|| at Oct 7, 2010 at 12:19 pm
Ooh, along with the autosummary extension:http://sphinx.pocoo.org/ext/autosummary.html
(This generates the templates used by autodoc if I am understanding
correctly - so autodoc pulls in explicitly specified docstrings and
autosummary generates stub pages that pull in all docstrings.)
The autosummary doc starts:
"This extension generates function/method/attribute summary lists,
similar to those output e.g. by Epydoc and other API doc generation tools."
All the best,
All the best,
* I'm not one of the cool kids unfortunately... I still tend to think
that documentation and docstrings are two different things.
On Thu, Oct 7, 2010 at 1:52 AM, Bill Janssenwrote:
I've been documenting UpLib with a combo of ReST for the standalone
docs, and epydoc for the API documentation. But epydoc seems to be
dying a slow death of non-maintenance. It won't work with docutils 0.6
or 0.7, and Python 2.6 seems to crash when running it.
So, I'm looking for an alternative to epydoc. Preferably something
easy to convert to... Any pointers?
Doc-SIG maillist - Doc-SIG at python.orghttp://mail.python.org/mailman/listinfo/doc-sig
READ CAREFULLY. By accepting and reading this email you agree,
on behalf of your employer, to release me from all obligations
and waivers arising from any and all NON-NEGOTIATED agreements,
licenses, terms-of-service, shrinkwrap, clickwrap, browsewrap,
confidentiality, non-disclosure, non-compete and acceptable use
policies (?BOGUS AGREEMENTS?) that I have entered into with your
employer, its partners, licensors, agents and assigns, in
perpetuity, without prejudice to my ongoing rights and privileges.
You further represent that you have the authority to release me
from any BOGUS AGREEMENTS on behalf of your employer.