* src/input.c (rp_mask_to_x11_mask): handle the shift modifier

(x11_mask_to_rp_mask): likewise
(keysym_to_keycode_mod): Make sure lower != keysym before adding
the shift mask.
(keysym_to_string): handle the shift modifier. use 's' for super
instead of 'S'
(cook_keycode): keep the shift modifier if XLookupString didn't
gobble it.

* src/data.h (RP_SHIFT_MASK): new define

* src/actions.c (parse_keydesc): parse the shift modifier change
super to 's' from 'S'.

1 files changed, 28 insertions, 0 deletions

diff --git a/doc/ratpoison.texi b/doc/ratpoison.texi
index 6061d70..2af7291 100644
--- a/doc/ratpoison.texi
+++ b/doc/ratpoison.texi
@@ -794,6 +794,34 @@ Interactive control of ratpoison is done entirely through
 keystrokes. This chapter explains how keystrokes are stored and
 manipulated.
 
+ratpoison uses the Emacs style key notation. A combination of
+modifiers and one non-modifier key combine to invoke an action. The
+syntax is one or more modifiers seperated with dashes followed by a
+dash and the non-modifier key name. For instance, holding down
+control, shift, and super then pressing the spacebar would be
+described as:
+
+@example
+S-C-s-space
+@end example
+
+The following is a list of modifiers ratpoison accepts:
+
+@table @asis
+@item S
+Shift modifier
+@item C
+Control modifier
+@item M
+Meta modifier
+@item A
+Alt modifier
+@item H
+Hyper modifier
+@item s
+Super modifier
+@end table
+
 @menu
 * Key Maps::                    
 * Default Key Bindings::