Обсуждение: pgsql: Update wording for 8.1.X, remove : This option can

Log Message:
-----------
Update wording for 8.1.X, remove <only>:

        This option can <only> be set at server start or in the
        <filename>postgresql.conf</filename> configuration file.

Tags:
----
REL8_1_STABLE

Modified Files:
--------------
    pgsql/doc/src/sgml:
        config.sgml (r1.36.2.1 -> r1.36.2.2)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/config.sgml.diff?r1=1.36.2.1&r2=1.36.2.2)

momjian@postgresql.org (Bruce Momjian) writes:
> Log Message:
> -----------
> Update wording for 8.1.X, remove <only>:

>         This option can <only> be set at server start or in the
>         <filename>postgresql.conf</filename> configuration file.

It wasn't confusing, and now it's incorrect.

If you didn't like the wording when I suggested it, why didn't you
join that discussion?

            regards, tom lane

Tom Lane wrote:
> momjian@postgresql.org (Bruce Momjian) writes:
> > Log Message:
> > -----------
> > Update wording for 8.1.X, remove <only>:
>
> >         This option can <only> be set at server start or in the
> >         <filename>postgresql.conf</filename> configuration file.
>
> It wasn't confusing, and now it's incorrect.
>
> If you didn't like the wording when I suggested it, why didn't you
> join that discussion?

This is only for the 8.1.X wording, not the newer HEAD wording.  I
thought the 8.1.X wording was old.  Why is it wrong?  Feel free to
revert it.

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073

Bruce Momjian <pgman@candle.pha.pa.us> writes:
> This is only for the 8.1.X wording, not the newer HEAD wording.  I
> thought the 8.1.X wording was old.  Why is it wrong?  Feel free to
> revert it.

Oh, my mistake, I was thinking you had reverted the newer wording.
Still, it seems wrong to me, because omitting "only" essentially
turns the statement into a no-op.  We wouldn't bother to say anything
if you could set the parameter whenever you wanted.

We could back-patch the newer wording if you want a change.

            regards, tom lane

Tom Lane wrote:
> Bruce Momjian <pgman@candle.pha.pa.us> writes:
> > This is only for the 8.1.X wording, not the newer HEAD wording.  I
> > thought the 8.1.X wording was old.  Why is it wrong?  Feel free to
> > revert it.
>
> Oh, my mistake, I was thinking you had reverted the newer wording.
> Still, it seems wrong to me, because omitting "only" essentially
> turns the statement into a no-op.  We wouldn't bother to say anything
> if you could set the parameter whenever you wanted.
>
> We could back-patch the newer wording if you want a change.

I only know the person was confused by the wording "Only X or Y" when X
and Y are fairly complex phrases, so I just removed "only".  I just said
"X or Y", which seems to still cover it.  Again, adjust however you
wish.

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073