diff --git a/.known-issues/doc/anonymous.conf b/.known-issues/doc/anonymous.conf deleted file mode 100644 index b66a229326c7b7..00000000000000 --- a/.known-issues/doc/anonymous.conf +++ /dev/null @@ -1,12 +0,0 @@ -# -# Anonymous struct/union -# -^(?P([\-:\\/\w\.])+[/\\]doc[/\\]reference[/\\]bluetooth[/\\]connection_mgmt.rst):(?P[0-9]+): WARNING: Error in declarator or parameters$ -^Invalid C declaration: Expected identifier in nested name. \[error at [0-9]+]$ -^.*union bt_conn_info::@[0-9]+.*$ -^[- \t]*\^$ -# -^(?P([\-:\\/\w\.])+[/\\]doc[/\\]reference[/\\]bluetooth[/\\]connection_mgmt.rst):(?P[0-9]+): WARNING: Error in declarator or parameters$ -^Invalid C declaration: Expected identifier in nested name. \[error at [0-9]+]$ -^.*enum bt_conn_oob_info::@[0-9]+.*$ -^[- \t]*\^$ diff --git a/doc/conf.py b/doc/conf.py index 9fff373bbf6a9b..3f308a0343ba7c 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -521,6 +521,7 @@ "c": "c", } breathe_separate_member_pages = True +breathe_show_enumvalue_initializer = True # Qualifiers to a function are causing Sphihx/Breathe to warn about # Error when parsing function declaration and more. This is a list diff --git a/include/sys/util_macro.h b/include/sys/util_macro.h index 96ee9db1405002..178d1e488d789d 100644 --- a/include/sys/util_macro.h +++ b/include/sys/util_macro.h @@ -274,19 +274,19 @@ extern "C" { /** Expands to the first argument. * - * @deprecated Use GET_ARG_N instead. + * @deprecated Use GET_ARG_N() instead. */ #define GET_ARG1(...) GET_ARG_N(1, __VA_ARGS__) /** Expands to the second argument. * - * @deprecated Use GET_ARG_N instead. + * @deprecated Use GET_ARG_N() instead. */ #define GET_ARG2(...) __DEPRECATED GET_ARG_N(2, __VA_ARGS__) /** Expands to all arguments except the first one. * - * @deprecated Use GET_ARGS_LESS_N instead. + * @deprecated Use GET_ARGS_LESS_N() instead. */ #define GET_ARGS_LESS_1(...) __DEPRECATED GET_ARGS_LESS_N(1, __VA_ARGS__) diff --git a/scripts/requirements-doc.txt b/scripts/requirements-doc.txt index 9bd312e2ba01f2..71133b527f2b12 100644 --- a/scripts/requirements-doc.txt +++ b/scripts/requirements-doc.txt @@ -1,6 +1,6 @@ # DOC: used to generate docs -breathe>=4.21.0 +breathe>=4.23.0 docutils>=0.16 sphinx>=3.2.0,<4.0 sphinx_rtd_theme