[Doc-SIG] Good API doc generation in the Python world recently?

Aahz aahz at pythoncraft.com
Fri Jan 28 19:18:08 CET 2005


On Fri, Jan 28, 2005, Sylvain Th?nault wrote:
> On Friday 28 January ? 10:51, Aahz wrote:
>> On Fri, Jan 28, 2005, Michael Foord wrote:
>>>
>>> epydoc isn't abandoned - but happydoc is.
>>> 
>>> I like epydoc, but would also prefer to see a version that parsed
>>> source code rather than importing it. Would make it much harder to
>>> link classes to super classes etc though I guess.
>> 
>> One of the primary goals for Python 2.5 is to finally push through the
>> AST branch.  If you want parsed source, consider joining python-dev and
>> helping with that project.
> 
> What do you mean ? Core python being based on a more usable ast than
> the one returned by the parser module ? 

That's my understanding, keeping in mind that I haven't paid much
attention.

> More than that ? Would be very interested if you could tell be more
> about your point, or giving me some pointers...

Sorry, you'll need to do some research or hope one of the other people
reading knows more.
-- 
Aahz (aahz at pythoncraft.com)           <*>         http://www.pythoncraft.com/

"19. A language that doesn't affect the way you think about programming,
is not worth knowing."  --Alan Perlis


More information about the Doc-SIG mailing list