[Doc-SIG] Python docs in reST
Sylvain Thénault
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
> tool.
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
mailing list