SF.net SVN: docutils:[10288 ] trunk/docutils/docs/ref/ doctree.rst

Revision: 10288
          http://sourceforge.net/p/docutils/code/10288
Author:   milde
Date:     2026-01-07 13:42:50 +0000 (Wed, 07 Jan 2026)
Log Message:
-----------
Doctree documentation: Include entity definitions from ``docutils.dtd``.

Modified Paths:
--------------
    trunk/docutils/docs/ref/doctree.rst

Modified: trunk/docutils/docs/ref/doctree.rst
===================================================================
--- trunk/docutils/docs/ref/doctree.rst	2026-01-07 13:40:59 UTC (rev 10287)
+++ trunk/docutils/docs/ref/doctree.rst	2026-01-07 13:42:50 UTC (rev 10288)
@@ -5522,6 +5522,12 @@
 
 The ``%bibliographic.elements`` parameter entity contains an OR-list of all
 `Bibliographic Elements`_.
+
+.. include:: docutils.dtd
+   :start-after: <!ENTITY % additional.bibliographic.elements "">
+   :end-before:
+   :literal:
+
 The `%additional.bibliographic.elements`_ placeholder can be used by
 wrapper DTDs to extend ``%bibliographic.elements``.
 
@@ -5533,8 +5539,13 @@
 ------------------
 
 The ``%body.elements`` parameter entity contains an OR-list of all
-`Body Elements`_.
+`Body Elements`_:
 
+.. include:: docutils.dtd
+   :start-after: <!ENTITY % additional.body.elements "">
+   :end-before:
+   :literal:
+
 The `%additional.body.elements`_ placeholder can be used by
 wrapper DTDs to extend ``%body.elements``.
 
@@ -5557,6 +5568,12 @@
 
 The ``%inline.elements`` parameter entity contains an OR-list of all
 `Inline Elements`_.
+
+.. include:: docutils.dtd
+   :start-after: <!ENTITY % additional.inline.elements "">
+   :end-before:
+   :literal:
+
 The `%additional.inline.elements`_ placeholder can be used by
 wrapper DTDs to extend ``%inline.elements``.
 
@@ -5569,6 +5586,12 @@
 
 The ``%section.elements`` parameter entity contains the `\<section>`_
 element.
+
+.. include:: docutils.dtd
+   :start-after: <!ENTITY % additional.section.elements "">
+   :end-before:
+   :literal:
+
 The `%additional.section.elements`_ placeholder can be used
 by wrapper DTDs to extend ``%section.elements``.
 
@@ -5618,14 +5641,13 @@
 followed by zero or more sections (whose contents include this model),
 or transitions.
 
-The actual entity definition is more complex,
+The actual definition is more complex,
 
-.. parsed-literal::
+.. include:: docutils.dtd
+   :start-after: <!-- The structure model may not end with a transition. -->
+   :end-before:
+   :literal:
 
-   ( ( (`%body.elements`_; | topic | sidebar)+, transition? )*,
-     ( (`%section.elements`_;),
-       (transition?, (`%section.elements`_;) )* )? )
-
 because there are additional restrictions on `\<transition>`_\ s.
 [#extra-rule]_
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.