[Zope-dev] Documenting products with epydoc

Gilles Lenfant gilles@pilotsystems.net
Thu, 27 Mar 2003 18:20:07 +0100


----- 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