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 ) id 1sW2cw-00CwIJ-Vg for pgsql-docs@arkaria.postgresql.org; Mon, 22 Jul 2024 23:39:34 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1sW2cu-0080gE-D0 for pgsql-docs@arkaria.postgresql.org; Mon, 22 Jul 2024 23:39:32 +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 ) id 1sW2cu-0080fw-4h for pgsql-docs@lists.postgresql.org; Mon, 22 Jul 2024 23:39:32 +0000 Received: from fhigh4-smtp.messagingengine.com ([103.168.172.155]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1sW2cr-000wVZ-7f for pgsql-docs@lists.postgresql.org; Mon, 22 Jul 2024 23:39:31 +0000 Received: from compute2.internal (compute2.nyi.internal [10.202.2.46]) by mailfhigh.nyi.internal (Postfix) with ESMTP id A0C491140180; Mon, 22 Jul 2024 19:39:27 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute2.internal (MEProxy); Mon, 22 Jul 2024 19:39:27 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=paquier.xyz; h= cc:content-type:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:subject :subject:to:to; s=fm3; t=1721691567; x=1721777967; bh=n3hIiGICDA MCuuYziPhCcQnfq1oxB3Q7o2f8N6UqJ5A=; b=JFoPc+LarV5AwjTAGE1sOMTX8U EuzfWCcJ7Osm1R+QwtbK0BhHXi48tI65mM4K9U6ZxpRz1m1g8cuo3CZI+kKn95/I YtXBGDmUO9CK7sQqDcL3ZTdAm0iRTSx3wvvBHUb+nEjkBreHyyjinSxL6eaJ2ZIp fSYcN3qvQruF2iMhEX/xo0UnuXIjY/Vn49YyIpZgaWOIX32gxDsnV0YIHAbkOr3W p1gCTNeoQGxU6wjY0fdv0PRj+P6TRSlR8E2XFzXAaEAKVXfNeoXXYjm2FMr1+6y8 gmxgkLGTlDX0h3niJ7PspfPnvT8684Lqq1jSYLpMeQ6qQhR7Hv1MJbH4VCTw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; t=1721691567; x=1721777967; bh=n3hIiGICDAMCuuYziPhCcQnfq1ox B3Q7o2f8N6UqJ5A=; b=d8rgQGMmdNvCh9VlkuLBan4q8SM2Zc1O1iTaZIA/fD+F 7tEkXWP3knQyVY19P+eF/M8Kx58GYQ2gPMfdGUIHBK9HmAyM7uVM7fAktbXJlyMN V86vJeC8rUWZviVKmFHwNfVHAL9LGMnZ+h8zw3GELeF8t10xrTLqD96TX0/N4xUk 8UpCOD1r1Th474YZuniFUPeTxrApCZP1tTiDk5a/VHHzBPyxknXF+zjBdNfHjJPE d7/z5mxJF6JlMhy6FaxrjthrcwZ+Lf7vLom52f7pMpxdP4KBxvhAb1KebGa7FuSu WufjzTCjHMmIw8S3pFOlcMr8dkt/RnLWEx6QKyqJ6A== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrheekgddvhecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecufghrlhcuvffnffculdefhedmnecujfgurhepfffhvf fukfhfgggtuggjsehgtderredttddvnecuhfhrohhmpefoihgthhgrvghlucfrrghquhhi vghruceomhhitghhrggvlhesphgrqhhuihgvrhdrgiihiieqnecuggftrfgrthhtvghrnh epffdufeeflefghfekudekkeevvddugfeiteekkeduleefvefhhffftdduffeiuedtnecu ffhomhgrihhnpehpohhsthhgrhgvshhqlhdrohhrghenucevlhhushhtvghrufhiiigvpe dtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehmihgthhgrvghlsehprghquhhivghrrdig hiii X-ME-Proxy: Feedback-ID: i0fe9450f:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon, 22 Jul 2024 19:39:26 -0400 (EDT) Date: Tue, 23 Jul 2024 08:39:20 +0900 From: Michael Paquier To: philipp.salvisberg@gmail.com, pgsql-docs@lists.postgresql.org Subject: Re: Undocumented optionality of handler_statements Message-ID: References: <172165655256.710.2097726158572647813@wrigleys.postgresql.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="EjsifxJ7fTjpge1u" Content-Disposition: inline In-Reply-To: <172165655256.710.2097726158572647813@wrigleys.postgresql.org> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --EjsifxJ7fTjpge1u Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jul 22, 2024 at 01:55:52PM +0000, PG Doc comments form wrote: > In > https://www.postgresql.org/docs/16/plpgsql-control-structures.html#PLPGSQ= L-ERROR-TRAPPING > handler_statements are documented as optional. >=20 > However, the following example shows that handler_statements can be omitt= ed. You have a good point. This could be clarified better in the documentation by making handler_statements conditional with square brackets around it. I'd rather add an extra sentence to tell that not specifying handler_statements is equivalent to taking no action. Perhaps you would like to write a patch? -- Michael --EjsifxJ7fTjpge1u Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAmae7agACgkQnvQgOdby QH3zSBAAqs4Q1LSf+UTxvExezoaKTAPwX90M+lIRXA836L4y8CIOHrqo5DeF7cEH vzMz8oHReNPenR4lhD0kM98G2sF+6CkgJ6+WGLkBbepV35NAi+MYlZ38QNKaDVHT 6djpQXlGdhCeK2Yb7oFIscdFuUY8P3rJnFXIadgztZwBhGzfwgHbCtLdWOq1mb6E uEj45QRbgKff8/ZzEQ35Zr5//qpYr2CNRPXdH1ZKMyu/ph21iDZwOScwfd8NNclI zSw0+Zj1NFoGUvdKcs7HGtxGxkIUuTcRCwp3xuJDa9LOVGHurLJnRa20PdiK5Jnk qkzL+0bwiY1/sEfs/b2gwE1qjdp2CSFCeEuUeC0eZM0rfS2OMpDoG/xYt4lxsibF WUszArvwc78Vjr2MSTj9cHMB81aCMd8G51UugHasvYpn2hHfjA8zrGgr59KXLzuf S4HJLfPeASnK/vihTwsDzLjEepOSt2cB7YyospLrncysv+71CPlC5BZ3UOx+v2Nh tSBdWySm8tAjvvaWhOIGUsZmcJTorzegW0+11A4Ij9cz/oUJLGQvkyRFAQ1WLfAb G4yJin22pMwzUj0oqZPFOWgE0OR2cC8S5GVk0iW+HJyLSQPgJj1UPbB1PLyEyl0c ayJyjOxtzoWZR+58CcD1iyosCLC3vKeaL5TnHI5EuGdwE1DUXQ0= =enfh -----END PGP SIGNATURE----- --EjsifxJ7fTjpge1u--