[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>