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.98.2) (envelope-from ) id 1xDdRI-00000000cnc-1dRO for pgsql-bugs@arkaria.postgresql.org; Mon, 05 Oct 2026 07:48:49 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.98.2) (envelope-from ) id 1xDdRH-00000008fnZ-1exo for pgsql-bugs@arkaria.postgresql.org; Mon, 05 Oct 2026 07:48:47 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xDdRG-00000008fnR-3nxg for pgsql-bugs@lists.postgresql.org; Mon, 05 Oct 2026 07:48:47 +0000 Received: from orphu.arstecnica.it ([2a01:4f8:121:4404::1]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xDdRE-00000000URB-0iZB for pgsql-bugs@lists.postgresql.org; Mon, 05 Oct 2026 07:48:46 +0000 From: Lele Gaifax DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=metapensiero.it; s=mail; t=1791186521; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type; bh=djAGvoMtatK2S3jbWMR5unELWhixuQqmcKP5HputxdE=; b=QpgK3gaGQ+HQjV0CHX1Tx8MTuEOKIRAFSQLhH5537T9EkxShaWbW9l+yEgtf7koaeYwn6M bKqHvvMVUk4lA8w0Xyx0jVnMVABj1bbA07E3XoCtTh+vyNmUU1+VHqIbXpqDgDnatezCe6 S0mcTQ/7iviX03bsTrrD6VMxk7hP5oA= 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> MIME-Version: 1.0 Content-Type: text/plain List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk 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 - TRANSFORM { FOR TYPE type_name } [, ... ] } + TRANSFORM { FOR TYPE type_name } [, ... ] 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 - TRANSFORM { FOR TYPE type_name } [, ... ] } + TRANSFORM { FOR TYPE type_name } [, ... ] 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