]> granicus.if.org Git - postgresql/commit
Improve documentation's description of JOIN clauses.
authorTom Lane <tgl@sss.pgh.pa.us>
Wed, 19 Nov 2014 21:00:33 +0000 (16:00 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 19 Nov 2014 21:00:33 +0000 (16:00 -0500)
commitd767aa51d58e0bcbbd95e3a4e1631c9d48497842
treee9aff84d960463710f3f259ae720d7a0944e4303
parent57ce746617b6d253602e4c34682d0a75408b3186
Improve documentation's description of JOIN clauses.

In bug #12000, Andreas Kunert complained that the documentation was
misleading in saying "FROM T1 CROSS JOIN T2 is equivalent to FROM T1, T2".
That's correct as far as it goes, but the equivalence doesn't hold when
you consider three or more tables, since JOIN binds more tightly than
comma.  I added a <note> to explain this, and ended up rearranging some
of the existing text so that the note would make sense in context.

In passing, rewrite the description of JOIN USING, which was unnecessarily
vague, and hadn't been helped any by somebody's reliance on markup as a
substitute for clear writing.  (Mostly this involved reintroducing a
concrete example that was unaccountably removed by commit 032f3b7e166cfa28.)

Back-patch to all supported branches.
doc/src/sgml/queries.sgml