[Doxygen] use \todo
authorPeter D. Barnes, Jr. <barnes26@llnl.gov>
Tue, 11 Jun 2013 17:02:23 -0700
changeset 9870 6543f3876ff5
parent 9869 126d9cf86d71
child 9871 90c92578f680
[Doxygen] use \todo
src/aodv/helper/aodv-helper.h
src/aodv/test/bug-772.h
src/dsdv/model/dsdv-rtable.cc
src/dsr/model/dsr-errorbuff.cc
src/dsr/model/dsr-options.cc
src/dsr/model/dsr-rcache.cc
src/dsr/model/dsr-routing.cc
src/flow-monitor/model/histogram.h
src/internet/model/global-route-manager-impl.h
src/internet/model/icmpv6-header.cc
src/internet/model/icmpv6-l4-protocol.cc
src/internet/model/ipv4-global-routing.cc
src/internet/model/ipv4-static-routing.cc
src/internet/model/ipv6-extension-header.cc
src/internet/model/ipv6-extension.cc
src/internet/model/ipv6-list-routing.cc
src/internet/model/ipv6-static-routing.cc
src/internet/model/nsc-tcp-l4-protocol.cc
src/internet/model/udp-socket-impl.cc
src/lte/model/epc-x2.cc
src/lte/model/fdbet-ff-mac-scheduler.cc
src/lte/model/fdmt-ff-mac-scheduler.cc
src/lte/model/fdtbfq-ff-mac-scheduler.cc
src/lte/model/lte-rlc-am.cc
src/lte/model/lte-rlc-am.h
src/lte/model/lte-rlc.h
src/lte/model/lte-ue-mac.cc
src/lte/model/lte-ue-rrc.cc
src/lte/model/pf-ff-mac-scheduler.cc
src/lte/model/pss-ff-mac-scheduler.cc
src/lte/model/rr-ff-mac-scheduler.cc
src/lte/model/tdbet-ff-mac-scheduler.cc
src/lte/model/tdmt-ff-mac-scheduler.cc
src/lte/model/tdtbfq-ff-mac-scheduler.cc
src/lte/model/tta-ff-mac-scheduler.cc
src/lte/test/test-asn1-encoding.cc
src/mesh/helper/flame/flame-installer.cc
src/mesh/model/dot11s/hwmp-protocol-mac.cc
src/mesh/model/dot11s/ie-dot11s-preq.cc
src/mesh/model/dot11s/ie-dot11s-preq.h
src/mesh/model/dot11s/peer-link-frame.cc
src/mesh/model/dot11s/peer-management-protocol.h
src/mesh/model/mesh-point-device.h
src/mesh/model/mesh-wifi-interface-mac-plugin.h
src/mesh/model/mesh-wifi-interface-mac.cc
src/mesh/model/mesh-wifi-interface-mac.h
src/netanim/model/animation-interface.cc
src/network/utils/ipv6-address.cc
src/network/utils/pcap-test.h
src/network/utils/red-queue.cc
src/olsr/model/olsr-header.cc
src/openflow/model/openflow-switch-net-device.cc
src/stats/model/omnet-data-output.cc
src/stats/model/sqlite-data-output.cc
src/uan/model/uan-net-device.cc
src/uan/model/uan-phy-dual.h
src/wifi/model/wifi-information-element-vector.cc
src/wifi/model/wifi-remote-station-manager.cc
src/wimax/model/cid-factory.cc
src/wimax/model/wimax-net-device.cc
src/wimax/model/wimax-tlv.cc
--- a/src/aodv/helper/aodv-helper.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/aodv/helper/aodv-helper.h	Tue Jun 11 17:02:23 2013 -0700
@@ -52,7 +52,7 @@
    *
    * This method will be called by ns3::InternetStackHelper::Install
    * 
-   * TODO: support installing AODV on the subset of all available IP interfaces
+   * \todo support installing AODV on the subset of all available IP interfaces
    */
   virtual Ptr<Ipv4RoutingProtocol> Create (Ptr<Node> node) const;
   /**
--- a/src/aodv/test/bug-772.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/aodv/test/bug-772.h	Tue Jun 11 17:02:23 2013 -0700
@@ -33,7 +33,7 @@
  * 
  * \brief AODV deferred route lookup test case (see bug 772)
  * 
- * TODO: describe expected packet trace 
+ * \todo describe expected packet trace 
  */
 class Bug772ChainTest : public TestCase
 {
--- a/src/dsdv/model/dsdv-rtable.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/dsdv/model/dsdv-rtable.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -233,7 +233,7 @@
           ++i;
           m_ipv4AddressEntry.erase (itmp);
         }
-      // TODO: Need to decide when to invalidate a route
+      /** \todo Need to decide when to invalidate a route */
       /*          else if (i->second.GetLifeTime() > m_holddownTime)
        {
        ++i;
--- a/src/dsr/model/dsr-errorbuff.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/dsr/model/dsr-errorbuff.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -58,7 +58,7 @@
       NS_LOG_INFO ("packet id " << i->GetPacket ()->GetUid () << " " << entry.GetPacket ()->GetUid () << " source " << i->GetSource () << " " << entry.GetSource ()
                                 << " next hop " << i->GetNextHop () << " " << entry.GetNextHop () << " dst " << i->GetDestination () << " " << entry.GetDestination ());
 
-      /// TODO check the source and destination over here
+      /// \todo check the source and destination over here
       if ((i->GetPacket ()->GetUid () == entry.GetPacket ()->GetUid ()) && (i->GetSource () == entry.GetSource ()) && (i->GetNextHop () == entry.GetSource ())
           && (i->GetDestination () == entry.GetDestination ()))
         {
--- a/src/dsr/model/dsr-options.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/dsr/model/dsr-options.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1481,7 +1481,7 @@
       p->RemoveHeader (rerrUnsupport);
       rerrSize = rerrUnsupport.GetSerializedSize ();
 
-      // This is for the other two error options, not supporting for now TODO
+      /// \todo This is for the other two error options, not supporting for now
 //      uint32_t serialized = DoSendError (p, rerrUnsupport, rerrSize, ipv4Address, protocol);
       uint32_t serialized = 0;
       return serialized;
--- a/src/dsr/model/dsr-rcache.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/dsr/model/dsr-rcache.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -502,7 +502,7 @@
   for (std::map<Link, LinkStab>::iterator i = m_linkCache.begin (); i != m_linkCache.end (); ++i)
     {
       // Here the weight is set as 1
-      // May need to set different weight for different link here later TODO
+      /// \todo May need to set different weight for different link here later
       uint32_t weight = 1;
       m_netGraph[i->first.m_low][i->first.m_high] = weight;
       m_netGraph[i->first.m_high][i->first.m_low] = weight;
@@ -523,7 +523,7 @@
     }
   else
     {
-      /// TODO get rid of the debug here
+      /// \todo get rid of the debug here
       NS_LOG_INFO ("The node stability " << i->second.GetNodeStability ().GetSeconds ());
       NS_LOG_INFO ("The stability here " << Time (i->second.GetNodeStability () * m_stabilityIncrFactor).GetSeconds ());
       NodeStab ns (Time (i->second.GetNodeStability () * m_stabilityIncrFactor));
@@ -546,7 +546,7 @@
     }
   else
     {
-      // TODO remove it here
+      /// \todo remove it here
       NS_LOG_INFO ("The stability here " << i->second.GetNodeStability ().GetSeconds ());
       NS_LOG_INFO ("The stability here " << Time (i->second.GetNodeStability () / m_stabilityDecrFactor).GetSeconds ());
       NodeStab ns (Time (i->second.GetNodeStability () / m_stabilityDecrFactor));
@@ -624,7 +624,7 @@
           if (m_linkCache[link].GetLinkStability () < m_useExtends)
             {
               m_linkCache[link].SetLinkStability (m_useExtends);
-              /// TODO remove after debug
+              /// \todo remove after debug
               NS_LOG_INFO ("The time of the link " << m_linkCache[link].GetLinkStability ().GetSeconds ());
             }
         }
@@ -785,7 +785,7 @@
       // erase the two kind of links to make sure the link is removed from the link cache
       NS_LOG_DEBUG ("Erase the route");
       m_linkCache.erase (link1);
-      /// TODO get rid of this one
+      /// \todo get rid of this one
       NS_LOG_DEBUG ("The link cache size " << m_linkCache.size());
       m_linkCache.erase (link2);
       NS_LOG_DEBUG ("The link cache size " << m_linkCache.size());
@@ -1179,7 +1179,7 @@
           if (pred (*j))
             {
               NS_LOG_LOGIC ("Close link to " << j->m_neighborAddress);
-              // disable temporarily TODO
+              /// \todo disable temporarily
 //              m_handleLinkFailure (j->m_neighborAddress);
             }
         }
--- a/src/dsr/model/dsr-routing.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/dsr/model/dsr-routing.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -474,7 +474,7 @@
   Ptr<Packet> newP = p->Copy();
   WifiMacHeader hdr;
   newP->RemoveHeader(hdr);
-  /// TODO this is a hard-coded check, need to find a better way to work on this
+  /// \todo this is a hard-coded check, need to find a better way to work on this
   if (newP->GetSize () == 4)
     {
       NS_LOG_WARN ("WifiMacTrailer left, skip this packet");
@@ -1094,7 +1094,7 @@
 
                   m_downTarget (newPacket, m_mainAddress, nextHop, GetProtocolNumber (), m_ipv4Route);
 
-                  // TODO
+                  /// \todo
 //                  DsrNetworkQueueEntry newEntry (newPacket, m_mainAddress, nextHop, Simulator::Now (), m_ipv4Route);
 //
 //                  if (dsrNetworkQueue->Enqueue (newEntry))
@@ -1475,7 +1475,7 @@
 
       m_downTarget (newPacket, m_mainAddress, nextHop, GetProtocolNumber (), m_ipv4Route);
 
-      // TODO
+      /// \todo
 //      DsrNetworkQueueEntry newEntry (newPacket, m_mainAddress, nextHop, Simulator::Now (), m_ipv4Route);
 //
 //      if (dsrNetworkQueue->Enqueue (newEntry))
@@ -1520,7 +1520,7 @@
 
   m_downTarget (packet, m_mainAddress, nextHop, GetProtocolNumber (), route);
 
-  // TODO
+  /// \todo
 //  DsrNetworkQueueEntry newEntry (packet, m_mainAddress, nextHop, Simulator::Now (), route);
 //
 //  if (dsrNetworkQueue->Enqueue (newEntry))
@@ -1732,7 +1732,7 @@
 
   m_downTarget (packet, source, nextHop, GetProtocolNumber (), m_ipv4Route);
 
-  //TODO
+  /// \todo 
 //  DsrNetworkQueueEntry newEntry (packet, source, nextHop, Simulator::Now (), m_ipv4Route);
 //
 //  if (dsrNetworkQueue->Enqueue (newEntry))
@@ -2038,7 +2038,7 @@
 
                   m_downTarget (newPacket, m_mainAddress, nextHop, GetProtocolNumber (), m_ipv4Route);
 
-                  // TODO
+                  /// \todo
 //                  DsrNetworkQueueEntry newEntry (newPacket, m_mainAddress, nextHop, Simulator::Now (), m_ipv4Route);
 //
 //                  if (dsrNetworkQueue->Enqueue (newEntry))
@@ -2390,7 +2390,7 @@
 
       m_downTarget (p, m_mainAddress, nextHop, GetProtocolNumber (), m_ipv4Route);
 
-      // TODO
+      /// \todo
 //      DsrNetworkQueueEntry newEntry (p, m_mainAddress, nextHop, Simulator::Now (), m_ipv4Route);
 //
 //      if (dsrNetworkQueue->Enqueue (newEntry))
@@ -3227,7 +3227,7 @@
 
   m_downTarget (packet, source, m_broadcast, GetProtocolNumber (), 0);
 
-  // TODO
+  /// \todo
 //  DsrNetworkQueueEntry newEntry (packet, source, m_broadcast, Simulator::Now (), 0);
 //  if (dsrNetworkQueue->Enqueue (newEntry))
 //    {
@@ -3333,7 +3333,7 @@
 
   m_downTarget (packet, source, nextHop, GetProtocolNumber (), route);
 
-  // TODO
+  /// \todo
 //  DsrNetworkQueueEntry newEntry (packet, source, nextHop, Simulator::Now (), route);
 //  if (dsrNetworkQueue->Enqueue (newEntry))
 //    {
@@ -3410,7 +3410,7 @@
 
   m_downTarget (packet, m_mainAddress, destination, GetProtocolNumber (), route);
 
-  // TODO
+  /// \todo
 //  DsrNetworkQueueEntry newEntry (packet, m_mainAddress, destination, Simulator::Now (), route);
 //  if (dsrNetworkQueue->Enqueue (newEntry))
 //    {
--- a/src/flow-monitor/model/histogram.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/flow-monitor/model/histogram.h	Tue Jun 11 17:02:23 2013 -0700
@@ -49,8 +49,8 @@
 
   void SerializeToXmlStream (std::ostream &os, int indent, std::string elementName) const;
 
-  // TODO: add method(s) to estimate N, µ, and s² from the histogram,
-  // see http://www.dspguide.com/ch2/4.htm
+  /// \todo add method(s) to estimate N, µ, and s² from the histogram,
+  /// see http://www.dspguide.com/ch2/4.htm
 
 private:
   std::vector<uint32_t> m_histogram;
--- a/src/internet/model/global-route-manager-impl.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/global-route-manager-impl.h	Tue Jun 11 17:02:23 2013 -0700
@@ -706,7 +706,7 @@
  * @brief Delete all static routes on all nodes that have a
  * GlobalRouterInterface
  *
- * TODO:  separate manually assigned static routes from static routes that
+ * \todo  separate manually assigned static routes from static routes that
  * the global routing code injects, and only delete the latter
  * @internal
  *
--- a/src/internet/model/icmpv6-header.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/icmpv6-header.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1470,7 +1470,7 @@
 Icmpv6OptionHeader::Icmpv6OptionHeader ()
 {
   NS_LOG_FUNCTION (this);
-  /* TODO */
+  /** \todo */
   m_type = 0;
   m_len = 0;
 }
--- a/src/internet/model/icmpv6-l4-protocol.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/icmpv6-l4-protocol.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -168,7 +168,7 @@
       return;
     }
 
-  /* TODO : disable multicast loopback to prevent NS probing to be received by the sender */
+  /** \todo disable multicast loopback to prevent NS probing to be received by the sender */
 
   Ptr<Packet> p = ForgeNS ("::",Ipv6Address::MakeSolicitedAddress (target), target, interface->GetDevice ()->GetAddress ());
 
@@ -222,7 +222,7 @@
     case Icmpv6Header::ICMPV6_ECHO_REPLY:
       // EchoReply does not contain any info about L4
       // so we can not forward it up.
-      // TODO: implement request / reply consistency check.
+      /// \todo implement request / reply consistency check.
       break;
     case Icmpv6Header::ICMPV6_ERROR_DESTINATION_UNREACHABLE:
       HandleDestinationUnreachable (p, header.GetSourceAddress (), header.GetDestinationAddress (), interface);
@@ -252,7 +252,7 @@
 
   Ptr<Ipv6L3Protocol> ipv6 = m_node->GetObject<Ipv6L3Protocol> ();
 
-  // TODO assuming the ICMP is carrying a extensionless IP packet
+  /// \todo assuming the ICMP is carrying a extensionless IP packet
 
   uint8_t nextHeader = ipHeader.GetNextHeader ();
 
@@ -1374,8 +1374,8 @@
 
       if (!ipv6->IsForwarding (ipv6->GetInterfaceForDevice (interface->GetDevice ())) && addr.IsLinkLocal ())
         {
-          /* XXX because all nodes start at the same time, there will be many of RS arround 1 second of simulation time
-           * TODO Add random delays before sending RS
+          /* \todo Add random delays before sending RS
+           * because all nodes start at the same time, there will be many of RS arround 1 second of simulation time
            */
           Simulator::Schedule (Seconds (0.0), &Icmpv6L4Protocol::SendRS, PeekPointer (icmpv6), ifaddr.GetAddress (), Ipv6Address::GetAllRoutersMulticast (), interface->GetDevice ()->GetAddress ());
         }
--- a/src/internet/model/ipv4-global-routing.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/ipv4-global-routing.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -489,11 +489,11 @@
   if (header.GetDestination ().IsBroadcast ())
     {
       NS_LOG_LOGIC ("For me (Ipv4Addr broadcast address)");
-      // TODO:  Local Deliver for broadcast
-      // TODO:  Forward broadcast
+      /// \todo  Local Deliver for broadcast
+      /// \todo  Forward broadcast
     }
 
-  // TODO:  Configurable option to enable RFC 1222 Strong End System Model
+  /// \todo  Configurable option to enable RFC 1222 Strong End System Model
   // Right now, we will be permissive and allow a source to send us
   // a packet to one of our other interface addresses; that is, the
   // destination unicast address does not match one of the iif addresses,
--- a/src/internet/model/ipv4-static-routing.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/ipv4-static-routing.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -516,12 +516,12 @@
   if (ipHeader.GetDestination ().IsBroadcast ())
     {
       NS_LOG_LOGIC ("For me (Ipv4Addr broadcast address)");
-      // TODO:  Local Deliver for broadcast
-      // TODO:  Forward broadcast
+      /// \todo Local Deliver for broadcast
+      /// \todo Forward broadcast
     }
 
   NS_LOG_LOGIC ("Unicast destination");
-  // TODO:  Configurable option to enable RFC 1222 Strong End System Model
+  /// \todo Configurable option to enable RFC 1222 Strong End System Model
   // Right now, we will be permissive and allow a source to send us
   // a packet to one of our other interface addresses; that is, the
   // destination unicast address does not match one of the iif addresses,
--- a/src/internet/model/ipv6-extension-header.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/ipv6-extension-header.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -613,23 +613,23 @@
 
 void Ipv6ExtensionESPHeader::Print (std::ostream &os) const
 {
-  /* TODO */
+  /* \todo */
 }
 
 uint32_t Ipv6ExtensionESPHeader::GetSerializedSize () const
 {
-  /* TODO */
+  /* \todo */
   return 0;
 }
 
 void Ipv6ExtensionESPHeader::Serialize (Buffer::Iterator start) const
 {
-  /* TODO */
+  /* \todo */
 }
 
 uint32_t Ipv6ExtensionESPHeader::Deserialize (Buffer::Iterator start) 
 {
-  /* TODO */
+  /* \todo */
   return 0;
 }
 
@@ -659,23 +659,23 @@
 
 void Ipv6ExtensionAHHeader::Print (std::ostream &os) const
 {
-  /* TODO */
+  /* \todo */
 }
 
 uint32_t Ipv6ExtensionAHHeader::GetSerializedSize () const
 {
-  /* TODO */
+  /* \todo */
   return 0;
 }
 
 void Ipv6ExtensionAHHeader::Serialize (Buffer::Iterator start) const
 {
-  /* TODO */
+  /* \todo */
 }
 
 uint32_t Ipv6ExtensionAHHeader::Deserialize (Buffer::Iterator start) 
 {
-  /* TODO */ 
+  /* \todo */ 
   return 0;
 }
 
--- a/src/internet/model/ipv6-extension.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/ipv6-extension.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1036,7 +1036,7 @@
 {
   NS_LOG_FUNCTION (this << packet << offset << ipv6Header << dst << nextHeader << isDropped);
 
-  /* TODO */
+  /** \todo */
 
   return 0;
 }
@@ -1074,7 +1074,7 @@
 {
   NS_LOG_FUNCTION (this << packet << offset << ipv6Header << dst << nextHeader << isDropped);
 
-  /* TODO */
+  /** \todo */
 
   return true;
 }
--- a/src/internet/model/ipv6-list-routing.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/ipv6-list-routing.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -147,7 +147,7 @@
       return retVal;
     }
 
-  // TODO:  Configurable option to enable RFC 1222 Strong End System Model
+  /// \todo  Configurable option to enable RFC 1222 Strong End System Model
   // Right now, we will be permissive and allow a source to send us
   // a packet to one of our other interface addresses; that is, the
   // destination unicast address does not match one of the iif addresses,
--- a/src/internet/model/ipv6-static-routing.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/ipv6-static-routing.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -565,7 +565,7 @@
         }
     }
 
-  // TODO:  Configurable option to enable RFC 1222 Strong End System Model
+  /// \todo  Configurable option to enable RFC 1222 Strong End System Model
   // Right now, we will be permissive and allow a source to send us
   // a packet to one of our other interface addresses; that is, the
   // destination unicast address does not match one of the iif addresses,
--- a/src/internet/model/nsc-tcp-l4-protocol.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/nsc-tcp-l4-protocol.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -114,7 +114,7 @@
 
 int external_rand ()
 {
-  return 1;   // TODO
+  return 1;   /// \todo
 }
 
 NscTcpL4Protocol::NscTcpL4Protocol ()
@@ -384,7 +384,7 @@
 
 void NscTcpL4Protocol::wakeup ()
 {
-  // TODO
+  /// \todo
   // this should schedule a timer to read from all tcp sockets now... this is
   // an indication that data might be waiting on the socket
 
--- a/src/internet/model/udp-socket-impl.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/internet/model/udp-socket-impl.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -86,7 +86,7 @@
 {
   NS_LOG_FUNCTION_NOARGS ();
 
-  // XXX todo:  leave any multicast groups that have been joined
+  /// \todo  leave any multicast groups that have been joined
   m_node = 0;
   /**
    * Note: actually this function is called AFTER
--- a/src/lte/model/epc-x2.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/epc-x2.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -750,7 +750,7 @@
 
   GtpuHeader gtpu;
   gtpu.SetTeid (params.gtpTeid);
-  gtpu.SetLength (params.ueData->GetSize () + gtpu.GetSerializedSize () - 8); // TODO This should be done in GtpuHeader
+  gtpu.SetLength (params.ueData->GetSize () + gtpu.GetSerializedSize () - 8); /// \todo This should be done in GtpuHeader
   NS_LOG_INFO ("GTP-U header: " << gtpu);
 
   Ptr<Packet> packet = params.ueData;
--- a/src/lte/model/fdbet-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/fdbet-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1228,7 +1228,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
 
   // update UEs stats
--- a/src/lte/model/fdmt-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/fdmt-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1221,7 +1221,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
   m_schedSapUser->SchedDlConfigInd (ret);
 
--- a/src/lte/model/fdtbfq-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/fdtbfq-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1471,7 +1471,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
   m_schedSapUser->SchedDlConfigInd (ret);
 
--- a/src/lte/model/lte-rlc-am.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/lte-rlc-am.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -835,7 +835,7 @@
                ( (! IsInsideReceivingWindow (m_vrX)) && (m_vrX != m_vrMr) )
              )
             {
-              // TODO stop and reset the t-Reordering
+              /// \todo stop and reset the t-Reordering
               NS_LOG_LOGIC ("Stop reordering timer");
               m_reorderingTimer.Cancel ();
             }
@@ -861,7 +861,7 @@
 
 
 
-      // TODO To remove
+      /// \todo To remove
 
       // 5.1.2.2.3 Actions when an UMD PDU is placed in the reception buffer
       // When an UMD PDU with SN = x is placed in the reception buffer, the receiving UM RLC entity shall:
@@ -1095,7 +1095,7 @@
           if ( lengthIndicator >= packet->GetSize () )
             {
               NS_LOG_LOGIC ("INTERNAL ERROR: Not enough data in the packet (" << packet->GetSize () << "). Needed LI=" << lengthIndicator);
-              // TODO What to do in this case? Discard packet and continue? Or Assert?
+              /// \todo What to do in this case? Discard packet and continue? Or Assert?
             }
 
           // Split packet in two fragments
@@ -1471,7 +1471,7 @@
 }
 
 
-// TODO To remove
+/// \todo To remove
 // void
 // LteRlcAm::ReassembleOutsideWindow (void)
 // {
@@ -1497,7 +1497,7 @@
 // }
 
 
-// TODO To remove
+/// \todo To remove
 // void
 // LteRlcAm::ReassembleSnLessThan (uint16_t seqNumber)
 // {
--- a/src/lte/model/lte-rlc-am.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/lte-rlc-am.h	Tue Jun 11 17:02:23 2013 -0700
@@ -147,7 +147,7 @@
   /**
    * Configurable parameters. See section 7.4 in TS 36.322
    */
-  uint16_t m_maxRetxThreshold;  // TODO How these parameters are configured???
+  uint16_t m_maxRetxThreshold;  /// \todo How these parameters are configured???
   uint16_t m_pollPdu;
   uint16_t m_pollByte;
 
--- a/src/lte/model/lte-rlc.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/lte-rlc.h	Tue Jun 11 17:02:23 2013 -0700
@@ -101,7 +101,7 @@
 
 
 
-  // TODO MRE What is the sense to duplicate all the interfaces here???
+  /// \todo MRE What is the sense to duplicate all the interfaces here???
   // NB to avoid the use of multiple inheritance
   
 protected:
--- a/src/lte/model/lte-ue-mac.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/lte-ue-mac.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -689,7 +689,7 @@
                   if (it->rapId == m_raPreambleId) // RAR is for me
                     {
                       RecvRaResponse (it->rarPayload);
-                      // TODO:: RRC generates the RecvRaResponse messaged
+                      /// \todo RRC generates the RecvRaResponse messaged
                       // for avoiding holes in transmission at PHY layer
                       // (which produce erroneous UL CQI evaluation)
                     }
--- a/src/lte/model/lte-ue-rrc.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/lte-ue-rrc.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -881,7 +881,7 @@
         {
           NS_LOG_INFO ("request to modify existing DRBID");
           Ptr<LteDataRadioBearerInfo> drbInfo = drbMapIt->second;
-          // TODO: currently not implemented. Would need to modify drbInfo, and then propagate changes to the MAC
+          /// \todo currently not implemented. Would need to modify drbInfo, and then propagate changes to the MAC
         }
     }
   
--- a/src/lte/model/pf-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/pf-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1251,7 +1251,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
 
   // update UEs stats
--- a/src/lte/model/pss-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/pss-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1550,7 +1550,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
 
   // update UEs stats
--- a/src/lte/model/rr-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/rr-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1152,7 +1152,7 @@
     }
   while ((*it).m_rnti != m_nextRntiDl);
 
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed  
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed  
 
   m_schedSapUser->SchedDlConfigInd (ret);
   return;
--- a/src/lte/model/tdbet-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/tdbet-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1151,7 +1151,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
 
   // update UEs stats
--- a/src/lte/model/tdmt-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/tdmt-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1161,7 +1161,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
   m_schedSapUser->SchedDlConfigInd (ret);
 
--- a/src/lte/model/tdtbfq-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/tdtbfq-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1257,7 +1257,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
   m_schedSapUser->SchedDlConfigInd (ret);
 
--- a/src/lte/model/tta-ff-mac-scheduler.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/model/tta-ff-mac-scheduler.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1240,7 +1240,7 @@
 
       itMap++;
     } // end while allocation
-  ret.m_nrOfPdcchOfdmSymbols = 1;   // TODO: check correct value according the DCIs txed
+  ret.m_nrOfPdcchOfdmSymbols = 1;   /// \todo check correct value according the DCIs txed
 
   m_schedSapUser->SchedDlConfigInd (ret);
 
--- a/src/lte/test/test-asn1-encoding.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/lte/test/test-asn1-encoding.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -482,7 +482,7 @@
   msg.measConfig.measIdToRemoveList.push_back (4);
   msg.measConfig.measIdToRemoveList.push_back (18);
  
-  // TODO: Test the following:
+  /// \todo Test the following:
   // std::list<MeasObjectToAddMod> measObjectToAddModList;
   // std::list<ReportConfigToAddMod> reportConfigToAddModList;
   // std::list<MeasIdToAddMod> measIdToAddModList;
--- a/src/mesh/helper/flame/flame-installer.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/helper/flame/flame-installer.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -55,7 +55,7 @@
 FlameStack::Report (const Ptr<MeshPointDevice> mp, std::ostream& os)
 {
   mp->Report (os);
-  // TODO report flame counters
+  /// \todo report flame counters
   Ptr<FlameProtocol> flame = mp->GetObject<FlameProtocol> ();
   NS_ASSERT (flame != 0);
   flame->Report (os);
@@ -64,7 +64,7 @@
 FlameStack::ResetStats (const Ptr<MeshPointDevice> mp)
 {
   mp->ResetStats ();
-  // TODO reset flame counters
+  /// \todo reset flame counters
   Ptr<FlameProtocol> flame = mp->GetObject<FlameProtocol> ();
   NS_ASSERT (flame != 0);
 
--- a/src/mesh/model/dot11s/hwmp-protocol-mac.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/dot11s/hwmp-protocol-mac.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -65,7 +65,7 @@
   m_stats.rxData++;
   m_stats.rxDataBytes += packet->GetSize ();
 
-  //TODO: address extension
+  /// \todo address extension
   Mac48Address destination;
   Mac48Address source;
   switch (meshHdr.GetAddressExt ())
--- a/src/mesh/model/dot11s/ie-dot11s-preq.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/dot11s/ie-dot11s-preq.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -348,7 +348,7 @@
           return;
         }
     }
-  //TODO: check overflow
+  /// \todo check overflow
   Ptr<DestinationAddressUnit> new_element = Create<DestinationAddressUnit> ();
   new_element->SetFlags (doFlag, rfFlag, (dest_seq_number == 0));
   new_element->SetDestinationAddress (dest_address);
--- a/src/mesh/model/dot11s/ie-dot11s-preq.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/dot11s/ie-dot11s-preq.h	Tue Jun 11 17:02:23 2013 -0700
@@ -132,7 +132,7 @@
   /**
    * how many destinations we support
    */
-  uint8_t m_maxSize; //TODO: make as an attribute
+  uint8_t m_maxSize; /// \todo make as an attribute
   /**
    * Fields of information element:
    */
--- a/src/mesh/model/dot11s/peer-link-frame.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/dot11s/peer-link-frame.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -72,7 +72,7 @@
 PeerLinkFrameStart::GetFields () const
 {
   PlinkFrameStartFields retval;
-  //TODO: protocol version:
+  /// \todo protocol version:
   retval.subtype = m_subtype;
   retval.capability = m_capability;
   retval.aid = m_aid;
--- a/src/mesh/model/dot11s/peer-management-protocol.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/dot11s/peer-management-protocol.h	Tue Jun 11 17:02:23 2013 -0700
@@ -137,7 +137,8 @@
   std::vector < Ptr<PeerLink> > GetPeerLinks () const;
   /// Get list of active peers of my given interface
   std::vector<Mac48Address> GetPeers (uint32_t interface) const;
-  /// Get mesh point address. TODO this used by plugins only. Now MAC plugins can ask MP addrress directly from main MAC
+  /// Get mesh point address.
+  /// \todo this used by plugins only. Now MAC plugins can ask MP addrress directly from main MAC
   Mac48Address GetAddress ();
   uint8_t GetNumberOfLinks ();
   void SetMeshId (std::string s);
--- a/src/mesh/model/mesh-point-device.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/mesh-point-device.h	Tue Jun 11 17:02:23 2013 -0700
@@ -44,7 +44,7 @@
  * From the level 3 point of view MeshPointDevice is similar to BridgeNetDevice, but the packets,
  * which going through may be changed (because L2 protocols may require their own headers or tags).
  *
- * Attributes: TODO
+ * Attributes: \todo
  */
 class MeshPointDevice : public NetDevice
 {
@@ -135,12 +135,13 @@
   /**
    * \brief Response callback for L2 routing protocol. This will be executed when routing information is ready.
    *
-   * \param success     True is route found. TODO: diagnose routing errors
+   * \param success     True is route found. 
    * \param packet      Packet to send
    * \param src         Source MAC address
    * \param dst         Destination MAC address
    * \param protocol    Protocol ID
    * \param iface       Interface to use (ID) for send (decided by routing protocol). All interfaces will be used if outIface = 0xffffffff
+   * \todo diagnose routing errors
    */
   void
   DoSend (bool success, Ptr<Packet> packet, Mac48Address src, Mac48Address dst, uint16_t protocol,
--- a/src/mesh/model/mesh-wifi-interface-mac-plugin.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/mesh-wifi-interface-mac-plugin.h	Tue Jun 11 17:02:23 2013 -0700
@@ -36,7 +36,7 @@
  * 
  * \brief Common interface for mesh point interface MAC plugins
  * 
- * TODO: plugins description
+ * \todo plugins description
  */
 class MeshWifiInterfaceMacPlugin : public SimpleRefCount<MeshWifiInterfaceMacPlugin>
 {
@@ -49,20 +49,20 @@
    * \brief Process received frame
    * 
    * \return false if (and only if) frame should be dropped
-   * TODO define when MAC call this
+   * \todo define when MAC call this
    */
   virtual bool Receive (Ptr<Packet> packet, const WifiMacHeader & header) = 0;
   /**
    * \brief Update frame before it will be forwarded down
    * 
    * \return false if (and only if) frame should be dropped
-   * TODO define when MAC call this, preconditions & postconditions
+   * \todo define when MAC call this, preconditions & postconditions
    */
   virtual bool UpdateOutcomingFrame (Ptr<Packet> packet, WifiMacHeader & header, Mac48Address from, Mac48Address to) = 0;
   /**
    * \brief Update beacon before it will be formed and sent
    *
-   * TODO define when MAC call this
+   * \todo define when MAC call this
    */
   virtual void UpdateBeacon (MeshWifiBeacon & beacon) const = 0;
   /**
--- a/src/mesh/model/mesh-wifi-interface-mac.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/mesh-wifi-interface-mac.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -193,8 +193,8 @@
 {
   NS_LOG_FUNCTION (this);
   NS_ASSERT (m_phy != 0); // need PHY to set/get channel
-  /* TODO
-   *
+  /**
+   * \todo
    * Correct channel switching is:
    *
    * 1. Interface down, e.g. to stop packets from layer 3
@@ -513,7 +513,7 @@
 MeshWifiInterfaceMac::Statistics::Print (std::ostream & os) const
 {
   os << "<Statistics "
-  // TODO txBeacons
+  /// \todo txBeacons
   "rxBeacons=\"" << recvBeacons << "\" "
   "txFrames=\"" << sentFrames << "\" "
   "txBytes=\"" << sentBytes << "\" "
--- a/src/mesh/model/mesh-wifi-interface-mac.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/mesh/model/mesh-wifi-interface-mac.h	Tue Jun 11 17:02:23 2013 -0700
@@ -99,7 +99,8 @@
 
   ///\name Plugins
   // \{
-  /// Install plugin. TODO return unique ID to allow unregister plugins
+  /// Install plugin.
+  /// \todo return unique ID to allow unregister plugins
   void InstallPlugin (Ptr<MeshWifiInterfaceMacPlugin> plugin);
   // \}
 
@@ -147,7 +148,8 @@
 private:
   /// Frame receive handler
   void  Receive (Ptr<Packet> packet, WifiMacHeader const *hdr);
-  /// Send frame. Frame is supposed to be tagged by routing information. TODO: clarify this point
+  /// Send frame. Frame is supposed to be tagged by routing information.
+  /// \todo clarify this point
   void  ForwardDown (Ptr<const Packet> packet, Mac48Address from, Mac48Address to);
   /// Send beacon
   void SendBeacon ();
--- a/src/netanim/model/animation-interface.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/netanim/model/animation-interface.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -1192,7 +1192,7 @@
       AddPendingWifiPacket (AnimUid, pktinfo);
       NS_LOG_WARN ("WifiPhyRxBegin: unknown Uid, but we are adding a wifi packet");
     }
-  // TODO: NS_ASSERT (WifiPacketIsPending (AnimUid) == true);
+  /// \todo NS_ASSERT (WifiPacketIsPending (AnimUid) == true);
   m_pendingWifiPackets[AnimUid].ProcessRxBegin (ndev, Simulator::Now ());
   m_pendingWifiPackets[AnimUid].ProcessRxEnd (ndev, Simulator::Now (), UpdatePosition (n));
   OutputWirelessPacket (p, m_pendingWifiPackets[AnimUid], m_pendingWifiPackets[AnimUid].GetRxInfo (ndev));
@@ -1215,7 +1215,7 @@
       AnimPacketInfo pktinfo (ndev, Simulator::Now (), Simulator::Now (), UpdatePosition (n));
       AddPendingWifiPacket (AnimUid, pktinfo);
     }
-  // TODO: NS_ASSERT (WifiPacketIsPending (AnimUid) == true);
+  /// \todo NS_ASSERT (WifiPacketIsPending (AnimUid) == true);
   AnimPacketInfo& pktInfo = m_pendingWifiPackets[AnimUid];
   pktInfo.ProcessRxEnd (ndev, Simulator::Now (), UpdatePosition (n));
   AnimRxInfo pktrxInfo = pktInfo.GetRxInfo (ndev);
@@ -1241,7 +1241,7 @@
       NS_LOG_WARN ("WifiMacRxTrace: unknown Uid");
       return;
     }
-  // TODO: NS_ASSERT (WifiPacketIsPending (AnimUid) == true);
+  /// \todo NS_ASSERT (WifiPacketIsPending (AnimUid) == true);
   AnimPacketInfo& pktInfo = m_pendingWifiPackets[AnimUid];
   AnimRxInfo pktrxInfo = pktInfo.GetRxInfo (ndev);
   if (pktrxInfo.IsPhyRxComplete ())
@@ -1267,7 +1267,7 @@
   gAnimUid++;
   NS_LOG_INFO ("WimaxTxTrace for packet:" << gAnimUid);
   AnimPacketInfo pktinfo (ndev, Simulator::Now (), Simulator::Now () + Seconds (0.001), UpdatePosition (n));
-  //TODO 0.0001 is used until Wimax implements TxBegin and TxEnd traces
+  /// \todo 0.0001 is used until Wimax implements TxBegin and TxEnd traces
   AnimByteTag tag;
   tag.Set (gAnimUid);
   p->AddByteTag (tag);
@@ -1289,7 +1289,7 @@
   AnimPacketInfo& pktInfo = m_pendingWimaxPackets[AnimUid];
   pktInfo.ProcessRxBegin (ndev, Simulator::Now ());
   pktInfo.ProcessRxEnd (ndev, Simulator::Now () + Seconds (0.001), UpdatePosition (n));
-  //TODO 0.001 is used until Wimax implements RxBegin and RxEnd traces
+  /// \todo 0.001 is used until Wimax implements RxBegin and RxEnd traces
   AnimRxInfo pktrxInfo = pktInfo.GetRxInfo (ndev);
   OutputWirelessPacket (p, pktInfo, pktrxInfo);
 }
@@ -1305,7 +1305,7 @@
   gAnimUid++;
   NS_LOG_INFO ("LteTxTrace for packet:" << gAnimUid);
   AnimPacketInfo pktinfo (ndev, Simulator::Now (), Simulator::Now () + Seconds (0.001), UpdatePosition (n));
-  //TODO 0.0001 is used until Lte implements TxBegin and TxEnd traces
+  /// \todo 0.0001 is used until Lte implements TxBegin and TxEnd traces
   AnimByteTag tag;
   tag.Set (gAnimUid);
   p->AddByteTag (tag);
@@ -1331,7 +1331,7 @@
   AnimPacketInfo& pktInfo = m_pendingLtePackets[AnimUid];
   pktInfo.ProcessRxBegin (ndev, Simulator::Now ());
   pktInfo.ProcessRxEnd (ndev, Simulator::Now () + Seconds (0.001), UpdatePosition (n));
-  //TODO 0.001 is used until Lte implements RxBegin and RxEnd traces
+  /// \todo 0.001 is used until Lte implements RxBegin and RxEnd traces
   AnimRxInfo pktrxInfo = pktInfo.GetRxInfo (ndev);
   OutputWirelessPacket (p, pktInfo, pktrxInfo);
 }
@@ -1360,7 +1360,7 @@
     gAnimUid++;
     NS_LOG_INFO ("LteSpectrumPhyTxTrace for packet:" << gAnimUid);
     AnimPacketInfo pktinfo (ndev, Simulator::Now (), Simulator::Now () + Seconds (0.001), UpdatePosition (n));
-    //TODO 0.0001 is used until Lte implements TxBegin and TxEnd traces
+    /// \todo 0.0001 is used until Lte implements TxBegin and TxEnd traces
     AnimByteTag tag;
     tag.Set (gAnimUid);
     p->AddByteTag (tag);
@@ -1399,7 +1399,7 @@
     AnimPacketInfo& pktInfo = m_pendingLtePackets[AnimUid];
     pktInfo.ProcessRxBegin (ndev, Simulator::Now ());
     pktInfo.ProcessRxEnd (ndev, Simulator::Now () + Seconds (0.001), UpdatePosition (n));
-    //TODO 0.001 is used until Lte implements RxBegin and RxEnd traces
+    /// \todo 0.001 is used until Lte implements RxBegin and RxEnd traces
     AnimRxInfo pktrxInfo = pktInfo.GetRxInfo (ndev);
     OutputWirelessPacket (p, pktInfo, pktrxInfo);
   }
@@ -1440,7 +1440,7 @@
       AddPendingCsmaPacket (AnimUid, pktinfo);
       NS_LOG_WARN ("Unknown Uid, but adding Csma Packet anyway");
     }
-  // TODO: NS_ASSERT (CsmaPacketIsPending (AnimUid) == true);
+  /// \todo NS_ASSERT (CsmaPacketIsPending (AnimUid) == true);
   AnimPacketInfo& pktInfo = m_pendingCsmaPackets[AnimUid];
   pktInfo.m_lbTx = Simulator::Now ().GetSeconds ();
 }
@@ -1459,7 +1459,7 @@
       NS_LOG_WARN ("CsmaPhyRxEndTrace: unknown Uid"); 
       return;
     }
-  // TODO: NS_ASSERT (CsmaPacketIsPending (AnimUid) == true);
+  /// \todo NS_ASSERT (CsmaPacketIsPending (AnimUid) == true);
   AnimPacketInfo& pktInfo = m_pendingCsmaPackets[AnimUid];
   m_pendingCsmaPackets[AnimUid].ProcessRxBegin (ndev, Simulator::Now ());
   pktInfo.ProcessRxEnd (ndev, Simulator::Now (), UpdatePosition (n));
@@ -1483,7 +1483,7 @@
       NS_LOG_WARN ("CsmaMacRxTrace: unknown Uid"); 
       return;
     }
-  // TODO: NS_ASSERT (CsmaPacketIsPending (AnimUid) == true);
+  /// \todo NS_ASSERT (CsmaPacketIsPending (AnimUid) == true);
   AnimPacketInfo& pktInfo = m_pendingCsmaPackets[AnimUid];
   AnimRxInfo pktrxInfo = pktInfo.GetRxInfo (ndev);
   if (pktrxInfo.IsPhyRxComplete ())
--- a/src/network/utils/ipv6-address.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/network/utils/ipv6-address.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -194,7 +194,7 @@
           continue;
         }
 
-      /* TODO Handle IPv4 mapped address (2001::192.168.0.1) */
+      /* \todo Handle IPv4 mapped address (2001::192.168.0.1) */
 #if 0
       if (ch == '.' && ((tp + 4 /*NS_INADDRSZ*/) <= endp) &&
           inet_pton4 (curtok, tp) > 0)
--- a/src/network/utils/pcap-test.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/network/utils/pcap-test.h	Tue Jun 11 17:02:23 2013 -0700
@@ -22,7 +22,7 @@
     std::string expected = CreateDataDirFilename (oss.str());           \
     std::string got = CreateTempDirFilename (oss.str());                \
     uint32_t sec(0), usec(0);                                           \
-    /* TODO support default PcapWriter snap length here */              \
+    /** \todo support default PcapWriter snap length here */			\
     bool diff = PcapFile::Diff (got, expected, sec, usec);              \
     NS_TEST_EXPECT_MSG_EQ (diff, false,                                 \
                            "PCAP traces " << got << " and " << expected \
--- a/src/network/utils/red-queue.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/network/utils/red-queue.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -404,7 +404,7 @@
       m_qW = 1.0 - std::exp (-10.0 / m_ptc);
     }
 
-  // TODO: implement adaptive RED
+  /// \todo implement adaptive RED
 
   NS_LOG_DEBUG ("\tm_delay " << m_linkDelay.GetSeconds () << "; m_isWait " 
                              << m_isWait << "; m_qW " << m_qW << "; m_ptc " << m_ptc
@@ -430,7 +430,7 @@
   newAve *= 1.0 - qW;
   newAve += qW * nQueued;
 
-  // TODO: implement adaptive RED
+  // implement adaptive RED
 
   return newAve;
 }
@@ -488,7 +488,7 @@
       // DROP or MARK
       m_count = 0;
       m_countBytes = 0;
-      // TODO: Implement set bit to mark
+      /// \todo Implement set bit to mark
 
       return 1; // drop
     }
--- a/src/olsr/model/olsr-header.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/olsr/model/olsr-header.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -130,7 +130,7 @@
 void 
 PacketHeader::Print (std::ostream &os) const
 {
-  // TODO
+  /// \todo
 }
 
 void
@@ -207,7 +207,7 @@
 void 
 MessageHeader::Print (std::ostream &os) const
 {
-  // TODO
+  /// \todo
 }
 
 void
@@ -288,7 +288,7 @@
 void 
 MessageHeader::Mid::Print (std::ostream &os) const
 {
-  // TODO
+  /// \todo
 }
 
 void
@@ -340,7 +340,7 @@
 void 
 MessageHeader::Hello::Print (std::ostream &os) const
 {
-  // TODO
+  /// \todo
 }
 
 void
@@ -423,7 +423,7 @@
 void 
 MessageHeader::Tc::Print (std::ostream &os) const
 {
-  // TODO
+  /// \todo
 }
 
 void
@@ -473,7 +473,7 @@
 void 
 MessageHeader::Hna::Print (std::ostream &os) const
 {
-  // TODO
+  /// \todo
 }
 
 void
--- a/src/openflow/model/openflow-switch-net-device.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/openflow/model/openflow-switch-net-device.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -846,7 +846,7 @@
   desc->config = htonl (p.config);
   desc->state = htonl (p.state);
 
-  // TODO: This should probably be fixed eventually to specify different available features.
+  /// \todo This should probably be fixed eventually to specify different available features.
   desc->curr = 0; // htonl(netdev_get_features(p->netdev, NETDEV_FEAT_CURRENT));
   desc->supported = 0; // htonl(netdev_get_features(p->netdev, NETDEV_FEAT_SUPPORTED));
   desc->advertised = 0; // htonl(netdev_get_features(p->netdev, NETDEV_FEAT_ADVERTISED));
@@ -1185,12 +1185,12 @@
           if ((opm->config & htonl (OFPPC_PORT_DOWN)) && (p.config & OFPPC_PORT_DOWN) == 0)
             {
               p.config |= OFPPC_PORT_DOWN;
-              // TODO: Possibly disable the Port's Net Device via the appropriate interface.
+              /// \todo Possibly disable the Port's Net Device via the appropriate interface.
             }
           else if ((opm->config & htonl (OFPPC_PORT_DOWN)) == 0 && (p.config & OFPPC_PORT_DOWN))
             {
               p.config &= ~OFPPC_PORT_DOWN;
-              // TODO: Possibly enable the Port's Net Device via the appropriate interface.
+              /// \todo Possibly enable the Port's Net Device via the appropriate interface.
             }
         }
     }
--- a/src/stats/model/omnet-data-output.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/stats/model/omnet-data-output.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -90,7 +90,7 @@
   std::string fn = m_filePrefix +"-"+dc.GetRunLabel ()+ ".sca";
   scalarFile.open (fn.c_str (), std::ios_base::out);
 
-  // TODO add timestamp to the runlevel
+  /// \todo add timestamp to the runlevel
   scalarFile << "run " << dc.GetRunLabel () << std::endl;
   scalarFile << "attr experiment \"" << dc.GetExperimentLabel ()
              << "\"" << std::endl;
--- a/src/stats/model/sqlite-data-output.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/stats/model/sqlite-data-output.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -106,7 +106,7 @@
       NS_LOG_ERROR ("Could not open sqlite3 database \"" << m_dbFile << "\"");
       NS_LOG_ERROR ("sqlite3 error \"" << sqlite3_errmsg (m_db) << "\"");
       sqlite3_close (m_db);
-      // TODO: Better error reporting, management!
+      /// \todo Better error reporting, management!
       return;
     }
 
--- a/src/uan/model/uan-net-device.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/uan/model/uan-net-device.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -226,7 +226,7 @@
 bool
 UanNetDevice::SetMtu (uint16_t mtu)
 {
-  // TODO:  Check this in MAC
+  /// \todo  Check this in MAC
   NS_LOG_WARN ("UanNetDevice:  MTU is not implemented");
   m_mtu = mtu;
   return true;
--- a/src/uan/model/uan-phy-dual.h	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/uan/model/uan-phy-dual.h	Tue Jun 11 17:02:23 2013 -0700
@@ -250,7 +250,7 @@
 
   virtual void SetSleepMode (bool sleep)
   {
-    //TODO This method has to be implemented
+    /// \todo This method has to be implemented
   }
 
   /**
--- a/src/wifi/model/wifi-information-element-vector.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/wifi/model/wifi-information-element-vector.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -106,7 +106,7 @@
 void
 WifiInformationElementVector::Print (std::ostream & os) const
 {
-  //TODO
+  /// \todo
 }
 void
 WifiInformationElementVector::SetMaxSize (uint16_t size)
--- a/src/wifi/model/wifi-remote-station-manager.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/wifi/model/wifi-remote-station-manager.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -644,7 +644,7 @@
    *   unless they conflict with the requirement to use the
    *   BSSBasicRateSet parameter.
    *
-   * TODO: Note that we're ignoring the last sentence for now, because
+   * \todo Note that we're ignoring the last sentence for now, because
    * there is not yet any manipulation here of PHY options.
    */
   for (uint32_t idx = 0; idx < m_wifiPhy->GetNModes (); idx++)
--- a/src/wimax/model/cid-factory.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/wimax/model/cid-factory.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -118,7 +118,7 @@
 void
 CidFactory::FreeCid (Cid cid)
 {
-  // TODO:We need to update the cid bitmap properly here.
+  /// \todo We need to update the cid bitmap properly here.
   NS_FATAL_ERROR ("TODO: Update the cid bitmap properly here-- please implement and contribute a patch");
 }
 
--- a/src/wimax/model/wimax-net-device.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/wimax/model/wimax-net-device.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -633,7 +633,7 @@
 void
 WimaxNetDevice::AddLinkChangeCallback (Callback<void> callback)
 {
-  /* TODO: Add a callback invoked whenever the link
+  /* \todo Add a callback invoked whenever the link
    * status changes to UP. This callback is typically used
    * by the IP/ARP layer to flush the ARP cache and by IPv6 stack
    * to flush NDISC cache whenever the link goes up.
--- a/src/wimax/model/wimax-tlv.cc	Tue Jun 11 16:48:13 2013 -0700
+++ b/src/wimax/model/wimax-tlv.cc	Tue Jun 11 17:02:23 2013 -0700
@@ -156,15 +156,15 @@
   switch (m_type)
     {
     case HMAC_TUPLE:
-      // TODO: implement Deserialize HMAC_TUPLE
+      /// \todo implement Deserialize HMAC_TUPLE
       NS_FATAL_ERROR ("Not implemented-- please implement and contribute a patch");
       break;
     case MAC_VERSION_ENCODING:
-      // TODO: implement Deserialize MAC_VERSION_ENCODING
+      /// \todo implement Deserialize MAC_VERSION_ENCODING
       NS_FATAL_ERROR ("Not implemented-- please implement and contribute a patch");
       break;
     case CURRENT_TRANSMIT_POWER:
-      // TODO: implement Deserialize CURRENT_TRANSMIT_POWER
+      /// \todo implement Deserialize CURRENT_TRANSMIT_POWER
       NS_FATAL_ERROR ("Not implemented-- please implement and contribute a patch");
       break;
     case DOWNLINK_SERVICE_FLOW:
@@ -182,11 +182,11 @@
         break;
       }
     case VENDOR_ID_EMCODING:
-      // TODO: implement Deserialize VENDOR_ID_EMCODING
+      /// \todo implement Deserialize VENDOR_ID_EMCODING
       NS_FATAL_ERROR ("Not implemented-- please implement and contribute a patch");
       break;
     case VENDOR_SPECIFIC_INFORMATION:
-      // TODO: implement Deserialize  VENDOR_SPECIFIC_INFORMATION
+      /// \todo implement Deserialize  VENDOR_SPECIFIC_INFORMATION
       NS_FATAL_ERROR ("Not implemented-- please implement and contribute a patch");
       break;
     default: