diff --git a/doc/src/sgml/release-9.3.sgml b/doc/src/sgml/release-9.3.sgml
index 72638a6b0cd0397de7377683155f900e29892ec4..30dba78c7c37bbec0b804fb93e6baeae910b8866 100644
--- a/doc/src/sgml/release-9.3.sgml
+++ b/doc/src/sgml/release-9.3.sgml
@@ -584,6 +584,13 @@
</para>
</listitem>
+ <listitem>
+ <para>
+ Add support for piping COPY and psql \copy to/from an external program (Etsuro
+ Fujita)
+ </para>
+ </listitem>
+
<listitem>
<para>
Improve query string error location reporting (Tom Lane)
@@ -601,13 +608,6 @@
</para>
</listitem>
- <listitem>
- <para>
- Add support for piping COPY and psql \copy to/from an external program (Etsuro
- Fujita)
- </para>
- </listitem>
-
</itemizedlist>
</sect3>
@@ -702,18 +702,6 @@
<itemizedlist>
- <listitem>
- <para>
- Internally store default foreign key matches (non-FULL, non-PARTIAL) as "simple" (Tom Lane)
- </para>
-
- <para>
- These were previously stored as "&unspecified&".
- This changes the value stored in system column
- pg_constraint.confmatchtype. BACKWARD COMPATIBILITY CHANGE
- </para>
- </listitem>
-
<listitem>
<para>
Change ON UPDATE SET NULL/SET DEFAULT foreign key actions to affect
@@ -741,6 +729,18 @@
</para>
</listitem>
+ <listitem>
+ <para>
+ Internally store default foreign key matches (non-FULL, non-PARTIAL) as "simple" (Tom Lane)
+ </para>
+
+ <para>
+ These were previously stored as "&unspecified&".
+ This changes the value stored in system column
+ pg_constraint.confmatchtype. BACKWARD COMPATIBILITY CHANGE
+ </para>
+ </listitem>
+
</itemizedlist>
</sect4>
@@ -752,7 +752,12 @@
<listitem>
<para>
- Add support for ALTER RULE ... RENAME (Ali Dar)
+ Add the ALTER TYPE ... IF NOT EXISTS clause when adding enumerated type labels (Andrew
+ Dunstan)
+ </para>
+
+ <para>
+ This is useful for conditional label creation in transaction blocks.
</para>
</listitem>
@@ -770,12 +775,7 @@
<listitem>
<para>
- Add the ALTER TYPE ... IF NOT EXISTS clause when adding enumerated type labels (Andrew
- Dunstan)
- </para>
-
- <para>
- This is useful for conditional label creation in transaction blocks.
+ Add support for ALTER RULE ... RENAME (Ali Dar)
</para>
</listitem>
@@ -790,8 +790,15 @@
<listitem>
<para>
- When converting a table to a view, remove its system columns (Tom Lane)
- KEEP?
+ Add a materialized view relations (Kevin Grittner)
+ </para>
+
+ <para>
+ Unlink ordinary views, where the base tables are read on every access,
+ materialized views create physical tables at creation or refresh time.
+ Access to the materialized view reads from these materialized physical
+ tables. There is no facility for incrementally refreshing materialized
+ views or auto-accessing them via base table access.
</para>
</listitem>
@@ -825,15 +832,8 @@
<listitem>
<para>
- Add a materialized view relations (Kevin Grittner)
- </para>
-
- <para>
- Unlink ordinary views, where the base tables are read on every access,
- materialized views create physical tables at creation or refresh time.
- Access to the materialized view reads from these materialized physical
- tables. There is no facility for incrementally refreshing materialized
- views or auto-accessing them via base table access.
+ When converting a table to a view, remove its system columns (Tom Lane)
+ KEEP?
</para>
</listitem>
@@ -848,13 +848,6 @@
<itemizedlist>
- <listitem>
- <para>
- Allow text timezone designations, e.g. "America/Chicago" when using the
- ISO "T" timestamptz format (Bruce Momjian)
- </para>
- </listitem>
-
<listitem>
<para>
Increase the maximum length of large objects from 2GB to 4TB (Nozomi
@@ -868,10 +861,18 @@
<listitem>
<para>
- Add functions to convert values, records, and hstore data to JSON (Andrew Dunstan)
+ Allow text timezone designations, e.g. "America/Chicago" when using the
+ ISO "T" timestamptz format (Bruce Momjian)
</para>
</listitem>
+ </itemizedlist>
+
+ <sect4>
+ <title>JSON</title>
+
+ <itemizedlist>
+
<listitem>
<para>
Add operators and functions to extract values from JSON data strings
@@ -885,10 +886,19 @@
</para>
</listitem>
+ <listitem>
+ <para>
+ Add functions to convert values, records, and hstore data to JSON (Andrew Dunstan)
+ </para>
+ </listitem>
+
</itemizedlist>
+ </sect4>
+
</sect3>
+
<sect3>
<title>Functions</title>
@@ -902,27 +912,34 @@
<listitem>
<para>
- Have to_char(), to_date(), and to_timestamp() properly handle
- negative century designations (CC) (Bruce Momjian)
+ Allow concat() and format() to properly expand VARIADIC-labeled
+ arguments (Pavel Stehule)
</para>
+ </listitem>
+ <listitem>
<para>
- Previously the behavior was either wrong or inconsistent with
- positive/AD handling, e.g. format mask 'IYYY-IW-DY'.
+ Improve format() to handle field width and left/right alignment
+ (Pavel Stehule)
</para>
</listitem>
<listitem>
<para>
- In to_date() and to_timestamp(), return proper results when mixing
- ISO and Gregorian week/day designations (Bruce Momjian)
+ Have to_char(), to_date(), and to_timestamp() properly handle
+ negative century designations (CC) (Bruce Momjian)
+ </para>
+
+ <para>
+ Previously the behavior was either wrong or inconsistent with
+ positive/AD handling, e.g. format mask 'IYYY-IW-DY'.
</para>
</listitem>
<listitem>
<para>
- Allow concat() and format() to properly expand VARIADIC-labeled
- arguments (Pavel Stehule)
+ Have to_date() and to_timestamp() return proper results when mixing
+ ISO and Gregorian week/day designations (Bruce Momjian)
</para>
</listitem>
@@ -944,13 +961,6 @@
</para>
</listitem>
- <listitem>
- <para>
- Improve format() to handle field width and left/right alignment
- (Pavel Stehule)
- </para>
- </listitem>
-
<listitem>
<para>
Force cached functions to be replanned if the search_path changes (Tom Lane)
@@ -987,7 +997,12 @@
<listitem>
<para>
- Allow greater flexibility in where keywords can be used in PL/pgSQL (Tom Lane)
+ Allow PL/pgSQL to use RETURN with a composite-type expressions (Asif
+ Rehman)
+ </para>
+
+ <para>
+ Previously RETURN could only reference composite-type variables.
</para>
</listitem>
@@ -1004,12 +1019,7 @@
<listitem>
<para>
- Allow PL/pgSQL to use RETURN with a composite-type expressions (Asif
- Rehman)
- </para>
-
- <para>
- Previously RETURN could only reference composite-type variables.
+ Allow greater flexibility in where keywords can be used in PL/pgSQL (Tom Lane)
</para>
</listitem>
@@ -1024,37 +1034,24 @@
<listitem>
<para>
- Allow PL/Python to support platform-specific include directories (Peter Eisentraut)
- </para>
- </listitem>
-
- <listitem>
- <para>
- Allow PL/Python on OS X to build against custom versions of Python
- (Peter Eisentraut)
+ Add PL/Python result object string handler (Peter Eisentraut)
</para>
- </listitem>
- <listitem>
<para>
- Handle SPIErrors raised explicitly with PL/Python's RAISE the same as
- as internal SPI errors (Oskari Saarenmaa and Jan Urbanski)
+ This allows plpy.debug(rv) to output something reasonable.
</para>
</listitem>
<listitem>
<para>
- Add PL/Python result object string handler (Peter Eisentraut)
- </para>
-
- <para>
- This allows plpy.debug(rv) to output something reasonable.
+ Have PL/Python convert oid values to a proper Python numeric type (Peter Eisentraut)
</para>
</listitem>
<listitem>
<para>
- Have PL/Python convert oid values to a proper Python numeric type (Peter Eisentraut)
+ Handle SPIErrors raised explicitly with PL/Python's RAISE the same as
+ as internal SPI errors (Oskari Saarenmaa and Jan Urbanski)
</para>
</listitem>
@@ -1071,22 +1068,8 @@
<listitem>
<para>
- Have initdb fsync the newly created data directory (Jeff Davis)
- </para>
-
- <para>
- This can be disabled by using --nosync.
- </para>
- </listitem>
-
- <listitem>
- <para>
- Add initdb --sync-only option to sync the data directory to durable
- storage (Bruce Momjian)
- </para>
-
- <para>
- This is used by pg_upgrade.
+ Add command-line utility pg_isready to check if the server is ready
+ to accept connections (Phil Sorber)
</para>
</listitem>
@@ -1101,20 +1084,6 @@
</para>
</listitem>
- <listitem>
- <para>
- Add command-line utility pg_isready to check if the server is ready
- to accept connections (Phil Sorber)
- </para>
- </listitem>
-
- <listitem>
- <para>
- Have initdb issue a warning about placing the data directory at the
- top of file system mount points (Bruce Momjian)
- </para>
- </listitem>
-
<listitem>
<para>
Add -d option to pg_dumpall, pg_basebackup, pg_receivexlog to
@@ -1153,12 +1122,8 @@
<listitem>
<para>
- Allow the psql --single-transaction mode to work when reading from
- standard input (Fabien Coelho, Robert Haas)
- </para>
-
- <para>
- Previously this option only worked when reading from a file.
+ Adjust function cost settings so psql tab completion and pattern
+ searching is more efficient (Tom Lane)
</para>
</listitem>
@@ -1170,18 +1135,22 @@
<listitem>
<para>
- Remove psql warning when connecting to an older server (Peter Eisentraut)
+ Allow the psql --single-transaction mode to work when reading from
+ standard input (Fabien Coelho, Robert Haas)
</para>
<para>
- The warning when connecting to a newer server was retained.
+ Previously this option only worked when reading from a file.
</para>
</listitem>
<listitem>
<para>
- Adjust function cost settings so psql tab completion and pattern
- searching is more efficient (Tom Lane)
+ Remove psql warning when connecting to an older server (Peter Eisentraut)
+ </para>
+
+ <para>
+ The warning when connecting to a newer server was retained.
</para>
</listitem>
@@ -1194,18 +1163,21 @@
<listitem>
<para>
- Add SSL information to psql's \conninfo command (Alastair Turner)
+ Add psql \watch command to repeatedly execute commands (Will
+ Leinweber)
</para>
</listitem>
<listitem>
<para>
- In psql, do not allow \connect to use defaults if there is no active
- connection (Bruce Momjian)
+ Add psql command \gset to store query results in psql variables
+ (Pavel Stehule)
</para>
+ </listitem>
+ <listitem>
<para>
- This might be the case if the server had crashed.
+ Add SSL information to psql's \conninfo command (Alastair Turner)
</para>
</listitem>
@@ -1217,31 +1189,28 @@
<listitem>
<para>
- Properly reset state if psql's "\g file" command failed (Tom Lane)
+ Allow psql \l to accept a database name pattern (Peter Eisentraut)
</para>
+ </listitem>
+ <listitem>
<para>
- Previously failed commands discarded output from subsequent commands.
+ In psql, do not allow \connect to use defaults if there is no active
+ connection (Bruce Momjian)
</para>
- </listitem>
- <listitem>
<para>
- Add psql command \gset to store query results in psql variables
- (Pavel Stehule)
+ This might be the case if the server had crashed.
</para>
</listitem>
<listitem>
<para>
- Add psql \watch command to repeatedly execute commands (Will
- Leinweber)
+ Properly reset state if psql's "\g file" command failed (Tom Lane)
</para>
- </listitem>
- <listitem>
<para>
- Allow psql \l to accept a database name pattern (Peter Eisentraut)
+ Previously failed commands discarded output from subsequent commands.
</para>
</listitem>
@@ -1297,18 +1266,23 @@
<listitem>
<para>
- Fix tar files emitted by pg_dump and pg_basebackup to be POSIX
- conformant (Brian Weaver, Tom Lane)
+ Add pg_dump --jobs to dump in parallel (Joachim Wieland)
</para>
</listitem>
-
<listitem>
<para>
Have pg_dump output functions in a predictable order (Joel Jacobson)
</para>
</listitem>
+ <listitem>
+ <para>
+ Fix tar files emitted by pg_dump and pg_basebackup to be POSIX
+ conformant (Brian Weaver, Tom Lane)
+ </para>
+ </listitem>
+
<listitem>
<para>
Add -d/--dbname option to pg_dump, for consistency with other client
@@ -1320,9 +1294,40 @@
</para>
</listitem>
+ </itemizedlist>
+
+ </sect4>
+
+ <sect4>
+ <title><link linkend="APP-INITDB"><application>initdb</></link></title>
+
+ <itemizedlist>
+
<listitem>
<para>
- Add pg_dump --jobs to dump in parallel (Joachim Wieland)
+ Have initdb fsync the newly created data directory (Jeff Davis)
+ </para>
+
+ <para>
+ This can be disabled by using --nosync.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add initdb --sync-only option to sync the data directory to durable
+ storage (Bruce Momjian)
+ </para>
+
+ <para>
+ This is used by pg_upgrade.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Have initdb issue a warning about placing the data directory at the
+ top of file system mount points (Bruce Momjian)
</para>
</listitem>
@@ -1339,19 +1344,25 @@
<listitem>
<para>
- Remove typedefs for int2/int4 as they are better represented as int16/int32 (Peter Eisentraut)
+ Add an embedded list interface (Andres Freund)
</para>
</listitem>
<listitem>
<para>
- Create a centralized timeout API (Zoltán Böszörményi)
+ Add infrastructure to better support plug-in background worker
+ processes (AlvaroAacute;lvaro Herrera)
</para>
</listitem>
<listitem>
<para>
- Rewrite pgindent in Perl (Andrew Dunstan)
+ Create libpgcommon and move pg_malloc() and other functions there
+ (AlvaroAacute;lvaro Herrera, Andres Freund)
+ </para>
+
+ <para>
+ This allows libpgport to be used solely for porting code.
</para>
</listitem>
@@ -1365,55 +1376,60 @@
<listitem>
<para>
- Fix install-strip on Mac OS X (Peter Eisentraut)
+ Remove typedefs for int2/int4 as they are better represented as int16/int32 (Peter Eisentraut)
</para>
</listitem>
<listitem>
<para>
- Remove configure flag --disable-shared, as it is no longer used (Bruce Momjian)
+ Create a centralized timeout API (Zoltán Böszörményi)
</para>
</listitem>
<listitem>
<para>
- Add emacs macro to match Postgres perltidy formatting (Peter
- Eisentraut)
+ Rewrite pgindent in Perl (Andrew Dunstan)
</para>
</listitem>
<listitem>
<para>
- Run tool to check the keyword list when the backend grammar is changed (Tom Lane)
+ Fix install-strip on Mac OS X (Peter Eisentraut)
</para>
</listitem>
<listitem>
<para>
- Standardize on naming of client-side memory allocation functions (Tom Lane)
+ Remove configure flag --disable-shared, as it is no longer used (Bruce Momjian)
</para>
</listitem>
<listitem>
<para>
- Centralize flex and bison 'make' rules (Peter Eisentraut)
+ Add emacs macro to match Postgres perltidy formatting (Peter
+ Eisentraut)
</para>
+ </listitem>
+ <listitem>
<para>
- This is useful for pgxs authors.
+ Run tool to check the keyword list when the backend grammar is changed (Tom Lane)
</para>
</listitem>
<listitem>
<para>
- Add an embedded list interface (Andres Freund)
+ Standardize on naming of client-side memory allocation functions (Tom Lane)
</para>
</listitem>
<listitem>
<para>
- Add infrastructure to better support plug-in background worker
- processes (AlvaroAacute;lvaro Herrera)
+ Centralize flex and bison 'make' rules (Peter Eisentraut)
+ </para>
+
+ <para>
+ This is useful for pgxs authors.
</para>
</listitem>
@@ -1441,17 +1457,6 @@
</para>
</listitem>
- <listitem>
- <para>
- Create libpgcommon and move pg_malloc() and other functions there
- (AlvaroAacute;lvaro Herrera, Andres Freund)
- </para>
-
- <para>
- This allows libpgport to be used solely for porting code.
- </para>
- </listitem>
-
<listitem>
<para>
Invent pre-commit/pre-prepare/pre-subcommit events for transaction
@@ -1504,6 +1509,19 @@
</para>
</listitem>
+ <listitem>
+ <para>
+ Allow PL/Python to support platform-specific include directories (Peter Eisentraut)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Allow PL/Python on OS X to build against custom versions of Python
+ (Peter Eisentraut)
+ </para>
+ </listitem>
+
</itemizedlist>
</sect3>