Hi, I use to document my (non Zope) python packages using epydoc that's (IMHO) the best python documentation tool (javadoc like great features). http://epydoc.sourceforge.net/ Unfortunately, this does not work with Zope products (usual pydoc doesn't too). How can I make a fixure to get it working ? Did any of you succeed documenting Zope products with epydoc ? Thanks in advance --Gilles
On Thu, 27 Mar 2003 16:40:49 +0100 "Gilles Lenfant" <gilles@pilotsystems.net> wrote:
Hi,
I use to document my (non Zope) python packages using epydoc that's (IMHO) the best python documentation tool (javadoc like great features).
http://epydoc.sourceforge.net/
Unfortunately, this does not work with Zope products (usual pydoc doesn't too).
How can I make a fixure to get it working ? Did any of you succeed documenting Zope products with epydoc ?
I Use HappyDoc, and i have patch it. I wait for the maintener apply the pacth in the cvs. Amelioration: Dia, DocBook output. -- Encolpe DEGOUTE, Ingénieur Logiciel, Nuxeo SARL: Zope Service Provider. Mail: edegoute@nuxeo.com - Tel: +33 (0)1 40 33 79 18 Nuxeo Collaborative Portal Server: http://www.nuxeo.com/cps Gestion de contenu web / portail collaboratif / groupware / open source
----- Original Message ----- From: "Encolpe DEGOUTE" <edegoute@nuxeo.com> To: <zope-dev@zope.org> Sent: Thursday, March 27, 2003 4:57 PM Subject: Re: [Zope-dev] Documenting products with epydoc On Thu, 27 Mar 2003 16:40:49 +0100 "Gilles Lenfant" <gilles@pilotsystems.net> wrote:
Hi,
I use to document my (non Zope) python packages using epydoc that's (IMHO) the best python documentation tool (javadoc like great features).
http://epydoc.sourceforge.net/
Unfortunately, this does not work with Zope products (usual pydoc doesn't too).
How can I make a fixure to get it working ? Did any of you succeed documenting Zope products with epydoc ?
I Use HappyDoc, and i have patch it. I wait for the maintener apply the pacth in the cvs. Amelioration: Dia, DocBook output.
Does HappyDoc "import" the packages/modules it builds the doc ? In that case, can you please describe briefly the fix you made to make it work with Zope products ? Is it something similar to the fixure for unittests ? Thanks in advance --Gilles
Hi Gilles! Gilles Lenfant wrote:
Unfortunately, this does not work with Zope products (usual pydoc doesn't too).
How can I make a fixure to get it working ? Did any of you succeed documenting Zope products with epydoc ?
Two weeks ago I wrote a patch for the cvs version of epydoc that works with Zope 2 ExtensionClasses. It's not released because there are still some bugs, but if you like I could send you the patch. Cheers, Yuppie
Gilles Lenfant wrote at 2003-3-27 16:40 +0100:
I use to document my (non Zope) python packages using epydoc that's (IMHO) the best python documentation tool (javadoc like great features).
http://epydoc.sourceforge.net/
Unfortunately, this does not work with Zope products (usual pydoc doesn't too).
How can I make a fixure to get it working ? Did any of you succeed documenting Zope products with epydoc ?
You may look at my "pydoc" patches. Maybe, something similar allows you to use "epydoc", too. <http://www.dieter.handshake.de/pyprojects/zope> Dieter
participants (4)
-
Dieter Maurer -
Encolpe DEGOUTE -
Gilles Lenfant -
Yuppie