1 files changed, 5 insertions, 2 deletions
diff --git a/utils.c b/utils.c
index dca0dfd49..b635be94c 100755
--- a/utils.c
+++ b/utils.c
@@ -14,10 +14,13 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Utility functions
+ * \brief Utility functions
  *
+ * \note These are important for portability and security,
+ * so please use them in favour of other routines.
+ * Please consult the CODING GUIDELINES for more information.
  */
 
 #include <ctype.h>