mm.c: Add documentation of mood comparator macros.
authorAndre Noll <maan@tuebingen.mpg.de>
Sun, 14 Jun 2015 13:02:11 +0000 (15:02 +0200)
committerAndre Noll <maan@tuebingen.mpg.de>
Wed, 19 Aug 2015 19:47:19 +0000 (21:47 +0200)
This makes doxygen a bit happier, and it's good to document the
preprocessor magic anyway.

mm.c

diff --git a/mm.c b/mm.c
index 902e41f..d6f3573 100644 (file)
--- a/mm.c
+++ b/mm.c
@@ -17,6 +17,7 @@
 #include "afs.h"
 #include "mm.h"
 
+/** The comparators for numeric mood methods (year, bitrate, ...). */
 #define MOOD_COMPARATORS \
        MC(LESS, <) \
        MC(LESS_OR_EQUAL, <=) \
        MC(GREATER, >) \
        MC(GREATER_OR_EQUAL, >=) \
 
+/** Prefix mood comparator name with "_MC", example: MC_LESS. */
 #define MC(a, b) MC_ ## a,
+/** Each mood comparator is identified by an integer of this type. */
 enum mood_comparator_id {MOOD_COMPARATORS NUM_MOOD_COMPARATORS};
 #undef MC
+/** Stringfied mood comparator, example: "<". */
 #define MC(a, b) # b,
+/** Array of mood comparators represented as C strings ("<", "<=", ...). */
 static const char *mood_comparators[] = {MOOD_COMPARATORS};
 #undef MC