pgsql: Doc: declutter CREATE TABLE synopsis.

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: declutter CREATE TABLE synopsis.
Date: 2026-03-26 21:27:49
Message-ID: E1w5sF2-001b1O-0s@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Doc: declutter CREATE TABLE synopsis.

Factor out the "persistence mode" and storage/compression parts
of the syntax synopsis to reduce line lengths and increase
readability. Also add an introductory para about the persistence
modes so that the Description section still lines up with the
synopsis.

Author: David G. Johnston <david(dot)g(dot)johnston(at)gmail(dot)com>
Reviewed-by: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
Reviewed-by: Jian He <jian(dot)universality(at)gmail(dot)com>
Discussion: https://postgr.es/m/CAKFQuwYfMV-2SdrP-umr5SVNSqTn378BUvHsebetp5=DhT494w@mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/a6d26e0fb29b8b644a495a6c2d5ed5c50b41addb

Modified Files
--------------
doc/src/sgml/ref/create_table.sgml | 38 ++++++++++++++++++++++++++---------
doc/src/sgml/ref/create_table_as.sgml | 8 ++++++--
2 files changed, 35 insertions(+), 11 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Heikki Linnakangas 2026-03-26 21:46:49 pgsql: Rename MAX_NAMED_TRANCHES to MAX_USER_DEFINED_TRANCHES
Previous Message Robert Haas 2026-03-26 21:22:52 pgsql: pg_plan_advice: Invent DO_NOT_SCAN(relation_identifier).