diff options
Diffstat (limited to 'Doc/Zsh/options.yo')
| -rw-r--r-- | Doc/Zsh/options.yo | 45 |
1 files changed, 33 insertions, 12 deletions
diff --git a/Doc/Zsh/options.yo b/Doc/Zsh/options.yo index 4dd68c9cb..abd0f8715 100644 --- a/Doc/Zsh/options.yo +++ b/Doc/Zsh/options.yo @@ -124,7 +124,7 @@ pindex(POSIXCD) pindex(NO_POSIX_CD) pindex(NOPOSIXCD) cindex(CDPATH, order of checking) -item(tt(POSIX_CD))( +item(tt(POSIX_CD) <K> <S>)( Modifies the behaviour of tt(cd), tt(chdir) and tt(pushd) commands to make them more compatible with the POSIX standard. The behaviour with the option unset is described in the documentation for the tt(cd) @@ -634,7 +634,7 @@ pindex(NO_MULTIBYTE) pindex(NOMULTIBYTE) cindex(characters, multibyte, in expansion and globbing) cindex(multibyte characters, in expansion and globbing) -item(tt(MULTIBYTE) <C> <K> <Z>)( +item(tt(MULTIBYTE) <D>)( Respect multibyte characters when found in strings. When this option is set, strings are examined using the system library to determine how many bytes form a character, depending @@ -642,10 +642,8 @@ on the current locale. This affects the way characters are counted in pattern matching, parameter values and various delimiters. The option is on by default if the shell was compiled with -tt(MULTIBYTE_SUPPORT) except in tt(sh) emulation; otherwise it is off by -default and has no effect if turned on. The mode is off in tt(sh) -emulation for compatibility but for interactive use may need to be -turned on if the terminal interprets multibyte characters. +tt(MULTIBYTE_SUPPORT); otherwise it is off by default and has no effect +if turned on. If the option is off a single byte is always treated as a single character. This setting is designed purely for examining strings @@ -1096,10 +1094,12 @@ pindex(NOCLOBBER) cindex(clobbering, of files) cindex(file clobbering, allowing) item(tt(CLOBBER) (tt(PLUS()C), ksh: tt(PLUS()C)) <D>)( -Allows `tt(>)' redirection to truncate existing files, -and `tt(>>)' to create files. -Otherwise `tt(>!)' or `tt(>|)' must be used to truncate a file, -and `tt(>>!)' or `tt(>>|)' to create a file. +Allows `tt(>)' redirection to truncate existing files. +Otherwise `tt(>!)' or `tt(>|)' must be used to truncate a file. + +If the option is not set, and the option tt(APPEND_CREATE) is also +not set, `tt(>>!)' or `tt(>>|)' must be used to create a file. +If either option is set, `tt(>>)' may be used. ) pindex(CORRECT) pindex(NO_CORRECT) @@ -1794,6 +1794,21 @@ enditem() subsect(Shell Emulation) startitem() +pindex(APPEND_CREATE) +pindex(NO_APPEND_CREATE) +pindex(APPENDCREATE) +pindex(NOAPPENDCREATE) +cindex(clobbering, POSIX compatibility) +cindex(file clobbering, POSIX compatibility) +cindex(no clobber, POSIX compatible) +item(tt(APPEND_CREATE) <K> <S>)( +This option only applies when tt(NO_CLOBBER) (-tt(C)) is in effect. + +If this option is not set, the shell will report an error when a +append redirection (tt(>>)) is used on a file that does not already +exists (the traditional zsh behaviour of tt(NO_CLOBBER)). If the option +is set, no error is reported (POSIX behaviour). +) pindex(BASH_REMATCH) pindex(NO_BASH_REMATCH) pindex(BASHREMATCH) @@ -1930,7 +1945,13 @@ pindex(KSHTYPESET) pindex(NOKSHTYPESET) cindex(argument splitting, in typeset etc.) cindex(ksh, argument splitting in typeset) -item(tt(KSH_TYPESET) <K>)( +item(tt(KSH_TYPESET))( +This option is now obsolete: a better appropximation to the behaviour of +other shells is obtained with the reserved word interface to +tt(declare), tt(export), tt(float), tt(integer), tt(local), tt(readonly) +and tt(typeset). Note that the option is only applied when the reserved +word interface is em(not) in use. + Alters the way arguments to the tt(typeset) family of commands, including tt(declare), tt(export), tt(float), tt(integer), tt(local) and tt(readonly), are processed. Without this option, zsh will perform normal @@ -2057,7 +2078,7 @@ of shell parameters and modules). In addition, setting this option limits the effect of parameter substitution with no braces, so that the expression tt($#) is treated as the parameter tt($#) even if followed by a valid parameter name. -When it is unset, zsh allows expresions of the form tt($#)var(name) +When it is unset, zsh allows expressions of the form tt($#)var(name) to refer to the length of tt($)var(name), even for special variables, for example in expressions such as tt($#-) and tt($#*). |