diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index fcb9c01fc0..80b7b5d4bf 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.489 2007/01/05 20:05:02 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.490 2007/01/05 22:34:35 tgl Exp $ -->
 <!--
 
 Typical markup:
@@ -62,24 +62,20 @@ links to the main documentation.
 
      <listitem>
       <para>
-       Fix <literal>SELECT</> ... <literal>LIMIT NULL</> to behave as
-       <literal>LIMIT ALL</> (Tom)
-      </para>
-
-      <para>
-       A bug in 8.2.0 caused the server to crash.
+       Fix crash with <literal>SELECT</> ... <literal>LIMIT ALL</> (also
+       <literal>LIMIT NULL</>) (Tom)
       </para>
      </listitem>
 
      <listitem>
       <para>
-       <filename>/contrib/tsearch2</> fixes (Teodor)
+       <filename>Several /contrib/tsearch2</> fixes (Teodor)
       </para>
      </listitem>
 
      <listitem>
       <para>
-       Fix WIN32 server log messages coming from the operating system to use
+       On Windows, make log messages coming from the operating system use
        <acronym>ASCII</> encoding (Hiroshi Saito)
       </para>
 
@@ -91,14 +87,31 @@ links to the main documentation.
 
      <listitem>
       <para>
-       Fix WIN32 linking of <application>pg_dump</> using <filename>win32.mak</>
+       Fix Windows linking of <application>pg_dump</> using
+       <filename>win32.mak</>
        (Hiroshi Saito)
       </para>
      </listitem>
 
      <listitem>
       <para>
-       Various fixes for outer join queries (Tom)
+       Fix planner mistakes for outer join queries (Tom)
+      </para>
+     </listitem>
+
+     <listitem>
+      <para>
+       Fix several problems in queries involving sub-SELECTs (Tom)
+      </para>
+     </listitem>
+
+     <listitem>
+      <para>
+       Fix potential crash in SPI during subtransaction abort (Tom)
+      </para>
+
+      <para>
+       This affects all PL functions since they all use SPI.
       </para>
      </listitem>
 
@@ -122,8 +135,8 @@ links to the main documentation.
 
      <listitem>
       <para>
-       Have <application>psql</> print multi-byte combining characters, rather
-       than output as <literal>\u</> (Tom)
+       Have <application>psql</> print multi-byte combining characters as
+       before, rather than output as <literal>\u</> (Tom)
       </para>
      </listitem>
 
@@ -133,7 +146,19 @@ links to the main documentation.
       </para>
 
       <para>
-         This improves <application>psql</> <literal>\d</> performance also.
+       This improves <application>psql</> <literal>\d</> performance also.
+      </para>
+     </listitem>
+
+     <listitem>
+      <para>
+       Make <application>pg_dumpall</> assume that databases have public
+       <literal>CONNECT</> privilege, when dumping from a pre-8.2 server (Tom)
+      </para>
+
+      <para>
+       This preserves the previous behavior that anyone can connect to a
+       database if allowed by <filename>pg_hba.conf</>.
       </para>
      </listitem>
 
@@ -399,7 +424,9 @@ links to the main documentation.
 
        <para>
         This allows the postmaster to pass arguments to each backend
-        without using <literal>-o</>.
+        without using <literal>-o</>.  Note that some options are now
+        only available as long-form options, because there were conflicting
+        single-letter options.
        </para>
       </listitem>
 
@@ -2730,29 +2757,59 @@ links to the main documentation.
 
      <listitem>
       <para>
-       Fix <application>pg_restore</> so it can restore a tar-format backup
-       that contains large object comments (Tom)
+       Fix <application>pg_restore</> to handle a tar-format backup
+       that contains large objects (blobs) with comments (Tom)
+      </para>
+     </listitem>
+
+      <listitem>
+       <para>
+        Fix <quote>failed to re-find parent key</> errors in
+        <command>VACUUM</> (Tom)
+       </para>
+      </listitem>
+
+      <listitem>
+       <para>
+        Clean out <filename>pg_internal.init</> cache files during server
+        restart (Simon)
+       </para>
+
+       <para>
+        This avoids a hazard that the cache files might contain stale
+        data after PITR recovery.
+       </para>
+      </listitem>
+
+      <listitem>
+       <para>
+        Fix race condition for truncation of a large relation across a
+        gigabyte boundary by <command>VACUUM</> (Tom)
+       </para>
+      </listitem>
+
+      <listitem>
+       <para>
+        Fix bug causing needless deadlock errors on row-level locks (Tom)
+       </para>
+      </listitem>
+
+      <listitem>
+       <para>
+        Fix bugs affecting multi-gigabyte hash indexes (Tom)
+       </para>
+      </listitem>
+
+     <listitem>
+      <para>
+       Fix possible deadlock in Windows signal handling (Teodor)
       </para>
      </listitem>
 
      <listitem>
       <para>
-       Fix <link linkend="SQL-VACUUM"><command>VACUUM</></link> to recover from
-       a rare problem during index page deletion/split (Tom)
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Fix point-in-time-recovery bug where stale status files could prevent
-       restore (Simon, Tom)
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Fix error when constructing an <literal>ARRAY[]</> made up of multiple empty
-       elements (Tom)
+       Fix error when constructing an <literal>ARRAY[]</> made up of multiple
+       empty elements (Tom)
       </para>
      </listitem>
 
@@ -2764,28 +2821,7 @@ links to the main documentation.
 
      <listitem>
       <para>
-       Improve savepoint and multi-transction row locking algorithms to avoid
-       erroneous deadlock cases (Tom)
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Fix problem with extending hash indexes that span multiple 1-gigabyte
-       segments (Tom)
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Fix problem where truncation of a multi-gigabyte table might cause
-       consistency problems with other backends (Tom)
-      </para>
-      </listitem>
-
-     <listitem>
-      <para>
-       Fix for Darwin/OS-X compiles (Tom)
+       Fix for Darwin (OS X) compilation (Tom)
       </para>
      </listitem>
 
@@ -2800,22 +2836,7 @@ links to the main documentation.
       <para>
        This is because <link
        linkend="guc-lc-numeric"><varname>lc_numeric</></link> can potentially
-       change the output of the functions.
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Update timezone database, particularly for Western Australia,
-       which has a new daylight savings date  (Tom)
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Document a risk that if a row is locked inside multiple sub-transactions
-       in the same transaction, and a sub-transaction is rolled back, the row
-       lock is lost (Tom)
+       change the output of these functions.
       </para>
      </listitem>
 
@@ -2829,6 +2850,17 @@ links to the main documentation.
       </para>
      </listitem>
 
+     <listitem>
+      <para>
+       Update timezone database
+      </para>
+
+      <para>
+       This affects Australian and Canadian daylight-savings rules in
+       particular.
+      </para>
+     </listitem>
+
     </itemizedlist>
 
    </sect2>
@@ -5533,10 +5565,29 @@ psql -t -f fixseq.sql db1 | psql -e db1
       </para>
      </listitem>
 
+      <listitem>
+       <para>
+        Fix <quote>failed to re-find parent key</> errors in
+        <command>VACUUM</> (Tom)
+       </para>
+      </listitem>
+
+      <listitem>
+       <para>
+        Fix race condition for truncation of a large relation across a
+        gigabyte boundary by <command>VACUUM</> (Tom)
+       </para>
+      </listitem>
+
+      <listitem>
+       <para>
+        Fix bugs affecting multi-gigabyte hash indexes (Tom)
+       </para>
+      </listitem>
+
      <listitem>
       <para>
-       Fix <link linkend="SQL-VACUUM"><command>VACUUM</></link> to recover from
-       a rare problem during index page deletion/split (Tom)
+       Fix possible deadlock in Windows signal handling (Teodor)
       </para>
      </listitem>
 
@@ -5553,20 +5604,6 @@ psql -t -f fixseq.sql db1 | psql -e db1
       </para>
      </listitem>
 
-     <listitem>
-      <para>
-       Fix problem with extending hash indexes that span multiple 1-gigabyte
-       segments (Tom)
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Fix problem where truncation of a multi-gigabyte table might cause
-       consistency problems with other backends (Tom)
-      </para>
-     </listitem>
-
      <listitem>
       <para>
        <function>to_number()</> and <function>to_char(numeric)</>
@@ -5578,22 +5615,7 @@ psql -t -f fixseq.sql db1 | psql -e db1
       <para>
        This is because <link
        linkend="guc-lc-numeric"><varname>lc_numeric</></link> can potentially
-       change the output of the functions.
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Update timezone database, particularly for Western Australia,
-       which has a new daylight savings date  (Tom)
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Document a risk that if a row is locked inside multiple sub-transactions
-       in the same transaction, and a sub-transaction is rolled back, the row
-       lock is lost (Tom)
+       change the output of these functions.
       </para>
      </listitem>
 
@@ -5607,6 +5629,17 @@ psql -t -f fixseq.sql db1 | psql -e db1
       </para>
      </listitem>
 
+     <listitem>
+      <para>
+       Update timezone database
+      </para>
+
+      <para>
+       This affects Australian and Canadian daylight-savings rules in
+       particular.
+      </para>
+     </listitem>
+
     </itemizedlist>
 
    </sect2>
@@ -8858,24 +8891,23 @@ typedefs (Michael)</para></listitem>
       </para>
      </listitem>
 
-     <listitem>
-      <para>
-       Fix <link linkend="SQL-VACUUM"><command>VACUUM</></link> to recover from
-       a rare problem during index page deletion/split (Tom)
-      </para>
-     </listitem>
+      <listitem>
+       <para>
+        Fix <quote>failed to re-find parent key</> errors in
+        <command>VACUUM</> (Tom)
+       </para>
+      </listitem>
+
+      <listitem>
+       <para>
+        Fix bugs affecting multi-gigabyte hash indexes (Tom)
+       </para>
+      </listitem>
 
      <listitem>
       <para>
-       Fix error when constructing an <literal>ARRAY[]</> made up of multiple empty
-       elements (Tom)
-      </para>
-     </listitem>
-
-     <listitem>
-      <para>
-       Fix problem with extending hash indexes that span multiple 1-gigabyte
-       segments (Tom)
+       Fix error when constructing an <literal>ARRAY[]</> made up of multiple
+       empty elements (Tom)
       </para>
      </listitem>
 
@@ -8890,7 +8922,7 @@ typedefs (Michael)</para></listitem>
       <para>
        This is because <link
        linkend="guc-lc-numeric"><varname>lc_numeric</></link> can potentially
-       change the output of the functions.
+       change the output of these functions.
       </para>
      </listitem>
 
@@ -11907,7 +11939,7 @@ DROP SCHEMA information_schema CASCADE;
       <para>
        This is because <link
        linkend="guc-lc-numeric"><varname>lc_numeric</></link> can potentially
-       change the output of the functions.
+       change the output of these functions.
       </para>
      </listitem>