[asterisk-commits] trunk r26170 - in /trunk: ./ include/asterisk/
pbx/ res/
asterisk-commits at lists.digium.com
asterisk-commits at lists.digium.com
Tue May 9 09:24:08 MST 2006
Author: kpfleming
Date: Tue May 9 11:24:07 2006
New Revision: 26170
URL: http://svn.digium.com/view/asterisk?rev=26170&view=rev
Log:
various doxygen fixes
Modified:
trunk/include/asterisk/astosp.h
trunk/include/asterisk/channel.h
trunk/include/asterisk/frame.h
trunk/include/asterisk/module.h
trunk/include/asterisk/translate.h
trunk/pbx.c
trunk/pbx/pbx_config.c
trunk/res/res_smdi.c
Modified: trunk/include/asterisk/astosp.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/astosp.h?rev=26170&r1=26169&r2=26170&view=diff
==============================================================================
--- trunk/include/asterisk/astosp.h (original)
+++ trunk/include/asterisk/astosp.h Tue May 9 11:24:07 2006
@@ -112,7 +112,8 @@
* \param handle OSP in/out_bound transaction handle
* \param reason Last destination failure reason
* \param start Call start time
- * \param duration Call duration
+ * \param connect Call connect time
+ * \param end Call end time
* \return 1 Success, 0 Failed, -1 Error
*/
int ast_osp_finish(
Modified: trunk/include/asterisk/channel.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/channel.h?rev=26170&r1=26169&r2=26170&view=diff
==============================================================================
--- trunk/include/asterisk/channel.h (original)
+++ trunk/include/asterisk/channel.h Tue May 9 11:24:07 2006
@@ -625,6 +625,13 @@
The supplied payload data is copied into the frame, so the caller's copy
is not modified nor freed, and the resulting frame will retain a copy of
the data even if the caller frees their local copy.
+
+ \note This method should be treated as a 'network transport'; in other
+ words, your frames may be transferred across an IAX2 channel to another
+ system, which may be a different endianness than yours. Because of this,
+ you should ensure that either your frames will never be expected to work
+ across systems, or that you always put your payload data into 'network byte
+ order' before calling this function.
*/
int ast_queue_control_data(struct ast_channel *chan, enum ast_control_frame_type control,
const void *data, size_t datalen);
Modified: trunk/include/asterisk/frame.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/frame.h?rev=26170&r1=26169&r2=26170&view=diff
==============================================================================
--- trunk/include/asterisk/frame.h (original)
+++ trunk/include/asterisk/frame.h Tue May 9 11:24:07 2006
@@ -241,24 +241,24 @@
#define AST_FORMAT_VIDEO_MASK (((1 << 25)-1) & ~(AST_FORMAT_AUDIO_MASK))
enum ast_control_frame_type {
- AST_CONTROL_HANGUP = 1, /*! Other end has hungup */
- AST_CONTROL_RING = 2, /*! Local ring */
- AST_CONTROL_RINGING = 3, /*! Remote end is ringing */
- AST_CONTROL_ANSWER = 4, /*! Remote end has answered */
- AST_CONTROL_BUSY = 5, /*! Remote end is busy */
- AST_CONTROL_TAKEOFFHOOK = 6, /*! Make it go off hook */
- AST_CONTROL_OFFHOOK = 7, /*! Line is off hook */
- AST_CONTROL_CONGESTION = 8, /*! Congestion (circuits busy) */
- AST_CONTROL_FLASH = 9, /*! Flash hook */
- AST_CONTROL_WINK = 10, /*! Wink */
- AST_CONTROL_OPTION = 11, /*! Set a low-level option */
- AST_CONTROL_RADIO_KEY = 12, /*! Key Radio */
- AST_CONTROL_RADIO_UNKEY = 13, /*! Un-Key Radio */
- AST_CONTROL_PROGRESS = 14, /*! Indicate PROGRESS */
- AST_CONTROL_PROCEEDING = 15, /*! Indicate CALL PROCEEDING */
- AST_CONTROL_HOLD = 16, /*! Indicate call is placed on hold */
- AST_CONTROL_UNHOLD = 17, /*! Indicate call is left from hold */
- AST_CONTROL_VIDUPDATE = 18, /*! Indicate video frame update */
+ AST_CONTROL_HANGUP = 1, /*!< Other end has hungup */
+ AST_CONTROL_RING = 2, /*!< Local ring */
+ AST_CONTROL_RINGING = 3, /*!< Remote end is ringing */
+ AST_CONTROL_ANSWER = 4, /*!< Remote end has answered */
+ AST_CONTROL_BUSY = 5, /*!< Remote end is busy */
+ AST_CONTROL_TAKEOFFHOOK = 6, /*!< Make it go off hook */
+ AST_CONTROL_OFFHOOK = 7, /*!< Line is off hook */
+ AST_CONTROL_CONGESTION = 8, /*!< Congestion (circuits busy) */
+ AST_CONTROL_FLASH = 9, /*!< Flash hook */
+ AST_CONTROL_WINK = 10, /*!< Wink */
+ AST_CONTROL_OPTION = 11, /*!< Set a low-level option */
+ AST_CONTROL_RADIO_KEY = 12, /*!< Key Radio */
+ AST_CONTROL_RADIO_UNKEY = 13, /*!< Un-Key Radio */
+ AST_CONTROL_PROGRESS = 14, /*!< Indicate PROGRESS */
+ AST_CONTROL_PROCEEDING = 15, /*!< Indicate CALL PROCEEDING */
+ AST_CONTROL_HOLD = 16, /*!< Indicate call is placed on hold */
+ AST_CONTROL_UNHOLD = 17, /*!< Indicate call is left from hold */
+ AST_CONTROL_VIDUPDATE = 18, /*!< Indicate video frame update */
};
#define AST_SMOOTHER_FLAG_G729 (1 << 0)
Modified: trunk/include/asterisk/module.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/module.h?rev=26170&r1=26169&r2=26170&view=diff
==============================================================================
--- trunk/include/asterisk/module.h (original)
+++ trunk/include/asterisk/module.h Tue May 9 11:24:07 2006
@@ -77,8 +77,7 @@
/*!
* \brief Unloads a module.
* \param resource_name The name of the module to unload.
- * \param force The force flag. This should be set using one of the AST_FORCE*
- * flags.
+ * \param unload_mode The force flag. This should be set using one of the AST_FORCE flags.
*
* This function unloads a module. It will only unload modules that are not in
* use (usecount not zero), unless #AST_FORCE_FIRM or #AST_FORCE_HARD is
@@ -177,9 +176,8 @@
* whose functions are exported through fields of a "struct module_symbol";
*
* Modules exporting extra symbols (data or functions), should list
- * them into an array of struct symbol_entry: \r
+ * them into an array of struct symbol_entry:
* struct symbol_entry exported_symbols[]
- * \r
* of symbols, with a NULL name on the last entry
*
* Functions should be added with MOD_FUNC(name),
Modified: trunk/include/asterisk/translate.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/translate.h?rev=26170&r1=26169&r2=26170&view=diff
==============================================================================
--- trunk/include/asterisk/translate.h (original)
+++ trunk/include/asterisk/translate.h Tue May 9 11:24:07 2006
@@ -146,6 +146,7 @@
/*!
* \brief Register a translator
* \param t populated ast_translator structure
+ * \param module handle to the module that owns this translator
* This registers a codec translator with asterisk
* \return 0 on success, -1 on failure
*/
Modified: trunk/pbx.c
URL: http://svn.digium.com/view/asterisk/trunk/pbx.c?rev=26170&r1=26169&r2=26170&view=diff
==============================================================================
--- trunk/pbx.c (original)
+++ trunk/pbx.c Tue May 9 11:24:07 2006
@@ -173,7 +173,7 @@
struct ast_app {
int (*execute)(struct ast_channel *chan, void *data);
const char *synopsis; /*!< Synopsis text for 'show applications' */
- const char *description; /*!< Description (help text) for 'show application <name>' */
+ const char *description; /*!< Description (help text) for 'show application <name>' */
AST_LIST_ENTRY(ast_app) list; /*!< Next app in list */
struct module *module; /*!< Module this app belongs to */
char name[0]; /*!< Name of the application */
@@ -1230,7 +1230,7 @@
}
/*! \brief return a pointer to the arguments of the function,
- * and terminates the function name with '\0'
+ * and terminates the function name with '\\0'
*/
static char *func_args(char *function)
{
Modified: trunk/pbx/pbx_config.c
URL: http://svn.digium.com/view/asterisk/trunk/pbx/pbx_config.c?rev=26170&r1=26169&r2=26170&view=diff
==============================================================================
--- trunk/pbx/pbx_config.c (original)
+++ trunk/pbx/pbx_config.c Tue May 9 11:24:07 2006
@@ -191,7 +191,7 @@
return (len == 0 || !strncmp(s, word, len));
}
-/*! \brief split extension at context in two parts, return -1 on error.
+/*! \brief split extension\@context in two parts, return -1 on error.
* The return string is malloc'ed and pointed by *ext
*/
static int split_ec(const char *src, char **ext, char ** const ctx)
Modified: trunk/res/res_smdi.c
URL: http://svn.digium.com/view/asterisk/trunk/res/res_smdi.c?rev=26170&r1=26169&r2=26170&view=diff
==============================================================================
--- trunk/res/res_smdi.c (original)
+++ trunk/res/res_smdi.c Tue May 9 11:24:07 2006
@@ -150,7 +150,7 @@
/*!
* \brief Put an SMDI message back in the front of the queue.
* \param iface a pointer to the interface to use.
- * \param msg a pointer to the message to use.
+ * \param md_msg a pointer to the message to use.
*
* This function puts a message back in the front of the specified queue. It
* should be used if a message was popped but is not going to be processed for
@@ -164,7 +164,7 @@
/*!
* \brief Put an SMDI message back in the front of the queue.
* \param iface a pointer to the interface to use.
- * \param msg a pointer to the message to use.
+ * \param mwi_msg a pointer to the message to use.
*
* This function puts a message back in the front of the specified queue. It
* should be used if a message was popped but is not going to be processed for
@@ -326,7 +326,7 @@
/*! \brief Read an SMDI message.
*
- * \param iface the SMDI interface to read from.
+ * \param iface_p the SMDI interface to read from.
*
* This function loops and reads from and SMDI interface. It must be stopped
* using pthread_cancel().
More information about the asterisk-commits
mailing list