From b524cb36ac2526049fe7978cadc28fca647f9b70 Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Tue, 1 Nov 2005 21:09:51 +0000
Subject: [PATCH] Make an editorial pass over the reference pages.
---
doc/src/sgml/maintenance.sgml | 5 +--
doc/src/sgml/ref/alter_domain.sgml | 5 +--
doc/src/sgml/ref/alter_function.sgml | 12 +++----
doc/src/sgml/ref/alter_sequence.sgml | 5 +--
doc/src/sgml/ref/create_cast.sgml | 7 ++--
doc/src/sgml/ref/create_domain.sgml | 14 +++++---
doc/src/sgml/ref/create_function.sgml | 16 ++++-----
doc/src/sgml/ref/create_sequence.sgml | 6 ++--
doc/src/sgml/ref/create_table.sgml | 19 +++++------
doc/src/sgml/ref/create_table_as.sgml | 43 +++++++++++++++++--------
doc/src/sgml/ref/create_trigger.sgml | 14 ++++----
doc/src/sgml/ref/create_type.sgml | 6 ++--
doc/src/sgml/ref/create_view.sgml | 17 +++++-----
doc/src/sgml/ref/createuser.sgml | 5 ++-
doc/src/sgml/ref/delete.sgml | 22 ++++++++++---
doc/src/sgml/ref/drop_sequence.sgml | 6 ++--
doc/src/sgml/ref/pg_config-ref.sgml | 7 ++--
doc/src/sgml/ref/pg_dump.sgml | 34 ++++++++++---------
doc/src/sgml/ref/pg_dumpall.sgml | 11 ++++---
doc/src/sgml/ref/pg_restore.sgml | 23 +++++++------
doc/src/sgml/ref/psql-ref.sgml | 16 +++++----
doc/src/sgml/ref/release_savepoint.sgml | 4 +--
doc/src/sgml/ref/rollback_to.sgml | 8 ++---
doc/src/sgml/ref/select.sgml | 10 +++---
doc/src/sgml/ref/vacuum.sgml | 14 ++++----
doc/src/sgml/release.sgml | 16 +++++----
26 files changed, 200 insertions(+), 145 deletions(-)
diff --git a/doc/src/sgml/maintenance.sgml b/doc/src/sgml/maintenance.sgml
index 672d740930e..452c4163455 100644
--- a/doc/src/sgml/maintenance.sgml
+++ b/doc/src/sgml/maintenance.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.49 2005/10/21 19:39:08 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.50 2005/11/01 21:09:49 tgl Exp $
-->
<chapter id="maintenance">
@@ -586,7 +586,8 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu
<para>
In some situations it is worthwhile to rebuild indexes periodically
- with the <command>REINDEX</> command.
+ with the <xref linkend="sql-reindex" endterm="sql-reindex-title">
+ command.
</para>
<para>
diff --git a/doc/src/sgml/ref/alter_domain.sgml b/doc/src/sgml/ref/alter_domain.sgml
index f3ed88c9e27..9913e2efb92 100644
--- a/doc/src/sgml/ref/alter_domain.sgml
+++ b/doc/src/sgml/ref/alter_domain.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.18 2005/10/13 22:44:51 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.19 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -237,7 +237,8 @@ ALTER DOMAIN zipcode SET SCHEMA customers;
<title>Compatibility</title>
<para>
- <command>ALTER DOMAIN</command> conforms with <acronym>SQL:2003</acronym>,
+ <command>ALTER DOMAIN</command> conforms to the <acronym>SQL</acronym>
+ standard,
except for the <literal>OWNER</> and <literal>SET SCHEMA</> variants,
which are <productname>PostgreSQL</productname> extensions.
</para>
diff --git a/doc/src/sgml/ref/alter_function.sgml b/doc/src/sgml/ref/alter_function.sgml
index a3dd38d2d4a..3f05216c078 100644
--- a/doc/src/sgml/ref/alter_function.sgml
+++ b/doc/src/sgml/ref/alter_function.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_function.sgml,v 1.9 2005/10/13 22:44:51 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_function.sgml,v 1.10 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -149,8 +149,9 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<literal>CALLED ON NULL INPUT</literal> changes the function so
that it will be invoked when some or all of its arguments are
null. <literal>RETURNS NULL ON NULL INPUT</literal> or
- <literal>STRICT</literal> changes the function so that it
- always returns null if any of its arguments are null. See <xref
+ <literal>STRICT</literal> changes the function so that it is not
+ invoked if any of its arguments are null; instead, a null result
+ is assumed automatically. See <xref
linkend="sql-createfunction"> for more information.
</para>
</listitem>
@@ -164,8 +165,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<listitem>
<para>
Change the volatility of the function to the specified
- type. See <xref linkend="sql-createfunction"> for more
- information about function volatility.
+ setting. See <xref linkend="sql-createfunction"> for details.
</para>
</listitem>
</varlistentry>
@@ -233,7 +233,7 @@ ALTER FUNCTION sqrt(integer) SET SCHEMA maths;
properties of a function to be modified, but does not provide the
ability to rename a function, make a function a security definer,
or change the owner, schema, or volatility of a function. The standard also
- requires the <literal>RESTRICT</> key word; it is optional in
+ requires the <literal>RESTRICT</> key word, which is optional in
<productname>PostgreSQL</>.
</para>
</refsect1>
diff --git a/doc/src/sgml/ref/alter_sequence.sgml b/doc/src/sgml/ref/alter_sequence.sgml
index 27e9e7702a5..3e7937e185b 100644
--- a/doc/src/sgml/ref/alter_sequence.sgml
+++ b/doc/src/sgml/ref/alter_sequence.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.12 2005/10/15 20:12:33 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.13 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -215,7 +215,8 @@ ALTER SEQUENCE serial RESTART WITH 105;
<title>Compatibility</title>
<para>
- <command>ALTER SEQUENCE</command> conforms with <acronym>SQL:2003</acronym>,
+ <command>ALTER SEQUENCE</command> conforms to the <acronym>SQL</acronym>
+ standard,
except for the <literal>SET SCHEMA</literal> variant, which is a
<productname>PostgreSQL</productname> extension.
</para>
diff --git a/doc/src/sgml/ref/create_cast.sgml b/doc/src/sgml/ref/create_cast.sgml
index 6adde5e0abb..71787b62c87 100644
--- a/doc/src/sgml/ref/create_cast.sgml
+++ b/doc/src/sgml/ref/create_cast.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/create_cast.sgml,v 1.21 2005/07/14 06:17:36 neilc Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/create_cast.sgml,v 1.22 2005/11/01 21:09:50 tgl Exp $ -->
<refentry id="SQL-CREATECAST">
<refmeta>
@@ -298,8 +298,9 @@ CREATE CAST (text AS int4) WITH FUNCTION int4(text);
<title>Compatibility</title>
<para>
- The <command>CREATE CAST</command> command conforms to SQL:2003,
- except that SQL:2003 does not make provisions for binary-compatible
+ The <command>CREATE CAST</command> command conforms to the
+ <acronym>SQL</acronym> standard,
+ except that SQL does not make provisions for binary-compatible
types or extra arguments to implementation functions.
<literal>AS IMPLICIT</> is a <productname>PostgreSQL</productname>
extension, too.
diff --git a/doc/src/sgml/ref/create_domain.sgml b/doc/src/sgml/ref/create_domain.sgml
index 0f52ff67f77..0ac449afc6d 100644
--- a/doc/src/sgml/ref/create_domain.sgml
+++ b/doc/src/sgml/ref/create_domain.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.24 2005/09/23 02:01:35 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.25 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -55,13 +55,17 @@ where <replaceable class="PARAMETER">constraint</replaceable> is:
constraints individually.
</para>
- <note>
+ <caution>
<para>
- Keep in mind also that declaring a function result value as a domain
+ At present, declaring a function result value as a domain
is pretty dangerous, because none of the PLs enforce domain constraints
- on their results.
+ on their results. You'll need to make sure that the function code itself
+ respects the constraints. In <application>PL/pgSQL</>, one possible
+ workaround is to explicitly cast the result value to the domain type
+ when you return it. <application>PL/pgSQL</> does not enforce domain
+ constraints for local variables within functions, either.
</para>
- </note>
+ </caution>
</refsect1>
<refsect1>
diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml
index 785f8bbb708..022a26c6b09 100644
--- a/doc/src/sgml/ref/create_function.sgml
+++ b/doc/src/sgml/ref/create_function.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_function.sgml,v 1.66 2005/07/14 06:17:36 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_function.sgml,v 1.67 2005/11/01 21:09:50 tgl Exp $
-->
<refentry id="SQL-CREATEFUNCTION">
@@ -228,9 +228,9 @@ CREATE [ OR REPLACE ] FUNCTION
change even within a single table scan, so no optimizations can be
made. Relatively few database functions are volatile in this sense;
some examples are <literal>random()</>, <literal>currval()</>,
- <literal>timeofday()</>. Note that any function that has side-effects
- must be classified volatile, even if its result is quite predictable,
- to prevent calls from being optimized away; an example is
+ <literal>timeofday()</>. But note that any function that has
+ side-effects must be classified volatile, even if its result is quite
+ predictable, to prevent calls from being optimized away; an example is
<literal>setval()</>.
</para>
@@ -279,9 +279,9 @@ CREATE [ OR REPLACE ] FUNCTION
</para>
<para>
- The key word <literal>EXTERNAL</literal> is present for SQL
- conformance but is optional since, unlike in SQL, this feature
- does not only apply to external functions.
+ The key word <literal>EXTERNAL</literal> is allowed for SQL
+ conformance, but it is optional since, unlike in SQL, this feature
+ applies to all functions not only external ones.
</para>
</listitem>
</varlistentry>
@@ -478,7 +478,7 @@ SELECT * FROM dup(42);
<title>Compatibility</title>
<para>
- A <command>CREATE FUNCTION</command> command is defined in SQL:2003.
+ A <command>CREATE FUNCTION</command> command is defined in SQL:1999 and later.
The <productname>PostgreSQL</productname> version is similar but
not fully compatible. The attributes are not portable, neither are the
different available languages.
diff --git a/doc/src/sgml/ref/create_sequence.sgml b/doc/src/sgml/ref/create_sequence.sgml
index 1afaa0ba295..7a094f6ef23 100644
--- a/doc/src/sgml/ref/create_sequence.sgml
+++ b/doc/src/sgml/ref/create_sequence.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.42 2004/11/27 21:27:07 petere Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.43 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -297,8 +297,8 @@ END;
<title>Compatibility</title>
<para>
- <command>CREATE SEQUENCE</command> is is specified in <acronym>SQL:2003</acronym>.
- <productname>PostgreSQL</productname> conforms with the standard, with the following exceptions:
+ <command>CREATE SEQUENCE</command> conforms to the <acronym>SQL</acronym>
+ standard, with the following exceptions:
<itemizedlist>
<listitem><para>The standard's <literal>AS <data type></literal> expression is not supported.</para></listitem>
<listitem><para>Obtaining the next value is done using the <function>nextval()</> function instead of the standard's <command>NEXT VALUE FOR</command> expression.</para></listitem>
diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 0bcd784911c..adfcd13ff0d 100644
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.95 2005/10/31 18:13:52 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.96 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -20,11 +20,12 @@ PostgreSQL documentation
<refsynopsisdiv>
<synopsis>
-CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable class="PARAMETER">table_name</replaceable> (
- [ <replaceable class="PARAMETER">column_name</replaceable> <replaceable class="PARAMETER">data_type</replaceable> [ DEFAULT <replaceable>default_expr</> ] [ <replaceable class="PARAMETER">column_constraint</replaceable> [ ... ] ]
+CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable class="PARAMETER">table_name</replaceable> ( [
+ { <replaceable class="PARAMETER">column_name</replaceable> <replaceable class="PARAMETER">data_type</replaceable> [ DEFAULT <replaceable>default_expr</> ] [ <replaceable class="PARAMETER">column_constraint</replaceable> [ ... ] ]
| <replaceable>table_constraint</replaceable>
- | LIKE <replaceable>parent_table</replaceable> [ { INCLUDING | EXCLUDING } DEFAULTS ] ] [, ... ]
-)
+ | LIKE <replaceable>parent_table</replaceable> [ { INCLUDING | EXCLUDING } DEFAULTS ] }
+ [, ... ]
+] )
[ INHERITS ( <replaceable>parent_table</replaceable> [, ... ] ) ]
[ WITH OIDS | WITHOUT OIDS ]
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
@@ -861,8 +862,8 @@ CREATE TABLE cinemas (
<title id="SQL-CREATETABLE-compatibility-title">Compatibility</title>
<para>
- The <command>CREATE TABLE</command> command conforms to SQL-92 and
- to a subset of SQL:2003, with exceptions listed below.
+ The <command>CREATE TABLE</command> command conforms to the
+ <acronym>SQL</acronym> standard, with exceptions listed below.
</para>
<refsect2>
@@ -940,8 +941,8 @@ CREATE TABLE cinemas (
<para>
Multiple inheritance via the <literal>INHERITS</literal> clause is
a <productname>PostgreSQL</productname> language extension.
- SQL:2003 defines single inheritance using a
- different syntax and different semantics. SQL:2003-style
+ SQL:1999 and later define single inheritance using a
+ different syntax and different semantics. SQL:1999-style
inheritance is not yet supported by
<productname>PostgreSQL</productname>.
</para>
diff --git a/doc/src/sgml/ref/create_table_as.sgml b/doc/src/sgml/ref/create_table_as.sgml
index d2dbf0ca3b3..201188d99cc 100644
--- a/doc/src/sgml/ref/create_table_as.sgml
+++ b/doc/src/sgml/ref/create_table_as.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.30 2005/10/15 20:12:33 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.31 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -20,7 +20,8 @@ PostgreSQL documentation
<refsynopsisdiv>
<synopsis>
-CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable>table_name</replaceable> [ (<replaceable>column_name</replaceable> [, ...] ) ] [ [ WITH | WITHOUT ] OIDS ]
+CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable>table_name</replaceable>
+ [ (<replaceable>column_name</replaceable> [, ...] ) ] [ [ WITH | WITHOUT ] OIDS ]
AS <replaceable>query</replaceable>
</synopsis>
</refsynopsisdiv>
@@ -143,17 +144,17 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable>table_name
<para>
Prior to <productname>PostgreSQL</productname> 8.0, <command>CREATE
TABLE AS</command> always included OIDs in the table it
- produced. As of <productname>PostgreSQL</productname> 8.0,
+ created. As of <productname>PostgreSQL</productname> 8.0,
the <command>CREATE TABLE AS</command> command allows the user to
explicitly specify whether OIDs should be included. If the
presence of OIDs is not explicitly specified,
the <xref linkend="guc-default-with-oids"> configuration variable is
- used. While this variable currently defaults to true, the default
- value may be changed in the future. Therefore, applications that
+ used. As of <productname>PostgreSQL</productname> 8.1,
+ this variable is false by default, so the default behavior is not
+ identical to pre-8.0 releases. Applications that
require OIDs in the table created by <command>CREATE TABLE
- AS</command> should explicitly specify <literal>WITH
- OIDS</literal> to ensure compatibility with future versions
- of <productname>PostgreSQL</productname>.
+ AS</command> should explicitly specify <literal>WITH OIDS</literal>
+ to ensure proper behavior.
</para>
</refsect1>
@@ -175,10 +176,8 @@ CREATE TABLE films_recent AS
<title>Compatibility</title>
<para>
- <command>CREATE TABLE AS</command> is specified by the SQL:2003
- standard. There are some small differences between the definition
- of the command in SQL:2003 and its implementation in
- <productname>PostgreSQL</>:
+ <command>CREATE TABLE AS</command> conforms to the <acronym>SQL</acronym>
+ standard, with the following exceptions:
<itemizedlist spacing="compact">
<listitem>
@@ -198,8 +197,26 @@ CREATE TABLE films_recent AS
<listitem>
<para>
- The standard defines a <literal>WITH DATA</literal> clause;
+ The standard defines a <literal>WITH [ NO ] DATA</literal> clause;
this is not currently implemented by <productname>PostgreSQL</>.
+ The behavior provided by <productname>PostgreSQL</> is equivalent
+ to the standard's <literal>WITH DATA</literal> case.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <literal>WITH/WITHOUT OIDS</> is a <productname>PostgreSQL</>
+ extension.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <productname>PostgreSQL</> handles temporary tables in a way
+ rather different from the standard; see
+ <xref linkend="sql-createtable" endterm="sql-createtable-title">
+ for details.
</para>
</listitem>
</itemizedlist>
diff --git a/doc/src/sgml/ref/create_trigger.sgml b/doc/src/sgml/ref/create_trigger.sgml
index 83a8edb9ed4..cbf51f8b864 100644
--- a/doc/src/sgml/ref/create_trigger.sgml
+++ b/doc/src/sgml/ref/create_trigger.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.41 2005/07/14 06:17:36 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.42 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -208,19 +208,19 @@ CREATE TRIGGER <replaceable class="PARAMETER">name</replaceable> { BEFORE | AFTE
<para>
The <command>CREATE TRIGGER</command> statement in
<productname>PostgreSQL</productname> implements a subset of the
- SQL:2003 standard. The following functionality is currently missing:
+ <acronym>SQL</> standard. The following functionality is currently missing:
<itemizedlist>
<listitem>
<para>
- SQL:2003 allows triggers to fire on updates to specific columns
+ SQL allows triggers to fire on updates to specific columns
(e.g., <literal>AFTER UPDATE OF col1, col2</literal>).
</para>
</listitem>
<listitem>
<para>
- SQL:2003 allows you to define aliases for the <quote>old</quote>
+ SQL allows you to define aliases for the <quote>old</quote>
and <quote>new</quote> rows or tables for use in the definition
of the triggered action (e.g., <literal>CREATE TRIGGER ... ON
tablename REFERENCING OLD ROW AS somename NEW ROW AS othername
@@ -234,9 +234,9 @@ CREATE TRIGGER <replaceable class="PARAMETER">name</replaceable> { BEFORE | AFTE
<listitem>
<para>
<productname>PostgreSQL</productname> only allows the execution
- of a user-defined function for the triggered action. SQL:2003
+ of a user-defined function for the triggered action. The standard
allows the execution of a number of other SQL commands, such as
- <command>CREATE TABLE</command> as triggered action. This
+ <command>CREATE TABLE</command> as the triggered action. This
limitation is not hard to work around by creating a user-defined
function that executes the desired commands.
</para>
@@ -245,7 +245,7 @@ CREATE TRIGGER <replaceable class="PARAMETER">name</replaceable> { BEFORE | AFTE
</para>
<para>
- SQL:2003 specifies that multiple triggers should be fired in
+ SQL specifies that multiple triggers should be fired in
time-of-creation order. <productname>PostgreSQL</productname> uses
name order, which was judged more convenient to work with.
</para>
diff --git a/doc/src/sgml/ref/create_type.sgml b/doc/src/sgml/ref/create_type.sgml
index 5fca3582fb7..1205605ca36 100644
--- a/doc/src/sgml/ref/create_type.sgml
+++ b/doc/src/sgml/ref/create_type.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_type.sgml,v 1.58 2005/08/12 21:49:46 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_type.sgml,v 1.59 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -533,8 +533,8 @@ CREATE TABLE big_objs (
<para>
This <command>CREATE TYPE</command> command is a
<productname>PostgreSQL</productname> extension. There is a
- <command>CREATE TYPE</command> statement in SQL:2003 that is rather
- different in detail.
+ <command>CREATE TYPE</command> statement in the <acronym>SQL</> standard
+ that is rather different in detail.
</para>
</refsect1>
diff --git a/doc/src/sgml/ref/create_view.sgml b/doc/src/sgml/ref/create_view.sgml
index 8c18378dee6..aaff51b2a09 100644
--- a/doc/src/sgml/ref/create_view.sgml
+++ b/doc/src/sgml/ref/create_view.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_view.sgml,v 1.30 2005/02/02 06:35:59 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_view.sgml,v 1.31 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -20,8 +20,8 @@ PostgreSQL documentation
<refsynopsisdiv>
<synopsis>
-CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW <replaceable class="PARAMETER">name</replaceable> [ ( <replaceable
-class="PARAMETER">column_name</replaceable> [, ...] ) ] AS <replaceable class="PARAMETER">query</replaceable>
+CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW <replaceable class="PARAMETER">name</replaceable> [ ( <replaceable class="PARAMETER">column_name</replaceable> [, ...] ) ]
+ AS <replaceable class="PARAMETER">query</replaceable>
</synopsis>
</refsynopsisdiv>
@@ -62,16 +62,14 @@ class="PARAMETER">column_name</replaceable> [, ...] ) ] AS <replaceable class="P
<para>
If specified, the view is created as a temporary view.
Temporary views are automatically dropped at the end of the
- current session. Temporary views are automatically placed in the
- current backend's local temporary schema, so it is illegal to
- specify a schema-qualified name for a temporary view. Existing
+ current session. Existing
permanent relations with the same name are not visible to the
current session while the temporary view exists, unless they are
referenced with schema-qualified names.
</para>
<para>
- If any of the base tables referenced by the view are temporary,
+ If any of the tables referenced by the view are temporary,
the view is created as a temporary view (whether
<literal>TEMPORARY</literal> is specified or not).
</para>
@@ -176,8 +174,8 @@ CREATE VIEW comedies AS
The SQL standard specifies some additional capabilities for the
<command>CREATE VIEW</command> statement:
<synopsis>
-CREATE VIEW <replaceable class="parameter">name</replaceable> [ ( <replaceable class="parameter">column</replaceable> [, ...] ) ]
- AS query
+CREATE VIEW <replaceable class="parameter">name</replaceable> [ ( <replaceable class="parameter">column_name</replaceable> [, ...] ) ]
+ AS <replaceable class="PARAMETER">query</replaceable>
[ WITH [ CASCADED | LOCAL ] CHECK OPTION ]
</synopsis>
</para>
@@ -224,6 +222,7 @@ CREATE VIEW <replaceable class="parameter">name</replaceable> [ ( <replaceable c
<para>
<command>CREATE OR REPLACE VIEW</command> is a
<productname>PostgreSQL</productname> language extension.
+ So is the concept of a temporary view.
</para>
</refsect1>
diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml
index 3f3b2c8cdcd..083637fb987 100644
--- a/doc/src/sgml/ref/createuser.sgml
+++ b/doc/src/sgml/ref/createuser.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/createuser.sgml,v 1.43 2005/09/30 07:13:53 petere Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/createuser.sgml,v 1.44 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -92,6 +92,7 @@ PostgreSQL documentation
<listitem>
<para>
The new user will not be a superuser.
+ This is the default.
</para>
</listitem>
</varlistentry>
@@ -112,6 +113,7 @@ PostgreSQL documentation
<listitem>
<para>
The new user will not be allowed to create databases.
+ This is the default.
</para>
</listitem>
</varlistentry>
@@ -133,6 +135,7 @@ PostgreSQL documentation
<listitem>
<para>
The new user will not be allowed to create new roles.
+ This is the default.
</para>
</listitem>
</varlistentry>
diff --git a/doc/src/sgml/ref/delete.sgml b/doc/src/sgml/ref/delete.sgml
index 598936cd5ac..8369d991372 100644
--- a/doc/src/sgml/ref/delete.sgml
+++ b/doc/src/sgml/ref/delete.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/delete.sgml,v 1.24 2005/04/08 00:59:58 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/delete.sgml,v 1.25 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -46,7 +46,7 @@ DELETE FROM [ ONLY ] <replaceable class="PARAMETER">table</replaceable>
<para>
By default, <command>DELETE</command> will delete rows in the
- specified table and all its subtables. If you wish to delete only
+ specified table and all its child tables. If you wish to delete only
from the specific table mentioned, you must use the
<literal>ONLY</literal> clause.
</para>
@@ -72,6 +72,16 @@ DELETE FROM [ ONLY ] <replaceable class="PARAMETER">table</replaceable>
<title>Parameters</title>
<variablelist>
+ <varlistentry>
+ <term><literal>ONLY</></term>
+ <listitem>
+ <para>
+ If specified, delete rows from the named table only. When not
+ specified, any tables inheriting from the named table are also processed.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term><replaceable class="parameter">table</replaceable></term>
<listitem>
@@ -90,7 +100,9 @@ DELETE FROM [ ONLY ] <replaceable class="PARAMETER">table</replaceable>
to the list of tables that can be specified in the <xref
linkend="sql-from" endterm="sql-from-title"> of a
<command>SELECT</command> statement; for example, an alias for
- the table name can be specified.
+ the table name can be specified. Do not repeat the target table
+ in the <replaceable class="PARAMETER">usinglist</replaceable>,
+ unless you wish to set up a self-join.
</para>
</listitem>
</varlistentry>
@@ -99,8 +111,8 @@ DELETE FROM [ ONLY ] <replaceable class="PARAMETER">table</replaceable>
<term><replaceable class="parameter">condition</replaceable></term>
<listitem>
<para>
- A value expression that returns a value of type
- <type>boolean</type> that determines the rows which are to be
+ An expression returning a value of type
+ <type>boolean</type>, which determines the rows that are to be
deleted.
</para>
</listitem>
diff --git a/doc/src/sgml/ref/drop_sequence.sgml b/doc/src/sgml/ref/drop_sequence.sgml
index 8a7bb893eb2..11f60b268a8 100644
--- a/doc/src/sgml/ref/drop_sequence.sgml
+++ b/doc/src/sgml/ref/drop_sequence.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/drop_sequence.sgml,v 1.22 2005/01/04 00:39:53 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/drop_sequence.sgml,v 1.23 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -82,8 +82,8 @@ DROP SEQUENCE serial;
<title>Compatibility</title>
<para>
- <command>DROP SEQUENCE</command> conforms with
- <acronym>SQL:2003</acronym>, except that the standard only allows one
+ <command>DROP SEQUENCE</command> conforms to the <acronym>SQL</acronym>
+ standard, except that the standard only allows one
sequence to be dropped per command.
</para>
</refsect1>
diff --git a/doc/src/sgml/ref/pg_config-ref.sgml b/doc/src/sgml/ref/pg_config-ref.sgml
index 4eef80a3ce0..2f6751723ac 100644
--- a/doc/src/sgml/ref/pg_config-ref.sgml
+++ b/doc/src/sgml/ref/pg_config-ref.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.22 2005/09/27 17:39:32 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.23 2005/11/01 21:09:50 tgl Exp $ -->
<refentry id="app-pgconfig">
<refmeta>
@@ -277,7 +277,10 @@
</para>
<para>
- The options <option>--cc</option>, <option>--cppflags</option>,
+ The options <option>--docdir</option>, <option>--pkgincludedir</option>,
+ <option>--localedir</option>, <option>--mandir</option>,
+ <option>--sharedir</option>, <option>--sysconfdir</option>,
+ <option>--cc</option>, <option>--cppflags</option>,
<option>--cflags</option>, <option>--cflags_sl</option>,
<option>--ldflags</option>, <option>--ldflags_sl</option>,
and <option>--libs</option> are new in <productname>PostgreSQL</> 8.1.
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 288ae20a411..998dc670c26 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.80 2005/07/25 22:12:31 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.81 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -194,18 +194,19 @@ PostgreSQL documentation
</listitem>
</varlistentry>
- <varlistentry>
- <term><option>-E <replaceable class="parameter">encoding</replaceable></option></term>
- <term><option>--encoding=<replaceable class="parameter">encoding</replaceable></option></term>
- <listitem>
- <para>
- Create the dump in the specified encoding. By default, the dump is
- created in the database encoding.
- </para>
- </listitem>
+ <varlistentry>
+ <term><option>-E <replaceable class="parameter">encoding</replaceable></option></term>
+ <term><option>--encoding=<replaceable class="parameter">encoding</replaceable></option></term>
+ <listitem>
+ <para>
+ Create the dump in the specified character set encoding. By default,
+ the dump is created in the database encoding. (Another way to get the
+ same result is to set the <envar>PGCLIENTENCODING</envar> environment
+ variable to the desired dump encoding.)
+ </para>
+ </listitem>
</varlistentry>
-
<varlistentry>
<term><option>-f <replaceable class="parameter">file</replaceable></option></term>
<term><option>--file=<replaceable class="parameter">file</replaceable></option></term>
@@ -474,10 +475,13 @@ PostgreSQL documentation
<term><option>--use-set-session-authorization</></term>
<listitem>
<para>
- Output SQL standard SET SESSION AUTHORIZATION commands instead of
- ALTER OWNER commands. This makes the dump more standards compatible,
- but depending on the history of the objects in the dump, may not
- restore properly.
+ Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands
+ instead of <command>ALTER OWNER</> commands to determine object
+ ownership. This makes the dump more standards compatible, but
+ depending on the history of the objects in the dump, may not restore
+ properly. Also, a dump using <command>SET SESSION AUTHORIZATION</>
+ will certainly require superuser privileges to restore correctly,
+ whereas <command>ALTER OWNER</> requires lesser privileges.
</para>
</listitem>
</varlistentry>
diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml
index 6d25f3e3c5d..6cf1c0d538c 100644
--- a/doc/src/sgml/ref/pg_dumpall.sgml
+++ b/doc/src/sgml/ref/pg_dumpall.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.54 2005/10/15 20:12:33 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.55 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -278,10 +278,11 @@ PostgreSQL documentation
<term><option>--use-set-session-authorization</></term>
<listitem>
<para>
- Output SQL standard SET SESSION AUTHORIZATION commands instead of
- ALTER OWNER commands. This makes the dump more standards compatible,
- but depending on the history of the objects in the dump, may not
- restore properly.
+ Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands
+ instead of <command>ALTER OWNER</> commands to determine object
+ ownership. This makes the dump more standards compatible, but
+ depending on the history of the objects in the dump, may not restore
+ properly.
</para>
</listitem>
</varlistentry>
diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index ec19d8e7844..dfd328e2455 100644
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.55 2005/07/27 13:42:01 neilc Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.56 2005/11/01 21:09:50 tgl Exp $ -->
<refentry id="APP-PGRESTORE">
<refmeta>
@@ -243,9 +243,9 @@
<term><option>--schema=<replaceable class="parameter">schema</replaceable></option></term>
<listitem>
<para>
- Restore only definitions and/or data in the named schema. Not to be
- confused with the <option>-s</option> option. This can be combined with
- <option>-t</option> option.
+ Restore only objects that are in the named schema. This can be
+ combined with the <option>-t</option> option to restore just a
+ specific table.
</para>
</listitem>
</varlistentry>
@@ -298,8 +298,10 @@
<term><option>--schema-only</option></term>
<listitem>
<para>
- Restore only the schema (data definitions), not the data.
- Sequence values will be reset.
+ Restore only the schema (data definitions), not the data (table
+ contents). Sequence current values will not be restored, either.
+ (Do not confuse this with the <option>--schema</> option, which
+ uses the word <quote>schema</> in a different meaning.)
</para>
</listitem>
</varlistentry>
@@ -361,10 +363,11 @@
<term><option>--use-set-session-authorization</option></term>
<listitem>
<para>
- Output SQL standard <command>SET SESSION AUTHORIZATION</>
- commands instead of <command>ALTER OWNER</> commands. This
- makes the dump more standards compatible, but depending on the
- history of the objects in the dump, may not restore properly.
+ Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands
+ instead of <command>ALTER OWNER</> commands to determine object
+ ownership. This makes the dump more standards compatible, but
+ depending on the history of the objects in the dump, may not restore
+ properly.
</para>
</listitem>
</varlistentry>
diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 90ec8e00f5b..f017a1ce225 100644
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.152 2005/10/30 03:01:49 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.153 2005/11/01 21:09:50 tgl Exp $
PostgreSQL documentation
-->
@@ -227,8 +227,9 @@ PostgreSQL documentation
<term><option>--log-file <replaceable class="parameter">filename</replaceable></></term>
<listitem>
<para>
- Write all query output into file <replaceable
- class="parameter">filename</replaceable> in addition to the regular output source.
+ Write all query output into file <replaceable
+ class="parameter">filename</replaceable>, in addition to the
+ normal output destination.
</para>
</listitem>
</varlistentry>
@@ -601,7 +602,7 @@ testdb=>
precede it by a backslash. Anything contained in single quotes is
furthermore subject to C-like substitutions for
<literal>\n</literal> (new line), <literal>\t</literal> (tab),
- <literal>\</literal><replaceable>digits</replaceable> (octal),
+ <literal>\</literal><replaceable>digits</replaceable> (octal), and
<literal>\x</literal><replaceable>digits</replaceable> (hexadecimal).
</para>
@@ -2015,12 +2016,13 @@ bar
<listitem>
<para>
The filename that will be used to store the history list. The default
- value is <filename>~/.psql_history</filename>. For example, using:
+ value is <filename>~/.psql_history</filename>. For example, putting
<programlisting>
\set HISTFILE ~/.psql_history- :DBNAME
</programlisting>
- in <filename>~/.psqlrc</filename> will get <application>psql</application> to
- maintain a separate history for each database.
+ in <filename>~/.psqlrc</filename> will cause
+ <application>psql</application> to maintain a separate history for
+ each database.
</para>
<note>
<para>
diff --git a/doc/src/sgml/ref/release_savepoint.sgml b/doc/src/sgml/ref/release_savepoint.sgml
index ab6d3f35293..bb1ca5acfd6 100644
--- a/doc/src/sgml/ref/release_savepoint.sgml
+++ b/doc/src/sgml/ref/release_savepoint.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/release_savepoint.sgml,v 1.4 2005/01/06 20:53:34 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/release_savepoint.sgml,v 1.5 2005/11/01 21:09:51 tgl Exp $
PostgreSQL documentation
-->
@@ -108,7 +108,7 @@ COMMIT;
<title>Compatibility</title>
<para>
- This command conforms to the SQL:2003 standard. The standard
+ This command conforms to the <acronym>SQL</> standard. The standard
specifies that the key word <literal>SAVEPOINT</literal> is
mandatory, but <productname>PostgreSQL</productname> allows it to
be omitted.
diff --git a/doc/src/sgml/ref/rollback_to.sgml b/doc/src/sgml/ref/rollback_to.sgml
index 8e3aeff6439..e6521a960a7 100644
--- a/doc/src/sgml/ref/rollback_to.sgml
+++ b/doc/src/sgml/ref/rollback_to.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/rollback_to.sgml,v 1.6 2005/01/26 23:20:20 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/rollback_to.sgml,v 1.7 2005/11/01 21:09:51 tgl Exp $
PostgreSQL documentation
-->
@@ -130,11 +130,11 @@ COMMIT;
<title>Compatibility</title>
<para>
- The SQL:2003 standard specifies that the key word
+ The <acronym>SQL</> standard specifies that the key word
<literal>SAVEPOINT</> is mandatory, but <productname>PostgreSQL</>
- and <productname>Oracle</> allow it to be omitted. SQL:2003 allows
+ and <productname>Oracle</> allow it to be omitted. SQL allows
only <literal>WORK</>, not <literal>TRANSACTION</>, as a noise word
- after <literal>ROLLBACK</>. Also, SQL:2003 has an optional clause
+ after <literal>ROLLBACK</>. Also, SQL has an optional clause
<literal>AND [ NO ] CHAIN</> which is not currently supported by
<productname>PostgreSQL</>. Otherwise, this command conforms to
the SQL standard.
diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml
index 48a192d1b90..f862d5f8737 100644
--- a/doc/src/sgml/ref/select.sgml
+++ b/doc/src/sgml/ref/select.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/select.sgml,v 1.89 2005/08/01 20:31:04 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/select.sgml,v 1.90 2005/11/01 21:09:51 tgl Exp $
PostgreSQL documentation
-->
@@ -1095,7 +1095,7 @@ SELECT distributors.* WHERE distributors.name = 'Westward';
<title>Namespace Available to <literal>GROUP BY</literal> and <literal>ORDER BY</literal></title>
<para>
- In the SQL:2003 standard, an <literal>ORDER BY</literal> clause may
+ In the SQL-92 standard, an <literal>ORDER BY</literal> clause may
only use result column names or numbers, while a <literal>GROUP
BY</literal> clause may only use expressions based on input column
names. <productname>PostgreSQL</productname> extends each of
@@ -1108,11 +1108,11 @@ SELECT distributors.* WHERE distributors.name = 'Westward';
</para>
<para>
- SQL:2003 uses a slightly different definition which is not entirely upward
- compatible with SQL-92.
+ SQL:1999 and later use a slightly different definition which is not
+ entirely upward compatible with SQL-92.
In most cases, however, <productname>PostgreSQL</productname>
will interpret an <literal>ORDER BY</literal> or <literal>GROUP
- BY</literal> expression the same way SQL:2003 does.
+ BY</literal> expression the same way SQL:1999 does.
</para>
</refsect2>
diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml
index 9429aec9f87..6640d54c238 100644
--- a/doc/src/sgml/ref/vacuum.sgml
+++ b/doc/src/sgml/ref/vacuum.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.39 2005/07/30 17:15:35 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.40 2005/11/01 21:09:51 tgl Exp $
PostgreSQL documentation
-->
@@ -176,12 +176,10 @@ VACUUM [ FULL | FREEZE ] [ VERBOSE ] ANALYZE [ <replaceable class="PARAMETER">ta
</para>
<para>
- During <command>VACUUM</command> execution, there can be a substantial
- increase in I/O traffic, which cause poor performance for other active
- sessions. Therefore, it is sometimes advisable to use
- the cost-based vacuum delay feature. See <xref
- linkend="runtime" endterm="runtime-config-resource-vacuum-cost-title"> for more
- details.
+ <command>VACUUM</command> causes a substantial increase in I/O traffic,
+ which can cause poor performance for other active sessions. Therefore,
+ it is sometimes advisable to use the cost-based vacuum delay feature.
+ See <xref linkend="runtime-config-resource-vacuum-cost"> for details.
</para>
</refsect1>
@@ -238,7 +236,7 @@ VACUUM
<simplelist type="inline">
<member><xref linkend="app-vacuumdb" endterm="app-vacuumdb-title"></member>
- <member><xref linkend="runtime" endterm="runtime-config-resource-vacuum-cost-title"></member>
+ <member><xref linkend="runtime-config-resource-vacuum-cost" endterm="runtime-config-resource-vacuum-cost-title"></member>
</simplelist>
</refsect1>
</refentry>
diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index 173115becdf..42f4cc31fbc 100644
--- a/doc/src/sgml/release.sgml
+++ b/doc/src/sgml/release.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.396 2005/10/28 20:00:03 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.397 2005/11/01 21:09:49 tgl Exp $
Typical markup:
@@ -1773,21 +1773,25 @@ psql -t -f fixseq.sql db1 | psql -e db1
<application>pg_restore</> (Richard van den Berg)
</para>
<para>
- This allows only objects from a specified schema to be restored.
+ This allows just the objects in a specified schema to be restored.
</para>
</listitem>
<listitem>
<para>
- Allow <application>pg_dump</> to dump a consistent snapshot of
- large objects (Tom)
+ Allow <application>pg_dump</> to dump large objects even in
+ text mode (Tom)
+ </para>
+ <para>
+ With this change, large objects are now always dumped; the former
+ <option>-b</> switch is a no-op.
</para>
</listitem>
<listitem>
<para>
- Allow <application>pg_dump</> to dump large objects even in
- text mode (Tom)
+ Allow <application>pg_dump</> to dump a consistent snapshot of
+ large objects (Tom)
</para>
</listitem>
--
GitLab