[Docutils-develop] Waiting for feedback about issues with the Docutils Doctree [#489]

[Guenter M. <mi...@us...>]

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