Reconcile Docutils DTD and Document Tree documentation.
commitaebceea6e4df817adf6d856464d79672f8299ba3
authormilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>
Thu, 18 Apr 2024 11:18:00 +0000 (18 11:18 +0000)
committermilde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>
Thu, 18 Apr 2024 11:18:00 +0000 (18 11:18 +0000)
treee2e91465cf3125a17eee45224eed3d6b4fea942c
parent76ae9eec4b4adf8f82ad6b01aaecf23774043457
Reconcile Docutils DTD and Document Tree documentation.

There are some cases where docutils.dtd and doctree.txt diverged.
Change so, that the documentation is consistent and matches actual behaviour.

Remove declaration of element `<info>`:

* added to docutils.dtd and nodes.py but not doctree.txt 2004-03-21,
* never used,
* removed from nodes.py 2004-11-09.

Remove `<decoration>` from content model of `<section>` elements:

* added to docutils.dtd but not doctree.txt 2004-03-21,
* never used because the Docutils rST parser inserts `<decoration>`
  directly into `<document>` even if the "header" or "footer" directive
  is nested in a section.

Fix declaration of `<sidebar>` content:

* no `<subtitle>` without `<title>`.

Add `<subtitle>` to children of `<section>` elements in "doctree.txt":

* present in docutils.dtd,
* used in the functional test examples via SectSubTitle transform
  (with "sectsubtitle_xform" configuration setting True).

git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@9647 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
docutils/HISTORY.txt
docutils/RELEASE-NOTES.txt
docutils/docs/ref/doctree.txt
docutils/docs/ref/docutils.dtd