From 751c4818bf428b250498765c571c11e905a15e8a Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Fri, 6 Jan 2006 03:00:46 +0000
Subject: [PATCH] Release-note updates and copy editing.

---
 doc/src/sgml/release.sgml | 41 ++++++++++++++++++++++++---------------
 1 file changed, 25 insertions(+), 16 deletions(-)

diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index 40a03652ee8..673f54723a7 100644
--- 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.163.2.28 2006/01/05 15:17:08 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.163.2.29 2006/01/06 03:00:46 tgl Exp $
 -->
 
 <appendix id="release">
@@ -24,6 +24,9 @@ $Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.163.2.28 2006/01/05 15:17:
      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>
 
@@ -32,26 +35,32 @@ $Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.163.2.28 2006/01/05 15:17:
   
 <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 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>Fix bug in strpos() and regular expression handling in
-certain rarely used Asian multi-byte character sets (Tatsuo)
+<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>
+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>
-
-<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>