Parcourir la source

[3156] Corrected a few doxygen errors.

Thomas Markwalder il y a 11 ans
Parent
commit
4e9470edf1
3 fichiers modifiés avec 8 ajouts et 6 suppressions
  1. 1 1
      src/bin/d2/d2_cfg_mgr.h
  2. 2 2
      src/bin/d2/nc_trans.h
  3. 5 3
      src/bin/d2/state_model.h

+ 1 - 1
src/bin/d2/d2_cfg_mgr.h

@@ -199,7 +199,7 @@ public:
     /// output:
     ///0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.9.9.0.0.2.0.3.0.8.B.D.0.1.0.0.2.ip6.arpa.
     ///
-    /// @param address string containing a valid IPv6 address.
+    /// @param ioaddr string containing a valid IPv6 address.
     ///
     /// @return a std::string containing the reverse order address.
     ///

+ 2 - 2
src/bin/d2/nc_trans.h

@@ -109,7 +109,7 @@ public:
 
     static const int PROCESS_TRANS_FAILED_ST = SM_STATE_MAX + 5;
 
-    /// @define Value at which custom states in a derived class should begin.
+    /// @brief Value at which custom states in a derived class should begin.
     static const int NCT_STATE_MAX = SM_STATE_MAX + 100;
     //@}
 
@@ -138,7 +138,7 @@ public:
     /// packet (if one was received).
     static const int UPDATE_FAILED_EVT = SM_EVENT_MAX + 7;
 
-    /// @define Value at which custom events in a derived class should begin.
+    /// @brief Value at which custom events in a derived class should begin.
     static const int NCT_EVENT_MAX = SM_EVENT_MAX + 100;
     //@}
 

+ 5 - 3
src/bin/d2/state_model.h

@@ -245,7 +245,7 @@ public:
     /// @brief Final state, all the state model has reached its conclusion.
     static const int END_ST = 1;
 
-    /// @define Value at which custom states in a derived class should begin.
+    /// @brief Value at which custom states in a derived class should begin.
     static const int SM_STATE_MAX = 10;
     //@}
 
@@ -264,7 +264,7 @@ public:
     /// @brief Event issued to abort the model execution.
     static const int FAIL_EVT = 3;
 
-    /// @define Value at which custom events in a derived class should begin.
+    /// @brief Value at which custom events in a derived class should begin.
     static const int SM_EVENT_MAX = 10;
     //@}
 
@@ -419,6 +419,8 @@ protected:
     /// @param value is the numeric value of the state
     /// @param label is the text label of the state used in log messages and
     /// exceptions.
+    /// @param handler is the bound instance method which implements the state's
+    /// actions.
     ///
     /// @throw StateModelError if the model has already been started, if
     /// the value is already defined, or if the label is empty.
@@ -512,7 +514,7 @@ protected:
     /// event that will be passed into the current state's handler on the next
     /// iteration of the run loop.
     ///
-    /// @param the numeric event value to post as the next event.
+    /// @param event the numeric event value to post as the next event.
     ///
     /// @throw StateModelError if the event is undefined
     void postNextEvent(unsigned int event);