From 6c34acce9bf3b39c142ea5954d6cc616d5cd9116 Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Thu, 9 Apr 2009 23:22:49 +0000
Subject: [PATCH] Update release notes through yesterday; some minor
wordsmithing.
---
doc/src/sgml/release.sgml | 409 +++++++++++++++++++++++++++++++-------
1 file changed, 337 insertions(+), 72 deletions(-)
diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index a13828d52c9..e5c2b7ac2d4 100644
--- a/doc/src/sgml/release.sgml
+++ b/doc/src/sgml/release.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.625 2009/04/09 17:39:47 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.626 2009/04/09 23:22:49 tgl Exp $ -->
<!--
Typical markup:
@@ -69,7 +69,7 @@ do it for earlier branch release files.
<note>
<title>Release date</title>
- <simpara>2009-XX-XX, ITEMS CURRENT AS OF 2009-03-16</simpara>
+ <simpara>2009-XX-XX, ITEMS CURRENT AS OF 2009-04-08</simpara>
</note>
<sect2>
@@ -89,7 +89,97 @@ do it for earlier branch release files.
<listitem>
<para>
- *MAJOR ITEM LIST GOES HERE*
+ Windowing Functions
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Common Table Expressions and Recursive Joins
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Default and variadic parameters for functions
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Parallel Restore
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Column Permissions
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Per-database locale settings
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Improved hash indexes
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Improved join performance for EXISTS and NOT EXISTS queries
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Easier-to-use Warm Standby
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Automatic sizing of the Free Space Map
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Visibility Map (greatly reduces vacuum overhead for slowly-changing tables)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Version-aware psql (backslash commands work against older servers)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Support SSL certificates for authentication
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Per-function runtime statistics
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Easy editing of functions in psql
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ New contrib modules: pg_stat_statements, auto_explain, citext, btree_gin
</para>
</listitem>
@@ -150,24 +240,24 @@ do it for earlier branch release files.
<listitem>
<para>
- Change <filename>postgresql.conf</> default for log_min_messages
- to <literal>warning</> (previously <literal>notice</>) to reduce
- log file volume (Tom)
+ Change <filename>postgresql.conf</> default for
+ <literal>log_min_messages</> to <literal>warning</> (previously
+ <literal>notice</>) to reduce log file volume (Tom)
</para>
</listitem>
<listitem>
<para>
- Have debug_print_parse, debug_print_rewritten, and debug_print_plan
- output appear as <literal>LOG</> message level, not
- <literal>DEBUG1</> (Tom) bjm: inconsistency because of var
- names?
+ Have <literal>debug_print_parse</>, <literal>debug_print_rewritten</>,
+ and <literal>debug_print_plan</>
+ output appear at <literal>LOG</> message level, not
+ <literal>DEBUG1</> as formerly (Tom)
</para>
</listitem>
<listitem>
<para>
- Have debug_pretty_print default to on (Tom)
+ Make <literal>debug_pretty_print</> default to <literal>on</> (Tom)
</para>
</listitem>
@@ -181,7 +271,7 @@ do it for earlier branch release files.
<listitem>
<para>
Disable appending of the epoch date/time when no <literal>%</>
- escapes are present in log_filename (Robert Haas)
+ escapes are present in <literal>log_filename</> (Robert Haas)
</para>
<para>
@@ -240,16 +330,15 @@ do it for earlier branch release files.
<listitem>
<para>
- Have children inherit <literal>CHECK</> constraints from parents
+ Force child tables to inherit <literal>CHECK</> constraints from parents
(Alex Hunsaker, Nikhil Sontakke, Tom Lane)
</para>
- </listitem>
- <listitem>
<para>
- Force child tables to have the same <literal>CHECK</> constraints
- as parents (Alex Hunsaker, Nikhil Sontakke, Tom Lane) bjm:
- verify
+ Formerly it was possible to delete such a constraint from a child
+ table, allowing rows that violate the constraint to be visible
+ when scanning the parent table. This was deemed inconsistent,
+ as well as contrary to SQL standard.
</para>
</listitem>
@@ -284,13 +373,6 @@ do it for earlier branch release files.
</para>
</listitem>
- <listitem>
- <para>
- Make <command>DISCARD ALL</> also discard advisory locks (Marko
- Kreen)
- </para>
- </listitem>
-
</itemizedlist>
</sect3>
@@ -320,7 +402,7 @@ do it for earlier branch release files.
</para>
<para>
- The changed behavior is more <acronym>IEEE</>-standards
+ The changed behavior is more <acronym>IEEE</>-standard
compliant.
</para>
</listitem>
@@ -335,16 +417,37 @@ do it for earlier branch release files.
<listitem>
<para>
Remove <literal>~=~</> and <literal>~<>~</> operators
- used for <literal>LIKE</> index comparisons (Tom) bjm: needed,
- pg_upgrade impact?
+ formerly used for <literal>LIKE</> index comparisons (Tom)
+ </para>
+
+ <para>
+ Pattern indexes now use the regular equality operator.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <function>xpath()</> now passes its arguments to <application>libxml</>
+ without any changes (Andrew)
+ </para>
+
+ <para>
+ This means that the XML argument must be a well-formed XML document.
+ The previous coding attempted to allow XML fragments, but it did not
+ work well.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Make <function>xmlelement()</> format attribute values just like
+ content values (Peter)
</para>
<para>
- A not-immediately-obvious incompatibility is that the sort
- order within <literal>bpchar_pattern_ops</> indexes changes
- --- it had been identical to plain <function>strcmp()</>, but
- is now trailing-blank-insensitive. This will impact in-place
- upgrades, if those ever happen.
+ Previously, attribute values were formatted according to the
+ normal SQL output behavior, which is sometimes at odds with
+ XML rules.
</para>
</listitem>
@@ -452,11 +555,13 @@ do it for earlier branch release files.
</para>
<para>
- This causes <command>SELECT DISTINCT</> no longer always produces
- sorted output; add an <literal>ORDER BY</> clause. The old
- <literal>SELECT DISTINCT</> behavior can be restored by disabling
- enable_hashagg. <literal>SELECT DISTINCT ON</> does not use
- hashing. bjm: enable_hashagg accurate?
+ This means that these types of queries no longer automatically
+ produce sorted output. The recommended response is to add an
+ <literal>ORDER BY</> clause if needed. As a short-term workaround,
+ the previous behavior can be restored by
+ disabling <literal>enable_hashagg</>, but that is a very
+ performance-expensive fix. <literal>SELECT DISTINCT ON</> never
+ uses hashing.
</para>
</listitem>
@@ -468,7 +573,7 @@ do it for earlier branch release files.
<para>
While semi-joins merely replace existing <literal>IN</> joins,
anti-joins are a new capability for <literal>NOT EXISTS</>
- clauses (Tom) This improves optimization possibilities.
+ clauses. This improves optimization possibilities.
</para>
</listitem>
@@ -560,6 +665,29 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Improve performance of multi-batch hash joins by providing a special
+ case for join key values that are especially common in the outer
+ relation (Bryce Cutt, Ramon Lawrence)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Reduce volume of temporary data in multi-batch hash joins
+ by suppressing <quote>physical tlist</> optimization (Michael
+ Henderson, Ramon Lawrence)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Avoid waiting for idle-in-transaction sessions during
+ <command>CREATE INDEX CONCURRENTLY</> (Simon)
+ </para>
+ </listitem>
+
</itemizedlist>
</sect3>
@@ -742,6 +870,18 @@ do it for earlier branch release files.
<title>Continuous Archiving</title>
<itemizedlist>
+ <listitem>
+ <para>
+ Provide an option to <function>pg_start_backup()</> to force its
+ implied checkpoint to finish as quickly as possible (Tom)
+ </para>
+
+ <para>
+ The default behavior avoids excess I/O consumption, but that is
+ pointless if no concurrent query activity is going on.
+ </para>
+ </listitem>
+
<listitem>
<para>
Have <function>pg_stop_backup()</> wait for modified <acronym>WAL</>
@@ -910,10 +1050,8 @@ do it for earlier branch release files.
<listitem>
<para>
- Support set-returning functions in the target lists of Agg and
- Group plan nodes. This is a pretty ugly feature but since we
- don't yet have a plausible substitute, we'd better support it
- everywhere (Tom) bjm: details?
+ Support set-returning functions in the output of aggregation
+ and grouping queries (Tom)
</para>
</listitem>
@@ -932,34 +1070,32 @@ do it for earlier branch release files.
<para>
There are no remote or external <acronym>SQL/MED</> capabilities
- yet. bjm: accurate?
+ yet, but this change provides a standardized and future-proof
+ system for managing connection information for modules like
+ dblink and plproxy.
</para>
</listitem>
<listitem>
<para>
- Invalidate cached plans when schemas, operators, or operator
- classes are modified (Tom) bjm: effect?
+ Invalidate cached plans when referenced schemas, functions, operators,
+ or operator classes are modified (Martin Pihlak, Tom)
</para>
- </listitem>
- <listitem>
<para>
- Improve the plan cache invalidation mechanism to make it
- invalidate plans when user-defined functions used in a plan
- are modified (Tom, Martin Pihlak) bjm: explain
+ This improves the system's ability to respond to on-the-fly
+ DDL changes.
</para>
</listitem>
-
<listitem>
<para>
Allow comparison of composite types and allow arrays of
- possibly-anonymous composite types (Tom) bjm: clear?
+ anonymous composite types (Tom)
</para>
<para>
- Specifically this allows <literal>array[ row(1,2), row(3,4)]</>
- and <literal>row(1,1.1) = any (array[ row(7,7.7), row(1,1.0)</>.
+ Specifically this allows <literal>array[row(1,2), row(3,4)]</>
+ and <literal>row(1,1.1) = any (array[row(7,7.7), row(1,1.0)])</>.
This is particularly useful for recursive queries.
</para>
</listitem>
@@ -1036,6 +1172,13 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Make <command>EXPLAIN</> identify subplans and initplans with
+ individual labels (Tom)
+ </para>
+ </listitem>
+
<listitem>
<para>
Have <command>EXPLAIN</> honor <varname>debug_print_plan</> (Tom)
@@ -1072,11 +1215,12 @@ do it for earlier branch release files.
<listitem>
<para>
- Add <acronym>SQL</>-standards syntax for
+ Add <acronym>SQL</>-standard syntax for
<literal>LIMIT</>/<literal>OFFSET</> capabilities (Peter)
</para>
<para>
+ To wit,
<literal>OFFSET num {ROW|ROWS} FETCH {FIRST|NEXT} [num] {ROW|ROWS}
ONLY</>.
</para>
@@ -1139,7 +1283,8 @@ do it for earlier branch release files.
</para>
<para>
- This simplifies creation of data types like existing types.
+ This simplifies creation of data types that use the same internal
+ representation as an existing type.
</para>
</listitem>
@@ -1335,8 +1480,19 @@ do it for earlier branch release files.
<listitem>
<para>
- Special xxx_pattern_ops <literal>LIKE</> indexes can now be
- used for simple equality comparisons (Tom)
+ Implement fast update for GIN indexes (Teodor, Oleg)
+ </para>
+
+ <para>
+ This option greatly improves update speed at a small penalty in search
+ speed.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <literal>xxx_pattern_ops</> indexes can now be used for simple
+ equality comparisons, not only <literal>LIKE</> (Tom)
</para>
</listitem>
@@ -1381,6 +1537,12 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Improve support for Nepali language and Devanagari alphabet (Teodor)
+ </para>
+ </listitem>
+
<listitem>
<para>
Support multi-column <acronym>GIN</> indexes (Teodor Sigaev)
@@ -1506,6 +1668,13 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Allow spaces around <literal>NaN</> in the input string for
+ type <type>numeric</> (Sam Mason)
+ </para>
+ </listitem>
+
</itemizedlist>
<sect4>
@@ -1949,11 +2118,7 @@ do it for earlier branch release files.
<listitem>
<para>
Improve the <literal>RAISE</> command: (Pavel Stehule)
- </para>
- </listitem>
- <listitem>
- <para>
<itemizedlist>
<listitem>
<para>
@@ -2004,12 +2169,27 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Make <command>FETCH</> and <command>MOVE</> set the
+ <command>GET DIAGNOSTICS</> <literal>ROW_COUNT</> variable
+ (Andrew Gierth)
+ </para>
+ </listitem>
+
<listitem>
<para>
Add message translation support (Alvaro)
</para>
</listitem>
+ <listitem>
+ <para>
+ Avoid memory leakage when the same function is called at varying
+ exception-block nesting depths (Tom)
+ </para>
+ </listitem>
+
</itemizedlist>
</sect4>
@@ -2181,12 +2361,14 @@ do it for earlier branch release files.
<listitem>
<para>
- Have all <command>\d*</> commands show system objects only
- if <literal>S</> is specified (Greg Sabino Mullane)
+ Make <command>\d*</> commands that do not have a pattern argument
+ show system objects only if the <literal>S</> modifier is specified
+ (Greg Sabino Mullane, Bruce)
</para>
<para>
- <command>\dt</> already behaved this way. bjm: accuate?
+ The former behavior was inconsistent across different variants
+ of <command>\d</>, and provided no easy way to see just user objects.
</para>
</listitem>
@@ -2221,6 +2403,20 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Make <command>\df</> not hide functions that take or return
+ type <type>cstring</> (Tom)
+ </para>
+
+ <para>
+ Previously, such functions were hidden because most of them are
+ datatype I/O functions, which were deemed uninteresting. The new
+ policy about hiding system functions by default makes this wart
+ unnecessary.
+ </para>
+ </listitem>
+
</itemizedlist>
</sect4>
@@ -2240,7 +2436,22 @@ do it for earlier branch release files.
<listitem>
<para>
- Remove <literal>-i</>/<literal>--ignore-version</> option from
+ Remove <option>-d</> and <option>-D</> options from
+ <application>pg_dump</> and <application>pg_dumpall</> (Tom)
+ </para>
+
+ <para>
+ These options were too frequently confused with the option to
+ select a database name in other <productname>PostgreSQL</>
+ client applications. The functionality is still available,
+ but you must spell out the long option name
+ <option>--inserts</> or <option>--column-inserts</>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Remove <option>-i</>/<option>--ignore-version</> option from
<application>pg_dump</> and <application>pg_dumpall</> (Tom)
</para>
@@ -2261,7 +2472,7 @@ do it for earlier branch release files.
<listitem>
<para>
Add <application>pg_dump</>/<application>pg_dumpall</> option
- <literal>--lock-wait-timeout</> (David Gould)
+ <option>--lock-wait-timeout</> (David Gould)
</para>
<para>
@@ -2411,15 +2622,22 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Add a <function>PQinitOpenSSL</> function to allow greater control
+ over OpenSSL/libcrypto initialization (Andrew Chernow)
+ </para>
+ </listitem>
+
<listitem>
<para>
Properly unregister <application>OpenSSL</> callbacks when
- libpq is done with all connection (Bruce, Magnus, Russell Smith)
+ libpq is done with all connections (Bruce, Magnus, Russell Smith)
</para>
<para>
- This is required for applications that unload the libpq library
- so no invalid <application>OpenSSL</> callbacks remain.
+ This is required for applications that unload the libpq library,
+ otherwise invalid <application>OpenSSL</> callbacks will remain.
</para>
</listitem>
@@ -2572,6 +2790,18 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Use the system's <function>getopt_long()</> on <productname>Solaris</>
+ (Zdenek Kotala, Tom)
+ </para>
+
+ <para>
+ This makes option processing more consistent with what Solaris users
+ expect.
+ </para>
+ </listitem>
+
<listitem>
<para>
Add support for the <productname>Sun Studio</> compiler on
@@ -2628,6 +2858,13 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Improve <application>gettext</> support to allow better translation
+ of plurals (Peter)
+ </para>
+ </listitem>
+
<listitem>
<para>
Add <application>DTrace</> probes (Robert Lor)
@@ -2648,6 +2885,13 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Add a <structfield>relistemp</> column to <structname>pg_class</>
+ to ease identification of temporary tables (Tom)
+ </para>
+ </listitem>
+
<listitem>
<para>
Improve logic for shared cache invalidation (Tom)
@@ -2656,7 +2900,7 @@ do it for earlier branch release files.
<listitem>
<para>
- Make <type>name</> char-aligned (Tom) bjm: pg_upgrade?
+ Make <type>name</> char-aligned (Tom)
</para>
</listitem>
@@ -2784,6 +3028,13 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Add <filename>/contrib/btree_gin</> to allow GIN indexes to
+ handle more datatypes (Oleg, Teodor)
+ </para>
+ </listitem>
+
<listitem>
<para>
Add <filename>/contrib/citext</> as a case-insensitive,
@@ -2831,6 +3082,20 @@ do it for earlier branch release files.
</para>
</listitem>
+ <listitem>
+ <para>
+ Remove <filename>/contrib/intarray</>'s definitions of the
+ <literal><@</> and <literal>@></> operators (Tom)
+ </para>
+
+ <para>
+ This avoids confusion with the equivalent built-in operators.
+ If necessary, the <filename>/contrib/intarray</> implementations
+ are still available under their historical names <literal>@</>
+ and <literal>~</>.
+ </para>
+ </listitem>
+
<listitem>
<para>
Add <filename>/contrib/auto_explain</> to automatically run
--
GitLab