From dfcf99bf93776a9bdd6fc43f99b6092fe7ed6e89 Mon Sep 17 00:00:00 2001
From: Neil Conway <neilc@samurai.com>
Date: Tue, 15 May 2007 19:43:51 +0000
Subject: [PATCH] Fix a bunch of bad grammar in the docs: "<link>, which see
 for more information" is un-good English.

---
 doc/src/sgml/ddl.sgml              |  5 +++--
 doc/src/sgml/ref/alter_role.sgml   | 11 ++++++-----
 doc/src/sgml/ref/alter_user.sgml   |  5 ++---
 doc/src/sgml/ref/begin.sgml        |  6 +++---
 doc/src/sgml/ref/create_group.sgml |  5 ++---
 doc/src/sgml/ref/create_user.sgml  |  5 ++---
 doc/src/sgml/ref/createlang.sgml   |  4 ++--
 doc/src/sgml/ref/drop_group.sgml   |  5 ++---
 doc/src/sgml/ref/drop_user.sgml    |  5 ++---
 9 files changed, 24 insertions(+), 27 deletions(-)

diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index b11b176fe3..33749f5f20 100644
--- 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.74 2007/05/03 15:05:56 neilc Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ddl.sgml,v 1.75 2007/05/15 19:43:50 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 1461746cfe..ce28f2ad59 100644
--- 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.8 2007/05/15 19:43:51 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 62c4800e50..8f41a35e7a 100644
--- 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.43 2007/05/15 19:43:51 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 af9a864a2f..bfef2ee37f 100644
--- 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.35 2007/01/31 23:26:02 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/begin.sgml,v 1.36 2007/05/15 19:43:51 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 4cd44bf6a2..c714f07aba 100644
--- 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.18 2007/05/15 19:43:51 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 68f097cfd7..c4b9f70527 100644
--- 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.40 2007/05/15 19:43:51 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 6913a13272..9441eef1de 100644
--- 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.40 2007/03/26 17:23:36 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/createlang.sgml,v 1.41 2007/05/15 19:43:51 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 66c4a17de0..014575a5a8 100644
--- 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.14 2007/05/15 19:43:51 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 81dda77b29..cc1002562b 100644
--- 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.24 2007/05/15 19:43:51 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>
 
-- 
2.40.0