- add support for introductory notes following .. changelog:: directive

diff --git a/doc/build/builder/changelog.py b/doc/build/builder/changelog.py
index 85ae6dba05c4481a98b6eacc2aac051af69bd4c8..41a403ad0955fd78c7f9f6a3f8ef3bb1f6f2ebce 100644 (file)
--- a/doc/build/builder/changelog.py
+++ b/doc/build/builder/changelog.py
@@ -142,6 +142,16 @@ class ChangeLogDirective(EnvDirective, Directive):
                         self._parsed_content['released']))
         else:
             topsection.append(nodes.Text("no release date"))
+
+        intro_para = nodes.paragraph('', '')
+        for len_, text in enumerate(self._parsed_content['text']):
+            if ".. change::" in text:
+                break
+        if len_:
+            self.state.nested_parse(self._parsed_content['text'][0:len_], 0,
+                            intro_para)
+            topsection.append(intro_para)
+
         return topsection