| 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/
| 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 |