diff --git a/doc/src/sgml/release-9.1.sgml b/doc/src/sgml/release-9.1.sgml
index 272304972d093cce4923f02e0dbf11e1a1d00a6f..34d5ea74dd65e2cbc1b9b621e1fcc2806cf71d42 100644
--- a/doc/src/sgml/release-9.1.sgml
+++ b/doc/src/sgml/release-9.1.sgml
@@ -71,8 +71,8 @@
    </para>
 
    <para>
-    Version 9.1 contains a number of changes that ...
-    Observe the following incompatibilities:
+    Version 9.1 contains a number of changes that may affect compatibility
+    with previous releases.  Observe the following incompatibilities:
    </para>
 
    <sect3>
@@ -617,6 +617,21 @@
        </para>
       </listitem>
 
+      <listitem>
+       <para>
+        Increase the maximum values for <xref linkend="guc-deadlock-timeout">,
+        <xref linkend="guc-max-standby-archive-delay">,
+        <xref linkend="guc-max-standby-streaming-delay">,
+        <xref linkend="guc-log-min-duration-statement">, and
+        <xref linkend="guc-log-autovacuum-min-duration">.
+       </para>
+
+       <para>
+        The maximum value for each of these parameters was previously
+        only about 35 minutes.  Much larger values are now allowed.
+       </para>
+      </listitem>
+
       </itemizedlist>
 
     </sect4>
@@ -694,6 +709,19 @@
       </para>
      </listitem>
 
+     <listitem>
+      <para>
+       <link linkend="auth-ident"><literal>ident</literal></link>
+       authentication over local sockets is now known as
+       <link linkend="auth-peer"><literal>peer</literal></link>
+       (Magnus Hagander)
+      </para>
+
+      <para>
+       The old term is still accepted for backward compatibility.
+      </para>
+     </listitem>
+
     </itemizedlist>
 
     <sect4>
@@ -1038,6 +1066,20 @@
        </para>
       </listitem>
 
+      <listitem>
+       <para>
+        Fix possible "tuple concurrently updated" error when two server
+        backends attempted to add an inheritance parent to the same
+        table at the same time (Robert Haas)
+       </para>
+
+       <para>
+        <xref linkend="sql-altertable"> now takes a stronger lock on the
+        parent table, so that both children do not try to update it
+        simultaneously.
+       </para>
+      </listitem>
+
      </itemizedlist>
 
     </sect4>
@@ -1459,7 +1501,9 @@
        </para>
 
        <para>
-        This function is used to obtain comments on objects.
+        This function is used to obtain a human-readable string describing an
+        object, based on the <link linkend="catalog-pg-class"><structname>pg_class</structname></link> OID, object OID, and sub-object OID.  It can be used to
+        help interpret the contents of <link linkend="catalog-pg-depend"><structname>pg_depend</structname></link>.
        </para>
       </listitem>
 
@@ -1846,15 +1890,8 @@
 
       <listitem>
        <para>
-         Additional tab completion of <application>psql</> variables (Pavel
-         Stehule)
-       </para>
-      </listitem>
-
-      <listitem>
-       <para>
-         More <application>psql</> tab completion support (Itagaki
-         Takahiro)
+        Additional tab completion support (Itagaki Takahiro, Pavel Stehule,
+        Andrey Popp, Christoph Berg, David Fetter, Josh Kupershmidt)
        </para>
       </listitem>