Refer to tables by id, not by "the following table", because tables are in

theory floating elements.
This commit is contained in:
Peter Eisentraut 2009-05-18 11:08:24 +00:00
parent 263144140f
commit 9c4c70321d
10 changed files with 58 additions and 58 deletions

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/cube.sgml,v 1.5 2007/12/06 04:12:09 tgl Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/cube.sgml,v 1.6 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="cube">
<title>cube</title>
@ -16,12 +16,13 @@
<title>Syntax</title>
<para>
The following are valid external representations for the <type>cube</>
type. <replaceable>x</>, <replaceable>y</>, etc denote floating-point
numbers:
<xref linkend="cube-repr-table"> shows the valid external
representations for the <type>cube</>
type. <replaceable>x</>, <replaceable>y</>, etc. denote
floating-point numbers.
</para>
<table>
<table id="cube-repr-table">
<title>Cube external representations</title>
<tgroup cols="2">
<tbody>
@ -159,10 +160,10 @@ a &lt;@ b Contained in
</para>
<para>
The following functions are available:
<xref linkend="cube-functions-table"> shows the available functions.
</para>
<table>
<table id="cube-functions-table">
<title>Cube functions</title>
<tgroup cols="2">
<tbody>

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ecpg.sgml,v 1.88 2009/04/27 16:27:35 momjian Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/ecpg.sgml,v 1.89 2009/05/18 11:08:24 petere Exp $ -->
<chapter id="ecpg">
<title><application>ECPG</application> - Embedded <acronym>SQL</acronym> in C</title>
@ -1137,8 +1137,9 @@ date PGTYPESdate_from_asc(char *str, char **endptr);
currently no variable to change that within ecpg.
</para>
<para>
The following input formats are allowed:
<table>
<xref linkend="ecpg-pgtypesdate-from-asc-table"> shows the allowed input formats.
</para>
<table id="ecpg-pgtypesdate-from-asc-table">
<title>Valid input formats for <function>PGTYPESdate_from_asc</function></title>
<tgroup cols="2">
<thead>
@ -1219,7 +1220,6 @@ date PGTYPESdate_from_asc(char *str, char **endptr);
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
@ -1392,10 +1392,11 @@ int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);
All other characters are copied 1:1 to the output string.
</para>
<para>
The following table indicates a few possible formats. This will give
<xref linkend="ecpg-pgtypesdate-fmt-asc-example-table"> indicates a few possible formats. This will give
you an idea of how to use this function. All output lines are based on
the same date: November, 23rd, 1959.
<table>
the same date: November 23, 1959.
</para>
<table id="ecpg-pgtypesdate-fmt-asc-example-table">
<title>Valid input formats for <function>PGTYPESdate_fmt_asc</function></title>
<tgroup cols="2">
<thead>
@ -1456,7 +1457,6 @@ int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
@ -1483,9 +1483,10 @@ int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);
day.
</para>
<para>
The following table indicates a few possible formats. This will give
<xref linkend="ecpg-rdefmtdate-example-table"> indicates a few possible formats. This will give
you an idea of how to use this function.
<table>
</para>
<table id="ecpg-rdefmtdate-example-table">
<title>Valid input formats for <function>rdefmtdate</function></title>
<tgroup cols="3">
<thead>
@ -1564,7 +1565,6 @@ int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
</variablelist>
@ -1612,8 +1612,9 @@ timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);
specifiers are silently discarded.
</para>
<para>
The following table contains a few examples for input strings:
<table>
<xref linkend="ecpg-pgtypestimestamp-from-asc-example-table"> contains a few examples for input strings.
</para>
<table id="ecpg-pgtypestimestamp-from-asc-example-table">
<title>Valid input formats for <function>PGTYPEStimestamp_from_asc</function></title>
<tgroup cols="2">
<thead>
@ -1642,7 +1643,6 @@ timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/isn.sgml,v 1.4 2007/12/10 05:32:51 tgl Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/isn.sgml,v 1.5 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="isn">
<title>isn</title>
@ -210,11 +210,12 @@
<para>
The <filename>isn</> module provides the standard comparison operators,
plus btree and hash indexing support for all these datatypes. In
addition there are several specialized functions. In this table,
<type>isn</> means any one of the module's data types:
addition there are several specialized functions; shown in <xref linkend="isn-functions">.
In this table,
<type>isn</> means any one of the module's data types.
</para>
<table>
<table id="isn-functions">
<title><filename>isn</> functions</title>
<tgroup cols="3">
<thead>

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgbuffercache.sgml,v 2.4 2009/04/27 16:27:36 momjian Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgbuffercache.sgml,v 2.5 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="pgbuffercache">
<title>pg_buffercache</title>
@ -28,10 +28,10 @@
<title>The <structname>pg_buffercache</structname> view</title>
<para>
The definitions of the columns exposed by the view are:
The definitions of the columns exposed by the view are shown in <xref linkend="pgbuffercache-columns">.
</para>
<table>
<table id="pgbuffercache-columns">
<title><structname>pg_buffercache</> Columns</title>
<tgroup cols="4">

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.6 2008/01/17 14:34:45 mha Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.7 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="pgcrypto">
<title>pgcrypto</title>
@ -217,10 +217,11 @@
too high a count the time to calculate a hash may be several years
&mdash; which is somewhat impractical. If the <parameter>iter_count</>
parameter is omitted, the default iteration count is used.
Allowed values for <parameter>iter_count</> depend on the algorithm:
Allowed values for <parameter>iter_count</> depend on the algorithm and
are shown in <xref linkend="pgcrypto-icfc-table">.
</para>
<table>
<table id="pgcrypto-icfc-table">
<title>Iteration counts for <function>crypt()</></title>
<tgroup cols="4">
<thead>
@ -262,7 +263,7 @@
</para>
<para>
Here is a table that gives an overview of the relative slowness
<xref linkend="pgcrypto-hash-speed-table"> gives an overview of the relative slowness
of different hashing algorithms.
The table shows how much time it would take to try all
combinations of characters in an 8-character password, assuming
@ -273,7 +274,7 @@
<function>gen_salt</function>.
</para>
<table>
<table id="pgcrypto-hash-speed-table">
<title>Hash algorithm speeds</title>
<tgroup cols="4">
<thead>
@ -1224,8 +1225,7 @@
<filename>pgcrypto</filename> uses code from the following sources:
</para>
<table>
<title>Credits</title>
<informaltable>
<tgroup cols="3">
<thead>
<row>
@ -1277,7 +1277,7 @@
</row>
</tbody>
</tgroup>
</table>
</informaltable>
</sect2>
</sect1>

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgrowlocks.sgml,v 1.4 2007/12/10 05:32:51 tgl Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgrowlocks.sgml,v 1.5 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="pgrowlocks">
<title>pgrowlocks</title>
@ -15,17 +15,17 @@
<sect2>
<title>Overview</title>
<synopsis>
<synopsis>
pgrowlocks(text) returns setof record
</synopsis>
</synopsis>
<para>
The parameter is the name of a table. The result is a set of records,
with one row for each locked row within the table. The output columns
are:
are shown in <xref linkend="pgrowlocks-columns">.
</para>
<table>
<table id="pgrowlocks-columns">
<title><function>pgrowlocks</> output columns</title>
<tgroup cols="3">

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstatstatements.sgml,v 1.1 2009/01/04 22:19:59 tgl Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstatstatements.sgml,v 1.2 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="pgstatstatements">
<title>pg_stat_statements</title>
@ -27,10 +27,10 @@
named <structname>pg_stat_statements</>. This view contains one row for
each distinct query text, database ID, and user ID (up to the maximum
number of distinct statements that the module can track). The columns
of the view are:
of the view are shown in <xref linkend="pgstatstatements-columns">.
</para>
<table>
<table id="pgstatstatements-columns">
<title><structname>pg_stat_statements</> columns</title>
<tgroup cols="4">

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstattuple.sgml,v 1.4 2008/03/21 03:23:30 tgl Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstattuple.sgml,v 1.5 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="pgstattuple">
<title>pgstattuple</title>
@ -28,8 +28,7 @@
to determine whether vacuum is necessary or not. The argument is the
target relation's name (optionally schema-qualified).
For example:
</para>
<programlisting>
<programlisting>
test=> SELECT * FROM pgstattuple('pg_catalog.pg_proc');
-[ RECORD 1 ]------+-------
table_len | 458752
@ -41,13 +40,11 @@ dead_tuple_len | 3157
dead_tuple_percent | 0.69
free_space | 8932
free_percent | 1.95
</programlisting>
<para>
The output columns are:
</programlisting>
The output columns are described in <xref linkend="pgstattuple-columns">.
</para>
<table>
<table id="pgstattuple-columns">
<title><function>pgstattuple</function> output columns</title>
<tgroup cols="3">
<thead>

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/seg.sgml,v 1.4 2007/12/06 04:12:10 tgl Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/seg.sgml,v 1.5 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="seg">
<title>seg</title>
@ -89,13 +89,13 @@ test=> select '6.25 .. 6.50'::seg as "pH";
</para>
<para>
In the following table, <replaceable>x</>, <replaceable>y</>, and
In <xref linkend="seg-repr-table">, <replaceable>x</>, <replaceable>y</>, and
<replaceable>delta</> denote
floating-point numbers. <replaceable>x</> and <replaceable>y</>, but
not <replaceable>delta</>, can be preceded by a certainty indicator:
not <replaceable>delta</>, can be preceded by a certainty indicator.
</para>
<table>
<table id="seg-repr-table">
<title><type>seg</> external representations</title>
<tgroup cols="2">
<tbody>

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/xml2.sgml,v 1.6 2009/04/27 16:27:36 momjian Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/xml2.sgml,v 1.7 2009/05/18 11:08:24 petere Exp $ -->
<sect1 id="xml2">
<title>xml2</title>
@ -34,11 +34,12 @@
<title>Description of functions</title>
<para>
<xref linkend="xml2-functions-table"> shows the functions provided by this module.
These functions provide straightforward XML parsing and XPath queries.
All arguments are of type <type>text</>, so for brevity that is not shown.
</para>
<table>
<table id="xml2-functions-table">
<title>Functions</title>
<tgroup cols="2">
<tbody>