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 6617caa69c5b0595163d0e17c517d9d030987669..4aaed8a1f7d8379823f65cffae7cf498448eb8a5 100644 (file)
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -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 db84af9360dd52caf6eb0c1b93f54687874f8d6b..922792488262eb62dd00f386eed3aa7a013aac9f 100644 (file)
--- a/doc/src/sgml/ref/alter_role.sgml
+++ b/doc/src/sgml/ref/alter_role.sgml
@@ -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 a9a6fd7aef07c18f837369ec52997ba5c0b479ab..f8f7e31809072f7fa75bda5b3bfdbe5cfed5eeb9 100644 (file)
--- a/doc/src/sgml/ref/alter_user.sgml
+++ b/doc/src/sgml/ref/alter_user.sgml
@@ -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 f4f0dcc7cb2cd3f7fd918cff05fb529379075265..6e9b53a9c1c6c2c6dcf3e1e4bd068b0ffa4b3dfd 100644 (file)
--- a/doc/src/sgml/ref/begin.sgml
+++ b/doc/src/sgml/ref/begin.sgml
@@ -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 a976a6e469b39720289b9d17e504f99e606727cf..d635a36541855a9ab1365af7f587371c9f91a84c 100644 (file)
--- a/doc/src/sgml/ref/create_group.sgml
+++ b/doc/src/sgml/ref/create_group.sgml
@@ -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 3278ab74b55f88f856f26b0250cec20e1fe39edb..f07f8b9aefb03d94f35400754a78bbc420019f1b 100644 (file)
--- a/doc/src/sgml/ref/create_user.sgml
+++ b/doc/src/sgml/ref/create_user.sgml
@@ -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 0dce6a67bf17074f30e1294655dd3c3868f3da4c..2ca9481e897ec863a072f7f821de7b7d6b09e5f3 100644 (file)
--- a/doc/src/sgml/ref/createlang.sgml
+++ b/doc/src/sgml/ref/createlang.sgml
@@ -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 193a730814bdb01b4ee99e12b7b5344726bf0ce9..976e184758faa4bbc2f7b2ce0c1999afe58e0b01 100644 (file)
--- a/doc/src/sgml/ref/drop_group.sgml
+++ b/doc/src/sgml/ref/drop_group.sgml
@@ -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 7e091d1783b5d9d98f04e0c2c15a1ac6f48204c6..062e8b005cb3efce869fef17b8966ec89c399172 100644 (file)
--- a/doc/src/sgml/ref/drop_user.sgml
+++ b/doc/src/sgml/ref/drop_user.sgml
@@ -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>