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

Started by ZizhuanLiu X-MANabout 2 months ago3 messagesdocs

44973863@qq.com

about 2 months ago

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

Paul A Jungwirth

pj@illuminatedcomputing.com

about 2 months ago

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 2:33 AM X-MAN <44973863@qq.com> 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..."

Thanks for the patch! This looks good to me.

Yours,

--
Paul ~{:-)
pj@illuminatedcomputing.com

ZizhuanLiu X-MAN

44973863@qq.com

about 2 months ago

In reply to: Paul A Jungwirth (#2)

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

>On Mon, May 25, 2026 at 2:33 AM X-MAN <44973863@qq.com> 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..."
>
>Thanks for the patch! This looks good to me.
>
>Yours,
>
>--
>Paul              ~{:-)
>pj@illuminatedcomputing.com

Thanks a lot for the review!

--
X-MAN (Zizhuan Liu) 
44973863@QQ.COM

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

Attachments: