[Epydoc-devel] New rules for public objects definition
Brought to you by:
edloper
From: Daniele V. <dan...@gm...> - 2006-01-09 03:09:38
|
Hello, i just submitted the patch 1400068 where the following updates are proposed: - if an object imported from a .c module is in the __all__ attribute of a .py module, it is considered belonging to the python module. This enables to shape the package structure (the API) using python modules, leaving c module as an implementative detail. - All modules specified on the command line not starting with an underscore are "public" and so - for example - appear in the toc and in the parent summary (the previous behavior is to made them public only if effectively imported by parent) This makes Epydoc more friendly towards those packages which are not made to be entirely imported. Feedback on these updates is appreciated. I'd like to read somebody's (and of course Edward's) opinion before applying the patch into the CVS. Daniele P.S. Patch url: http://sourceforge.net/tracker/index.php?func=detail&aid=1400068&group_id=32455&atid=405620 |