Fix bad spelling and worse grammar in recent doc commits. Propagate

pg_dump --ignore-version comments into pg_dumpall and pg_restore pages.

diff --git a/doc/src/sgml/array.sgml b/doc/src/sgml/array.sgml
index 9b0e658d81aa0303eaf8e6d9eac57821f7a766d0..bf81c29aaf166b03dd654cc757b740b6949bcf61 100644 (file)
--- a/doc/src/sgml/array.sgml
+++ b/doc/src/sgml/array.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/array.sgml,v 1.63 2008/03/26 14:43:20 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/array.sgml,v 1.64 2008/03/26 16:34:47 tgl Exp $ -->
 
 <sect1 id="arrays">
  <title>Arrays</title>
@@ -259,8 +259,8 @@ SELECT schedule[1:2][2] FROM sal_emp WHERE name = 'Bill';
 (1 row)
 </programlisting>
 
-  To avoid confusion with slices, use slice syntax for all dimmension
-  references, e.g.  <literal>[1:2][1:1]</>, not <literal>[2][1:1]</>.
+  To avoid confusion with the non-slice case, it's best to use slice syntax
+  for all dimensions, e.g., <literal>[1:2][1:1]</>, not <literal>[2][1:1]</>.
  </para>
 
  <para>

diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 1fb93fbb88005c43b2ebb87bddc1fc285b6f716b..c6e82c29479bff85aed8977041674bb0e6bc9103 100644 (file)
--- 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.100 2008/03/26 14:32:22 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.101 2008/03/26 16:34:47 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -296,18 +296,20 @@ PostgreSQL documentation
       <term><option>--ignore-version</></term>
       <listitem>
        <para>
-        Ignore incompatible version check between
+        Ignore version mismatch between
         <application>pg_dump</application> and the database server.
        </para>
 
        <para>
-        Dumping from a server newer than <application>pg_dump</application>
-        is likely fail and is disabled by default.
-        Also, while <application>pg_dump</application> can dump from servers running
-        previous releases of <productname>PostgreSQL</>, some very old
-        versions are not supported (currently, pre-7.0).
-        Use this option if you need to override the version check, but
-        be prepared for <application>pg_dump</application> to fail.
+        By default, <application>pg_dump</> will refuse to attempt
+        to dump from a server that is of a newer <productname>PostgreSQL</>
+        version than <application>pg_dump</application> is.  It will also
+        refuse to attempt to dump from a server that is older than the oldest
+        supported version (currently, 7.0).  The <option>-i</> option
+        overrides this check and forces a dump to be attempted anyway.
+        This option is <emphasis>deprecated</> because the dump is very
+        likely to fail &mdash; or worse, seem to succeed but be wrong or
+        incomplete.
        </para>
       </listitem>
      </varlistentry>

diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml
index e624210bac4db1c8fd8fea4f8b16a920911dd9d8..2dbf8524cf4865bd907460ac995d6f4858454874 100644 (file)
--- 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.70 2008/03/20 17:36:57 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.71 2008/03/26 16:34:47 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -161,12 +161,15 @@ PostgreSQL documentation
        </para>
 
        <para>
-        <application>pg_dumpall</application> can handle databases
-        from previous releases of <productname>PostgreSQL</>, but very
-        old versions are not supported anymore (currently prior to
-        7.0).  Use this option if you need to override the version
-        check (and if <application>pg_dumpall</application> then
-        fails, don't say you weren't warned).
+        By default, <application>pg_dumpall</> will refuse to attempt
+        to dump from a server that is of a newer <productname>PostgreSQL</>
+        version than <application>pg_dumpall</application> is.  It will also
+        refuse to attempt to dump from a server that is older than the oldest
+        supported version (currently, 7.0).  The <option>-i</> option
+        overrides this check and forces a dump to be attempted anyway.
+        This option is <emphasis>deprecated</> because the dump is very
+        likely to fail &mdash; or worse, seem to succeed but be wrong or
+        incomplete.
        </para>
       </listitem>
      </varlistentry>

diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index f908d93dcab621dcbeadf829e9bc92d7221c38fb..edc5672c20ff182e3eedc7d5ce401223e2cd9370 100644 (file)
--- 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.73 2008/03/20 17:36:57 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.74 2008/03/26 16:34:47 tgl Exp $ -->
 
 <refentry id="APP-PGRESTORE">
  <refmeta>
@@ -200,7 +200,8 @@
       <term><option>--ignore-version</option></term>
       <listitem>
        <para>
-        Ignore database version checks.
+        Ignore version mismatch between
+        <application>pg_restore</application> and the database server.
        </para>
       </listitem>
      </varlistentry>