On Wednesday 25 May 2005 17:57, Felix Wiemann wrote: > * We want to have **well-readable** documentation source.
We have that now. Not ReST, but its very readable. > * We want to get **flexibility** in that we can modify the parsed > document using Python code. Is this a goal, or is this a means to an end? This sounds like the later to me. > In particular I have Docutils' document tree in mind -- use > rst2pseudoxml.py to see what it looks like. You can easily apply > transformations on these trees, using your favorite programming > language ;-). This is not (easily?) possible with LaTeX. Not easily, but mostly because there are things the markup syntax doesn't encode directly. The handling of paragraphs also doesn't help. > * We want an **easy-to-use** documentation system. Any documentation > should be renderable by typing "sometool.py input.txt output.html". > Getting multi-document output should be similarly easy. Again, I think we have this now. "mkhowto input.tex" is pretty straightforward. -Fred -- Fred L. Drake, Jr. <fdrake at acm.org> _______________________________________________ Doc-SIG maillist - [email protected] http://mail.python.org/mailman/listinfo/doc-sig
