Hi, My thoughts exactly, Michael, I use your Breathe extension and most of the stuff just works... gotta test if the new thing provides more functionality but perhaps the authors can point us in the right direction? I mean Breathe is not ideal but perhaps it would be wiser to fill in the blanks than write a new framework from scratch. Still, if it is there, perhaps they can benefit mutually from the 'competition'?
Best, Michael (it's a fairly popular name ;) ) On Sunday, 26 August 2012 00:18:01 UTC+2, mpj wrote: > > Hey, > > I wrote Breathe, if you'd be up for providing a short explanation of > why you started your project and what advantages you feel your > approach has then I'd love to put it in the Breathe readme so that > people can see alternatives. > > Cheers, > Michael > > On Sat, Jun 16, 2012 at 3:59 AM, Anteru > <newsg...@catchall.shelter13.net <javascript:>> wrote: > > Hi, > > > > We're happy to announce robin, a new Doxygen/C++ to Sphinx bridge. Robin > > provides an easy-to-use, easy-to-hack integration of Doxygen > > documentation into Sphinx. Robin is licensed under the BSD and can be > > found at Bitbucket: https://bitbucket.org/reima/robin > > > > Features > > ======== > > > > * Robust extraction of Doxygen XML data via an easy-to-hack parser > > * Intermediate data is stored in a database (mongodb) for simple > > extraction and processing > > * Directive-driven output; each directive provides callbacks and hooks > > which allows for deep customization > > * Automated generation of driver ReST documents: Similar to automodule; > > however, robin generates actual ReST documents which can be inspected > > > > Prerequisites > > ============= > > > > Robin expects a running mongodb on the local host. It uses a minimal set > > of external libraries: Pymongo, sphinx, progressbar. All of the > > dependencies can be easily installed using pip or easy_install. > > > > Robin has been developed with Python 2.7; we have not tested previous > > versions. > > > > Getting started > > =============== > > > > * Run Doxygen to generate XML documentation (GENERATE_XML=YES) > > * Run extract-doxygen <path to XML> <project name> > > * Run create-rst <project name> > > This generates several directories (classes, groups, etc.) > > Include the groups.rst into your toc > > * Add 'robin.sphinx' to the Sphinx extensions > > * Build (make html) for TOC update > > * Build again (make clean && make html) > > > > Status > > ====== > > > > We're using robin internally for a large C++ codebase, and there are a > > few minor issues left that we hope to resolve soon (all of them are > > tracked on Bitbucket.) After that, we expect that robin will go into > > "maintenance" mode focusing on bug fixes only. If someone is interested > > in contributing, please get in touch with us. > > > > Cheers, > > the robin developers > > > > -- > > You received this message because you are subscribed to the Google > Groups "sphinx-dev" group. > > To post to this group, send email to > > sphin...@googlegroups.com<javascript:>. > > > To unsubscribe from this group, send email to > sphinx-dev+...@googlegroups.com <javascript:>. > > For more options, visit this group at > http://groups.google.com/group/sphinx-dev?hl=en. > > > -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To view this discussion on the web visit https://groups.google.com/d/msg/sphinx-dev/-/7Xgdn5bp2hQJ. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
