From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Thu, 21 Oct 2004 22:48:54 +0000 (+0000)
Subject: Update obsolete comments about COPY vs INSERT options, per Uwe Schroeder.
X-Git-Tag: REL8_0_0BETA4~34
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=9eff02f5ac374466e37d63ed4361496a4aeef0d6;p=thirdparty%2Fpostgresql.git

Update obsolete comments about COPY vs INSERT options, per Uwe Schroeder.
---

diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 72ec981fcc5..a35fb491466 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.73 2004/07/13 02:59:49 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.74 2004/10/21 22:48:54 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -175,9 +175,11 @@ PostgreSQL documentation
       <listitem>
        <para>
 	Dump data as <command>INSERT</command> commands (rather
-	than <command>COPY</command>). This will make restoration very
-	slow, but it makes the archives more portable to other SQL database
-	management systems.
+	than <command>COPY</command>).  This will make restoration very slow;
+	it is mainly useful for making dumps that can be loaded into
+	non-<productname>PostgreSQL</productname> databases.  Note that
+	the restore may fail altogether if you have rearranged column order.
+	The <option>-D</option> option is safer, though even slower.
        </para>
       </listitem>
      </varlistentry>
@@ -192,8 +194,9 @@ PostgreSQL documentation
 	column names (<literal>INSERT INTO
 	<replaceable>table</replaceable>
 	(<replaceable>column</replaceable>, ...) VALUES
-	...</literal>).  This will make restoration very slow,
-	but it is necessary if you desire to rearrange the column ordering.
+	...</literal>).  This will make restoration very slow; it is mainly
+	useful for making dumps that can be loaded into
+	non-<productname>PostgreSQL</productname> databases.
        </para>
       </listitem>
      </varlistentry>