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?