minor doc / usage fixes

Started by Neil Conwayover 23 years ago6 messagespatches
Jump to latest
#1Neil Conway
neilc@samurai.com

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

Attachments:

minor-doc-improv-2.patchtext/x-patch; charset=ANSI_X3.4-1968; name=minor-doc-improv-2.patchDownload+38-38
#2Peter Eisentraut
peter_e@gmx.net
In reply to: Neil Conway (#1)
Re: minor doc / usage fixes

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

#3Neil Conway
neilc@samurai.com
In reply to: Peter Eisentraut (#2)
Re: minor doc / usage fixes

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

#4Peter Eisentraut
peter_e@gmx.net
In reply to: Neil Conway (#3)
Re: minor doc / usage fixes

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

#5Bruce Momjian
bruce@momjian.us
In reply to: Neil Conway (#1)
Re: minor doc / usage fixes

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
#6Bruce Momjian
bruce@momjian.us
In reply to: Neil Conway (#1)
Re: minor doc / usage fixes

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