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-hackers-owner+archive@lists.postgresql.org>)
	id 1nt5yk-0004HV-Jk
	for pgsql-hackers@arkaria.postgresql.org; Mon, 23 May 2022 11:12:02 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1nt5yj-0006tD-I2
	for pgsql-hackers@arkaria.postgresql.org; Mon, 23 May 2022 11:12:01 +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 <peter.eisentraut@enterprisedb.com>)
	id 1nt5yi-0006t4-KG
	for pgsql-hackers@lists.postgresql.org; Mon, 23 May 2022 11:12:01 +0000
Received: from wout3-smtp.messagingengine.com ([64.147.123.19])
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <peter.eisentraut@enterprisedb.com>)
	id 1nt5yc-0004UM-Uv
	for pgsql-hackers@lists.postgresql.org; Mon, 23 May 2022 11:12:00 +0000
Received: from compute2.internal (compute2.nyi.internal [10.202.2.46])
	by mailout.west.internal (Postfix) with ESMTP id B98B73200950;
	Mon, 23 May 2022 07:11:50 -0400 (EDT)
Received: from mailfrontend1 ([10.202.2.162])
  by compute2.internal (MEProxy); Mon, 23 May 2022 07:11:51 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
	messagingengine.com; h=cc:cc:content-transfer-encoding
	:content-type:date:date:feedback-id:feedback-id:from:from
	:in-reply-to:in-reply-to:message-id:mime-version:references
	:reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy
	:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1653304310; x=
	1653390710; bh=k/8mujOdUBJVnla7aQgmwTwrl4JRqIyiJKsylxtEahM=; b=A
	ZLiyMT1FgKXKLD4tp7evxM7Ak4mC58nk+6sDj+Ss/B2w5wD5IxnX0lK/ob/b9SyK
	fDXOdGAL5pumPVB2BY+vRlQEDrUPiEC2Xa66VCKlq2fcRxMOtET1fq1tjVh9ITgG
	icCPdotwHY//CVPNsU5hDlwnBINSQSdhG6UHrMe2JtaTkq1G5/YKPsDe6c/sd6Zu
	QT+cnSnkW7739zHTJs/3ZXL+evXLYERq8JQdwmITu3k0SiuAgQ+puIUIBnwE3TPT
	OUxLcpwdy+zA898c7pt3ZKqf3EU1uhQeLIZNTidBj33771XshXxiUrShVDMu3YHL
	uWKeABOvPeljSo8RyXFsA==
X-ME-Sender: <xms:9WuLYg42KASLTHK7OYVzcCAO2nmNax5Z1f2odUYmPXHOi-v1V6WxyQ>
    <xme:9WuLYh60jSYXA1Xx71EaHwpYkI0kdepK6QkNLPaeLGZsUvSOHpDeazG3u07int97T
    x6xdWTxquslEOHqDQ>
X-ME-Received: 
 <xmr:9WuLYvf8MMGUORP1lzWSYaIjr4hPlkSwrhRAgog2qjuQnzmG2MNyuaJ_b-BekBebrrdiQkdcDQANjxkQWpIbgrHs4FT_JdA>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgedvfedrjedugddtjecutefuodetggdotefrodftvf
    curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu
    uegrihhlohhuthemuceftddtnecunecujfgurhepkfffgggfuffvvehfhfgjtgfgsehtje
    ertddtfeejnecuhfhrohhmpefrvghtvghrucfgihhsvghnthhrrghuthcuoehpvghtvghr
    rdgvihhsvghnthhrrghuthesvghnthgvrhhprhhishgvuggsrdgtohhmqeenucggtffrrg
    htthgvrhhnpeehleffgeegudejteeihfelteduvdeifffhffdvjedvffegjeekudeludeh
    udeifeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpe
    hpvghtvghrrdgvihhsvghnthhrrghuthesvghnthgvrhhprhhishgvuggsrdgtohhm
X-ME-Proxy: <xmx:9WuLYlILue8iEtWgyurbT9OOq4GtsIF3aRGgwATzJhq_e8SZpBe9Xw>
    <xmx:9WuLYkJC0Rlz6TkHWN6aq_27AstLYc2H1nX3S3OAcS7gg-xj37fLNQ>
    <xmx:9WuLYmweX9HA4z49PhOrCOfpJBA6qpVj5ZX9gDRvYODR15SHVuUSig>
    <xmx:9muLYhDp9IZdafhi5Yv7kGaNuQAoE32y-lI27qURvjaLnWNuJvM6eg>
Feedback-ID: i131946ab:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon,
 23 May 2022 07:11:49 -0400 (EDT)
Message-ID: <87acb592-4111-fe5a-6be9-37cf84902489@enterprisedb.com>
Date: Mon, 23 May 2022 13:11:47 +0200
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0)
 Gecko/20100101 Thunderbird/91.9.0
Subject: Re: create_help.pl treats <literal> as replaceable
Content-Language: en-US
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Kyotaro Horiguchi <horikyota.ntt@gmail.com>,
 pgsql-hackers@lists.postgresql.org
References: <20220517.174342.1884842412165214815.horikyota.ntt@gmail.com>
 <1581685.1652800163@sss.pgh.pa.us>
 <b4773b4a-3c2c-336a-6904-297d9accd5dc@enterprisedb.com>
 <17623.1652891345@sss.pgh.pa.us>
From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
In-Reply-To: <17623.1652891345@sss.pgh.pa.us>
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/87acb592-4111-fe5a-6be9-37cf84902489%40enterprisedb.com>
Precedence: bulk

On 18.05.22 18:29, Tom Lane wrote:
> I think you should have upper-cased MATCH while at it, to make it clear
> that it acts like a keyword in this context.  The current situation is
> quite unreadable in plain-ASCII output:
> 
> regression=# \help copy
> Command:     COPY
> ...
>      HEADER [ boolean | match ]
> ...
> 
> Since "boolean" is a metasyntactic variable here, it's absolutely
> not obvious that "match" isn't.

done