> The reasons **I** am unhappy with the existing tools [#]_ (i.e. epydoc) > is that they don't allow me to mark constants/functions/classes/methods > as private, and they don't allow me to document constants.
Epydoc does have the ability to avoid including private objects in the generated docs. Even when you include them, it generates two versions of the docs, one with and one without them. > You could overcome these problems by parsing source code rather than > importing and examining objects. You would obviously need to develop > appropriate conventions. That's how HappyDoc works. Maybe someone could try and merge (or rather, cherry-pick features from) the two tools. ;-) -- Nicola Larosa - [EMAIL PROTECTED] In one sense, we're entering an age of high tech. In another sense, it's *always* been high tech. Poster: picture of a nautilus shell. Caption: "High Tech: It's not just where we're heading, it's where we're coming from." -- Kirby Urner, April 2005 _______________________________________________ Doc-SIG maillist - [email protected] http://mail.python.org/mailman/listinfo/doc-sig
