From 487867d3aa09df86d85157548445aa89b0772cd8 Mon Sep 17 00:00:00 2001
From: Raj Bhattacharjea <raj.b@gatech.edu>
Date: Mon, 14 May 2007 14:34:48 -0400
Subject: [PATCH] MacAddress dox

---
 src/node/mac-address.h | 45 ++++++++++++++++++++++++++++++++++++++----
 1 file changed, 41 insertions(+), 4 deletions(-)

diff --git a/src/node/mac-address.h b/src/node/mac-address.h
index 4a88da1d0..75a80b700 100644
--- a/src/node/mac-address.h
+++ b/src/node/mac-address.h
@@ -40,24 +40,61 @@ public:
   enum {
     MAX_LEN = 32
   };
+  /**
+   * \brief Construct a null MacAddress
+   *
+   * This MacAddress has length of zero, and is internally all zeros
+   */
   MacAddress (void);
-  /* 
+  /**
+   * \brief Construct a MacAddress from a byte-array
+   *
    * low byte should be first.
-	 */
+   * \param address a byte array indicating the address
+   * \param len length, in bytes, of the address points to
+   */
   MacAddress (uint8_t const *address, uint8_t len);
-  /* The string should look like this:
+  /**
+   * \brief Construct a MacAddress from a C-string
+   *
+   * The string should look like this:
    * hh:xx:xx:xx:xx:ll
    * where hh is the high byte and ll is
    * the low byte.
+   * \param address the C-string representation of the address
    */
   MacAddress (char const *address);
   ~MacAddress ();
   
+  /**
+   * \brief Comparison operation between MacAddresses
+   * \param other The address against which to compare this one
+   * \return True if they are equal, false otherwise.
+   */   
   bool IsEqual (MacAddress other) const;
+  /**
+   * \brief Print this MacAddress to a stream
+   *
+   * The format is colon seperated groups of two hexadecimal digits
+   * \param os The output stream desired
+   */ 
   void Print (std::ostream &os) const;
   
-  uint8_t GetLength() const;  
+  /**
+   * \return The length in bytes of this MacAddress
+   */
+  uint8_t GetLength() const;
+  /**
+   * \brief Copy routine to peek the contents of the MacAddress
+   *
+   * \param ad Output parameter which holds a copy of this MacAddress
+   */
   void Peek (uint8_t ad[MAX_LEN]) const;
+  /**
+   * \brief Sets this MacAddress to a specific value
+   * \param ad byte buffer to set the MacAddress to
+   * \param len the length of the buffer
+   */
   void Set (uint8_t const ad[MAX_LEN], uint8_t len);
 
 private: