From 8c5dfbabffa7709bb7ee2ab97a9f230bc37f8c8d Mon Sep 17 00:00:00 2001
From: Neil Conway <neilc@samurai.com>
Date: Sat, 18 Feb 2006 23:14:45 +0000
Subject: [PATCH] Minor SGML style police work.
---
doc/src/sgml/ddl.sgml | 22 ++++++++++++----------
doc/src/sgml/dml.sgml | 25 ++++++++++++-------------
doc/src/sgml/plpgsql.sgml | 15 ++++++++-------
doc/src/sgml/queries.sgml | 9 +++++----
doc/src/sgml/ref/alter_function.sgml | 16 +++++++++-------
5 files changed, 46 insertions(+), 41 deletions(-)
diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index d55dffa8f62..e7d590dfacd 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.54 2006/02/12 19:11:00 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ddl.sgml,v 1.55 2006/02/18 23:14:45 neilc Exp $ -->
<chapter id="ddl">
<title>Data Definition</title>
@@ -77,10 +77,11 @@
</indexterm>
<para>
- To create a table, you use the aptly named <command>CREATE
- TABLE</command> command. In this command you specify at least a
- name for the new table, the names of the columns and the data type
- of each column. For example:
+ To create a table, you use the aptly named <xref
+ linkend="sql-createtable" endterm="sql-createtable-title"> command.
+ In this command you specify at least a name for the new table, the
+ names of the columns and the data type of each column. For
+ example:
<programlisting>
CREATE TABLE my_first_table (
first_column text,
@@ -136,8 +137,9 @@ CREATE TABLE products (
</indexterm>
<para>
- If you no longer need a table, you can remove it using the
- <command>DROP TABLE</command> command. For example:
+ If you no longer need a table, you can remove it using the <xref
+ linkend="sql-droptable" endterm="sql-droptable-title"> command.
+ For example:
<programlisting>
DROP TABLE my_first_table;
DROP TABLE products;
@@ -1487,9 +1489,9 @@ REVOKE ALL ON accounts FROM PUBLIC;
</indexterm>
<para>
- To create a schema, use the command <command>CREATE
- SCHEMA</command>. Give the schema a name of your choice. For
- example:
+ To create a schema, use the <xref linkend="sql-createschema"
+ endterm="sql-createschema-title"> command. Give the schema a name
+ of your choice. For example:
<programlisting>
CREATE SCHEMA myschema;
</programlisting>
diff --git a/doc/src/sgml/dml.sgml b/doc/src/sgml/dml.sgml
index 879e4510d37..fcea6ad65fe 100644
--- a/doc/src/sgml/dml.sgml
+++ b/doc/src/sgml/dml.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/dml.sgml,v 1.12 2005/03/17 20:24:34 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/dml.sgml,v 1.13 2006/02/18 23:14:45 neilc Exp $ -->
<chapter id="dml">
<title>Data Manipulation</title>
@@ -39,7 +39,7 @@
<para>
To create a new row, use the <xref linkend="sql-insert"
- xreflabel="sql-insert-title"> command. The command requires the
+ endterm="sql-insert-title"> command. The command requires the
table name and a value for each of the columns of the table. For
example, consider the products table from <xref linkend="ddl">:
<programlisting>
@@ -95,12 +95,12 @@ INSERT INTO products DEFAULT VALUES;
<tip>
<para>
- To do <quote>bulk loads</quote>, that is, inserting a lot of data,
- take a look at the <xref linkend="sql-copy"
- endterm="sql-copy-title"> command. It is not as flexible as the
- <xref linkend="sql-insert" endterm="sql-insert-title"> command,
- but is more efficient. Refer to <xref linkend="populate"> for more
- information on improving bulk loading performance.
+ When inserting a lot of data at the same time, considering using
+ the <xref linkend="sql-copy" endterm="sql-copy-title"> command.
+ It is not as flexible as the <xref linkend="sql-insert"
+ endterm="sql-insert-title"> command, but is more efficient. Refer
+ to <xref linkend="populate"> for more information on improving
+ bulk loading performance.
</para>
</tip>
</sect1>
@@ -224,11 +224,10 @@ UPDATE mytable SET a = 5, b = 3, c = 1 WHERE a > 0;
</para>
<para>
- You use the <xref linkend="sql-delete"
- xreflabel="sql-delete-title"> command to remove rows; the syntax is
- very similar to the <command>UPDATE</command> command. For
- instance, to remove all rows from the products table that have a
- price of 10, use
+ You use the <xref linkend="sql-delete" endterm="sql-delete-title">
+ command to remove rows; the syntax is very similar to the
+ <command>UPDATE</command> command. For instance, to remove all
+ rows from the products table that have a price of 10, use
<programlisting>
DELETE FROM products WHERE price = 10;
</programlisting>
diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml
index f0f5aec4315..4e56f75852a 100644
--- a/doc/src/sgml/plpgsql.sgml
+++ b/doc/src/sgml/plpgsql.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/plpgsql.sgml,v 1.86 2006/02/12 06:37:05 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/plpgsql.sgml,v 1.87 2006/02/18 23:14:45 neilc Exp $
-->
<chapter id="plpgsql">
@@ -1594,7 +1594,7 @@ SELECT * FROM some_func();
allow users to define set-returning functions
that do not have this limitation. Currently, the point at
which data begins being written to disk is controlled by the
- <xref linkend="guc-work-mem" xreflabel="work_mem">
+ <xref linkend="guc-work-mem">
configuration variable. Administrators who have sufficient
memory to store larger result sets in memory should consider
increasing this parameter.
@@ -3642,11 +3642,12 @@ $$ LANGUAGE plpgsql;
<para>
<productname>PostgreSQL</> gives you two function creation
- modifiers to optimize execution: <quote>volatility</> (whether the
- function always returns the same result when given the same
- arguments) and <quote>strictness</quote> (whether the
- function returns null if any argument is null). Consult the
- <xref linkend="sql-createfunction"> reference page for details.
+ modifiers to optimize execution: <quote>volatility</> (whether
+ the function always returns the same result when given the same
+ arguments) and <quote>strictness</quote> (whether the function
+ returns null if any argument is null). Consult the <xref
+ linkend="sql-createfunction" endterm="sql-createfunction-title">
+ reference page for details.
</para>
<para>
diff --git a/doc/src/sgml/queries.sgml b/doc/src/sgml/queries.sgml
index 9ba27738030..cb8f2a1e5ac 100644
--- a/doc/src/sgml/queries.sgml
+++ b/doc/src/sgml/queries.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/queries.sgml,v 1.34 2005/05/08 03:08:05 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/queries.sgml,v 1.35 2006/02/18 23:14:45 neilc Exp $ -->
<chapter id="queries">
<title>Queries</title>
@@ -24,8 +24,9 @@
<para>
The process of retrieving or the command to retrieve data from a
database is called a <firstterm>query</firstterm>. In SQL the
- <command>SELECT</command> command is used to specify queries. The
- general syntax of the <command>SELECT</command> command is
+ <xref linkend="sql-select" endterm="sql-select-title"> command is
+ used to specify queries. The general syntax of the
+ <command>SELECT</command> command is
<synopsis>
SELECT <replaceable>select_list</replaceable> FROM <replaceable>table_expression</replaceable> <optional><replaceable>sort_specification</replaceable></optional>
</synopsis>
@@ -1284,7 +1285,7 @@ SELECT a FROM table1 ORDER BY b;
<synopsis>
SELECT <replaceable>select_list</replaceable>
FROM <replaceable>table_expression</replaceable>
- <optional>LIMIT { <replaceable>number</replaceable> | ALL }</optional> <optional>OFFSET <replaceable>number</replaceable></optional>
+ <optional> LIMIT { <replaceable>number</replaceable> | ALL } </optional> <optional> OFFSET <replaceable>number</replaceable> </optional>
</synopsis>
</para>
diff --git a/doc/src/sgml/ref/alter_function.sgml b/doc/src/sgml/ref/alter_function.sgml
index 3f05216c078..978847a47b0 100644
--- a/doc/src/sgml/ref/alter_function.sgml
+++ b/doc/src/sgml/ref/alter_function.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_function.sgml,v 1.10 2005/11/01 21:09:50 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_function.sgml,v 1.11 2006/02/18 23:14:45 neilc Exp $
PostgreSQL documentation
-->
@@ -151,8 +151,8 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
null. <literal>RETURNS NULL ON NULL INPUT</literal> or
<literal>STRICT</literal> changes the function so that it is not
invoked if any of its arguments are null; instead, a null result
- is assumed automatically. See <xref
- linkend="sql-createfunction"> for more information.
+ is assumed automatically. See <xref linkend="sql-createfunction"
+ endterm="sql-createfunction-title"> for more information.
</para>
</listitem>
</varlistentry>
@@ -164,8 +164,9 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<listitem>
<para>
- Change the volatility of the function to the specified
- setting. See <xref linkend="sql-createfunction"> for details.
+ Change the volatility of the function to the specified setting.
+ See <xref linkend="sql-createfunction"
+ endterm="sql-createfunction-title"> for details.
</para>
</listitem>
</varlistentry>
@@ -178,8 +179,9 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<para>
Change whether the function is a security definer or not. The
key word <literal>EXTERNAL</literal> is ignored for SQL
- conformance. See <xref linkend="sql-createfunction"> for more
- information about this capability.
+ conformance. See <xref linkend="sql-createfunction"
+ endterm="sql-createfunction-title"> for more information about
+ this capability.
</para>
</listitem>
</varlistentry>
--
GitLab