Kent Pitman (KMP) often talks about programming languages as Political Parties (a brilliant intuition). I *honestly* wonder whether to the Python party really corresponds more-or-less just one documentation format party, a silent majority perhaps. And whether Docutils (formerly DPS) will be up to this ambitious design claim in PEP 258 (revision 1.2): Intermediate Data Structure =========================== ... The DTD defines a rich set of elements, suitable for any input syntax or output format or is it already optionless (anyway it is not finished). sometimes-I-wish-I-had-a-real-&-working-Erik-Naggum's-mode- (a-KMP's-mode-would-be-better-and-more-pythonic-but-even-more- ambitious)-ly y'rs. PS: the funny thing is that I do not dislike structured text formats in general, but auto-documenting is reducible to that ? ----- Original Message ----- From: David Goodger <goodger@users.sourceforge.net> Newsgroups: comp.lang.python Cc: Richard Jones <rjones@ekit-inc.com>; <python-dev@python.org>; <doc-sig@python.org> Sent: Friday, April 05, 2002 6:33 AM Subject: [Python-Dev] Re: PEP 287: reStructuredText Standard Docstring Format
Thank you to everyone who has commented on PEP 287, be they in favor, well-meaning but opposed, or ill-wishing troll ;-) [1]_. I have been otherwise busy and haven't been able to keep up with replies, but I have read and kept a record of all the posts so far (and will, for posts yet to come) for consideration and reference when revising the PEP. I may not be able to offer timely replies to all the posts; ultimately the revised PEP will serve as an umbrella reply.
.. [1] Actually, the posts opposed and even the trolls are often the most useful, since they point out weaknesses and help strengthen the arguments. The number of people posting *in favor* of the PEP was roughly the same as the number opposed, but supporters tend to be silent while protesters tend to be quite vociferous and relentless.
Over the weeks to come, I will be revising PEP 287 and related PEPs 256-258, merging the reStructuredText_ and DPS_ projects into the renamed Docutils_ project, and producing a "road map" describing the big picture. Further suggestions for improvement are welcome.
.. _reStructuredText: http://structuredtext.sourceforge.net/ .. _DPS: http://docstring.sourceforge.net/ .. _Docutils: http://docutils.sourceforge.net/
A special thanks must go to Richard Jones for taking up arms (or keyboard) in my stead, and for taking the initiative to start work on `A ReStructuredText Primer`_. In hindsight it was much needed, and it's coming along nicely. Thanks Richard!
.. _A ReStructuredText Primer: http://mechanicalcat.net/tech/quickstart.html
-- David Goodger goodger@users.sourceforge.net Open-source projects: - Python Docstring Processing System: http://docstring.sourceforge.net - reStructuredText: http://structuredtext.sourceforge.net - The Go Tools Project: http://gotools.sourceforge.net
_______________________________________________ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev