From 9a0bcd7025ee1ba9eb32503c86e03a3db166484e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bert=20M=C3=BCnnich?= <ber.t@posteo.de>
Date: Sun, 5 Jan 2014 22:07:21 +0100
Subject: [PATCH] Added doc header to exec/key-handler

---
 exec/key-handler | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/exec/key-handler b/exec/key-handler
index 5647251..3912825 100644
--- a/exec/key-handler
+++ b/exec/key-handler
@@ -1,5 +1,16 @@
 #!/bin/sh
 
+# Example for ~/.sxiv/exec/key-handler
+# Called by sxiv(1) whenever an unbound key combo is used,
+# with the key combo as its first argument and the path of the current image
+# as its second argument.
+# sxiv(1) blocks until this script terminates. It then checks if the image
+# has been modified and reloads it.
+
+# The key combo argument has the following form: "[C-][M-][S-]KEY",
+# where C/M/S indicate Ctrl/Meta(Alt)/Shift modifier states and KEY is the X
+# keysym as listed in /usr/include/X11/keysymdef.h without the "XK_" prefix.
+
 case "$1" in
 "C-c")
 	echo -n "$2" | xsel -i ;;