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?