]> 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:30 +0000 (16:00 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 19 Nov 2014 21:00:30 +0000 (16:00 -0500)
commitbe2dfe4081b0ec59e1fe6bf77fca1406943a0d74
tree987192b8b6292c11db6e7e89435a29b78e29a1e8
parent8cf825974cd10323013f3be0ed1cd35176fbe364
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