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

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Andreas Karlsson <andreas(at)proxel(dot)se>
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:44:41
Message-ID: CAKFQuwYMbsUQ65CYsyVxKrcqa2BmvRmBh6bAuXocoMEp3sZwGg@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Fri, Apr 3, 2026 at 12:35 PM Andreas Karlsson <andreas(at)proxel(dot)se> wrote:

> On 4/3/26 9:27 PM, Andreas Karlsson wrote:
> > On 4/3/26 8:18 PM, David G. Johnston wrote:
> >> Per the discussion on -general [1] I propose that we stop using the
> >> generic label storage_parameter on the create table reference page and
> >> instead set up proper labels for table and index variants.
> >
> > Nice patch, I like these changes! But you forgot to mention that you
> > added the index storage parameters as in <indexterm>. Not sure if it is
> > worth sending a new version of the patch for but something probably
> > useful for the committer to knw.
>
> Shouldn't also update ALTER INDEX and LATER TABLE to match?
>
>
I gave it a thought and decided there was no ambiguity to resolve on those
pages.

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.

David J.

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Andreas Karlsson 2026-04-03 19:50:30 Re: Docs: Distinguish table and index storage parameters in CREATE TABLE
Previous Message Alvaro Herrera 2026-04-03 19:37:57 Re: Adding REPACK [concurrently]