Re: DOC: fixes multiple errors in alter table doc

From: Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com>
To: Postgres hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: DOC: fixes multiple errors in alter table doc
Date: 2025-12-19 05:26:38
Message-ID: C463B8B3-986E-4ABF-95C4-419D94B0876C@gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

> On Dec 18, 2025, at 15:22, Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com> wrote:
>
> Hi Hacker,
>
> While working on a patch these days, my eyes are on the “alter table” doc, and found multiple errors:
>
> 1. Several sub-commands are missed in the top “action” list:
>
> * ALTER COLUMN SET <sequence-option>
> * ALTER COLUMN RESTART
> * RENAME
> * SET SCHEMA
> * ATTACH PARTITION
> * DETACH PARTITION
> * MERGE PARTITION
> * SPLIT PARTITION
>
> 2. In sub-command details section, "ADD COLUMN [ IF NOT EXISTS ]” missed “[]" with “COLUMN”, which is misleading, because “COLUMN” is actually optional.
>
> 3. For all “alter column” sub-commands, "ALTER [ COLUMN ]” are omitted, which is also confusing, because none of other sub-commands omit their prefix part.
>
> This patch fixed all these issue.
>
> <v1-0001-doc-clarify-and-complete-ALTER-TABLE-syntax-in-re.patch>

CF entry created: https://commitfest.postgresql.org/patch/6328/

Best regards,
--
Chao Li (Evan)
HighGo Software Co., Ltd.
https://www.highgo.com/

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Smith 2025-12-19 05:42:15 Re: Proposal: Conflict log history table for Logical Replication
Previous Message Michael Paquier 2025-12-19 05:22:02 Re: Switch buffile.c/h to use pgoff_t