Add some links to tables

diff --git a/doc/src/sgml/isn.sgml b/doc/src/sgml/isn.sgml
index b4d7c413aff91fd9bcc96862cd1eb1b34d86a941..976c3ce8a6eaccf4b69ebff45fac75dcba9cb42b 100644 (file)
--- a/doc/src/sgml/isn.sgml
+++ b/doc/src/sgml/isn.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/isn.sgml,v 1.5.14.1 2010/07/29 19:34:36 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/isn.sgml,v 1.5.14.2 2010/08/10 20:42:02 petere Exp $ -->
 
 <sect1 id="isn">
  <title>isn</title>
@@ -17,7 +17,12 @@
  <sect2>
   <title>Data types</title>
 
-  <table>
+  <para>
+   <xref linkend="isn-datatypes"> shows the data types provided by
+   the <filename>isn</filename> module.
+  </para>
+
+  <table id="isn-datatypes">
    <title><filename>isn</filename> data types</title>
    <tgroup cols="2">
     <thead>

diff --git a/doc/src/sgml/pgcrypto.sgml b/doc/src/sgml/pgcrypto.sgml
index 367dd32105ae9bce1480819f8c4caa4f0fd71203..1d78cd727e62361080a481a7223c5adff2094c81 100644 (file)
--- a/doc/src/sgml/pgcrypto.sgml
+++ b/doc/src/sgml/pgcrypto.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.9.2.1 2010/07/29 19:34:37 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.9.2.2 2010/08/10 20:42:02 petere Exp $ -->
 
 <sect1 id="pgcrypto">
  <title>pgcrypto</title>
@@ -115,7 +115,12 @@ hmac(data bytea, key text, type text) returns bytea
    </listitem>
   </orderedlist>
 
-  <table>
+  <para>
+   <xref linkend="pgcrypto-crypt-algorithms"> lists the algorithms
+   supported by the <function>crypt()</function> function.
+  </para>
+
+  <table id="pgcrypto-crypt-algorithms">
    <title>Supported algorithms for <function>crypt()</></title>
    <tgroup cols="5">
     <thead>

diff --git a/doc/src/sgml/pgstattuple.sgml b/doc/src/sgml/pgstattuple.sgml
index 5da169f20d7ff81466ffea4cbd9ea17d774bea7a..e538e4f5024a822dcd9f0078ccf56086004fc114 100644 (file)
--- a/doc/src/sgml/pgstattuple.sgml
+++ b/doc/src/sgml/pgstattuple.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstattuple.sgml,v 1.5.14.1 2010/07/29 19:34:37 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstattuple.sgml,v 1.5.14.2 2010/08/10 20:42:02 petere Exp $ -->
 
 <sect1 id="pgstattuple">
  <title>pgstattuple</title>
@@ -159,10 +159,8 @@ leaf_fragmentation | 0
 
     <para>
      The output columns are:
-    </para>
 
-    <table>
-     <title><function>pgstatindex</function> output columns</title>
+    <informaltable>
      <tgroup cols="3">
       <thead>
        <row>
@@ -235,7 +233,8 @@ leaf_fragmentation | 0
 
       </tbody>
      </tgroup>
-    </table>
+    </informaltable>
+    </para>
 
     <para>
      As with <function>pgstattuple</>, the results are accumulated

diff --git a/doc/src/sgml/seg.sgml b/doc/src/sgml/seg.sgml
index 06cd28a7311c29d1311d36bdcc9225737ae2f5a6..f3ff4066fa363a0903e82746b3b58c1ae1a2b368 100644 (file)
--- a/doc/src/sgml/seg.sgml
+++ b/doc/src/sgml/seg.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/seg.sgml,v 1.6.8.1 2010/07/29 19:34:37 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/seg.sgml,v 1.6.8.2 2010/08/10 20:42:02 petere Exp $ -->
 
 <sect1 id="seg">
  <title>seg</title>
@@ -86,6 +86,9 @@ test=> select '6.25 .. 6.50'::seg as "pH";
    Optional certainty indicators (<literal>&lt;</literal>,
    <literal>&gt;</literal> and <literal>~</literal>) can be stored as well.
    (Certainty indicators are ignored by all the built-in operators, however.)
+   <xref linkend="seg-repr-table"> gives on overview over the allowed
+   representations; <xref linkend="seg-input-examples"> shows some
+   examples.
   </para>
 
   <para>
@@ -129,7 +132,7 @@ test=> select '6.25 .. 6.50'::seg as "pH";
    </tgroup>
   </table>
 
-  <table>
+  <table id="seg-input-examples">
    <title>Examples of valid <type>seg</> input</title>
    <tgroup cols="2">
     <tbody>

diff --git a/doc/src/sgml/tablefunc.sgml b/doc/src/sgml/tablefunc.sgml
index ba3770d2e72ba15f895eac762e8ccb4d41a0fbfc..437ca7b6f8f77680006e8bdd53826ce043b21aa1 100644 (file)
--- a/doc/src/sgml/tablefunc.sgml
+++ b/doc/src/sgml/tablefunc.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/tablefunc.sgml,v 1.4.16.1 2010/07/29 19:34:37 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/tablefunc.sgml,v 1.4.16.2 2010/08/10 20:42:02 petere Exp $ -->
 
 <sect1 id="tablefunc">
  <title>tablefunc</title>
@@ -17,7 +17,12 @@
  <sect2>
   <title>Functions Provided</title>
 
-  <table>
+  <para>
+   <xref linkend="tablefunc-functions"> shows the functions provided
+   by the <filename>tablefunc</filename> module.
+  </para>
+
+  <table id="tablefunc-functions">
    <title><filename>tablefunc</> functions</title>
    <tgroup cols="3">
     <thead>
@@ -609,7 +614,12 @@ connectby(text relname, text keyid_fld, text parent_keyid_fld
     sub-tree descending from any row.
    </para>
 
-   <table>
+   <para>
+    <xref linkend="tablefunc-connectby-parameters"> explains the
+    parameters.
+   </para>
+
+   <table id="tablefunc-connectby-parameters">
     <title><function>connectby</function> parameters</title>
     <tgroup cols="2">
      <thead>

diff --git a/doc/src/sgml/uuid-ossp.sgml b/doc/src/sgml/uuid-ossp.sgml
index e052c0a4b3aaabeb8b9bf67a16258976fc4bec37..df11fc9f19b08c5d846eb1af72d6a9500a869210 100644 (file)
--- a/doc/src/sgml/uuid-ossp.sgml
+++ b/doc/src/sgml/uuid-ossp.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/uuid-ossp.sgml,v 1.2.16.1 2010/07/29 19:34:37 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/uuid-ossp.sgml,v 1.2.16.2 2010/08/10 20:42:02 petere Exp $ -->
 
 <sect1 id="uuid-ossp">
  <title>uuid-ossp</title>
@@ -22,6 +22,8 @@
   <title><literal>uuid-ossp</literal> Functions</title>
 
   <para>
+   <xref linkend="uuid-ossp-functions"> shows the functions available to
+   generate UUIDs.
    The relevant standards ITU-T Rec. X.667, ISO/IEC 9834-8:2005, and RFC
    4122 specify four algorithms for generating UUIDs, identified by the
    version numbers 1, 3, 4, and 5.  (There is no version 2 algorithm.)
@@ -29,7 +31,7 @@
    applications.
   </para>
 
-  <table>
+  <table id="uuid-ossp-functions">
    <title>Functions for UUID Generation</title>
    <tgroup cols="2">
     <thead>
@@ -67,9 +69,22 @@
         This function generates a version 3 UUID in the given namespace using
         the specified input name.  The namespace should be one of the special
         constants produced by the <function>uuid_ns_*()</> functions shown
-        below.  (It could be any UUID in theory.)  The name is an identifier
+        in <xref linkend="uuid-ossp-constants">.  (It could be any UUID in theory.)  The name is an identifier
         in the selected namespace.
        </para>
+
+       <para>
+        For example:
+
+<programlisting>
+SELECT uuid_generate_v3(uuid_ns_url(), 'http://www.postgresql.org');
+</programlisting>
+
+        The name parameter will be MD5-hashed, so the cleartext cannot be
+        derived from the generated UUID.
+        The generation of UUIDs by this method has no random or
+        environment-dependent element and is therefore reproducible.
+       </para>
       </entry>
      </row>
      <row>
@@ -96,20 +111,7 @@
    </tgroup>
   </table>
 
-  <para>
-   For example:
-
-<programlisting>
-SELECT uuid_generate_v3(uuid_ns_url(), 'http://www.postgresql.org');
-</programlisting>
-
-   The name parameter will be MD5-hashed, so the cleartext cannot be
-   derived from the generated UUID.
-   The generation of UUIDs by this method has no random or
-   environment-dependent element and is therefore reproducible.
-  </para>
-
-  <table>
+  <table id="uuid-ossp-constants">
    <title>Functions Returning UUID Constants</title>
    <tgroup cols="2">
     <tbody>

diff --git a/doc/src/sgml/xml2.sgml b/doc/src/sgml/xml2.sgml
index 0badb2d8ef96d5458180cd1c6bce27dea8438344..eaeca083a1b3eaf799b90d43d4c7942f48ea0221 100644 (file)
--- a/doc/src/sgml/xml2.sgml
+++ b/doc/src/sgml/xml2.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/xml2.sgml,v 1.7.14.2 2010/07/29 19:34:37 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/xml2.sgml,v 1.7.14.3 2010/08/10 20:42:02 petere Exp $ -->
 
 <sect1 id="xml2">
  <title>xml2</title>
@@ -160,11 +160,12 @@ xpath_table(text key, text document, text relation, text xpaths, text criteria)
    queries on each of a set of documents and returns the results as a
    table. The primary key field from the original document table is returned
    as the first column of the result so that the result set
-   can readily be used in joins.
+   can readily be used in joins.  The parameters are described in
+   <xref linkend="xml2-xpath-table-parameters">.
   </para>
 
-  <table>
-   <title>Parameters</title>
+  <table id="xml2-xpath-table-parameters">
+   <title><function>xpath_table</function> Parameters</title>
    <tgroup cols="2">
     <tbody>
      <row>