rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/src/sgml/cube.sgml
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"> <sect1 id="cube">
<title>cube</title> <title>cube</title>
@ -16,12 +16,13 @@
<title>Syntax</title> <title>Syntax</title>
<para> <para>
The following are valid external representations for the <type>cube</> <xref linkend="cube-repr-table"> shows the valid external
type. <replaceable>x</>, <replaceable>y</>, etc denote floating-point representations for the <type>cube</>
numbers: type. <replaceable>x</>, <replaceable>y</>, etc. denote
floating-point numbers.
</para> </para>
<table> <table id="cube-repr-table">
<title>Cube external representations</title> <title>Cube external representations</title>
<tgroup cols="2"> <tgroup cols="2">
<tbody> <tbody>
@ -159,10 +160,10 @@ a &lt;@ b Contained in
</para> </para>
<para> <para>
The following functions are available: <xref linkend="cube-functions-table"> shows the available functions.
</para> </para>
<table> <table id="cube-functions-table">
<title>Cube functions</title> <title>Cube functions</title>
<tgroup cols="2"> <tgroup cols="2">
<tbody> <tbody>

28
doc/src/sgml/ecpg.sgml
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"> <chapter id="ecpg">
<title><application>ECPG</application> - Embedded <acronym>SQL</acronym> in C</title> <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. currently no variable to change that within ecpg.
</para> </para>
<para> <para>
The following input formats are allowed: <xref linkend="ecpg-pgtypesdate-from-asc-table"> shows the allowed input formats.
<table> </para>
<table id="ecpg-pgtypesdate-from-asc-table">
<title>Valid input formats for <function>PGTYPESdate_from_asc</function></title> <title>Valid input formats for <function>PGTYPESdate_from_asc</function></title>
<tgroup cols="2"> <tgroup cols="2">
<thead> <thead>
@ -1219,7 +1220,6 @@ date PGTYPESdate_from_asc(char *str, char **endptr);
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
</para>
</listitem> </listitem>
</varlistentry> </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. All other characters are copied 1:1 to the output string.
</para> </para>
<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 you an idea of how to use this function. All output lines are based on
the same date: November, 23rd, 1959. the same date: November 23, 1959.
<table> </para>
<table id="ecpg-pgtypesdate-fmt-asc-example-table">
<title>Valid input formats for <function>PGTYPESdate_fmt_asc</function></title> <title>Valid input formats for <function>PGTYPESdate_fmt_asc</function></title>
<tgroup cols="2"> <tgroup cols="2">
<thead> <thead>
@ -1456,7 +1457,6 @@ int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1483,9 +1483,10 @@ int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);
day. day.
</para> </para>
<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. 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> <title>Valid input formats for <function>rdefmtdate</function></title>
<tgroup cols="3"> <tgroup cols="3">
<thead> <thead>
@ -1564,7 +1565,6 @@ int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -1612,8 +1612,9 @@ timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);
specifiers are silently discarded. specifiers are silently discarded.
</para> </para>
<para> <para>
The following table contains a few examples for input strings: <xref linkend="ecpg-pgtypestimestamp-from-asc-example-table"> contains a few examples for input strings.
<table> </para>
<table id="ecpg-pgtypestimestamp-from-asc-example-table">
<title>Valid input formats for <function>PGTYPEStimestamp_from_asc</function></title> <title>Valid input formats for <function>PGTYPEStimestamp_from_asc</function></title>
<tgroup cols="2"> <tgroup cols="2">
<thead> <thead>
@ -1642,7 +1643,6 @@ timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

9
doc/src/sgml/isn.sgml
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"> <sect1 id="isn">
<title>isn</title> <title>isn</title>
@ -210,11 +210,12 @@
<para> <para>
The <filename>isn</> module provides the standard comparison operators, The <filename>isn</> module provides the standard comparison operators,
plus btree and hash indexing support for all these datatypes. In plus btree and hash indexing support for all these datatypes. In
addition there are several specialized functions. In this table, addition there are several specialized functions; shown in <xref linkend="isn-functions">.
<type>isn</> means any one of the module's data types: In this table,
<type>isn</> means any one of the module's data types.
</para> </para>
<table> <table id="isn-functions">
<title><filename>isn</> functions</title> <title><filename>isn</> functions</title>
<tgroup cols="3"> <tgroup cols="3">
<thead> <thead>

6
doc/src/sgml/pgbuffercache.sgml
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"> <sect1 id="pgbuffercache">
<title>pg_buffercache</title> <title>pg_buffercache</title>
@ -28,10 +28,10 @@
<title>The <structname>pg_buffercache</structname> view</title> <title>The <structname>pg_buffercache</structname> view</title>
<para> <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> </para>
<table> <table id="pgbuffercache-columns">
<title><structname>pg_buffercache</> Columns</title> <title><structname>pg_buffercache</> Columns</title>
<tgroup cols="4"> <tgroup cols="4">

16
doc/src/sgml/pgcrypto.sgml
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"> <sect1 id="pgcrypto">
<title>pgcrypto</title> <title>pgcrypto</title>
@ -217,10 +217,11 @@
too high a count the time to calculate a hash may be several years too high a count the time to calculate a hash may be several years
&mdash; which is somewhat impractical. If the <parameter>iter_count</> &mdash; which is somewhat impractical. If the <parameter>iter_count</>
parameter is omitted, the default iteration count is used. 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> </para>
<table> <table id="pgcrypto-icfc-table">
<title>Iteration counts for <function>crypt()</></title> <title>Iteration counts for <function>crypt()</></title>
<tgroup cols="4"> <tgroup cols="4">
<thead> <thead>
@ -262,7 +263,7 @@
</para> </para>
<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. of different hashing algorithms.
The table shows how much time it would take to try all The table shows how much time it would take to try all
combinations of characters in an 8-character password, assuming combinations of characters in an 8-character password, assuming
@ -273,7 +274,7 @@
<function>gen_salt</function>. <function>gen_salt</function>.
</para> </para>
<table> <table id="pgcrypto-hash-speed-table">
<title>Hash algorithm speeds</title> <title>Hash algorithm speeds</title>
<tgroup cols="4"> <tgroup cols="4">
<thead> <thead>
@ -1224,8 +1225,7 @@
<filename>pgcrypto</filename> uses code from the following sources: <filename>pgcrypto</filename> uses code from the following sources:
</para> </para>
<table> <informaltable>
<title>Credits</title>
<tgroup cols="3"> <tgroup cols="3">
<thead> <thead>
<row> <row>
@ -1277,7 +1277,7 @@
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</table> </informaltable>
</sect2> </sect2>
</sect1> </sect1>

10
doc/src/sgml/pgrowlocks.sgml
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"> <sect1 id="pgrowlocks">
<title>pgrowlocks</title> <title>pgrowlocks</title>
@ -15,17 +15,17 @@
<sect2> <sect2>
<title>Overview</title> <title>Overview</title>
<synopsis> <synopsis>
pgrowlocks(text) returns setof record pgrowlocks(text) returns setof record
</synopsis> </synopsis>
<para> <para>
The parameter is the name of a table. The result is a set of records, 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 with one row for each locked row within the table. The output columns
are: are shown in <xref linkend="pgrowlocks-columns">.
</para> </para>
<table> <table id="pgrowlocks-columns">
<title><function>pgrowlocks</> output columns</title> <title><function>pgrowlocks</> output columns</title>
<tgroup cols="3"> <tgroup cols="3">

6
doc/src/sgml/pgstatstatements.sgml
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"> <sect1 id="pgstatstatements">
<title>pg_stat_statements</title> <title>pg_stat_statements</title>
@ -27,10 +27,10 @@
named <structname>pg_stat_statements</>. This view contains one row for named <structname>pg_stat_statements</>. This view contains one row for
each distinct query text, database ID, and user ID (up to the maximum each distinct query text, database ID, and user ID (up to the maximum
number of distinct statements that the module can track). The columns 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> </para>
<table> <table id="pgstatstatements-columns">
<title><structname>pg_stat_statements</> columns</title> <title><structname>pg_stat_statements</> columns</title>
<tgroup cols="4"> <tgroup cols="4">

13
doc/src/sgml/pgstattuple.sgml
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"> <sect1 id="pgstattuple">
<title>pgstattuple</title> <title>pgstattuple</title>
@ -28,8 +28,7 @@
to determine whether vacuum is necessary or not. The argument is the to determine whether vacuum is necessary or not. The argument is the
target relation's name (optionally schema-qualified). target relation's name (optionally schema-qualified).
For example: For example:
</para> <programlisting>
<programlisting>
test=> SELECT * FROM pgstattuple('pg_catalog.pg_proc'); test=> SELECT * FROM pgstattuple('pg_catalog.pg_proc');
-[ RECORD 1 ]------+------- -[ RECORD 1 ]------+-------
table_len | 458752 table_len | 458752
@ -41,13 +40,11 @@ dead_tuple_len | 3157
dead_tuple_percent | 0.69 dead_tuple_percent | 0.69
free_space | 8932 free_space | 8932
free_percent | 1.95 free_percent | 1.95
</programlisting> </programlisting>
The output columns are described in <xref linkend="pgstattuple-columns">.
<para>
The output columns are:
</para> </para>
<table> <table id="pgstattuple-columns">
<title><function>pgstattuple</function> output columns</title> <title><function>pgstattuple</function> output columns</title>
<tgroup cols="3"> <tgroup cols="3">
<thead> <thead>

8
doc/src/sgml/seg.sgml
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"> <sect1 id="seg">
<title>seg</title> <title>seg</title>
@ -89,13 +89,13 @@ test=> select '6.25 .. 6.50'::seg as "pH";
</para> </para>
<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 <replaceable>delta</> denote
floating-point numbers. <replaceable>x</> and <replaceable>y</>, but 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> </para>
<table> <table id="seg-repr-table">
<title><type>seg</> external representations</title> <title><type>seg</> external representations</title>
<tgroup cols="2"> <tgroup cols="2">
<tbody> <tbody>

5
doc/src/sgml/xml2.sgml
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"> <sect1 id="xml2">
<title>xml2</title> <title>xml2</title>
@ -34,11 +34,12 @@
<title>Description of functions</title> <title>Description of functions</title>
<para> <para>
<xref linkend="xml2-functions-table"> shows the functions provided by this module.
These functions provide straightforward XML parsing and XPath queries. These functions provide straightforward XML parsing and XPath queries.
All arguments are of type <type>text</>, so for brevity that is not shown. All arguments are of type <type>text</>, so for brevity that is not shown.
</para> </para>
<table> <table id="xml2-functions-table">
<title>Functions</title> <title>Functions</title>
<tgroup cols="2"> <tgroup cols="2">
<tbody> <tbody>