dm.zdoc 1.1
pydoc based documentation for Zope
dm.zdoc
Tiny wrapper around pydoc to make it usable for Zope.
A wrapper is necessary because Zope makes use of Python packages' __path__ feature and this is not well supported by pydoc.
Zope' environment variables INSTANCE_HOME and SOFTWARE_HOME must be set before the module can be imported.
Usage
zdoc can either be used via the script dmzdoc or via module import. Note, that in both cases the Zope environment variables INSTANCE_HOME and SOFTWARE_HOME must be defined. They tell zdoc where the Zope sources can be found.
Use via dmzdoc
The script dmzdoc is installed when you have setuptools installed.
Otherwise, you must install it yourself. It has the following content:
import dm.zdoc; dm.zdoc.cli()
dmzdoc has the exact same options and parameters as pydoc, documented in pydoc.
Use via module import
The module dm.zdoc defines exactly the same objects as pydoc. Unfortunately, pydoc has no module level documentation - but you can use pydoc to get a source documentation.
Version History
- 1.1 works around a bug in zope.interface which breaks inspect (the authors call it a feature, not a bug).
| File | Type | Py Version | Uploaded on | Size | # downloads |
|---|---|---|---|---|---|
| dm.zdoc-1.1.tar.gz (md5) | Source | 2008-01-07 20:59:26 | 3KB | 199 | |
- Author: Dieter Maurer <dieter at handshake de>
- Keywords: pydoc documentation Zope
- License: BSD (see "dm/zdoc/LICENSE.txt", for details)
- Categories
- Package Index Owner: dmaurer
- DOAP record: dm.zdoc-1.1.xml
Log in to rate this package.
