From: Lele Gaifax <lele@metapensiero.it>
To: pgsql-bugs@lists.postgresql.org
Subject: Spurious curly bracket in "CREATE FUNCTION"/"CREATE PROCEDURE" doc
Date: Mon, 05 Oct 2026 09:48:32 +0200
Message-ID: <87bj98oaen.fsf@metapensiero.it> (raw)
Hi all,
I think I spotted two minor glitches in the documentation for both
"CREATE FUNCTION" and "CREATE PROCEDURE" doc pages.
The detailed entry for the "TRANSFORM" option in their "Parameters"
section (not the "Synopsis" one), has a trailing "}" that I think it is
spurious. It currently shows
TRANSFORM { FOR TYPE type_name } [, ... ] }
Lists which transforms a call to the function should apply...
I can see the same "problem" (assuming it is not me misreading the
syntax) in all versions of the pages (that is, from v14 to "current"
version of PG) visible at https://www.postgresql.org/docs/.
If I am right, the following patch against current master would fix
the problem:
inline patch 1: doc/src/sgml/ref/create_function.sgml, doc/src/sgml/ref/create_procedure.sgml (+2/-2 lines) download inline-1.patchdiff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgmlindex 91148af012d..8e7f4aa08b6 100644--- a/doc/src/sgml/ref/create_function.sgml+++ b/doc/src/sgml/ref/create_function.sgml@@ -273,7 +273,7 @@ CREATE [ OR REPLACE ] FUNCTION
</varlistentry>
<varlistentry>
- <term><literal>TRANSFORM { FOR TYPE <replaceable class="parameter">type_name</replaceable> } [, ... ] }</literal></term>+ <term><literal>TRANSFORM { FOR TYPE <replaceable class="parameter">type_name</replaceable> } [, ... ]</literal></term>
<listitem>
<para>
diff --git a/doc/src/sgml/ref/create_procedure.sgml b/doc/src/sgml/ref/create_procedure.sgmlindex 03a14c86845..2cda4876b59 100644--- a/doc/src/sgml/ref/create_procedure.sgml+++ b/doc/src/sgml/ref/create_procedure.sgml@@ -177,7 +177,7 @@ CREATE [ OR REPLACE ] PROCEDURE
</varlistentry>
<varlistentry>
- <term><literal>TRANSFORM { FOR TYPE <replaceable class="parameter">type_name</replaceable> } [, ... ] }</literal></term>+ <term><literal>TRANSFORM { FOR TYPE <replaceable class="parameter">type_name</replaceable> } [, ... ]</literal></term>
<listitem>
<para>
All the best,
bye, lele.
--
nickname: Lele Gaifax | Seeing Emacs as an editor is like seeing a car
real: Emanuele Gaifas | as a seating-accomodation.
lele@metapensiero.it | -- Karl Voit
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients from your mail client; the link fills in
the headers below: reply via email
Some clients, webmail especially, drop In-Reply-To and References from
a link, and the reply then starts a new thread: use the mbox below.
To: pgsql-bugs@postgresql.org
Cc: lele@metapensiero.it
Subject: Re: Spurious curly bracket in "CREATE FUNCTION"/"CREATE PROCEDURE" doc
In-Reply-To: <87bj98oaen.fsf@metapensiero.it>
References: <87bj98oaen.fsf@metapensiero.it>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox