RE: New user questions

RE: New user questions

[Sven Wischnowsky]

Andrej Borsenkow wrote:

> > BTW, I was fiddling with 'bindkey -R' but I was using things like
> >
> > 	bindkey -R "^A-^Z"
> >
> > An example in the manual would be nice.
> >
> 
> 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, 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.

So I guess -R is one of the var(options).

Bye
 Sven


--
Sven Wischnowsky                         wischnow@informatik.hu-berlin.de

PATCH: bindkey doc (Re: New user questions)

[Bart Schaefer]

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

RE: New user questions

[Andrej Borsenkow]

>
> BTW, I was fiddling with 'bindkey -R' but I was using things like
>
> 	bindkey -R "^A-^Z"
>
> An example in the manual would be nice.
>

Actually, -R flag is not described at all (I have dev-20 with a couple
of patches).

-andrej

RE: New user questions

[Andrej Borsenkow]

> >
> > This is in modules section (Zle module). But, yes, I never
> liked this.
> > Users are not supposed to know, if command is implemented in core or
> > module.
> >
> > man zshmodules
>
> But without the module they won't get the builtin (parameter,
> condition code, whatever...), so they may be in for a surprise.
>
> Hm, maybe add pointers to the module docs in builtins.yo?
> (And also in
> params.yo, cond.yo??)
>

I mostly referred to those modules, that are autoloaded by default. You
hardly can imagine Zsh without ZLE. And this is completely transparent,
users do not need to load any modules manually and may not even know
that modules exist.

-andrej

RE: New user questions

[Sven Wischnowsky]

[ moved to zsh-workers ]

Andrej Borsenkow wrote:

> ...
> 
> This is in modules section (Zle module). But, yes, I never liked this.
> Users are not supposed to know, if command is implemented in core or
> module.
> 
> man zshmodules

But without the module they won't get the builtin (parameter,
condition code, whatever...), so they may be in for a surprise.

Hm, maybe add pointers to the module docs in builtins.yo? (And also in 
params.yo, cond.yo??)

Bye
 Sven


--
Sven Wischnowsky                         wischnow@informatik.hu-berlin.de