diff --git a/conf.py b/conf.py index 02794784..0a356391 100755 --- a/conf.py +++ b/conf.py @@ -52,6 +52,12 @@ # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] +# Fixes "WARNING: Error when parsing function declaration." +c_id_attributes = ["__sparse_cache"] +# Not clear why Sphinx thinks some C files are C++ +cpp_id_attributes = c_id_attributes +# cpp_paren_attributes = ["_ALIAS_OF", "__printf_like"] + # The suffix(es) of source filenames. # You can specify multiple suffix as a list of string: # @@ -83,7 +89,7 @@ # # This is also used if you do content translation via gettext catalogs. # Usually you set "language" from the command line for these cases. -language = None +language = 'en' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. @@ -168,13 +174,13 @@ # as required. extlinks = { 'git-sof-mainline': - (SOF_GIT + '/sof/tree/master/%s', ""), + (SOF_GIT + '/sof/tree/master/%s', None), 'git-sof-docs-mainline': - (SOF_GIT + '/sof-docs/tree/master/%s', ""), + (SOF_GIT + '/sof-docs/tree/master/%s', None), 'git-sof-kconfig': - (SOF_GIT + '/kconfig/tree/master/%s', ""), + (SOF_GIT + '/kconfig/tree/master/%s', None), 'git-alsa': - ('https://git.alsa-project.org/?p=%s.git', ""), + ('https://git.alsa-project.org/?p=%s.git', None), } # Add any paths that contain custom static files (such as style sheets) here,