1
0
Fork 0
mirror of git://git.code.sf.net/p/zsh/code synced 2025-09-15 14:21:13 +02:00

41623: Update FAQ.yo for Yodl 3

This commit is contained in:
Peter Stephenson 2017-09-02 20:09:27 +01:00
parent b2e44bce62
commit a6c72cb835
2 changed files with 27 additions and 23 deletions

View file

@ -1,3 +1,7 @@
2017-09-02 Peter Stephenson <p.w.stephenson@ntlworld.com>
* 41623: Etc/FAQ.yo: update to align with Yodl 3.
2017-08-31 Peter Stephenson <p.stephenson@samsung.com> 2017-08-31 Peter Stephenson <p.stephenson@samsung.com>
* unposted: Functions/Misc/zed: zstyle -m can set match, * unposted: Functions/Misc/zed: zstyle -m can set match,

View file

@ -242,9 +242,9 @@ sect(What is it good at?)
in any other freely-available shell which zsh does not also have in any other freely-available shell which zsh does not also have
(except smallness). (except smallness).
itemize( itemization(
it() Command line editing: it() Command line editing:
itemize( itemization(
it() programmable completion: incorporates the ability to use the it() programmable completion: incorporates the ability to use the
full power of zsh's globbing and shell programming features, full power of zsh's globbing and shell programming features,
it() multi-line commands editable as a single buffer (even files!), it() multi-line commands editable as a single buffer (even files!),
@ -257,7 +257,7 @@ sect(What is it good at?)
it() inline expansion of variables and history commands. it() inline expansion of variables and history commands.
) )
it() Globbing --- extremely powerful, including: it() Globbing --- extremely powerful, including:
itemize( itemization(
it() recursive globbing (cf. find), it() recursive globbing (cf. find),
it() file attribute qualifiers (size, type, etc. also cf. find), it() file attribute qualifiers (size, type, etc. also cf. find),
it() full alternation and negation of patterns. it() full alternation and negation of patterns.
@ -447,7 +447,7 @@ label(21)
substantial. substantial.
As a summary of the status: As a summary of the status:
enumerate( enumeration(
myeit() because of all the options it is not safe to assume a general myeit() because of all the options it is not safe to assume a general
zsh run by a user will behave as if sh or ksh compatible; zsh run by a user will behave as if sh or ksh compatible;
myeit() invoking zsh as sh or ksh (or if either is a symbolic link to myeit() invoking zsh as sh or ksh (or if either is a symbolic link to
@ -500,9 +500,9 @@ tt(RM_STAR_SILENT),
if `emulate ksh' is in effect. Capitalised words with underlines if `emulate ksh' is in effect. Capitalised words with underlines
refer to shell options. refer to shell options.
itemize( itemization(
it() Syntax: it() Syntax:
itemize( itemization(
it()* Shell word splitting: see question link(3.1)(31). it()* Shell word splitting: see question link(3.1)(31).
it()* Arrays are (by default) more csh-like than ksh-like: it()* Arrays are (by default) more csh-like than ksh-like:
subscripts start at 1, not 0; tt(array[0]) refers to tt(array[1]); subscripts start at 1, not 0; tt(array[0]) refers to tt(array[1]);
@ -522,7 +522,7 @@ tt(RM_STAR_SILENT),
this is a bug. Use mytt({ cmd1 && cmd2 } &) as a workaround. this is a bug. Use mytt({ cmd1 && cmd2 } &) as a workaround.
) )
it() Command line substitutions, globbing etc.: it() Command line substitutions, globbing etc.:
itemize( itemization(
it()* Failure to match a globbing pattern causes an error (use it()* Failure to match a globbing pattern causes an error (use
tt(NO_NOMATCH)). tt(NO_NOMATCH)).
it()* The results of parameter substitutions are treated as plain text: it()* The results of parameter substitutions are treated as plain text:
@ -565,14 +565,14 @@ tt(EXTENDED_GLOB).
assignment specially as a single word. assignment specially as a single word.
) )
it() Command execution: it() Command execution:
itemize( itemization(
it()* There is no tt($ENV) variable (use tt(/etc/zshrc), tt(~/.zshrc); it()* There is no tt($ENV) variable (use tt(/etc/zshrc), tt(~/.zshrc);
note also tt($ZDOTDIR)). note also tt($ZDOTDIR)).
it()* tt($PATH) is not searched for commands specified it()* tt($PATH) is not searched for commands specified
at invocation without -c. at invocation without -c.
) )
it() Aliases and functions: it() Aliases and functions:
itemize( itemization(
it() The order in which aliases and functions are defined is significant: it() The order in which aliases and functions are defined is significant:
function definitions with () expand aliases -- see question \ function definitions with () expand aliases -- see question \
link(2.3)(23). link(2.3)(23).
@ -588,14 +588,14 @@ link(2.3)(23).
and only the latter behave as true functions. and only the latter behave as true functions.
) )
it() Traps and signals: it() Traps and signals:
itemize( itemization(
it()* Traps are not local to functions. The option LOCAL_TRAPS is it()* Traps are not local to functions. The option LOCAL_TRAPS is
available from 3.1.6. available from 3.1.6.
it() TRAPERR has become TRAPZERR (this was forced by UNICOS which it() TRAPERR has become TRAPZERR (this was forced by UNICOS which
has SIGERR). has SIGERR).
) )
it() Editing: it() Editing:
itemize( itemization(
it() The options tt(gmacs), tt(viraw) are not supported. it() The options tt(gmacs), tt(viraw) are not supported.
Use bindkey to change the editing behaviour: mytt(set -o {emacs,vi}) Use bindkey to change the editing behaviour: mytt(set -o {emacs,vi})
becomes `bindkey -{e,v}', although `set -o emacs' and `set -o vi' becomes `bindkey -{e,v}', although `set -o emacs' and `set -o vi'
@ -620,7 +620,7 @@ link(2.3)(23).
) )
) )
it() Built-in commands: it() Built-in commands:
itemize( itemization(
it() Some built-ins (tt(r), tt(autoload), tt(history), tt(integer) ...) it() Some built-ins (tt(r), tt(autoload), tt(history), tt(integer) ...)
were aliases in ksh. were aliases in ksh.
it() There is no built-in command newgrp: use e.g. mytt(alias it() There is no built-in command newgrp: use e.g. mytt(alias
@ -628,7 +628,7 @@ link(2.3)(23).
it() mytt(jobs) has no mytt(-n) flag. it() mytt(jobs) has no mytt(-n) flag.
) )
it() Other idiosyncrasies: it() Other idiosyncrasies:
itemize( itemization(
it() mytt(select) always redisplays the list of selections on each loop. it() mytt(select) always redisplays the list of selections on each loop.
) )
) )
@ -644,7 +644,7 @@ sect(Similarities with csh)
particularly those with arguments. particularly those with arguments.
Csh-compatibility additions include: Csh-compatibility additions include:
itemize( itemization(
it() tt(logout), tt(rehash), tt(source), tt((un)limit) built-in commands. it() tt(logout), tt(rehash), tt(source), tt((un)limit) built-in commands.
it() tt(*rc) file for interactive shells. it() tt(*rc) file for interactive shells.
it() Directory stacks. it() Directory stacks.
@ -706,7 +706,7 @@ label(23)
Here is Bart Schaefer's guide to converting csh aliases for zsh. Here is Bart Schaefer's guide to converting csh aliases for zsh.
enumerate( enumeration(
myeit() If the csh alias references "parameters" (tt(\!:1), tt(\!*) etc.), myeit() If the csh alias references "parameters" (tt(\!:1), tt(\!*) etc.),
then in zsh you need a function (referencing tt($1), tt($*) etc.). then in zsh you need a function (referencing tt($1), tt($*) etc.).
Otherwise, you can use a zsh alias. Otherwise, you can use a zsh alias.
@ -722,7 +722,7 @@ label(23)
myeit() If you have aliases that refer to each other (tt(alias ls "ls -C"; myeit() If you have aliases that refer to each other (tt(alias ls "ls -C";
alias lf "ls -F" ==> lf == ls -C -F)) then you must either: alias lf "ls -F" ==> lf == ls -C -F)) then you must either:
itemize( itemization(
it() convert all of them to zsh functions; or it() convert all of them to zsh functions; or
it() after converting, be sure your .zshrc defines all of your it() after converting, be sure your .zshrc defines all of your
aliases before it defines any of your functions. aliases before it defines any of your functions.
@ -1097,7 +1097,7 @@ sect(What is the difference between `export' and the tt(ALL_EXPORT) option?)
This may seem a useful shorthand, but in practice it can have This may seem a useful shorthand, but in practice it can have
unhelpful side effects: unhelpful side effects:
enumerate( enumeration(
myeit() Since every variable is in the environment as well as remembered myeit() Since every variable is in the environment as well as remembered
by the shell, the memory for it needs to be allocated twice. by the shell, the memory for it needs to be allocated twice.
This is bigger as well as slower. This is bigger as well as slower.
@ -1365,7 +1365,7 @@ sect(Why do my autoloaded functions not autoload [the first time]?)
The problem is that there are two possible ways of autoloading a The problem is that there are two possible ways of autoloading a
function (see the AUTOLOADING FUNCTIONS section of the zsh manual function (see the AUTOLOADING FUNCTIONS section of the zsh manual
page zshmisc for more detailed information): page zshmisc for more detailed information):
enumerate( enumeration(
myeit() The file contains just the body of the function, i.e. myeit() The file contains just the body of the function, i.e.
there should be no line at the beginning saying mytt(function foo {) there should be no line at the beginning saying mytt(function foo {)
or mytt(foo () {), and consequently no matching mytt(}) at the end. or mytt(foo () {), and consequently no matching mytt(}) at the end.
@ -1709,7 +1709,7 @@ sect(What's wrong with cut and paste on my xterm?)
`non-canonical input mode'. On the systems in question, input can be `non-canonical input mode'. On the systems in question, input can be
lost or re-ordered when the mode changes. There are actually two lost or re-ordered when the mode changes. There are actually two
slightly different problems: slightly different problems:
enumerate( enumeration(
myeit() When you paste something in while a programme is running, so that myeit() When you paste something in while a programme is running, so that
the shell only retrieves it later. Traditionally, there was a test the shell only retrieves it later. Traditionally, there was a test
which was used only on systems where the problem was known to exist, which was used only on systems where the problem was known to exist,
@ -1931,7 +1931,7 @@ label(327)
assume the option tt(EXTENDED_GLOB) is set and none of the pattern assume the option tt(EXTENDED_GLOB) is set and none of the pattern
characters is disabled. characters is disabled.
enumerate( enumeration(
myeit() mytt(**/foo~*bar*) matches any file called mytt(foo) in any myeit() mytt(**/foo~*bar*) matches any file called mytt(foo) in any
subdirectory, except where mytt(bar) occurred somewhere in the path. subdirectory, except where mytt(bar) occurred somewhere in the path.
For example, mytt(users/barstaff/foo) will be excluded by the mytt(~) For example, mytt(users/barstaff/foo) will be excluded by the mytt(~)
@ -2035,7 +2035,7 @@ sect(How does zsh deal with ambiguous completions?)
(That's assuming you're at the end of the line, otherwise tt(\C-D) will (That's assuming you're at the end of the line, otherwise tt(\C-D) will
delete the next character and you have to use tt(ESC-\C-D).) This can be delete the next character and you have to use tt(ESC-\C-D).) This can be
changed by the following options, among others: changed by the following options, among others:
itemize( itemization(
it() with tt(NO_BEEP) set, that annoying beep goes away it() with tt(NO_BEEP) set, that annoying beep goes away
it() with tt(NO_LIST_BEEP), beeping is only turned off for ambiguous it() with tt(NO_LIST_BEEP), beeping is only turned off for ambiguous
completions completions
@ -2243,7 +2243,7 @@ sect(How do I ensure multibyte input and output work on my system?)
There are basically three components. There are basically three components.
itemize( itemization(
it() The locale. This describes a whole series of features specific it() The locale. This describes a whole series of features specific
to countries or regions of which the character set is one. Usually to countries or regions of which the character set is one. Usually
it is controlled by the environment variable tt(LANG) (there are it is controlled by the environment variable tt(LANG) (there are
@ -2436,7 +2436,7 @@ sect(What's on the wish-list?)
particularly welcome for these tasks. particularly welcome for these tasks.
Some future possibilities which have been suggested: Some future possibilities which have been suggested:
itemize( itemization(
it() The shell, in particular the line editor, should support Unicode it() The shell, in particular the line editor, should support Unicode
characters. Initial support for this appeared in version 4.3; characters. Initial support for this appeared in version 4.3;
it is reasonably complete in the line editor but patchy elsewhere it is reasonably complete in the line editor but patchy elsewhere