open-dsi
/
postgres
mirror of https://github.com/postgres/postgres
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

SGML cleanup: consistently use "endterm" in <xref>s that link to the

Browse Source 
reference page for SQL commands, so that the link text is italicized.
REL8_1_STABLE
Neil Conway 21 years ago
parent a2fb7b8a1f
commit 8c05ca7754
8 changed files with 59 additions and 50 deletions
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Show Stats Download Patch File Download Diff File
  1. 38
      doc/src/sgml/ddl.sgml
  2. 4
      doc/src/sgml/func.sgml
  3. 15
      doc/src/sgml/maintenance.sgml
  4. 14
      doc/src/sgml/manage-ag.sgml
  5. 7
      doc/src/sgml/mvcc.sgml
  6. 5
      doc/src/sgml/query.sgml
  7. 16
      doc/src/sgml/ref/psql-ref.sgml
  8. 10
      doc/src/sgml/runtime.sgml

38
doc/src/sgml/ddl.sgml
Unescape View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ddl.sgml,v 1.40 2005/03/13 09:36:30 neilc Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/ddl.sgml,v 1.41 2005/06/13 02:40:01 neilc Exp $ -->
<chapter id="ddl">
<title>Data Definition</title>
@ -1540,14 +1540,14 @@ ALTER TABLE products RENAME TO items;
There are several different privileges: <literal>SELECT</>,
<literal>INSERT</>, <literal>UPDATE</>, <literal>DELETE</>,
<literal>RULE</>, <literal>REFERENCES</>, <literal>TRIGGER</>,
<literal>CREATE</>, <literal>TEMPORARY</>, <literal>EXECUTE</>,
and <literal>USAGE</>. The privileges applicable to a particular
<literal>CREATE</>, <literal>TEMPORARY</>, <literal>EXECUTE</>, and
<literal>USAGE</>. The privileges applicable to a particular
object vary depending on the object's type (table, function, etc).
For complete
information on the different types of privileges supported by
<productname>PostgreSQL</productname>, refer to the
<xref linkend="sql-grant"> reference page. The following sections
and chapters will also show you how those privileges are used.
For complete information on the different types of privileges
supported by <productname>PostgreSQL</productname>, refer to the
<xref linkend="sql-grant" endterm="sql-grant-title"> reference
page. The following sections and chapters will also show you how
those privileges are used.
</para>
<para>
@ -1558,8 +1558,9 @@ ALTER TABLE products RENAME TO items;
<note>
<para>
To change the owner of a table, index, sequence, or view, use the
<xref linkend="sql-altertable"> command. There are corresponding
<literal>ALTER</> commands for other object types.
<xref linkend="sql-altertable" endterm="sql-altertable-title">
command. There are corresponding <literal>ALTER</> commands for
other object types.
</para>
</note>
@ -1596,14 +1597,15 @@ REVOKE ALL ON accounts FROM PUBLIC;
</para>
<para>
Ordinarily, only the object's owner (or a superuser) can grant or revoke
privileges on an object. However, it is possible to grant a privilege
<quote>with grant option</>, which gives the recipient the right to
grant it in turn to others. If the grant option is subsequently revoked
then all who received the privilege from that recipient (directly or
through a chain of grants) will lose the privilege. For details see
the <xref linkend="sql-grant"> and <xref linkend="sql-revoke"> reference
pages.
Ordinarily, only the object's owner (or a superuser) can grant or
revoke privileges on an object. However, it is possible to grant a
privilege <quote>with grant option</>, which gives the recipient
the right to grant it in turn to others. If the grant option is
subsequently revoked then all who received the privilege from that
recipient (directly or through a chain of grants) will lose the
privilege. For details see the <xref linkend="sql-grant"
endterm="sql-grant-title"> and <xref linkend="sql-revoke"
endterm="sql-revoke-title"> reference pages.
</para>
</sect1>

4
doc/src/sgml/func.sgml
Unescape View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.253 2005/06/09 16:35:08 momjian Exp $
$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.254 2005/06/13 02:40:04 neilc Exp $
PostgreSQL documentation
-->
@ -8152,7 +8152,7 @@ select current_date + s.a as dates from generate_series(0,14,7) as s(a);
<para>
The <function>session_user</function> is normally the user who initiated
the current database connection; but superusers can change this setting
with <xref linkend="sql-set-session-authorization">.
with <xref linkend="sql-set-session-authorization" endterm="sql-set-session-authorization-title">.
The <function>current_user</function> is the user identifier
that is applicable for permission checking. Normally, it is equal
to the session user, but it changes during the execution of

15
doc/src/sgml/maintenance.sgml
Unescape View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.43 2005/05/10 22:27:29 momjian Exp $
$PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.44 2005/06/13 02:40:04 neilc Exp $
-->
<chapter id="maintenance">
@ -74,12 +74,13 @@ $PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.43 2005/05/10 22:27:29 momj
</listitem>
</orderedlist>
The frequency and scope of the <command>VACUUM</> operations performed for each of
these reasons will vary depending on the needs of each site.
Therefore, database administrators must understand these issues and
develop an appropriate maintenance strategy. This section concentrates
on explaining the high-level issues; for details about command syntax
and so on, see the <xref linkend="sql-vacuum"> reference page.
The frequency and scope of the <command>VACUUM</> operations
performed for each of these reasons will vary depending on the
needs of each site. Therefore, database administrators must
understand these issues and develop an appropriate maintenance
strategy. This section concentrates on explaining the high-level
issues; for details about command syntax and so on, see the <xref
linkend="sql-vacuum" endterm="sql-vacuum-title"> reference page.
</para>
<para>

14
doc/src/sgml/manage-ag.sgml
Unescape View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/manage-ag.sgml,v 2.40 2005/01/08 22:13:34 tgl Exp $
$PostgreSQL: pgsql/doc/src/sgml/manage-ag.sgml,v 2.41 2005/06/13 02:40:04 neilc Exp $
-->
<chapter id="managing-databases">
@ -88,7 +88,7 @@ SELECT datname FROM pg_database;
<para>
Databases are created with the SQL command
<xref linkend="sql-createdatabase">:<indexterm><primary>CREATE
<xref linkend="sql-createdatabase" endterm="sql-createdatabase-title">:<indexterm><primary>CREATE
DATABASE</></>
<synopsis>
CREATE DATABASE <replaceable>name</>;
@ -314,7 +314,7 @@ ALTER DATABASE mydb SET geqo TO off;
<para>
Databases are destroyed with the command
<xref linkend="sql-dropdatabase">:<indexterm><primary>DROP DATABASE</></>
<xref linkend="sql-dropdatabase" endterm="sql-dropdatabase-title">:<indexterm><primary>DROP DATABASE</></>
<synopsis>
DROP DATABASE <replaceable>name</>;
</synopsis>
@ -379,7 +379,8 @@ dropdb <replaceable class="parameter">dbname</replaceable>
</para>
<para>
To define a tablespace, use the <xref linkend="sql-createtablespace">
To define a tablespace, use the <xref
linkend="sql-createtablespace" endterm="sql-createdatabase-title">
command, for example:<indexterm><primary>CREATE TABLESPACE</></>
<programlisting>
CREATE TABLESPACE fastspace LOCATION '/mnt/sda1/postgresql/data';
@ -459,8 +460,9 @@ CREATE TABLE foo(i int);
</para>
<para>
To remove an empty tablespace, use the <xref linkend="sql-droptablespace">
command.
To remove an empty tablespace, use the <xref
linkend="sql-droptablespace" endterm="sql-droptablespace-title">
command.
</para>
<para>

7
doc/src/sgml/mvcc.sgml
Unescape View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/mvcc.sgml,v 2.50 2005/04/28 21:47:09 tgl Exp $
$PostgreSQL: pgsql/doc/src/sgml/mvcc.sgml,v 2.51 2005/06/13 02:40:05 neilc Exp $
-->
<chapter id="mvcc">
@ -224,7 +224,7 @@ $PostgreSQL: pgsql/doc/src/sgml/mvcc.sgml,v 2.50 2005/04/28 21:47:09 tgl Exp $
<para>
To set the transaction isolation level of a transaction, use the
command <xref linkend="sql-set-transaction">.
command <xref linkend="sql-set-transaction" endterm="sql-set-transaction-title">.
</para>
<sect2 id="xact-read-committed">
@ -524,7 +524,8 @@ SELECT SUM(value) FROM mytab WHERE class = 2;
The list below shows the available lock modes and the contexts in
which they are used automatically by
<productname>PostgreSQL</productname>. You can also acquire any
of these locks explicitly with the command <xref linkend="sql-lock">.
of these locks explicitly with the command <xref
linkend="sql-lock" endterm="sql-lock-title">.
Remember that all of these lock modes are table-level locks,
even if the name contains the word
<quote>row</quote>; the names of the lock modes are historical.

5
doc/src/sgml/query.sgml
Unescape View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/query.sgml,v 1.44 2005/03/10 23:21:20 tgl Exp $
$PostgreSQL: pgsql/doc/src/sgml/query.sgml,v 1.45 2005/06/13 02:40:06 neilc Exp $
-->
<chapter id="tutorial-sql">
@ -269,7 +269,8 @@ COPY weather FROM '/home/user/weather.txt';
where the file name for the source file must be available to the
backend server machine, not the client, since the backend server
reads the file directly. You can read more about the
<command>COPY</command> command in <xref linkend="sql-copy">.
<command>COPY</command> command in <xref linkend="sql-copy"
endterm="sql-copy-title">.
</para>
</sect1>

16
doc/src/sgml/ref/psql-ref.sgml
Unescape View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.142 2005/06/10 16:31:48 momjian Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.143 2005/06/13 02:40:08 neilc Exp $
PostgreSQL documentation
-->
@ -1036,9 +1036,9 @@ testdb=&gt;
</para>
<para>
The commands <xref linkend="SQL-GRANT"> and
<xref linkend="SQL-REVOKE">
are used to set access privileges. See <xref linkend="SQL-GRANT">
The commands <command>GRANT</command> and
<command>REVOKE</command> are used to set access privileges.
See <xref linkend="sql-grant" endterm="sql-grant-title">
for more information.
</para>
</listitem>
@ -1740,10 +1740,10 @@ lo_import 152801
</para>
<para>
The commands <xref linkend="SQL-GRANT"> and
<xref linkend="SQL-REVOKE">
are used to set access privileges. See <xref linkend="SQL-GRANT">
for more information.
The commands <command>GRANT</command> and
<command>REVOKE</command> are used to set access privileges.
See <xref linkend="sql-grant" endterm="sql-grant-title"> for
more information.
</para>
<para>

10
doc/src/sgml/runtime.sgml
Unescape View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.324 2005/06/09 22:35:23 momjian Exp $
$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.325 2005/06/13 02:40:06 neilc Exp $
-->
<chapter Id="runtime">
@ -3234,8 +3234,9 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
</para>
<para>
Consult <xref linkend="mvcc"> and <xref linkend="sql-set-transaction"> for more
information.
Consult <xref linkend="mvcc"> and <xref
linkend="sql-set-transaction"
endterm="sql-set-transaction-title"> for more information.
</para>
</listitem>
</varlistentry>
@ -3257,7 +3258,8 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
</para>
<para>
Consult <xref linkend="sql-set-transaction"> for more information.
Consult <xref linkend="sql-set-transaction"
endterm="sql-set-transaction-title"> for more information.
</para>
</listitem>
</varlistentry>

Write Preview
Loading…
Cancel
Save