Re: Docs: Distinguish table and index storage parameters in CREATE TABLE

From: Andreas Karlsson <andreas(at)proxel(dot)se>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Docs: Distinguish table and index storage parameters in CREATE TABLE
Date: 2026-04-03 19:50:30
Message-ID: 87f00359-a8d6-4e0b-9cd8-78084ec89033@proxel.se
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 4/3/26 9:44 PM, David G. Johnston wrote:
> I'm not opposed to it but figured I'd wait for a committer to show
> interest and ask the scope to be expanded to a full docs review instead
> of just addressing the immediate user-reported confusion.  When I do
> expand the scope on my own it seems to scare them off.

Well, ALTER TABLE also has the same potential confusion so I think we
should either just change CREATE TABLE and ALTER TABLE or all of CREATE
TABLE, ALTER TABLE, CREATE INDEX and ALTER INDEX.

Just changing the two CREATE pages makes little sense when CREATE|ALTER
TABLE are both equally problematic en my opinion.

Andreas

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Robert Treat 2026-04-03 19:51:45 Re: Docs: Distinguish table and index storage parameters in CREATE TABLE
Previous Message David G. Johnston 2026-04-03 19:44:41 Re: Docs: Distinguish table and index storage parameters in CREATE TABLE