aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2008-08-21 22:25:44 +0000
committerBruce Momjian <bruce@momjian.us>2008-08-21 22:25:44 +0000
commit8875a16ee15d6bed09b8f95e813eb74cb8d22fe9 (patch)
treefdd3292c8c313b0b59f6ea2d0590713517217f04
parentedb6a4c02a81b560e71d84ace0c31e1027fda1bb (diff)
downloadpostgresql-8875a16ee15d6bed09b8f95e813eb74cb8d22fe9.tar.gz
postgresql-8875a16ee15d6bed09b8f95e813eb74cb8d22fe9.zip
Mention that pg_dump does not dump ALTER DATABASE ... SET commands;
backpatch to 8.3.X. Also fix markup that had just one bullet.
-rw-r--r--doc/src/sgml/ref/pg_dump.sgml38
1 files changed, 16 insertions, 22 deletions
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index c8aae47b6f0..39c64af8108 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.103 2008/07/20 18:43:30 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.104 2008/08/21 22:25:44 momjian Exp $
PostgreSQL documentation
-->
@@ -754,22 +754,13 @@ CREATE DATABASE foo WITH TEMPLATE template0;
</para>
<para>
- <application>pg_dump</application> has a few limitations:
-
- <itemizedlist>
- <listitem>
- <para>
- When a data-only dump is chosen and the option
- <option>--disable-triggers</> is used,
- <application>pg_dump</application> emits commands to disable
- triggers on user tables before inserting the data and commands
- to re-enable them after the data has been inserted. If the
- restore is stopped in the middle, the system catalogs might be
- left in the wrong state.
- </para>
- </listitem>
-
- </itemizedlist>
+ <application>pg_dump</application> has a limitation; when a
+ data-only dump is chosen and the option <option>--disable-triggers</>
+ is used, <application>pg_dump</application> emits commands
+ to disable triggers on user tables before inserting the data
+ and commands to re-enable them after the data has been
+ inserted. If the restore is stopped in the middle, the system
+ catalogs might be left in the wrong state.
</para>
<para>
@@ -782,11 +773,14 @@ CREATE DATABASE foo WITH TEMPLATE template0;
</para>
<para>
- The dump file produced by <application>pg_dump</application> does
- not contain the statistics used by the optimizer to make query
- planning decisions. Therefore, it is wise to run
- <command>ANALYZE</command> after restoring from a dump file to
- ensure good performance.
+ The dump file produced by <application>pg_dump</application>
+ does not contain the statistics used by the optimizer to make
+ query planning decisions. Therefore, it is wise to run
+ <command>ANALYZE</command> after restoring from a dump file
+ to ensure good performance. The dump file also does not
+ contain any <command>ALTER DATABASE ... SET</> commands;
+ these settings are dumped by <xref linkend="app-pg-dumpall">,
+ along with database users and other installation-wide settings.
</para>
<para>