[Doc-SIG] Python docs in reST
Sylvain.Thenault at logilab.fr
Fri May 27 18:34:16 CEST 2005
On Friday 27 May à 11:23, Ian Bicking wrote:
> Michael Foord wrote:
> > I would probably still do this with introspection - although I note the
> > frustration of Mark Williamson trying to use Epydoc to generate docs for
> > Twisted. It can't work for him *because* it uses introspection......
> I think it's kind of inevitable; I don't think it's possible to make a
> good document extraction system without object introspection, and that
> it's easier to simply resolve the non-importability of modules (or build
> docs on project machines that are fully set up, or whatever). Obviously
> this doesn't work well when you are trying to generate documents for
> someone else's project, but I think it's possible to produce very good
> results when the package wasn't intended for use with a given extraction
however it's possible to make source code introspection without actually
import modules and instrospecting living object, using things such as
the compiler module of the std lib.
Sylvain Thénault LOGILAB, Paris (France).
http://www.logilab.com http://www.logilab.fr http://www.logilab.org
More information about the Doc-SIG