Date: Tue, 15 Oct 2024 20:26:06 -0500
From: Nathan Bossart <nathandbossart@gmail.com>
To: Michael Paquier <michael@paquier.xyz>
Cc: Seino Yuki <seinoyu@oss.nttdata.com>, pgsql-hackers@postgresql.org
Subject: Re: Doc: shared_memory_size_in_huge_pages with the "SHOW" command.
Message-ID: <Zw8WLvyjsbz64NOD@nathan>
References: <420584fd274f9ec4f337da55ffb3b790@oss.nttdata.com>
 <Zw8JdU_LzvuFZ-AG@paquier.xyz>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <Zw8JdU_LzvuFZ-AG@paquier.xyz>
Archived-At: <https://www.postgresql.org/message-id/Zw8WLvyjsbz64NOD%40nathan>
Precedence: bulk

On Wed, Oct 16, 2024 at 09:31:49AM +0900, Michael Paquier wrote:
> I am not sure that neither mentioning nor recommending SHOW for this
> area is a good idea, the point being to encourage its use before the
> server is running as we don't want to allocate anything when tuning
> it.

Agreed.

> Point taken that the current wording can be confusing because of the
> "*must* be shut down".  How about doing a simpler s/must/should/ for a
> softer wording?

Well, the point is that you can't use "postgres -C" to view this GUC while
the server is running.  I can see how the present wording might be
misinterpreted, though.  Perhaps we should change this sentence to
something like:

	Note that the server must be shut down to view this runtime-computed
	parameter with the postgres command.

-- 
nathan