Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps  (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1t0xZ1-00DzkB-BF
	for pgsql-hackers@arkaria.postgresql.org; Wed, 16 Oct 2024 06:31:19 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.94.2)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1t0xYz-00Gci9-4Y
	for pgsql-hackers@arkaria.postgresql.org; Wed, 16 Oct 2024 06:31:17 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps  (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <masao.fujii@oss.nttdata.com>)
	id 1t0xYy-00GcdA-Qa
	for pgsql-hackers@lists.postgresql.org; Wed, 16 Oct 2024 06:31:17 +0000
Received: from oss.nttdata.com ([49.212.34.109])
	by makus.postgresql.org with esmtps  (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <masao.fujii@oss.nttdata.com>)
	id 1t0xYw-0018FB-5r
	for pgsql-hackers@postgresql.org; Wed, 16 Oct 2024 06:31:15 +0000
Received: from [192.168.179.2] (mo1-77-161-141.air.mopera.net [1.77.161.141])
	by oss.nttdata.com (Postfix) with ESMTPSA id 504C76139F;
	Wed, 16 Oct 2024 15:31:09 +0900 (JST)
X-Virus-Status: Clean
X-Virus-Scanned: clamav-milter 0.103.11 at oss.nttdata.com
Message-ID: <755f74a1-d50a-4411-aed2-d8cf09764865@oss.nttdata.com>
Date: Wed, 16 Oct 2024 15:31:05 +0900
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: Doc: shared_memory_size_in_huge_pages with the "SHOW" command.
Content-Language: en-US
To: Michael Paquier <michael@paquier.xyz>,
 Nathan Bossart <nathandbossart@gmail.com>
Cc: Seino Yuki <seinoyu@oss.nttdata.com>, pgsql-hackers@postgresql.org
References: <420584fd274f9ec4f337da55ffb3b790@oss.nttdata.com>
 <Zw8JdU_LzvuFZ-AG@paquier.xyz> <Zw8WLvyjsbz64NOD@nathan>
 <Zw9MmGecS9QHF4qh@paquier.xyz>
From: Fujii Masao <masao.fujii@oss.nttdata.com>
In-Reply-To: <Zw9MmGecS9QHF4qh@paquier.xyz>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
List-Id: <pgsql-hackers.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-hackers@lists.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-hackers>
Archived-At: <https://www.postgresql.org/message-id/755f74a1-d50a-4411-aed2-d8cf09764865%40oss.nttdata.com>
Precedence: bulk



On 2024/10/16 14:18, Michael Paquier wrote:
> On Tue, Oct 15, 2024 at 08:26:06PM -0500, Nathan Bossart wrote:
>> 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.
> 
> I'm OK with the "postgres command" addition.

Another idea is to use the same wording as for num_os_semaphores in runtime.sgml, like this:

     This parameter can be viewed
     before starting the server with a <command>postgres</command> command like:

Regards,

-- 
Fujii Masao
Advanced Computing Technology Center
Research and Development Headquarters
NTT DATA CORPORATION