From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: b.l.michielsen@wanadoo.fr
Subject: Inconsistency in: 2.3. Creating a New Table
Date: Wed, 20 Dec 2023 23:35:38 +0000
Message-ID: <170311533858.1876504.6571296569439176220@wrigleys.postgresql.org> (raw)
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/16/tutorial-table.html
Description:
The text in: 2.3. Creating a New Table, states:
"... you can type the command aligned differently than above, or even all on
one line. Two dashes (“--”) introduce comments. Whatever follows them is
ignored up to the end of the line ..."
The last phrase contradicts the first one. If there is a comment on a
column definition you cannot continue to define a new column on the same
line. It looks like commas were column separators before comments were
allowed to appear. They rather should have become column terminators
appearing after an optional comment?
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-docs@postgresql.org
Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, b.l.michielsen@wanadoo.fr
Subject: Re: Inconsistency in: 2.3. Creating a New Table
In-Reply-To: <170311533858.1876504.6571296569439176220@wrigleys.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