Cleanup of BBP code
[libdai.git] / include / dai / enum.h
index e99bb5e..491cd35 100644 (file)
@@ -1,6 +1,7 @@
-/*  Copyright (C) 2006-2008  Joris Mooij  [j dot mooij at science dot ru dot nl]
-    Radboud University Nijmegen, The Netherlands
-    
+/*  Copyright (C) 2006-2008  Joris Mooij  [joris dot mooij at tuebingen dot mpg dot de]
+    Radboud University Nijmegen, The Netherlands /
+    Max Planck Institute for Biological Cybernetics, Germany
+
     This file is part of libDAI.
 
     libDAI is free software; you can redistribute it and/or modify
 */
 
 
+/// \file
+/// \brief Defines the DAI_ENUM macro
+
+
 #ifndef __defined_libdai_enum_h
 #define __defined_libdai_enum_h
 
 #include <dai/exceptions.h>
 
 
-/// Extends the C++ enum type by supporting io streaming and conversion to and from const char* (using anonymous variadic macros)
-
-
+/// Extends the C++ enum type by supporting input/output streaming and conversion to and from const char* and size_t
+/** For more details see the source code.
+ *
+ *  \par Example:
+ *  \code
+ *  DAI_ENUM(colors,RED,GREEN,BLUE)
+ *  \endcode
+ *  defines a class \a colors encapsulating an
+ *  \code
+ *  enum {RED, GREEN, BLUE};
+ *  \endcode
+ *  which offers additional functionality over the plain \c enum keyword.
+ */
 #define DAI_ENUM(x,val0,...) class x {\
     public:\
         enum value {val0,__VA_ARGS__};\