Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
64 lines (42 sloc) 1.61 KB


This is an extension to reStructuredText and Sphinx to be able to read and render the Doxygen xml output.


Documentation is available in the testsuite folder and up in full here.

Running Testsuite

Run make in the root of the project.

This will run doxygen over the example code and then run the Breathe documentation/testsuite. View the results at:



Development is currently done with:

  • Python 2.7
  • Docutils 0.7
  • Sphinx 1.0.7
  • Doxygen 1.7.2

Doxygen 1.5.1 seems to produce xml with repeated sections which causes Breathe some confusion. Not sure when this was resolved but it might be best to go for the latest possible.

Mailing List

There is a mailing list available thanks to LibreList:

The archives are available here.


Thank you to:

For their contributions; improving the code and the documentation. And thanks to:

  • Dimitri van Heesch for Doxygen.
  • Georg Brandl for Sphinx.
  • David Goodger for Docutils and reStructuredText.
Something went wrong with that request. Please try again.