From 405728f66976729b15dbc95bbbe3dfa147b5106f Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Mon, 12 Jan 2009 14:06:20 +0000
Subject: [PATCH] Add some minimal documentation that the SQL standard requires
parentheses after ONLY.
---
doc/src/sgml/ref/select.sgml | 15 ++++++++++++++-
1 file changed, 14 insertions(+), 1 deletion(-)
diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml
index 0a19f894e70..ba14437764f 100644
--- a/doc/src/sgml/ref/select.sgml
+++ b/doc/src/sgml/ref/select.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/select.sgml,v 1.116 2008/12/31 23:42:56 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/select.sgml,v 1.117 2009/01/12 14:06:20 petere Exp $
PostgreSQL documentation
-->
@@ -1457,6 +1457,19 @@ SELECT distributors.* WHERE distributors.name = 'Westward';
</para>
</refsect2>
+ <refsect2>
+ <title><literal>ONLY</literal> and Parentheses</title>
+
+ <para>
+ The SQL standard requires parentheses around the table name
+ after <literal>ONLY</literal>, as in <literal>SELECT * FROM ONLY
+ (tab1), ONLY (tab2) WHERE ...</literal>. PostgreSQL supports that
+ as well, but the parentheses are optional. (This point applies
+ equally to all SQL commands supporting the <literal>ONLY</literal>
+ option.)
+ </para>
+ </refsect2>
+
<refsect2>
<title>Namespace Available to <literal>GROUP BY</literal> and <literal>ORDER BY</literal></title>
--
GitLab