[PATCH] DOCS: Fix inconsistent text description punctuation in UPDATE FOR PORTION OF

Started by ZizhuanLiu X-MAN2 months ago2 messageshackers
Jump to latest
#1ZizhuanLiu X-MAN
44973863@qq.com

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

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

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

The UPDATE documentation misses a comma before "where" that DELETE has.
For consistency, 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:

0001-DOCS-Fix-missing-comma-in-UPDATE-FOR-PORTION-OF-text.patchapplication/octet-stream; charset=utf-8; name=0001-DOCS-Fix-missing-comma-in-UPDATE-FOR-PORTION-OF-text.patchDownload+1-2
#2Bruce Momjian
bruce@momjian.us
In reply to: ZizhuanLiu X-MAN (#1)
Re: [PATCH] DOCS: Fix inconsistent text description punctuation in UPDATE FOR PORTION OF

On Mon, May 25, 2026 at 06:14:05PM +0800, X-MAN wrote:

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

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

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

The UPDATE documentation misses a comma before "where" that DELETE has.
For consistency, 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.

Good point, patch applied.

--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com

Do not let urgent matters crowd out time for investment in the future.