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

2010-04-16 Thread John Reid
James Amundson wrote: On 04/15/2010 03:53 AM, Murray Cumming wrote: (If anyone can suggest a better alternative to nasty pydoc, I'd be glad.) I always thought it should be possible make boost.python configurable so the user can choose which docstring format is output (standard, epytext mar

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

2010-04-15 Thread James Amundson
On 04/15/2010 03:53 AM, Murray Cumming wrote: (If anyone can suggest a better alternative to nasty pydoc, I'd be glad.) Well, Sphinx, , is the new standard for Python documentation, but I don't think it has any way to extract documentation from your boost python

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

2010-04-15 Thread 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.co