Re: Fwd: Copy out wording

Andrew Dunstan wrote:
>
>
> Bruce Momjian wrote:
> > Magnus Hagander wrote:
> >
> >> On Thu, Sep 3, 2009 at 13:31, Andrew Dunstan<andrew(at)dunslane(dot)net> wrote:
> >>
> >>> Magnus Hagander wrote:
> >>>
> >>>> Oh, hang on, "the NULL string" refers to the copy parameter? Not a
> >>>> part of the data? I read it as "a string being NULL". Maybe something
> >>>> like "the value of the NULL string parameter" to be overly clear for
> >>>> people like me? :-)
> >>>>
> >>>>
> >>> We could change:
> >>>
> >>> ? A NULL is output as the NULL string and is not quoted, while a data value
> >>> ? matching the NULL string is quoted.
> >>>
> >>>
> >>> to
> >>>
> >>> ? A NULL is output as the NULL parameter and is not quoted, while a non-NULL
> >>> data value whose text representation
> >>> ? matches the NULL parameter is quoted.
> >>>
> >>>
> >>> or something similar. Would that be better?
> >>>
> >> Yes, much better IMO.
> >>
> >
> > I have applied the attached documentation clarification patch, and
> > backpatched it to 8.4.X.
> >
> >
> >
>
> Why didn't you follow the wording I actually suggested, which had the
> virtue of being accurate.

I thought the problem was the use of the word "null string", which
clearly was confusing.

I have updated the docs to use your wording, with a little
clarification. The diff against yesterday's CVS is attached, which is
not smaller.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +