From: Bruce Momjian Date: Thu, 20 Mar 2003 19:00:01 +0000 (+0000) Subject: The documentation for SELECT is incorrect in a sense: the syntax for a X-Git-Tag: REL7_4_BETA1~874 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0fe77d7283160fc9dc5b5cacd1a70502835350e3;p=postgresql The documentation for SELECT is incorrect in a sense: the syntax for a join is defined as: from_item [ NATURAL ] join_type from_item [ ON join_condition | USING ( join_column_list ) ] However, if the join_type is an INNER or OUTER join, an ON, USING, or NATURAL clause *must* be specified (it's not optional, as that segment of the docs suggest). I'm not exactly sure what the best way to fix this is, so I've attached a patch adding a FIXME comment to the relevant section of the SGML. If anyone has any ideas on the proper way to outline join syntax, please speak up. Neil Conway || PGP Key ID: DB3C29FC --- diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml index 0f8a3dbcc9..42281e5cf0 100644 --- a/doc/src/sgml/ref/select.sgml +++ b/doc/src/sgml/ref/select.sgml @@ -1,5 +1,5 @@ @@ -46,6 +46,11 @@ where from_item can be: table_function_name ( [ argument [, ...] ] ) AS ( column_definition_list ) | + from_item [ NATURAL ] join_type from_item [ ON join_condition | USING ( join_column_list ) ]