The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/10/static/sql-select.html
Description:
The SYNOPSIS section of the "SELECT" SQL command contains the line
[ { UNION | INTERSECT | EXCEPT } [ ALL | DISTINCT ] select ]
(with a boldface "select"), but it is not clear what is meant by that
"select". Further down the page, in the "UNION clause" section (and also
INTERSECTION or EXCEPT), it is written:
select_statement UNION [ ALL | DISTINCT ] select_statement
which uses boldface "select_statement" instead of boldface "select" as in
the synopsis. This is confusing.
It would be great if the boldface "select" in the synopsis could be better
defined.