PATCH: make documentation clearer

PATCH: make documentation clearer

[Peter Stephenson]

or something.  Maybe the option should be called something like
DESTROY_ATTEMPTS_AT_CONSISTENT_ARGUMENT_HANDLING_WITHOUT_EXCESSIVE_QUOTING
or
USE_UNNECESSARY_PRETEND_ARRAYS_AUTOMATICALLY
to get the point across.

Index: Doc/Zsh/expn.yo
===================================================================
RCS file: /cvsroot/zsh/zsh/Doc/Zsh/expn.yo,v
retrieving revision 1.43
diff -u -r1.43 expn.yo
--- Doc/Zsh/expn.yo	5 Aug 2002 12:33:28 -0000	1.43
+++ Doc/Zsh/expn.yo	17 Sep 2002 11:00:19 -0000
@@ -374,6 +374,11 @@
 for a description of parameters, including arrays, associative arrays,
 and subscript notation to access individual array elements.
 
+Note in particular the fact that words of unquoted parameters are not
+automatically split on whitespace unless the option tt(SH_WORD_SPLIT) is
+set; see references to this option below for more details.  This is an
+important difference from other shells.
+
 In the expansions discussed below that require a pattern, the form of
 the pattern is the same as that used for filename generation;
 see noderef(Filename Generation).  Note that these patterns, along with

-- 
Peter Stephenson <pws@csr.com>                  Software Engineer
CSR Ltd., Science Park, Milton Road,
Cambridge, CB4 0WH, UK                          Tel: +44 (0)1223 692070


**********************************************************************
The information transmitted is intended only for the person or
entity to which it is addressed and may contain confidential 
and/or privileged material. 
Any review, retransmission, dissemination or other use of, or
taking of any action in reliance upon, this information by 
persons or entities other than the intended recipient is 
prohibited.  
If you received this in error, please contact the sender and 
delete the material from any computer.
**********************************************************************

Re: PATCH: make documentation clearer

[Geoff Wing]

Peter Stephenson <pws@csr.com> typed:
: or something.  Maybe the option should be called something like
: DESTROY_ATTEMPTS_AT_CONSISTENT_ARGUMENT_HANDLING_WITHOUT_EXCESSIVE_QUOTING
: or
: USE_UNNECESSARY_PRETEND_ARRAYS_AUTOMATICALLY
: to get the point across.

or GIVE_US_A_PARENT_ARTICLE_REFENCE_FOR_YOUR_PATCH_SO_WE_KNOW_WHAT_YOURE_TALKING_ABOUT or somehow pull a rabbit out of our zsh-users hat
or specify invocation as sh or ksh or something.  Well, yes, I know what
you're talking about and this is not an attack or anything (except for us
poor boozed-up blokes - or just me).  Umm, we don't go specifying "see
references" for previous mentions of options (including SH_WORD_SPLIT).
It seems somewhat excessive to inclue those extra nine words.  Oh, well,
it doesn't really matter.  Go for it.
 
: +set; see references to this option below for more details.  This is an

Regards,
-- 
Geoff Wing