From a6c72cb8355a014ad01fb359a60c6c7d2c2d1306 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Sat, 2 Sep 2017 20:09:27 +0100 Subject: 41623: Update FAQ.yo for Yodl 3 --- Etc/FAQ.yo | 46 +++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 23 deletions(-) (limited to 'Etc/FAQ.yo') diff --git a/Etc/FAQ.yo b/Etc/FAQ.yo index adde2d56c..641504503 100644 --- a/Etc/FAQ.yo +++ b/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 (except smallness). - itemize( + itemization( it() Command line editing: - itemize( + itemization( it() programmable completion: incorporates the ability to use the full power of zsh's globbing and shell programming features, 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() Globbing --- extremely powerful, including: - itemize( + itemization( it() recursive globbing (cf. find), it() file attribute qualifiers (size, type, etc. also cf. find), it() full alternation and negation of patterns. @@ -447,7 +447,7 @@ label(21) substantial. As a summary of the status: - enumerate( + enumeration( 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; 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 refer to shell options. - itemize( + itemization( it() Syntax: - itemize( + itemization( it()* Shell word splitting: see question link(3.1)(31). 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]); @@ -522,7 +522,7 @@ tt(RM_STAR_SILENT), this is a bug. Use mytt({ cmd1 && cmd2 } &) as a workaround. ) it() Command line substitutions, globbing etc.: - itemize( + itemization( it()* Failure to match a globbing pattern causes an error (use tt(NO_NOMATCH)). it()* The results of parameter substitutions are treated as plain text: @@ -565,14 +565,14 @@ tt(EXTENDED_GLOB). assignment specially as a single word. ) it() Command execution: - itemize( + itemization( it()* There is no tt($ENV) variable (use tt(/etc/zshrc), tt(~/.zshrc); note also tt($ZDOTDIR)). it()* tt($PATH) is not searched for commands specified at invocation without -c. ) it() Aliases and functions: - itemize( + itemization( it() The order in which aliases and functions are defined is significant: function definitions with () expand aliases -- see question \ link(2.3)(23). @@ -588,14 +588,14 @@ link(2.3)(23). and only the latter behave as true functions. ) it() Traps and signals: - itemize( + itemization( it()* Traps are not local to functions. The option LOCAL_TRAPS is available from 3.1.6. it() TRAPERR has become TRAPZERR (this was forced by UNICOS which has SIGERR). ) it() Editing: - itemize( + itemization( it() The options tt(gmacs), tt(viraw) are not supported. Use bindkey to change the editing behaviour: mytt(set -o {emacs,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: - itemize( + itemization( it() Some built-ins (tt(r), tt(autoload), tt(history), tt(integer) ...) were aliases in ksh. 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() Other idiosyncrasies: - itemize( + itemization( it() mytt(select) always redisplays the list of selections on each loop. ) ) @@ -644,7 +644,7 @@ sect(Similarities with csh) particularly those with arguments. Csh-compatibility additions include: - itemize( + itemization( it() tt(logout), tt(rehash), tt(source), tt((un)limit) built-in commands. it() tt(*rc) file for interactive shells. it() Directory stacks. @@ -706,7 +706,7 @@ label(23) 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.), then in zsh you need a function (referencing tt($1), tt($*) etc.). 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"; alias lf "ls -F" ==> lf == ls -C -F)) then you must either: - itemize( + itemization( it() convert all of them to zsh functions; or it() after converting, be sure your .zshrc defines all of your 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 unhelpful side effects: - enumerate( + enumeration( myeit() Since every variable is in the environment as well as remembered by the shell, the memory for it needs to be allocated twice. 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 function (see the AUTOLOADING FUNCTIONS section of the zsh manual page zshmisc for more detailed information): - enumerate( + enumeration( myeit() The file contains just the body of the function, i.e. there should be no line at the beginning saying mytt(function foo {) 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 lost or re-ordered when the mode changes. There are actually two slightly different problems: - enumerate( + enumeration( myeit() When you paste something in while a programme is running, so that the shell only retrieves it later. Traditionally, there was a test 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 characters is disabled. - enumerate( + enumeration( myeit() mytt(**/foo~*bar*) matches any file called mytt(foo) in any subdirectory, except where mytt(bar) occurred somewhere in the path. 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 delete the next character and you have to use tt(ESC-\C-D).) This can be changed by the following options, among others: - itemize( + itemization( it() with tt(NO_BEEP) set, that annoying beep goes away it() with tt(NO_LIST_BEEP), beeping is only turned off for ambiguous completions @@ -2243,7 +2243,7 @@ sect(How do I ensure multibyte input and output work on my system?) There are basically three components. - itemize( + itemization( it() The locale. This describes a whole series of features specific to countries or regions of which the character set is one. Usually 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. Some future possibilities which have been suggested: - itemize( + itemization( it() The shell, in particular the line editor, should support Unicode characters. Initial support for this appeared in version 4.3; it is reasonably complete in the line editor but patchy elsewhere -- cgit 1.4.1