sharpetronics/PostgreSQL
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-05-25 00:04:05 -04:00
Code Issues Projects Releases Wiki Activity

Update reference documentation on may/can/might:

Browse Source 
Standard English uses "may", "can", and "might" in different ways:

        may - permission, "You may borrow my rake."

        can - ability, "I can lift that log."

        might - possibility, "It might rain today."

Unfortunately, in conversational English, their use is often mixed, as
in, "You may use this variable to do X", when in fact, "can" is a better
choice.  Similarly, "It may crash" is better stated, "It might crash".
This commit is contained in:
Bruce Momjian 2007-01-31 23:26:05 +00:00
parent bc799fab2b
commit e81c138e18
71 changed files with 301 additions and 301 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.20 2006/09/16 00:30:16 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.21 2007/01/31 23:26:02 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -64,7 +64,7 @@ ALTER DOMAIN <replaceable class="PARAMETER">name</replaceable>
<listitem> <listitem>
<para> <para>
These forms change whether a domain is marked to allow NULL These forms change whether a domain is marked to allow NULL
values or to reject NULL values. You may only <literal>SET NOT NULL</> values or to reject NULL values. You can only <literal>SET NOT NULL</>
when the columns using the domain contain no null values. when the columns using the domain contain no null values.
</para> </para>
</listitem> </listitem>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_index.sgml,v 1.11 2006/09/16 00:30:16 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/alter_index.sgml,v 1.12 2007/01/31 23:26:02 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -67,7 +67,7 @@ ALTER INDEX <replaceable class="PARAMETER">name</replaceable> RESET ( <replaceab
<xref linkend="SQL-CREATEINDEX" endterm="sql-createindex-title"> <xref linkend="SQL-CREATEINDEX" endterm="sql-createindex-title">
for details on the available parameters. Note that the index contents for details on the available parameters. Note that the index contents
will not be modified immediately by this command; depending on the will not be modified immediately by this command; depending on the
parameter you may need to rebuild the index with parameter you might need to rebuild the index with
<xref linkend="SQL-REINDEX" endterm="sql-reindex-title"> <xref linkend="SQL-REINDEX" endterm="sql-reindex-title">
to get the desired effects. to get the desired effects.
</para> </para>
@ -80,7 +80,7 @@ ALTER INDEX <replaceable class="PARAMETER">name</replaceable> RESET ( <replaceab
<para> <para>
This form resets one or more index-method-specific storage parameters to This form resets one or more index-method-specific storage parameters to
their defaults. As with <literal>SET</>, a <literal>REINDEX</literal> their defaults. As with <literal>SET</>, a <literal>REINDEX</literal>
may be needed to update the index entirely. might be needed to update the index entirely.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_opfamily.sgml,v 1.1 2007/01/23 05:07:17 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/alter_opfamily.sgml,v 1.2 2007/01/31 23:26:02 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -202,7 +202,7 @@ ALTER OPERATOR FAMILY <replaceable>name</replaceable> USING <replaceable class="
<para> <para>
The <literal>OPERATOR</> and <literal>FUNCTION</> The <literal>OPERATOR</> and <literal>FUNCTION</>
clauses may appear in any order. clauses can appear in any order.
</para> </para>
</refsect1> </refsect1>
@ -216,7 +216,7 @@ ALTER OPERATOR FAMILY <replaceable>name</replaceable> USING <replaceable class="
type(s). The name of the operator or function occupying the slot is not type(s). The name of the operator or function occupying the slot is not
mentioned. Also, for <literal>DROP FUNCTION</> the type(s) to specify mentioned. Also, for <literal>DROP FUNCTION</> the type(s) to specify
are the input data type(s) the function is intended to support; for are the input data type(s) the function is intended to support; for
GIN and GiST indexes this may have nothing to do with the actual input GIN and GiST indexes this might have nothing to do with the actual input
argument types of the function. argument types of the function.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.15 2006/09/16 00:30:16 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.16 2007/01/31 23:26:02 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -136,7 +136,7 @@ ALTER SEQUENCE <replaceable class="parameter">name</replaceable> SET SCHEMA <rep
<term><literal>CYCLE</literal></term> <term><literal>CYCLE</literal></term>
<listitem> <listitem>
<para> <para>
The optional <literal>CYCLE</literal> key word may be used to enable The optional <literal>CYCLE</literal> key word can be used to enable
the sequence to wrap around when the the sequence to wrap around when the
<replaceable class="parameter">maxvalue</replaceable> or <replaceable class="parameter">maxvalue</replaceable> or
<replaceable class="parameter">minvalue</replaceable> has been <replaceable class="parameter">minvalue</replaceable> has been

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.92 2006/10/23 18:10:32 petere Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.93 2007/01/31 23:26:02 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -110,7 +110,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
These forms set or remove the default value for a column. These forms set or remove the default value for a column.
The default values only apply to subsequent <command>INSERT</command> The default values only apply to subsequent <command>INSERT</command>
commands; they do not cause rows already in the table to change. commands; they do not cause rows already in the table to change.
Defaults may also be created for views, in which case they are Defaults can also be created for views, in which case they are
inserted into <command>INSERT</> statements on the view before inserted into <command>INSERT</> statements on the view before
the view's <literal>ON INSERT</literal> rule is applied. the view's <literal>ON INSERT</literal> rule is applied.
</para> </para>
@ -200,7 +200,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
A disabled trigger is still known to the system, but is not executed A disabled trigger is still known to the system, but is not executed
when its triggering event occurs. For a deferred trigger, the enable when its triggering event occurs. For a deferred trigger, the enable
status is checked when the event occurs, not when the trigger function status is checked when the event occurs, not when the trigger function
is actually executed. One may disable or enable a single is actually executed. One can disable or enable a single
trigger specified by name, or all triggers on the table, or only trigger specified by name, or all triggers on the table, or only
user triggers (this option excludes triggers that are used to implement user triggers (this option excludes triggers that are used to implement
foreign key constraints). Disabling or enabling constraint triggers foreign key constraints). Disabling or enabling constraint triggers
@ -261,7 +261,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<xref linkend="SQL-CREATETABLE" endterm="sql-createtable-title"> <xref linkend="SQL-CREATETABLE" endterm="sql-createtable-title">
for details on the available parameters. Note that the table contents for details on the available parameters. Note that the table contents
will not be modified immediately by this command; depending on the will not be modified immediately by this command; depending on the
parameter you may need to rewrite the table to get the desired effects. parameter you might need to rewrite the table to get the desired effects.
That can be done with <xref linkend="SQL-CLUSTER" That can be done with <xref linkend="SQL-CLUSTER"
endterm="sql-cluster-title"> or one of the forms of <command>ALTER endterm="sql-cluster-title"> or one of the forms of <command>ALTER
TABLE</> that forces a table rewrite. TABLE</> that forces a table rewrite.
@ -284,7 +284,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<listitem> <listitem>
<para> <para>
This form resets one or more storage parameters to their This form resets one or more storage parameters to their
defaults. As with <literal>SET</>, a table rewrite may be defaults. As with <literal>SET</>, a table rewrite might be
needed to update the table entirely. needed to update the table entirely.
</para> </para>
</listitem> </listitem>
@ -309,7 +309,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<literal>CHECK</literal> constraints of the parent. Currently <literal>CHECK</literal> constraints of the parent. Currently
<literal>UNIQUE</literal>, <literal>PRIMARY KEY</literal>, and <literal>UNIQUE</literal>, <literal>PRIMARY KEY</literal>, and
<literal>FOREIGN KEY</literal> constraints are not considered, but <literal>FOREIGN KEY</literal> constraints are not considered, but
this may change in the future. this might change in the future.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -607,7 +607,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<para> <para>
Adding a column with a non-null default or changing the type of an Adding a column with a non-null default or changing the type of an
existing column will require the entire table to be rewritten. This existing column will require the entire table to be rewritten. This
may take a significant amount of time for a large table; and it will might take a significant amount of time for a large table; and it will
temporarily require double the disk space. temporarily require double the disk space.
</para> </para>
@ -656,7 +656,7 @@ ALTER TABLE table ALTER COLUMN anycol TYPE anytype;
expression is not applied to the column's default value (if any); the expression is not applied to the column's default value (if any); the
result might not be a constant expression as required for a default. result might not be a constant expression as required for a default.
This means that when there is no implicit or assignment cast from old to This means that when there is no implicit or assignment cast from old to
new type, <literal>ALTER TYPE</> may fail to convert the default even new type, <literal>ALTER TYPE</> might fail to convert the default even
though a <literal>USING</literal> clause is supplied. In such cases, though a <literal>USING</literal> clause is supplied. In such cases,
drop the default with <literal>DROP DEFAULT</>, perform the <literal>ALTER drop the default with <literal>DROP DEFAULT</>, perform the <literal>ALTER
TYPE</>, and then use <literal>SET DEFAULT</> to add a suitable new TYPE</>, and then use <literal>SET DEFAULT</> to add a suitable new

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/analyze.sgml,v 1.20 2006/09/16 00:30:16 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/analyze.sgml,v 1.21 2007/01/31 23:26:02 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -109,7 +109,7 @@ ANALYZE [ VERBOSE ] [ <replaceable class="PARAMETER">table</replaceable> [ (<rep
The statistics collected by <command>ANALYZE</command> usually The statistics collected by <command>ANALYZE</command> usually
include a list of some of the most common values in each column and include a list of some of the most common values in each column and
a histogram showing the approximate data distribution in each a histogram showing the approximate data distribution in each
column. One or both of these may be omitted if column. One or both of these can be omitted if
<command>ANALYZE</command> deems them uninteresting (for example, <command>ANALYZE</command> deems them uninteresting (for example,
in a unique-key column, there are no common values) or if the in a unique-key column, there are no common values) or if the
column data type does not support the appropriate operators. There column data type does not support the appropriate operators. There
@ -123,7 +123,7 @@ ANALYZE [ VERBOSE ] [ <replaceable class="PARAMETER">table</replaceable> [ (<rep
allows even very large tables to be analyzed in a small amount of allows even very large tables to be analyzed in a small amount of
time. Note, however, that the statistics are only approximate, and time. Note, however, that the statistics are only approximate, and
will change slightly each time <command>ANALYZE</command> is run, will change slightly each time <command>ANALYZE</command> is run,
even if the actual table contents did not change. This may result even if the actual table contents did not change. This might result
in small changes in the planner's estimated costs shown by in small changes in the planner's estimated costs shown by
<command>EXPLAIN</command>. In rare situations, this <command>EXPLAIN</command>. In rare situations, this
non-determinism will cause the query optimizer to choose a non-determinism will cause the query optimizer to choose a
@ -146,7 +146,7 @@ ANALYZE [ VERBOSE ] [ <replaceable class="PARAMETER">table</replaceable> [ (<rep
<command>ANALYZE</command> and the amount of space occupied in <command>ANALYZE</command> and the amount of space occupied in
<literal>pg_statistic</literal>. In particular, setting the <literal>pg_statistic</literal>. In particular, setting the
statistics target to zero disables collection of statistics for statistics target to zero disables collection of statistics for
that column. It may be useful to do that for columns that are that column. It might be useful to do that for columns that are
never used as part of the <literal>WHERE</>, <literal>GROUP BY</>, never used as part of the <literal>WHERE</>, <literal>GROUP BY</>,
or <literal>ORDER BY</> clauses of queries, since the planner will or <literal>ORDER BY</> clauses of queries, since the planner will
have no use for statistics on such columns. have no use for statistics on such columns.

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/begin.sgml,v 1.34 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/begin.sgml,v 1.35 2007/01/31 23:26:02 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -109,7 +109,7 @@ where <replaceable class="parameter">transaction_mode</replaceable> is one of:
<para> <para>
For reasons of backwards compatibility, the commas between successive For reasons of backwards compatibility, the commas between successive
<replaceable class="parameter">transaction_modes</replaceable> may be <replaceable class="parameter">transaction_modes</replaceable> can be
omitted. omitted.
</para> </para>
</refsect1> </refsect1>

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

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/checkpoint.sgml,v 1.14 2006/09/16 00:30:17 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/ref/checkpoint.sgml,v 1.15 2007/01/31 23:26:02 momjian Exp $ -->
<refentry id="sql-checkpoint"> <refentry id="sql-checkpoint">
<refmeta> <refmeta>
@ -42,7 +42,7 @@ CHECKPOINT
</para> </para>
<para> <para>
Only superusers may call <command>CHECKPOINT</command>. The command is Only superusers can call <command>CHECKPOINT</command>. The command is
not intended for use during normal operation. not intended for use during normal operation.
</para> </para>
</refsect1> </refsect1>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/cluster.sgml,v 1.38 2006/11/04 19:03:51 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/cluster.sgml,v 1.39 2007/01/31 23:26:02 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -132,7 +132,7 @@ CLUSTER
Because the planner records statistics about the ordering of Because the planner records statistics about the ordering of
tables, it is advisable to run <xref linkend="sql-analyze" tables, it is advisable to run <xref linkend="sql-analyze"
endterm="sql-analyze-title"> on the newly clustered table. endterm="sql-analyze-title"> on the newly clustered table.
Otherwise, the planner may make poor choices of query plans. Otherwise, the planner might make poor choices of query plans.
</para> </para>
<para> <para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/comment.sgml,v 1.34 2007/01/23 05:07:17 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/comment.sgml,v 1.35 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -93,7 +93,7 @@ COMMENT ON
<para> <para>
The name of the object to be commented. Names of tables, The name of the object to be commented. Names of tables,
aggregates, domains, functions, indexes, operators, operator classes, aggregates, domains, functions, indexes, operators, operator classes,
operator families, sequences, types, and views may be schema-qualified. operator families, sequences, types, and views can be schema-qualified.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/copy.sgml,v 1.77 2006/09/18 19:54:01 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/copy.sgml,v 1.78 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -358,9 +358,9 @@ COPY <replaceable class="parameter">count</replaceable>
should not lead to problems in the event of a <command>COPY should not lead to problems in the event of a <command>COPY
TO</command>, but the target table will already have received TO</command>, but the target table will already have received
earlier rows in a <command>COPY FROM</command>. These rows will not earlier rows in a <command>COPY FROM</command>. These rows will not
be visible or accessible, but they still occupy disk space. This may be visible or accessible, but they still occupy disk space. This might
amount to a considerable amount of wasted disk space if the failure amount to a considerable amount of wasted disk space if the failure
happened well into a large copy operation. You may wish to invoke happened well into a large copy operation. You might wish to invoke
<command>VACUUM</command> to recover the wasted space. <command>VACUUM</command> to recover the wasted space.
</para> </para>
</refsect1> </refsect1>
@ -395,7 +395,7 @@ COPY <replaceable class="parameter">count</replaceable>
</para> </para>
<para> <para>
Backslash characters (<literal>\</>) may be used in the Backslash characters (<literal>\</>) can be used in the
<command>COPY</command> data to quote data characters that might <command>COPY</command> data to quote data characters that might
otherwise be taken as row or column delimiters. In particular, the otherwise be taken as row or column delimiters. In particular, the
following characters <emphasis>must</> be preceded by a backslash if following characters <emphasis>must</> be preceded by a backslash if
@ -694,7 +694,7 @@ There is no alignment padding or any other extra data between fields.
<para> <para>
Presently, all data values in a <command>COPY BINARY</command> file are Presently, all data values in a <command>COPY BINARY</command> file are
assumed to be in binary format (format code one). It is anticipated that a assumed to be in binary format (format code one). It is anticipated that a
future extension may add a header field that allows per-column format codes future extension might add a header field that allows per-column format codes
to be specified. to be specified.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_aggregate.sgml,v 1.36 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_aggregate.sgml,v 1.37 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -96,7 +96,7 @@ CREATE AGGREGATE <replaceable class="PARAMETER">name</replaceable> (
</para> </para>
<para> <para>
An aggregate function may provide an initial condition, An aggregate function can provide an initial condition,
that is, an initial value for the internal state value. that is, an initial value for the internal state value.
This is specified and stored in the database as a value of type This is specified and stored in the database as a value of type
<type>text</type>, but it must be a valid external representation <type>text</type>, but it must be a valid external representation

12
doc/src/sgml/ref/create_cast.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/create_cast.sgml,v 1.23 2006/09/16 00:30:17 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/ref/create_cast.sgml,v 1.24 2007/01/31 23:26:03 momjian Exp $ -->
<refentry id="SQL-CREATECAST"> <refentry id="SQL-CREATECAST">
<refmeta> <refmeta>
@ -44,7 +44,7 @@ SELECT CAST(42 AS text);
</para> </para>
<para> <para>
Two types may be <firstterm>binary compatible</firstterm>, which Two types can be <firstterm>binary compatible</firstterm>, which
means that they can be converted into one another <quote>for means that they can be converted into one another <quote>for
free</quote> without invoking any function. This requires that free</quote> without invoking any function. This requires that
corresponding values use the same internal representation. For corresponding values use the same internal representation. For
@ -145,7 +145,7 @@ SELECT 'The time is ' || CAST(now() AS text);
<listitem> <listitem>
<para> <para>
The function used to perform the cast. The function name may The function used to perform the cast. The function name can
be schema-qualified. If it is not, the function will be looked be schema-qualified. If it is not, the function will be looked
up in the schema search path. The function's result data type must up in the schema search path. The function's result data type must
match the target type of the cast. Its arguments are discussed below. match the target type of the cast. Its arguments are discussed below.
@ -169,7 +169,7 @@ SELECT 'The time is ' || CAST(now() AS text);
<listitem> <listitem>
<para> <para>
Indicates that the cast may be invoked implicitly in assignment Indicates that the cast can be invoked implicitly in assignment
contexts. contexts.
</para> </para>
</listitem> </listitem>
@ -180,14 +180,14 @@ SELECT 'The time is ' || CAST(now() AS text);
<listitem> <listitem>
<para> <para>
Indicates that the cast may be invoked implicitly in any context. Indicates that the cast can be invoked implicitly in any context.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para> <para>
Cast implementation functions may have one to three arguments. Cast implementation functions can have one to three arguments.
The first argument type must be identical to the cast's source type. The first argument type must be identical to the cast's source type.
The second argument, The second argument,
if present, must be type <type>integer</>; it receives the type if present, must be type <type>integer</>; it receives the type

10
doc/src/sgml/ref/create_conversion.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/create_conversion.sgml,v 1.18 2006/09/16 00:30:17 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/ref/create_conversion.sgml,v 1.19 2007/01/31 23:26:03 momjian Exp $ -->
<refentry id="SQL-CREATECONVERSION"> <refentry id="SQL-CREATECONVERSION">
<refmeta> <refmeta>
@ -27,7 +27,7 @@ CREATE [ DEFAULT ] CONVERSION <replaceable>name</replaceable>
<para> <para>
<command>CREATE CONVERSION</command> defines a new conversion between <command>CREATE CONVERSION</command> defines a new conversion between
character set encodings. Conversion names may be used in the character set encodings. Conversion names can be used in the
<function>convert</function> function <function>convert</function> function
to specify a particular encoding conversion. Also, conversions that to specify a particular encoding conversion. Also, conversions that
are marked <literal>DEFAULT</> can be used for automatic encoding are marked <literal>DEFAULT</> can be used for automatic encoding
@ -65,7 +65,7 @@ CREATE [ DEFAULT ] CONVERSION <replaceable>name</replaceable>
<listitem> <listitem>
<para> <para>
The name of the conversion. The conversion name may be The name of the conversion. The conversion name can be
schema-qualified. If it is not, the conversion is defined in the schema-qualified. If it is not, the conversion is defined in the
current schema. The conversion name must be unique within a current schema. The conversion name must be unique within a
schema. schema.
@ -98,7 +98,7 @@ CREATE [ DEFAULT ] CONVERSION <replaceable>name</replaceable>
<listitem> <listitem>
<para> <para>
The function used to perform the conversion. The function name may The function used to perform the conversion. The function name can
be schema-qualified. If it is not, the function will be looked be schema-qualified. If it is not, the function will be looked
up in the path. up in the path.
</para> </para>
@ -129,7 +129,7 @@ conv_proc(
</para> </para>
<para> <para>
The privileges required to create a conversion may be changed in a future The privileges required to create a conversion might be changed in a future
release. release.
</para> </para>
</refsect1> </refsect1>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_database.sgml,v 1.46 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_database.sgml,v 1.47 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -60,7 +60,7 @@ CREATE DATABASE <replaceable class="PARAMETER">name</replaceable>
database containing only the standard objects predefined by your database containing only the standard objects predefined by your
version of <productname>PostgreSQL</productname>. This is useful version of <productname>PostgreSQL</productname>. This is useful
if you wish to avoid copying if you wish to avoid copying
any installation-local objects that may have been added to any installation-local objects that might have been added to
<literal>template1</>. <literal>template1</>.
</para> </para>
</refsect1> </refsect1>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.29 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.30 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -76,7 +76,7 @@ where <replaceable class="PARAMETER">constraint</replaceable> is:
<term><replaceable class="PARAMETER">data_type</replaceable></term> <term><replaceable class="PARAMETER">data_type</replaceable></term>
<listitem> <listitem>
<para> <para>
The underlying data type of the domain. This may include array The underlying data type of the domain. This can include array
specifiers. specifiers.
</para> </para>
</listitem> </listitem>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_function.sgml,v 1.71 2007/01/22 01:35:19 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_function.sgml,v 1.72 2007/01/31 23:26:03 momjian Exp $
--> -->
<refentry id="SQL-CREATEFUNCTION"> <refentry id="SQL-CREATEFUNCTION">
@ -49,7 +49,7 @@ CREATE [ OR REPLACE ] FUNCTION
specified schema. Otherwise it is created in the current schema. specified schema. Otherwise it is created in the current schema.
The name of the new function must not match any existing function The name of the new function must not match any existing function
with the same argument types in the same schema. However, with the same argument types in the same schema. However,
functions of different argument types may share a name (this is functions of different argument types can share a name (this is
called <firstterm>overloading</>). called <firstterm>overloading</>).
</para> </para>
@ -125,11 +125,11 @@ CREATE [ OR REPLACE ] FUNCTION
<listitem> <listitem>
<para> <para>
The data type(s) of the function's arguments (optionally The data type(s) of the function's arguments (optionally
schema-qualified), if any. The argument types may be base, composite, schema-qualified), if any. The argument types can be base, composite,
or domain types, or may reference the type of a table column. or domain types, or can reference the type of a table column.
</para> </para>
<para> <para>
Depending on the implementation language it may also be allowed Depending on the implementation language it might also be allowed
to specify <quote>pseudotypes</> such as <type>cstring</>. to specify <quote>pseudotypes</> such as <type>cstring</>.
Pseudotypes indicate that the actual argument type is either Pseudotypes indicate that the actual argument type is either
incompletely specified, or outside the set of ordinary SQL data types. incompletely specified, or outside the set of ordinary SQL data types.
@ -151,16 +151,16 @@ CREATE [ OR REPLACE ] FUNCTION
<listitem> <listitem>
<para> <para>
The return data type (optionally schema-qualified). The return type The return data type (optionally schema-qualified). The return type
may be a base, composite, or domain type, can be a base, composite, or domain type,
or may reference the type of a table column. or can reference the type of a table column.
Depending on the implementation language it may also be allowed Depending on the implementation language it might also be allowed
to specify <quote>pseudotypes</> such as <type>cstring</>. to specify <quote>pseudotypes</> such as <type>cstring</>.
If the function is not supposed to return a value, specify If the function is not supposed to return a value, specify
<type>void</> as the return type. <type>void</> as the return type.
</para> </para>
<para> <para>
When there are <literal>OUT</> or <literal>INOUT</> parameters, When there are <literal>OUT</> or <literal>INOUT</> parameters,
the <literal>RETURNS</> clause may be omitted. If present, it the <literal>RETURNS</> clause can be omitted. If present, it
must agree with the result type implied by the output parameters: must agree with the result type implied by the output parameters:
<literal>RECORD</> if there are multiple output parameters, or <literal>RECORD</> if there are multiple output parameters, or
the same type as the single output parameter. the same type as the single output parameter.
@ -185,10 +185,10 @@ CREATE [ OR REPLACE ] FUNCTION
<listitem> <listitem>
<para> <para>
The name of the language that the function is implemented in. The name of the language that the function is implemented in.
May be <literal>SQL</literal>, <literal>C</literal>, Can be <literal>SQL</literal>, <literal>C</literal>,
<literal>internal</literal>, or the name of a user-defined <literal>internal</literal>, or the name of a user-defined
procedural language. For backward compatibility, procedural language. For backward compatibility,
the name may be enclosed by single quotes. the name can be enclosed by single quotes.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -202,7 +202,7 @@ CREATE [ OR REPLACE ] FUNCTION
<para> <para>
These attributes inform the query optimizer about the behavior These attributes inform the query optimizer about the behavior
of the function. At most one choice of the function. At most one choice
may be specified. If none of these appear, can be specified. If none of these appear,
<literal>VOLATILE</literal> is the default assumption. <literal>VOLATILE</literal> is the default assumption.
</para> </para>
@ -326,7 +326,7 @@ CREATE [ OR REPLACE ] FUNCTION
<listitem> <listitem>
<para> <para>
A string constant defining the function; the meaning depends on the A string constant defining the function; the meaning depends on the
language. It may be an internal function name, the path to an language. It can be an internal function name, the path to an
object file, an SQL command, or text in a procedural language. object file, an SQL command, or text in a procedural language.
</para> </para>
</listitem> </listitem>
@ -357,7 +357,7 @@ CREATE [ OR REPLACE ] FUNCTION
<listitem> <listitem>
<para> <para>
The historical way to specify optional pieces of information The historical way to specify optional pieces of information
about the function. The following attributes may appear here: about the function. The following attributes can appear here:
<variablelist> <variablelist>
<varlistentry> <varlistentry>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_index.sgml,v 1.59 2007/01/09 02:14:10 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_index.sgml,v 1.60 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -75,7 +75,7 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] <replaceable class="parameter">name</re
</para> </para>
<para> <para>
The expression used in the <literal>WHERE</literal> clause may refer The expression used in the <literal>WHERE</literal> clause can refer
only to columns of the underlying table, but it can use all columns, only to columns of the underlying table, but it can use all columns,
not just the ones being indexed. Presently, subqueries and not just the ones being indexed. Presently, subqueries and
aggregate expressions are also forbidden in <literal>WHERE</literal>. aggregate expressions are also forbidden in <literal>WHERE</literal>.
@ -172,7 +172,7 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] <replaceable class="parameter">name</re
<para> <para>
An expression based on one or more columns of the table. The An expression based on one or more columns of the table. The
expression usually must be written with surrounding parentheses, expression usually must be written with surrounding parentheses,
as shown in the syntax. However, the parentheses may be omitted as shown in the syntax. However, the parentheses can be omitted
if the expression has the form of a function call. if the expression has the form of a function call.
</para> </para>
</listitem> </listitem>
@ -324,14 +324,14 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] <replaceable class="parameter">name</re
significantly longer to complete. However, since it allows normal significantly longer to complete. However, since it allows normal
operations to continue while the index is built, this method is useful for operations to continue while the index is built, this method is useful for
adding new indexes in a production environment. Of course, the extra CPU adding new indexes in a production environment. Of course, the extra CPU
and I/O load imposed by the index creation may slow other operations. and I/O load imposed by the index creation might slow other operations.
</para> </para>
<para> <para>
If a problem arises during the second scan of the table, such as a If a problem arises during the second scan of the table, such as a
uniqueness violation in a unique index, the <command>CREATE INDEX</> uniqueness violation in a unique index, the <command>CREATE INDEX</>
command will fail but leave behind an <quote>invalid</> index. This index command will fail but leave behind an <quote>invalid</> index. This index
will be ignored for querying purposes because it may be incomplete; will be ignored for querying purposes because it might be incomplete;
however it will still consume update overhead. The recommended recovery however it will still consume update overhead. The recommended recovery
method in such cases is to drop the index and try again to perform method in such cases is to drop the index and try again to perform
<command>CREATE INDEX CONCURRENTLY</>. (Another possibility is to rebuild <command>CREATE INDEX CONCURRENTLY</>. (Another possibility is to rebuild
@ -378,7 +378,7 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] <replaceable class="parameter">name</re
<para> <para>
Currently, only the B-tree and GiST index methods support Currently, only the B-tree and GiST index methods support
multicolumn indexes. Up to 32 fields may be specified by default. multicolumn indexes. Up to 32 fields can be specified by default.
(This limit can be altered when building (This limit can be altered when building
<productname>PostgreSQL</productname>.) Only B-tree currently <productname>PostgreSQL</productname>.) Only B-tree currently
supports unique indexes. supports unique indexes.

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_language.sgml,v 1.42 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_language.sgml,v 1.43 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -107,7 +107,7 @@ CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE <replaceable class="parameter">name</
</para> </para>
<para> <para>
For backward compatibility, the name may be enclosed by single For backward compatibility, the name can be enclosed by single
quotes. quotes.
</para> </para>
</listitem> </listitem>
@ -192,7 +192,7 @@ CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE <replaceable class="parameter">name</
To create functions in a procedural language, a user must have the To create functions in a procedural language, a user must have the
<literal>USAGE</literal> privilege for the language. By default, <literal>USAGE</literal> privilege for the language. By default,
<literal>USAGE</> is granted to <literal>PUBLIC</> (i.e., everyone) <literal>USAGE</> is granted to <literal>PUBLIC</> (i.e., everyone)
for trusted languages. This may be revoked if desired. for trusted languages. This can be revoked if desired.
</para> </para>
<para> <para>
@ -208,7 +208,7 @@ CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE <replaceable class="parameter">name</
in <structname>pg_pltemplate</>. But when there is an entry, in <structname>pg_pltemplate</>. But when there is an entry,
the functions need not already exist; the functions need not already exist;
they will be automatically defined if not present in the database. they will be automatically defined if not present in the database.
(This can result in <command>CREATE LANGUAGE</> failing, if the (This might result in <command>CREATE LANGUAGE</> failing, if the
shared library that implements the language is not available in shared library that implements the language is not available in
the installation.) the installation.)
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_opclass.sgml,v 1.19 2007/01/23 05:07:17 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_opclass.sgml,v 1.20 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -88,7 +88,7 @@ CREATE OPERATOR CLASS <replaceable class="parameter">name</replaceable> [ DEFAUL
<term><replaceable class="parameter">name</replaceable></term> <term><replaceable class="parameter">name</replaceable></term>
<listitem> <listitem>
<para> <para>
The name of the operator class to be created. The name may be The name of the operator class to be created. The name can be
schema-qualified. schema-qualified.
</para> </para>
</listitem> </listitem>
@ -161,7 +161,7 @@ CREATE OPERATOR CLASS <replaceable class="parameter">name</replaceable> [ DEFAUL
In an <literal>OPERATOR</> clause, In an <literal>OPERATOR</> clause,
the operand data type(s) of the operator, or <literal>NONE</> to the operand data type(s) of the operator, or <literal>NONE</> to
signify a left-unary or right-unary operator. The operand data signify a left-unary or right-unary operator. The operand data
types may be omitted in the normal case where they are the same types can be omitted in the normal case where they are the same
as the operator class's data type. as the operator class's data type.
</para> </para>
@ -236,7 +236,7 @@ CREATE OPERATOR CLASS <replaceable class="parameter">name</replaceable> [ DEFAUL
<para> <para>
The <literal>OPERATOR</>, <literal>FUNCTION</>, and <literal>STORAGE</> The <literal>OPERATOR</>, <literal>FUNCTION</>, and <literal>STORAGE</>
clauses may appear in any order. clauses can appear in any order.
</para> </para>
</refsect1> </refsect1>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.46 2006/12/23 00:43:08 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.47 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -108,7 +108,7 @@ CREATE OPERATOR <replaceable>name</replaceable> (
<listitem> <listitem>
<para> <para>
The name of the operator to be defined. See above for allowable The name of the operator to be defined. See above for allowable
characters. The name may be schema-qualified, for example characters. The name can be schema-qualified, for example
<literal>CREATE OPERATOR myschema.+ (...)</>. If not, then <literal>CREATE OPERATOR myschema.+ (...)</>. If not, then
the operator is created in the current schema. Two operators the operator is created in the current schema. Two operators
in the same schema can have the same name if they operate on in the same schema can have the same name if they operate on

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_opfamily.sgml,v 1.1 2007/01/23 05:07:17 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_opfamily.sgml,v 1.2 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -83,7 +83,7 @@ CREATE OPERATOR FAMILY <replaceable class="parameter">name</replaceable> USING <
<term><replaceable class="parameter">name</replaceable></term> <term><replaceable class="parameter">name</replaceable></term>
<listitem> <listitem>
<para> <para>
The name of the operator family to be created. The name may be The name of the operator family to be created. The name can be
schema-qualified. schema-qualified.
</para> </para>
</listitem> </listitem>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_role.sgml,v 1.8 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_role.sgml,v 1.9 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -217,7 +217,7 @@ where <replaceable class="PARAMETER">option</replaceable> can be:
</para> </para>
<para> <para>
Note that older clients may lack support for the MD5 Note that older clients might lack support for the MD5
authentication mechanism that is needed to work with passwords authentication mechanism that is needed to work with passwords
that are stored encrypted. that are stored encrypted.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.48 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.49 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -136,9 +136,9 @@ CREATE [ OR REPLACE ] RULE <replaceable class="parameter">name</replaceable> AS
<listitem> <listitem>
<para> <para>
Any <acronym>SQL</acronym> conditional expression (returning Any <acronym>SQL</acronym> conditional expression (returning
<type>boolean</type>). The condition expression may not refer <type>boolean</type>). The condition expression cannot refer
to any tables except <literal>NEW</> and <literal>OLD</>, and to any tables except <literal>NEW</> and <literal>OLD</>, and
may not contain aggregate functions. can not contain aggregate functions.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -186,7 +186,7 @@ CREATE [ OR REPLACE ] RULE <replaceable class="parameter">name</replaceable> AS
<para> <para>
Within <replaceable class="parameter">condition</replaceable> and Within <replaceable class="parameter">condition</replaceable> and
<replaceable class="parameter">command</replaceable>, the special <replaceable class="parameter">command</replaceable>, the special
table names <literal>NEW</literal> and <literal>OLD</literal> may table names <literal>NEW</literal> and <literal>OLD</literal> can
be used to refer to values in the referenced table. be used to refer to values in the referenced table.
<literal>NEW</literal> is valid in <literal>ON INSERT</literal> and <literal>NEW</literal> is valid in <literal>ON INSERT</literal> and
<literal>ON UPDATE</literal> rules to refer to the new row being <literal>ON UPDATE</literal> rules to refer to the new row being
@ -257,7 +257,7 @@ UPDATE mytable SET name = 'foo' WHERE id = 42;
one <command>NOTIFY</command> event will be sent during the one <command>NOTIFY</command> event will be sent during the
<command>UPDATE</command>, whether or not there are any rows that <command>UPDATE</command>, whether or not there are any rows that
match the condition <literal>id = 42</literal>. This is an match the condition <literal>id = 42</literal>. This is an
implementation restriction that may be fixed in future releases. implementation restriction that might be fixed in future releases.
</para> </para>
</refsect1> </refsect1>

10
doc/src/sgml/ref/create_schema.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_schema.sgml,v 1.18 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_schema.sgml,v 1.19 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -38,7 +38,7 @@ CREATE SCHEMA AUTHORIZATION <replaceable class="parameter">username</replaceable
<para> <para>
A schema is essentially a namespace: A schema is essentially a namespace:
it contains named objects (tables, data types, functions, and operators) it contains named objects (tables, data types, functions, and operators)
whose names may duplicate those of other objects existing in other whose names can duplicate those of other objects existing in other
schemas. Named objects are accessed either by <quote>qualifying</> schemas. Named objects are accessed either by <quote>qualifying</>
their names with the schema name as a prefix, or by setting a search their names with the schema name as a prefix, or by setting a search
path that includes the desired schema(s). A <literal>CREATE</> command path that includes the desired schema(s). A <literal>CREATE</> command
@ -78,7 +78,7 @@ CREATE SCHEMA AUTHORIZATION <replaceable class="parameter">username</replaceable
<para> <para>
The name of the user who will own the schema. If omitted, The name of the user who will own the schema. If omitted,
defaults to the user executing the command. Only superusers defaults to the user executing the command. Only superusers
may create schemas owned by users other than themselves. can create schemas owned by users other than themselves.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -163,9 +163,9 @@ CREATE VIEW hollywood.winners AS
<para> <para>
The SQL standard specifies that the subcommands in <command>CREATE The SQL standard specifies that the subcommands in <command>CREATE
SCHEMA</command> may appear in any order. The present SCHEMA</command> can appear in any order. The present
<productname>PostgreSQL</productname> implementation does not <productname>PostgreSQL</productname> implementation does not
handle all cases of forward references in subcommands; it may handle all cases of forward references in subcommands; it might
sometimes be necessary to reorder the subcommands in order to avoid sometimes be necessary to reorder the subcommands in order to avoid
forward references. forward references.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.45 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.46 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -41,7 +41,7 @@ CREATE [ TEMPORARY | TEMP ] SEQUENCE <replaceable class="parameter">name</replac
<para> <para>
If a schema name is given then the sequence is created in the If a schema name is given then the sequence is created in the
specified schema. Otherwise it is created in the current schema. specified schema. Otherwise it is created in the current schema.
Temporary sequences exist in a special schema, so a schema name may not be Temporary sequences exist in a special schema, so a schema name cannot be
given when creating a temporary sequence. given when creating a temporary sequence.
The sequence name must be distinct from the name of any other sequence, The sequence name must be distinct from the name of any other sequence,
table, index, or view in the same schema. table, index, or view in the same schema.
@ -65,7 +65,7 @@ SELECT * FROM <replaceable>name</replaceable>;
to examine the parameters and current state of a sequence. In particular, to examine the parameters and current state of a sequence. In particular,
the <literal>last_value</> field of the sequence shows the last value the <literal>last_value</> field of the sequence shows the last value
allocated by any session. (Of course, this value may be obsolete allocated by any session. (Of course, this value might be obsolete
by the time it's printed, if other sessions are actively doing by the time it's printed, if other sessions are actively doing
<function>nextval</> calls.) <function>nextval</> calls.)
</para> </para>
@ -224,13 +224,13 @@ SELECT * FROM <replaceable>name</replaceable>;
Sequences are based on <type>bigint</> arithmetic, so the range Sequences are based on <type>bigint</> arithmetic, so the range
cannot exceed the range of an eight-byte integer cannot exceed the range of an eight-byte integer
(-9223372036854775808 to 9223372036854775807). On some older (-9223372036854775808 to 9223372036854775807). On some older
platforms, there may be no compiler support for eight-byte platforms, there might be no compiler support for eight-byte
integers, in which case sequences use regular <type>integer</> integers, in which case sequences use regular <type>integer</>
arithmetic (range -2147483648 to +2147483647). arithmetic (range -2147483648 to +2147483647).
</para> </para>
<para> <para>
Unexpected results may be obtained if a <replaceable Unexpected results might be obtained if a <replaceable
class="parameter">cache</replaceable> setting greater than one is class="parameter">cache</replaceable> setting greater than one is
used for a sequence object that will be used concurrently by used for a sequence object that will be used concurrently by
multiple sessions. Each session will allocate and cache successive multiple sessions. Each session will allocate and cache successive
@ -246,7 +246,7 @@ SELECT * FROM <replaceable>name</replaceable>;
<para> <para>
Furthermore, although multiple sessions are guaranteed to allocate Furthermore, although multiple sessions are guaranteed to allocate
distinct sequence values, the values may be generated out of distinct sequence values, the values might be generated out of
sequence when all the sessions are considered. For example, with sequence when all the sessions are considered. For example, with
a <replaceable class="parameter">cache</replaceable> setting of 10, a <replaceable class="parameter">cache</replaceable> setting of 10,
session A might reserve values 1..10 and return session A might reserve values 1..10 and return

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.105 2006/09/16 00:30:17 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.106 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -74,7 +74,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
If a schema name is given (for example, <literal>CREATE TABLE If a schema name is given (for example, <literal>CREATE TABLE
myschema.mytable ...</>) then the table is created in the specified myschema.mytable ...</>) then the table is created in the specified
schema. Otherwise it is created in the current schema. Temporary schema. Otherwise it is created in the current schema. Temporary
tables exist in a special schema, so a schema name may not be given tables exist in a special schema, so a schema name cannot be given
when creating a temporary table. The name of the table must be when creating a temporary table. The name of the table must be
distinct from the name of any other table, sequence, index, or view distinct from the name of any other table, sequence, index, or view
in the same schema. in the same schema.
@ -156,7 +156,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
<term><replaceable class="PARAMETER">data_type</replaceable></term> <term><replaceable class="PARAMETER">data_type</replaceable></term>
<listitem> <listitem>
<para> <para>
The data type of the column. This may include array The data type of the column. This can include array
specifiers. For more information on the data types supported by specifiers. For more information on the data types supported by
<productname>PostgreSQL</productname>, refer to <xref <productname>PostgreSQL</productname>, refer to <xref
linkend="datatype">. linkend="datatype">.
@ -319,7 +319,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
<listitem> <listitem>
<para> <para>
The <literal>UNIQUE</literal> constraint specifies that a The <literal>UNIQUE</literal> constraint specifies that a
group of one or more columns of a table may contain group of one or more columns of a table can contain
only unique values. The behavior of the unique table constraint only unique values. The behavior of the unique table constraint
is the same as that for column constraints, with the additional is the same as that for column constraints, with the additional
capability to span multiple columns. capability to span multiple columns.
@ -345,13 +345,13 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
<listitem> <listitem>
<para> <para>
The primary key constraint specifies that a column or columns of a table The primary key constraint specifies that a column or columns of a table
may contain only unique (non-duplicate), nonnull values. can contain only unique (non-duplicate), nonnull values.
Technically, <literal>PRIMARY KEY</literal> is merely a Technically, <literal>PRIMARY KEY</literal> is merely a
combination of <literal>UNIQUE</> and <literal>NOT NULL</>, but combination of <literal>UNIQUE</> and <literal>NOT NULL</>, but
identifying a set of columns as primary key also provides identifying a set of columns as primary key also provides
metadata about the design of the schema, as a primary key metadata about the design of the schema, as a primary key
implies that other tables implies that other tables
may rely on this set of columns as a unique identifier for rows. can rely on this set of columns as a unique identifier for rows.
</para> </para>
<para> <para>
@ -379,7 +379,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
raised and the insert or update does not alter the database. A raised and the insert or update does not alter the database. A
check constraint specified as a column constraint should check constraint specified as a column constraint should
reference that column's value only, while an expression reference that column's value only, while an expression
appearing in a table constraint may reference multiple columns. appearing in a table constraint can reference multiple columns.
</para> </para>
<para> <para>
@ -412,7 +412,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
class="parameter">reftable</replaceable> is used. The class="parameter">reftable</replaceable> is used. The
referenced columns must be the columns of a unique or primary referenced columns must be the columns of a unique or primary
key constraint in the referenced table. Note that foreign key key constraint in the referenced table. Note that foreign key
constraints may not be defined between temporary tables and constraints cannot be defined between temporary tables and
permanent tables. permanent tables.
</para> </para>
@ -501,7 +501,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
</para> </para>
<para> <para>
If the referenced column(s) are changed frequently, it may be wise to If the referenced column(s) are changed frequently, it might be wise to
add an index to the foreign key column so that referential actions add an index to the foreign key column so that referential actions
associated with the foreign key column can be performed more associated with the foreign key column can be performed more
efficiently. efficiently.
@ -517,7 +517,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
This controls whether the constraint can be deferred. A This controls whether the constraint can be deferred. A
constraint that is not deferrable will be checked immediately constraint that is not deferrable will be checked immediately
after every command. Checking of constraints that are after every command. Checking of constraints that are
deferrable may be postponed until the end of the transaction deferrable can be postponed until the end of the transaction
(using the <xref linkend="sql-set-constraints" endterm="sql-set-constraints-title"> command). (using the <xref linkend="sql-set-constraints" endterm="sql-set-constraints-title"> command).
<literal>NOT DEFERRABLE</literal> is the default. Only foreign <literal>NOT DEFERRABLE</literal> is the default. Only foreign
key constraints currently accept this clause. All other key constraints currently accept this clause. All other
@ -1005,8 +1005,8 @@ CREATE TABLE cinemas (
<para> <para>
The SQL standard says that <literal>CHECK</> column constraints The SQL standard says that <literal>CHECK</> column constraints
may only refer to the column they apply to; only <literal>CHECK</> can only refer to the column they apply to; only <literal>CHECK</>
table constraints may refer to multiple columns. table constraints can refer to multiple columns.
<productname>PostgreSQL</productname> does not enforce this <productname>PostgreSQL</productname> does not enforce this
restriction; it treats column and table check constraints alike. restriction; it treats column and table check constraints alike.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_tablespace.sgml,v 1.7 2006/10/31 01:52:31 neilc Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_tablespace.sgml,v 1.8 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -36,7 +36,7 @@ CREATE TABLESPACE <replaceable class="parameter">tablespacename</replaceable> [
<para> <para>
A tablespace allows superusers to define an alternative location on A tablespace allows superusers to define an alternative location on
the file system where the data files containing database objects the file system where the data files containing database objects
(such as tables and indexes) may reside. (such as tables and indexes) can reside.
</para> </para>
<para> <para>
@ -69,7 +69,7 @@ CREATE TABLESPACE <replaceable class="parameter">tablespacename</replaceable> [
<para> <para>
The name of the user who will own the tablespace. If omitted, The name of the user who will own the tablespace. If omitted,
defaults to the user executing the command. Only superusers defaults to the user executing the command. Only superusers
may create tablespaces, but they can assign ownership of tablespaces can create tablespaces, but they can assign ownership of tablespaces
to non-superusers. to non-superusers.
</para> </para>
</listitem> </listitem>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.45 2006/10/23 18:10:32 petere Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.46 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -44,7 +44,7 @@ CREATE TRIGGER <replaceable class="PARAMETER">name</replaceable> { BEFORE | AFTE
completed (after constraints are checked and the completed (after constraints are checked and the
<command>INSERT</command>, <command>UPDATE</command>, or <command>INSERT</command>, <command>UPDATE</command>, or
<command>DELETE</command> has completed). If the trigger fires <command>DELETE</command> has completed). If the trigger fires
before the event, the trigger may skip the operation for the before the event, the trigger can skip the operation for the
current row, or change the row being inserted (for current row, or change the row being inserted (for
<command>INSERT</command> and <command>UPDATE</command> operations <command>INSERT</command> and <command>UPDATE</command> operations
only). If the trigger fires after the event, all changes, including only). If the trigger fires after the event, all changes, including
@ -160,10 +160,10 @@ CREATE TRIGGER <replaceable class="PARAMETER">name</replaceable> { BEFORE | AFTE
An optional comma-separated list of arguments to be provided to An optional comma-separated list of arguments to be provided to
the function when the trigger is executed. The arguments are the function when the trigger is executed. The arguments are
literal string constants. Simple names and numeric constants literal string constants. Simple names and numeric constants
may be written here, too, but they will all be converted to can be written here, too, but they will all be converted to
strings. Please check the description of the implementation strings. Please check the description of the implementation
language of the trigger function about how the trigger arguments language of the trigger function about how the trigger arguments
are accessible within the function; it may be different from are accessible within the function; it might be different from
normal function arguments. normal function arguments.
</para> </para>
</listitem> </listitem>

22
doc/src/sgml/ref/create_type.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_type.sgml,v 1.66 2006/12/30 21:21:52 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_type.sgml,v 1.67 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -82,7 +82,7 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
<para> <para>
The second form of <command>CREATE TYPE</command> creates a new base type The second form of <command>CREATE TYPE</command> creates a new base type
(scalar type). The parameters may appear in any order, not only that (scalar type). The parameters can appear in any order, not only that
illustrated above, and most are optional. You must register illustrated above, and most are optional. You must register
two or more functions (using <command>CREATE FUNCTION</command>) before two or more functions (using <command>CREATE FUNCTION</command>) before
defining the type. The support functions defining the type. The support functions
@ -103,7 +103,7 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
converts the type's external textual representation to the internal converts the type's external textual representation to the internal
representation used by the operators and functions defined for the type. representation used by the operators and functions defined for the type.
<replaceable class="parameter">output_function</replaceable> <replaceable class="parameter">output_function</replaceable>
performs the reverse transformation. The input function may be performs the reverse transformation. The input function can be
declared as taking one argument of type <type>cstring</type>, declared as taking one argument of type <type>cstring</type>,
or as taking three arguments of types or as taking three arguments of types
<type>cstring</type>, <type>oid</type>, <type>integer</type>. <type>cstring</type>, <type>oid</type>, <type>integer</type>.
@ -118,7 +118,7 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
input value. The function must still return NULL in this case, unless input value. The function must still return NULL in this case, unless
it raises an error. it raises an error.
(This case is mainly meant to support domain input functions, which (This case is mainly meant to support domain input functions, which
may need to reject NULL inputs.) might need to reject NULL inputs.)
The output function must be The output function must be
declared as taking one argument of the new data type. declared as taking one argument of the new data type.
The output function must return type <type>cstring</type>. The output function must return type <type>cstring</type>.
@ -136,7 +136,7 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
representation is in the machine's native byte order.) The receive representation is in the machine's native byte order.) The receive
function should perform adequate checking to ensure that the value is function should perform adequate checking to ensure that the value is
valid. valid.
The receive function may be declared as taking one argument of type The receive function can be declared as taking one argument of type
<type>internal</type>, or as taking three arguments of types <type>internal</type>, or as taking three arguments of types
<type>internal</type>, <type>oid</type>, <type>integer</type>. <type>internal</type>, <type>oid</type>, <type>integer</type>.
The first argument is a pointer to a <type>StringInfo</type> buffer The first argument is a pointer to a <type>StringInfo</type> buffer
@ -148,7 +148,7 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
input value. The function must still return NULL in this case, unless input value. The function must still return NULL in this case, unless
it raises an error. it raises an error.
(This case is mainly meant to support domain receive functions, which (This case is mainly meant to support domain receive functions, which
may need to reject NULL inputs.) might need to reject NULL inputs.)
Similarly, the optional Similarly, the optional
<replaceable class="parameter">send_function</replaceable> converts <replaceable class="parameter">send_function</replaceable> converts
from the internal representation to the external binary representation. from the internal representation to the external binary representation.
@ -234,7 +234,7 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
<para> <para>
The optional flag <literal>PASSEDBYVALUE</literal> indicates that The optional flag <literal>PASSEDBYVALUE</literal> indicates that
values of this data type are passed by value, rather than by values of this data type are passed by value, rather than by
reference. You may not pass by value types whose internal reference. You cannot pass by value types whose internal
representation is larger than the size of the <type>Datum</> type representation is larger than the size of the <type>Datum</> type
(4 bytes on most machines, 8 bytes on a few). (4 bytes on most machines, 8 bytes on a few).
</para> </para>
@ -260,17 +260,17 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
main table, but the system will not try to compress it. main table, but the system will not try to compress it.
<literal>main</literal> allows compression, but discourages moving <literal>main</literal> allows compression, but discourages moving
the value out of the main table. (Data items with this storage the value out of the main table. (Data items with this storage
strategy may still be moved out of the main table if there is no strategy might still be moved out of the main table if there is no
other way to make a row fit, but they will be kept in the main other way to make a row fit, but they will be kept in the main
table preferentially over <literal>extended</literal> and table preferentially over <literal>extended</literal> and
<literal>external</literal> items.) <literal>external</literal> items.)
</para> </para>
<para> <para>
A default value may be specified, in case a user wants columns of the A default value can be specified, in case a user wants columns of the
data type to default to something other than the null value. data type to default to something other than the null value.
Specify the default with the <literal>DEFAULT</literal> key word. Specify the default with the <literal>DEFAULT</literal> key word.
(Such a default may be overridden by an explicit <literal>DEFAULT</literal> (Such a default can be overridden by an explicit <literal>DEFAULT</literal>
clause attached to a particular column.) clause attached to a particular column.)
</para> </para>
@ -531,7 +531,7 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
the name of the new data type as the return type of the input function. the name of the new data type as the return type of the input function.
The shell type is implicitly created in this situation, and then it The shell type is implicitly created in this situation, and then it
can be referenced in the definitions of the remaining I/O functions. can be referenced in the definitions of the remaining I/O functions.
This approach still works, but is deprecated and may be disallowed in This approach still works, but is deprecated and might be disallowed in
some future release. Also, to avoid accidentally cluttering some future release. Also, to avoid accidentally cluttering
the catalogs with shell types as a result of simple typos in function the catalogs with shell types as a result of simple typos in function
definitions, a shell type will only be made this way when the input definitions, a shell type will only be made this way when the input

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_view.sgml,v 1.33 2006/09/18 19:54:01 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_view.sgml,v 1.34 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -45,7 +45,7 @@ CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW <replaceable class="PARAMETER">n
If a schema name is given (for example, <literal>CREATE VIEW If a schema name is given (for example, <literal>CREATE VIEW
myschema.myview ...</>) then the view is created in the specified myschema.myview ...</>) then the view is created in the specified
schema. Otherwise it is created in the current schema. Temporary schema. Otherwise it is created in the current schema. Temporary
views exist in a special schema, so a schema name may not be given views exist in a special schema, so a schema name cannot be given
when creating a temporary view. The name of the view must be when creating a temporary view. The name of the view must be
distinct from the name of any other view, table, sequence, or index distinct from the name of any other view, table, sequence, or index
in the same schema. in the same schema.

14
doc/src/sgml/ref/declare.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/declare.sgml,v 1.39 2006/09/18 19:54:01 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/declare.sgml,v 1.40 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -47,10 +47,10 @@ DECLARE <replaceable class="parameter">name</replaceable> [ BINARY ] [ INSENSITI
<command>SELECT</> would produce. Since data is stored natively in <command>SELECT</> would produce. Since data is stored natively in
binary format, the system must do a conversion to produce the text binary format, the system must do a conversion to produce the text
format. Once the information comes back in text form, the client format. Once the information comes back in text form, the client
application may need to convert it to a binary format to manipulate application might need to convert it to a binary format to manipulate
it. In addition, data in the text format is often larger in size it. In addition, data in the text format is often larger in size
than in the binary format. Binary cursors return the data in a than in the binary format. Binary cursors return the data in a
binary representation that may be more easily manipulated. binary representation that might be more easily manipulated.
Nevertheless, if you intend to display the data as text anyway, Nevertheless, if you intend to display the data as text anyway,
retrieving it in text form will retrieving it in text form will
save you some effort on the client side. save you some effort on the client side.
@ -123,10 +123,10 @@ DECLARE <replaceable class="parameter">name</replaceable> [ BINARY ] [ INSENSITI
<term><literal>NO SCROLL</literal></term> <term><literal>NO SCROLL</literal></term>
<listitem> <listitem>
<para> <para>
<literal>SCROLL</literal> specifies that the cursor may be used <literal>SCROLL</literal> specifies that the cursor can be used
to retrieve rows in a nonsequential fashion (e.g., to retrieve rows in a nonsequential fashion (e.g.,
backward). Depending upon the complexity of the query's backward). Depending upon the complexity of the query's
execution plan, specifying <literal>SCROLL</literal> may impose execution plan, specifying <literal>SCROLL</literal> might impose
a performance penalty on the query's execution time. a performance penalty on the query's execution time.
<literal>NO SCROLL</literal> specifies that the cursor cannot be <literal>NO SCROLL</literal> specifies that the cursor cannot be
used to retrieve rows in a nonsequential fashion. The default is to used to retrieve rows in a nonsequential fashion. The default is to
@ -142,7 +142,7 @@ DECLARE <replaceable class="parameter">name</replaceable> [ BINARY ] [ INSENSITI
<term><literal>WITHOUT HOLD</literal></term> <term><literal>WITHOUT HOLD</literal></term>
<listitem> <listitem>
<para> <para>
<literal>WITH HOLD</literal> specifies that the cursor may <literal>WITH HOLD</literal> specifies that the cursor can
continue to be used after the transaction that created it continue to be used after the transaction that created it
successfully commits. <literal>WITHOUT HOLD</literal> specifies successfully commits. <literal>WITHOUT HOLD</literal> specifies
that the cursor cannot be used outside of the transaction that that the cursor cannot be used outside of the transaction that
@ -195,7 +195,7 @@ DECLARE <replaceable class="parameter">name</replaceable> [ BINARY ] [ INSENSITI
<para> <para>
The key words <literal>BINARY</literal>, The key words <literal>BINARY</literal>,
<literal>INSENSITIVE</literal>, and <literal>SCROLL</literal> may <literal>INSENSITIVE</literal>, and <literal>SCROLL</literal> can
appear in any order. appear in any order.
</para> </para>
</refsect1> </refsect1>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/delete.sgml,v 1.28 2006/09/16 00:30:18 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/delete.sgml,v 1.29 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -146,7 +146,7 @@ DELETE FROM [ ONLY ] <replaceable class="PARAMETER">table</replaceable> [ [ AS ]
<listitem> <listitem>
<para> <para>
An expression to be computed and returned by the <command>DELETE</> An expression to be computed and returned by the <command>DELETE</>
command after each row is deleted. The expression may use any command after each row is deleted. The expression can use any
column names of the <replaceable class="PARAMETER">table</replaceable> column names of the <replaceable class="PARAMETER">table</replaceable>
or table(s) listed in <literal>USING</>. or table(s) listed in <literal>USING</>.
Write <literal>*</> to return all columns. Write <literal>*</> to return all columns.
@ -197,7 +197,7 @@ DELETE <replaceable class="parameter">count</replaceable>
<productname>PostgreSQL</productname> lets you reference columns of <productname>PostgreSQL</productname> lets you reference columns of
other tables in the <literal>WHERE</> condition by specifying the other tables in the <literal>WHERE</> condition by specifying the
other tables in the <literal>USING</literal> clause. For example, other tables in the <literal>USING</literal> clause. For example,
to delete all films produced by a given producer, one might do to delete all films produced by a given producer, one can do
<programlisting> <programlisting>
DELETE FROM films USING producers DELETE FROM films USING producers
WHERE producer_id = producers.id AND producers.name = 'foo'; WHERE producer_id = producers.id AND producers.name = 'foo';

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

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.10 2006/09/16 00:30:18 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.11 2007/01/31 23:26:03 momjian Exp $ -->
<refentry id="SQL-DROPCONVERSION"> <refentry id="SQL-DROPCONVERSION">
<refmeta> <refmeta>
@ -49,7 +49,7 @@ DROP CONVERSION [ IF EXISTS ] <replaceable>name</replaceable> [ CASCADE | RESTRI
<listitem> <listitem>
<para> <para>
The name of the conversion. The conversion name may be The name of the conversion. The conversion name can be
schema-qualified. schema-qualified.
</para> </para>
</listitem> </listitem>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_function.sgml,v 1.32 2006/09/16 00:30:18 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/drop_function.sgml,v 1.33 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -33,7 +33,7 @@ DROP FUNCTION [ IF EXISTS ] <replaceable class="parameter">name</replaceable> (
function. To execute this command the user must be the function. To execute this command the user must be the
owner of the function. The argument types to the owner of the function. The argument types to the
function must be specified, since several different functions function must be specified, since several different functions
may exist with the same name and different argument lists. can exist with the same name and different argument lists.
</para> </para>
</refsect1> </refsect1>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_language.sgml,v 1.23 2006/09/16 00:30:18 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/drop_language.sgml,v 1.24 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -54,7 +54,7 @@ DROP [ PROCEDURAL ] LANGUAGE [ IF EXISTS ] <replaceable class="PARAMETER">name</
<listitem> <listitem>
<para> <para>
The name of an existing procedural language. For backward The name of an existing procedural language. For backward
compatibility, the name may be enclosed by single quotes. compatibility, the name can be enclosed by single quotes.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_opclass.sgml,v 1.11 2007/01/23 05:07:17 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/drop_opclass.sgml,v 1.12 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -102,7 +102,7 @@ DROP OPERATOR CLASS [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceab
containing the class, even if there is nothing else left in the containing the class, even if there is nothing else left in the
family (in particular, in the case where the family was implicitly family (in particular, in the case where the family was implicitly
created by <command>CREATE OPERATOR CLASS</>). An empty operator created by <command>CREATE OPERATOR CLASS</>). An empty operator
family is harmless, but for the sake of tidiness you may wish to family is harmless, but for the sake of tidiness you might wish to
remove the family with <command>DROP OPERATOR FAMILY</>; or perhaps remove the family with <command>DROP OPERATOR FAMILY</>; or perhaps
better, use <command>DROP OPERATOR FAMILY</> in the first place. better, use <command>DROP OPERATOR FAMILY</> in the first place.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_owned.sgml,v 1.4 2006/09/18 21:19:29 neilc Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/drop_owned.sgml,v 1.5 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -81,7 +81,7 @@ DROP OWNED BY <replaceable class="PARAMETER">name</replaceable> [, ...] [ CASCAD
</para> </para>
<para> <para>
Using the <literal>CASCADE</literal> option may make the command Using the <literal>CASCADE</literal> option might make the command
recurse to objects owned by other users. recurse to objects owned by other users.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_table.sgml,v 1.25 2006/09/16 00:30:18 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/drop_table.sgml,v 1.26 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -29,7 +29,7 @@ DROP TABLE [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable> [, ..
<para> <para>
<command>DROP TABLE</command> removes tables from the database. <command>DROP TABLE</command> removes tables from the database.
Only its owner may destroy a table. To empty a table of rows Only its owner can destroy a table. To empty a table of rows
without destroying the table, use <xref linkend="sql-delete" without destroying the table, use <xref linkend="sql-delete"
endterm="sql-delete-title"> or <xref linkend="sql-truncate" endterm="sql-delete-title"> or <xref linkend="sql-truncate"
endterm="sql-truncate-title">. endterm="sql-truncate-title">.

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_tablespace.sgml,v 1.5 2006/10/31 01:52:31 neilc Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/drop_tablespace.sgml,v 1.6 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -34,7 +34,7 @@ DROP TABLESPACE [ IF EXISTS ] <replaceable class="PARAMETER">tablespacename</rep
<para> <para>
A tablespace can only be dropped by its owner or a superuser. A tablespace can only be dropped by its owner or a superuser.
The tablespace must be empty of all database objects before it can be The tablespace must be empty of all database objects before it can be
dropped. It is possible that objects in other databases may still reside dropped. It is possible that objects in other databases might still reside
in the tablespace even if no objects in the current database are using in the tablespace even if no objects in the current database are using
the tablespace. the tablespace.
</para> </para>

4
doc/src/sgml/ref/ecpg-ref.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/ecpg-ref.sgml,v 1.31 2006/09/16 00:30:18 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/ecpg-ref.sgml,v 1.32 2007/01/31 23:26:03 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -80,7 +80,7 @@ PostgreSQL documentation
<term><option>-C <replaceable>mode</replaceable></option></term> <term><option>-C <replaceable>mode</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Set a compatibility mode. <replaceable>mode</replaceable> may Set a compatibility mode. <replaceable>mode</replaceable> can
be <literal>INFORMIX</literal> or be <literal>INFORMIX</literal> or
<literal>INFORMIX_SE</literal>. <literal>INFORMIX_SE</literal>.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/explain.sgml,v 1.38 2006/09/18 19:54:01 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/explain.sgml,v 1.39 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -147,7 +147,7 @@ ROLLBACK;
distribution of the data in the table has changed significantly distribution of the data in the table has changed significantly
since the last time <command>ANALYZE</command> was run), the since the last time <command>ANALYZE</command> was run), the
estimated costs are unlikely to conform to the real properties of estimated costs are unlikely to conform to the real properties of
the query, and consequently an inferior query plan may be chosen. the query, and consequently an inferior query plan might be chosen.
</para> </para>
<para> <para>
@ -233,7 +233,7 @@ EXPLAIN ANALYZE EXECUTE query(100, 200);
<para> <para>
Of course, the specific numbers shown here depend on the actual Of course, the specific numbers shown here depend on the actual
contents of the tables involved. Also note that the numbers, and contents of the tables involved. Also note that the numbers, and
even the selected query strategy, may vary between even the selected query strategy, might vary between
<productname>PostgreSQL</productname> releases due to planner <productname>PostgreSQL</productname> releases due to planner
improvements. In addition, the <command>ANALYZE</command> command improvements. In addition, the <command>ANALYZE</command> command
uses random sampling to estimate data statistics; therefore, it is uses random sampling to estimate data statistics; therefore, it is

18
doc/src/sgml/ref/grant.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/grant.sgml,v 1.62 2006/09/16 00:30:18 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/grant.sgml,v 1.63 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -86,8 +86,8 @@ GRANT <replaceable class="PARAMETER">role</replaceable> [, ...] TO <replaceable
<para> <para>
The key word <literal>PUBLIC</literal> indicates that the The key word <literal>PUBLIC</literal> indicates that the
privileges are to be granted to all roles, including those that may privileges are to be granted to all roles, including those that might
be created later. <literal>PUBLIC</literal> may be thought of as an be created later. <literal>PUBLIC</literal> can be thought of as an
implicitly defined group that always includes all roles. implicitly defined group that always includes all roles.
Any particular role will have the sum Any particular role will have the sum
of privileges granted directly to it, privileges granted to any role it of privileges granted directly to it, privileges granted to any role it
@ -97,7 +97,7 @@ GRANT <replaceable class="PARAMETER">role</replaceable> [, ...] TO <replaceable
<para> <para>
If <literal>WITH GRANT OPTION</literal> is specified, the recipient If <literal>WITH GRANT OPTION</literal> is specified, the recipient
of the privilege may in turn grant it to others. Without a grant of the privilege can in turn grant it to others. Without a grant
option, the recipient cannot do that. Grant options cannot be granted option, the recipient cannot do that. Grant options cannot be granted
to <literal>PUBLIC</literal>. to <literal>PUBLIC</literal>.
</para> </para>
@ -114,17 +114,17 @@ GRANT <replaceable class="PARAMETER">role</replaceable> [, ...] TO <replaceable
</para> </para>
<para> <para>
Depending on the type of object, the initial default privileges may Depending on the type of object, the initial default privileges might
include granting some privileges to <literal>PUBLIC</literal>. include granting some privileges to <literal>PUBLIC</literal>.
The default is no public access for tables, schemas, and tablespaces; The default is no public access for tables, schemas, and tablespaces;
<literal>CONNECT</> privilege and <literal>TEMP</> table creation privilege <literal>CONNECT</> privilege and <literal>TEMP</> table creation privilege
for databases; for databases;
<literal>EXECUTE</> privilege for functions; and <literal>EXECUTE</> privilege for functions; and
<literal>USAGE</> privilege for languages. <literal>USAGE</> privilege for languages.
The object owner may of course revoke these privileges. (For maximum The object owner can of course revoke these privileges. (For maximum
security, issue the <command>REVOKE</> in the same transaction that security, issue the <command>REVOKE</> in the same transaction that
creates the object; then there is no window in which another user creates the object; then there is no window in which another user
may use the object.) can use the object.)
</para> </para>
<para> <para>
@ -306,7 +306,7 @@ GRANT <replaceable class="PARAMETER">role</replaceable> [, ...] TO <replaceable
</para> </para>
<para> <para>
If <literal>WITH ADMIN OPTION</literal> is specified, the member may If <literal>WITH ADMIN OPTION</literal> is specified, the member can
in turn grant membership in the role to others, and revoke membership in turn grant membership in the role to others, and revoke membership
in the role as well. Without the admin option, ordinary users cannot do in the role as well. Without the admin option, ordinary users cannot do
that. However, that. However,
@ -448,7 +448,7 @@ GRANT SELECT, UPDATE, INSERT ON mytable TO GROUP todos;
If the <quote>Access privileges</> column is empty for a given object, If the <quote>Access privileges</> column is empty for a given object,
it means the object has default privileges (that is, its privileges column it means the object has default privileges (that is, its privileges column
is null). Default privileges always include all privileges for the owner, is null). Default privileges always include all privileges for the owner,
and may include some privileges for <literal>PUBLIC</> depending on the and can include some privileges for <literal>PUBLIC</> depending on the
object type, as explained above. The first <command>GRANT</> or object type, as explained above. The first <command>GRANT</> or
<command>REVOKE</> on an object <command>REVOKE</> on an object
will instantiate the default privileges (producing, for example, will instantiate the default privileges (producing, for example,

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/initdb.sgml,v 1.38 2007/01/06 19:40:00 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/initdb.sgml,v 1.39 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -69,7 +69,7 @@ PostgreSQL documentation
<command>initdb</command> must be run as the user that will own the <command>initdb</command> must be run as the user that will own the
server process, because the server needs to have access to the server process, because the server needs to have access to the
files and directories that <command>initdb</command> creates. files and directories that <command>initdb</command> creates.
Since the server may not be run as root, you must not run Since the server cannot be run as root, you must not run
<command>initdb</command> as root either. (It will in fact refuse <command>initdb</command> as root either. (It will in fact refuse
to do so.) to do so.)
</para> </para>
@ -265,7 +265,7 @@ PostgreSQL documentation
<para> <para>
By default, when <command>initdb</command> By default, when <command>initdb</command>
determines that an error prevented it from completely creating the database determines that an error prevented it from completely creating the database
cluster, it removes any files it may have created before discovering cluster, it removes any files it might have created before discovering
that it can't finish the job. This option inhibits tidying-up and is that it can't finish the job. This option inhibits tidying-up and is
thus useful for debugging. thus useful for debugging.
</para> </para>
@ -286,7 +286,7 @@ PostgreSQL documentation
<listitem> <listitem>
<para> <para>
Specifies the directory where the database cluster is to be Specifies the directory where the database cluster is to be
stored; may be overridden using the <option>-D</option> option. stored; can be overridden using the <option>-D</option> option.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/insert.sgml,v 1.34 2006/10/23 18:10:32 petere Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/insert.sgml,v 1.35 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -36,7 +36,7 @@ INSERT INTO <replaceable class="PARAMETER">table</replaceable> [ ( <replaceable
</para> </para>
<para> <para>
The target column names may be listed in any order. If no list of The target column names can be listed in any order. If no list of
column names is given at all, the default is all the columns of the column names is given at all, the default is all the columns of the
table in their declared order; or the first <replaceable>N</> column table in their declared order; or the first <replaceable>N</> column
names, if there are only <replaceable>N</> columns supplied by the names, if there are only <replaceable>N</> columns supplied by the
@ -147,7 +147,7 @@ INSERT INTO <replaceable class="PARAMETER">table</replaceable> [ ( <replaceable
<listitem> <listitem>
<para> <para>
An expression to be computed and returned by the <command>INSERT</> An expression to be computed and returned by the <command>INSERT</>
command after each row is inserted. The expression may use any command after each row is inserted. The expression can use any
column names of the <replaceable class="PARAMETER">table</replaceable>. column names of the <replaceable class="PARAMETER">table</replaceable>.
Write <literal>*</> to return all columns of the inserted row(s). Write <literal>*</> to return all columns of the inserted row(s).
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/ipcclean.sgml,v 1.13 2006/09/16 00:30:18 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/ipcclean.sgml,v 1.14 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -61,8 +61,8 @@ PostgreSQL documentation
<para> <para>
The script makes assumptions about the output format of the The script makes assumptions about the output format of the
<command>ipcs</command> <command>ipcs</command>
utility which may not be true across different operating systems. utility which might not be true across different operating systems.
Therefore, it may not work on your particular OS. It's wise to Therefore, it might not work on your particular OS. It's wise to
look at the script before trying it. look at the script before trying it.
</para> </para>
</refsect1> </refsect1>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/load.sgml,v 1.23 2006/09/16 00:30:19 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/load.sgml,v 1.24 2007/01/31 23:26:04 momjian Exp $
--> -->
<refentry id="SQL-LOAD"> <refentry id="SQL-LOAD">
@ -40,7 +40,7 @@ LOAD '<replaceable class="PARAMETER">filename</replaceable>'
<para> <para>
The file name is specified in the same way as for shared library The file name is specified in the same way as for shared library
names in <xref linkend="sql-createfunction" endterm="sql-createfunction-title">; in particular, one names in <xref linkend="sql-createfunction" endterm="sql-createfunction-title">; in particular, one
may rely on a search path and automatic addition of the system's standard can rely on a search path and automatic addition of the system's standard
shared library file name extension. See <xref linkend="xfunc-c"> for shared library file name extension. See <xref linkend="xfunc-c"> for
more information on this topic. more information on this topic.
</para> </para>
@ -50,7 +50,7 @@ LOAD '<replaceable class="PARAMETER">filename</replaceable>'
</indexterm> </indexterm>
<para> <para>
Non-superusers may only apply <command>LOAD</> to library files Non-superusers can only apply <command>LOAD</> to library files
located in <filename>$libdir/plugins/</> &mdash; the specified located in <filename>$libdir/plugins/</> &mdash; the specified
<replaceable class="PARAMETER">filename</replaceable> must begin <replaceable class="PARAMETER">filename</replaceable> must begin
with exactly that string. (It is the database administrator's with exactly that string. (It is the database administrator's

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/notify.sgml,v 1.28 2006/09/16 00:30:19 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/notify.sgml,v 1.29 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -90,7 +90,7 @@ NOTIFY <replaceable class="PARAMETER">name</replaceable>
<para> <para>
<command>NOTIFY</command> behaves like Unix signals in one important <command>NOTIFY</command> behaves like Unix signals in one important
respect: if the same notification name is signaled multiple times in quick respect: if the same notification name is signaled multiple times in quick
succession, recipients may get only one notification event for several executions succession, recipients might get only one notification event for several executions
of <command>NOTIFY</command>. So it is a bad idea to depend on the number of <command>NOTIFY</command>. So it is a bad idea to depend on the number
of notifications received. Instead, use <command>NOTIFY</command> to wake up of notifications received. Instead, use <command>NOTIFY</command> to wake up
applications that need to pay attention to something, and use a database applications that need to pay attention to something, and use a database

4
doc/src/sgml/ref/pg_config-ref.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.25 2006/10/23 18:10:32 petere Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.26 2007/01/31 23:26:04 momjian Exp $ -->
<refentry id="app-pgconfig"> <refentry id="app-pgconfig">
<refmeta> <refmeta>
@ -106,7 +106,7 @@
<para> <para>
Print the location of dynamically loadable modules, or where Print the location of dynamically loadable modules, or where
the server would search for them. (Other the server would search for them. (Other
architecture-dependent data files may also be installed in this architecture-dependent data files might also be installed in this
directory.) directory.)
</para> </para>
</listitem> </listitem>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_controldata.sgml,v 1.8 2006/09/16 00:30:19 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_controldata.sgml,v 1.9 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -37,7 +37,7 @@ PostgreSQL documentation
</para> </para>
<para> <para>
This utility may only be run by the user who initialized the cluster because This utility can only be run by the user who initialized the cluster because
it requires read access to the data directory. it requires read access to the data directory.
You can specify the data directory on the command line, or use You can specify the data directory on the command line, or use
the environment variable <envar>PGDATA</>. the environment variable <envar>PGDATA</>.

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.37 2007/01/11 02:30:01 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.38 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -203,7 +203,7 @@ PostgreSQL documentation
<listitem> <listitem>
<para> <para>
Specifies the shutdown mode. <replaceable>mode</replaceable> Specifies the shutdown mode. <replaceable>mode</replaceable>
may be <literal>smart</literal>, <literal>fast</literal>, or can be <literal>smart</literal>, <literal>fast</literal>, or
<literal>immediate</literal>, or the first letter of one of <literal>immediate</literal>, or the first letter of one of
these three. these three.
</para> </para>
@ -425,7 +425,7 @@ PostgreSQL documentation
<title>Notes</title> <title>Notes</title>
<para> <para>
Waiting for complete start is not a well-defined operation and may Waiting for complete start is not a well-defined operation and might
fail if access control is set up so that a local client cannot fail if access control is set up so that a local client cannot
connect without manual interaction (e.g., password authentication). For connect without manual interaction (e.g., password authentication). For
additional connection variables, see <xref linkend="libpq-envars">, additional connection variables, see <xref linkend="libpq-envars">,

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.92 2006/11/28 22:54:18 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.93 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -120,7 +120,7 @@ PostgreSQL documentation
<para> <para>
This option is only meaningful for the plain-text format. For This option is only meaningful for the plain-text format. For
the archive formats, you may specify the option when you the archive formats, you can specify the option when you
call <command>pg_restore</command>. call <command>pg_restore</command>.
</para> </para>
</listitem> </listitem>
@ -150,7 +150,7 @@ PostgreSQL documentation
<para> <para>
This option is only meaningful for the plain-text format. For This option is only meaningful for the plain-text format. For
the archive formats, you may specify the option when you the archive formats, you can specify the option when you
call <command>pg_restore</command>. call <command>pg_restore</command>.
</para> </para>
</listitem> </listitem>
@ -169,7 +169,7 @@ PostgreSQL documentation
<para> <para>
This option is only meaningful for the plain-text format. For This option is only meaningful for the plain-text format. For
the archive formats, you may specify the option when you the archive formats, you can specify the option when you
call <command>pg_restore</command>. call <command>pg_restore</command>.
</para> </para>
</listitem> </listitem>
@ -188,7 +188,7 @@ PostgreSQL documentation
an error in reloading a row causes only that row to be lost rather an error in reloading a row causes only that row to be lost rather
than the entire table contents. than the entire table contents.
Note that Note that
the restore may fail altogether if you have rearranged column order. the restore might fail altogether if you have rearranged column order.
The <option>-D</option> option is safe against column order changes, The <option>-D</option> option is safe against column order changes,
though even slower. though even slower.
</para> </para>
@ -337,7 +337,7 @@ PostgreSQL documentation
<para> <para>
When <option>-n</> is specified, <application>pg_dump</application> When <option>-n</> is specified, <application>pg_dump</application>
makes no attempt to dump any other database objects that the selected makes no attempt to dump any other database objects that the selected
schema(s) may depend upon. Therefore, there is no guarantee schema(s) might depend upon. Therefore, there is no guarantee
that the results of a specific-schema dump can be successfully that the results of a specific-schema dump can be successfully
restored by themselves into a clean database. restored by themselves into a clean database.
</para> </para>
@ -410,7 +410,7 @@ PostgreSQL documentation
<para> <para>
This option is only meaningful for the plain-text format. For This option is only meaningful for the plain-text format. For
the archive formats, you may specify the option when you the archive formats, you can specify the option when you
call <command>pg_restore</command>. call <command>pg_restore</command>.
</para> </para>
</listitem> </listitem>
@ -478,7 +478,7 @@ PostgreSQL documentation
<para> <para>
When <option>-t</> is specified, <application>pg_dump</application> When <option>-t</> is specified, <application>pg_dump</application>
makes no attempt to dump any other database objects that the selected makes no attempt to dump any other database objects that the selected
table(s) may depend upon. Therefore, there is no guarantee table(s) might depend upon. Therefore, there is no guarantee
that the results of a specific-table dump can be successfully that the results of a specific-table dump can be successfully
restored by themselves into a clean database. restored by themselves into a clean database.
</para> </para>
@ -576,7 +576,7 @@ PostgreSQL documentation
<para> <para>
This option is only meaningful for the plain-text format. For This option is only meaningful for the plain-text format. For
the archive formats, you may specify the option when you the archive formats, you can specify the option when you
call <command>pg_restore</command>. call <command>pg_restore</command>.
</para> </para>
</listitem> </listitem>
@ -589,7 +589,7 @@ PostgreSQL documentation
Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands
instead of <command>ALTER OWNER</> commands to determine object instead of <command>ALTER OWNER</> commands to determine object
ownership. This makes the dump more standards compatible, but ownership. This makes the dump more standards compatible, but
depending on the history of the objects in the dump, may not restore depending on the history of the objects in the dump, might not restore
properly. Also, a dump using <command>SET SESSION AUTHORIZATION</> properly. Also, a dump using <command>SET SESSION AUTHORIZATION</>
will certainly require superuser privileges to restore correctly, will certainly require superuser privileges to restore correctly,
whereas <command>ALTER OWNER</> requires lesser privileges. whereas <command>ALTER OWNER</> requires lesser privileges.
@ -722,7 +722,7 @@ CREATE DATABASE foo WITH TEMPLATE template0;
<application>pg_dump</application> emits commands to disable <application>pg_dump</application> emits commands to disable
triggers on user tables before inserting the data and commands triggers on user tables before inserting the data and commands
to re-enable them after the data has been inserted. If the to re-enable them after the data has been inserted. If the
restore is stopped in the middle, the system catalogs may be restore is stopped in the middle, the system catalogs might be
left in the wrong state. left in the wrong state.
</para> </para>
</listitem> </listitem>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.63 2007/01/25 15:08:06 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.64 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -106,7 +106,7 @@ PostgreSQL documentation
than <command>COPY</command>). This will make restoration very slow; than <command>COPY</command>). This will make restoration very slow;
it is mainly useful for making dumps that can be loaded into it is mainly useful for making dumps that can be loaded into
non-<productname>PostgreSQL</productname> databases. Note that non-<productname>PostgreSQL</productname> databases. Note that
the restore may fail altogether if you have rearranged column order. the restore might fail altogether if you have rearranged column order.
The <option>-D</option> option is safer, though even slower. The <option>-D</option> option is safer, though even slower.
</para> </para>
</listitem> </listitem>
@ -309,7 +309,7 @@ PostgreSQL documentation
Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands
instead of <command>ALTER OWNER</> commands to determine object instead of <command>ALTER OWNER</> commands to determine object
ownership. This makes the dump more standards compatible, but ownership. This makes the dump more standards compatible, but
depending on the history of the objects in the dump, may not restore depending on the history of the objects in the dump, might not restore
properly. properly.
</para> </para>
</listitem> </listitem>

18
doc/src/sgml/ref/pg_resetxlog.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_resetxlog.sgml,v 1.19 2006/12/08 19:50:52 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_resetxlog.sgml,v 1.20 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -42,7 +42,7 @@ PostgreSQL documentation
<para> <para>
After running this command, it should be possible to start the server, After running this command, it should be possible to start the server,
but bear in mind that the database may contain inconsistent data due to but bear in mind that the database might contain inconsistent data due to
partially-committed transactions. You should immediately dump your data, partially-committed transactions. You should immediately dump your data,
run <command>initdb</>, and reload. After reload, check for run <command>initdb</>, and reload. After reload, check for
inconsistencies and repair as needed. inconsistencies and repair as needed.
@ -61,7 +61,7 @@ PostgreSQL documentation
valid data for <filename>pg_control</>, you can force it to proceed anyway valid data for <filename>pg_control</>, you can force it to proceed anyway
by specifying the <literal>-f</> (force) switch. In this case plausible by specifying the <literal>-f</> (force) switch. In this case plausible
values will be substituted for the missing data. Most of the fields can be values will be substituted for the missing data. Most of the fields can be
expected to match, but manual assistance may be needed for the next OID, expected to match, but manual assistance might be needed for the next OID,
next transaction ID and epoch, next multitransaction ID and offset, next transaction ID and epoch, next multitransaction ID and offset,
WAL starting address, and database locale fields. WAL starting address, and database locale fields.
The first six of these can be set using the switches discussed below. The first six of these can be set using the switches discussed below.
@ -84,14 +84,14 @@ PostgreSQL documentation
epoch, next multitransaction ID, next multitransaction offset, and WAL epoch, next multitransaction ID, next multitransaction offset, and WAL
starting address values to be set manually. These are only needed when starting address values to be set manually. These are only needed when
<command>pg_resetxlog</command> is unable to determine appropriate values <command>pg_resetxlog</command> is unable to determine appropriate values
by reading <filename>pg_control</>. Safe values may be determined as by reading <filename>pg_control</>. Safe values can be determined as
follows: follows:
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
A safe value for the next transaction ID (<literal>-x</>) A safe value for the next transaction ID (<literal>-x</>)
may be determined by looking for the numerically largest can be determined by looking for the numerically largest
file name in the directory <filename>pg_clog</> under the data directory, file name in the directory <filename>pg_clog</> under the data directory,
adding one, adding one,
and then multiplying by 1048576. Note that the file names are in and then multiplying by 1048576. Note that the file names are in
@ -105,7 +105,7 @@ PostgreSQL documentation
<listitem> <listitem>
<para> <para>
A safe value for the next multitransaction ID (<literal>-m</>) A safe value for the next multitransaction ID (<literal>-m</>)
may be determined by looking for the numerically largest can be determined by looking for the numerically largest
file name in the directory <filename>pg_multixact/offsets</> under the file name in the directory <filename>pg_multixact/offsets</> under the
data directory, adding one, and then multiplying by 65536. As above, data directory, adding one, and then multiplying by 65536. As above,
the file names are in hexadecimal, so the easiest way to do this is to the file names are in hexadecimal, so the easiest way to do this is to
@ -116,7 +116,7 @@ PostgreSQL documentation
<listitem> <listitem>
<para> <para>
A safe value for the next multitransaction offset (<literal>-O</>) A safe value for the next multitransaction offset (<literal>-O</>)
may be determined by looking for the numerically largest can be determined by looking for the numerically largest
file name in the directory <filename>pg_multixact/members</> under the file name in the directory <filename>pg_multixact/members</> under the
data directory, adding one, and then multiplying by 65536. As above, data directory, adding one, and then multiplying by 65536. As above,
the file names are in hexadecimal, so the easiest way to do this is to the file names are in hexadecimal, so the easiest way to do this is to
@ -179,7 +179,7 @@ PostgreSQL documentation
The <literal>-n</> (no operation) switch instructs The <literal>-n</> (no operation) switch instructs
<command>pg_resetxlog</command> to print the values reconstructed from <command>pg_resetxlog</command> to print the values reconstructed from
<filename>pg_control</> and then exit without modifying anything. <filename>pg_control</> and then exit without modifying anything.
This is mainly a debugging tool, but may be useful as a sanity check This is mainly a debugging tool, but can be useful as a sanity check
before allowing <command>pg_resetxlog</command> to proceed for real. before allowing <command>pg_resetxlog</command> to proceed for real.
</para> </para>
</refsect1> </refsect1>
@ -191,7 +191,7 @@ PostgreSQL documentation
This command must not be used when the server is This command must not be used when the server is
running. <command>pg_resetxlog</command> will refuse to start up if running. <command>pg_resetxlog</command> will refuse to start up if
it finds a server lock file in the data directory. If the it finds a server lock file in the data directory. If the
server crashed then a lock file may have been left server crashed then a lock file might have been left
behind; in that case you can remove the lock file to allow behind; in that case you can remove the lock file to allow
<command>pg_resetxlog</command> to run. But before you do <command>pg_resetxlog</command> to run. But before you do
so, make doubly certain that there is no server process still alive. so, make doubly certain that there is no server process still alive.

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

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.64 2006/11/26 18:11:11 tgl Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.65 2007/01/31 23:26:04 momjian Exp $ -->
<refentry id="APP-PGRESTORE"> <refentry id="APP-PGRESTORE">
<refmeta> <refmeta>
@ -233,7 +233,7 @@
<para> <para>
Restore elements in <replaceable class="PARAMETER"> Restore elements in <replaceable class="PARAMETER">
list-file</replaceable> only, and in the list-file</replaceable> only, and in the
order they appear in the file. Lines can be moved and may also order they appear in the file. Lines can be moved and can also
be commented out by placing a <literal>;</literal> at the be commented out by placing a <literal>;</literal> at the
start of the line. (See below for examples.) start of the line. (See below for examples.)
</para> </para>
@ -389,7 +389,7 @@
Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands
instead of <command>ALTER OWNER</> commands to determine object instead of <command>ALTER OWNER</> commands to determine object
ownership. This makes the dump more standards compatible, but ownership. This makes the dump more standards compatible, but
depending on the history of the objects in the dump, may not restore depending on the history of the objects in the dump, might not restore
properly. properly.
</para> </para>
</listitem> </listitem>
@ -402,10 +402,10 @@
By default, table data is restored even if the creation command By default, table data is restored even if the creation command
for the table failed (e.g., because it already exists). for the table failed (e.g., because it already exists).
With this option, data for such a table is skipped. With this option, data for such a table is skipped.
This behavior is useful when the target database may already This behavior is useful if the target database already
contain the desired table contents. For example, contains the desired table contents. For example,
auxiliary tables for <productname>PostgreSQL</> extensions auxiliary tables for <productname>PostgreSQL</> extensions
such as <productname>PostGIS</> may already be loaded in such as <productname>PostGIS</> might already be loaded in
the target database; specifying this option prevents duplicate the target database; specifying this option prevents duplicate
or obsolete data from being loaded into them. or obsolete data from being loaded into them.
</para> </para>
@ -549,7 +549,7 @@ CREATE DATABASE foo WITH TEMPLATE template0;
<application>pg_restore</application> emits commands <application>pg_restore</application> emits commands
to disable triggers on user tables before inserting the data then emits commands to to disable triggers on user tables before inserting the data then emits commands to
re-enable them after the data has been inserted. If the restore is stopped in the re-enable them after the data has been inserted. If the restore is stopped in the
middle, the system catalogs may be left in the wrong state. middle, the system catalogs might be left in the wrong state.
</para> </para>
</listitem> </listitem>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/postgres-ref.sgml,v 1.48 2007/01/04 00:57:51 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/postgres-ref.sgml,v 1.49 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -354,13 +354,13 @@ PostgreSQL documentation
<title>Semi-internal Options</title> <title>Semi-internal Options</title>
<para> <para>
There are several other options that may be specified, used There are several other options that can be specified, used
mainly for debugging purposes and in some cases to assist with mainly for debugging purposes and in some cases to assist with
recovery of severely damaged databases. There should be no reason recovery of severely damaged databases. There should be no reason
to use them in a production database setup. These are listed to use them in a production database setup. These are listed
here only for the use by <productname>PostgreSQL</productname> here only for the use by <productname>PostgreSQL</productname>
system developers. Furthermore, any of these options may system developers. Furthermore, these options might
disappear or change in a future release without notice. change or be removed in a future release without notice.
</para> </para>
<variablelist> <variablelist>
@ -559,7 +559,7 @@ PostgreSQL documentation
<listitem> <listitem>
<para> <para>
Default character encoding used by clients. (The clients may Default character encoding used by clients. (The clients can
override this individually.) This value can also be set in the override this individually.) This value can also be set in the
configuration file. configuration file.
</para> </para>
@ -617,7 +617,7 @@ PostgreSQL documentation
A failure message mentioning <literal>semget</> or A failure message mentioning <literal>semget</> or
<literal>shmget</> probably indicates you need to configure your <literal>shmget</> probably indicates you need to configure your
kernel to provide adequate shared memory and semaphores. For more kernel to provide adequate shared memory and semaphores. For more
discussion see <xref linkend="kernel-resources">. You may be able discussion see <xref linkend="kernel-resources">. You might be able
to postpone reconfiguring your kernel by decreasing <xref to postpone reconfiguring your kernel by decreasing <xref
linkend="guc-shared-buffers"> to reduce the shared memory linkend="guc-shared-buffers"> to reduce the shared memory
consumption of <productname>PostgreSQL</>, and/or by reducing consumption of <productname>PostgreSQL</>, and/or by reducing
@ -636,18 +636,18 @@ PostgreSQL documentation
<prompt>$</prompt> <userinput>ps -ef | grep postgres</userinput> <prompt>$</prompt> <userinput>ps -ef | grep postgres</userinput>
</screen> </screen>
depending on your system. If you are certain that no conflicting depending on your system. If you are certain that no conflicting
server is running, you may remove the lock file mentioned in the server is running, you can remove the lock file mentioned in the
message and try again. message and try again.
</para> </para>
<para> <para>
A failure message indicating inability to bind to a port may A failure message indicating inability to bind to a port might
indicate that that port is already in use by some indicate that that port is already in use by some
non-<productname>PostgreSQL</productname> process. You may also non-<productname>PostgreSQL</productname> process. You might also
get this error if you terminate <command>postgres</command> get this error if you terminate <command>postgres</command>
and immediately restart it using the same port; in this case, you and immediately restart it using the same port; in this case, you
must simply wait a few seconds until the operating system closes must simply wait a few seconds until the operating system closes
the port before trying again. Finally, you may get this error if the port before trying again. Finally, you might get this error if
you specify a port number that your operating system considers to you specify a port number that your operating system considers to
be reserved. For example, many versions of Unix consider port be reserved. For example, many versions of Unix consider port
numbers under 1024 to be <quote>trusted</quote> and only permit numbers under 1024 to be <quote>trusted</quote> and only permit
@ -665,7 +665,7 @@ PostgreSQL documentation
<command>postgres</command> server. Doing so will prevent <command>postgres</command> server. Doing so will prevent
<command>postgres</command> from freeing the system <command>postgres</command> from freeing the system
resources (e.g., shared memory and semaphores) that it holds before resources (e.g., shared memory and semaphores) that it holds before
terminating. This may cause problems for starting a fresh terminating. This might cause problems for starting a fresh
<command>postgres</command> run. <command>postgres</command> run.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/prepare.sgml,v 1.21 2006/09/18 19:54:01 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/prepare.sgml,v 1.22 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -138,7 +138,7 @@ PREPARE <replaceable class="PARAMETER">name</replaceable> [ (<replaceable class=
constant values in a statement to make guesses about the likely constant values in a statement to make guesses about the likely
result of executing the statement. Since this data is unavailable result of executing the statement. Since this data is unavailable
when planning prepared statements with parameters, the chosen plan when planning prepared statements with parameters, the chosen plan
may be suboptimal. To examine the query plan might be suboptimal. To examine the query plan
<productname>PostgreSQL</productname> has chosen for a prepared <productname>PostgreSQL</productname> has chosen for a prepared
statement, use <xref linkend="sql-explain" statement, use <xref linkend="sql-explain"
endterm="sql-explain-title">. endterm="sql-explain-title">.

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.180 2007/01/20 16:57:31 neilc Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.181 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -601,7 +601,7 @@ testdb=&gt;
</para> </para>
<para> <para>
At the prompt, the user may type in <acronym>SQL</acronym> commands. At the prompt, the user can type in <acronym>SQL</acronym> commands.
Ordinarily, input lines are sent to the server when a Ordinarily, input lines are sent to the server when a
command-terminating semicolon is reached. An end of line does not command-terminating semicolon is reached. An end of line does not
terminate a command. Thus commands can be spread over several lines for terminate a command. Thus commands can be spread over several lines for
@ -638,7 +638,7 @@ testdb=&gt;
</para> </para>
<para> <para>
To include whitespace into an argument you may quote it with a To include whitespace into an argument you can quote it with a
single quote. To include a single quote into such an argument, single quote. To include a single quote into such an argument,
use two single quotes. Anything contained in single quotes is use two single quotes. Anything contained in single quotes is
furthermore subject to C-like substitutions for furthermore subject to C-like substitutions for
@ -819,7 +819,7 @@ testdb=&gt;
This operation is not as efficient as the <acronym>SQL</acronym> This operation is not as efficient as the <acronym>SQL</acronym>
<command>COPY</command> command because all data must pass <command>COPY</command> command because all data must pass
through the client/server connection. For large through the client/server connection. For large
amounts of data the <acronym>SQL</acronym> command may be preferable. amounts of data the <acronym>SQL</acronym> command might be preferable.
</para> </para>
</tip> </tip>
@ -1172,7 +1172,7 @@ Tue Oct 26 21:40:57 CEST 1999
<tip> <tip>
<para> <para>
If you use the <command>\o</command> command to redirect your If you use the <command>\o</command> command to redirect your
query output you may wish to use <command>\qecho</command> query output you might wish to use <command>\qecho</command>
instead of this command. instead of this command.
</para> </para>
</tip> </tip>
@ -1566,8 +1566,8 @@ lo_import 152801
<term><literal>tuples_only</literal> (or <literal>t</literal>)</term> <term><literal>tuples_only</literal> (or <literal>t</literal>)</term>
<listitem> <listitem>
<para> <para>
Toggles between tuples only and full display. Full display may Toggles between tuples only and full display. Full display
show extra information such as column headers, titles, and shows extra information such as column headers, titles, and
various footers. In tuples only mode, only actual table data various footers. In tuples only mode, only actual table data
is shown. is shown.
</para> </para>
@ -2022,7 +2022,7 @@ bar
<para> <para>
The autocommit-on mode is <productname>PostgreSQL</>'s traditional The autocommit-on mode is <productname>PostgreSQL</>'s traditional
behavior, but autocommit-off is closer to the SQL spec. If you behavior, but autocommit-off is closer to the SQL spec. If you
prefer autocommit-off, you may wish to set it in the system-wide prefer autocommit-off, you might wish to set it in the system-wide
<filename>psqlrc</filename> file or your <filename>psqlrc</filename> file or your
<filename>~/.psqlrc</filename> file. <filename>~/.psqlrc</filename> file.
</para> </para>
@ -2093,7 +2093,7 @@ bar
limited amount of memory is used, regardless of the size of limited amount of memory is used, regardless of the size of
the result set. Settings of 100 to 1000 are commonly used the result set. Settings of 100 to 1000 are commonly used
when enabling this feature. when enabling this feature.
Keep in mind that when using this feature, a query may Keep in mind that when using this feature, a query might
fail after having already displayed some rows. fail after having already displayed some rows.
</para> </para>
<tip> <tip>
@ -2387,7 +2387,7 @@ testdb=&gt; <userinput>\set content '''' `sed -e "s/'/''/g" -e 's/\\/\\\\/g' &lt
</para> </para>
<para> <para>
Since colons may legally appear in SQL commands, the following rule Since colons can legally appear in SQL commands, the following rule
applies: the character sequence applies: the character sequence
<quote>:name</quote> is not changed unless <quote>name</> is the name <quote>:name</quote> is not changed unless <quote>name</> is the name
of a variable that is currently set. In any case you can escape of a variable that is currently set. In any case you can escape
@ -2559,13 +2559,13 @@ testdb=&gt; <userinput>\set content '''' `sed -e "s/'/''/g" -e 's/\\/\\\\/g' &lt
<term><literal>%[</literal> ... <literal>%]</literal></term> <term><literal>%[</literal> ... <literal>%]</literal></term>
<listitem> <listitem>
<para> <para>
Prompts may contain terminal control characters which, for Prompts can contain terminal control characters which, for
example, change the color, background, or style of the prompt example, change the color, background, or style of the prompt
text, or change the title of the terminal window. In order for text, or change the title of the terminal window. In order for
the line editing features of <application>Readline</application> to work properly, these the line editing features of <application>Readline</application> to work properly, these
non-printing control characters must be designated as invisible non-printing control characters must be designated as invisible
by surrounding them with <literal>%[</literal> and by surrounding them with <literal>%[</literal> and
<literal>%]</literal>. Multiple pairs of these may occur within <literal>%]</literal>. Multiple pairs of these can occur within
the prompt. For example, the prompt. For example,
<programlisting> <programlisting>
testdb=&gt; \set PROMPT1 '%[%033[1;33;40m%]%n@%/%R%[%033[0m%]%# ' testdb=&gt; \set PROMPT1 '%[%033[1;33;40m%]%n@%/%R%[%033[0m%]%# '

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/reindex.sgml,v 1.35 2007/01/05 01:18:59 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/reindex.sgml,v 1.36 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -37,7 +37,7 @@ REINDEX { INDEX | TABLE | DATABASE | SYSTEM } <replaceable class="PARAMETER">nam
<para> <para>
An index has become corrupted, and no longer contains valid An index has become corrupted, and no longer contains valid
data. Although in theory this should never happen, in data. Although in theory this should never happen, in
practice indexes may become corrupted due to software bugs or practice indexes can become corrupted due to software bugs or
hardware failures. <command>REINDEX</command> provides a hardware failures. <command>REINDEX</command> provides a
recovery method. recovery method.
</para> </para>
@ -130,7 +130,7 @@ REINDEX { INDEX | TABLE | DATABASE | SYSTEM } <replaceable class="PARAMETER">nam
<listitem> <listitem>
<para> <para>
The name of the specific index, table, or database to be The name of the specific index, table, or database to be
reindexed. Index and table names may be schema-qualified. reindexed. Index and table names can be schema-qualified.
Presently, <command>REINDEX DATABASE</> and <command>REINDEX SYSTEM</> Presently, <command>REINDEX DATABASE</> and <command>REINDEX SYSTEM</>
can only reindex the current database, so their parameter must match can only reindex the current database, so their parameter must match
the current database's name. the current database's name.
@ -162,7 +162,7 @@ REINDEX { INDEX | TABLE | DATABASE | SYSTEM } <replaceable class="PARAMETER">nam
Things are more difficult if you need to recover from corruption of Things are more difficult if you need to recover from corruption of
an index on a system table. In this case it's important for the an index on a system table. In this case it's important for the
system to not have used any of the suspect indexes itself. system to not have used any of the suspect indexes itself.
(Indeed, in this sort of scenario you may find that server (Indeed, in this sort of scenario you might find that server
processes are crashing immediately at start-up, due to reliance on processes are crashing immediately at start-up, due to reliance on
the corrupted indexes.) To recover safely, the server must be started the corrupted indexes.) To recover safely, the server must be started
with the <option>-P</option> option, which prevents it from using with the <option>-P</option> option, which prevents it from using
@ -191,7 +191,7 @@ REINDEX { INDEX | TABLE | DATABASE | SYSTEM } <replaceable class="PARAMETER">nam
<application>libpq</>-based clients, it is possible to set <application>libpq</>-based clients, it is possible to set
the <envar>PGOPTIONS</envar> environment variable to <literal>-P</> the <envar>PGOPTIONS</envar> environment variable to <literal>-P</>
before starting the client. Note that while this method does not before starting the client. Note that while this method does not
require locking out other clients, it may still be wise to prevent require locking out other clients, it might still be wise to prevent
other users from connecting to the damaged database until repairs other users from connecting to the damaged database until repairs
have been completed. have been completed.
</para> </para>
@ -230,7 +230,7 @@ REINDEX { INDEX | TABLE | DATABASE | SYSTEM } <replaceable class="PARAMETER">nam
exclusive lock on the parent table, blocking both writes and reads. The exclusive lock on the parent table, blocking both writes and reads. The
subsequent <command>CREATE INDEX</> locks out writes but not reads; since subsequent <command>CREATE INDEX</> locks out writes but not reads; since
the index is not there, no read will attempt to use it, meaning that there the index is not there, no read will attempt to use it, meaning that there
will be no blocking but reads may be forced into expensive sequential will be no blocking but reads might be forced into expensive sequential
scans. Another important point is that the drop/create approach scans. Another important point is that the drop/create approach
invalidates any cached query plans that use the index, while invalidates any cached query plans that use the index, while
<command>REINDEX</> does not. <command>REINDEX</> does not.

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/release_savepoint.sgml,v 1.6 2006/09/16 00:30:19 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/release_savepoint.sgml,v 1.7 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -43,7 +43,7 @@ RELEASE [ SAVEPOINT ] <replaceable>savepoint_name</replaceable>
effects of commands executed after the savepoint was established. effects of commands executed after the savepoint was established.
(To do that, see <xref linkend="sql-rollback-to" (To do that, see <xref linkend="sql-rollback-to"
endterm="sql-rollback-to-title">.) Destroying a savepoint when endterm="sql-rollback-to-title">.) Destroying a savepoint when
it is no longer needed may allow the system to reclaim some resources it is no longer needed allows the system to reclaim some resources
earlier than transaction end. earlier than transaction end.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/revoke.sgml,v 1.41 2006/09/16 00:30:19 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/revoke.sgml,v 1.42 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -111,7 +111,7 @@ REVOKE [ ADMIN OPTION FOR ]
will fail. This recursive revocation only affects privileges that will fail. This recursive revocation only affects privileges that
were granted through a chain of users that is traceable to the user were granted through a chain of users that is traceable to the user
that is the subject of this <literal>REVOKE</literal> command. that is the subject of this <literal>REVOKE</literal> command.
Thus, the affected users may effectively keep the privilege if it Thus, the affected users might effectively keep the privilege if it
was also granted through other users. was also granted through other users.
</para> </para>
@ -163,7 +163,7 @@ REVOKE [ ADMIN OPTION FOR ]
command, the command is performed as though it were issued by the command, the command is performed as though it were issued by the
owner of the affected object. Since all privileges ultimately come owner of the affected object. Since all privileges ultimately come
from the object owner (possibly indirectly via chains of grant options), from the object owner (possibly indirectly via chains of grant options),
it is possible for a superuser to revoke all privileges, but this may it is possible for a superuser to revoke all privileges, but this might
require use of <literal>CASCADE</literal> as stated above. require use of <literal>CASCADE</literal> as stated above.
</para> </para>
@ -187,7 +187,7 @@ REVOKE [ ADMIN OPTION FOR ]
indirectly via more than one role membership path, it is unspecified indirectly via more than one role membership path, it is unspecified
which containing role will be used to perform the command. In such cases which containing role will be used to perform the command. In such cases
it is best practice to use <command>SET ROLE</> to become the specific it is best practice to use <command>SET ROLE</> to become the specific
role you want to do the <command>REVOKE</> as. Failure to do so may role you want to do the <command>REVOKE</> as. Failure to do so might
lead to revoking privileges other than the ones you intended, or not lead to revoking privileges other than the ones you intended, or not
revoking anything at all. revoking anything at all.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/select.sgml,v 1.96 2007/01/09 16:59:20 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/select.sgml,v 1.97 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -242,7 +242,7 @@ where <replaceable class="parameter">from_item</replaceable> can be one of:
result sets, but any function can be used.) This acts as result sets, but any function can be used.) This acts as
though its output were created as a temporary table for the though its output were created as a temporary table for the
duration of this single <command>SELECT</command> command. An duration of this single <command>SELECT</command> command. An
alias may also be used. If an alias is written, a column alias alias can also be used. If an alias is written, a column alias
list can also be written to provide substitute names for one list can also be written to provide substitute names for one
or more attributes of the function's composite return type. If or more attributes of the function's composite return type. If
the function has been defined as returning the <type>record</> the function has been defined as returning the <type>record</>
@ -287,7 +287,7 @@ where <replaceable class="parameter">from_item</replaceable> can be one of:
<literal>USING (<replaceable <literal>USING (<replaceable
class="parameter">join_column</replaceable> [, ...])</literal>. class="parameter">join_column</replaceable> [, ...])</literal>.
See below for the meaning. For <literal>CROSS JOIN</literal>, See below for the meaning. For <literal>CROSS JOIN</literal>,
none of these clauses may appear. none of these clauses can appear.
</para> </para>
<para> <para>
@ -542,7 +542,7 @@ HAVING <replaceable class="parameter">condition</replaceable>
</para> </para>
<para> <para>
Currently, <literal>FOR UPDATE</> and <literal>FOR SHARE</> may not be Currently, <literal>FOR UPDATE</> and <literal>FOR SHARE</> cannot be
specified either for a <literal>UNION</> result or for any input of a specified either for a <literal>UNION</> result or for any input of a
<literal>UNION</>. <literal>UNION</>.
</para> </para>
@ -588,7 +588,7 @@ HAVING <replaceable class="parameter">condition</replaceable>
</para> </para>
<para> <para>
Currently, <literal>FOR UPDATE</> and <literal>FOR SHARE</> may not be Currently, <literal>FOR UPDATE</> and <literal>FOR SHARE</> cannot be
specified either for an <literal>INTERSECT</> result or for any input of specified either for an <literal>INTERSECT</> result or for any input of
an <literal>INTERSECT</>. an <literal>INTERSECT</>.
</para> </para>
@ -630,7 +630,7 @@ HAVING <replaceable class="parameter">condition</replaceable>
</para> </para>
<para> <para>
Currently, <literal>FOR UPDATE</> and <literal>FOR SHARE</> may not be Currently, <literal>FOR UPDATE</> and <literal>FOR SHARE</> cannot be
specified either for an <literal>EXCEPT</> result or for any input of specified either for an <literal>EXCEPT</> result or for any input of
an <literal>EXCEPT</>. an <literal>EXCEPT</>.
</para> </para>
@ -678,7 +678,7 @@ SELECT name FROM distributors ORDER BY code;
</programlisting> </programlisting>
A limitation of this feature is that an <literal>ORDER BY</> A limitation of this feature is that an <literal>ORDER BY</>
clause applying to the result of a <literal>UNION</>, clause applying to the result of a <literal>UNION</>,
<literal>INTERSECT</>, or <literal>EXCEPT</> clause may only <literal>INTERSECT</>, or <literal>EXCEPT</> clause can only
specify an output column name or number, not an expression. specify an output column name or number, not an expression.
</para> </para>
@ -692,11 +692,11 @@ SELECT name FROM distributors ORDER BY code;
</para> </para>
<para> <para>
Optionally one may add the key word <literal>ASC</> (ascending) or Optionally one can add the key word <literal>ASC</> (ascending) or
<literal>DESC</> (descending) after any expression in the <literal>DESC</> (descending) after any expression in the
<literal>ORDER BY</> clause. If not specified, <literal>ASC</> is <literal>ORDER BY</> clause. If not specified, <literal>ASC</> is
assumed by default. Alternatively, a specific ordering operator assumed by default. Alternatively, a specific ordering operator
name may be specified in the <literal>USING</> clause. name can be specified in the <literal>USING</> clause.
An ordering operator must be a less-than or greater-than An ordering operator must be a less-than or greater-than
member of some btree operator family. member of some btree operator family.
<literal>ASC</> is usually equivalent to <literal>USING &lt;</> and <literal>ASC</> is usually equivalent to <literal>USING &lt;</> and
@ -792,7 +792,7 @@ OFFSET <replaceable class="parameter">start</replaceable>
When using <literal>LIMIT</>, it is a good idea to use an When using <literal>LIMIT</>, it is a good idea to use an
<literal>ORDER BY</> clause that constrains the result rows into a <literal>ORDER BY</> clause that constrains the result rows into a
unique order. Otherwise you will get an unpredictable subset of unique order. Otherwise you will get an unpredictable subset of
the query's rows &mdash; you may be asking for the tenth through the query's rows &mdash; you might be asking for the tenth through
twentieth rows, but tenth through twentieth in what ordering? You twentieth rows, but tenth through twentieth in what ordering? You
don't know what ordering unless you specify <literal>ORDER BY</>. don't know what ordering unless you specify <literal>ORDER BY</>.
</para> </para>
@ -1144,9 +1144,9 @@ SELECT distributors.* WHERE distributors.name = 'Westward';
<title>Namespace Available to <literal>GROUP BY</literal> and <literal>ORDER BY</literal></title> <title>Namespace Available to <literal>GROUP BY</literal> and <literal>ORDER BY</literal></title>
<para> <para>
In the SQL-92 standard, an <literal>ORDER BY</literal> clause may In the SQL-92 standard, an <literal>ORDER BY</literal> clause can
only use result column names or numbers, while a <literal>GROUP only use result column names or numbers, while a <literal>GROUP
BY</literal> clause may only use expressions based on input column BY</literal> clause can only use expressions based on input column
names. <productname>PostgreSQL</productname> extends each of names. <productname>PostgreSQL</productname> extends each of
these clauses to allow the other choice as well (but it uses the these clauses to allow the other choice as well (but it uses the
standard's interpretation if there is ambiguity). standard's interpretation if there is ambiguity).

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/set_role.sgml,v 1.3 2006/09/16 00:30:20 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/set_role.sgml,v 1.4 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -32,7 +32,7 @@ RESET ROLE
<para> <para>
This command sets the current user This command sets the current user
identifier of the current SQL-session context to be <replaceable identifier of the current SQL-session context to be <replaceable
class="parameter">rolename</replaceable>. The role name may be class="parameter">rolename</replaceable>. The role name can be
written as either an identifier or a string literal. written as either an identifier or a string literal.
After <command>SET ROLE</>, permissions checking for SQL commands After <command>SET ROLE</>, permissions checking for SQL commands
is carried out as though the named role were the one that had logged is carried out as though the named role were the one that had logged
@ -54,7 +54,7 @@ RESET ROLE
<para> <para>
The <literal>NONE</> and <literal>RESET</> forms reset the current The <literal>NONE</> and <literal>RESET</> forms reset the current
user identifier to be the current session user identifier. user identifier to be the current session user identifier.
These forms may be executed by any user. These forms can be executed by any user.
</para> </para>
</refsect1> </refsect1>

10
doc/src/sgml/ref/set_session_auth.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/set_session_auth.sgml,v 1.15 2006/09/16 00:30:20 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/ref/set_session_auth.sgml,v 1.16 2007/01/31 23:26:04 momjian Exp $ -->
<refentry id="SQL-SET-SESSION-AUTHORIZATION"> <refentry id="SQL-SET-SESSION-AUTHORIZATION">
<refmeta> <refmeta>
<refentrytitle id="sql-set-session-authorization-title">SET SESSION AUTHORIZATION</refentrytitle> <refentrytitle id="sql-set-session-authorization-title">SET SESSION AUTHORIZATION</refentrytitle>
@ -28,7 +28,7 @@ RESET SESSION AUTHORIZATION
<para> <para>
This command sets the session user identifier and the current user This command sets the session user identifier and the current user
identifier of the current SQL-session context to be <replaceable identifier of the current SQL-session context to be <replaceable
class="parameter">username</replaceable>. The user name may be class="parameter">username</replaceable>. The user name can be
written as either an identifier or a string literal. Using this written as either an identifier or a string literal. Using this
command, it is possible, for example, to temporarily become an command, it is possible, for example, to temporarily become an
unprivileged user and later switch back to being a superuser. unprivileged user and later switch back to being a superuser.
@ -38,14 +38,14 @@ RESET SESSION AUTHORIZATION
The session user identifier is initially set to be the (possibly The session user identifier is initially set to be the (possibly
authenticated) user name provided by the client. The current user authenticated) user name provided by the client. The current user
identifier is normally equal to the session user identifier, but identifier is normally equal to the session user identifier, but
may change temporarily in the context of <quote>setuid</quote> might change temporarily in the context of <quote>setuid</quote>
functions and similar mechanisms; it can also be changed by functions and similar mechanisms; it can also be changed by
<xref linkend="sql-set-role" endterm="sql-set-role-title">. <xref linkend="sql-set-role" endterm="sql-set-role-title">.
The current user identifier is relevant for permission checking. The current user identifier is relevant for permission checking.
</para> </para>
<para> <para>
The session user identifier may be changed only if the initial session The session user identifier can be changed only if the initial session
user (the <firstterm>authenticated user</firstterm>) had the user (the <firstterm>authenticated user</firstterm>) had the
superuser privilege. Otherwise, the command is accepted only if it superuser privilege. Otherwise, the command is accepted only if it
specifies the authenticated user name. specifies the authenticated user name.
@ -60,7 +60,7 @@ RESET SESSION AUTHORIZATION
<para> <para>
The <literal>DEFAULT</> and <literal>RESET</> forms reset the session The <literal>DEFAULT</> and <literal>RESET</> forms reset the session
and current user identifiers to be the originally authenticated user and current user identifiers to be the originally authenticated user
name. These forms may be executed by any user. name. These forms can be executed by any user.
</para> </para>
</refsect1> </refsect1>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/start_transaction.sgml,v 1.15 2006/09/16 00:30:20 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/start_transaction.sgml,v 1.16 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -61,7 +61,7 @@ where <replaceable class="parameter">transaction_mode</replaceable> is one of:
issuing a <command>COMMIT</command> after each command that does not issuing a <command>COMMIT</command> after each command that does not
follow <command>START TRANSACTION</> (or <command>BEGIN</command>), follow <command>START TRANSACTION</> (or <command>BEGIN</command>),
and it is therefore often called <quote>autocommit</>. and it is therefore often called <quote>autocommit</>.
Other relational database systems may offer an autocommit feature Other relational database systems might offer an autocommit feature
as a convenience. as a convenience.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/truncate.sgml,v 1.21 2006/09/16 00:30:20 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/truncate.sgml,v 1.22 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -75,7 +75,7 @@ TRUNCATE [ TABLE ] <replaceable class="PARAMETER">name</replaceable> [, ...] [ C
<title>Notes</title> <title>Notes</title>
<para> <para>
Only the owner of a table may <command>TRUNCATE</> it. Only the owner of a table can <command>TRUNCATE</> it.
</para> </para>
<para> <para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/unlisten.sgml,v 1.28 2006/09/16 00:30:20 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/unlisten.sgml,v 1.29 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -74,7 +74,7 @@ UNLISTEN { <replaceable class="PARAMETER">name</replaceable> | * }
<title>Notes</title> <title>Notes</title>
<para> <para>
You may unlisten something you were not listening for; no warning or error You can unlisten something you were not listening for; no warning or error
will appear. will appear.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/update.sgml,v 1.41 2006/09/16 00:30:20 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/update.sgml,v 1.42 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -117,7 +117,7 @@ UPDATE [ ONLY ] <replaceable class="PARAMETER">table</replaceable> [ [ AS ] <rep
<term><replaceable class="PARAMETER">expression</replaceable></term> <term><replaceable class="PARAMETER">expression</replaceable></term>
<listitem> <listitem>
<para> <para>
An expression to assign to the column. The expression may use the An expression to assign to the column. The expression can use the
old values of this and other columns in the table. old values of this and other columns in the table.
</para> </para>
</listitem> </listitem>
@ -165,7 +165,7 @@ UPDATE [ ONLY ] <replaceable class="PARAMETER">table</replaceable> [ [ AS ] <rep
<listitem> <listitem>
<para> <para>
An expression to be computed and returned by the <command>UPDATE</> An expression to be computed and returned by the <command>UPDATE</>
command after each row is updated. The expression may use any command after each row is updated. The expression can use any
column names of the <replaceable class="PARAMETER">table</replaceable> column names of the <replaceable class="PARAMETER">table</replaceable>
or table(s) listed in <literal>FROM</>. or table(s) listed in <literal>FROM</>.
Write <literal>*</> to return all columns. Write <literal>*</> to return all columns.

10
doc/src/sgml/ref/vacuum.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.46 2007/01/31 04:13:22 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.47 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -72,7 +72,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] ANALYZE [ <replaceable class="PARAMETER">
<term><literal>FULL</literal></term> <term><literal>FULL</literal></term>
<listitem> <listitem>
<para> <para>
Selects <quote>full</quote> vacuum, which may reclaim more Selects <quote>full</quote> vacuum, which can reclaim more
space, but takes much longer and exclusively locks the table. space, but takes much longer and exclusively locks the table.
</para> </para>
</listitem> </listitem>
@ -153,7 +153,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] ANALYZE [ <replaceable class="PARAMETER">
We recommend that active production databases be We recommend that active production databases be
vacuumed frequently (at least nightly), in order to vacuumed frequently (at least nightly), in order to
remove dead rows. After adding or deleting a large number remove dead rows. After adding or deleting a large number
of rows, it may be a good idea to issue a <command>VACUUM of rows, it might be a good idea to issue a <command>VACUUM
ANALYZE</command> command for the affected table. This will update the ANALYZE</command> command for the affected table. This will update the
system catalogs with system catalogs with
the results of all recent changes, and allow the the results of all recent changes, and allow the
@ -163,7 +163,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] ANALYZE [ <replaceable class="PARAMETER">
<para> <para>
The <option>FULL</option> option is not recommended for routine use, The <option>FULL</option> option is not recommended for routine use,
but may be useful in special cases. An example is when you have deleted but might be useful in special cases. An example is when you have deleted
most of the rows in a table and would like the table to physically shrink most of the rows in a table and would like the table to physically shrink
to occupy less disk space. <command>VACUUM FULL</command> will usually to occupy less disk space. <command>VACUUM FULL</command> will usually
shrink the table more than a plain <command>VACUUM</command> would. shrink the table more than a plain <command>VACUUM</command> would.
@ -174,7 +174,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] ANALYZE [ <replaceable class="PARAMETER">
<para> <para>
<command>VACUUM</command> causes a substantial increase in I/O traffic, <command>VACUUM</command> causes a substantial increase in I/O traffic,
which can cause poor performance for other active sessions. Therefore, which might cause poor performance for other active sessions. Therefore,
it is sometimes advisable to use the cost-based vacuum delay feature. it is sometimes advisable to use the cost-based vacuum delay feature.
See <xref linkend="runtime-config-resource-vacuum-cost"> for details. See <xref linkend="runtime-config-resource-vacuum-cost"> for details.
</para> </para>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/vacuumdb.sgml,v 1.37 2006/09/16 00:30:20 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/vacuumdb.sgml,v 1.38 2007/01/31 23:26:04 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -130,7 +130,7 @@ PostgreSQL documentation
<listitem> <listitem>
<para> <para>
Clean or analyze <replaceable class="parameter">table</replaceable> only. Clean or analyze <replaceable class="parameter">table</replaceable> only.
Column names may be specified only in conjunction with Column names can be specified only in conjunction with
the <option>--analyze</option> option. the <option>--analyze</option> option.
</para> </para>
<tip> <tip>

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/values.sgml,v 1.2 2006/10/23 18:10:32 petere Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/values.sgml,v 1.3 2007/01/31 23:26:05 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -78,7 +78,7 @@ VALUES ( <replaceable class="PARAMETER">expression</replaceable> [, ...] ) [, ..
<listitem> <listitem>
<para> <para>
An expression or integer constant indicating how to sort the result An expression or integer constant indicating how to sort the result
rows. This expression may refer to the columns of the rows. This expression can refer to the columns of the
<command>VALUES</> result as <literal>column1</>, <literal>column2</>, <command>VALUES</> result as <literal>column1</>, <literal>column2</>,
etc. For more details see etc. For more details see
<xref linkend="sql-orderby" endterm="sql-orderby-title">. <xref linkend="sql-orderby" endterm="sql-orderby-title">.
@ -124,7 +124,7 @@ VALUES ( <replaceable class="PARAMETER">expression</replaceable> [, ...] ) [, ..
<para> <para>
<command>VALUES</> lists with very large numbers of rows should be avoided, <command>VALUES</> lists with very large numbers of rows should be avoided,
as you may encounter out-of-memory failures or poor performance. as you might encounter out-of-memory failures or poor performance.
<command>VALUES</> appearing within <command>INSERT</> is a special case <command>VALUES</> appearing within <command>INSERT</> is a special case
(because the desired column types are known from the <command>INSERT</>'s (because the desired column types are known from the <command>INSERT</>'s
target table, and need not be inferred by scanning the <command>VALUES</> target table, and need not be inferred by scanning the <command>VALUES</>
@ -203,7 +203,7 @@ UPDATE employees SET salary = salary * v.increase
<para> <para>
When <command>VALUES</> is used in <command>INSERT</>, the values are all When <command>VALUES</> is used in <command>INSERT</>, the values are all
automatically coerced to the data type of the corresponding destination automatically coerced to the data type of the corresponding destination
column. When it's used in other contexts, it may be necessary to specify column. When it's used in other contexts, it might be necessary to specify
the correct data type. If the entries are all quoted literal constants, the correct data type. If the entries are all quoted literal constants,
coercing the first is sufficient to determine the assumed type for all: coercing the first is sufficient to determine the assumed type for all: