[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 &lt;name&gt;' */
 	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