Skip to content

Commit 5148a04

Browse files
peterepetere
committed
Add some links to tables
1 parent 6d5afc2 commit 5148a04

File tree

7 files changed

+60
-35
lines changed

7 files changed

+60
-35
lines changed

‎doc/src/sgml/isn.sgml

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/isn.sgml,v 1.6 2010/07/29 19:34:40 petere Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/isn.sgml,v 1.7 2010/08/10 20:42:01 petere Exp $ -->
22

33
<sect1 id="isn">
44
<title>isn</title>
@@ -17,7 +17,12 @@
1717
<sect2>
1818
<title>Data types</title>
1919

20-
<table>
20+
<para>
21+
<xref linkend="isn-datatypes"> shows the data types provided by
22+
the <filename>isn</filename> module.
23+
</para>
24+
25+
<table id="isn-datatypes">
2126
<title><filename>isn</filename> data types</title>
2227
<tgroup cols="2">
2328
<thead>

‎doc/src/sgml/pgcrypto.sgml

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.10 2010/07/29 19:34:40 petere Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgcrypto.sgml,v 1.11 2010/08/10 20:42:01 petere Exp $ -->
22

33
<sect1 id="pgcrypto">
44
<title>pgcrypto</title>
@@ -115,7 +115,12 @@ hmac(data bytea, key text, type text) returns bytea
115115
</listitem>
116116
</orderedlist>
117117

118-
<table>
118+
<para>
119+
<xref linkend="pgcrypto-crypt-algorithms"> lists the algorithms
120+
supported by the <function>crypt()</function> function.
121+
</para>
122+
123+
<table id="pgcrypto-crypt-algorithms">
119124
<title>Supported algorithms for <function>crypt()</></title>
120125
<tgroup cols="5">
121126
<thead>

‎doc/src/sgml/pgstattuple.sgml

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstattuple.sgml,v 1.6 2010/07/29 19:34:40 petere Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/pgstattuple.sgml,v 1.7 2010/08/10 20:42:01 petere Exp $ -->
22

33
<sect1 id="pgstattuple">
44
<title>pgstattuple</title>
@@ -159,10 +159,8 @@ leaf_fragmentation | 0
159159

160160
<para>
161161
The output columns are:
162-
</para>
163162

164-
<table>
165-
<title><function>pgstatindex</function> output columns</title>
163+
<informaltable>
166164
<tgroup cols="3">
167165
<thead>
168166
<row>
@@ -235,7 +233,8 @@ leaf_fragmentation | 0
235233

236234
</tbody>
237235
</tgroup>
238-
</table>
236+
</informaltable>
237+
</para>
239238

240239
<para>
241240
As with <function>pgstattuple</>, the results are accumulated

‎doc/src/sgml/seg.sgml

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/seg.sgml,v 1.7 2010/07/29 19:34:40 petere Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/seg.sgml,v 1.8 2010/08/10 20:42:01 petere Exp $ -->
22

33
<sect1 id="seg">
44
<title>seg</title>
@@ -86,6 +86,9 @@ test=> select '6.25 .. 6.50'::seg as "pH";
8686
Optional certainty indicators (<literal>&lt;</literal>,
8787
<literal>&gt;</literal> and <literal>~</literal>) can be stored as well.
8888
(Certainty indicators are ignored by all the built-in operators, however.)
89+
<xref linkend="seg-repr-table"> gives on overview over the allowed
90+
representations; <xref linkend="seg-input-examples"> shows some
91+
examples.
8992
</para>
9093

9194
<para>
@@ -129,7 +132,7 @@ test=> select '6.25 .. 6.50'::seg as "pH";
129132
</tgroup>
130133
</table>
131134

132-
<table>
135+
<table id="seg-input-examples">
133136
<title>Examples of valid <type>seg</> input</title>
134137
<tgroup cols="2">
135138
<tbody>

‎doc/src/sgml/tablefunc.sgml

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/tablefunc.sgml,v 1.5 2010/07/29 19:34:40 petere Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/tablefunc.sgml,v 1.6 2010/08/10 20:42:01 petere Exp $ -->
22

33
<sect1 id="tablefunc">
44
<title>tablefunc</title>
@@ -17,7 +17,12 @@
1717
<sect2>
1818
<title>Functions Provided</title>
1919

20-
<table>
20+
<para>
21+
<xref linkend="tablefunc-functions"> shows the functions provided
22+
by the <filename>tablefunc</filename> module.
23+
</para>
24+
25+
<table id="tablefunc-functions">
2126
<title><filename>tablefunc</> functions</title>
2227
<tgroup cols="3">
2328
<thead>
@@ -609,7 +614,12 @@ connectby(text relname, text keyid_fld, text parent_keyid_fld
609614
sub-tree descending from any row.
610615
</para>
611616

612-
<table>
617+
<para>
618+
<xref linkend="tablefunc-connectby-parameters"> explains the
619+
parameters.
620+
</para>
621+
622+
<table id="tablefunc-connectby-parameters">
613623
<title><function>connectby</function> parameters</title>
614624
<tgroup cols="2">
615625
<thead>

‎doc/src/sgml/uuid-ossp.sgml

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/uuid-ossp.sgml,v 1.3 2010/07/29 19:34:40 petere Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/uuid-ossp.sgml,v 1.4 2010/08/10 20:42:01 petere Exp $ -->
22

33
<sect1 id="uuid-ossp">
44
<title>uuid-ossp</title>
@@ -22,14 +22,16 @@
2222
<title><literal>uuid-ossp</literal> Functions</title>
2323

2424
<para>
25+
<xref linkend="uuid-ossp-functions"> shows the functions available to
26+
generate UUIDs.
2527
The relevant standards ITU-T Rec. X.667, ISO/IEC 9834-8:2005, and RFC
2628
4122 specify four algorithms for generating UUIDs, identified by the
2729
version numbers 1, 3, 4, and 5. (There is no version 2 algorithm.)
2830
Each of these algorithms could be suitable for a different set of
2931
applications.
3032
</para>
3133

32-
<table>
34+
<table id="uuid-ossp-functions">
3335
<title>Functions for UUID Generation</title>
3436
<tgroup cols="2">
3537
<thead>
@@ -67,9 +69,22 @@
6769
This function generates a version 3 UUID in the given namespace using
6870
the specified input name. The namespace should be one of the special
6971
constants produced by the <function>uuid_ns_*()</> functions shown
70-
below. (It could be any UUID in theory.) The name is an identifier
72+
in <xref linkend="uuid-ossp-constants">. (It could be any UUID in theory.) The name is an identifier
7173
in the selected namespace.
7274
</para>
75+
76+
<para>
77+
For example:
78+
79+
<programlisting>
80+
SELECT uuid_generate_v3(uuid_ns_url(), 'http://www.postgresql.org');
81+
</programlisting>
82+
83+
The name parameter will be MD5-hashed, so the cleartext cannot be
84+
derived from the generated UUID.
85+
The generation of UUIDs by this method has no random or
86+
environment-dependent element and is therefore reproducible.
87+
</para>
7388
</entry>
7489
</row>
7590
<row>
@@ -96,20 +111,7 @@
96111
</tgroup>
97112
</table>
98113

99-
<para>
100-
For example:
101-
102-
<programlisting>
103-
SELECT uuid_generate_v3(uuid_ns_url(), 'http://www.postgresql.org');
104-
</programlisting>
105-
106-
The name parameter will be MD5-hashed, so the cleartext cannot be
107-
derived from the generated UUID.
108-
The generation of UUIDs by this method has no random or
109-
environment-dependent element and is therefore reproducible.
110-
</para>
111-
112-
<table>
114+
<table id="uuid-ossp-constants">
113115
<title>Functions Returning UUID Constants</title>
114116
<tgroup cols="2">
115117
<tbody>

‎doc/src/sgml/xml2.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/xml2.sgml,v 1.9 2010/07/29 19:34:40 petere Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/xml2.sgml,v 1.10 2010/08/10 20:42:01 petere Exp $ -->
22

33
<sect1 id="xml2">
44
<title>xml2</title>
@@ -160,11 +160,12 @@ xpath_table(text key, text document, text relation, text xpaths, text criteria)
160160
queries on each of a set of documents and returns the results as a
161161
table. The primary key field from the original document table is returned
162162
as the first column of the result so that the result set
163-
can readily be used in joins.
163+
can readily be used in joins. The parameters are described in
164+
<xref linkend="xml2-xpath-table-parameters">.
164165
</para>
165166

166-
<table>
167-
<title>Parameters</title>
167+
<table id="xml2-xpath-table-parameters">
168+
<title><function>xpath_table</function> Parameters</title>
168169
<tgroup cols="2">
169170
<tbody>
170171
<row>

0 commit comments

Comments
 (0)