]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/conf.py: silence warnings from breathe
authorKefu Chai <tchaikov@gmail.com>
Sun, 6 Mar 2022 06:27:50 +0000 (14:27 +0800)
committerLaura Flores <lflores@redhat.com>
Mon, 25 Apr 2022 17:43:45 +0000 (12:43 -0500)
breathe calls doxygen for extracting/generating docs from code.
while doxygen complains at seeing undocumented fields/func. these
warnings could fail the sphinx-build command, if it takes warnings
as errors.

in this change, these warnings are silenced.

Signed-off-by: Kefu Chai <tchaikov@gmail.com>
(cherry picked from commit 8891d653198c30f9578499126e1ee9ee67eca04a)

doc/conf.py

index c5638baa4f11df01fef160f35e0e582d3e9464da..2a3a134e4e0469d413fc4c10ded6f40d8ec58593 100644 (file)
@@ -102,7 +102,8 @@ breathe_domain_by_extension = {'py': 'py', 'c': 'c', 'h': 'c', 'cc': 'cxx', 'hpp
 breathe_doxygen_config_options = {
     'EXPAND_ONLY_PREDEF': 'YES',
     'MACRO_EXPANSION': 'YES',
-    'PREDEFINED': 'CEPH_RADOS_API= '
+    'PREDEFINED': 'CEPH_RADOS_API= ',
+    'WARN_IF_UNDOCUMENTED': 'NO',
 }
 
 # the docs are rendered with github links pointing to master. the javascript