mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Spell checking and markup additions

Browse Source
This commit is contained in:
Peter Eisentraut 2002-03-22 19:20:45 +00:00
parent 108a0ec87d
commit b6ea172ace
47 changed files with 360 additions and 360 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/src/sgml/bki.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/bki.sgml,v 1.9 2001/11/21 22:57:01 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/bki.sgml,v 1.10 2002/03/22 19:20:02 petere Exp $
--> -->
<chapter id="bki"> <chapter id="bki">
@ -23,7 +23,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/bki.sgml,v 1.9 2001/11/21 22:57:01 tgl Exp
part of building and installing <productname>PostgreSQL</productname> part of building and installing <productname>PostgreSQL</productname>
by a program named <filename>genbki.sh</filename> from some by a program named <filename>genbki.sh</filename> from some
specially formatted C header files in the source tree. The created specially formatted C header files in the source tree. The created
BKI file is called <filename>postgres.bki</filename> and is <acronym>BKI</acronym> file is called <filename>postgres.bki</filename> and is
normally installed in the normally installed in the
<filename>share</filename> subdirectory of the installation tree. <filename>share</filename> subdirectory of the installation tree.
</para> </para>
@ -46,7 +46,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/bki.sgml,v 1.9 2001/11/21 22:57:01 tgl Exp
</para> </para>
<para> <para>
BKI input consists of a sequence of commands. Commands are made up <acronym>BKI</acronym> input consists of a sequence of commands. Commands are made up
of a number of tokens, depending on the syntax of the command. of a number of tokens, depending on the syntax of the command.
Tokens are usually separated by whitespace, but need not be if Tokens are usually separated by whitespace, but need not be if
there is no ambiguity. There is no special command separator; the there is no ambiguity. There is no special command separator; the
@ -64,7 +64,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/bki.sgml,v 1.9 2001/11/21 22:57:01 tgl Exp
</sect1> </sect1>
<sect1 id="bki-commands"> <sect1 id="bki-commands">
<title>BKI Commands</title> <title><acronym>BKI</acronym> Commands</title>
<variablelist> <variablelist>
<varlistentry> <varlistentry>

26
doc/src/sgml/catalogs.sgml
View File

@ -1,6 +1,6 @@
<!-- <!--
Documentation of the system catalogs, directed toward PostgreSQL developers Documentation of the system catalogs, directed toward PostgreSQL developers
$Header: /cvsroot/pgsql/doc/src/sgml/catalogs.sgml,v 2.35 2002/03/20 19:43:24 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/catalogs.sgml,v 2.36 2002/03/22 19:20:03 petere Exp $
--> -->
<chapter id="catalogs"> <chapter id="catalogs">
@ -222,7 +222,7 @@
<entry>aggbasetype</entry> <entry>aggbasetype</entry>
<entry><type>oid</type></entry> <entry><type>oid</type></entry>
<entry>pg_type.oid</entry> <entry>pg_type.oid</entry>
<entry>The input datatype for this aggregate function</entry> <entry>The input data type for this aggregate function</entry>
</row> </row>
<row> <row>
<entry>aggtranstype</entry> <entry>aggtranstype</entry>
@ -386,8 +386,8 @@
of statistics accumulated for this column by of statistics accumulated for this column by
<command>ANALYZE</command>. <command>ANALYZE</command>.
A zero value indicates that no statistics should be collected. A zero value indicates that no statistics should be collected.
The exact meaning of positive values is datatype-dependent. The exact meaning of positive values is data type-dependent.
For scalar datatypes, <structfield>attstattarget</structfield> For scalar data types, <structfield>attstattarget</structfield>
is both the target number of <quote>most common values</quote> is both the target number of <quote>most common values</quote>
to collect, and the target number of histogram bins to create. to collect, and the target number of histogram bins to create.
</entry> </entry>
@ -533,7 +533,7 @@
<title>pg_class</title> <title>pg_class</title>
<para> <para>
<structname>pg_class</structname> catalogues tables and mostly <structname>pg_class</structname> catalogs tables and mostly
everything else that has columns or is otherwise similar to a everything else that has columns or is otherwise similar to a
table. This includes indexes (but see also table. This includes indexes (but see also
<structname>pg_index</structname>), sequences, views, and some <structname>pg_index</structname>), sequences, views, and some
@ -584,7 +584,7 @@
<entry>relam</entry> <entry>relam</entry>
<entry><type>oid</type></entry> <entry><type>oid</type></entry>
<entry>pg_am.oid</entry> <entry>pg_am.oid</entry>
<entry>If this is an index, the access method used (btree, hash, etc.)</entry> <entry>If this is an index, the access method used (B-tree, hash, etc.)</entry>
</row> </row>
<row> <row>
@ -624,7 +624,7 @@
<entry><type>oid</type></entry> <entry><type>oid</type></entry>
<entry>pg_class.oid</entry> <entry>pg_class.oid</entry>
<entry> <entry>
Oid of the TOAST table associated with this table, 0 if none. OID of the TOAST table associated with this table, 0 if none.
The TOAST table stores large attributes <quote>out of The TOAST table stores large attributes <quote>out of
line</quote> in a secondary table. line</quote> in a secondary table.
</entry> </entry>
@ -909,7 +909,7 @@
The pg_description table can store an optional description or The pg_description table can store an optional description or
comment for each database object. Descriptions can be manipulated comment for each database object. Descriptions can be manipulated
with the <command>COMMENT</command> command. Client applications with the <command>COMMENT</command> command. Client applications
can view the descriptions by joining with this table. Many builtin can view the descriptions by joining with this table. Many built-in
system objects have comments associated with them that are shown by system objects have comments associated with them that are shown by
<application>psql</application>'s <literal>\d</literal> commands. <application>psql</application>'s <literal>\d</literal> commands.
</para> </para>
@ -1648,7 +1648,7 @@
<entry><type>bool</type></entry> <entry><type>bool</type></entry>
<entry></entry> <entry></entry>
<entry>Function returns a set (ie, multiple values of the specified <entry>Function returns a set (ie, multiple values of the specified
datatype)</entry> data type)</entry>
</row> </row>
<row> <row>
@ -2128,7 +2128,7 @@
<entry></entry> <entry></entry>
<entry>Column data values of the appropriate kind for the Nth <entry>Column data values of the appropriate kind for the Nth
<quote>slot</quote>, or NULL if the slot kind does not store any data values. <quote>slot</quote>, or NULL if the slot kind does not store any data values.
For datatype independence, all column data values are converted For data-type independence, all column data values are converted
to external textual form and stored as TEXT datums. to external textual form and stored as TEXT datums.
</entry> </entry>
</row> </row>
@ -2271,7 +2271,7 @@
<title>pg_type</title> <title>pg_type</title>
<para> <para>
This catalog stores information about datatypes. Scalar types This catalog stores information about data types. Scalar types
(<quote>base types</>) are created with <command>CREATE TYPE</command>. (<quote>base types</>) are created with <command>CREATE TYPE</command>.
A complex type is also created for each table in the database, to A complex type is also created for each table in the database, to
represent the row structure of the table. It is also possible to create represent the row structure of the table. It is also possible to create
@ -2369,7 +2369,7 @@
<entry></entry> <entry></entry>
<entry>Character that separates two values of this type when parsing <entry>Character that separates two values of this type when parsing
array input. Note that the delimiter is associated with the array array input. Note that the delimiter is associated with the array
element datatype, not the array datatype.</entry> element data type, not the array data type.</entry>
</row> </row>
<row> <row>
@ -2402,7 +2402,7 @@
<type>name</type> and <type>oidvector</type>. <type>name</type> and <type>oidvector</type>.
If a fixed-length type has a <structfield>typelem</structfield> then If a fixed-length type has a <structfield>typelem</structfield> then
its internal representation must be N values of the its internal representation must be N values of the
<structfield>typelem</structfield> datatype with no other data. <structfield>typelem</structfield> data type with no other data.
Variable-length array types have a header defined by the array Variable-length array types have a header defined by the array
subroutines. subroutines.
</entry> </entry>

4
doc/src/sgml/charset.sgml
View File

@ -1,4 +1,4 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/charset.sgml,v 2.22 2002/03/05 05:52:42 momjian Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/charset.sgml,v 2.23 2002/03/22 19:20:05 petere Exp $ -->
<chapter id="charset"> <chapter id="charset">
<title>Localization</> <title>Localization</>
@ -178,7 +178,7 @@ export LANG=sv_SE
by recording the values of <envar>LC_COLLATE</> and <envar>LC_CTYPE</> by recording the values of <envar>LC_COLLATE</> and <envar>LC_CTYPE</>
that are seen by <application>initdb</>. The server automatically adopts that are seen by <application>initdb</>. The server automatically adopts
those two values when it is started; only the other <envar>LC_</> those two values when it is started; only the other <envar>LC_</>
categories can be set from the environment at server startup. categories can be set from the environment at server start-up.
In short, only one collation order can be used in a database cluster, In short, only one collation order can be used in a database cluster,
and it is chosen at <application>initdb</> time. and it is chosen at <application>initdb</> time.
</para> </para>

6
doc/src/sgml/client-auth.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/client-auth.sgml,v 1.32 2002/01/20 22:19:55 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/client-auth.sgml,v 1.33 2002/03/22 19:20:06 petere Exp $
--> -->
<chapter id="client-authentication"> <chapter id="client-authentication">
@ -366,7 +366,7 @@ hostssl <replaceable>database</replaceable> <replaceable>IP-address</replaceable
<indexterm> <indexterm>
<primary>SIGHUP</primary> <primary>SIGHUP</primary>
</indexterm> </indexterm>
The <filename>pg_hba.conf</filename> file is read on startup The <filename>pg_hba.conf</filename> file is read on start-up
and when the <application>postmaster</> receives a and when the <application>postmaster</> receives a
<systemitem>SIGHUP</systemitem> signal. If you edit the file on an <systemitem>SIGHUP</systemitem> signal. If you edit the file on an
active system, you will need to signal the <application>postmaster</> active system, you will need to signal the <application>postmaster</>
@ -750,7 +750,7 @@ local all md5 admins
<indexterm> <indexterm>
<primary>SIGHUP</primary> <primary>SIGHUP</primary>
</indexterm> </indexterm>
The <filename>pg_ident.conf</filename> file is read on startup The <filename>pg_ident.conf</filename> file is read on start-up
and when the <application>postmaster</> receives a and when the <application>postmaster</> receives a
<systemitem>SIGHUP</systemitem> signal. If you edit the file on an <systemitem>SIGHUP</systemitem> signal. If you edit the file on an
active system, you will need to signal the <application>postmaster</> active system, you will need to signal the <application>postmaster</>

38
doc/src/sgml/datatype.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.85 2002/03/05 06:14:45 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.86 2002/03/22 19:20:07 petere Exp $
--> -->
<chapter id="datatype"> <chapter id="datatype">
@ -1522,31 +1522,31 @@ SELECT b, char_length(b) FROM test2;
</thead> </thead>
<tbody> <tbody>
<row> <row>
<entry>04:05:06.789</entry> <entry><literal>04:05:06.789</literal></entry>
<entry>ISO 8601</entry> <entry>ISO 8601</entry>
</row> </row>
<row> <row>
<entry>04:05:06</entry> <entry><literal>04:05:06</literal></entry>
<entry>ISO 8601</entry> <entry>ISO 8601</entry>
</row> </row>
<row> <row>
<entry>04:05</entry> <entry><literal>04:05</literal></entry>
<entry>ISO 8601</entry> <entry>ISO 8601</entry>
</row> </row>
<row> <row>
<entry>040506</entry> <entry><literal>040506</literal></entry>
<entry>ISO 8601</entry> <entry>ISO 8601</entry>
</row> </row>
<row> <row>
<entry>04:05 AM</entry> <entry><literal>04:05 AM</literal></entry>
<entry>Same as 04:05; AM does not affect value</entry> <entry>Same as 04:05; AM does not affect value</entry>
</row> </row>
<row> <row>
<entry>04:05 PM</entry> <entry><literal>04:05 PM</literal></entry>
<entry>Same as 16:05; input hour must be <= 12</entry> <entry>Same as 16:05; input hour must be <= 12</entry>
</row> </row>
<row> <row>
<entry>allballs</entry> <entry><literal>allballs</literal></entry>
<entry>Same as 00:00:00</entry> <entry>Same as 00:00:00</entry>
</row> </row>
</tbody> </tbody>
@ -1811,39 +1811,39 @@ January 8 04:05:06 1999 PST
</thead> </thead>
<tbody> <tbody>
<row> <row>
<entry>epoch</entry> <entry><literal>epoch</literal></entry>
<entry>1970-01-01 00:00:00+00 (Unix system time zero)</entry> <entry>1970-01-01 00:00:00+00 (Unix system time zero)</entry>
</row> </row>
<row> <row>
<entry>infinity</entry> <entry><literal>infinity</literal></entry>
<entry>Later than other valid times</entry> <entry>Later than other valid times</entry>
</row> </row>
<row> <row>
<entry>-infinity</entry> <entry><literal>-infinity</literal></entry>
<entry>Earlier than other valid times</entry> <entry>Earlier than other valid times</entry>
</row> </row>
<row> <row>
<entry>invalid</entry> <entry><literal>invalid</literal></entry>
<entry>Illegal entry</entry> <entry>Illegal entry</entry>
</row> </row>
<row> <row>
<entry>now</entry> <entry><literal>now</literal></entry>
<entry>Current transaction time</entry> <entry>Current transaction time</entry>
</row> </row>
<row> <row>
<entry>today</entry> <entry><literal>today</literal></entry>
<entry>Midnight today</entry> <entry>Midnight today</entry>
</row> </row>
<row> <row>
<entry>tomorrow</entry> <entry><literal>tomorrow</literal></entry>
<entry>Midnight tomorrow</entry> <entry>Midnight tomorrow</entry>
</row> </row>
<row> <row>
<entry>yesterday</entry> <entry><literal>yesterday</literal></entry>
<entry>Midnight yesterday</entry> <entry>Midnight yesterday</entry>
</row> </row>
<row> <row>
<entry>zulu, allballs, z</entry> <entry><literal>zulu</>, <literal>allballs</>, <literal>z</></entry>
<entry>00:00:00.00 GMT</entry> <entry>00:00:00.00 GMT</entry>
</row> </row>
</tbody> </tbody>
@ -2083,7 +2083,7 @@ January 8 04:05:06 1999 PST
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
The <envar>PGTZ</envar> environment variable, if set at the client, is used by libpq The <envar>PGTZ</envar> environment variable, if set at the client, is used by <application>libpq</application>
to send a <command>SET TIME ZONE</command> command to the backend upon to send a <command>SET TIME ZONE</command> command to the backend upon
connection. connection.
</para> </para>
@ -2117,7 +2117,7 @@ January 8 04:05:06 1999 PST
<note> <note>
<para> <para>
If the runtime option <literal>AUSTRALIAN_TIMEZONES</literal> is set If the run-time option <literal>AUSTRALIAN_TIMEZONES</literal> is set
then <literal>CST</literal> and <literal>EST</literal> refer to then <literal>CST</literal> and <literal>EST</literal> refer to
Australian time zones, not American ones. Australian time zones, not American ones.
</para> </para>

20
doc/src/sgml/datetime.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/datetime.sgml,v 2.26 2002/01/20 22:19:55 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/datetime.sgml,v 2.27 2002/03/22 19:20:07 petere Exp $
Date/time details Date/time details
--> -->
@ -150,31 +150,31 @@ Date/time details
</thead> </thead>
<tbody> <tbody>
<row> <row>
<entry>ABSTIME</entry> <entry><literal>ABSTIME</literal></entry>
<entry>Keyword ignored</entry> <entry>Keyword ignored</entry>
</row> </row>
<row> <row>
<entry>AM</entry> <entry><literal>AM</literal></entry>
<entry>Time is before 12:00</entry> <entry>Time is before 12:00</entry>
</row> </row>
<row> <row>
<entry>AT</entry> <entry><literal>AT</literal></entry>
<entry>Keyword ignored</entry> <entry>Keyword ignored</entry>
</row> </row>
<row> <row>
<entry>JULIAN, JD, J</entry> <entry><literal>JULIAN</>, <literal>JD</>, <literal>J</></entry>
<entry>Next field is Julian Day</entry> <entry>Next field is Julian Day</entry>
</row> </row>
<row> <row>
<entry>ON</entry> <entry><literal>ON</literal></entry>
<entry>Keyword ignored</entry> <entry>Keyword ignored</entry>
</row> </row>
<row> <row>
<entry>PM</entry> <entry><literal>PM</literal></entry>
<entry>Time is on or after after 12:00</entry> <entry>Time is on or after after 12:00</entry>
</row> </row>
<row> <row>
<entry>T</entry> <entry><literal>T</literal></entry>
<entry>Next field is time</entry> <entry>Next field is time</entry>
</row> </row>
</tbody> </tbody>
@ -186,7 +186,7 @@ Date/time details
The keyword <literal>ABSTIME</literal> is ignored for historical The keyword <literal>ABSTIME</literal> is ignored for historical
reasons; in very old releases of reasons; in very old releases of
<productname>PostgreSQL</productname> invalid <type>ABSTIME</type> <productname>PostgreSQL</productname> invalid <type>ABSTIME</type>
fields were emitted as <quote>Invalid Abstime</quote>. This is no fields were emitted as <literal>Invalid Abstime</literal>. This is no
longer the case however and this keyword will likely be dropped in longer the case however and this keyword will likely be dropped in
a future release. a future release.
</para> </para>
@ -753,7 +753,7 @@ Date/time details
</para> </para>
<para> <para>
If the runtime option <literal>AUSTRALIAN_TIMEZONES</literal> is set If the run-time option <literal>AUSTRALIAN_TIMEZONES</literal> is set
then <literal>CST</literal>, <literal>EST</literal>, and then <literal>CST</literal>, <literal>EST</literal>, and
<literal>SAT</literal> will be <literal>SAT</literal> will be
interpreted as Australian timezone names. Without this option, interpreted as Australian timezone names. Without this option,

26
doc/src/sgml/docguide.sgml
View File

@ -1,4 +1,4 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v 1.40 2002/01/20 22:19:55 petere Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v 1.41 2002/03/22 19:20:08 petere Exp $ -->
<appendix id="docguide"> <appendix id="docguide">
<title>Documentation</title> <title>Documentation</title>
@ -116,7 +116,7 @@
<sect1 id="doc-toolsets"> <sect1 id="doc-toolsets">
<title>Toolsets</title> <title>Tool Sets</title>
<para> <para>
The following tools are used to process the documentation. Some The following tools are used to process the documentation. Some
@ -304,7 +304,7 @@ apt-get install docbook-stylesheets
<para> <para>
The manual installation process of the DocBook tools is somewhat The manual installation process of the DocBook tools is somewhat
complex, so if you have pre-built packages available, use them. complex, so if you have pre-built packages available, use them.
We describe here only a standard setup, with reasonabley standard We describe here only a standard setup, with reasonably standard
installation paths, and no <quote>fancy</quote> features. For installation paths, and no <quote>fancy</quote> features. For
details, you should study the documentation of the respective details, you should study the documentation of the respective
package, and read <acronym>SGML</acronym> introductory material. package, and read <acronym>SGML</acronym> introductory material.
@ -682,7 +682,7 @@ gmake man
<para> <para>
The hardcopy Postscript documentation is generated by converting the The hardcopy Postscript documentation is generated by converting the
<acronym>SGML</acronym> source code to <acronym>RTF</acronym>, then <acronym>SGML</acronym> source code to <acronym>RTF</acronym>, then
importing into <productname>ApplixWare</productname>. importing into <productname>Applixware</productname>.
After a little cleanup (see the following After a little cleanup (see the following
section) the output is <quote>printed</quote> to a postscript file. section) the output is <quote>printed</quote> to a postscript file.
</para> </para>
@ -710,14 +710,14 @@ gmake man
</para> </para>
<procedure> <procedure>
<title>Applixware <acronym>RTF</acronym> Cleanup</title> <title><productname>Applixware</productname> <acronym>RTF</acronym> Cleanup</title>
<para> <para>
<application>jade</application>, an integral part of the <application>jade</application>, an integral part of the
hardcopy procedure, omits specifying a default style for body hardcopy procedure, omits specifying a default style for body
text. In the past, this undiagnosed problem led to a long process text. In the past, this undiagnosed problem led to a long process
of Table of Contents (ToC) generation. However, with great help of Table of Contents (ToC) generation. However, with great help
from the ApplixWare folks the symptom was diagnosed and a from the <productname>Applixware</productname> folks the symptom was diagnosed and a
workaround is available. workaround is available.
</para> </para>
@ -759,7 +759,7 @@ gmake man
<para> <para>
The script adds <literal>{\s0 Normal;}</literal> as The script adds <literal>{\s0 Normal;}</literal> as
the zero-th style in the document. According to ApplixWare, the the zero-th style in the document. According to <productname>Applixware</productname>, the
RTF standard would prohibit adding an implicit zero-th style, RTF standard would prohibit adding an implicit zero-th style,
though M$Word happens to handle this case. For repairing though M$Word happens to handle this case. For repairing
<sgmltag>REFENTRY</sgmltag> sections, the script replaces <sgmltag>REFENTRY</sgmltag> sections, the script replaces
@ -769,14 +769,14 @@ gmake man
<step performance="required"> <step performance="required">
<para> <para>
Open a new document in <productname>Applix Words</productname> and Open a new document in <productname>Applixware Words</productname> and
then import the <acronym>RTF</acronym> file. then import the <acronym>RTF</acronym> file.
</para> </para>
</step> </step>
<step performance="required"> <step performance="required">
<para> <para>
Generate a new ToC using ApplixWare. Generate a new ToC using <productname>Applixware</productname>.
</para> </para>
<substeps> <substeps>
@ -795,7 +795,7 @@ gmake man
first three levels of headers for inclusion in the ToC. first three levels of headers for inclusion in the ToC.
This will This will
replace the existing lines imported in the RTF with a native replace the existing lines imported in the RTF with a native
ApplixWare ToC. <productname>Applixware</productname> ToC.
</para> </para>
</step> </step>
@ -887,7 +887,7 @@ gmake man
<listitem> <listitem>
<para> <para>
Insert figures into the document. Center each figure on the page using Insert figures into the document. Center each figure on the page using
the centering margins button on the ApplixWare toolbar. the centering margins button on the <productname>Applixware</productname> toolbar.
<note> <note>
<para> <para>
@ -969,7 +969,7 @@ Later stylesheets seem to not need this adjustment - thomas 2001-11-29
<step performance="required"> <step performance="required">
<para> <para>
Save the document as native Applix Words format to allow easier last Save the document as native <productname>Applixware Words</productname> format to allow easier last
minute editing later. minute editing later.
</para> </para>
</step> </step>
@ -1110,7 +1110,7 @@ Later stylesheets seem to not need this adjustment - thomas 2001-11-29
<para> <para>
<acronym>SGML</acronym> and <productname>DocBook</productname> do <acronym>SGML</acronym> and <productname>DocBook</productname> do
not suffer from an oversupply of open-source authoring tools. The not suffer from an oversupply of open-source authoring tools. The
most common toolset is the most common tool set is the
<productname>Emacs</productname>/<productname>XEmacs</productname> <productname>Emacs</productname>/<productname>XEmacs</productname>
editor with appropriate editing mode. On some systems editor with appropriate editing mode. On some systems
these tools are provided in a typical full installation. these tools are provided in a typical full installation.

8
doc/src/sgml/func.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.93 2002/01/30 21:55:33 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.94 2002/03/22 19:20:09 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -3592,13 +3592,13 @@ SELECT TIMESTAMP 'now';
<row> <row>
<entry><function>lseg</function>(<type>box</type>)</entry> <entry><function>lseg</function>(<type>box</type>)</entry>
<entry><type>lseg</type></entry> <entry><type>lseg</type></entry>
<entry>box diagonal to lseg</entry> <entry>box diagonal to <type>lseg</type></entry>
<entry><literal>lseg(box '((-1,0),(1,0))')</literal></entry> <entry><literal>lseg(box '((-1,0),(1,0))')</literal></entry>
</row> </row>
<row> <row>
<entry><function>lseg</function>(<type>point</type>, <type>point</type>)</entry> <entry><function>lseg</function>(<type>point</type>, <type>point</type>)</entry>
<entry><type>lseg</type></entry> <entry><type>lseg</type></entry>
<entry>points to lseg</entry> <entry>points to <type>lseg</type></entry>
<entry><literal>lseg(point '(-1,0)', point '(1,0)')</literal></entry> <entry><literal>lseg(point '(-1,0)', point '(1,0)')</literal></entry>
</row> </row>
<row> <row>
@ -3773,7 +3773,7 @@ SELECT TIMESTAMP 'now';
<row> <row>
<entry><function>set_masklen</function>(<type>inet</type>,<type>integer</type>)</entry> <entry><function>set_masklen</function>(<type>inet</type>,<type>integer</type>)</entry>
<entry><type>inet</type></entry> <entry><type>inet</type></entry>
<entry>set netmask length for inet value</entry> <entry>set netmask length for <type>inet</type> value</entry>
<entry><literal>set_masklen('192.168.1.5/24',16)</literal></entry> <entry><literal>set_masklen('192.168.1.5/24',16)</literal></entry>
<entry><literal>192.168.1.5/16</literal></entry> <entry><literal>192.168.1.5/16</literal></entry>
</row> </row>

4
doc/src/sgml/indexcost.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/indexcost.sgml,v 2.10 2001/11/21 05:53:41 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/indexcost.sgml,v 2.11 2002/03/22 19:20:10 petere Exp $
--> -->
<chapter id="indexcost"> <chapter id="indexcost">
@ -201,7 +201,7 @@ amcostestimate (Query *root,
<para> <para>
Estimate and return the fraction of main-table tuples that will be visited Estimate and return the fraction of main-table tuples that will be visited
based on the given qual conditions. In the absence of any index-type-specific based on the given qual conditions. In the absence of any index-type-specific
knowledge, use the standard optimizer function clauselist_selectivity(): knowledge, use the standard optimizer function <function>clauselist_selectivity()</function>:
<programlisting> <programlisting>
*indexSelectivity = clauselist_selectivity(root, indexQuals, *indexSelectivity = clauselist_selectivity(root, indexQuals,

6
doc/src/sgml/jdbc.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/jdbc.sgml,v 1.35 2002/01/20 22:19:56 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/jdbc.sgml,v 1.36 2002/03/22 19:20:11 petere Exp $
--> -->
<chapter id="jdbc"> <chapter id="jdbc">
@ -1210,7 +1210,7 @@ public void addFunctions(ResultSet rs) throws SQLException
</para> </para>
<para> <para>
Do not think that manually converting them to the oid's will Do not think that manually converting them to the OIDs will
work. OK, they will for now, but they can change during work. OK, they will for now, but they can change during
development (there was some discussion about this for V7.0), development (there was some discussion about this for V7.0),
so this is implemented to prevent any unwarranted headaches so this is implemented to prevent any unwarranted headaches
@ -2505,7 +2505,7 @@ public void unlink(int oid) throws SQLException
<sect1 id="jdbc-thread"> <sect1 id="jdbc-thread">
<title>Using the driver in a multi-threaded or a servlet environment</title> <title>Using the driver in a multithreaded or a servlet environment</title>
<para> <para>
A problem with many <acronym>JDBC</acronym> drivers is that only A problem with many <acronym>JDBC</acronym> drivers is that only

4
doc/src/sgml/libpgtcl.sgml
View File

@ -1173,7 +1173,7 @@ pg_lo_creat <REPLACEABLE CLASS="PARAMETER">conn</REPLACEABLE> <REPLACEABLE CLASS
</TERM> </TERM>
<LISTITEM> <LISTITEM>
<PARA> <PARA>
The oid of the large object created. The OID of the large object created.
</PARA> </PARA>
</LISTITEM> </LISTITEM>
</VARLISTENTRY> </VARLISTENTRY>
@ -1247,7 +1247,7 @@ pg_lo_open <REPLACEABLE CLASS="PARAMETER">conn</REPLACEABLE> <REPLACEABLE CLASS=
<REPLACEABLE CLASS="PARAMETER">objOid</REPLACEABLE> <REPLACEABLE CLASS="PARAMETER">objOid</REPLACEABLE>
</TERM> </TERM>
<LISTITEM> <LISTITEM>
<PARA>Specifies a valid large object oid. <PARA>Specifies a valid large object OID.
</PARA> </PARA>
</LISTITEM> </LISTITEM>
</VARLISTENTRY> </VARLISTENTRY>

4
doc/src/sgml/libpq++.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/libpq++.sgml,v 1.40 2002/01/07 02:29:12 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/libpq++.sgml,v 1.41 2002/03/22 19:20:12 petere Exp $
--> -->
<chapter id="libpqplusplus"> <chapter id="libpqplusplus">
@ -139,7 +139,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/libpq++.sgml,v 1.40 2002/01/07 02:29:
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<envar>PGOPTIONS</envar> sets additional runtime options for <envar>PGOPTIONS</envar> sets additional run-time options for
the <productname>PostgreSQL</productname> backend. the <productname>PostgreSQL</productname> backend.
</para> </para>
</listitem> </listitem>

4
doc/src/sgml/libpq.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.89 2002/03/11 05:03:51 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.90 2002/03/22 19:20:13 petere Exp $
--> -->
<chapter id="libpq"> <chapter id="libpq">
@ -2056,7 +2056,7 @@ used if Kerberos authentication is selected by the backend.
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<envar>PGOPTIONS</envar> sets additional runtime options for <envar>PGOPTIONS</envar> sets additional run-time options for
the <productname>PostgreSQL</productname> backend. the <productname>PostgreSQL</productname> backend.
</para> </para>
</listitem> </listitem>

4
doc/src/sgml/monitoring.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/monitoring.sgml,v 1.6 2001/11/29 20:43:43 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/monitoring.sgml,v 1.7 2002/03/22 19:20:14 petere Exp $
--> -->
<chapter id="monitoring"> <chapter id="monitoring">
@ -132,7 +132,7 @@ postgres: <replaceable>user</> <replaceable>database</> <replaceable>host</> <re
The variables <varname>STATS_COMMAND_STRING</varname>, The variables <varname>STATS_COMMAND_STRING</varname>,
<varname>STATS_BLOCK_LEVEL</varname>, <varname>STATS_BLOCK_LEVEL</varname>,
and <varname>STATS_ROW_LEVEL</varname> control how much information is and <varname>STATS_ROW_LEVEL</varname> control how much information is
actually sent to the collector, and thus determine how much runtime actually sent to the collector, and thus determine how much run-time
overhead occurs. These respectively determine whether a server process overhead occurs. These respectively determine whether a server process
sends its current command string, disk-block-level access statistics, and sends its current command string, disk-block-level access statistics, and
row-level access statistics to the collector. Normally these variables are row-level access statistics to the collector. Normally these variables are

8
doc/src/sgml/nls.sgml
View File

@ -1,4 +1,4 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/nls.sgml,v 1.3 2002/01/20 22:19:56 petere Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/nls.sgml,v 1.4 2002/03/22 19:20:15 petere Exp $ -->
<chapter id="nls"> <chapter id="nls">
<docinfo> <docinfo>
@ -141,7 +141,7 @@ msgstr "another translated"
<title>Creating and maintaining message catalogs</title> <title>Creating and maintaining message catalogs</title>
<para> <para>
Okay, so how does one create a <quote>blank</quote> message OK, so how does one create a <quote>blank</quote> message
catalog? First, go into the directory that contains the program catalog? First, go into the directory that contains the program
whose messages you want to translate. If there is a file whose messages you want to translate. If there is a file
<filename>nls.mk</filename>, then this program has been prepared <filename>nls.mk</filename>, then this program has been prepared
@ -312,7 +312,7 @@ msgstr "Die Datei %2$s hat %1$u Zeichen."
<step> <step>
<para> <para>
Insert this code into the startup sequence of the program: Insert this code into the start-up sequence of the program:
<programlisting> <programlisting>
#ifdef ENABLE_NLS #ifdef ENABLE_NLS
#include &lt;locale.h&gt; #include &lt;locale.h&gt;
@ -473,7 +473,7 @@ printf("number of copied files: %d", n);
<para> <para>
If you want to communicate something to the translator, such as If you want to communicate something to the translator, such as
about how a message is intended to line up with other output, about how a message is intended to line up with other output,
precede the occurrance of the string with a comment that starts precede the occurrence of the string with a comment that starts
with <literal>translator</literal>, e.g., with <literal>translator</literal>, e.g.,
<programlisting> <programlisting>
/* translator: This message is not what it seems to be. */ /* translator: This message is not what it seems to be. */

32
doc/src/sgml/odbc.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/odbc.sgml,v 1.29 2002/01/07 02:29:12 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/odbc.sgml,v 1.30 2002/03/22 19:20:16 petere Exp $
--> -->
<chapter id="odbc"> <chapter id="odbc">
@ -328,14 +328,14 @@ InstallDir = /opt/applix/axdata/axshlib
<title><application>ApplixWare</application></title> <title><application>ApplixWare</application></title>
<indexterm zone="odbc-applixware"> <indexterm zone="odbc-applixware">
<primary>ApplixWare</primary> <primary>Applixware</primary>
</indexterm> </indexterm>
<para> <para>
<productname>ApplixWare</productname> has an <productname>Applixware</productname> has an
<acronym>ODBC</acronym> database interface <acronym>ODBC</acronym> database interface
supported on at least some platforms. supported on at least some platforms.
<productname>ApplixWare</productname> 4.4.2 has been <productname>Applixware</productname> 4.4.2 has been
demonstrated under Linux with <productname>PostgreSQL</productname> 7.0 demonstrated under Linux with <productname>PostgreSQL</productname> 7.0
using the <productname>psqlODBC</productname> using the <productname>psqlODBC</productname>
driver contained in the <productname>PostgreSQL</productname> distribution. driver contained in the <productname>PostgreSQL</productname> distribution.
@ -345,18 +345,18 @@ InstallDir = /opt/applix/axdata/axshlib
<title>Configuration</title> <title>Configuration</title>
<para> <para>
<productname>ApplixWare</productname> must be configured correctly <productname>Applixware</productname> must be configured correctly
in order for it to in order for it to
be able to access the <productname>PostgreSQL</productname> be able to access the <productname>PostgreSQL</productname>
<acronym>ODBC</acronym> software drivers. <acronym>ODBC</acronym> software drivers.
</para> </para>
<procedure> <procedure>
<title>Enabling <application>ApplixWare</application> Database Access</title> <title>Enabling <application>Applixware</application> Database Access</title>
<para> <para>
These instructions are for the 4.4.2 release of These instructions are for the 4.4.2 release of
<productname>ApplixWare</productname> on <productname>Linux</productname>. <productname>Applixware</productname> on <productname>Linux</productname>.
Refer to the <citetitle>Linux Sys Admin</citetitle> on-line book Refer to the <citetitle>Linux Sys Admin</citetitle> on-line book
for more detailed information. for more detailed information.
</para> </para>
@ -367,7 +367,7 @@ InstallDir = /opt/applix/axdata/axshlib
<filename>elfodbc</filename> can <filename>elfodbc</filename> can
find <filename>libodbc.so</filename> find <filename>libodbc.so</filename>
(the <acronym>ODBC</acronym> driver manager) shared library. (the <acronym>ODBC</acronym> driver manager) shared library.
This library is included with the <application>ApplixWare</application> distribution, This library is included with the <application>Applixware</application> distribution,
but <filename>axnet.cnf</filename> needs to be modified to point to the but <filename>axnet.cnf</filename> needs to be modified to point to the
correct location. correct location.
</para> </para>
@ -425,7 +425,7 @@ TextAsLongVarchar=0
</procedure> </procedure>
<procedure> <procedure>
<title>Testing <application>ApplixWare</application> ODBC Connections</title> <title>Testing <application>Applixware</application> ODBC Connections</title>
<step performance="required"> <step performance="required">
<para> <para>
@ -550,7 +550,7 @@ TextAsLongVarchar=0
<listitem> <listitem>
<para> <para>
The September release of <application>ApplixWare</application> 4.4.1 (the first release with official The September release of <application>Applixware</application> 4.4.1 (the first release with official
<acronym>ODBC</acronym> support under Linux) shows problems when user names <acronym>ODBC</acronym> support under Linux) shows problems when user names
exceed eight (8) characters in length. exceed eight (8) characters in length.
Problem description contributed by Steve Campbell Problem description contributed by Steve Campbell
@ -583,7 +583,7 @@ TextAsLongVarchar=0
</sect2> </sect2>
<sect2> <sect2>
<title>Debugging <application>ApplixWare</application> ODBC Connections</title> <title>Debugging <application>Applixware</application> ODBC Connections</title>
<para> <para>
One good tool for debugging connection problems uses the Unix system One good tool for debugging connection problems uses the Unix system
@ -594,7 +594,7 @@ TextAsLongVarchar=0
<step performance="required"> <step performance="required">
<para> <para>
Start <application>ApplixWare</application>. Start <application>Applixware</application>.
</para> </para>
</step> </step>
<step performance="required"> <step performance="required">
@ -631,7 +631,7 @@ cary 27883 0.9 31.0 12692 4596 ? S 10:24 0:04 axmain
<title>Note from Cary</title> <title>Note from Cary</title>
<para> <para>
Many of the error messages from <productname>ApplixWare</productname> Many of the error messages from <productname>Applixware</productname>
go to <filename>stderr</filename>, go to <filename>stderr</filename>,
but I'm not sure where <filename>stderr</filename> but I'm not sure where <filename>stderr</filename>
is sent, so <command>strace</command> is the way to find out. is sent, so <command>strace</command> is the way to find out.
@ -656,13 +656,13 @@ cary 27883 0.9 31.0 12692 4596 ? S 10:24 0:04 axmain
</sect2> </sect2>
<sect2> <sect2>
<title>Running the <application>ApplixWare</application> Demo</title> <title>Running the <application>Applixware</application> Demo</title>
<comment>I think the condition this refers to is gone. -- petere 2002-01-07</comment> <comment>I think the condition this refers to is gone. -- petere 2002-01-07</comment>
<para> <para>
In order to go through the In order to go through the
<citetitle>ApplixWare Data Tutorial</citetitle>, you need to create <citetitle>Applixware Data Tutorial</citetitle>, you need to create
the sample tables that the Tutorial refers to. The ELF Macro used to the sample tables that the Tutorial refers to. The ELF Macro used to
create the tables tries to use a NULL condition create the tables tries to use a NULL condition
on many of the database columns, on many of the database columns,
@ -674,7 +674,7 @@ cary 27883 0.9 31.0 12692 4596 ? S 10:24 0:04 axmain
</para> </para>
<procedure> <procedure>
<title>Modifying the <application>ApplixWare</application> Demo</title> <title>Modifying the <application>Applixware</application> Demo</title>
<step performance="required"> <step performance="required">
<para> <para>

12
doc/src/sgml/perform.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/perform.sgml,v 1.17 2002/03/06 06:44:31 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/perform.sgml,v 1.18 2002/03/22 19:20:17 petere Exp $
--> -->
<chapter id="performance-tips"> <chapter id="performance-tips">
@ -252,7 +252,7 @@ Hash Join (cost=181.22..564.83 rows=49 width=296)
<para> <para>
It is possible to check on the accuracy of the planner's estimated costs It is possible to check on the accuracy of the planner's estimated costs
by using EXPLAIN ANALYZE. This command actually executes the query, by using EXPLAIN ANALYZE. This command actually executes the query,
and then displays the true runtime accumulated within each plan node and then displays the true run time accumulated within each plan node
along with the same estimated costs that a plain EXPLAIN shows. along with the same estimated costs that a plain EXPLAIN shows.
For example, we might get a result like this: For example, we might get a result like this:
@ -289,12 +289,12 @@ Total runtime: 30.67 msec
</para> </para>
<para> <para>
The <quote>total runtime</quote> shown by EXPLAIN ANALYZE includes The <literal>Total runtime</literal> shown by <command>EXPLAIN ANALYZE</command> includes
executor startup and shutdown time, as well as time spent processing executor start-up and shutdown time, as well as time spent processing
the result tuples. It does not include parsing, rewriting, or planning the result tuples. It does not include parsing, rewriting, or planning
time. For a SELECT query, the total runtime will normally be just a time. For a SELECT query, the total run time will normally be just a
little larger than the total time reported for the top-level plan node. little larger than the total time reported for the top-level plan node.
For INSERT, UPDATE, and DELETE queries, the total runtime may be For INSERT, UPDATE, and DELETE queries, the total run time may be
considerably larger, because it includes the time spent processing the considerably larger, because it includes the time spent processing the
output tuples. In these queries, the time for the top plan node output tuples. In these queries, the time for the top plan node
essentially is the time spent computing the new tuples and/or locating essentially is the time spent computing the new tuples and/or locating

4
doc/src/sgml/plpython.sgml
View File

@ -1,4 +1,4 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/plpython.sgml,v 1.9 2002/03/06 19:05:57 momjian Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/plpython.sgml,v 1.10 2002/03/22 19:20:18 petere Exp $ -->
<chapter id="plpython"> <chapter id="plpython">
<title>PL/Python - Python Procedural Language</title> <title>PL/Python - Python Procedural Language</title>
@ -92,7 +92,7 @@ def __plpython_procedure_myfunc_23456():
return args[0] return args[0]
</programlisting> </programlisting>
where 23456 is the Oid of the function. where 23456 is the OID of the function.
</para> </para>
<para> <para>

46
doc/src/sgml/plsql.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/plsql.sgml,v 2.53 2002/01/07 02:29:13 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/plsql.sgml,v 2.54 2002/03/22 19:20:18 petere Exp $
--> -->
<chapter id="plpgsql"> <chapter id="plpgsql">
@ -392,7 +392,7 @@ url VARCHAR;
The CONSTANT option prevents the variable from being assigned to, The CONSTANT option prevents the variable from being assigned to,
so that its value remains constant for the duration of the block. so that its value remains constant for the duration of the block.
If NOT NULL If NOT NULL
is specified, an assignment of a NULL value results in a runtime is specified, an assignment of a NULL value results in a run-time
error. All variables declared as NOT NULL error. All variables declared as NOT NULL
must have a non-NULL default value specified. must have a non-NULL default value specified.
</para> </para>
@ -453,7 +453,7 @@ END;
</sect2> </sect2>
<sect2 id="plpgsql-declaration-rowtypes"> <sect2 id="plpgsql-declaration-rowtypes">
<title>Rowtypes</title> <title>Row Types</title>
<para> <para>
<synopsis> <synopsis>
@ -463,7 +463,7 @@ END;
<para> <para>
A variable of a composite type is called a <firstterm>row</> A variable of a composite type is called a <firstterm>row</>
variable (or <firstterm>rowtype</> variable). Such a variable can hold a variable (or <firstterm>row-type</> variable). Such a variable can hold a
whole row of a SELECT or FOR whole row of a SELECT or FOR
query result, so long as that query's column set matches the declared query result, so long as that query's column set matches the declared
type of the variable. The individual fields of the row value are type of the variable. The individual fields of the row value are
@ -487,8 +487,8 @@ END;
<para> <para>
Only the user-defined attributes of a table row are accessible in a Only the user-defined attributes of a table row are accessible in a
rowtype variable, not OID or other system attributes (because the row-type variable, not OID or other system attributes (because the
row could be from a view). The fields of the rowtype inherit the row could be from a view). The fields of the row type inherit the
table's field size or precision for data types such as table's field size or precision for data types such as
<type>char(n)</type>. <type>char(n)</type>.
</para> </para>
@ -504,17 +504,17 @@ END;
</para> </para>
<para> <para>
Record variables are similar to rowtype variables, but they have no Record variables are similar to row-type variables, but they have no
predefined structure. They take on the actual row structure of the predefined structure. They take on the actual row structure of the
row they are assigned during a SELECT or FOR command. The substructure row they are assigned during a SELECT or FOR command. The substructure
of a record variable can change each time it is assigned to. of a record variable can change each time it is assigned to.
A consequence of this is that until a record variable is first assigned A consequence of this is that until a record variable is first assigned
to, <emphasis>it has no</> substructure, and any attempt to access a to, <emphasis>it has no</> substructure, and any attempt to access a
field in it will draw a runtime error. field in it will draw a run-time error.
</para> </para>
<para> <para>
Note that <literal>RECORD</> is not a true datatype, only a placeholder. Note that <literal>RECORD</> is not a true data type, only a placeholder.
Thus, for example, one cannot declare a function returning Thus, for example, one cannot declare a function returning
<literal>RECORD</>. <literal>RECORD</>.
</para> </para>
@ -711,7 +711,7 @@ CREATE FUNCTION logfunc2 (TEXT) RETURNS TIMESTAMP AS '
<application>PL/pgSQL</application> interpreter casts this <application>PL/pgSQL</application> interpreter casts this
string to the <type>timestamp</type> type by calling the string to the <type>timestamp</type> type by calling the
<function>text_out()</function> and <function>timestamp_in()</function> <function>text_out()</function> and <function>timestamp_in()</function>
functions for the conversion. So, the computed timestamp is updated functions for the conversion. So, the computed time stamp is updated
on each execution as the programmer expects. on each execution as the programmer expects.
</para> </para>
@ -720,7 +720,7 @@ CREATE FUNCTION logfunc2 (TEXT) RETURNS TIMESTAMP AS '
connection. When fields of a record variable are used in expressions or connection. When fields of a record variable are used in expressions or
statements, the data types of the statements, the data types of the
fields must not change between calls of one and the same expression, fields must not change between calls of one and the same expression,
since the expression will be planned using the datatype that is present since the expression will be planned using the data type that is present
when the expression is first reached. when the expression is first reached.
Keep this in mind when writing trigger procedures that handle events Keep this in mind when writing trigger procedures that handle events
for more than one table. (EXECUTE can be used to get around this for more than one table. (EXECUTE can be used to get around this
@ -766,7 +766,7 @@ CREATE FUNCTION logfunc2 (TEXT) RETURNS TIMESTAMP AS '
converted by the <application>PL/pgSQL</application> interpreter using converted by the <application>PL/pgSQL</application> interpreter using
the result type's output-function and the result type's output-function and
the variable type's input-function. Note that this could potentially the variable type's input-function. Note that this could potentially
result in runtime errors generated by the input function, if the result in run-time errors generated by the input function, if the
string form of the result value is not acceptable to the input function. string form of the result value is not acceptable to the input function.
</para> </para>
@ -784,7 +784,7 @@ tax := subtotal * 0.06;
<para> <para>
The result of a SELECT command yielding multiple columns (but The result of a SELECT command yielding multiple columns (but
only one row) can be assigned to a record variable, rowtype only one row) can be assigned to a record variable, row-type
variable, or list of scalar variables. This is done by: variable, or list of scalar variables. This is done by:
<synopsis> <synopsis>
@ -802,9 +802,9 @@ SELECT INTO <replaceable>target</replaceable> <replaceable>expressions</replacea
<para> <para>
If a row or a variable list is used as target, the selected values If a row or a variable list is used as target, the selected values
must exactly match the structure of the target(s), or a runtime error must exactly match the structure of the target(s), or a run-time error
occurs. When a record variable is the target, it automatically occurs. When a record variable is the target, it automatically
configures itself to the rowtype of the query result columns. configures itself to the row type of the query result columns.
</para> </para>
<para> <para>
@ -908,7 +908,7 @@ PERFORM create_mv(''cs_session_page_requests_mv'',''
<para> <para>
Oftentimes you will want to generate dynamic queries inside Oftentimes you will want to generate dynamic queries inside
your <application>PL/pgSQL</application> functions, that is, your <application>PL/pgSQL</application> functions, that is,
queries that will involve different tables or different datatypes queries that will involve different tables or different data types
each time they are executed. <application>PL/pgSQL</application>'s each time they are executed. <application>PL/pgSQL</application>'s
normal attempts to cache plans for queries will not work in such normal attempts to cache plans for queries will not work in such
scenarios. To handle this sort of problem, the EXECUTE statement scenarios. To handle this sort of problem, the EXECUTE statement
@ -1034,7 +1034,7 @@ GET DIAGNOSTICS <replaceable>variable</replaceable> = <replaceable>item</replace
status items are <varname>ROW_COUNT</>, the number of rows status items are <varname>ROW_COUNT</>, the number of rows
processed by the last <acronym>SQL</acronym> query sent down to processed by the last <acronym>SQL</acronym> query sent down to
the <acronym>SQL</acronym> engine; and <varname>RESULT_OID</>, the <acronym>SQL</acronym> engine; and <varname>RESULT_OID</>,
the Oid of the last row inserted by the most recent the OID of the last row inserted by the most recent
<acronym>SQL</acronym> query. Note that <varname>RESULT_OID</> <acronym>SQL</acronym> query. Note that <varname>RESULT_OID</>
is only useful after an INSERT query. is only useful after an INSERT query.
</para> </para>
@ -1063,14 +1063,14 @@ RETURN <replaceable>expression</replaceable>;
The function terminates and the value of The function terminates and the value of
<replaceable>expression</replaceable> will be returned to the <replaceable>expression</replaceable> will be returned to the
upper executor. upper executor.
The expression's result will be automatically casted into the The expression's result will be automatically cast into the
function's return type as described for assignments. function's return type as described for assignments.
</para> </para>
<para> <para>
The return value of a function cannot be left undefined. If control The return value of a function cannot be left undefined. If control
reaches the end of the top-level block of reaches the end of the top-level block of
the function without hitting a RETURN statement, a runtime error the function without hitting a RETURN statement, a run-time error
will occur. will occur.
</para> </para>
</sect2> </sect2>
@ -1429,7 +1429,7 @@ END LOOP;
two kinds of FOR loops (integer or record-returning) by checking two kinds of FOR loops (integer or record-returning) by checking
whether the target variable mentioned just after FOR has been whether the target variable mentioned just after FOR has been
declared as a record/row variable. If not, it's presumed to be declared as a record/row variable. If not, it's presumed to be
an integer FOR loop. This can cause rather unintuitive error an integer FOR loop. This can cause rather nonintuitive error
messages when the true problem is, say, that one has messages when the true problem is, say, that one has
misspelled the FOR variable name. misspelled the FOR variable name.
</para> </para>
@ -1450,7 +1450,7 @@ END LOOP;
use a cursor internally to avoid memory problems.) A more interesting use a cursor internally to avoid memory problems.) A more interesting
possibility is that a function can return a reference to a cursor possibility is that a function can return a reference to a cursor
that it has set up, allowing the caller to read the rows. This that it has set up, allowing the caller to read the rows. This
provides one way of returning a rowset from a function. provides one way of returning a row set from a function.
</para> </para>
<sect2 id="plpgsql-cursor-declarations"> <sect2 id="plpgsql-cursor-declarations">
@ -1458,7 +1458,7 @@ END LOOP;
<para> <para>
All access to cursors in <application>PL/pgSQL</> goes through All access to cursors in <application>PL/pgSQL</> goes through
cursor variables, which are always of the special datatype cursor variables, which are always of the special data type
<type>refcursor</>. One way to create a cursor variable <type>refcursor</>. One way to create a cursor variable
is just to declare it as a variable of type <type>refcursor</>. is just to declare it as a variable of type <type>refcursor</>.
Another way is to use the cursor declaration syntax, Another way is to use the cursor declaration syntax,
@ -1482,7 +1482,7 @@ DECLARE
curs2 CURSOR FOR SELECT * from tenk1; curs2 CURSOR FOR SELECT * from tenk1;
curs3 CURSOR (key int) IS SELECT * from tenk1 where unique1 = key; curs3 CURSOR (key int) IS SELECT * from tenk1 where unique1 = key;
</programlisting> </programlisting>
All three of these variables have the datatype <type>refcursor</>, All three of these variables have the data type <type>refcursor</>,
but the first may be used with any query, while the second has but the first may be used with any query, while the second has
a fully specified query already <firstterm>bound</> to it, and the last a fully specified query already <firstterm>bound</> to it, and the last
has a parameterized query bound to it. (<literal>key</> will be has a parameterized query bound to it. (<literal>key</> will be

4
doc/src/sgml/pltcl.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/pltcl.sgml,v 2.19 2002/03/06 19:05:58 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/pltcl.sgml,v 2.20 2002/03/22 19:20:21 petere Exp $
--> -->
<chapter id="pltcl"> <chapter id="pltcl">
@ -120,7 +120,7 @@ CREATE FUNCTION tcl_max (integer, integer) RETURNS integer AS '
if the actual value of an argument is NULL, the corresponding if the actual value of an argument is NULL, the corresponding
<literal>$n</literal> variable will be set to an empty string. <literal>$n</literal> variable will be set to an empty string.
To detect whether a particular argument is NULL, use the function To detect whether a particular argument is NULL, use the function
<literal>argisnull</>. For example, suppose that we wanted tcl_max <literal>argisnull</>. For example, suppose that we wanted <function>tcl_max</function>
with one null and one non-null argument to return the non-null with one null and one non-null argument to return the non-null
argument, rather than NULL: argument, rather than NULL:

4
doc/src/sgml/protocol.sgml
View File

@ -1,4 +1,4 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/protocol.sgml,v 1.23 2001/11/22 01:22:10 tgl Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/protocol.sgml,v 1.24 2002/03/22 19:20:21 petere Exp $ -->
<chapter id="protocol"> <chapter id="protocol">
<title>Frontend/Backend Protocol</title> <title>Frontend/Backend Protocol</title>
@ -67,7 +67,7 @@
<para> <para>
Packets are sent as a data stream. The first byte determines what Packets are sent as a data stream. The first byte determines what
should be expected in the rest of the packet. The exceptions are should be expected in the rest of the packet. The exceptions are
packets sent as part of the startup and authentication exchange, packets sent as part of the start-up and authentication exchange,
which comprise a packet length followed by the packet itself. The which comprise a packet length followed by the packet itself. The
difference is historical. difference is historical.
</para> </para>

4
doc/src/sgml/ref/alter_user.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.20 2002/03/01 22:45:07 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.21 2002/03/22 19:20:36 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -189,7 +189,7 @@ ALTER USER <replaceable class="PARAMETER">username</replaceable> RESET <replacea
<para> <para>
Use <xref linkend="SQL-CREATEUSER" endterm="SQL-CREATEUSER-title"> Use <xref linkend="SQL-CREATEUSER" endterm="SQL-CREATEUSER-title">
to add new users, and <xref linkend="SQL-DROPUSER" to add new users, and <xref linkend="SQL-DROPUSER"
endterm="SQL-DROPUSER-title"> to remoe a user. endterm="SQL-DROPUSER-title"> to remove a user.
</para> </para>
<para> <para>

4
doc/src/sgml/ref/copy.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v 1.28 2002/02/12 21:25:34 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v 1.29 2002/03/22 19:20:37 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -279,7 +279,7 @@ ERROR: <replaceable>reason</replaceable>
</para> </para>
<para> <para>
It is recommended that the filename used in <command>COPY</command> It is recommended that the file name used in <command>COPY</command>
always be specified as an absolute path. This is enforced by the backend always be specified as an absolute path. This is enforced by the backend
in the case of <command>COPY TO</command>, but for <command>COPY in the case of <command>COPY TO</command>, but for <command>COPY
FROM</command> you do have the option of reading from a file specified FROM</command> you do have the option of reading from a file specified

4
doc/src/sgml/ref/create_function.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.33 2002/03/01 20:38:12 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.34 2002/03/22 19:20:37 petere Exp $
--> -->
<refentry id="SQL-CREATEFUNCTION"> <refentry id="SQL-CREATEFUNCTION">
@ -332,7 +332,7 @@ CREATE TABLE product (
user-defined type complex, and the internal type point. The user-defined type complex, and the internal type point. The
function is implemented by a dynamically loaded object that was function is implemented by a dynamically loaded object that was
compiled from C source (we illustrate the now-deprecated alternative compiled from C source (we illustrate the now-deprecated alternative
of specifying the exact pathname to the shared object file). of specifying the absolute file name to the shared object file).
For <productname>PostgreSQL</productname> to For <productname>PostgreSQL</productname> to
find a type conversion function automatically, the SQL function has find a type conversion function automatically, the SQL function has
to have the same name as the return type, and so overloading is to have the same name as the return type, and so overloading is

16
doc/src/sgml/ref/create_index.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_index.sgml,v 1.26 2002/01/20 22:19:56 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_index.sgml,v 1.27 2002/03/22 19:20:38 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -82,7 +82,7 @@ CREATE [ UNIQUE ] INDEX <replaceable class="parameter">index_name</replaceable>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>BTREE</term> <term><literal>BTREE</></term>
<listitem> <listitem>
<para> <para>
an implementation of Lehman-Yao an implementation of Lehman-Yao
@ -92,7 +92,7 @@ CREATE [ UNIQUE ] INDEX <replaceable class="parameter">index_name</replaceable>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>RTREE</term> <term><literal>RTREE</></term>
<listitem> <listitem>
<para>implements standard R-trees using Guttman's <para>implements standard R-trees using Guttman's
quadratic split algorithm. quadratic split algorithm.
@ -101,7 +101,7 @@ CREATE [ UNIQUE ] INDEX <replaceable class="parameter">index_name</replaceable>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>HASH</term> <term><literal>HASH</></term>
<listitem> <listitem>
<para> <para>
an implementation of Litwin's linear hashing. an implementation of Litwin's linear hashing.
@ -110,7 +110,7 @@ CREATE [ UNIQUE ] INDEX <replaceable class="parameter">index_name</replaceable>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>GIST</term> <term><literal>GIST</></term>
<listitem> <listitem>
<para> <para>
Generalized Index Search Trees. Generalized Index Search Trees.
@ -270,11 +270,11 @@ ERROR: Cannot create index: 'index_name' already exists.
<para> <para>
All functions and operators used in an index definition must be All functions and operators used in an index definition must be
<firstterm>cachable</>, that is, their results must depend only on <firstterm>cacheable</>, that is, their results must depend only on
their input arguments and never on any outside influence (such as their input arguments and never on any outside influence (such as
the contents of another table or the current time). This restriction the contents of another table or the current time). This restriction
ensures that the behavior of the index is well-defined. To use a ensures that the behavior of the index is well-defined. To use a
user-defined function in an index, remember to mark the function cachable user-defined function in an index, remember to mark the function cacheable
when you create it. when you create it.
</para> </para>
@ -329,7 +329,7 @@ ERROR: Cannot create index: 'index_name' already exists.
</para> </para>
<para> <para>
Currently, only the B-tree and gist access methods support multi-column Currently, only the B-tree and gist access methods support multicolumn
indexes. Up to 16 keys may be specified by default (this limit indexes. Up to 16 keys may be specified by default (this limit
can be altered when building can be altered when building
<application>PostgreSQL</application>). Only B-tree currently supports <application>PostgreSQL</application>). Only B-tree currently supports

4
doc/src/sgml/ref/create_operator.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.24 2002/01/20 22:19:56 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.25 2002/03/22 19:20:39 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -309,7 +309,7 @@ MYBOXES.description !== box '((0,0), (1,1))'
furthermore, equality of the data type must mean bitwise equality furthermore, equality of the data type must mean bitwise equality
of the representation of the type. (For example, a data type that of the representation of the type. (For example, a data type that
contains unused bits that don't matter for equality tests could contains unused bits that don't matter for equality tests could
not be hashjoined.) not be hash-joined.)
The HASHES flag indicates to the query optimizer that a hash join The HASHES flag indicates to the query optimizer that a hash join
may safely be used with this operator.</para> may safely be used with this operator.</para>
<para> <para>

6
doc/src/sgml/ref/create_rule.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.32 2002/03/10 06:00:13 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.33 2002/03/22 19:20:39 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -78,7 +78,7 @@ NOTHING
<term><replaceable class="parameter">condition</replaceable></term> <term><replaceable class="parameter">condition</replaceable></term>
<listitem> <listitem>
<para> <para>
Any SQL boolean-condition expression. The condition expression may not Any SQL conditional expression (returning <type>boolean</type>). The condition expression may not
refer to any tables except <literal>new</literal> and refer to any tables except <literal>new</literal> and
<literal>old</literal>. <literal>old</literal>.
</para> </para>
@ -269,7 +269,7 @@ CREATE RULE "_RETtoyemp" AS
SELECT * FROM emp; SELECT * FROM emp;
</programlisting> </programlisting>
This attempt to select from EMP will cause This attempt to select from <literal>EMP</literal> will cause
<productname>PostgreSQL</productname> to issue an error <productname>PostgreSQL</productname> to issue an error
because the queries cycled too many times: because the queries cycled too many times:

4
doc/src/sgml/ref/create_sequence.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.24 2002/01/20 22:19:56 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.25 2002/03/22 19:20:40 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -268,7 +268,7 @@ SELECT * FROM <replaceable>seqname</replaceable>;
setting of 10, backend A might reserve values 1..10 and return <function>nextval</function>=1, setting of 10, backend A might reserve values 1..10 and return <function>nextval</function>=1,
then then
backend B might reserve values 11..20 and return <function>nextval</function>=11 before backend backend B might reserve values 11..20 and return <function>nextval</function>=11 before backend
A has generated nextval=2.) Thus, with a <replaceable class="parameter">cache</replaceable> setting of one it is safe A has generated <literal>nextval</literal>=2.) Thus, with a <replaceable class="parameter">cache</replaceable> setting of one it is safe
to assume that <function>nextval</> values are generated sequentially; with a <replaceable class="parameter">cache</replaceable> to assume that <function>nextval</> values are generated sequentially; with a <replaceable class="parameter">cache</replaceable>
setting greater than one you should only assume that the <function>nextval</> values setting greater than one you should only assume that the <function>nextval</> values
are all distinct, not that they are generated purely sequentially. are all distinct, not that they are generated purely sequentially.

4
doc/src/sgml/ref/create_table.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.52 2002/01/20 22:19:56 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.53 2002/03/22 19:20:40 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -520,7 +520,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
accompanied by some descriptive text, such as: accompanied by some descriptive text, such as:
<computeroutput>ERROR: Relation '<replaceable <computeroutput>ERROR: Relation '<replaceable
class="parameter">table</replaceable>' already class="parameter">table</replaceable>' already
exists</computeroutput>, which occurs at runtime if the table exists</computeroutput>, which occurs at run time if the table
specified already exists in the database. specified already exists in the database.
</para> </para>
</msgexplan> </msgexplan>

4
doc/src/sgml/ref/explain.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/explain.sgml,v 1.15 2002/03/06 06:48:04 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/explain.sgml,v 1.16 2002/03/22 19:20:40 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -41,7 +41,7 @@ EXPLAIN [ ANALYZE ] [ VERBOSE ] <replaceable class="PARAMETER">query</replaceabl
<term>ANALYZE</term> <term>ANALYZE</term>
<listitem> <listitem>
<para> <para>
Flag to carry out the query and show actual runtimes. Flag to carry out the query and show actual run times.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>

10
doc/src/sgml/ref/pg_ctl-ref.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.12 2001/12/08 03:24:37 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.13 2002/03/22 19:20:41 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -76,7 +76,7 @@ PostgreSQL documentation
stopping, or restarting <xref linkend="app-postmaster">, the stopping, or restarting <xref linkend="app-postmaster">, the
<productname>PostgreSQL</productname> backend server, or displaying <productname>PostgreSQL</productname> backend server, or displaying
the status of a running postmaster. Although the postmaster can be the status of a running postmaster. Although the postmaster can be
started manually, <application>pg_ctl</application> encapulates started manually, <application>pg_ctl</application> encapsulates
tasks such as redirecting log output, properly detaching from the tasks such as redirecting log output, properly detaching from the
terminal and process group, and it provides convenient options for terminal and process group, and it provides convenient options for
controlled shutdown. controlled shutdown.
@ -190,7 +190,7 @@ PostgreSQL documentation
<para> <para>
Specifies the location of the <filename>postmaster</filename> Specifies the location of the <filename>postmaster</filename>
executable. By default the postmaster is taken from the same executable. By default the postmaster is taken from the same
directory as pg_ctl, or failing that, the hard-wired directory as <command>pg_ctl</>, or failing that, the hard-wired
installation directory. It is not necessary to use this installation directory. It is not necessary to use this
option unless you are doing something unusual and get errors option unless you are doing something unusual and get errors
that the postmaster was not found. that the postmaster was not found.
@ -291,7 +291,7 @@ PostgreSQL documentation
<para> <para>
This is almost equivalent to stopping the This is almost equivalent to stopping the
<application>postmaster</application> and starting it again <application>postmaster</application> and starting it again
except that pg_ctl saves and reuses the command line options that except that <command>pg_ctl</command> saves and reuses the command line options that
were passed to the previously running instance. To restart were passed to the previously running instance. To restart
the <application>postmaster</application> in the simplest form: the <application>postmaster</application> in the simplest form:
<screen> <screen>
@ -308,7 +308,7 @@ PostgreSQL documentation
</para> </para>
<para> <para>
To restart using port 5433 and disabling fsync after restarting: To restart using port 5433 and disabling <function>fsync</> after restarting:
<screen> <screen>
<prompt>$</prompt> <userinput>pg_ctl -o "-F -p 5433" restart</userinput> <prompt>$</prompt> <userinput>pg_ctl -o "-F -p 5433" restart</userinput>
</screen> </screen>

102
doc/src/sgml/ref/pg_dump.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.42 2002/02/11 00:14:10 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.43 2002/03/22 19:20:42 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -138,8 +138,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-a</term> <term><option>-a</></term>
<term>--data-only</term> <term><option>--data-only</></term>
<listitem> <listitem>
<para> <para>
Dump only the data, not the schema (data definitions). Dump only the data, not the schema (data definitions).
@ -154,8 +154,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-b</term> <term><option>-b</></term>
<term>--blobs</term> <term><option>--blobs</></term>
<listitem> <listitem>
<para> <para>
Include large objects in dump. Include large objects in dump.
@ -164,8 +164,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-c</term> <term><option>-c</option></term>
<term>--clean</term> <term><option>--clean</option></term>
<listitem> <listitem>
<para> <para>
Output commands to clean (drop) Output commands to clean (drop)
@ -181,8 +181,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-C</term> <term><option>-C</></term>
<term>--create</term> <term><option>--create</></term>
<listitem> <listitem>
<para> <para>
Begin the output with a command to create the Begin the output with a command to create the
@ -200,8 +200,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-d</term> <term><option>-d</option></term>
<term>--inserts</term> <term><option>--inserts</option></term>
<listitem> <listitem>
<para> <para>
Dump data as <command>INSERT</command> commands (rather Dump data as <command>INSERT</command> commands (rather
@ -213,9 +213,9 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-D</term> <term><option>-D</option></term>
<term>--column-inserts</term> <term><option>--column-inserts</option></term>
<term>--attribute-inserts</term> <term><option>--attribute-inserts</option></term>
<listitem> <listitem>
<para> <para>
Dump data as <command>INSERT</command> commands with explicit Dump data as <command>INSERT</command> commands with explicit
@ -229,8 +229,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-f <replaceable class="parameter">file</replaceable></term> <term><option>-f <replaceable class="parameter">file</replaceable></option></term>
<term>--file=<replaceable class="parameter">file</replaceable></term> <term><option>--file=<replaceable class="parameter">file</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Send output to the specified file. If this is omitted, the Send output to the specified file. If this is omitted, the
@ -240,8 +240,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-F <replaceable class="parameter">format</replaceable></term> <term><option>-F <replaceable class="parameter">format</replaceable></option></term>
<term>--format=<replaceable class="parameter">format</replaceable></term> <term><option>--format=<replaceable class="parameter">format</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Selects the format of the output. Selects the format of the output.
@ -289,8 +289,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-i</term> <term><option>-i</></term>
<term>--ignore-version</term> <term><option>--ignore-version</></term>
<listitem> <listitem>
<para> <para>
Ignore version mismatch between <command>pg_dump</command> Ignore version mismatch between <command>pg_dump</command>
@ -306,8 +306,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-n</term> <term><option>-n</></term>
<term>--no-quotes</term> <term><option>--no-quotes</></term>
<listitem> <listitem>
<para> <para>
Suppress double quotes around identifiers unless absolutely necessary. Suppress double quotes around identifiers unless absolutely necessary.
@ -320,8 +320,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-N</term> <term><option>-N</></term>
<term>--quotes</term> <term><option>--quotes</></term>
<listitem> <listitem>
<para> <para>
Include double quotes around identifiers. Include double quotes around identifiers.
@ -331,8 +331,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-o</term> <term><option>-o</></term>
<term>--oids</term> <term><option>--oids</></term>
<listitem> <listitem>
<para> <para>
Dump object identifiers (<acronym>OID</acronym>s) for every Dump object identifiers (<acronym>OID</acronym>s) for every
@ -344,8 +344,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-O</term> <term><option>-O</></term>
<term>--no-owner</term> <term><option>--no-owner</option></term>
<listitem> <listitem>
<para> <para>
Do not output commands to set the Do not output commands to set the
@ -369,8 +369,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-R</term> <term><option>-R</option></term>
<term>--no-reconnect</term> <term><option>--no-reconnect</option></term>
<listitem> <listitem>
<para> <para>
Prohibit <command>pg_dump</command> Prohibit <command>pg_dump</command>
@ -399,8 +399,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-s</term> <term><option>-s</option></term>
<term>--schema-only</term> <term><option>--schema-only</option></term>
<listitem> <listitem>
<para> <para>
Dump only the schema (data definitions), no data. Dump only the schema (data definitions), no data.
@ -409,8 +409,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-S <replaceable class="parameter">username</replaceable></term> <term><option>-S <replaceable class="parameter">username</replaceable></option></term>
<term>--superuser=<replaceable class="parameter">username</replaceable></term> <term><option>--superuser=<replaceable class="parameter">username</replaceable></option></term>
<listitem> <listitem>
<para> <para>
The scripts or archives created by <command>pg_dump</command> The scripts or archives created by <command>pg_dump</command>
@ -422,8 +422,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-t <replaceable class="parameter">table</replaceable></term> <term><option>-t <replaceable class="parameter">table</replaceable></option></term>
<term>--table=<replaceable class="parameter">table</replaceable></term> <term><option>--table=<replaceable class="parameter">table</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Dump data for <replaceable class="parameter">table</replaceable> only. Dump data for <replaceable class="parameter">table</replaceable> only.
@ -432,8 +432,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-v</term> <term><option>-v</></term>
<term>--verbose</term> <term><option>--verbose</></term>
<listitem> <listitem>
<para> <para>
Specifies verbose mode. Specifies verbose mode.
@ -442,9 +442,9 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-x</term> <term><option>-x</></term>
<term>--no-privileges</term> <term><option>--no-privileges</></term>
<term>--no-acl</term> <term><option>--no-acl</></term>
<listitem> <listitem>
<para> <para>
Prevent dumping of access privileges (grant/revoke commands). Prevent dumping of access privileges (grant/revoke commands).
@ -453,8 +453,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-X use-set-session-authorization</term> <term><option>-X use-set-session-authorization</></term>
<term>--use-set-session-authorization</term> <term><option>--use-set-session-authorization</></term>
<listitem> <listitem>
<para> <para>
Normally, if a (plain-text mode) script generated by Normally, if a (plain-text mode) script generated by
@ -488,8 +488,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-Z <replaceable class="parameter">0..9</replaceable></term> <term><option>-Z <replaceable class="parameter">0..9</replaceable></option></term>
<term>--compress=<replaceable class="parameter">0..9</replaceable></term> <term><option>--compress=<replaceable class="parameter">0..9</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specify the compression level to use in archive formats that support Specify the compression level to use in archive formats that support
@ -507,8 +507,8 @@ PostgreSQL documentation
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>-h <replaceable class="parameter">host</replaceable></term> <term><option>-h <replaceable class="parameter">host</replaceable></option></term>
<term>--host=<replaceable class="parameter">host</replaceable></term> <term><option>--host=<replaceable class="parameter">host</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specifies the host name of the machine on which the Specifies the host name of the machine on which the
@ -520,8 +520,8 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-p <replaceable class="parameter">port</replaceable></term> <term><option>-p <replaceable class="parameter">port</replaceable></option></term>
<term>--port=<replaceable class="parameter">port</replaceable></term> <term><option>--port=<replaceable class="parameter">port</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specifies the Internet TCP/IP port or local Unix domain socket file Specifies the Internet TCP/IP port or local Unix domain socket file
@ -534,7 +534,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-U <replaceable>username</replaceable></term> <term><option>-U <replaceable>username</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Connect as the given user. Connect as the given user.
@ -543,7 +543,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-W</term> <term><option>-W</option></term>
<listitem> <listitem>
<para> <para>
Force a password prompt. This should happen automatically if Force a password prompt. This should happen automatically if

104
doc/src/sgml/ref/pg_restore.sgml
View File

@ -1,4 +1,4 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.22 2002/02/11 00:14:10 tgl Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.23 2002/03/22 19:20:42 petere Exp $ -->
<refentry id="APP-PGRESTORE"> <refentry id="APP-PGRESTORE">
<docinfo> <docinfo>
@ -117,8 +117,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-a</term> <term><option>-a</option></term>
<term>--data-only</term> <term><option>--data-only</option></term>
<listitem> <listitem>
<para> <para>
Restore only the data, no schema (definitions). Restore only the data, no schema (definitions).
@ -127,8 +127,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-c</term> <term><option>-c</option></term>
<term>--clean</term> <term><option>--clean</option></term>
<listitem> <listitem>
<para> <para>
Clean (drop) database objects before recreating them. Clean (drop) database objects before recreating them.
@ -137,8 +137,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-C</term> <term><option>-C</option></term>
<term>--create</term> <term><option>--create</option></term>
<listitem> <listitem>
<para> <para>
Create the database before restoring into it. Create the database before restoring into it.
@ -151,8 +151,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-d <replaceable class="parameter">dbname</replaceable></term> <term><option>-d <replaceable class="parameter">dbname</replaceable></option></term>
<term>--dbname=<replaceable class="parameter">dbname</replaceable></term> <term><option>--dbname=<replaceable class="parameter">dbname</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Connect to database <replaceable class="parameter">dbname</replaceable> and restore Connect to database <replaceable class="parameter">dbname</replaceable> and restore
@ -162,8 +162,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-f <replaceable>filename</replaceable></term> <term><option>-f <replaceable>filename</replaceable></option></term>
<term>--file=<replaceable>filename</replaceable></term> <term><option>--file=<replaceable>filename</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specify output file for generated script, or for the listing Specify output file for generated script, or for the listing
@ -173,8 +173,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-F <replaceable class="parameter">format</replaceable></term> <term><option>-F <replaceable class="parameter">format</replaceable></option></term>
<term>--format=<replaceable class="parameter">format</replaceable></term> <term><option>--format=<replaceable class="parameter">format</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specify format of the archive. Specify format of the archive.
@ -212,8 +212,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-i <replaceable class="parameter">index</replaceable></term> <term><option>-i <replaceable class="parameter">index</replaceable></option></term>
<term>--index=<replaceable class="parameter">index</replaceable></term> <term><option>--index=<replaceable class="parameter">index</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Restore definition for named <replaceable class="parameter">index</replaceable> only. Restore definition for named <replaceable class="parameter">index</replaceable> only.
@ -222,8 +222,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-l</term> <term><option>-l</option></term>
<term>--list</term> <term><option>--list</option></term>
<listitem> <listitem>
<para> <para>
List the contents of the archive. The output of this command can be used with the <option>-L</option> option List the contents of the archive. The output of this command can be used with the <option>-L</option> option
@ -233,8 +233,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-L <replaceable class="parameter">list-file</replaceable></term> <term><option>-L <replaceable class="parameter">list-file</replaceable></option></term>
<term>--use-list=<replaceable class="parameter">list-file</replaceable></term> <term><option>--use-list=<replaceable class="parameter">list-file</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Restore elements in <REPLACEABLE CLASS="PARAMETER">list-file</REPLACEABLE> only, and in the Restore elements in <REPLACEABLE CLASS="PARAMETER">list-file</REPLACEABLE> only, and in the
@ -245,8 +245,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-N</term> <term><option>-N</option></term>
<term>--orig-order</term> <term><option>--orig-order</option></term>
<listitem> <listitem>
<para> <para>
Restore items in the original dump order. By default <command>pg_dump</command> will dump items in an order convenient Restore items in the original dump order. By default <command>pg_dump</command> will dump items in an order convenient
@ -256,8 +256,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-o</term> <term><option>-o</option></term>
<term>--oid-order</term> <term><option>--oid-order</option></term>
<listitem> <listitem>
<para> <para>
Restore items in the OID order. By default <command>pg_dump</command> will dump items in an order convenient Restore items in the OID order. By default <command>pg_dump</command> will dump items in an order convenient
@ -267,8 +267,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-O</term> <term><option>-O</option></term>
<term>--no-owner</term> <term><option>--no-owner</option></term>
<listitem> <listitem>
<para> <para>
Prevent any attempt to restore original object ownership. Objects will be owned by the user name used Prevent any attempt to restore original object ownership. Objects will be owned by the user name used
@ -278,8 +278,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-P <replaceable class="parameter">function-name</replaceable></term> <term><option>-P <replaceable class="parameter">function-name</replaceable></option></term>
<term>--function=<replaceable class="parameter">function-name</replaceable></term> <term><option>--function=<replaceable class="parameter">function-name</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specify a procedure or function to be restored. Specify a procedure or function to be restored.
@ -288,8 +288,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-r</term> <term><option>-r</option></term>
<term>--rearrange</term> <term><option>--rearrange</option></term>
<listitem> <listitem>
<para> <para>
Restore items in modified OID order. By default <command>pg_dump</command> will dump items in an order convenient Restore items in modified OID order. By default <command>pg_dump</command> will dump items in an order convenient
@ -301,8 +301,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-R</term> <term><option>-R</option></term>
<term>--no-reconnect</term> <term><option>--no-reconnect</option></term>
<listitem> <listitem>
<para> <para>
While restoring an archive, <command>pg_restore</command> While restoring an archive, <command>pg_restore</command>
@ -324,8 +324,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-s</term> <term><option>-s</option></term>
<term>--schema-only</term> <term><option>--schema-only</option></term>
<listitem> <listitem>
<para> <para>
Restore the schema (definitions), no data. Sequence values will be reset. Restore the schema (definitions), no data. Sequence values will be reset.
@ -334,8 +334,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-S <replaceable class="parameter">username</replaceable></term> <term><option>-S <replaceable class="parameter">username</replaceable></option></term>
<term>--superuser=<replaceable class="parameter">username</replaceable></term> <term><option>--superuser=<replaceable class="parameter">username</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specify the superuser user name to use when disabling triggers and/or setting ownership of schema elements. Specify the superuser user name to use when disabling triggers and/or setting ownership of schema elements.
@ -345,8 +345,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-t <replaceable class="parameter">table</replaceable></term> <term><option>-t <replaceable class="parameter">table</replaceable></option></term>
<term>--table=<replaceable class="parameter">table</replaceable></term> <term><option>--table=<replaceable class="parameter">table</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Restore schema/data for <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> only. Restore schema/data for <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> only.
@ -355,8 +355,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-T <replaceable class="parameter">trigger</replaceable></term> <term><option>-T <replaceable class="parameter">trigger</replaceable></option></term>
<term>--trigger=<replaceable class="parameter">trigger</replaceable></term> <term><option>--trigger=<replaceable class="parameter">trigger</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Restore definition of <REPLACEABLE CLASS="PARAMETER">trigger</REPLACEABLE> only. Restore definition of <REPLACEABLE CLASS="PARAMETER">trigger</REPLACEABLE> only.
@ -365,8 +365,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-v</term> <term><option>-v</option></term>
<term>--verbose</term> <term><option>--verbose</option></term>
<listitem> <listitem>
<para> <para>
Specifies verbose mode. Specifies verbose mode.
@ -375,9 +375,9 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-x</term> <term><option>-x</option></term>
<term>--no-privileges</term> <term><option>--no-privileges</option></term>
<term>--no-acl</term> <term><option>--no-acl</option></term>
<listitem> <listitem>
<para> <para>
Prevent restoration of access privileges (grant/revoke commands). Prevent restoration of access privileges (grant/revoke commands).
@ -386,8 +386,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-X use-set-session-authorization</term> <term><option>-X use-set-session-authorization</option></term>
<term>--use-set-session-authorization</term> <term><option>--use-set-session-authorization</option></term>
<listitem> <listitem>
<para> <para>
Normally, if restoring an archive requires altering the Normally, if restoring an archive requires altering the
@ -413,8 +413,8 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>-h <replaceable class="parameter">host</replaceable></term> <term><option>-h <replaceable class="parameter">host</replaceable></option></term>
<term>--host=<replaceable class="parameter">host</replaceable></term> <term><option>--host=<replaceable class="parameter">host</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specifies the host name of the machine on which the Specifies the host name of the machine on which the
@ -426,8 +426,8 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-p <replaceable class="parameter">port</replaceable></term> <term><option>-p <replaceable class="parameter">port</replaceable></option></term>
<term>--port=<replaceable class="parameter">port</replaceable></term> <term><option>--port=<replaceable class="parameter">port</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Specifies the Internet TCP/IP port or local Unix domain socket file Specifies the Internet TCP/IP port or local Unix domain socket file
@ -440,7 +440,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-U <replaceable>username</replaceable></term> <term><option>-U <replaceable>username</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Connect as the given user. Connect as the given user.
@ -449,7 +449,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-W</term> <term><option>-W</option></term>
<listitem> <listitem>
<para> <para>
Force a password prompt. This should happen automatically if Force a password prompt. This should happen automatically if

44
doc/src/sgml/ref/postgres-ref.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/postgres-ref.sgml,v 1.24 2002/03/02 21:39:16 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/postgres-ref.sgml,v 1.25 2002/03/22 19:20:43 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -79,7 +79,7 @@ PostgreSQL documentation
The <filename>postgres</filename> executable is the actual The <filename>postgres</filename> executable is the actual
<productname>PostgreSQL</productname> server process that processes <productname>PostgreSQL</productname> server process that processes
queries. It is normally not called directly; instead a <xref queries. It is normally not called directly; instead a <xref
linkend="app-postmaster"> multi-user server is started. linkend="app-postmaster"> multiuser server is started.
</para> </para>
<para> <para>
@ -130,7 +130,7 @@ PostgreSQL documentation
Guide</citetitle> for details. Some (safe) options can also be Guide</citetitle> for details. Some (safe) options can also be
set from the connecting client in an application-dependent way. set from the connecting client in an application-dependent way.
For example, if the environment variable <envar>PGOPTIONS</envar> For example, if the environment variable <envar>PGOPTIONS</envar>
is set, then libpq-based clients will pass that string to the is set, then <application>libpq</>-based clients will pass that string to the
server, which will interpret it as server, which will interpret it as
<application>postgres</application> command-line options. <application>postgres</application> command-line options.
</para> </para>
@ -144,12 +144,12 @@ PostgreSQL documentation
<option>-F</option>, and <option>--name</> have the same meanings <option>-F</option>, and <option>--name</> have the same meanings
as the <xref linkend="app-postmaster"> except that as the <xref linkend="app-postmaster"> except that
<option>-d</option> <literal>0</> prevents the debugging level of <option>-d</option> <literal>0</> prevents the debugging level of
the postmaster from being propogated to the backend. the postmaster from being propagated to the backend.
</para> </para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>-e</term> <term><option>-e</option></term>
<listitem> <listitem>
<para> <para>
Sets the default date style to <quote>European</quote>, which Sets the default date style to <quote>European</quote>, which
@ -163,21 +163,21 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-o <replaceable class="parameter">filename</replaceable></term> <term><option>-o</option> <replaceable class="parameter">filename</replaceable></term>
<listitem> <listitem>
<para> <para>
Sends all debugging and error output to Sends all debugging and error output to
<replaceable class="parameter">filename</replaceable>. <replaceable class="parameter">filename</replaceable>.
If the backend is running under the If the backend is running under the
<application>postmaster</application>, this option is ignored, <application>postmaster</application>, this option is ignored,
and the stderr inherited from the and the <systemitem>stderr</> inherited from the
<application>postmaster</application> is used. <application>postmaster</application> is used.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-P</term> <term><option>-P</option></term>
<listitem> <listitem>
<para> <para>
Ignore system indexes while scanning/updating system tuples. The Ignore system indexes while scanning/updating system tuples. The
@ -188,7 +188,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-s</term> <term><option>-s</option></term>
<listitem> <listitem>
<para> <para>
Print time information and other statistics at the end of each query. Print time information and other statistics at the end of each query.
@ -199,7 +199,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-S <replaceable class="parameter">sort-mem</replaceable></term> <term><option>-S</option> <replaceable class="parameter">sort-mem</replaceable></term>
<listitem> <listitem>
<para> <para>
Specifies the amount of memory to be used by internal sorts and hashes Specifies the amount of memory to be used by internal sorts and hashes
@ -231,7 +231,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-E</term> <term><option>-E</option></term>
<listitem> <listitem>
<para> <para>
Echo all queries. Echo all queries.
@ -240,7 +240,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-N</term> <term><option>-N</option></term>
<listitem> <listitem>
<para> <para>
Disables use of newline as a query delimiter. Disables use of newline as a query delimiter.
@ -264,7 +264,7 @@ PostgreSQL documentation
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>-f { s | i | m | n | h }</term> <term><option>-f</option> <literal>{ s | i | m | n | h }</literal></term>
<listitem> <listitem>
<para> <para>
Forbids the use of particular scan and join methods: Forbids the use of particular scan and join methods:
@ -286,7 +286,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-i</term> <term><option>-i</option></term>
<listitem> <listitem>
<para> <para>
Prevents query execution, but shows the plan tree. Prevents query execution, but shows the plan tree.
@ -295,7 +295,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-O</term> <term><option>-O</option></term>
<listitem> <listitem>
<para> <para>
Allows the structure of system tables to be modified. This is Allows the structure of system tables to be modified. This is
@ -305,7 +305,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-p <replaceable class="parameter">database</replaceable></term> <term><option>-p</option> <replaceable class="parameter">database</replaceable></term>
<listitem> <listitem>
<para> <para>
Indicates that this server has been started by a Indicates that this server has been started by a
@ -317,7 +317,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-t pa[rser] | pl[anner] | e[xecutor]</term> <term><option>-t</option> <literal>pa[rser] | pl[anner] | e[xecutor]</literal></term>
<listitem> <listitem>
<para> <para>
Print timing statistics for each query relating to each of the Print timing statistics for each query relating to each of the
@ -328,7 +328,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-v <replaceable class="parameter">protocol</replaceable></term> <term><option>-v</option> <replaceable class="parameter">protocol</replaceable></term>
<listitem> <listitem>
<para> <para>
Specifies the version number of the frontend/backend protocol Specifies the version number of the frontend/backend protocol
@ -338,7 +338,7 @@ PostgreSQL documentation
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>-W <replaceable class="parameter">seconds</replaceable></term> <term><option>-W</option> <replaceable class="parameter">seconds</replaceable></term>
<listitem> <listitem>
<para> <para>
As soon as this option is encountered, the process sleeps for As soon as this option is encountered, the process sleeps for
@ -377,16 +377,16 @@ PostgreSQL documentation
<para> <para>
But if you use the <option>-N</> command line switch, then newline does But if you use the <option>-N</> command line switch, then newline does
not terminate command entry. The backend will read the standard input not terminate command entry. The backend will read the standard input
until the end-of-file (EOF) marker, then until the end-of-file (<acronym>EOF</>) marker, then
process the input as a single query string. Backslash-newline is not process the input as a single query string. Backslash-newline is not
treated specially in this case. treated specially in this case.
</para> </para>
<para> <para>
To quit the session, type EOF To quit the session, type <acronym>EOF</acronym>
(<keycombo action="simul"><keycap>Control</><keycap>D</></>, usually). (<keycombo action="simul"><keycap>Control</><keycap>D</></>, usually).
If you've If you've
used <option>-N</>, two consecutive EOFs are needed to exit. used <option>-N</>, two consecutive <acronym>EOF</>s are needed to exit.
</para> </para>
<para> <para>

4
doc/src/sgml/ref/postmaster.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/postmaster.sgml,v 1.27 2002/03/02 21:39:16 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/postmaster.sgml,v 1.28 2002/03/22 19:20:43 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -478,7 +478,7 @@ StreamServerPort: cannot bind to port
</para> </para>
<para> <para>
Named runtime parameters can be set in either of these styles: Named run-time parameters can be set in either of these styles:
<screen> <screen>
<prompt>$</prompt> <userinput>postmaster -c sort_mem=1234</userinput> <prompt>$</prompt> <userinput>postmaster -c sort_mem=1234</userinput>
<prompt>$</prompt> <userinput>postmaster --sort-mem=1234</userinput> <prompt>$</prompt> <userinput>postmaster --sort-mem=1234</userinput>

18
doc/src/sgml/ref/psql-ref.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.65 2002/03/20 19:43:30 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.66 2002/03/22 19:20:44 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -66,7 +66,7 @@ PostgreSQL documentation
<para> <para>
<application>psql</application> is a regular <productname>PostgreSQL</productname> <application>psql</application> is a regular <productname>PostgreSQL</productname>
client application. In order to connect to a database you need to know the client application. In order to connect to a database you need to know the
name of your target database, the hostname and port number of the server name of your target database, the host name and port number of the server
and what user name you want to connect as. <application>psql</application> can be and what user name you want to connect as. <application>psql</application> can be
told about those parameters via command line options, namely <option>-d</option>, told about those parameters via command line options, namely <option>-d</option>,
<option>-h</option>, <option>-p</option>, and <option>-U</option> respectively. <option>-h</option>, <option>-p</option>, and <option>-U</option> respectively.
@ -77,9 +77,9 @@ PostgreSQL documentation
to a server on the to a server on the
local host. The default port number is compile-time determined. Since the database local host. The default port number is compile-time determined. Since the database
server uses the same default, you will not have to specify the port in most server uses the same default, you will not have to specify the port in most
cases. The default user name is your Unix username, as is the default cases. The default user name is your Unix user name, as is the default
database name. database name.
Note that you can't just connect to any database under any username. Your database Note that you can't just connect to any database under any user name. Your database
administrator should have informed you about your access rights. To save you some typing administrator should have informed you about your access rights. To save you some typing
you can also set the environment variables <envar>PGDATABASE</envar>, you can also set the environment variables <envar>PGDATABASE</envar>,
<envar>PGHOST</envar>, <envar>PGPORT</envar> and <envar>PGUSER</envar> <envar>PGHOST</envar>, <envar>PGPORT</envar> and <envar>PGUSER</envar>
@ -270,7 +270,7 @@ testdb=>
</para> </para>
<para> <para>
If the connection attempt failed (wrong username, access denied, etc.), the If the connection attempt failed (wrong user name, access denied, etc.), the
previous connection will be kept if and only if <application>psql</application> is previous connection will be kept if and only if <application>psql</application> is
in interactive mode. When executing a non-interactive script, processing in interactive mode. When executing a non-interactive script, processing
will immediately stop with an error. This distinction was chosen as a user will immediately stop with an error. This distinction was chosen as a user
@ -1701,7 +1701,7 @@ bar
<application>psql</application>'s internal variable names can consist of <application>psql</application>'s internal variable names can consist of
letters, numbers, and underscores in any order and any number of them. letters, numbers, and underscores in any order and any number of them.
A number of regular variables are treated specially by <application>psql</application>. A number of regular variables are treated specially by <application>psql</application>.
They indicate certain option settings that can be changed at runtime They indicate certain option settings that can be changed at run time
by altering the value of the variable or represent some state of the application. by altering the value of the variable or represent some state of the application.
Although you can use these Although you can use these
variables for any other purpose, this is not recommended, as the variables for any other purpose, this is not recommended, as the
@ -2037,7 +2037,7 @@ testdb=> <userinput>\set content '\'' `sed -e "s/'/\\\\\\'/g" < my_file.txt` '\'
<term><literal>%M</literal></term> <term><literal>%M</literal></term>
<listitem> <listitem>
<para> <para>
The full hostname (with domain name) of the database server, The full host name (with domain name) of the database server,
or <literal>[local]</literal> if the connection is over a or <literal>[local]</literal> if the connection is over a
Unix domain socket, or Unix domain socket, or
<literal>[local:<replaceable>/dir/name</replaceable>]</literal>, <literal>[local:<replaceable>/dir/name</replaceable>]</literal>,
@ -2051,7 +2051,7 @@ testdb=> <userinput>\set content '\'' `sed -e "s/'/\\\\\\'/g" < my_file.txt` '\'
<term><literal>%m</literal></term> <term><literal>%m</literal></term>
<listitem> <listitem>
<para> <para>
The hostname of the database server, truncated after the The host name of the database server, truncated after the
first dot, or <literal>[local]</literal> if the connection first dot, or <literal>[local]</literal> if the connection
is over a Unix domain socket. is over a Unix domain socket.
</para> </para>
@ -2065,7 +2065,7 @@ testdb=> <userinput>\set content '\'' `sed -e "s/'/\\\\\\'/g" < my_file.txt` '\'
<varlistentry> <varlistentry>
<term><literal>%n</literal></term> <term><literal>%n</literal></term>
<listitem><para>The username you are connected as (not your local system <listitem><para>The user name you are connected as (not your local system
user name).</para></listitem> user name).</para></listitem>
</varlistentry> </varlistentry>

4
doc/src/sgml/ref/reindex.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v 1.8 2001/12/08 03:24:38 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v 1.9 2002/03/22 19:20:45 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -145,7 +145,7 @@ REINDEX
index on a system table. In this case it's important for the backend index on a system table. In this case it's important for the backend
doing the recovery to not have used any of the suspect indexes itself. doing the recovery to not have used any of the suspect indexes itself.
(Indeed, in this sort of scenario you may find that backends are (Indeed, in this sort of scenario you may find that backends are
crashing immediately at startup, due to reliance on the corrupted crashing immediately at start-up, due to reliance on the corrupted
indexes.) To recover safely, the postmaster must be shut down and a indexes.) To recover safely, the postmaster must be shut down and a
stand-alone <productname>PostgreSQL</productname> backend must be stand-alone <productname>PostgreSQL</productname> backend must be
started instead, giving it started instead, giving it

8
doc/src/sgml/ref/select.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/select.sgml,v 1.51 2001/12/08 03:24:39 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/select.sgml,v 1.52 2002/03/22 19:20:45 petere Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -91,7 +91,7 @@ where <replaceable class="PARAMETER">from_item</replaceable> can be:
<term><replaceable class="PARAMETER">condition</replaceable></term> <term><replaceable class="PARAMETER">condition</replaceable></term>
<listitem> <listitem>
<para> <para>
A boolean expression giving a result of true or false. A Boolean expression giving a result of true or false.
See the WHERE and HAVING clause descriptions below. See the WHERE and HAVING clause descriptions below.
</para> </para>
</listitem> </listitem>
@ -368,7 +368,7 @@ where <replaceable class="PARAMETER">from_item</replaceable> can be:
<Productname>PostgreSQL</Productname> 7.1, <Productname>PostgreSQL</Productname> 7.1,
this was the default result, and adding sub-tables was done this was the default result, and adding sub-tables was done
by appending <command>*</command> to the table name. by appending <command>*</command> to the table name.
This old behaviour is available via the command This old behavior is available via the command
<command>SET SQL_Inheritance TO OFF;</command> <command>SET SQL_Inheritance TO OFF;</command>
</para> </para>
@ -449,7 +449,7 @@ WHERE <replaceable class="PARAMETER">boolean_expr</replaceable>
</synopsis> </synopsis>
<replaceable class="PARAMETER">boolean_expr</replaceable> <replaceable class="PARAMETER">boolean_expr</replaceable>
can consist of any expression which evaluates to a boolean value. can consist of any expression which evaluates to a Boolean value.
In many cases, this expression will be: In many cases, this expression will be:
<synopsis> <synopsis>

46
doc/src/sgml/release.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.124 2002/03/19 18:53:01 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.125 2002/03/22 19:20:22 petere Exp $
--> -->
<appendix id="release"> <appendix id="release">
@ -127,11 +127,11 @@ Fix for array subscripts handling (Tom)
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>OID's</term> <term>OIDs</term>
<listitem> <listitem>
<para> <para>
OID's are now optional. Users can now create tables without OIDs are now optional. Users can now create tables without
OID's for cases where OID usage is excessive. OIDs for cases where OID usage is excessive.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -268,7 +268,7 @@ Enable SIGTERM, SIGQUIT to kill backends (Jan)
Removed compile-time limit on number of backends (Tom) Removed compile-time limit on number of backends (Tom)
Better cleanup for semaphore resource failure (Tatsuo, Tom) Better cleanup for semaphore resource failure (Tatsuo, Tom)
Allow safe transaction ID wraparound (Tom) Allow safe transaction ID wraparound (Tom)
Removed OID's from some system tables (Tom) Removed OIDs from some system tables (Tom)
Removed "triggered data change violation" error check (Tom) Removed "triggered data change violation" error check (Tom)
SPI portal creation of prepared/saved plans (Jan) SPI portal creation of prepared/saved plans (Jan)
Allow SPI column functions to work for system columns (Tom) Allow SPI column functions to work for system columns (Tom)
@ -873,7 +873,7 @@ Subqueries in FROM are now supported.
<programlisting> <programlisting>
Bug Fixes Bug Fixes
--------- ---------
Many multi-byte/Unicode/locale fixes (Tatsuo and others) Many multibyte/Unicode/locale fixes (Tatsuo and others)
More reliable ALTER TABLE RENAME (Tom) More reliable ALTER TABLE RENAME (Tom)
Kerberos V fixes (David Wragg) Kerberos V fixes (David Wragg)
Fix for INSERT INTO...SELECT where targetlist has subqueries (Tom) Fix for INSERT INTO...SELECT where targetlist has subqueries (Tom)
@ -1096,7 +1096,7 @@ Fix backwards-index-scan (Tom)
Fix SELECT ... FOR UPDATE so it checks for duplicate keys (Hiroshi) Fix SELECT ... FOR UPDATE so it checks for duplicate keys (Hiroshi)
Add --enable-syslog to configure (Marc) Add --enable-syslog to configure (Marc)
Fix abort transaction at backend exit in rare cases (Tom) Fix abort transaction at backend exit in rare cases (Tom)
Fix for psql \l+ when multi-byte enabled (Tatsuo) Fix for psql \l+ when multibyte enabled (Tatsuo)
Allow PL/pgSQL to accept non ascii identifiers (Tatsuo) Allow PL/pgSQL to accept non ascii identifiers (Tatsuo)
Make vacuum always flush buffers (Tom) Make vacuum always flush buffers (Tom)
Fix to allow cancel while waiting for a lock (Hiroshi) Fix to allow cancel while waiting for a lock (Hiroshi)
@ -1773,7 +1773,7 @@ Add SHLIB_LINK setting for solaris_i386 and solaris_sparc ports(Daren Sefcik)
Fixes for CASE in WHERE join clauses(Tom) Fixes for CASE in WHERE join clauses(Tom)
Fix BTScan abort(Tom) Fix BTScan abort(Tom)
Repair the check for redundant UNIQUE and PRIMARY KEY indexes(Thomas) Repair the check for redundant UNIQUE and PRIMARY KEY indexes(Thomas)
Improve it so that it checks for multi-column constraints(Thomas) Improve it so that it checks for multicolumn constraints(Thomas)
Fix for Win32 making problem with MB enabled(Hiroki Kataoka) Fix for Win32 making problem with MB enabled(Hiroki Kataoka)
Allow BSD yacc and bison to compile pl code(Bruce) Allow BSD yacc and bison to compile pl code(Bruce)
Fix SET NAMES working Fix SET NAMES working
@ -1828,7 +1828,7 @@ Add NT README file
Portability fixes for linux_ppc, IRIX, linux_alpha, OpenBSD, alpha Portability fixes for linux_ppc, IRIX, linux_alpha, OpenBSD, alpha
Remove QUERY_LIMIT, use SELECT...LIMIT Remove QUERY_LIMIT, use SELECT...LIMIT
Fix for EXPLAIN on inheritance(Tom) Fix for EXPLAIN on inheritance(Tom)
Patch to allow vacuum on multi-segment tables(Hiroshi) Patch to allow vacuum on multisegment tables(Hiroshi)
R-Tree optimizer selectivity fix(Tom) R-Tree optimizer selectivity fix(Tom)
ACL file descriptor leak fix(Atsushi Ogawa) ACL file descriptor leak fix(Atsushi Ogawa)
New expresssion subtree code(Tom) New expresssion subtree code(Tom)
@ -1873,7 +1873,7 @@ Add Win1250 (Czech) support (Pavel Behal)
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term>
Multi-version concurrency control(MVCC) Multiversion concurrency control(MVCC)
</term> </term>
<listitem> <listitem>
<para> <para>
@ -1881,7 +1881,7 @@ Add Win1250 (Czech) support (Pavel Behal)
table-level locking, and replaces it with a locking system that is table-level locking, and replaces it with a locking system that is
superior to most commercial database systems. In a traditional system, superior to most commercial database systems. In a traditional system,
each row that is modified is locked until committed, preventing reads by each row that is modified is locked until committed, preventing reads by
other users. MVCC uses the natural multi-version nature of PostgreSQL other users. MVCC uses the natural multiversion nature of PostgreSQL
to allow readers to continue reading consistent data during writer to allow readers to continue reading consistent data during writer
activity. Writers continue to use the compact pg_log transaction activity. Writers continue to use the compact pg_log transaction
system. This is all performed without having to allocate a lock for system. This is all performed without having to allocate a lock for
@ -2020,15 +2020,15 @@ Add Win1250 (Czech) support (Pavel Behal)
</para> </para>
<para> <para>
The new Multi-Version Concurrency Control (MVCC) features can The new Multiversion Concurrency Control (MVCC) features can
give somewhat different behaviors in multi-user give somewhat different behaviors in multiuser
environments. <emphasis>Read and understand the following section environments. <emphasis>Read and understand the following section
to ensure that your existing applications will give you the to ensure that your existing applications will give you the
behavior you need.</emphasis> behavior you need.</emphasis>
</para> </para>
<sect3> <sect3>
<title>Multi-Version Concurrency Control</title> <title>Multiversion Concurrency Control</title>
<para> <para>
Because readers in 6.5 don't lock data, regardless of transaction Because readers in 6.5 don't lock data, regardless of transaction
@ -2122,7 +2122,7 @@ Allow username containing a dash GRANT permissions
Cleanup of NULL in inet types Cleanup of NULL in inet types
Clean up system table bugs(Tom) Clean up system table bugs(Tom)
Fix problems of PAGER and \? command(Masaaki Sakaida) Fix problems of PAGER and \? command(Masaaki Sakaida)
Reduce default multi-segment file size limit to 1GB(Peter) Reduce default multisegment file size limit to 1GB(Peter)
Fix for dumping of CREATE OPERATOR(Tom) Fix for dumping of CREATE OPERATOR(Tom)
Fix for backward scanning of cursors(Hiroshi Inoue) Fix for backward scanning of cursors(Hiroshi Inoue)
Fix for COPY FROM STDIN when using \i(Tom) Fix for COPY FROM STDIN when using \i(Tom)
@ -2134,7 +2134,7 @@ Fix pg_dump so -t option can handle case-sensitive tablenames
Fixes for GROUP BY in special cases(Tom, Jan) Fixes for GROUP BY in special cases(Tom, Jan)
Fix for memory leak in failed queries(Tom) Fix for memory leak in failed queries(Tom)
DEFAULT now supports mixed-case identifiers(Tom) DEFAULT now supports mixed-case identifiers(Tom)
Fix for multi-segment uses of DROP/RENAME table, indexes(Ole Gjerde) Fix for multisegment uses of DROP/RENAME table, indexes(Ole Gjerde)
Disable use of pg_dump with both -o and -d options(Bruce) Disable use of pg_dump with both -o and -d options(Bruce)
Allow pg_dump to properly dump GROUP permissions(Bruce) Allow pg_dump to properly dump GROUP permissions(Bruce)
Fix GROUP BY in INSERT INTO table SELECT * FROM table2(Jan) Fix GROUP BY in INSERT INTO table SELECT * FROM table2(Jan)
@ -2159,7 +2159,7 @@ Update to pgaccess 0.96(Constantin)
Add routines for single-byte "char" type(Thomas) Add routines for single-byte "char" type(Thomas)
Improved substr() function(Thomas) Improved substr() function(Thomas)
Improved multibyte handling(Tatsuo) Improved multibyte handling(Tatsuo)
Multi-version concurrency control/MVCC(Vadim) Multiversion concurrency control/MVCC(Vadim)
New Serialized mode(Vadim) New Serialized mode(Vadim)
Fix for tables over 2gigs(Peter) Fix for tables over 2gigs(Peter)
New SET TRANSACTION ISOLATION LEVEL(Vadim) New SET TRANSACTION ISOLATION LEVEL(Vadim)
@ -2577,7 +2577,7 @@ New rewrite system fixes many problems with rules and views(Jan)
* handle subselects * handle subselects
* handle aggregates on views * handle aggregates on views
* handle insert into select from view works * handle insert into select from view works
System indexes are now multi-key(Bruce) System indexes are now multikey(Bruce)
Oidint2, oidint4, and oidname types are removed(Bruce) Oidint2, oidint4, and oidname types are removed(Bruce)
Use system cache for more system table lookups(Bruce) Use system cache for more system table lookups(Bruce)
New backend programming language PL/pgSQL in backend/pl(Jan) New backend programming language PL/pgSQL in backend/pl(Jan)
@ -3471,7 +3471,7 @@ Bug Fixes
packet length checking in library routines packet length checking in library routines
lock manager priority patch lock manager priority patch
check for under/over flow of float8(Bruce) check for under/over flow of float8(Bruce)
multi-table join fix(Vadim) multitable join fix(Vadim)
SIGPIPE crash fix(Darren) SIGPIPE crash fix(Darren)
large object fixes(Sven) large object fixes(Sven)
allow btree indexes to handle NULLs(Vadim) allow btree indexes to handle NULLs(Vadim)
@ -3503,7 +3503,7 @@ much faster new btree bulk load code(Paul)
BTREE UNIQUE added to bulk load code(Vadim) BTREE UNIQUE added to bulk load code(Vadim)
new lock debug code(Massimo) new lock debug code(Massimo)
massive changes to libpg++(Leo) massive changes to libpg++(Leo)
new GEQO optimizer speeds table multi-table optimization(Martin) new GEQO optimizer speeds table multitable optimization(Martin)
new WARN message for non-unique insert into unique key(Marc) new WARN message for non-unique insert into unique key(Marc)
update x=-3, no spaces, now valid(Bruce) update x=-3, no spaces, now valid(Bruce)
remove case-sensitive identifier handling(Bruce,Thomas,Dan) remove case-sensitive identifier handling(Bruce,Thomas,Dan)
@ -3514,7 +3514,7 @@ no such class or insufficient privilege changed to distinct messages(Dan)
new ANSI timestamp function(Dan) new ANSI timestamp function(Dan)
new ANSI Time and Date types (Thomas) new ANSI Time and Date types (Thomas)
move large chunks of data in backend(Martin) move large chunks of data in backend(Martin)
multi-column btree indexes(Vadim) multicolumn btree indexes(Vadim)
new SET var TO value command(Martin) new SET var TO value command(Martin)
update transaction status on reads(Dan) update transaction status on reads(Dan)
new locale settings for character types(Oleg) new locale settings for character types(Oleg)
@ -3627,7 +3627,7 @@ Properly report errors when INSERT ... SELECT columns did not match
Properly report errors when insert column names were not correct Properly report errors when insert column names were not correct
Psql \g filename now works(Bruce) Psql \g filename now works(Bruce)
Psql fixed problem with multiple statements on one line with multiple outputs Psql fixed problem with multiple statements on one line with multiple outputs
Removed duplicate system oid's Removed duplicate system OIDs
SELECT * INTO TABLE . GROUP/ORDER BY gives unlink error if table exists(Bruce) SELECT * INTO TABLE . GROUP/ORDER BY gives unlink error if table exists(Bruce)
Several fixes for queries that crashed the backend Several fixes for queries that crashed the backend
Starting quote in insert string errors(Bruce) Starting quote in insert string errors(Bruce)
@ -3662,7 +3662,7 @@ Implement IN qualifier(Bruce)
Libpq has PQgetisnull()(Bruce) Libpq has PQgetisnull()(Bruce)
Libpq++ improvements Libpq++ improvements
New options to initdb(Bryan) New options to initdb(Bryan)
Pg_dump allow dump of oid's(Bruce) Pg_dump allow dump of OIDs(Bruce)
Pg_dump create indexes after tables are loaded for speed(Bruce) Pg_dump create indexes after tables are loaded for speed(Bruce)
Pg_dumpall dumps all databases, and the user table Pg_dumpall dumps all databases, and the user table
Pginterface additions for NULL values(Bruce) Pginterface additions for NULL values(Bruce)

4
doc/src/sgml/rules.sgml
View File

@ -1,4 +1,4 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/rules.sgml,v 1.21 2002/01/20 22:19:56 petere Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/rules.sgml,v 1.22 2002/03/22 19:20:26 petere Exp $ -->
<Chapter Id="rules"> <Chapter Id="rules">
<Title>The Rule System</Title> <Title>The Rule System</Title>
@ -1140,7 +1140,7 @@ INSERT INTO shoelace_log VALUES(
INSERT ... VALUES ... FROM. The FROM clause here is just to indicate INSERT ... VALUES ... FROM. The FROM clause here is just to indicate
that there are range-table entries in the parse tree for *NEW* and *OLD*. that there are range-table entries in the parse tree for *NEW* and *OLD*.
These are needed so that they can be referenced by variables in the These are needed so that they can be referenced by variables in the
INSERT command's querytree. INSERT command's query tree.
</Para> </Para>
<Para> <Para>

6
doc/src/sgml/runtime.sgml
View File

@ -1,9 +1,9 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.108 2002/03/11 05:03:51 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.109 2002/03/22 19:20:28 petere Exp $
--> -->
<Chapter Id="runtime"> <Chapter Id="runtime">
<Title>Server Runtime Environment</Title> <Title>Server Run-time Environment</Title>
<Para> <Para>
This chapter discusses how to set up and run the database server This chapter discusses how to set up and run the database server
@ -467,7 +467,7 @@ psql: could not connect to server: Connection refused
<para> <para>
All parameter names are case-insensitive. Every parameter takes a All parameter names are case-insensitive. Every parameter takes a
value of one of the four types: boolean, integer, floating point, value of one of the four types: Boolean, integer, floating point,
and string. Boolean values are <literal>ON</literal>, and string. Boolean values are <literal>ON</literal>,
<literal>OFF</literal>, <literal>TRUE</literal>, <literal>OFF</literal>, <literal>TRUE</literal>,
<literal>FALSE</literal>, <literal>YES</literal>, <literal>FALSE</literal>, <literal>YES</literal>,

14
doc/src/sgml/spi.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/spi.sgml,v 1.21 2002/03/06 06:44:33 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/spi.sgml,v 1.22 2002/03/22 19:20:30 petere Exp $
--> -->
<Chapter id="spi"> <Chapter id="spi">
@ -536,10 +536,10 @@ You may pass multiple queries in one string or query string may be
</Para> </Para>
<Para> <Para>
vals is an array of pointers to tuples (the number of useful entries <structfield>vals</> is an array of pointers to tuples (the number of useful entries
is given by SPI_processed). TupleDesc tupdesc is is given by SPI_processed). <structfield>tupdesc</> is
a tuple descriptor which you may pass to SPI functions dealing with a tuple descriptor which you may pass to SPI functions dealing with
tuples. tuptabcxt, alloced, and free are internal fields not intended tuples. <structfield>tuptabcxt</>, <structfield>alloced</>, and <structfield>free</> are internal fields not intended
for use by SPI callers. for use by SPI callers.
</Para> </Para>
@ -686,7 +686,7 @@ Pointer to an execution plan (parser+planner+optimizer)
</para> </para>
</note> </note>
<PARA> <PARA>
If the query uses parameters, their number and datatypes must be If the query uses parameters, their number and data types must be
specified in the call to <FUNCTION>SPI_prepare</FUNCTION>. specified in the call to <FUNCTION>SPI_prepare</FUNCTION>.
</para> </para>
<Para> <Para>
@ -2177,7 +2177,7 @@ Attribute numbers are 1 based.
</TITLE> </TITLE>
<PARA> <PARA>
Does not allocate new space for the datum. In the case of a pass-by- Does not allocate new space for the datum. In the case of a pass-by-
reference datatype, the Datum will be a pointer into the given tuple. reference data type, the Datum will be a pointer into the given tuple.
</PARA> </PARA>
</REFSECT1> </REFSECT1>
<!-- <!--
@ -2576,7 +2576,7 @@ exit, avoiding memory leakage.
</Para> </Para>
<Para> <Para>
However, if your procedure needs to return an allocated memory object However, if your procedure needs to return an allocated memory object
(such as a value of a pass-by-reference datatype), you can't allocate (such as a value of a pass-by-reference data type), you can't allocate
the return object using <Function>palloc</Function>, at least not while the return object using <Function>palloc</Function>, at least not while
you are connected to SPI. If you try, the object will be deallocated you are connected to SPI. If you try, the object will be deallocated
during <Function>SPI_finish</Function>, and your procedure will not during <Function>SPI_finish</Function>, and your procedure will not

4
doc/src/sgml/syntax.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/syntax.sgml,v 1.58 2002/01/20 22:19:56 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/syntax.sgml,v 1.59 2002/03/22 19:20:31 petere Exp $
--> -->
<chapter id="sql-syntax"> <chapter id="sql-syntax">
@ -391,7 +391,7 @@ CAST ( '<replaceable>string</replaceable>' AS <replaceable>type</replaceable> )
<para> <para>
The <literal>::</literal>, <literal>CAST()</literal>, and The <literal>::</literal>, <literal>CAST()</literal>, and
function-call syntaxes can also be used to specify runtime type function-call syntaxes can also be used to specify run-time type
conversions of arbitrary expressions, as discussed in <xref conversions of arbitrary expressions, as discussed in <xref
linkend="sql-syntax-type-casts">. But the form linkend="sql-syntax-type-casts">. But the form
<replaceable>type</replaceable> '<replaceable>string</replaceable>' <replaceable>type</replaceable> '<replaceable>string</replaceable>'

15
doc/src/sgml/trigger.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/trigger.sgml,v 1.20 2002/03/06 06:44:33 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/trigger.sgml,v 1.21 2002/03/22 19:20:32 petere Exp $
--> -->
<chapter id="triggers"> <chapter id="triggers">
@ -7,9 +7,9 @@ $Header: /cvsroot/pgsql/doc/src/sgml/trigger.sgml,v 1.20 2002/03/06 06:44:33 mom
<para> <para>
<productname>PostgreSQL</productname> has various server-side function <productname>PostgreSQL</productname> has various server-side function
interfaces. Server-side functions can be written in SQL, PLPGSQL, interfaces. Server-side functions can be written in SQL, PL/pgSQL,
TCL, or C. Trigger functions can be written in any of these Tcl, or C. Trigger functions can be written in any of these
languages except SQL. Note that STATEMENT-level trigger events are not languages except SQL. Note that statement-level trigger events are not
supported in the current version. You can currently specify BEFORE or supported in the current version. You can currently specify BEFORE or
AFTER on INSERT, DELETE or UPDATE of a tuple as a trigger event. AFTER on INSERT, DELETE or UPDATE of a tuple as a trigger event.
</para> </para>
@ -216,9 +216,10 @@ CREATE TRIGGER <replaceable>trigger</replaceable> [ BEFORE | AFTER ] [ INSERT |
</para> </para>
<para> <para>
struct TriggerData is defined in src/include/commands/trigger.h: <structname>struct TriggerData</structname> is defined in
<filename>commands/trigger.h</filename>:
<programlisting> <programlisting>
typedef struct TriggerData typedef struct TriggerData
{ {
NodeTag type; NodeTag type;
@ -228,7 +229,7 @@ typedef struct TriggerData
HeapTuple tg_newtuple; HeapTuple tg_newtuple;
Trigger *tg_trigger; Trigger *tg_trigger;
} TriggerData; } TriggerData;
</programlisting> </programlisting>
where the members are defined as follows: where the members are defined as follows:

9
doc/src/sgml/xfunc.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/xfunc.sgml,v 1.50 2002/03/21 16:00:28 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/xfunc.sgml,v 1.51 2002/03/22 19:20:33 petere Exp $
--> -->
<chapter id="xfunc"> <chapter id="xfunc">
@ -86,7 +86,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/xfunc.sgml,v 1.50 2002/03/21 16:00:28 tgl E
<literal>SELECT</>. <literal>SELECT</>.
In the simple (non-set) In the simple (non-set)
case, the first row of the last query's result will be returned. case, the first row of the last query's result will be returned.
(Bear in mind that <quote>the first row</quote> of a multi-row (Bear in mind that <quote>the first row</quote> of a multirow
result is not well-defined unless you use <literal>ORDER BY</>.) result is not well-defined unless you use <literal>ORDER BY</>.)
If the last query happens If the last query happens
to return no rows at all, NULL will be returned. to return no rows at all, NULL will be returned.
@ -367,7 +367,6 @@ SELECT name(new_emp());
------ ------
None None
</screen> </screen>
</para>
<programlisting> <programlisting>
-- --
@ -622,7 +621,7 @@ CREATE FUNCTION square_root(double precision) RETURNS double precision
The user ID the <application>PostgreSQL</application> server runs The user ID the <application>PostgreSQL</application> server runs
as must be able to traverse the path to the file you intend to as must be able to traverse the path to the file you intend to
load. Making the file or a higher-level directory not readable load. Making the file or a higher-level directory not readable
and/or not executable by the <quote>postgres</quote> user is a and/or not executable by the <systemitem>postgres</systemitem> user is a
common mistake. common mistake.
</para> </para>
</note> </note>
@ -1169,7 +1168,7 @@ PG_FUNCTION_INFO_V1(funcname);
<para> <para>
In a version-1 function, each actual argument is fetched using a In a version-1 function, each actual argument is fetched using a
<function>PG_GETARG_<replaceable>xxx</replaceable>()</function> <function>PG_GETARG_<replaceable>xxx</replaceable>()</function>
macro that corresponds to the argument's datatype, and the result macro that corresponds to the argument's data type, and the result
is returned using a is returned using a
<function>PG_RETURN_<replaceable>xxx</replaceable>()</function> <function>PG_RETURN_<replaceable>xxx</replaceable>()</function>
macro for the return type. macro for the return type.

4
doc/src/sgml/xoper.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/xoper.sgml,v 1.17 2002/01/07 02:29:14 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/xoper.sgml,v 1.18 2002/03/22 19:20:34 petere Exp $
--> -->
<Chapter Id="xoper"> <Chapter Id="xoper">
@ -389,7 +389,7 @@ table1.column1 OP table2.column2
</para> </para>
<para> <para>
Merge join is based on the idea of sorting the left and righthand tables Merge join is based on the idea of sorting the left- and right-hand tables
into order and then scanning them in parallel. So, both data types must into order and then scanning them in parallel. So, both data types must
be capable of being fully ordered, and the join operator must be one be capable of being fully ordered, and the join operator must be one
that can only succeed for pairs of values that fall at the <quote>same place</> that can only succeed for pairs of values that fall at the <quote>same place</>

2
doc/src/sgml/xtypes.sgml
View File

@ -175,7 +175,7 @@ CREATE TYPE complex (
<primary>TOAST</primary> <primary>TOAST</primary>
<secondary>and user-defined types</secondary> <secondary>and user-defined types</secondary>
</indexterm> </indexterm>
If the values of your datatype might exceed a few hundred bytes in If the values of your data type might exceed a few hundred bytes in
size (in internal form), you should be careful to mark them size (in internal form), you should be careful to mark them
TOAST-able. To do this, the internal representation must follow the TOAST-able. To do this, the internal representation must follow the
standard layout for variable-length data: the first four bytes must standard layout for variable-length data: the first four bytes must