Inconsistency in: 2.3. Creating a New Table - Mailing list pgsql-docs

From PG Doc comments form
Subject Inconsistency in: 2.3. Creating a New Table
Date
Msg-id 170311533858.1876504.6571296569439176220@wrigleys.postgresql.org
Whole thread Raw
List pgsql-docs
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?

pgsql-docs by date:

Previous
From: Daniel Gustafsson
Date:
Subject: Re: 'bar' shouldn't be a string in example
Next
From: PG Doc comments form
Date:
Subject: Documentation does not describes format for access privileges: =Tc/user