Fix a bunch of bad grammar in the docs: "<link>, which see for more

information" is un-good English.

diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index c0a1b96f5bcd8774129441d69a8e1ad16f8d037a..53157c4ef536a598bb68ae7e38cb253847603c75 100644 (file)
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/ddl.sgml,v 1.69.2.1 2007/05/03 15:06:13 neilc Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ddl.sgml,v 1.69.2.2 2007/05/15 19:43:59 neilc Exp $ -->
 
 <chapter id="ddl">
  <title>Data Definition</title>
@@ -1095,7 +1095,8 @@ CREATE TABLE order_items (
 
    All these actions are performed using the
    <xref linkend="sql-altertable" endterm="sql-altertable-title">
-   command, which see for details beyond those given here.
+   command, whose reference page contains details beyond those given
+   here.
   </para>
 
   <sect2>

diff --git a/doc/src/sgml/ref/alter_role.sgml b/doc/src/sgml/ref/alter_role.sgml
index 1461746cfe73dc65a3c1f5414f799f454dd4e3f1..363a7558eab253cb5dbbd26385f451e0476a827f 100644 (file)
--- a/doc/src/sgml/ref/alter_role.sgml
+++ b/doc/src/sgml/ref/alter_role.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_role.sgml,v 1.7 2006/09/16 00:30:16 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_role.sgml,v 1.7.2.1 2007/05/15 19:43:59 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -52,8 +52,8 @@ ALTER ROLE <replaceable class="PARAMETER">name</replaceable> RESET <replaceable>
   <para>
    The first variant of this command listed in the synopsis can change
    many of the role attributes that can be specified in 
-   <xref linkend="sql-createrole" endterm="sql-createrole-title">,
-   which see for details.  (All the possible attributes are covered,
+   <xref linkend="sql-createrole" endterm="sql-createrole-title">.
+   (All the possible attributes are covered,
    except that there are no options for adding or removing memberships; use
    <xref linkend="SQL-GRANT" endterm="SQL-GRANT-title"> and
    <xref linkend="SQL-REVOKE" endterm="SQL-REVOKE-title"> for that.)
@@ -127,8 +127,9 @@ ALTER ROLE <replaceable class="PARAMETER">name</replaceable> RESET <replaceable>
       <listitem>
        <para>
         These clauses alter attributes originally set by
-        <xref linkend="SQL-CREATEROLE" endterm="SQL-CREATEROLE-title">,
-        which see for more information.
+        <xref linkend="SQL-CREATEROLE"
+        endterm="SQL-CREATEROLE-title">. For more information, see the
+        <command>CREATE ROLE</command> reference page.
        </para>
       </listitem>
      </varlistentry>

diff --git a/doc/src/sgml/ref/alter_user.sgml b/doc/src/sgml/ref/alter_user.sgml
index 62c4800e508e02442ffe65405bef16558de5b839..13c696f454e68a71e22aa263cce0e3fecb023ae7 100644 (file)
--- a/doc/src/sgml/ref/alter_user.sgml
+++ b/doc/src/sgml/ref/alter_user.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.42 2006/09/16 00:30:16 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.42.2.1 2007/05/15 19:43:59 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -46,8 +46,7 @@ ALTER USER <replaceable class="PARAMETER">name</replaceable> RESET <replaceable>
 
   <para>
    <command>ALTER USER</command> is now an alias for
-   <xref linkend="sql-alterrole" endterm="sql-alterrole-title">,
-   which see for more information.
+   <xref linkend="sql-alterrole" endterm="sql-alterrole-title">.
   </para>
  </refsect1>
 

diff --git a/doc/src/sgml/ref/begin.sgml b/doc/src/sgml/ref/begin.sgml
index add1b710690c0c3e312475ea7bcb0de6d7516eb5..413c87e244a48ffcfd2ddadd157285c76807dd8f 100644 (file)
--- a/doc/src/sgml/ref/begin.sgml
+++ b/doc/src/sgml/ref/begin.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/begin.sgml,v 1.34 2006/09/16 00:30:17 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/begin.sgml,v 1.34.2.1 2007/05/15 19:43:59 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -133,8 +133,8 @@ BEGIN;
    <command>BEGIN</command> is a <productname>PostgreSQL</productname>
    language extension.  It is equivalent to the SQL-standard command
    <xref linkend="sql-start-transaction"
-   endterm="sql-start-transaction-title">, which see for additional
-   compatibility information.
+   endterm="sql-start-transaction-title">, whose reference page
+   contains additional compatibility information.
   </para>
 
   <para>

diff --git a/doc/src/sgml/ref/create_group.sgml b/doc/src/sgml/ref/create_group.sgml
index 4cd44bf6a24b9c73e900ccdbec62adbada9f63c4..e6d3764c33433f19238d1204e52bf243339ff212 100644 (file)
--- a/doc/src/sgml/ref/create_group.sgml
+++ b/doc/src/sgml/ref/create_group.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_group.sgml,v 1.17 2006/09/16 00:30:17 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_group.sgml,v 1.17.2.1 2007/05/15 19:43:59 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -46,8 +46,7 @@ where <replaceable class="PARAMETER">option</replaceable> can be:
 
   <para>
    <command>CREATE GROUP</command> is now an alias for
-   <xref linkend="sql-createrole" endterm="sql-createrole-title">,
-   which see for more information.
+   <xref linkend="sql-createrole" endterm="sql-createrole-title">.
   </para>
  </refsect1> 
  

diff --git a/doc/src/sgml/ref/create_user.sgml b/doc/src/sgml/ref/create_user.sgml
index 68f097cfd7cf5f3e35669e3557520f690b744010..df6b6f10b6f70ed334307a65462f3fd748c362e6 100644 (file)
--- a/doc/src/sgml/ref/create_user.sgml
+++ b/doc/src/sgml/ref/create_user.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_user.sgml,v 1.39 2006/09/16 00:30:17 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_user.sgml,v 1.39.2.1 2007/05/15 19:43:59 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -47,8 +47,7 @@ where <replaceable class="PARAMETER">option</replaceable> can be:
 
   <para>
    <command>CREATE USER</command> is now an alias for
-   <xref linkend="sql-createrole" endterm="sql-createrole-title">,
-   which see for more information.
+   <xref linkend="sql-createrole" endterm="sql-createrole-title">.
    The only difference is that when the command is spelled
    <command>CREATE USER</command>, <literal>LOGIN</> is assumed
    by default, whereas <literal>NOLOGIN</> is assumed when

diff --git a/doc/src/sgml/ref/createlang.sgml b/doc/src/sgml/ref/createlang.sgml
index c7d255211ab210b9fd3c9313c0120c7d95eb9a17..3bd6c0d9937e79d9adaa6e9e749270f558210d7a 100644 (file)
--- a/doc/src/sgml/ref/createlang.sgml
+++ b/doc/src/sgml/ref/createlang.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/createlang.sgml,v 1.38.2.2 2007/03/26 17:23:44 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/createlang.sgml,v 1.38.2.3 2007/05/15 19:43:59 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -42,7 +42,7 @@ PostgreSQL documentation
    programming language to a <productname>PostgreSQL</productname> database.
    <application>createlang</application> is just a wrapper around the
    <xref linkend="sql-createlanguage" endterm="sql-createlanguage-title">
-   command, which see for additional information.
+   command.
   </para>
  </refsect1>
 

diff --git a/doc/src/sgml/ref/drop_group.sgml b/doc/src/sgml/ref/drop_group.sgml
index 66c4a17de0d4c48d74448176b7bc4e895988d61b..2ac211284bf315487073fe557873419ddd011010 100644 (file)
--- a/doc/src/sgml/ref/drop_group.sgml
+++ b/doc/src/sgml/ref/drop_group.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.13 2006/09/16 00:30:18 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.13.2.1 2007/05/15 19:43:59 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -29,8 +29,7 @@ DROP GROUP [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable> [, ..
 
   <para>
    <command>DROP GROUP</command> is now an alias for
-   <xref linkend="sql-droprole" endterm="sql-droprole-title">,
-   which see for more information.
+   <xref linkend="sql-droprole" endterm="sql-droprole-title">.
   </para>
  </refsect1>
 

diff --git a/doc/src/sgml/ref/drop_user.sgml b/doc/src/sgml/ref/drop_user.sgml
index 81dda77b297db41e17323a520d3bcdcb90b6da17..07b621983201c82856470489d249ef4187f0115a 100644 (file)
--- a/doc/src/sgml/ref/drop_user.sgml
+++ b/doc/src/sgml/ref/drop_user.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/drop_user.sgml,v 1.23 2006/09/16 00:30:18 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/drop_user.sgml,v 1.23.2.1 2007/05/15 19:43:59 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -29,8 +29,7 @@ DROP USER [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable> [, ...
 
   <para>
    <command>DROP USER</command> is now an alias for
-   <xref linkend="sql-droprole" endterm="sql-droprole-title">,
-   which see for more information.
+   <xref linkend="sql-droprole" endterm="sql-droprole-title">.
   </para>
  </refsect1>