Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1oEMkK-00073r-BN
	for pgsql-docs@arkaria.postgresql.org; Thu, 21 Jul 2022 03:21:04 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1oEMkJ-00031H-6H
	for pgsql-docs@arkaria.postgresql.org; Thu, 21 Jul 2022 03:21:03 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <masao.fujii@oss.nttdata.com>)
	id 1oEMkI-0002yu-VJ
	for pgsql-docs@lists.postgresql.org; Thu, 21 Jul 2022 03:21:02 +0000
Received: from oss.nttdata.com ([49.212.34.109])
	by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <masao.fujii@oss.nttdata.com>)
	id 1oEMkG-0005Hn-QC
	for pgsql-docs@postgresql.org; Thu, 21 Jul 2022 03:21:02 +0000
Received: from [10.6.216.52] (unknown [203.180.48.65])
	by oss.nttdata.com (Postfix) with ESMTPSA id B1956605CE;
	Thu, 21 Jul 2022 12:20:57 +0900 (JST)
X-Virus-Status: Clean
X-Virus-Scanned: clamav-milter 0.103.6 at oss.nttdata.com
Message-ID: <20032f53-f64a-c8f0-c0d1-3736a63fc464@oss.nttdata.com>
Date: Thu, 21 Jul 2022 12:20:57 +0900
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0)
 Gecko/20100101 Thunderbird/91.11.0
Subject: Re: list of flags that pg_settings_get_flags reports
Content-Language: en-US
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Michael Paquier <michael@paquier.xyz>, pgsql-docs@postgresql.org
References: <20220720090710.5rbmjs5ldsynjdia@alvherre.pgsql>
From: Fujii Masao <masao.fujii@oss.nttdata.com>
In-Reply-To: <20220720090710.5rbmjs5ldsynjdia@alvherre.pgsql>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
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>
Archived-At: 
 <https://www.postgresql.org/message-id/20032f53-f64a-c8f0-c0d1-3736a63fc464%40oss.nttdata.com>
Precedence: bulk



On 2022/07/20 18:07, Alvaro Herrera wrote:
> Hello
> 
> On 2022-Jul-20, Fujii Masao wrote:
> 
>> Attached is the updated version of the patch. It separates the list
>> for GUC flags from the table entry for pg_settings_get_flags() and
>> adds the table for it at the bottom of the existing function table.
> 
> I lament the fact that the version of DocBook we use doesn't let us add
> captions; it would be much better to have "Flags to use with function
> pg_settings_get_flags()" under the table; unadorned, you have to guess
> or search.

Or, though it's not a caption under the table, it's better to have "Flags to use with function pg_settings_get_flags()" in the title of the table as follows?

    <table id="functions-pg-settings-flags">
-   <title>GUC Flags</title>
+   <title>GUC Flags To Use With Function pg_settings_get_flags()</title>
     <tgroup cols="2">

Regards,

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