Tidy up \file & \author blocks under core/net/ipv6

* Make these blocks appear in the respective module pages
* Re-word \file blocks to bring them up to speed with what each file actually does nowadays
This commit is contained in:
George Oikonomou 2015-02-15 19:02:07 +01:00
parent 06cfea692b
commit b0390e3e70
11 changed files with 70 additions and 51 deletions

View file

@ -29,6 +29,11 @@
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
/** /**
* \file * \file
* IPv6 Neighbor cache (link-layer/IPv6 address mapping) * IPv6 Neighbor cache (link-layer/IPv6 address mapping)
@ -38,11 +43,6 @@
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
#include <string.h> #include <string.h>
#include <stdlib.h> #include <stdlib.h>
#include <stddef.h> #include <stddef.h>

View file

@ -29,6 +29,11 @@
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
/** /**
* \file * \file
* IPv6 Neighbor cache (link-layer/IPv6 address mapping) * IPv6 Neighbor cache (link-layer/IPv6 address mapping)
@ -38,11 +43,6 @@
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
#ifndef UIP_DS6_NEIGHBOR_H_ #ifndef UIP_DS6_NEIGHBOR_H_
#define UIP_DS6_NEIGHBOR_H_ #define UIP_DS6_NEIGHBOR_H_

View file

@ -29,6 +29,15 @@
* OF THE POSSIBILITY OF SUCH DAMAGE. * OF THE POSSIBILITY OF SUCH DAMAGE.
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
/**
* \file
* Routing table manipulation
*/
#include "net/ipv6/uip-ds6.h" #include "net/ipv6/uip-ds6.h"
#include "net/ip/uip.h" #include "net/ip/uip.h"
@ -636,3 +645,4 @@ uip_ds6_defrt_periodic(void)
} }
} }
/*---------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------*/
/** @} */

View file

@ -29,6 +29,14 @@
* OF THE POSSIBILITY OF SUCH DAMAGE. * OF THE POSSIBILITY OF SUCH DAMAGE.
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
/**
* \file
* Header file for routing table manipulation
*/
#ifndef UIP_DS6_ROUTE_H #ifndef UIP_DS6_ROUTE_H
#define UIP_DS6_ROUTE_H #define UIP_DS6_ROUTE_H
@ -158,3 +166,4 @@ uip_ds6_route_t *uip_ds6_route_next(uip_ds6_route_t *);
/** @} */ /** @} */
#endif /* UIP_DS6_ROUTE_H */ #endif /* UIP_DS6_ROUTE_H */
/** @} */

View file

@ -28,20 +28,20 @@
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
/** /**
* \file * \file
* IPv6 data structures handling functions. * IPv6 data structure manipulation.
* Comprises part of the Neighbor discovery (RFC 4861) * Comprises part of the Neighbor discovery (RFC 4861)
* and auto configuration (RFC 4862) state machines. * and auto configuration (RFC 4862) state machines.
* \author Mathilde Durvy <mdurvy@cisco.com> * \author Mathilde Durvy <mdurvy@cisco.com>
* \author Julien Abeille <jabeille@cisco.com> * \author Julien Abeille <jabeille@cisco.com>
*/ */
/**
* \addtogroup uip6
* @{
*/
#include <string.h> #include <string.h>
#include <stdlib.h> #include <stdlib.h>
#include <stddef.h> #include <stddef.h>

View file

@ -5,7 +5,7 @@
/** /**
* \file * \file
* Network interface and stateless autoconfiguration (RFC 4862) * Header file for IPv6-related data structures
* \author Mathilde Durvy <mdurvy@cisco.com> * \author Mathilde Durvy <mdurvy@cisco.com>
* \author Julien Abeille <jabeille@cisco.com> * \author Julien Abeille <jabeille@cisco.com>
* *

View file

@ -31,15 +31,15 @@
*/ */
/** /**
* \file * \addtogroup uip6
* ICMPv6 echo request and error messages (RFC 4443) * @{
* \author Julien Abeille <jabeille@cisco.com>
* \author Mathilde Durvy <mdurvy@cisco.com>
*/ */
/** /**
* \addtogroup uip6 * \file
* @{ * ICMPv6 (RFC 4443) implementation, with message and error handling
* \author Julien Abeille <jabeille@cisco.com>
* \author Mathilde Durvy <mdurvy@cisco.com>
*/ */
#include <string.h> #include <string.h>

View file

@ -31,15 +31,15 @@
*/ */
/** /**
* \file * \addtogroup uip6
* ICMPv6 echo request and error messages (RFC 4443) * @{
* \author Julien Abeille <jabeille@cisco.com>
* \author Mathilde Durvy <mdurvy@cisco.com>
*/ */
/** /**
* \addtogroup uip6 * \file
* @{ * Header file for ICMPv6 message and error handing (RFC 4443)
* \author Julien Abeille <jabeille@cisco.com>
* \author Mathilde Durvy <mdurvy@cisco.com>
*/ */
#ifndef ICMP6_H_ #ifndef ICMP6_H_

View file

@ -56,6 +56,11 @@
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
/** /**
* \file * \file
* Neighbor discovery (RFC 4861) * Neighbor discovery (RFC 4861)
@ -63,11 +68,6 @@
* \author Julien Abeille <jabeille@cisco.com> * \author Julien Abeille <jabeille@cisco.com>
*/ */
/**
* \addtogroup uip6
* @{
*/
#include <string.h> #include <string.h>
#include "net/ipv6/uip-icmp6.h" #include "net/ipv6/uip-icmp6.h"
#include "net/ipv6/uip-nd6.h" #include "net/ipv6/uip-nd6.h"

View file

@ -31,15 +31,15 @@
*/ */
/** /**
* \file * \addtogroup uip6
* Neighbor discovery (RFC 4861) * @{
* \author Julien Abeille <jabeille@cisco.com>
* \author Mathilde Durvy <mdurvy@cisco.com>
*/ */
/** /**
* \addtogroup uip6 * \file
* @{ * Header file for IPv6 Neighbor discovery (RFC 4861)
* \author Julien Abeille <jabeille@cisco.com>
* \author Mathilde Durvy <mdurvy@cisco.com>
*/ */
#ifndef UIP_ND6_H_ #ifndef UIP_ND6_H_

View file

@ -31,6 +31,11 @@
* *
*/ */
/**
* \addtogroup uip6
* @{
*/
/** /**
* \file * \file
* The uIP TCP/IPv6 stack code. * The uIP TCP/IPv6 stack code.
@ -40,11 +45,6 @@
* \author Mathilde Durvy <mdurvy@cisco.com> (IPv6 related code) * \author Mathilde Durvy <mdurvy@cisco.com> (IPv6 related code)
*/ */
/**
* \addtogroup uip6
* @{
*/
/* /*
* uIP is a small implementation of the IP, UDP and TCP protocols (as * uIP is a small implementation of the IP, UDP and TCP protocols (as
* well as some basic ICMP stuff). The implementation couples the IP, * well as some basic ICMP stuff). The implementation couples the IP,