I'm currently working on the documentation of a large C++ project using Sphinx (Doxygen is just not readable enough...).
I was initially planning to do a trick like http://www.vlfeat.org/api/index.html where they split a generated page to use a header and footer for the generated doxygen html pages. However the 'breathe' extensions seems to be a better way of doing things. Could you explain the status of the project ? Do you think it is a viable option ? Is it somewhere a sample of the expected output ? Retrieving the current git branch and running the testsuite today provides an >>>> breathe/testsuite$ make html mkdir -p build/html build/doctrees sphinx-build -b html -a -N -d build/doctrees source build/html Extension error: Could not import extension breathe (exception: No module named indexsuper) <<<< And it seems that indexsuper http://google.com/codesearch?hl=en&sa=N&q=indexsuper++lang:python&ct=rr&cs_r=lang:python is supposed to be provided by your code ? Thanks for your answer. Regards, rodrigob. On Feb 8, 1:09 pm, Michael Jones <[email protected]> wrote: > For those interested, I've not made much progress, what I have done is > summarised by the following two repositories: > > Sphinx extension:http://github.com/michaeljones/breathe/tree/master > > Output processing:http://github.com/michaeljones/doxml/tree/master > > I'm getting into a rhythm of working on it, but it might still be > several weeks before something basic is in place. > > Michael > > On Mon, Dec 15, 2008 at 11:02 PM, Michael Jones <[email protected]> > wrote: > > I'm giving this a whirl, I'll keep this thread updated with progress. > > Might not be anything of interest before the new year though. Give us > > a shout if you'd like to help out, > > > Michael > > > On Sat, Dec 13, 2008 at 11:47 AM, Michael Jones <[email protected]> > > wrote: > >> I've not tried, though I believe Dan's suggestion to be the best > >> direction to go in, with the one problem that the Doxygen XML output > >> is still in development so might well be subject to change. > > >> I'm still not finding the time I'm afraid. > > >> Michael > > >> On Tue, Dec 9, 2008 at 6:10 AM, Dmitriy <[email protected]> wrote: > > >>> Hi, Michael (and the rest of the Sphinx mailing list), > > >>> Have you had any luck with this? I would be very interested in using > >>> Sphinx to document C++ code. > > >>> Thanks. > >>> Dmitriy > > >>> On Oct 22, 1:49 am, mpj <[email protected]> wrote: > >>>> Hi, > > >>>> I was wondering if anyone has done any work on some kind of autoclass > >>>> equivalent for c++? I thought that using gccxml and pygccxml might be > >>>> an avenue worth exploring but I thought I'd check if anyone had put > >>>> some more thought into it. > > >>>> Sphinx is ace, thank you for all the hard work. > > >>>> Regards, > >>>> Michael > > --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
