Allow to hide in which headers the entity is defined

When something like "doxygennamespace" is used, structures gain
additional line about in which header they are defined.

If the API simply serves as a generic description and no public headers
are provided, this info is redundant. This can be worked around by
manually by using "doxygenstruct" directive instead, but this can get
messy quickly with large namespaces. Also, namespace description is
lost.

Allow to hide these lines by setting 'breathe_show_include' to
'False'. The default behavior stays unchanged.

See breathe-doc#57.

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