doc: Flesh out 0.9.0 relnotes
authorCraig Ringer <craig@2ndquadrant.com>
Tue, 24 Mar 2015 10:30:36 +0000 (18:30 +0800)
committerCraig Ringer <craig@2ndquadrant.com>
Tue, 24 Mar 2015 10:31:27 +0000 (18:31 +0800)
doc/appendix-releasenotes.sgml

index 7f98fe457fdbcb3c8fda630d93a31f170fc7f478..e0e42bee95142d2c3015125954b998bf47223e5e 100644 (file)
   <title>Release 0.9.0</title>
 
   <para>
-   <!-- TODO: taginfo -->
-   RELEASE TAG INFO HERE
-  </para>
-
-  <para>
-   The biggest change with 0.9.0 is that the <literal>bdr.connections</literal> is now
-   unused and ignored. Connections between nodes are now configured using SQL function
-   calls. For details, see the <xref linkend="node-management"> chapter.
+   The 0.9.0 release was tagged on Tue Mar 24 2015 as git tag
+   <literal>bdr-plugin/0.9.0</literal>. This release requires
+   bdr-Pg <literal>bdr-pg/REL9_4_1-1</literal> to support full
+   BDR functionality.
   </para>
 
   <para>
     <listitem><para>Dynamic SQL-level configuration of connections between nodes</para></listitem>
     <listitem><para>Joining new nodes no longer requires restarting all nodes</para></listitem>
     <listitem><para>Easy node removal</para></listitem>
-    <listitem><para>Many helper and information functions</para></listitem>
     <listitem><para><xref linkend="command-bdr-init-copy"> performs its own <application>pg_basebackup</application></para></listitem>
+    <listitem><para>Many helper and information functions</para></listitem>
     <listitem><para>Documentation expanded and moved into the source tree</para></listitem>
     <listitem><para>FreeBSD compatibility</para></listitem>
    </itemizedlist>
   </para>
 
+  <sect2 id="release-0.9.0-dynconf" xreflabel="Dynamic configuration">
+   <title>Dynamic configuration</title>
+
+   <para>
+    The biggest change with 0.9.0 is that connections between nodes are now
+    configured using the <xref linkend="function-bdr-group-create"> and
+    <xref linkend="function-bdr-group-join"> SQL function calls. It is no
+    longer necessary to restart any existing nodes when joining a node. Even
+    the newly joining node can join without a restart if it was initially
+    configured with the settings required for running &bdr; (see
+    <xref linkend="settings-prerequisite">).
+   </para>
+
+   <para>
+    <literal>bdr.connections</literal> is now unused and ignored. If it
+    remains in <filename>postgresql.conf</filename> a warning will be issued
+    in the PostgreSQL log on startup.
+   </para>
+
+   <para>
+    For details, see the <xref linkend="node-management"> chapter.
+   </para>
+
+  </sect2>
+
+  <sect2 id="release-0.9.0-node-removal" xreflabel="Easy node removal">
+   <title>Easy node removal</title>
+
+   <para>
+    The new <xref linkend="function-bdr-part-by-node-names"> function allows easy
+    online node removal. There is no need to restart nodes or to manually
+    delete replication identifiers and slots. Multiple nodes may be
+    removed at once.
+   </para>
+
+  </sect2>
+
+  <sect2 id="release-0.9.0-init-copy" xreflabel="bdr_init_copy">
+   <title><application>bdr_init_copy</application> makes its own base backup</title>
+
+   <para>
+    <application>bdr_init_copy</application> can now make its own base backup
+    of the target node, and does so by default. Its user interface has also
+    been overhauled as part of the update to support dynamic configuration.
+   </para>
+
+  </sect2>
+
+  <sect2 id="release-0.9.0-docs" xreflabel="Documentation in the source tree">
+   <title>Documentation in the source tree</title>
+
+   <para>
+    Formal documentation has been written and added to the &bdr; source tree
+    to replace the prior ad-hoc wiki based documentation. This allows users
+    to more easily refer to documentation specific to their particular
+    version and permits the documentation to be updated at the same time
+    as the source code.
+   </para>
+
+  </sect2>
+
+  <sect2 id="release-0.9.0-freebsd" xreflabel="FreeBSD compatibility">
+   <title>FreeBSD compatibility</title>
+
+   <para>
+    &bdr; is now tested and built automatically on FreeBSD.
+   </para>
+
+  </sect2>
+
+  <sect2 id="release-0.9.0-functions" xreflabel="New helper functions">
+   <title>New helper functions</title>
+
+   <para>
+    Many new helper functions have been added, see <xref linkend="functions">.
+   </para>
+
+  </sect2>
 
  </sect1>