Index: vtcross/trunk/src/include/vtcross/cognitive_engine.h
===================================================================
--- vtcross/trunk/src/include/vtcross/cognitive_engine.h	(revision 465)
+++ vtcross/trunk/src/include/vtcross/cognitive_engine.h	(revision 518)
@@ -15,5 +15,5 @@
 */
 
-/* This header exports the declaration for the Cognitive Engine component type.
+/*! This header exports the declaration for the Cognitive Engine component type.
  */
 
@@ -25,14 +25,21 @@
 
 
-/* Cognitive Engine class declaration.  All public functions are inherited from
- * parent classes.
+/*! \brief Cognitive Engine class declaration.
+ *
+ * All public functions are inherited from parent classes.  Please see parent
+ * class definitions for function documentation.
  */
 class CognitiveEngine : public Engine
 {
     public:
+        /*! Default constructor. */
         CognitiveEngine();
+
+        /*! Default destructor. */
         ~CognitiveEngine();
 
-        /* Overloaded constructor that creates a cognitive engine object and
+        /*! \brief Preferred constructor.
+         *
+         * Overloaded constructor that creates a cognitive engine object and
          * connects it to either the shell or an SML, depening on the SML bool.
          */
@@ -53,22 +60,31 @@
 
     private:
-        /* Receive the transmitted radio configuration from the radio itself
-         * (the CE will not always be local to the radio).
-         */
+        /*! \brief Receive radio XML configuration.
+         * 
+         * Receive the transmitted radio configuration from the radio itself
+         * (the CE will not always be local to the radio). This gets passed
+         * through either the Shell or the SML. */
         void ReceiveRadioConfiguration();
 
-        /* Receive an 'experience' report from the radio.
-         */
+        /*! \brief Receive an 'experience' report from the radio.
+         *
+         * An experience report can be used to build the transmission history
+         * for a CE just starting up so that it has a moving start regarding
+         * parameter optimization. */
         void ReceiveExperience();
 
-        /* Find the most optimal set of transmission parameters given certain
+        /*! \brief Request that the CE optimize a set of parameters. 
+         *
+         * Find the most optimal set of transmission parameters given certain
          * observables and possibly a service if the SML component is present
-         * and active.
-         */
-        Parameter *GetSolution(Observable *observables, Parameter *currentParameters);
-        Parameter *GetSolution(Observable *observables, Parameter *currentParameters, \
-                std::string service);
+         * and active. */
+        Parameter *GetSolution(Observable *observables, \
+                Parameter *currentParameters);
+        Parameter *GetSolution(Observable *observables, \
+                Parameter *currentParameters, std::string service);
 
-        /* Receive a feedback from the radio regarding the performance of a
+        /*! \brief Receive feedback from the radio 
+         *
+         * Receive a feedback from the radio regarding the performance of a
          * certain set of parameters, possibly associated with a service.
          *
@@ -78,11 +94,12 @@
          * more accurate performance statistics. 
          */
-        void ReceiveFeedback(Observable *observables,\
-                Parameter *parameters);
-        void ReceiveFeedback(Observable *observables, \
-                Parameter *parameters, std::string service);
+        void ReceiveFeedback(Observable *observables,Parameter *parameters);
+        void ReceiveFeedback(Observable *observables, Parameter *parameters, \
+                std::string service);
 
 
-        /* BuildCognitiveEngine performs the CE implementation specific work
+        /*! \brief Initialize the CE and prepare it for operation. 
+         *
+         * BuildCognitiveEngine performs the CE implementation specific work
          * that defines the internals of a CE.  For example, a CBR CE engine
          * would build the case-base reasoner or create the database, a neural
@@ -92,5 +109,7 @@
         void BuildCognitiveEngine();
 
-        /* The SML_present bool reflects whether or not the remote component
+        /*! \brief Keept track of what this CE is connected to. 
+         *
+         * The SML_present bool reflects whether or not the remote component
          * this object is connected to is an SML.  If it isn't, then it must be
          * a shell.  The socketFD stores the socket file descriptor for this
