kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-10-28 07:01:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix a bunch of places where \arg was used instead of \param. Using \arg

Browse Source 
to document arguments seems logical, and does work, but is not the best
thing to use.

\arg in doxygen is simply for creating non-nested unordered lists.  \param is
the correct tag to use to document function parameters, and will come out
better in the generated documentation.


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@127401 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Russell Bryant
2008-07-02 14:50:45 +00:00
parent 097ac98034
commit 3cf77c4c7f
10 changed files with 75 additions and 80 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
include/asterisk/threadstorage.h
View File

@@ -75,7 +75,7 @@ void __ast_threadstorage_object_replace(void *key_old, void *key_new, size_t len
/*!
* \brief Define a thread storage variable
*
* \arg name The name of the thread storage object
* \param name The name of the thread storage object
*
* This macro would be used to declare an instance of thread storage in a file.
*
@@ -90,11 +90,11 @@ void __ast_threadstorage_object_replace(void *key_old, void *key_new, size_t len
/*!
* \brief Define a thread storage variable, with custom initialization and cleanup
*
* \arg name The name of the thread storage object
* \arg init This is a custom function that will be called after each thread specific
* \param name The name of the thread storage object
* \param init This is a custom function that will be called after each thread specific
* object is allocated, with the allocated block of memory passed
* as the argument.
* \arg cleanup This is a custom function that will be called instead of ast_free
* \param cleanup This is a custom function that will be called instead of ast_free
* when the thread goes away. Note that if this is used, it *MUST*
* call free on the allocated memory.
*
@@ -137,11 +137,11 @@ static void __init_##name(void) \
/*!
* \brief Retrieve thread storage
*
* \arg ts This is a pointer to the thread storage structure declared by using
* \param ts This is a pointer to the thread storage structure declared by using
* the AST_THREADSTORAGE macro. If declared with
* AST_THREADSTORAGE(my_buf, my_buf_init), then this argument would be
* (&my_buf).
* \arg init_size This is the amount of space to be allocated the first time
* \param init_size This is the amount of space to be allocated the first time
* this thread requests its data. Thus, this should be the size that the
* code accessing this thread storage is assuming the size to be.
*