pgsql: Update wording for 8.1.X, remove <only>: This option can

Started by Bruce Momjianover 20 years ago5 messagescomitters
Jump to latest
#1Bruce Momjian
bruce@momjian.us

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&amp;r2=1.36.2.2)

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruce Momjian (#1)
Re: pgsql: Update wording for 8.1.X, remove <only>: This option can

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

#3Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#2)
Re: pgsql: Update wording for 8.1.X, remove <only>: This

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
#4Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruce Momjian (#3)
Re: pgsql: Update wording for 8.1.X, remove <only>: This

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

#5Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#4)
Re: pgsql: Update wording for 8.1.X, remove <only>: This

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