Thread: minor doc / usage fixes

minor doc / usage fixes

From
Neil Conway
Date:
This patch fixes an error in the usage message for 'clusterdb', and
makes a few editorial changes to the documentation.

Cheers,

Neil
--
Neil Conway <neilc@samurai.com> || PGP Key ID: DB3C29FC



Attachment

Re: minor doc / usage fixes

From
Peter Eisentraut
Date:
Neil Conway writes:

> This patch fixes an error in the usage message for 'clusterdb', and
> makes a few editorial changes to the documentation.

Why do you add periods to the end of phrases that are not sentences?

--
Peter Eisentraut   peter_e@gmx.net


Re: minor doc / usage fixes

From
Neil Conway
Date:
On Mon, 2003-01-27 at 16:10, Peter Eisentraut wrote:
> Why do you add periods to the end of phrases that are not sentences?

Because my understanding is that the phrase "Connect as the given user"
is an imperative sentence. I won't pretend to be an expert in grammar
though.

If you'd like to argue that including a period is incorrect, that's fair
enough -- but please make that kind of policy consistent: other
sentences of the same form in that document include a period ("Include
large objects in dump.", "Dump data for table only.", etc.)

Cheers,

Neil
--
Neil Conway <neilc@samurai.com> || PGP Key ID: DB3C29FC



Re: minor doc / usage fixes

From
Peter Eisentraut
Date:
Neil Conway writes:

> If you'd like to argue that including a period is incorrect, that's fair
> enough -- but please make that kind of policy consistent: other
> sentences of the same form in that document include a period ("Include
> large objects in dump.", "Dump data for table only.", etc.)

I'm not particularly attached to either format.  I just vaguely recall
that I made a conscious effort to keep this distinction when I wrote the
text in question, and now I was wondering why someone else made a
conscious effort to do it differently.

--
Peter Eisentraut   peter_e@gmx.net


Re: minor doc / usage fixes

From
Bruce Momjian
Date:
Your patch has been added to the PostgreSQL unapplied patches list at:

    http://momjian.postgresql.org/cgi-bin/pgpatches

I will try to apply it within the next 48 hours.

---------------------------------------------------------------------------


Neil Conway wrote:
> This patch fixes an error in the usage message for 'clusterdb', and
> makes a few editorial changes to the documentation.
>
> Cheers,
>
> Neil
> --
> Neil Conway <neilc@samurai.com> || PGP Key ID: DB3C29FC
>
>

[ Attachment, skipping... ]

>
> ---------------------------(end of broadcast)---------------------------
> TIP 2: you can get off all lists at once with the unregister command
>     (send "unregister YourEmailAddressHere" to majordomo@postgresql.org)

--
  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

Re: minor doc / usage fixes

From
Bruce Momjian
Date:
Patch applied.  Thanks.

---------------------------------------------------------------------------


Neil Conway wrote:
> This patch fixes an error in the usage message for 'clusterdb', and
> makes a few editorial changes to the documentation.
>
> Cheers,
>
> Neil
> --
> Neil Conway <neilc@samurai.com> || PGP Key ID: DB3C29FC
>
>

[ Attachment, skipping... ]

>
> ---------------------------(end of broadcast)---------------------------
> TIP 2: you can get off all lists at once with the unregister command
>     (send "unregister YourEmailAddressHere" to majordomo@postgresql.org)

--
  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