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:
parent
b2e44bce62
commit
a6c72cb835
2 changed files with 27 additions and 23 deletions
|
@ -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,
|
||||||
|
|
46
Etc/FAQ.yo
46
Etc/FAQ.yo
|
@ -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
|
||||||
|
|
Loading…
Reference in a new issue