From d54ae17b630bb579fae976bfc4dac1ce88b16165 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Sat, 7 Feb 2009 14:31:30 +0000
Subject: [PATCH] Document disabling the statistics collector pg_dump activity,
 and give a bit more visibility to the PGOPTIONS environment variable
 supported by libpq.

Bryce Nesbitt
---
 doc/src/sgml/ref/pg_dump.sgml    | 13 +++++++++++--
 doc/src/sgml/ref/pg_dumpall.sgml |  3 ++-
 doc/src/sgml/ref/pg_restore.sgml |  3 ++-
 3 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 34536bf18f..71bab9681b 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.106 2009/01/05 16:54:36 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.107 2009/02/07 14:31:30 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -726,14 +726,16 @@ PostgreSQL documentation
    <varlistentry>
     <term><envar>PGDATABASE</envar></term>
     <term><envar>PGHOST</envar></term>
+    <term><envar>PGOPTIONS</envar></term>
     <term><envar>PGPORT</envar></term>
-    <term><envar>PGUSER</envar></term>
 
+    <term><envar>PGUSER</envar></term>
     <listitem>
      <para>
       Default connection parameters.
      </para>
     </listitem>
+
    </varlistentry>
   </variablelist>
 
@@ -757,6 +759,13 @@ PostgreSQL documentation
    variables used by the <application>libpq</application> front-end
    library will apply.
   </para>
+  <para>
+   The database activity of <application>pg_dump</application> is normally collected by the statistics collector.
+   If this is undesirable, you can set parameters <literal>stats_block_level</literal> and <literal>stats_row_level</literal> to false
+   via the <application>libpq</> <envar>PGOPTIONS</envar> environment variable, or via <literal>ALTER USER</literal>.
+  </para>
+
+
  </refsect1>
 
 
diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml
index e05e4f075d..dfb8d0dc6f 100644
--- a/doc/src/sgml/ref/pg_dumpall.sgml
+++ b/doc/src/sgml/ref/pg_dumpall.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.74 2009/01/05 16:54:36 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.75 2009/02/07 14:31:30 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -445,6 +445,7 @@ PostgreSQL documentation
   <variablelist>
    <varlistentry>
     <term><envar>PGHOST</envar></term>
+    <term><envar>PGOPTIONS</envar></term>
     <term><envar>PGPORT</envar></term>
     <term><envar>PGUSER</envar></term>
 
diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index 92c9f4be93..787db5e884 100644
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.78 2009/02/02 20:07:36 adunstan Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.79 2009/02/07 14:31:30 momjian Exp $ -->
 
 <refentry id="APP-PGRESTORE">
  <refmeta>
@@ -559,6 +559,7 @@
   <variablelist>
    <varlistentry>
     <term><envar>PGHOST</envar></term>
+    <term><envar>PGOPTIONS</envar></term>
     <term><envar>PGPORT</envar></term>
     <term><envar>PGUSER</envar></term>