Allow to hide in which headers the struct is defined

breathe/directives/setup.py

@@ -101,6 +101,7 @@ def setup(app: Sphinx) -> None:
     app.add_config_value("breathe_default_members", (), True)
     app.add_config_value("breathe_show_define_initializer", False, 'env')
     app.add_config_value("breathe_show_enumvalue_initializer", False, 'env')
+    app.add_config_value("breathe_show_include", True, 'env')
     app.add_config_value("breathe_implementation_filename_extensions", ['.c', '.cc', '.cpp'], True)
     app.add_config_value("breathe_doxygen_config_options", {}, True)
     app.add_config_value("breathe_use_project_refids", False, "env")

breathe/renderer/sphinxrenderer.py

@@ -1655,6 +1655,9 @@ def visit_verbatim(self, node) -> List[Node]:
         return [rst_node]
 
     def visit_inc(self, node) -> List[Node]:
+        if not self.app.config.breathe_show_include:
+            return []
+
         if node.local == u"yes":
             text = '#include "%s"' % node.content_[0].getValue()
         else:

documentation/source/directives.rst

@@ -562,6 +562,23 @@ Config Values
    For example an enum value ``TWO = 2`` would be shown with the value 2 if this is set to ``True``,
    and without if it is set to ``False``.
 
+.. confval:: breathe_show_include
+
+   A boolean flag which can be set to ``False`` to hide the header in which each
+   entity (struct, function, macro, etc.) is defined.
+
+   For example, when set to ``True`` (the default) a ``struct Foo`` is rendered
+   similarly to::
+
+     struct Foo
+       #include <foo.hpp>
+       Description of Foo.
+
+   but when set to ``False`` it is instead rendered as::
+
+     struct Foo
+       Description of Foo.
+
 .. confval:: breathe_use_project_refids
 
    True or False setting to control if the refids generated by breathe for doxygen