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 a4a4aecddf1ad4f2bf5801ed62928dabb91e2200..07b2bae1db5c9fb4730d8a4f1ff193bf845e6d9a 100644 (file)
--- 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 5196c699930a01f95bfbb238b684e44799a7dc6d..fbdece39144b60d8d8ff784c90363a240ca34e6e 100644 (file)
--- 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)