[doc] Give files a common structure by placing license first (partial)

Followed by doxyen file and group tags.
This patch is only a first attempt to make provide a clean structure,
many more files require rework, too.
This commit is contained in:
Enrico Joerns 2014-11-08 01:15:42 +01:00
parent b0206e2f58
commit 85b494c16b
141 changed files with 2026 additions and 1994 deletions

View file

@ -1,34 +1,3 @@
/**
* \file
* Argument buffer for passing arguments when starting processes
* \author Adam Dunkels <adam@dunkels.com>
*/
/**
* \addtogroup sys
* @{
*/
/**
* \defgroup arg Argument buffer
* @{
*
* The argument buffer can be used when passing an argument from an
* exiting process to a process that has not been created yet. Since
* the exiting process will have exited when the new process is
* started, the argument cannot be passed in any of the processes'
* addres spaces. In such situations, the argument buffer can be used.
*
* The argument buffer is statically allocated in memory and is
* globally accessible to all processes.
*
* An argument buffer is allocated with the arg_alloc() function and
* deallocated with the arg_free() function. The arg_free() function
* is designed so that it can take any pointer, not just an argument
* buffer pointer. If the pointer to arg_free() is not an argument
* buffer, the function does nothing.
*/
/*
* Copyright (c) 2003, Adam Dunkels.
* All rights reserved.
@ -63,6 +32,37 @@
*
*/
/**
* \file
* Argument buffer for passing arguments when starting processes
* \author Adam Dunkels <adam@dunkels.com>
*/
/**
* \addtogroup sys
* @{
*/
/**
* \defgroup arg Argument buffer
* @{
*
* The argument buffer can be used when passing an argument from an
* exiting process to a process that has not been created yet. Since
* the exiting process will have exited when the new process is
* started, the argument cannot be passed in any of the processes'
* addres spaces. In such situations, the argument buffer can be used.
*
* The argument buffer is statically allocated in memory and is
* globally accessible to all processes.
*
* An argument buffer is allocated with the arg_alloc() function and
* deallocated with the arg_free() function. The arg_free() function
* is designed so that it can take any pointer, not just an argument
* buffer pointer. If the pointer to arg_free() is not an argument
* buffer, the function does nothing.
*/
#include "contiki.h"
#include "sys/arg.h"