public inbox for [email protected]  

help / color / mirror / Atom feed

From: Alvaro Herrera <[email protected]>
To: David G. Johnston <[email protected]>
Cc: Euler Taveira <[email protected]>
Cc: Jeff Janes <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: "Alter system" command documentation
Date: Mon, 15 Jun 2015 22:14:20 -0300
Message-ID: <[email protected]> (raw)
In-Reply-To: <CAKFQuwZnoQKAi9qu_Vb6njo30x46MWZDNSExkvbs+hiOdjmHAA@mail.gmail.com>
References: <CAMkU=1xjSYan=T518E+=J4Ugg8xkymjx5a_hSFx1roB-chKyxw@mail.gmail.com>
	<[email protected]>
	<CAKFQuwZnoQKAi9qu_Vb6njo30x46MWZDNSExkvbs+hiOdjmHAA@mail.gmail.com>
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>

David G. Johnston wrote:
> On Mon, Jun 15, 2015 at 4:58 PM, Euler Taveira <[email protected]> wrote:
> 
> > On 15-06-2015 13:32, Jeff Janes wrote:

> > > Isn't it unfortunate that the command used for changing the
> > > configuration file from within SQL mentions SIGHUP and pg_ctl
> > > reload, but not "select pg_reload_conf();", as a way to activate
> > > that change?
> > >
> > SIGHUP is an implementation detail. If I were to change that
> > sentence, my preference is replace SIGHUP with pg_reload_conf.
> 
> I disagree on SIGHUP being an implementation detail.  Using signals in
> IPC (inter-process communication) is a public API that should be
> documented when applicable.

Agreed.  However, I don't think it makes sense to document that either
SIGHUP, pg_ctl reload, and pg_reload_conf() can be used whenever a
parameter reload is mentioned; that would bloat too much (in a quick
grep, I see at least 10-15 places where SIGHUP or "reload" is mentioned
in the context of config files.)  Maybe we should have one section
somewhere, saying "reload is executed by any of the following:" and list
them all.  Then this place and others could simply say "these values are
effective after reload, about which see section X.Y.Z".

-- 
Álvaro Herrera                http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

view thread (6+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected]
  Subject: Re: "Alter system" command documentation
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox