[Doc-SIG] Python docs in reST

[Nicola Larosa]

> 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 - nico at tekNico.net

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