diff options
Diffstat (limited to 'Doc/Zsh/builtins.yo')
| -rw-r--r-- | Doc/Zsh/builtins.yo | 36 |
1 files changed, 31 insertions, 5 deletions
diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo index f709f5020..46f40cc3a 100644 --- a/Doc/Zsh/builtins.yo +++ b/Doc/Zsh/builtins.yo @@ -603,7 +603,7 @@ tt(enable -p) reenables patterns disabled with tt(disable -p). Note that it does not override globbing options; for example, `tt(enable -p "~")' does not cause the pattern character tt(~) to be active unless the tt(EXTENDED_GLOB) option is also set. To enable all possible -patterns (so that they may be invidually disabled with tt(disable -p)), +patterns (so that they may be individually disabled with tt(disable -p)), use `tt(setopt EXTENDED_GLOB KSH_GLOB NO_SH_GLOB)'. ) findex(eval) @@ -773,7 +773,7 @@ findex(functions) xitem(tt(functions) [ {tt(PLUS())|tt(-)}tt(UXkmtTuz) ] [ var(name) ... ]) xitem(tt(functions -M) var(mathfn) [ var(min) [ var(max) [ var(shellfn) ] ] ]) xitem(tt(functions -M) [ tt(-m) var(pattern) ... ]) -item(tt(functions +M) [ tt(-m) ] var(mathfn))( +item(tt(functions +M) [ tt(-m) ] var(mathfn) ... )( Equivalent to tt(typeset -f), with the exception of the tt(-M) option. Use of the tt(-M) option may not be combined with any of the options handled by tt(typeset -f). @@ -1639,14 +1639,26 @@ Do nothing and return an exit status of 0. findex(ttyctl) cindex(tty, freezing) item(tt(ttyctl) tt(-fu))( -The tt(-f) option freezes the tty, and tt(-u) unfreezes it. +The tt(-f) option freezes the tty (i.e. terminal or terminal emulator), and +tt(-u) unfreezes it. When the tty is frozen, no changes made to the tty settings by external programs will be honored by the shell, except for changes in the size of the screen; the shell will simply reset the settings to their previous values as soon as each command exits or is suspended. Thus, tt(stty) and similar programs have -no effect when the tty is frozen. Without options it reports whether the -terminal is frozen or not. +no effect when the tty is frozen. Freezing the tty does not cause +the current state to be remembered: instead, it causes future changes +to the state to be blocked. + +Without options it reports whether the terminal is frozen or not. + +Note that, regardless of whether the tty is frozen or not, the +shell needs to change the settings when the line editor starts, so +unfreezing the tty does not guarantee settings made on the +command line are preserved. Strings of commands run between +editing the command line will see a consistent tty state. +See also the shell variable tt(STTY) for a means of initialising +the tty before running external commands. ) findex(type) item(tt(type) [ tt(-wfpams) ] var(name) ...)( @@ -2162,6 +2174,20 @@ match one of these patterns will be written. If no var(name) is given, the definitions of all functions currently defined or marked as autoloaded will be written. +Note the second form cannot be used for compiling functions that +include redirections as part of the definition rather than within +the body of the function; for example + +example(fn1() { { ... } >~/logfile }) + +can be compiled but + +example(fn1() { ... } >~/logfile) + +cannot. It is possible to use the first form of tt(zcompile) to compile +autoloadable functions that include the full function definition instead +of just the body of the function. + The third form, with the tt(-t) option, examines an existing compiled file. Without further arguments, the names of the original files compiled into it are listed. The first line of output shows |