public inbox for [email protected]  
help / color / mirror / Atom feed
From: =?utf-8?B?WC1NQU4=?= <[email protected]>
To: =?utf-8?B?cGdzcWwtZG9jcw==?= <[email protected]>
Cc: =?utf-8?B?5oiR6Ieq5bex55qE6YKu566x?= <[email protected]>
Subject: [PATCH] DOCS: Fix inconsistent text description punctuation in UPDATE FOR PORTION OF
Date: Mon, 25 May 2026 17:32:58 +0800
Message-ID: <[email protected]> (raw)

Hi,
I noticed an inconsistency in the documentation between UPDATE and DELETE&nbsp;
commands regarding the FOR PORTION OF clause description.&nbsp;


In doc/src/sgml/ref/update.sgml (line 169), the description reads:
&nbsp; "must be in the form ( portion ) where portion is an expression..."&nbsp;


In doc/src/sgml/ref/delete.sgml (line 166), it reads:
&nbsp;"must be&nbsp;in the form ( portion ), where portion is an expression..."&nbsp;


The UPDATE documentation misses a comma before "where" that DELETE has.
For consistency,&nbsp;add the comma to the UPDATE documentation to match DELETE.


I have recompiled the documentation and verified that
share/doc/postgresql/html/sql-update.html and
share/doc/postgresql/html/sql-delete.html are now consistent.


Best regards,
Zizhuan Liu

Attachments:

  [application/octet-stream] 0001-DOCS-Fix-missing-comma-in-UPDATE-FOR-PORTION-OF-text.patch (1.1K, 3-0001-DOCS-Fix-missing-comma-in-UPDATE-FOR-PORTION-OF-text.patch)
  download | inline diff:
From 83f6a5e79706ffd126ce98f3417b93231598afcb Mon Sep 17 00:00:00 2001
From: Zizhuan Liu <[email protected]>
Date: Mon, 25 May 2026 16:59:41 +0800
Subject: [PATCH] DOCS : Fix missing comma in UPDATE FOR PORTION OF text
 description

---
 doc/src/sgml/ref/update.sgml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/src/sgml/ref/update.sgml b/doc/src/sgml/ref/update.sgml
index 92c12c3..dd57bea 100644
--- a/doc/src/sgml/ref/update.sgml
+++ b/doc/src/sgml/ref/update.sgml
@@ -166,7 +166,7 @@ UPDATE [ ONLY ] <replaceable class="parameter">table_name</replaceable> [ * ]
       class="parameter">start_time</replaceable> <literal>TO</literal>
       <replaceable class="parameter">end_time</replaceable>.  Otherwise, it
       must be in the form <literal>(</literal><replaceable
-      class="parameter">portion</replaceable><literal>)</literal> where
+      class="parameter">portion</replaceable><literal>)</literal>, where
       <replaceable class="parameter">portion</replaceable> is an expression
       that yields a value of the same type as <replaceable
       class="parameter">range_column_name</replaceable>.
-- 
2.43.0



reply

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 using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: [PATCH] DOCS: Fix inconsistent text description punctuation in UPDATE FOR PORTION OF
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox