feh(1): Document behaviour of duplicate key bindings (closes #91)

2 files changed, 29 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index 27c347b..d1a769f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,6 +1,8 @@
 git HEAD
 
     * Dennis Real: EXIF mode fixes, support for more camera models
+    * feh(1): Document behaviour for duplicate key bindings
+      <https://github.com/derf/feh/issues/91>
 
 Sun, 25 Mar 2012 13:13:26 +0200  Daniel Friesel <derf@finalrewind.org>
 
diff --git a/man/feh.pre b/man/feh.pre
index 8460b64..fcf3ad6 100644
--- a/man/feh.pre
+++ b/man/feh.pre
@@ -962,6 +962,11 @@ Available modifiers are
 .Ar C No for Control ,
 .Ar S No for Shift and
 .Ar 1 , 4 No for Mod1 and Mod4 .
+To match an uppercase letter like
+.Qq S
+instead of
+.Qq s ,
+the Shift modifier is not required.
 .
 .Pp
 .
@@ -971,6 +976,17 @@ without any keys unbinds it (i.e. the default bindings are removed).
 .
 .Pp
 .
+.Em Note :
+Do not use the same keybinding for multiple actions.
+.Nm
+does not check for conflicting bindings, so their behaviour is undefined.
+.
+Either unbind the unwanted action, or bind it to another unused key.
+.
+The order in which you bind / unbind does not matter, though.
+.
+.Pp
+.
 For a list of the
 .Ar action
 names, see
@@ -1247,6 +1263,17 @@ looks like
 .
 .Pp
 .
+.Em Note :
+Do not use the same button for multiple actions.
+.Nm
+does not check for conflicting bindings, so their behaviour is undefined.
+.
+Either unbind the unwanted action, or bind it to another unused button.
+.
+The order in which you bind / unbind does not matter, though.
+.
+.Pp
+.
 For the available modifiers, see
 .Sx KEYS CONFIGURATION SYNTAX .
 .