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 986a571b80fbf0800822952da902540d12a980dd..06d9c68ae0e7e6ee6d13893cab75e5f8c15ed94e 100644 (file)
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.65.2.1 2003/11/04 09:45:30 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.65.2.2 2004/10/21 22:49:04 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>