From: James Jones <jejones3141@gmail.com>
Date: Tue, 28 Feb 2023 14:43:32 +0000 (-0600)
Subject: Get rid of "explicit link to foo could not be resolved" warnings (#4912)
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bd51053a4bff2823be5317de9bc963c77dca8930;p=thirdparty%2Ffreeradius-server.git

Get rid of "explicit link to foo could not be resolved" warnings (#4912)

These turned up for a couple of reasons:
1. Macros expanding to variable declarations (here STATE());
   doxygen needs it expaded to see the declaration.
2. Forward references in @param
---

diff --git a/doc/doxygen/Doxyfile b/doc/doxygen/Doxyfile
index a4a4aecddf1..07b2bae1db5 100644
--- a/doc/doxygen/Doxyfile
+++ b/doc/doxygen/Doxyfile
@@ -2146,6 +2146,7 @@ INCLUDE_FILE_PATTERNS  = *.h
 
 PREDEFINED             = WITH_STATS \
                          HAVE_JSON \
+                         STATE \
                          CC_HINT(x)=
 
 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
diff --git a/src/lib/util/pair.c b/src/lib/util/pair.c
index 5196c699930..fbdece39144 100644
--- a/src/lib/util/pair.c
+++ b/src/lib/util/pair.c
@@ -1334,8 +1334,8 @@ int fr_pair_insert_before(fr_pair_list_t *list, fr_pair_t *pos, fr_pair_t *to_ad
  *
  * @note Memory used by the VP being replaced will be freed.
  *
- * @param[in,out] list		pair list containing #to_replace.
- * @param[in] to_replace	pair to replace and free
+ * @param[in,out] list		pair list
+ * @param[in] to_replace	pair to replace and free, on #list
  * @param[in] vp		New pair to insert.
  */
 void fr_pair_replace(fr_pair_list_t *list, fr_pair_t *to_replace, fr_pair_t *vp)