[tepl] docs: document API breaks for Gtef 2 -> Tepl 3

[Sébastien Wilmet <swilmet src gnome org>]

commit 360dce053bc3270f17145acbbba1ac00e79a77cc
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Wed Jun 14 11:13:27 2017 +0200

    docs: document API breaks for Gtef 2 -> Tepl 3

 docs/reference/api-breaks.xml |   18 ++++++++++++++++++
 1 files changed, 18 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/api-breaks.xml b/docs/reference/api-breaks.xml
index a099c8e..4f4d4b4 100644
--- a/docs/reference/api-breaks.xml
+++ b/docs/reference/api-breaks.xml
@@ -28,4 +28,22 @@
       </listitem>
     </itemizedlist>
   </chapter>
+
+  <chapter id="api-breaks-2-to-3">
+    <title>Gtef 2 -> Tepl 3</title>
+
+    <itemizedlist>
+      <listitem>
+        <para>
+          The library has been renamed to Tepl (Text editor product line). So
+          the namespace of the code has changed.
+        </para>
+        <para>
+          The new version is Tepl&nbsp;3 and not Tepl&nbsp;1, to avoid confusion
+          with the git tags (the git repository is still the same), since the
+          repository already contains tags for versions 1 and 2.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </chapter>
 </part>