Waiting for feedback about issues with the Docutils Doctree [#489]
Guenter Milde via Docutils-develop <[email protected]>
| Newsgroups | gmane.text.docutils.devel |
|---|---|
| Message-ID | <[email protected]> |
Dear Docutils Developers, I still hope to get some feedback on what to do with the discrepancies of * user documentation * Docutils Generic Document Type Description (docutils.dtd), and * "rst" parser behaviour. Footnotes and Citations may be specified **without content** in rST without the parser complaining. According to documentation and docutils.dtd content is required. → Is there any use-case for empty footnotes or citations? Footnote label is optional according to docutils.dtd According to user documentation, a label is required. The "rst" parser requires a label, too. → Is there any use-case for a footnote without label? Figures require a caption or legend according to docutils.dtd. The "rst" parser and the documentation allow figures without caption or legend. → OK to Allow figures without caption/legend in the Docutils Generic DTD? See also https://sourceforge.net/p/docutils/bugs/489/ Günter _______________________________________________ Docutils-develop mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/docutils-develop Please use "Reply All" to reply to the list.