add tests interfaces as examples in the doc ; remove unused test binaries ; some code formating

eo/src/utils/eoCheckPoint.h

@@ -39,10 +39,13 @@
  *
  * Use them with eoStats, eoUpdater and eoMonitor to get statistics at each generation.
  *
- * @see eoStats
+ * @see eoStat
  * @see eoMonitor
  * @see eoUpdater
  *
+ * Example of a test program using checkpointing:
+ * @include t-eoCheckpointing.cpp
+ *
  * @ingroup Utilities
  *
  * @{

eo/src/utils/eoLogger.h

@@ -247,6 +247,8 @@ private:
      */
     std::map< std::ostream*, int >	_standard_io_streams;
 };
+/** @example t-eoLogger.cpp
+ */
 
 namespace	eo
 {

eo/src/utils/eoRNG.h

@@ -438,6 +438,8 @@ private:
     */
     eoRng& operator=(const eoRng&);
 };
+/** @example t-eoRNG.cpp
+ */
 
 
 

eo/src/utils/eoRealBounds.h

@@ -33,6 +33,12 @@
 /**
 \defgroup Real Vector of reals
 
+Set of classes related to continuous black-box optimization problems.
+
+Here are several examples of test programs using eoReal, eoEsSimple, eoEsStdev or eoEsFull to build an Evoution Strategies algorithm:
+@include t-eoESAll.cpp
+@include t-eoESFull.cpp
+
 @ingroup Representations
 
 */

eo/src/utils/eoRndGenerators.h

@@ -88,12 +88,16 @@ template <class T = double> class eoUniformGenerator : public eoRndGenerator<T>
   for ints and unsigneds
   */
   T operator()(void) { return minim+static_cast<T>(uniform.uniform(range)); }
+  /** @example t-eoUniform.cpp
+   */
 
 private :
   T minim;
   T range;
   eoRng& uniform;
 };
+/** @example t-eoRandom.cpp
+ */
 
 
 /// Specialization for bool, does an unbiased coin flip

eo/src/utils/eoStat.h

@@ -407,6 +407,8 @@ private :
     }
 
 };
+/** @example t-eoSSGA.cpp
+ */
 
 template <class EOT>
 class eoDistanceStat : public eoStat<EOT, double>

eo/src/utils/eoState.h

@@ -132,5 +132,7 @@ private :
     eoState& operator=(const eoState&);
 
 };
+/** @example t-eoStateAndParser.cpp
+ */
 
 #endif