[Epydoc-devel] Problem with latest docutils

[Eric H. <e-...@ne...>]

We've noticed a problem when using epydoc with the latest version of
docutils.  The HTML output is including <p> tags around the content making
it look, well, wrong.

I have some output examples that show this here:
http://www.ehuss.org/epydoc/

The change seems to be centered around CVS version 1.132 (or maybe 1.139?)
of docutils/writers/html4css1.py which altered the behavior of determining
if something should be a "compact paragraph".  This change was made in
November.  Thus docutils 0.3.5 works, but 0.3.7 does not.

We think that epydoc should not pass things to docutils that are documents
(because of the should_be_compact_paragraph method in html4css1 is
checking for that), but we are entirely unsure of what should be done to
fix this (if, perhaps, it is a problem with docutils).  Has anyone else
seen this, or know anything more about it?

-Eric