diff options
Diffstat (limited to 'Doc/Zsh/builtins.yo')
| -rw-r--r-- | Doc/Zsh/builtins.yo | 30 |
1 files changed, 19 insertions, 11 deletions
diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo index 5bbe7e70b..49806e4d8 100644 --- a/Doc/Zsh/builtins.yo +++ b/Doc/Zsh/builtins.yo @@ -144,8 +144,12 @@ findex(autoload) cindex(functions, autoloading) cindex(autoloading functions) item(tt(autoload) [ {tt(PLUS())|tt(-)}tt(TUXkmtz) ] [ tt(-w) ] [ var(name) ... ])( +vindex(fpath, searching) Equivalent to tt(functions -u), with the exception of tt(-X)/tt(+X) and -tt(-w). +tt(-w). See the section `Autoloading Functions' in ifzman(zmanref(zshmisc))\ +ifnzman(noderef(Functions)) for full details. The tt(fpath) parameter +will be searched to find the function definition when the function is +first referenced. The flag tt(-X) may be used only inside a shell function, and may not be followed by a var(name). It causes the calling function to be marked for @@ -473,7 +477,7 @@ cindex(compatibility, csh) cindex(sh, compatibility) cindex(ksh, compatibility) cindex(csh, compatibility) -item(tt(emulate) [ tt(-LR) ] [ {tt(zsh)|tt(sh)|tt(ksh)|tt(csh)} [ var(flags) ... ] ])( +item(tt(emulate) [ tt(-lLR) ] [ {tt(zsh)|tt(sh)|tt(ksh)|tt(csh)} [ var(flags) ... ] ])( Without any argument print current emulation mode. With single argument set up zsh options to emulate the specified shell @@ -514,6 +518,14 @@ function, if any; normally these options are turned off in all emulation modes except tt(ksh). The tt(-L) switch is mutually exclusive with the use of tt(-c) in var(flags). +If there is a single argument and the tt(-l) switch is given, the +options that would be set or unset (the latter indicated with the prefix +`tt(no)') are listed. tt(-l) can be combined with tt(-L) or tt(-R) and +the list will be modified in the appropriate way. Note the list does +not depend on the current setting of options, i.e. it includes all +options that may in principle change, not just those that would actually +change. + The var(flags) may be any of the invocation-time flags described in ifnzman(noderef(Invocation))\ ifzman(the section INVOCATION in zmanref(zsh)), @@ -546,8 +558,7 @@ For example: example(emulate sh -c 'fni+LPAR()RPAR() { setopt cshnullglob; } fno+LPAR()RPAR() { fni; }' -fno -) +fno) The two functions tt(fni) and tt(fno) are defined with sticky tt(sh) emulation. tt(fno) is then executed, causing options associated @@ -1981,12 +1992,8 @@ for this function; the flag tt(-T) does the same, but turns off tracing on any function called from the present one, unless that function also has the tt(-t) or tt(-T) flag. The tt(-u) and tt(-U) flags cause the function to be marked for autoloading; tt(-U) also causes alias -expansion to be suppressed when the function is loaded. The tt(fpath) -parameter will be searched to find the function definition when the -function is first referenced; see noderef(Functions). The tt(-k) and -tt(-z) flags make the function be loaded using ksh-style or zsh-style -autoloading respectively. If neither is given, the setting of the -tt(KSH_AUTOLOAD) option determines how the function is loaded. +expansion to be suppressed when the function is loaded. See the +description of the `tt(autoload)' builtin for details. Note that the builtin tt(functions) provides the same basic capabilities as tt(typeset -f) but gives access to a few extra options. @@ -2320,7 +2327,7 @@ item(tt(zcompile -t) var(file) [ var(name) ... ])( This builtin command can be used to compile functions or scripts, storing the compiled form in a file, and to examine files containing the compiled form. This allows faster autoloading of functions and -execution of scripts by avoiding parsing of the text when the files +sourcing of scripts by avoiding parsing of the text when the files are read. The first form (without the tt(-c), tt(-a) or tt(-t) options) creates a @@ -2338,6 +2345,7 @@ noderef(Functions) for a description of how autoloaded functions are searched. The extension tt(.zwc) stands for `zsh word code'. +vindex(fpath, with zcompile) If there is at least one var(name) argument, all the named files are compiled into the output var(file) given as the first argument. If var(file) does not end in tt(.zwc), this extension is automatically |