[Python-Dev] Re: Docutils/reStructuredText is ready to process PEPs

Fredrik Lundh fredrik@pythonware.com
Mon, 5 Aug 2002 15:13:08 +0200


Ka-Ping Yee wrote:

> I would be very unhappy about having to enter and edit inline
> documentation in an XML-based markup language.

have you tried it?

I suggest taking a look at 2.3's xmlrpclib.py module.

does the comments that start with a single ## line look scary
to you?

it's javadoc-style markup, which is based on HTML.  if you've
ever written a webpage, you can learn the rest in a couple of
minutes.

</F>