Re: [patch] [doc] Clarify that signal functions have no feedback - Mailing list pgsql-hackers

From Heikki Linnakangas
Subject Re: [patch] [doc] Clarify that signal functions have no feedback
Date
Msg-id fac05ca4-96a4-706d-6a84-6e903fe58dd8@iki.fi
Whole thread Raw
In response to Re: [patch] [doc] Clarify that signal functions have no feedback  ("David G. Johnston" <david.g.johnston@gmail.com>)
List pgsql-hackers
On 17/11/2020 21:50, David G. Johnston wrote:
> On Tue, Nov 17, 2020 at 6:13 AM Heikki Linnakangas <hlinnaka@iki.fi 
> <mailto:hlinnaka@iki.fi>> wrote:
>     You can use the <link
>     linkend="view-pg-file-settings">pg_file_settings</link> and <link
>     linkend="view-pg-hba-file-rules">pg_hba_file_rules</link> views to
>     check
>     the configuration files for possible errors, before reloading.
> 
> 
> I agree with adding "why" you want to check those links, and added a bit 
> about why doing so before reloading works, but the phrasing using "You" 
> seems out-of-place in this region of the documentation.

There are plenty of "you"s in the docs. Matter of taste, for sure, but 
I'd prefer more active voice. Me being stubborn, I pushed this using my 
wording. :-)

Thanks!

- Heikki



pgsql-hackers by date:

Previous
From: Daniel Gustafsson
Date:
Subject: Re: Move OpenSSL random under USE_OPENSSL_RANDOM
Next
From: Amit Kapila
Date:
Subject: Re: [HACKERS] logical decoding of two-phase transactions