PATCH: bindkey doc (Re: New user questions)

["Bart Schaefer" <schaefer@candle.brasslantern.com>]

On Mar 31,  3:04pm, Sven Wischnowsky wrote:
} Subject: RE: New user questions
}
} > Actually, -R flag is not described at all (I have dev-20 with a couple
} > of patches).
} 
} It is, although not very clearly: (from mod_zle.yo)
} 
}   xitem(tt(bindkey) [ var(options) ] tt(-l))
}   ...
}   In the binding operations, if the tt(-R) option is used  ...
} 
} So I guess -R is one of the var(options).

This clearly could be clearer.

Index: Doc/Zsh/mod_zle.yo
===================================================================
@@ -45,10 +45,11 @@
 If a keymap selection is required and none of the options above are used, the
 `tt(main)' keymap is used.  Some operations do not permit a keymap to be
 selected, namely:
+
 startitem()
 item(tt(-l))(
 List all existing keymap names.  If the tt(-L)
-option is used, list in the form of tt(bindkey)
+option is also used, list in the form of tt(bindkey)
 commands to create the keymaps.
 )
 item(tt(-d))(
@@ -82,7 +83,8 @@
 var(newmap) is tt(emacs) or tt(viins), it will not work for tt(vicmd), as
 switching from vi insert to command mode becomes impossible.
 
-The following operations require a keymap to be selected:
+The following operations act on the `tt(main)' keymap if no keymap
+selection option was given:
 
 startitem()
 item(tt(-m))(
@@ -92,29 +94,34 @@
 item(tt(-r) var(in-string) ...)(
 Unbind the specified var(in-string)s in the selected keymap.
 This is exactly equivalent to binding the strings to tt(undefined-key).
+When tt(-R) is also used, interpret the var(in-string)s as ranges.
 )
 item(tt(-s) var(in-string out-string) ...)(
 Bind each var(in-string) to each var(out-string).
 When var(in-string) is typed, var(out-string) will be
 pushed back and treated as input to the line editor.
+When tt(-R) is also used, interpret the var(in-string)s as ranges.
 )
 item(var(in-string command) ...)(
 Bind each var(in-string) to each var(command).
+When tt(-R) is used, interpret the var(in-string)s as ranges.
 )
 item([ var(in-string) ])(
 List key bindings.  If an var(in-string) is specified, the binding of
 that string in the selected keymap is displayed.  Otherwise, all key
-bindings in the selected keymap are displayed.  As an exception,
-if the tt(-e) or tt(-v) options are used alone, the keymap is em(not)
-displayed - the implicit linking of keymaps is the only thing that happens.
+bindings in the selected keymap are displayed.  (As a special case,
+if the tt(-e) or tt(-v) option is used alone, the keymap is em(not)
+displayed - the implicit linking of keymaps is the only thing that
+happens.)
+
+When the tt(-L) option is used, the list is in the form of tt(bindkey)
+commands to create the key bindings.
 )
 enditem()
 
-In the binding operations, if the tt(-R) option is used, the var(in-string)s
-are interpreted as ranges, instead of plain strings.  A valid range
-consists of two characters, with an optional `tt(-)'
-between them.  All characters between the two specified, inclusive,
-are bound as specified.
+When the tt(-R) option is used as noted above, a valid range consists of
+two characters, with an optional `tt(-)' between them.  All characters
+between the two specified, inclusive, are bound as specified.
 
 For either var(in-string) or var(out-string), the following
 escape sequences are recognised:

-- 
Bart Schaefer                                 Brass Lantern Enterprises
http://www.well.com/user/barts              http://www.brasslantern.com