more doxygen

doc/modules

@@ -24,7 +24,7 @@
  *      in a simulation: ns3::Config.
  *
  * @defgroup common Common
- * The "core" module contains: 
+ * The "common" module contains: 
  *    - a packet class to create and manipulate simulation packets: 
  *      ns3::Packet, ns3::Header,  and ns3::Trailer. This packet class 
  *      also supports per-packet ns3::Tag which are  globs of data 
@@ -62,4 +62,4 @@
  * @brief Constants you can change
  *
  * @defgroup contrib Contrib
- */
+ */

src/common/chunk.h

@@ -8,6 +8,8 @@ namespace ns3 {
 
 /**
  * \ingroup packet
+ *
+ * \brief abstract base class for ns3::Header and ns3::Trailer
  */
 class Chunk : public ObjectBase
 {

src/common/header.h

@@ -28,7 +28,7 @@
 namespace ns3 {
 
 /**
- * \ingroup Packet
+ * \ingroup packet
  *
  * \brief Protocol header serialization and deserialization.
  *

src/node/address.h

@@ -10,6 +10,11 @@
 namespace ns3 {
 
 /**
+ * \ingroup node
+ * \defgroup address Address
+ */
+/**
+ * \ingroup address
  * \brief a polymophic address class
  *
  * This class is very similar in design and spirit to the BSD sockaddr

src/node/application.h

@@ -33,6 +33,9 @@ class Node;
 class RandomVariable;
 
 /**
+ * \ingroup node
+ * \defgroup application
+ *
  * \brief The base class for all ns3 applicationes
  * 
  * Class Application is the base class for all ns3 applications.

src/node/channel.h

@@ -27,6 +27,9 @@ namespace ns3 {
 class NetDevice;
 
 /**
+ * \ingroup node
+ * \defgroup channel Channel
+ *
  * \brief Abstract Channel Base Class.
  *
  * A channel is a logical path over which information flows.  The path can

src/node/drop-tail-queue.h

@@ -28,6 +28,8 @@ namespace ns3 {
 class TraceContainer;
 
 /**
+ * \ingroup queue
+ *
  * \brief A FIFO packet queue that drops tail-end packets on overflow
  */
 class DropTailQueue : public Queue {

src/node/ethernet-header.h

@@ -38,6 +38,8 @@ namespace ns3 {
     QINQ      /**< Double tagged packet. Header includes two VLAN tags */
   };
 /**
+ * \ingroup node
+ *
  * \brief Packet header for Ethernet
  *
  * This class can be used to add a header to an ethernet packet that

src/node/ethernet-trailer.h

@@ -29,6 +29,8 @@ namespace ns3 {
 class Packet;
 
 /**
+ * \ingroup node
+ *
  * \brief Packet trailer for Ethernet
  *
  * This class can be used to add and verify the FCS at the end of an

src/node/inet-socket-address.h

@@ -29,6 +29,8 @@ namespace ns3 {
 
 
 /**
+ * \ingroup address
+ *
  * \brief an Inet address class
  *
  * This class is similar to inet_sockaddr in the BSD socket

src/node/ipv4-address-generator.h

@@ -23,6 +23,12 @@
 
 namespace ns3 {
 
+/**
+ * \ingroup address
+ *
+ * \brief This generator assigns addresses sequentially from a provided
+ * network address; used in topology code.
+ */
 class Ipv4AddressGenerator {
 public:
   static void Init (const Ipv4Address net, const Ipv4Mask mask, 

src/node/ipv4-address.h

@@ -30,9 +30,11 @@ namespace ns3 {
 
 class Ipv4Mask;
 
-/** Ipv4 addresses are stored in host order in
-  * this class.
-  */
+/** 
+ * \ingroup address
+ *
+ * \brief Ipv4 addresses are stored in host order in this class.
+ */
 class Ipv4Address {
 public:
   Ipv4Address ();
@@ -144,7 +146,11 @@ private:
   friend bool operator < (Ipv4Address const &addrA, Ipv4Address const &addrB);
 };
 
-
+/**
+ * \ingroup address
+ *
+ * \brief a class to represent an Ipv4 address mask
+ */
 class Ipv4Mask {
 public:
   Ipv4Mask ();

src/node/ipv4-route.h

@@ -28,6 +28,7 @@
 
 namespace ns3 {
 /**
+ * \ingroup ipv4
  * \brief A record of an IPv4 route
  */
 class Ipv4Route {
@@ -106,6 +107,7 @@ private:
 std::ostream& operator<< (std::ostream& os, Ipv4Route const& route);
 
 /**
+ * \ingroup ipv4 
  * \brief A record of an IPv4 multicast route
  */
 class Ipv4MulticastRoute {

src/node/ipv4.h

@@ -32,10 +32,17 @@ class Node;
 class NetDevice;
 class Packet;
 class Ipv4Route;
-class Ipv4Header; // FIXME: ipv4-header.h needs to move from module
+class Ipv4Header; // XXX: ipv4-header.h needs to move from module
                   // "internet-node" to module "node"
 
 /**
+ * \ingroup node
+ * \defgroup ipv4 Ipv4
+ */
+
+/**
+ * \ingroup ipv4
+ *
  * \brief Base class for IPv4 routing protocols.
  *
  * This class represents the interface between the IPv4 routing core

src/node/llc-snap-header.h

@@ -27,6 +27,11 @@
 
 namespace ns3 {
 
+/**
+ * \ingroup node
+ *
+ * \brief Header for the LLC/SNAP encapsulation
+ */
 class LlcSnapHeader : public Header 
 {
 public:

src/node/mac48-address.h

@@ -30,6 +30,8 @@ namespace ns3 {
 class Address;
 
 /**
+ * \ingroup address
+ * 
  * \brief an EUI-48 address
  *
  * This class can contain 48 bit IEEE addresses.

src/node/mac64-address.h

@@ -28,6 +28,8 @@ namespace ns3 {
 class Address;
 
 /**
+ * \ingroup address
+ *
  * \brief an EUI-64 address
  *
  * This class can contain 64 bit IEEE addresses.

src/node/net-device.h

@@ -36,6 +36,12 @@ class Channel;
 class Packet;
 
 /**
+ * \ingroup node
+ * \defgroup netdevice NetDevice
+ */
+/**
+ * \ingroup NetDevice
+ *
  * \brief Network layer to device interface
  *
  * This interface defines the API which the IP and ARP

src/node/node-list.h

@@ -31,6 +31,8 @@ class CallbackBase;
 
 
 /**
+ * \ingroup node
+ *
  * \brief the list of simulation nodes.
  *
  * Every Node created is automatically added to this list.

src/node/node.h

@@ -36,6 +36,8 @@ class Address;
 
 
 /**
+ * \ingroup node
+ *
  * \brief A network Node.
  *
  * This class holds together:

src/node/packet-socket-address.h

@@ -30,6 +30,11 @@ namespace ns3 {
 
 class NetDevice;
 
+/**
+ * \ingroup address
+ *
+ * \brief an address for a packet socket
+ */
 class PacketSocketAddress
 {
  public:

src/node/packet-socket-factory.h

@@ -27,6 +27,8 @@ namespace ns3 {
 class Socket;
 
 /**
+ * \ingroup socket 
+ * 
  * This can be used as an interface in a node in order for the node to
  * generate PacketSockets that can connect to net devices.
  */

src/node/packet-socket.h

@@ -36,6 +36,8 @@ class NetDevice;
 class PacketSocketAddress;
 
 /**
+ * \ingroup socket
+ *
  * \brief A PacketSocket is a link between an application and a net device.
  *
  * A PacketSocket can be used to connect an application to a net

src/node/queue.h

@@ -33,6 +33,9 @@
 namespace ns3 {
 
 /**
+ * \ingroup node
+ * \defgroup queue Queue
+ *
  * \brief Abstract base class for packet Queues
  * 
  * This class defines the base APIs for packet queues in the ns-3 system

src/node/simple-channel.h

@@ -10,6 +10,10 @@ namespace ns3 {
 class SimpleNetDevice;
 class Packet;
 
+/**
+ * \ingroup channel
+ * \brief A simple channel, for simple things and testing
+ */
 class SimpleChannel : public Channel
 {
 public:

src/node/simple-net-device.h

@@ -30,6 +30,11 @@ namespace ns3 {
 class SimpleChannel;
 class Node;
 
+/**
+ * \ingroup netdevice
+ * 
+ * \brief simple net device for simple things and testing
+ */
 class SimpleNetDevice : public NetDevice
 {
 public:

src/node/socket-factory.h

@@ -28,6 +28,8 @@ namespace ns3 {
 class Socket;
 
 /**
+ * \ingroup socket
+ *
  * \brief Object to create transport layer instances that provide a 
  * socket API to applications.
  *

src/node/tcp-socket-factory.h

@@ -27,6 +27,8 @@ namespace ns3 {
 class Socket;
 
 /**
+ * \ingroup socket
+ *
  * \brief API to create TCP socket instances 
  *
  * This abstract class defines the API for TCP sockets.

src/node/tcp-socket.h

@@ -36,6 +36,8 @@ class Node;
 class Packet;
 
 /**
+ * \ingroup socket
+ *
  * \brief (abstract) base class of all TcpSockets
  *
  * This class exists solely for hosting TcpSocket attributes that can

src/node/udp-socket-factory.h

@@ -27,6 +27,8 @@ namespace ns3 {
 class Socket;
 
 /**
+ * \ingroup socket
+ *
  * \brief API to create UDP socket instances 
  *
  * This abstract class defines the API for UDP socket factory.

src/node/udp-socket.h

@@ -35,6 +35,8 @@ class Node;
 class Packet;
 
 /**
+ * \ingroup socket
+ *
  * \brief (abstract) base class of all UdpSockets
  *
  * This class exists solely for hosting UdpSocket attributes that can