breathe
breathe copied to clipboard
ReStructuredText and Sphinx bridge to Doxygen
I'm in the process to transition our documentation of a large C project from `doxygen` to `sphinx` using the `breathe` bridge and have stumpled across some problems. In particular, I...
I am trying to set up automated build of our docs on rtd, which is limited to 1 GB mem usage (and 15min build time). The sphinx step ``` reading...
CC @drmoose transferring https://github.com/svenevs/exhale/issues/173 to breathe which is the part of the stack responsible for rendering the doxygen xml output into html. I took a quick look at the renderer...
This was discovered in #816 when resolving all warning produced by `sphinx-build`. So, the test project (see link below) is taken from the original breathe docs, namely _examples/specific/array.h_. The C...
Versions: ``` Sphinx - 4.5.0 breathe - 4.34.0 exhale - 0.3.4 doxygen - 1.9.1 ``` Relevent input files: `ManagedString.h` --> https://github.com/lancaster-university/codal-core/blob/master/inc/types/ManagedString.h On line 2192 of `spinxrenderer.py` ( https://github.com/michaeljones/breathe/blob/master/breathe/renderer/sphinxrenderer.py#L2192 ) the...
The union directive is currently classified as an "item", similar to typedefs, enums, and enumerators. However, formally it is a class type (https://en.cppreference.com/w/cpp/language/type), and in terms of documentation I think...
First of all looks like setuptoolssphinx integration is not done. Below patch fixes that: ```patch --- a/setup.cfg~ 2021-05-06 20:43:49.000000000 +0100 +++ b/setup.cfg 2021-08-16 14:35:35.505071997 +0100 @@ -7,3 +7,6 @@ [bdist_wheel]...
Currently, breathe will pass Fortran classes (derived types), namespaces (modules), procedures, ... as C++ code and sphinx will complain about the invalid syntax. Integrating Fortran code documentation in sphinx would...
I would like to be able to include single examples annotated with \example in the doxygen comment in the documentation. When using the `doxygenindex` directive, example sections are generated for...
I'd really prefer not to show the "Subclassed by" list, but I didn't see an option to remove it. Looks like `derivedcompoundref` already exists for this in the [doxygenfile sections](https://breathe.readthedocs.io/en/latest/file.html#file-example),...