From: Robert Haas <rhaas@postgresql.org>
Date: Thu, 24 Jul 2014 12:06:54 +0000 (-0400)
Subject: docs: Improve documentation of \pset without arguments.
X-Git-Tag: REL9_5_ALPHA1~1685
X-Git-Url: http://git.postgresql.org/gitweb/?a=commitdiff_plain;h=967a4e7f3107e3c5b732fe4f8e13a1f31a255e46;p=postgresql.git

docs: Improve documentation of \pset without arguments.

The syntax summary previously failed to clarify that the first
argument is also optional.  The textual description did mention it,
but all the way at the bottom.  It fits better with the command
overview, so move it there, and fix the summary also.

Dilip Kumar, reviewed by Fabien Coelho
---

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index fa0d6f2ec90..133390ab637 100644
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -1956,7 +1956,7 @@ lo_import 152801
       </varlistentry>
 
       <varlistentry>
-        <term><literal>\pset <replaceable class="parameter">option</replaceable> [ <replaceable class="parameter">value</replaceable> ]</literal></term>
+        <term><literal>\pset [ <replaceable class="parameter">option</replaceable> [ <replaceable class="parameter">value</replaceable> ] ]</literal></term>
 
         <listitem>
         <para>
@@ -1972,6 +1972,11 @@ lo_import 152801
         the current setting being displayed.
         </para>
 
+        <para>
+        <command>\pset</command> without any arguments displays the current status
+        of all printing options.
+        </para>
+
         <para>
         Adjustable printing options are:
         <variablelist>
@@ -2311,11 +2316,6 @@ lo_import 152801
         </para>
         </tip>
 
-        <para>
-        <command>\pset</command> without any arguments displays the current status
-        of all printing options.
-        </para>
-
         </listitem>
       </varlistentry>