Re: [doc] "sh_word_split nothing to do with word splitting"?

[Stephane Chazelas <stephane.chazelas@gmail.com>]

2018-03-11 11:24:07 -0700, Bart Schaefer:
> On Mar 11,  9:44am, Stephane Chazelas wrote:
> } Subject: [doc] "sh_word_split nothing to do with word splitting"?
> }
> } SH_WORD_SPLIT (-y) <K> <S>
> }      Causes field splitting to be performed on unquoted parameter
> }      expansions.  Note that this option has nothing to do with word
> }      splitting.  (See *note Parameter Expansion::.)
> 
> What this means to say:
> 
> This option applies to field splitting within an expanded shell word,
> not to splitting a command line into shell words during parsing.

Thanks Bart for confirming that.

What about changing it to something like:


diff --git a/Doc/Zsh/options.yo b/Doc/Zsh/options.yo
index 25b3d57..7677f73 100644
--- a/Doc/Zsh/options.yo
+++ b/Doc/Zsh/options.yo
@@ -2314,9 +2314,17 @@ pindex(NOSHWORDSPLIT)
 cindex(field splitting, sh style)
 cindex(sh, field splitting style)
 item(tt(SH_WORD_SPLIT) (tt(-y)) <K> <S>)(
-Causes field splitting to be performed on unquoted parameter expansions.
-Note that this option has nothing to do with word splitting.
-(See noderef(Parameter Expansion).)
+Causes tt($IFS) field splitting to be performed on unquoted parameter
+expansions in addition to command substitutions. Note that contrary to
+POSIX shells, field splitting is still not performed on unquoted
+arithmetic expansions and contrary to the Bourne shell, not on words
+that are not the result of expansions. Like in other Bourne-like shells,
+field splitting is only performed in contexts where several words may be
+expected, such as in arguments to simple commands or anonymous functions,
+array assignments and for loop word lists. If the tt(MULTIOS) option is
+enabled, it is also performed in the targets of tt(<), tt(>) and tt(>>)
+redirection operators. (See noderef(Parameter Expansion) and
+noderef(Redirection)).
 )
 pindex(TRAPS_ASYNC)
 pindex(NO_TRAPS_ASYNC)

A reference to $IFS may also be useful. Is it possible to add
references to index entries in yodl?

(I only include the >, >>, < redirections, that's missing the
clobber variants and the >& >>&... Not sure how to express it
without making it too wordy).

Not sure it's worth mentioning:

$var() function-definition

as a context where shwordsplit happens.

See also https://unix.stackexchange.com/a/382914

-- 
Stephane