Re: [Docutils-develop] docutils api docs

[David G. <go...@us...>]

Richard Jones wrote:
> This seemed like a good idea, hope I haven't overstepped the mark,
> David.

Using the competition?!?  Traitor!  How dare you?

;-)

Sure, it's fine.  If it's useful to anyone, I have no objections.
We're sure to get some good ideas from epydoc (and HappyDoc etc.).
Eventually, of course, it will be replaced with the One True API
Docset. ;-)

One nit, though.  Could you replace it with a run over the curremt CVS
code?  I recently moved the bibliographic fields that were in all the
module docstrings into simple comments.  This gets rid of ":Author:
David Goodger :Contact: goodger@users." from the API docs of almost
EVERY SINGLE MODULE ENTRY!  Sheesh!  You'd think the guy was conceited
or something.

-- 
David Goodger  <go...@us...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/