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 0a19f894e7..ba14437764 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>