More 9.3 release note reorderings

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 "&amp;unspecified&amp;".
-        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 "&amp;unspecified&amp;".
+        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
+        Add support for ALTER RULE ... RENAME (Ali Dar)
-        Dunstan)
-       </para>
-
-       <para>
-        This is useful for conditional label creation in transaction blocks.
        </para>
       </listitem>
 
@@ -790,8 +790,15 @@
 
       <listitem>
        <para>
-        When converting a table to a view, remove its system columns (Tom Lane)
+        Add a materialized view relations (Kevin Grittner)
-        KEEP?
+       </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)
+        When converting a table to a view, remove its system columns (Tom Lane)
-       </para>
+        KEEP?
-
-       <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>
 
@@ -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
+        Allow concat() and format() to properly expand VARIADIC-labeled
-        negative century designations (CC) (Bruce Momjian)
+        arguments (Pavel Stehule)
        </para>
+      </listitem>
 
+      <listitem>
        <para>
-        Previously the behavior was either wrong or inconsistent with
+        Improve format() to handle field width and left/right alignment
-        positive/AD handling, e.g. format mask 'IYYY-IW-DY'.
+        (Pavel Stehule)
        </para>
       </listitem>
 
       <listitem>
        <para>
-        In to_date() and to_timestamp(), return proper results when mixing
+        Have to_char(), to_date(), and to_timestamp() properly handle
-        ISO and Gregorian week/day designations (Bruce Momjian)
+        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
+        Have to_date() and to_timestamp() return proper results when mixing
-        arguments (Pavel Stehule)
+        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
+        Allow greater flexibility in where keywords can be used in PL/pgSQL (Tom Lane)
-        Rehman)
-       </para>
-
-       <para>
-        Previously RETURN could only reference composite-type variables.
        </para>
       </listitem>
 
@@ -1024,37 +1034,24 @@
 
       <listitem>
        <para>
-        Allow PL/Python to support platform-specific include directories (Peter Eisentraut)
+        Add PL/Python result object string handler (Peter Eisentraut)
-       </para>
-      </listitem>
-
-      <listitem>
-       <para>
-        Allow PL/Python on OS X to build against custom versions of Python
-        (Peter Eisentraut)
        </para>
-      </listitem>
 
-      <listitem>
        <para>
-        Handle SPIErrors raised explicitly with PL/Python's RAISE the same as
+        This allows plpy.debug(rv) to output something reasonable.
-        as internal SPI errors (Oskari Saarenmaa and Jan Urbanski)
        </para>
       </listitem>
 
       <listitem>
        <para>
-        Add PL/Python result object string handler (Peter Eisentraut)
+        Have PL/Python convert oid values to a proper Python numeric type (Peter Eisentraut)
-       </para>
-
-       <para>
-        This allows plpy.debug(rv) to output something reasonable.
        </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)
+        Add command-line utility pg_isready to check if the server is ready
-       </para>
+        to accept connections (Phil Sorber)
-
-       <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>
 
@@ -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
+        Adjust function cost settings so psql tab completion and pattern
-        standard input (Fabien Coelho, Robert Haas)
+        searching is more efficient (Tom Lane)
-       </para>
-
-       <para>
-        Previously this option only worked when reading from a file.
        </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
+        Remove psql warning when connecting to an older server (Peter Eisentraut)
-        searching is more efficient (Tom Lane)
+       </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
+        Add psql command \gset to store query results in psql variables
-        connection (Bruce Momjian)
+        (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
+        This might be the case if the server had crashed.
-        (Pavel Stehule)
        </para>
       </listitem>
 
       <listitem>
        <para>
-        Add psql \watch command to repeatedly execute commands (Will
+        Properly reset state if psql's "\g file" command failed (Tom Lane)
-        Leinweber)
        </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
+        Add pg_dump --jobs to dump in parallel (Joachim Wieland)
-        conformant (Brian Weaver, Tom Lane)
        </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
+        Rewrite pgindent in Perl (Andrew Dunstan)
-        Eisentraut)
        </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
+        Centralize flex and bison 'make' rules (Peter Eisentraut)
-        processes  (AlvaroAacute;lvaro Herrera)
+       </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>