Spurious curly bracket in "CREATE FUNCTION"/"CREATE PROCEDURE" doc

From: Lele Gaifax <lele(at)metapensiero(dot)it>
To: pgsql-bugs(at)lists(dot)postgresql(dot)org
Subject: Spurious curly bracket in "CREATE FUNCTION"/"CREATE PROCEDURE" doc
Date: 2026-10-05 07:48:32
Message-ID: 87bj98oaen.fsf@metapensiero.it
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-bugs

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:

diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml
index 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.sgml
index 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(at)metapensiero(dot)it | -- Karl Voit

Responses

Browse pgsql-bugs by date

  From Date Subject
Next Message Andrey Borodin 2026-10-05 09:47:05 Re: BUG #19738: `uuidv7(interval)` rejects sub-millisecond timestamps within the final 48-bit millisecond
Previous Message Rahul 2026-10-05 07:19:12 Re: BUG #17545: Incorrect selectivity for IS NOT DISTINCT FROM and NULLs