Commit 9eced003 authored by Bruce Momjian's avatar Bruce Momjian

Split release notes up into smaller sections; easier to read.

parent e66d0c62
<!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.553 2007/11/20 05:23:20 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.554 2007/11/20 17:10:25 momjian Exp $ -->
<!-- <!--
Typical markup: Typical markup:
...@@ -232,6 +232,8 @@ do it for earlier branch release files. ...@@ -232,6 +232,8 @@ do it for earlier branch release files.
Observe the following incompatibilities: Observe the following incompatibilities:
</para> </para>
<sect3>
<title>General</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
...@@ -300,43 +302,23 @@ current_date &lt; 2017-11-17 ...@@ -300,43 +302,23 @@ current_date &lt; 2017-11-17
<listitem> <listitem>
<para> <para>
Numerous changes in administrative server parameters <literal>ARRAY(SELECT ...)</literal>, where the <command>SELECT</>
</para> returns no rows, now returns an empty array, rather than NULL
(Tom)
<para>
<varname>bgwriter_lru_percent</>,
<varname>bgwriter_all_percent</>,
<varname>bgwriter_all_maxpages</>,
<varname>stats_start_collector</>, and
<varname>stats_reset_on_server_start</> are removed.
<varname>redirect_stderr</> is renamed to
<varname>logging_collector</>.
<varname>stats_command_string</> is renamed to
<varname>track_activities</>.
<varname>stats_block_level</> and <varname>stats_row_level</>
are merged into <varname>track_counts</>.
A new boolean configuration parameter, <varname>archive_mode</>,
controls archiving. Autovacuum's default settings have changed.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Commenting out a parameter in <filename>postgresql.conf</> now The array type name for a base data type is no longer always the base
causes it to revert to its default value (Joachim Wieland) type's name with an underscore prefix
</para>
<para>
Previously, commenting out an entry left the parameter's value unchanged
until the next server restart.
</para> </para>
</listitem>
<listitem>
<para> <para>
<literal>ARRAY(SELECT ...)</literal>, where the <command>SELECT</> The old naming convention is still honored when possible, but
returns no rows, now returns an empty array, rather than NULL application code should no longer depend on it. Instead
(Tom) use the new <literal>pg_type.typarray</literal> column to
identify the array data type associated with a given type.
</para> </para>
</listitem> </listitem>
...@@ -352,20 +334,6 @@ current_date &lt; 2017-11-17 ...@@ -352,20 +334,6 @@ current_date &lt; 2017-11-17
</para> </para>
</listitem> </listitem>
<listitem>
<para>
The array type name for a base data type is no longer always the base
type's name with an underscore prefix
</para>
<para>
The old naming convention is still honored when possible, but
application code should no longer depend on it. Instead
use the new <literal>pg_type.typarray</literal> column to
identify the array data type associated with a given type.
</para>
</listitem>
<listitem> <listitem>
<para> <para>
<command>SET LOCAL</command> changes now persist until <command>SET LOCAL</command> changes now persist until
...@@ -410,6 +378,25 @@ current_date &lt; 2017-11-17 ...@@ -410,6 +378,25 @@ current_date &lt; 2017-11-17
</para> </para>
</listitem> </listitem>
<listitem>
<para>
<command>ALTER SEQUENCE</> no longer affects <function>currval()</>
(Tom)
</para>
</listitem>
<listitem>
<para>
Foreign keys now must match indexable conditions for
cross-data-type references (Tom)
</para>
<para>
This improves semantic consistency and helps avoid
performance problems.
</para>
</listitem>
<listitem> <listitem>
<para> <para>
Restrict object size functions to users who have reasonable Restrict object size functions to users who have reasonable
...@@ -427,43 +414,69 @@ current_date &lt; 2017-11-17 ...@@ -427,43 +414,69 @@ current_date &lt; 2017-11-17
<listitem> <listitem>
<para> <para>
Internal hashing functions are now more uniformly-distributed (Tom) Remove the undocumented <literal>!!=</> (not in) operator (Tom)
</para> </para>
<para> <para>
If application code was computing and storing hash values using <literal>NOT IN (SELECT ...)</literal> is the proper way to
internal <productname>PostgreSQL</> hashing functions, the hash perform this operation.
values must be regenerated.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<command>ALTER SEQUENCE</> no longer affects <function>currval()</> Internal hashing functions are now more uniformly-distributed (Tom)
(Tom) </para>
<para>
If application code was computing and storing hash values using
internal <productname>PostgreSQL</> hashing functions, the hash
values must be regenerated.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Foreign keys now must match indexable conditions for C-code conventions for handling variable-length data values
cross-data-type references (Tom) have changed (Greg Stark, Tom)
</para> </para>
<para> <para>
This improves semantic consistency and helps avoid The new <function>SET_VARSIZE()</> macro <emphasis>must</> be used
performance problems. to set the length of generated <type>varlena</> values. Also, it
might be necessary to expand (<quote>de-TOAST</quote>) input values
in more cases.
</para> </para>
</listitem> </listitem>
</itemizedlist>
</sect3>
<sect3>
<title>Configuration Parameters</title>
<itemizedlist>
<listitem> <listitem>
<para> <para>
Remove the undocumented <literal>!!=</> (not in) operator (Tom) Numerous changes in administrative server parameters
</para> </para>
<para> <para>
<literal>NOT IN (SELECT ...)</literal> is the proper way to <varname>bgwriter_lru_percent</>,
perform this operation. <varname>bgwriter_all_percent</>,
<varname>bgwriter_all_maxpages</>,
<varname>stats_start_collector</>, and
<varname>stats_reset_on_server_start</> are removed.
<varname>redirect_stderr</> is renamed to
<varname>logging_collector</>.
<varname>stats_command_string</> is renamed to
<varname>track_activities</>.
<varname>stats_block_level</> and <varname>stats_row_level</>
are merged into <varname>track_counts</>.
A new boolean configuration parameter, <varname>archive_mode</>,
controls archiving. Autovacuum's default settings have changed.
</para> </para>
</listitem> </listitem>
...@@ -491,24 +504,23 @@ current_date &lt; 2017-11-17 ...@@ -491,24 +504,23 @@ current_date &lt; 2017-11-17
<listitem> <listitem>
<para> <para>
C-code conventions for handling variable-length data values Commenting out a parameter in <filename>postgresql.conf</> now
have changed (Greg Stark, Tom) causes it to revert to its default value (Joachim Wieland)
</para> </para>
<para> <para>
The new <function>SET_VARSIZE()</> macro <emphasis>must</> be used Previously, commenting out an entry left the parameter's value unchanged
to set the length of generated <type>varlena</> values. Also, it until the next server restart.
might be necessary to expand (<quote>de-TOAST</quote>) input values
in more cases.
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</sect3>
<para>
The following incompatibilities relate to character encodings: <sect3>
</para> <title>Character Encodings</title>
<itemizedlist> <itemizedlist>
...@@ -603,6 +615,8 @@ current_date &lt; 2017-11-17 ...@@ -603,6 +615,8 @@ current_date &lt; 2017-11-17
</itemizedlist> </itemizedlist>
</sect3>
</sect2> </sect2>
<sect2> <sect2>
...@@ -888,6 +902,14 @@ current_date &lt; 2017-11-17 ...@@ -888,6 +902,14 @@ current_date &lt; 2017-11-17
</para> </para>
</listitem> </listitem>
<listitem>
<para>
Change server startup log message from <quote>database system is
ready</quote> to <quote>database system is ready to accept
connections</quote>
</para>
</listitem>
</itemizedlist> </itemizedlist>
</sect3> </sect3>
...@@ -1034,6 +1056,13 @@ current_date &lt; 2017-11-17 ...@@ -1034,6 +1056,13 @@ current_date &lt; 2017-11-17
</para> </para>
</listitem> </listitem>
<listitem>
<para>
Fix pgstats counting of live and dead tuples to recognize that
committed and aborted transactions have different effects (Tom)
</para>
</listitem>
</itemizedlist> </itemizedlist>
</sect3> </sect3>
...@@ -2128,17 +2157,9 @@ current_date &lt; 2017-11-17 ...@@ -2128,17 +2157,9 @@ current_date &lt; 2017-11-17
</sect3> </sect3>
<sect3> <sect3>
<title>Source Code</title> <title>Server Programming Interface (<acronym>SPI</>)</title>
<itemizedlist> <itemizedlist>
<listitem>
<para>
Rename macro <literal>DLLIMPORT</> to <literal>PGDLLIMPORT</> to
avoid conflicting with third party includes (like Tcl) that
define <literal>DLLIMPORT</> (Magnus)
</para>
</listitem>
<listitem> <listitem>
<para> <para>
Allow execution of cursor commands through Allow execution of cursor commands through
...@@ -2174,6 +2195,14 @@ current_date &lt; 2017-11-17 ...@@ -2174,6 +2195,14 @@ current_date &lt; 2017-11-17
</para> </para>
</listitem> </listitem>
</itemizedlist>
</sect3>
<sect3>
<title>Build Options</title>
<itemizedlist>
<listitem> <listitem>
<para> <para>
Add <application>configure</> <literal>--enable-profiling</> Add <application>configure</> <literal>--enable-profiling</>
...@@ -2191,8 +2220,9 @@ current_date &lt; 2017-11-17 ...@@ -2191,8 +2220,9 @@ current_date &lt; 2017-11-17
<listitem> <listitem>
<para> <para>
Create <quote>operator families</quote> to improve planning of Fix <acronym>PGXS</> so extensions can be built against PostgreSQL
queries involving cross-data-type comparisons (Tom) installations whose <application>pg_config</> program does not
appear first in the <varname>PATH</> (Tom)
</para> </para>
</listitem> </listitem>
...@@ -2203,42 +2233,50 @@ current_date &lt; 2017-11-17 ...@@ -2203,42 +2233,50 @@ current_date &lt; 2017-11-17
</para> </para>
</listitem> </listitem>
</itemizedlist>
</sect3>
<sect3>
<title>Source Code</title>
<itemizedlist>
<listitem> <listitem>
<para> <para>
Update GIN <function>extractQuery()</> API to allow signalling Rename macro <literal>DLLIMPORT</> to <literal>PGDLLIMPORT</> to
that nothing can satisfy the query (Teodor) avoid conflicting with third party includes (like Tcl) that
define <literal>DLLIMPORT</> (Magnus)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Move <literal>NAMEDATALEN</> definition from Create <quote>operator families</quote> to improve planning of
<filename>postgres_ext.h</> to <filename>pg_config_manual.h</> queries involving cross-data-type comparisons (Tom)
(Peter)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Change server startup log message from <quote>database system is Update GIN <function>extractQuery()</> API to allow signalling
ready</quote> to <quote>database system is ready to accept that nothing can satisfy the query (Teodor)
connections</quote>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Provide <function>strlcpy()</function> and Move <literal>NAMEDATALEN</> definition from
<function>strlcat()</function> on all platforms, and replace <filename>postgres_ext.h</> to <filename>pg_config_manual.h</>
error-prone uses of <function>strncpy()</function>, (Peter)
<function>strncat()</function>, etc (Peter)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Fix pgstats counting of live and dead tuples to recognize that Provide <function>strlcpy()</function> and
committed and aborted transactions have different effects (Tom) <function>strlcat()</function> on all platforms, and replace
error-prone uses of <function>strncpy()</function>,
<function>strncat()</function>, etc (Peter)
</para> </para>
</listitem> </listitem>
...@@ -2266,20 +2304,12 @@ current_date &lt; 2017-11-17 ...@@ -2266,20 +2304,12 @@ current_date &lt; 2017-11-17
<listitem> <listitem>
<para> <para>
Have <function>quote_identifier()</function> and <function>quote_identifier()</function> and
<application>pg_dump</application> not quote keywords that are <application>pg_dump</application> no longer quote keywords that are
unreserved according to the grammar (Tom) unreserved according to the grammar (Tom)
</para> </para>
</listitem> </listitem>
<listitem>
<para>
Fix <acronym>PGXS</> so extensions can be built against PostgreSQL
installations whose <application>pg_config</> program does not
appear first in the <varname>PATH</> (Tom)
</para>
</listitem>
<listitem> <listitem>
<para> <para>
Change the on-disk representation of the <type>NUMERIC</type> Change the on-disk representation of the <type>NUMERIC</type>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment