From 43ee22826bba77f669e34cb3b96994262800ca53 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Fri, 16 May 2008 16:59:05 +0000
Subject: Add detection of psql pager to trigger on wide output.  Also add
 pager detection for wrapped lines or lines with newlines that need pager to
 display.

---
 doc/src/sgml/ref/psql-ref.sgml | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

(limited to 'doc/src')

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 32346e413f3..75392accf7d 100644
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.204 2008/05/14 04:07:01 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.205 2008/05/16 16:59:05 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -1555,7 +1555,8 @@ lo_import 152801
           <term><literal>columns</literal></term>
           <listitem>
           <para>
-          Controls the target width for the <literal>wrapped</> format.
+          Controls the target width for the <literal>wrapped</> format,
+          and width for determining if wide output requires the pager.
           Zero (the default) causes the <literal>wrapped</> format to
           affect only screen output.
           </para>
@@ -1717,10 +1718,9 @@ lo_import 152801
           When the pager is <literal>off</>, the pager is not used. When the pager
           is <literal>on</>, the pager is used only when appropriate, i.e. the
           output is to a terminal and will not fit on the screen.
-          (<application>psql</> does not do a perfect job of estimating
-          when to use the pager.) <literal>\pset pager</> turns the
-          pager on and off. Pager can also be set to <literal>always</>,
-          which causes the pager to be always used.
+          <literal>\pset pager</> turns the pager on and off. Pager can
+          also be set to <literal>always</>, which causes the pager to be
+          always used.
           </para>
           </listitem>
           </varlistentry>
@@ -2734,8 +2734,9 @@ $endif
 
     <listitem>
      <para>
-      Used for the <literal>wrapped</> output format if 
-      <literal>\pset columns</> is zero.
+      If <literal>\pset columns</> is zero, controls the
+      width for the <literal>wrapped</> format and width for determining
+      if wide output requires the pager.
      </para>
     </listitem>
    </varlistentry>
-- 
cgit v1.2.3