bug 648: doxygen

src/applications/v4ping/v4ping.h

@@ -9,11 +9,20 @@ namespace ns3 {
 
 class Socket;
 
+/**
+ * \brief an application which sends one ICMP ECHO request, waits for a REPLYs
+ *        and reports the calculated RTT.
+ *
+ * Note: The RTT calculated is reported through a trace source.
+ */
 class V4Ping : public Application
 {
 public:
   static TypeId GetTypeId (void);
 
+  /**
+   * create a pinger applications
+   */
   V4Ping ();
   virtual ~V4Ping ();
 

src/helper/v4ping-helper.cc

@@ -30,12 +30,6 @@ V4PingHelper::V4PingHelper (Ipv4Address remote)
   m_factory.Set ("Remote", Ipv4AddressValue (remote));
 }
 
-void 
-V4PingHelper::SetAttribute (std::string name, const AttributeValue &value)
-{
-  m_factory.Set (name, value);
-}
-
 ApplicationContainer
 V4PingHelper::Install (Ptr<Node> node) const
 {

src/helper/v4ping-helper.h

@@ -7,15 +7,40 @@
 
 namespace ns3 {
 
+/**
+ * \brief create a pinger application and associate it to a node
+ *
+ * This class creates one or multiple instances of ns3::V4Ping and associates
+ * it/them to one/multiple node(s).
+ */
 class V4PingHelper
 {
 public:
+  /**
+   * \param remote the address which should be pinged
+   */
   V4PingHelper (Ipv4Address remote);
 
-  void SetAttribute (std::string name, const AttributeValue &value);
-
+  /**
+   * \param nodes the list of nodes.
+   *
+   * Install a pinger application on each node in the input list of nodes.
+   * \returns a list of pinger applications, one for each input node
+   */
   ApplicationContainer Install (NodeContainer nodes) const;
+  /**
+   * \param node the node
+   *
+   * Install a pinger application on the input node
+   * \returns the pinger application created.
+   */
   ApplicationContainer Install (Ptr<Node> node) const;
+  /**
+   * \param nodeName the node
+   *
+   * Install a pinger application on the input node
+   * \returns the pinger application created.
+   */
   ApplicationContainer Install (std::string nodeName) const;
 
 private: