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 1pNAhc-0006XU-Et
	for pgsql-hackers@arkaria.postgresql.org; Wed, 01 Feb 2023 10:50:56 +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 1pNAhb-0002Dw-1n
	for pgsql-hackers@arkaria.postgresql.org; Wed, 01 Feb 2023 10:50:55 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <ilmari@ilmari.org>)
	id 1pNAha-0002CO-8T
	for pgsql-hackers@lists.postgresql.org; Wed, 01 Feb 2023 10:50:54 +0000
Received: from wout5-smtp.messagingengine.com ([64.147.123.21])
	by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <ilmari@ilmari.org>)
	id 1pNAhS-0001M5-Uf
	for pgsql-hackers@postgresql.org; Wed, 01 Feb 2023 10:50:53 +0000
Received: from compute1.internal (compute1.nyi.internal [10.202.2.41])
	by mailout.west.internal (Postfix) with ESMTP id BE028320055E;
	Wed,  1 Feb 2023 05:50:44 -0500 (EST)
Received: from mailfrontend2 ([10.202.2.163])
  by compute1.internal (MEProxy); Wed, 01 Feb 2023 05:50:44 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ilmari.org; h=cc
	:cc:content-type:date:date:from:from:in-reply-to:in-reply-to
	:message-id:mime-version:references:reply-to:sender:subject
	:subject:to:to; s=fm3; t=1675248644; x=1675335044; bh=D/EACfKDCB
	X54Dl34+w14g06QpYjx3t14yEpleVH6FY=; b=RhvMd2IBpG84INAepguq/xi23P
	NYq16ProY1ZfDAmj24krOxr26gdNHuIPB35JO7QIBGB1hb1QmVBser1hTywlHLka
	aFk5EkRanR05UmwRy4Uu63Ji9BVhQhe2J2YyInZUmhBp5k/OOYMkpHMfHZwyhnZR
	6y5DAshpguyVb5QxHb4MYsAlYzUgnD/GTyMlAx1617uSbBQ6O483eoiFGkMwC/BB
	QFiOFXsVwk1Xy8eveAcFD3CKgtxaygHW34SztPXGg0RkH8FlIve5o5IKHo4vjn5A
	4ymng3y/e1Oy3LxDmsB2qJITmHk3jeR82MsdgVppFOLCvVcWZ7KYiQrQCaVQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
	messagingengine.com; h=cc:cc: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=
	fm3; t=1675248644; x=1675335044; bh=D/EACfKDCBX54Dl34+w14g06QpYj
	x3t14yEpleVH6FY=; b=Pi/FQa3RdymAPPcTpOEvK9WP1eWRqXteSdlnAs8frOb9
	86ih6NVFxfw3SYL9k81AvxUf2lWeOLWXcnKEVFTyPPNZ/DH6tnhclgiBlAynT5Nu
	OI8alTLUHaiiU+wWAznMm/Gn5tYWFPcp8hlWXqqKFjfNZTbsJKuC7XX0famn3wWt
	/mMZLUvPkvNJ4G5GX/cjtb7J7PZ2Jhz/FLvxcearCK0xAMc7BGe4gUPsiLCjGKag
	krPjsKxEuxhiLPHuujZVa2QRvR2hEn/GnwO8d5BetF4AlVrE9OZYaqAS5YFmzxoT
	UeRGZ7sIy2sDGW223XeubEm4b+u7U0ULjsMq+Zv9dQ==
X-ME-Sender: <xms:BETaYy6ehANOgD-K1jVsYW3iNsFRO923z8GOEn_aRJs1vWaM_wtiQg>
    <xme:BETaY77J8qPuRC7F565FTzhha5QbIKYZcsjOnwQFhb_nBk16eMZDM4mFC7pbtTvA1
    SCAACFuy-bm3M5Y8FU>
X-ME-Received: 
 <xmr:BETaYxfyKKb8NZ7yJstf4D-S1IprPJK9Uu-noZx5uD-z4MdFp5MGoxrNVSWMLam8vVP38t1J26XFgAVHBA>
X-ME-Proxy-Cause: 
 gggruggvucftvghtrhhoucdtuddrgedvhedrudefiedgvdduucetufdoteggodetrfdotf
    fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen
    uceurghilhhouhhtmecufedttdenucenucfjughrpefhvfevufhfffgjkfgfgggtsehttd
    ertddtreejnecuhfhrohhmpeffrghgfhhinhhnucfklhhmrghrihcuofgrnhhnshonkhgv
    rhcuoehilhhmrghrihesihhlmhgrrhhirdhorhhgqeenucggtffrrghtthgvrhhnpeekle
    ejueefhfffkefhkedtfeeluedvieeihfehfeeffeeggeduffduheejjeeigfenucevlhhu
    shhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehilhhmrghrihesih
    hlmhgrrhhirdhorhhg
X-ME-Proxy: <xmx:BETaY_IpB-2MD52HB_RIlcoZI-VqEvE2ODAwode2E-sIpm0FhrEFOw>
    <xmx:BETaY2IMGB-oMn67oVwMNp-cSl-tQKBl_akhl-K0s4qFlhDsUlMy6Q>
    <xmx:BETaYwzum7-k2zuIi0GWCuzCJK9cwzQ-Xy39ewIgr-0I3Kehw_7DEg>
    <xmx:BETaYwybQ0i800k8Cqvk-6snm70ljrtt8t9KxPJDnYDcWtBbGR0e8A>
Feedback-ID: i1ff147bf:Fastmail
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed,
 1 Feb 2023 05:50:43 -0500 (EST)
From: =?utf-8?Q?Dagfinn_Ilmari_Manns=C3=A5ker?= <ilmari@ilmari.org>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: pgsql-hackers@postgresql.org
Subject: Re: Clarify deleting comments and security labels in synopsis
References: <87sffqk4zp.fsf@wibble.ilmari.org>
	<1139370.1675186526@sss.pgh.pa.us> <87pmauk27g.fsf@wibble.ilmari.org>
	<1224866.1675191141@sss.pgh.pa.us>
Date: Wed, 01 Feb 2023 10:50:42 +0000
In-Reply-To: <1224866.1675191141@sss.pgh.pa.us> (Tom Lane's message of "Tue,
	31 Jan 2023 13:52:21 -0500")
Message-ID: <87mt5xk6bh.fsf@wibble.ilmari.org>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
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/87mt5xk6bh.fsf%40wibble.ilmari.org>
Precedence: bulk

Tom Lane <tgl@sss.pgh.pa.us> writes:

> =?utf-8?Q?Dagfinn_Ilmari_Manns=C3=A5ker?= <ilmari@ilmari.org> writes:
>> Tom Lane <tgl@sss.pgh.pa.us> writes:
>>> Agreed; as-is, the syntax summary is not just confusing but outright
>>> wrong.
>>> 
>>> I think we could go further and split the entry under Parameters
>>> to match:
>
>> Makes sense. Something like the attached v2?
>
> WFM, will push.

Thanks!

> 			regards, tom lane

- ilmari