Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1i2jaI-00067x-06
	for pgsql-docs@arkaria.postgresql.org; Tue, 27 Aug 2019 22:05:02 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.89)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1i2jaG-00034s-Sb
	for pgsql-docs@arkaria.postgresql.org; Tue, 27 Aug 2019 22:05:00 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1i2jaG-00034h-L2; Tue, 27 Aug 2019 22:05:00 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1i2jaD-0007bU-9s; Tue, 27 Aug 2019 22:05:00 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id x7RM4r7j003900;
	Tue, 27 Aug 2019 18:04:53 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Ian Barwick <ian.barwick@2ndquadrant.com>
cc: "pgsql-hackers@postgresql.org" <pgsql-hackers@postgresql.org>,
        pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: doc: clarify "pg_signal_backend" default role
In-reply-to: <89907e32-76f3-7282-a89c-ea19c722fe5d@2ndquadrant.com>
References: <89907e32-76f3-7282-a89c-ea19c722fe5d@2ndquadrant.com>
Comments: In-reply-to Ian Barwick <ian.barwick@2ndquadrant.com>
	message dated "Mon, 10 Jun 2019 11:06:54 +0900"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <3894.1566943493.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Tue, 27 Aug 2019 18:04:53 -0400
Message-ID: <3895.1566943493@sss.pgh.pa.us>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Precedence: bulk

Ian Barwick <ian.barwick@2ndquadrant.com> writes:
> Currently the documentation for the default role "pg_signal_backend" sta=
tes,
> somewhat ambiguously, "Send signals to other backends (eg: cancel query,=
 terminate)",
> giving the impression other signals (e.g. SIGHUP) can be sent too, which=
 is
> currently not the case.
> Attached patch clarifies this, adds a descriptive paragraph (similar to =
what
> the other default roles have) and a link to the "Server Signaling Functi=
ons"
> section.

Pushed with minor tweaking.

(Note: patches are less likely to fall through the cracks if you
add them to the commitfest page.)

			regards, tom lane