Skip to content

Commit 9c4c703

Browse files
peterepetere
committed
Refer to tables by id, not by "the following table", because tables are in
theory floating elements.
1 parent 2631441 commit 9c4c703

File tree

10 files changed

+58
-58
lines changed

10 files changed

+58
-58
lines changed

‎doc/src/sgml/cube.sgml

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/cube.sgml,v 1.5 2007/12/06 04:12:09 tgl Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/cube.sgml,v 1.6 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="cube">
44
<title>cube</title>
@@ -16,12 +16,13 @@
1616
<title>Syntax</title>
1717

1818
<para>
19-
The following are valid external representations for the <type>cube</>
20-
type. <replaceable>x</>, <replaceable>y</>, etc denote floating-point
21-
numbers:
19+
<xref linkend="cube-repr-table"> shows the valid external
20+
representations for the <type>cube</>
21+
type. <replaceable>x</>, <replaceable>y</>, etc. denote
22+
floating-point numbers.
2223
</para>
2324

24-
<table>
25+
<table id="cube-repr-table">
2526
<title>Cube external representations</title>
2627
<tgroup cols="2">
2728
<tbody>
@@ -159,10 +160,10 @@ a &lt;@ b Contained in
159160
</para>
160161

161162
<para>
162-
The following functions are available:
163+
<xref linkend="cube-functions-table"> shows the available functions.
163164
</para>
164165

165-
<table>
166+
<table id="cube-functions-table">
166167
<title>Cube functions</title>
167168
<tgroup cols="2">
168169
<tbody>

‎doc/src/sgml/ecpg.sgml

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/ecpg.sgml,v 1.88 2009/04/27 16:27:35 momjian Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/ecpg.sgml,v 1.89 2009/05/18 11:08:24 petere Exp $ -->
22

33
<chapter id="ecpg">
44
<title><application>ECPG</application> - Embedded <acronym>SQL</acronym> in C</title>
@@ -1137,8 +1137,9 @@ date PGTYPESdate_from_asc(char *str, char **endptr);
11371137
currently no variable to change that within ecpg.
11381138
</para>
11391139
<para>
1140-
The following input formats are allowed:
1141-
<table>
1140+
<xref linkend="ecpg-pgtypesdate-from-asc-table"> shows the allowed input formats.
1141+
</para>
1142+
<table id="ecpg-pgtypesdate-from-asc-table">
11421143
<title>Valid input formats for <function>PGTYPESdate_from_asc</function></title>
11431144
<tgroup cols="2">
11441145
<thead>
@@ -1219,7 +1220,6 @@ date PGTYPESdate_from_asc(char *str, char **endptr);
12191220
</tbody>
12201221
</tgroup>
12211222
</table>
1222-
</para>
12231223
</listitem>
12241224
</varlistentry>
12251225

@@ -1392,10 +1392,11 @@ int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);
13921392
All other characters are copied 1:1 to the output string.
13931393
</para>
13941394
<para>
1395-
The following table indicates a few possible formats. This will give
1395+
<xref linkend="ecpg-pgtypesdate-fmt-asc-example-table"> indicates a few possible formats. This will give
13961396
you an idea of how to use this function. All output lines are based on
1397-
the same date: November, 23rd, 1959.
1398-
<table>
1397+
the same date: November 23, 1959.
1398+
</para>
1399+
<table id="ecpg-pgtypesdate-fmt-asc-example-table">
13991400
<title>Valid input formats for <function>PGTYPESdate_fmt_asc</function></title>
14001401
<tgroup cols="2">
14011402
<thead>
@@ -1456,7 +1457,6 @@ int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);
14561457
</tbody>
14571458
</tgroup>
14581459
</table>
1459-
</para>
14601460
</listitem>
14611461
</varlistentry>
14621462

@@ -1483,9 +1483,10 @@ int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);
14831483
day.
14841484
</para>
14851485
<para>
1486-
The following table indicates a few possible formats. This will give
1486+
<xref linkend="ecpg-rdefmtdate-example-table"> indicates a few possible formats. This will give
14871487
you an idea of how to use this function.
1488-
<table>
1488+
</para>
1489+
<table id="ecpg-rdefmtdate-example-table">
14891490
<title>Valid input formats for <function>rdefmtdate</function></title>
14901491
<tgroup cols="3">
14911492
<thead>
@@ -1564,7 +1565,6 @@ int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);
15641565
</tbody>
15651566
</tgroup>
15661567
</table>
1567-
</para>
15681568
</listitem>
15691569
</varlistentry>
15701570
</variablelist>
@@ -1612,8 +1612,9 @@ timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);
16121612
specifiers are silently discarded.
16131613
</para>
16141614
<para>
1615-
The following table contains a few examples for input strings:
1616-
<table>
1615+
<xref linkend="ecpg-pgtypestimestamp-from-asc-example-table"> contains a few examples for input strings.
1616+
</para>
1617+
<table id="ecpg-pgtypestimestamp-from-asc-example-table">
16171618
<title>Valid input formats for <function>PGTYPEStimestamp_from_asc</function></title>
16181619
<tgroup cols="2">
16191620
<thead>
@@ -1642,7 +1643,6 @@ timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);
16421643
</tbody>
16431644
</tgroup>
16441645
</table>
1645-
</para>
16461646
</listitem>
16471647
</varlistentry>
16481648

‎doc/src/sgml/isn.sgml

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/isn.sgml,v 1.4 2007/12/10 05:32:51 tgl Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/isn.sgml,v 1.5 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="isn">
44
<title>isn</title>
@@ -210,11 +210,12 @@
210210
<para>
211211
The <filename>isn</> module provides the standard comparison operators,
212212
plus btree and hash indexing support for all these datatypes. In
213-
addition there are several specialized functions. In this table,
214-
<type>isn</> means any one of the module's data types:
213+
addition there are several specialized functions; shown in <xref linkend="isn-functions">.
214+
In this table,
215+
<type>isn</> means any one of the module's data types.
215216
</para>
216217

217-
<table>
218+
<table id="isn-functions">
218219
<title><filename>isn</> functions</title>
219220
<tgroup cols="3">
220221
<thead>

‎doc/src/sgml/pgbuffercache.sgml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgbuffercache.sgml,v 2.4 2009/04/27 16:27:36 momjian Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgbuffercache.sgml,v 2.5 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="pgbuffercache">
44
<title>pg_buffercache</title>
@@ -28,10 +28,10 @@
2828
<title>The <structname>pg_buffercache</structname> view</title>
2929

3030
<para>
31-
The definitions of the columns exposed by the view are:
31+
The definitions of the columns exposed by the view are shown in <xref linkend="pgbuffercache-columns">.
3232
</para>
3333

34-
<table>
34+
<table id="pgbuffercache-columns">
3535
<title><structname>pg_buffercache</> Columns</title>
3636

3737
<tgroup cols="4">

‎doc/src/sgml/pgcrypto.sgml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.6 2008/01/17 14:34:45 mha Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.7 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="pgcrypto">
44
<title>pgcrypto</title>
@@ -217,10 +217,11 @@
217217
too high a count the time to calculate a hash may be several years
218218
&mdash; which is somewhat impractical. If the <parameter>iter_count</>
219219
parameter is omitted, the default iteration count is used.
220-
Allowed values for <parameter>iter_count</> depend on the algorithm:
220+
Allowed values for <parameter>iter_count</> depend on the algorithm and
221+
are shown in <xref linkend="pgcrypto-icfc-table">.
221222
</para>
222223

223-
<table>
224+
<table id="pgcrypto-icfc-table">
224225
<title>Iteration counts for <function>crypt()</></title>
225226
<tgroup cols="4">
226227
<thead>
@@ -262,7 +263,7 @@
262263
</para>
263264

264265
<para>
265-
Here is a table that gives an overview of the relative slowness
266+
<xref linkend="pgcrypto-hash-speed-table"> gives an overview of the relative slowness
266267
of different hashing algorithms.
267268
The table shows how much time it would take to try all
268269
combinations of characters in an 8-character password, assuming
@@ -273,7 +274,7 @@
273274
<function>gen_salt</function>.
274275
</para>
275276

276-
<table>
277+
<table id="pgcrypto-hash-speed-table">
277278
<title>Hash algorithm speeds</title>
278279
<tgroup cols="4">
279280
<thead>
@@ -1224,8 +1225,7 @@
12241225
<filename>pgcrypto</filename> uses code from the following sources:
12251226
</para>
12261227

1227-
<table>
1228-
<title>Credits</title>
1228+
<informaltable>
12291229
<tgroup cols="3">
12301230
<thead>
12311231
<row>
@@ -1277,7 +1277,7 @@
12771277
</row>
12781278
</tbody>
12791279
</tgroup>
1280-
</table>
1280+
</informaltable>
12811281
</sect2>
12821282

12831283
</sect1>

‎doc/src/sgml/pgrowlocks.sgml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgrowlocks.sgml,v 1.4 2007/12/10 05:32:51 tgl Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgrowlocks.sgml,v 1.5 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="pgrowlocks">
44
<title>pgrowlocks</title>
@@ -15,17 +15,17 @@
1515
<sect2>
1616
<title>Overview</title>
1717

18-
<synopsis>
18+
<synopsis>
1919
pgrowlocks(text) returns setof record
20-
</synopsis>
20+
</synopsis>
2121

2222
<para>
2323
The parameter is the name of a table. The result is a set of records,
2424
with one row for each locked row within the table. The output columns
25-
are:
25+
are shown in <xref linkend="pgrowlocks-columns">.
2626
</para>
2727

28-
<table>
28+
<table id="pgrowlocks-columns">
2929
<title><function>pgrowlocks</> output columns</title>
3030

3131
<tgroup cols="3">

‎doc/src/sgml/pgstatstatements.sgml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstatstatements.sgml,v 1.1 2009/01/04 22:19:59 tgl Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstatstatements.sgml,v 1.2 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="pgstatstatements">
44
<title>pg_stat_statements</title>
@@ -27,10 +27,10 @@
2727
named <structname>pg_stat_statements</>. This view contains one row for
2828
each distinct query text, database ID, and user ID (up to the maximum
2929
number of distinct statements that the module can track). The columns
30-
of the view are:
30+
of the view are shown in <xref linkend="pgstatstatements-columns">.
3131
</para>
3232

33-
<table>
33+
<table id="pgstatstatements-columns">
3434
<title><structname>pg_stat_statements</> columns</title>
3535

3636
<tgroup cols="4">

‎doc/src/sgml/pgstattuple.sgml

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstattuple.sgml,v 1.4 2008/03/21 03:23:30 tgl Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstattuple.sgml,v 1.5 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="pgstattuple">
44
<title>pgstattuple</title>
@@ -28,8 +28,7 @@
2828
to determine whether vacuum is necessary or not. The argument is the
2929
target relation's name (optionally schema-qualified).
3030
For example:
31-
</para>
32-
<programlisting>
31+
<programlisting>
3332
test=> SELECT * FROM pgstattuple('pg_catalog.pg_proc');
3433
-[ RECORD 1 ]------+-------
3534
table_len | 458752
@@ -41,13 +40,11 @@ dead_tuple_len | 3157
4140
dead_tuple_percent | 0.69
4241
free_space | 8932
4342
free_percent | 1.95
44-
</programlisting>
45-
46-
<para>
47-
The output columns are:
43+
</programlisting>
44+
The output columns are described in <xref linkend="pgstattuple-columns">.
4845
</para>
4946

50-
<table>
47+
<table id="pgstattuple-columns">
5148
<title><function>pgstattuple</function> output columns</title>
5249
<tgroup cols="3">
5350
<thead>

‎doc/src/sgml/seg.sgml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/seg.sgml,v 1.4 2007/12/06 04:12:10 tgl Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/seg.sgml,v 1.5 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="seg">
44
<title>seg</title>
@@ -89,13 +89,13 @@ test=> select '6.25 .. 6.50'::seg as "pH";
8989
</para>
9090

9191
<para>
92-
In the following table, <replaceable>x</>, <replaceable>y</>, and
92+
In <xref linkend="seg-repr-table">, <replaceable>x</>, <replaceable>y</>, and
9393
<replaceable>delta</> denote
9494
floating-point numbers. <replaceable>x</> and <replaceable>y</>, but
95-
not <replaceable>delta</>, can be preceded by a certainty indicator:
95+
not <replaceable>delta</>, can be preceded by a certainty indicator.
9696
</para>
9797

98-
<table>
98+
<table id="seg-repr-table">
9999
<title><type>seg</> external representations</title>
100100
<tgroup cols="2">
101101
<tbody>

‎doc/src/sgml/xml2.sgml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/xml2.sgml,v 1.6 2009/04/27 16:27:36 momjian Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/xml2.sgml,v 1.7 2009/05/18 11:08:24 petere Exp $ -->
22

33
<sect1 id="xml2">
44
<title>xml2</title>
@@ -34,11 +34,12 @@
3434
<title>Description of functions</title>
3535

3636
<para>
37+
<xref linkend="xml2-functions-table"> shows the functions provided by this module.
3738
These functions provide straightforward XML parsing and XPath queries.
3839
All arguments are of type <type>text</>, so for brevity that is not shown.
3940
</para>
4041

41-
<table>
42+
<table id="xml2-functions-table">
4243
<title>Functions</title>
4344
<tgroup cols="2">
4445
<tbody>

0 commit comments

Comments
 (0)