[Doc-SIG] Documentation tool

[Guido van Rossum]

> This is almost identical to "autodoc", the tool I wrote about before
> to the SWIG List (Ive suggested that SWIG generate this sort of
> documentation directly in the sources).
> 
> When I suggested something like this a while ago to the DOC SIG, the
> consensus was that it does not scan well enough for humans.  People
> thought that the doc strings should be less intrusive than that.

Hm...  I've read plenty of Java code and have no problem with its
markup of doc comments.  Perhaps we could reconsider this?

--Guido van Rossum (home page: http://www.python.org/~guido/)