[Twisted-Python] Teud

[Itamar Shtull-Trauring]

Jürgen Hermann wrote:


> Things that I noticed:
> 	* xmldoc.py should emit a SAX2 stream, not write to a file directly.


Makes sense.


> xmldoc.dtd (which I wrote and committet):
>     * submodule should contain a description, not #PCDATA


the #PCDATA is the description in all elements.

>     * class/@parents should be @bases (cf. __bases__)


OK.


>     * <other> should contain <value> (note that variables might get 
>       docstrings in the __future__, just like functions), and value
>       should have a @type attribute


The contents of all elements are their docstring, so it should rather be:
<other value="foo"/>

and if docstrings ever get added (which I doubt) it can be changed to
<other value="foo"></other>


>     * modelling of function attributes?


Mmmm. I wonder if that counts as an external interface.

Once the DTD is settled on, xmldoc.py and the XSL need to be updated...