Re: Undocumented optionality of handler_statements - Mailing list pgsql-docs

From Michael Paquier
Subject Re: Undocumented optionality of handler_statements
Date
Msg-id Zp7tqLSTbBaBTUlP@paquier.xyz
Whole thread Raw
In response to Undocumented optionality of handler_statements  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: Undocumented optionality of handler_statements
List pgsql-docs
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#PLPGSQL-ERROR-TRAPPING
> handler_statements are documented as optional.
>
> However, the following example shows that handler_statements can be omitted.

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

Attachment

pgsql-docs by date:

Previous
From: Philipp Salvisberg
Date:
Subject: Re: Undocumented count in FORWARD/BACKWARD direction of MOVE statement
Next
From: "Zhijie Hou (Fujitsu)"
Date:
Subject: RE: Correction in doc of failover ready steps