BUG #11325: Documentation Bug / RFE - Mailing list pgsql-bugs

From thomas@landauer.at
Subject BUG #11325: Documentation Bug / RFE
Date
Msg-id 20140901154149.2921.14246@wrigleys.postgresql.org
Whole thread Raw
Responses Re: BUG #11325: Documentation Bug / RFE
List pgsql-bugs
The following bug has been logged on the website:

Bug reference:      11325
Logged by:          Thomas Landauer
Email address:      thomas@landauer.at
PostgreSQL version: Unsupported/Unknown
Operating system:   Irrelevant
Description:

Two suggestions for "PostgreSQL 9.3.5 Documentation" (which is excellent in
general, by the way :-)

Capter 7.2.1.1

1) "Finally, NATURAL is a shorthand form of USING: it forms a USING list
consisting of all column
names that appear in both input tables."
Please clarify: All column names that appear in both input tables
(regardless of the SELECT clause), or all column names /listed in the SELECT
clause/ that appear in both input tables?

2) "with the exception that if ON is used there will be two columns a, b,
and c in the result"
Hard to understand. Suggestion:
"if ON is used, each column a, b, and c will appear twice in the result."

Cheers,
Thomas

pgsql-bugs by date:

Previous
From: Tom Lane
Date:
Subject: Re: BUG #11321: describe command is getting locked due to ALTER statement running on public table
Next
From: Tom Lane
Date:
Subject: Re: BUG #11325: Documentation Bug / RFE