[C++-sig] Generating API documentation when using boost::python

[Murray Cumming]

I tried running pydoc on my python module,
(implemented here
http://git.gnome.org/browse/glom/tree/glom/python_embed/python_module/py_glom_module.cc#n35
)
but the output has lots of stuff that is uninteresting to Python coders,
even after using docstring_options. For instance:
http://www.murrayc.com/temp/glom_1_14_pydoc.html

In particular, it 
a) Mentions a Boost.Python.instance base class.
b) Mentions stuff like "__instance_size__ = 84"
b) Mentions the __setitem__, __getitem__ and __len__ implementation
details of the [] syntax.
c) Shows the arg1 self argument for each method.
d) Shows just "object" for some of my argument types.. How can I say
what specific type they are. 
e) Likewise, just shows "object" for my return types.


(If anyone can suggest a better alternative to nasty pydoc, I'd be
glad.)

-- 
murrayc at murrayc.com
www.murrayc.com
www.openismus.com