From: James Jones Date: Fri, 24 Feb 2023 04:02:56 +0000 (-0600) Subject: Hide CC_HINT() from doxygen (#4909) X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=61533e08e22196749e7915389277c03021fc02ab;p=thirdparty%2Ffreeradius-server.git Hide CC_HINT() from doxygen (#4909) doxygen documentation mentions that it doesn't know about __attribute()__, and recommends making it expand to the empty string for doxygen using PREDEFINED. Letting CC_HINT() through to doxygen confuses it, in particular about function definitions/declarations. In src/lib/util/strerror.h it was not recognizing the parameters of the functions therein as such and therefore giving multiple "member belongs to two different groups" warnings. --- diff --git a/doc/doxygen/Doxyfile b/doc/doxygen/Doxyfile index ff8a965eeec..f6996b69d15 100644 --- a/doc/doxygen/Doxyfile +++ b/doc/doxygen/Doxyfile @@ -2104,7 +2104,7 @@ ENABLE_PREPROCESSING = YES # The default value is: NO. # This tag requires that the tag ENABLE_PREPROCESSING is set to YES. -MACRO_EXPANSION = NO +MACRO_EXPANSION = YES # If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then # the macro expansion is limited to the macros specified with the PREDEFINED and @@ -2112,7 +2112,7 @@ MACRO_EXPANSION = NO # The default value is: NO. # This tag requires that the tag ENABLE_PREPROCESSING is set to YES. -EXPAND_ONLY_PREDEF = NO +EXPAND_ONLY_PREDEF = YES # If the SEARCH_INCLUDES tag is set to YES, the include files in the # INCLUDE_PATH will be searched if a #include is found. @@ -2145,7 +2145,8 @@ INCLUDE_FILE_PATTERNS = *.h # This tag requires that the tag ENABLE_PREPROCESSING is set to YES. PREDEFINED = WITH_STATS \ - HAVE_JSON + HAVE_JSON \ + CC_HINT(x)= # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this # tag can be used to specify a list of macro names that should be expanded. The