From a8bd9c7ea20b7af58d83439b3981964e8fd6f00c Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Tue, 30 Sep 2014 08:59:18 +0000
Subject: [PATCH] CR-4686 OPENDJ-1567: Mention makeldif template branches now need object classes

---
 src/main/docbkx/sdk-release-notes/chap-compatibility.xml |   39 +++++++++++++++++++++++++++++++++++++++
 1 files changed, 39 insertions(+), 0 deletions(-)

diff --git a/src/main/docbkx/sdk-release-notes/chap-compatibility.xml b/src/main/docbkx/sdk-release-notes/chap-compatibility.xml
index 3b08d14..ab357a1 100644
--- a/src/main/docbkx/sdk-release-notes/chap-compatibility.xml
+++ b/src/main/docbkx/sdk-release-notes/chap-compatibility.xml
@@ -39,11 +39,50 @@
  <section xml:id="changes">
   <title>Major Changes</title>
 
+<!--
   <para>
    This maintenance release is binary-compatible with
    OpenDJ LDAP SDK ${docPreviousVersion}.
    It does not introduce major changes.
   </para>
+-->
+
+  <itemizedlist>
+   <para>
+    This release introduces the following changes.
+   </para>
+
+   <listitem>
+    <para>
+     When specifying a branch in <command>makeldif</command> templates,
+     you must now also specify the object classes for the branch.
+     For example, suppose a template creates an organizational unit branch as follows:
+    </para>
+
+    <programlisting language="ldif">
+branch: ou=People,[suffix]
+    </programlisting>
+
+    <para>
+     You now create the organization unit branch as follows:
+    </para>
+
+    <programlisting language="ldif">
+branch: ou=People,[suffix]
+objectClass: top
+objectClass: organizationalUnit
+    </programlisting>
+
+    <para>
+     For details on writing <command>makeldif</command> templates, see
+     <link
+      xlink:show="new"
+      xlink:href="dev-guide#makeldif-template-5"
+      xlink:role=""
+     >makeldif.template</link>.
+    </para>
+   </listitem>
+  </itemizedlist>
  </section>
 
  <section xml:id="deprecation">

--
Gitblit v1.10.0