pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Doc: declutter CREATE TABLE synopsis.
Date: Thu, 26 Mar 2026 21:27:49 +0000
Message-ID: <E1w5sF2-001b1O-0s@gemulon.postgresql.org> (raw)

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.g.johnston@gmail.com>
Reviewed-by: Laurenz Albe <laurenz.albe@cybertec.at>
Reviewed-by: Jian He <jian.universality@gmail.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(-)



Message-ID: <E1w5sF2-001b1O-0s@gemulon.postgresql.org>
Permalink:  ../E1w5sF2-001b1O-0s@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1w5sF2-001b1O-0s@gemulon.postgresql.org

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-committers@postgresql.org
  Cc: tgl@sss.pgh.pa.us, pgsql-committers@lists.postgresql.org
  Subject: Re: pgsql: Doc: declutter CREATE TABLE synopsis.
  In-Reply-To: <E1w5sF2-001b1O-0s@gemulon.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox