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 b11b176fe34..33749f5f200 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 1461746cfe7..ce28f2ad597 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 62c4800e508..8f41a35e7aa 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 af9a864a2f7..bfef2ee37fc 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 4cd44bf6a24..c714f07aba2 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 68f097cfd7c..c4b9f70527d 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 6913a132722..9441eef1de0 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 66c4a17de0d..014575a5a87 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 81dda77b297..cc1002562b4 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>
--
GitLab