Re: [HACKERS] pg_ctl man page - Mailing list pgsql-hackers

From Tatsuo Ishii
Subject Re: [HACKERS] pg_ctl man page
Date
Msg-id 20000206154003R.t-ishii@sra.co.jp
Whole thread Raw
In response to Re: [HACKERS] pg_ctl man page  (Thomas Lockhart <lockhart@alumni.caltech.edu>)
List pgsql-hackers
> > I have written a man page for pg_ctl. I will appreciate if someone
> > would give me comments on it including grammatical corrections.
> 
> I assume that this is intended for the main documentation set? Then
> I'll be happy to convert this to sgml markup if you haven't done so or
> do not know how. Also, I can make small changes to grammar etc at that
> time.

Oh, thank you very much!

> You probably weren't asking about this, but...
> 
> The switch options "smart", "fast", and "immediate" are imho a bit too
> general. I would suggest that "wait", "stop", and "abort" (or
> something similar) might be better and more direct terms which would
> come to mind for an admin. Though I see that you also have the concept
> of "wait" wrt pg_ctl and the postmaster, to allow pg_ctl to return
> immediately before the effects of the commands are seen. So maybe
> "asychronous" or something similar could be applied to the
> pg_ctl/postmaster relationship, leaving the other terms for the
> pg_ctl/client relationship.

Talking about "smart/fast/immediate," I have refered to them from
comments in postmaster.c probably written by Vadim. So before changing
them I would like to hear from Vadim. Ok?

> I would also suggest dropping "-m <opt>" style switches in favor of
> specific flags, with the last flag specified taking precedence. I'm
> not aware of other utilities having quite that same style.

Sounds resonable. 
--
Tatsuo Ishii


pgsql-hackers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: [HACKERS] Solaris regression tests.
Next
From: Tatsuo Ishii
Date:
Subject: Re: [HACKERS] TODO item