From 03b20b5d918291ee2127414ec3c7595c1803c0ed Mon Sep 17 00:00:00 2001 From: Marcin Maka Date: Tue, 24 Mar 2020 14:42:13 +0100 Subject: [PATCH] conf: switch breathe to import into cpp domain Cpp domain provides much better formatting in Sphinx. Initialized enum items are correctly displayed, pointer to functions typedef-ed in place also works fine. Other projects also tend to use cpp domain for import from C headers. With this commit, breathe stops enforcing C and this seems to be enough for consistent import. Running breathe with different options I found that it imports everything into cpp domain w/o extra options, cpp seems to be the default one, and the output is correct (see also michaeljones/breathe#282 (comment)). Note that doxygen always outputs . The doxygen is already configured with OPTIMIZE_OUTPUT_FOR_C = YES and adding EXTENSION_MAPPING = h=C does not make any difference too. Signed-off-by: Marcin Maka --- conf.py | 3 --- 1 file changed, 3 deletions(-) diff --git a/conf.py b/conf.py index dedbb7c1..965257cc 100644 --- a/conf.py +++ b/conf.py @@ -191,6 +191,3 @@ def setup(app): } breathe_default_project = "SOF Project" breathe_default_members = ('members', 'undoc-members', 'content-only') -breathe_domain_by_extension = { - "h" : "c", -}