From cc9bc2dd0b90cbf920794f15d0fce73fe04babac Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Mon, 22 Nov 2010 11:42:47 +0000 Subject: 28424: new POSIX_STRINGS option --- Doc/Zsh/options.yo | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'Doc') diff --git a/Doc/Zsh/options.yo b/Doc/Zsh/options.yo index d334f5829..467c92723 100644 --- a/Doc/Zsh/options.yo +++ b/Doc/Zsh/options.yo @@ -1891,6 +1891,33 @@ If multibyte character support is not compiled into the shell this option is ignored; all octets with the top bit set may be used in identifiers. This is non-standard but is the traditional zsh behaviour. ) +pindex(POSIX_STRINGS) +pindex(NO_POSIX_STRINGS) +pindex(POSIXSTRINGS) +pindex(NOPOSIXSTRINGS) +cindex(discarding embedded nulls in $'...') +cindex(embedded nulls, in $'...') +cindex(nulls, embedded in $'...') +item(tt(POSIX_STRINGS) )( +This option affects processing of quoted strings. Currently it only +affects the behaviour of null characters, i.e. character 0 in the +portable character set corresponding to US ASCII. + +When this option is not set, null characters embedded within strings +of the form tt($')var(...)tt(') are treated as ordinary characters. The +entire string is maintained within the shell and output to files where +necessary, although owing to restrictions of the library interface +the string is truncated at the null character in file names, environment +variables, or in arguments to external programs. + +When this option is set, the tt($')var(...)tt(') expression is truncated at +the null character. Note that remaining parts of the same string +beyond the termination of the quotes are not trunctated. + +For example, the command line argument tt(a$'b\0c'd) is treated with +the option off as the characters tt(a), tt(b), null, tt(c), tt(d), +and with the option on as the characters tt(a), tt(b), tt(d). +) pindex(POSIX_TRAPS) pindex(NO_POSIX_TRAPS) pindex(POSIXTRAPS) -- cgit 1.4.1