Release-note updates and copy editing.

diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index 5154a4b8c457393a8de92661926131edb9468a31..1dfed85090a1089d3b275ba4d26166dd52cb5b09 100644 (file)
--- a/doc/src/sgml/release.sgml
+++ b/doc/src/sgml/release.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.235.2.38 2006/01/05 15:17:40 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.235.2.39 2006/01/06 03:00:34 tgl Exp $
 -->
 
 <appendix id="release">
@@ -24,6 +24,9 @@ $Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.235.2.38 2006/01/05 15:17:
      A dump/restore is not required for those running 7.4.X.  However,
      if you are upgrading from a version earlier than 7.4.8, see the release
      notes for 7.4.8.
+     Also, you might need to <command>REINDEX</> indexes on textual
+     columns after updating, if you are affected by the locale or
+     <application>plperl</> issues described below.
     </para>
    </sect2>
 
@@ -32,29 +35,35 @@ $Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.235.2.38 2006/01/05 15:17:
   
 <itemizedlist>
 
-<listitem><para>Fix for protocol-level describe portal statements issued
-outside a transaction (Tom)</para></listitem>
-
-<listitem><para>Fix character set sorting for locales that consider
-different character combinations to have the same sorting, e.g.
-Hungarian. (Tom) </para><para>This might require <command>REINDEX</> in
-those locales to fix  existing indexes.</para></listitem>
-
-<listitem><para>Fix bug in strpos() and regular expression handling in
-certain rarely used Asian multi-byte character sets (Tatsuo)
+<listitem><para>Fix for protocol-level Describe messages issued
+outside a transaction or in a failed transaction (Tom)</para></listitem>
+
+<listitem><para>Fix character string comparison for locales that consider
+different character combinations as equal, such as Hungarian (Tom)</para>
+<para>This might require <command>REINDEX</> to fix existing indexes on
+textual columns.</para></listitem>
+
+<listitem><para>Set locale environment variables during postmaster startup
+to ensure that <application>plperl</> won't change the locale later</para>
+<para>This fixes a problem that occurred if the <application>postmaster</> was
+started with environment variables specifying a different locale than what
+<application>initdb</> had been told.  Under these conditions, any use of
+<application>plperl</> was likely to lead to corrupt indexes.  You may need
+<command>REINDEX</> to fix existing indexes on
+textual columns if this has happened to you.</para></listitem>
+
+<listitem><para>Fix longstanding bug in strpos() and regular expression
+handling in certain rarely used Asian multi-byte character sets (Tatsuo)
 </para></listitem>
 
 <listitem><para>Fix bug in <filename>/contrib/pgcrypto</> gen_salt,
-which caused it not to use all available salt space for md5 and
-xdes algorithms (Marko Kreen, Solar Designer)</para>
-<para>Salts for blowfish and standard des are unaffected</para></listitem>
-
-<listitem><para>Fix <filename>/contrib/dblink</> to throw an error
-when the number of columns specified is different from those returned
-by the query (Joe)</para></listitem>
+which caused it not to use all available salt space for MD5 and
+XDES algorithms (Marko Kreen, Solar Designer)</para>
+<para>Salts for Blowfish and standard DES are unaffected.</para></listitem>
 
-<listitem><para>Set <literal>LC_XXX</> variables to prevent problems
-with <application>plperl</> processing (Tom)</para></listitem>
+<listitem><para>Fix <filename>/contrib/dblink</> to throw an error,
+rather than crashing, when the number of columns specified is different from
+what's actually returned by the query (Joe)</para></listitem>
 
 </itemizedlist>
 
@@ -2763,6 +2772,9 @@ DROP SCHEMA information_schema CASCADE;
      A dump/restore is not required for those running 7.3.X.  However,
      if you are upgrading from a version earlier than 7.3.10, see the release
      notes for 7.3.10.
+     Also, you might need to <command>REINDEX</> indexes on textual
+     columns after updating, if you are affected by the locale or
+     <application>plperl</> issues described below.
     </para>
    </sect2>
 
@@ -2771,23 +2783,32 @@ DROP SCHEMA information_schema CASCADE;
   
 <itemizedlist>
 
-<listitem><para>Fix character set sorting for locales that consider
-different character combinations to have the same sorting, e.g.
-Hungarian. (Tom) </para><para>This might require <command>REINDEX</> in
-those locales to fix  existing indexes.</para></listitem>
-
-<listitem><para>Fix long standing Asian multibyte charsets bug (Tatsuo)
+<listitem><para>Fix character string comparison for locales that consider
+different character combinations as equal, such as Hungarian (Tom)</para>
+<para>This might require <command>REINDEX</> to fix existing indexes on
+textual columns.</para></listitem>
+
+<listitem><para>Set locale environment variables during postmaster startup
+to ensure that <application>plperl</> won't change the locale later</para>
+<para>This fixes a problem that occurred if the <application>postmaster</> was
+started with environment variables specifying a different locale than what
+<application>initdb</> had been told.  Under these conditions, any use of
+<application>plperl</> was likely to lead to corrupt indexes.  You may need
+<command>REINDEX</> to fix existing indexes on
+textual columns if this has happened to you.</para></listitem>
+
+<listitem><para>Fix longstanding bug in strpos() and regular expression
+handling in certain rarely used Asian multi-byte character sets (Tatsuo)
 </para></listitem>
 
-<listitem><para>Fix bug in <filename>/contrib/pgcrypto</> Openwall
-gen_salt processing (Marko Kreen></para></listitem>
-
-<listitem><para>Fix <filename>/contrib/dblink</> to throw an error
-when the number of columns specified is different from those returned
-by the query (Joe)</para></listitem>
+<listitem><para>Fix bug in <filename>/contrib/pgcrypto</> gen_salt,
+which caused it not to use all available salt space for MD5 and
+XDES algorithms (Marko Kreen, Solar Designer)</para>
+<para>Salts for Blowfish and standard DES are unaffected.</para></listitem>
 
-<listitem><para>Set <literal>LC_XXX</> variables to prevent problems
-with <application>plperl</> processing (Tom)</para></listitem>
+<listitem><para>Fix <filename>/contrib/dblink</> to throw an error,
+rather than crashing, when the number of columns specified is different from
+what's actually returned by the query (Joe)</para></listitem>
 
 </itemizedlist>