Re: docs: document zsh specialty with empty here-documents.

[Eric Blake]

On 09/12/2010 09:55 PM, Gary V. Vaughan wrote:
> On 12 Sep 2010, at 23:41, Ralf Wildenhues wrote:
> >     docs: document zsh specialty with empty here-documents.
> >
> >     * doc/autoconf.texi (Here-Documents): zsh 4.3.10 adds a newline
> >     to empty here-docs.
> >
> > diff --git a/doc/autoconf.texi b/doc/autoconf.texi
> > index e8d65cb..344aefa 100644
> > --- a/doc/autoconf.texi
> > +++ b/doc/autoconf.texi
> > @@ -14897,6 +14897,15 @@ Here-Documents
> > @samp{ksh93g} (1998-04-30) but as of 2006 many operating systems were
> > still shipping older versions with the bug.
> >
> > +Empty here-documents are not portable either: @command{zsh} 4.3.10 creates
> > +a file with a single newline upon, whereas other shells create an empty
> > +file, upon:
>
> Two colons in a sentence seems odd to me, and the English doesn't parse
> well either.  How about:
>
> "Empty here-documents are not portable either; with the following code,
> @command{zsh} 4.3.10 creates a file with a single newline, whereas other
> shells create an empty file:"
>
> Also, is it really just that one micro release of zsh that has this
> problem?  Or do you mean "since 4.3.10" or maybe "before 4.3.10" or
> even "at least 4.3.10"?

I like "at least 4.3.10".  Okay with Gary's proposed wording changes.

--
Eric Blake   address@hidden    +1-801-349-2682
Libvirt virtualization library http://libvirt.org