[asterisk-commits] qwell: trunk r89202 - in /trunk: channels/ include/asterisk/ main/ pbx/ res/
SVN commits to the Asterisk project
asterisk-commits at lists.digium.com
Mon Nov 12 17:44:21 CST 2007
Author: qwell
Date: Mon Nov 12 17:44:20 2007
New Revision: 89202
URL: http://svn.digium.com/view/asterisk?view=rev&rev=89202
Log:
Doxygen fixes.
Also fix a common typo I kept seeing (arguement) in various files.
Closes issue #11222, patch by snuffy (with arguement > argument by me).
Modified:
trunk/channels/chan_unistim.c
trunk/include/asterisk/cli.h
trunk/include/asterisk/config.h
trunk/include/asterisk/pbx.h
trunk/include/asterisk/stringfields.h
trunk/main/ast_expr2f.c
trunk/pbx/pbx_lua.c
trunk/res/res_clioriginate.c
trunk/res/res_config_sqlite.c
trunk/res/res_convert.c
trunk/res/res_crypto.c
trunk/res/res_features.c
trunk/res/res_monitor.c
Modified: trunk/channels/chan_unistim.c
URL: http://svn.digium.com/view/asterisk/trunk/channels/chan_unistim.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/channels/chan_unistim.c (original)
+++ trunk/channels/chan_unistim.c Mon Nov 12 17:44:20 2007
@@ -386,7 +386,7 @@
ast_mutex_t lock;
/*! Like 200 */
char name[80];
- /*! Like USTM/200 at black */
+ /*! Like USTM/200\@black */
char fullname[80];
/*! pointer to our current connection, channel... */
struct unistim_subchannel *subs[MAX_SUBS];
Modified: trunk/include/asterisk/cli.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/cli.h?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/include/asterisk/cli.h (original)
+++ trunk/include/asterisk/cli.h Mon Nov 12 17:44:20 2007
@@ -220,6 +220,8 @@
/*!
* \brief Interprets a command
* Interpret a command s, sending output to fd
+ * \param fd pipe
+ * \param s incoming string
* \retval 0 on success
* \retval -1 on failure
*/
@@ -227,14 +229,16 @@
/*!
* \brief Executes multiple CLI commands
- * Interpret strings separated by '\0' and execute each one, sending output to fd
+ * Interpret strings separated by NULL and execute each one, sending output to fd
+ * \param fd pipe
* \param size is the total size of the string
+ * \param s incoming string
* \retval number of commands executed
*/
int ast_cli_command_multiple(int fd, size_t size, const char *s);
/*! \brief Registers a command or an array of commands
- * \param e which cli entry to register
+ * \param e which cli entry to register.
* Register your own command
* \retval 0 on success
* \retval -1 on failure
@@ -252,7 +256,7 @@
* \brief Unregisters a command or an array of commands
* \param e which cli entry to unregister
* Unregister your own command. You must pass a completed ast_cli_entry structure
- * \return 0.
+ * \return 0
*/
int ast_cli_unregister(struct ast_cli_entry *e);
@@ -280,14 +284,14 @@
*
* The first entry (offset 0) of the result is the longest common substring
* in the results, useful to extend the string that has been completed.
- * Subsequent entries are all possible values, followe by a NULL.
+ * Subsequent entries are all possible values, followed by a NULL.
* All strings and the array itself are malloc'ed and must be freed
* by the caller.
*/
char **ast_cli_completion_matches(const char *, const char *);
/*!
- * \brief Command completion for the list of active channels
+ * \brief Command completion for the list of active channels.
*
* This can be called from a CLI command completion function that wants to
* complete from the list of active channels. 'rpos' is the required
Modified: trunk/include/asterisk/config.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/config.h?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/include/asterisk/config.h (original)
+++ trunk/include/asterisk/config.h Mon Nov 12 17:44:20 2007
@@ -113,7 +113,7 @@
/*! \brief Goes through categories
* \param config Which config structure you wish to "browse"
* \param prev A pointer to a previous category.
- * This funtion is kind of non-intuitive in it's use. To begin, one passes NULL as the second arguement. It will return a pointer to the string of the first category in the file. From here on after, one must then pass the previous usage's return value as the second pointer, and it will return a pointer to the category name afterwards.
+ * This function is kind of non-intuitive in it's use. To begin, one passes NULL as the second argument. It will return a pointer to the string of the first category in the file. From here on after, one must then pass the previous usage's return value as the second pointer, and it will return a pointer to the category name afterwards.
*
* \retval a category on success
* \retval NULL on failure/no-more-categories
Modified: trunk/include/asterisk/pbx.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/pbx.h?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/include/asterisk/pbx.h (original)
+++ trunk/include/asterisk/pbx.h Mon Nov 12 17:44:20 2007
@@ -529,6 +529,8 @@
* \param exten new extension to add
* \param priority priority of new extension
* \param callerid callerid of extension
+ * \param found
+ * \param combined_find_spawn
*
* This adds a new extension to the asterisk extension list.
*
Modified: trunk/include/asterisk/stringfields.h
URL: http://svn.digium.com/view/asterisk/trunk/include/asterisk/stringfields.h?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/include/asterisk/stringfields.h (original)
+++ trunk/include/asterisk/stringfields.h Mon Nov 12 17:44:20 2007
@@ -303,8 +303,8 @@
\param x Pointer to a structure containing fields
\param field Name of the field to set
\param fmt printf-style format string
- \param args1 arguement one
- \param args2 arguement two
+ \param args1 argument one
+ \param args2 argument two
\return nothing
*/
#define ast_string_field_build_va(x, field, fmt, args1, args2) \
Modified: trunk/main/ast_expr2f.c
URL: http://svn.digium.com/view/asterisk/trunk/main/ast_expr2f.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/main/ast_expr2f.c (original)
+++ trunk/main/ast_expr2f.c Mon Nov 12 17:44:20 2007
@@ -2774,7 +2774,7 @@
/** Setup the input buffer state to scan a string. The next call to ast_yylex() will
* scan from a @e copy of @a str.
- * @param str a NUL-terminated string to scan
+ * @param yy_str a NUL-terminated string to scan
* @param yyscanner The scanner object.
* @return the newly allocated buffer state object.
* @note If you want to scan bytes that may contain NUL values, then use
@@ -2950,7 +2950,7 @@
}
/** Set the current column.
- * @param line_number
+ * @param column_no
* @param yyscanner The scanner object.
*/
void ast_yyset_column (int column_no , yyscan_t yyscanner)
Modified: trunk/pbx/pbx_lua.c
URL: http://svn.digium.com/view/asterisk/trunk/pbx/pbx_lua.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/pbx/pbx_lua.c (original)
+++ trunk/pbx/pbx_lua.c Mon Nov 12 17:44:20 2007
@@ -868,9 +868,9 @@
* \brief Load the extensions.lua file from the internal buffer
*
* \param L the lua_State to use
+ * \param chan channel to work on
*
* This function also sets up some constructs used by the extensions.lua file.
- *
* In the event of an error, an error string will be pushed onto the lua stack.
*
* \retval 0 success
Modified: trunk/res/res_clioriginate.c
URL: http://svn.digium.com/view/asterisk/trunk/res/res_clioriginate.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/res/res_clioriginate.c (original)
+++ trunk/res/res_clioriginate.c Mon Nov 12 17:44:20 2007
@@ -117,9 +117,9 @@
* \brief handle for orgination app or exten.
* \param e pointer to the CLI structure to initialize
* \param cmd operation to execute
- * \param a structure that contains either application or extension arguements
+ * \param a structure that contains either application or extension arguments
* \retval CLI_SUCCESS on success.
- * \retval CLI_SHOWUSAGE on failure.
+ * \retval CLI_SHOWUSAGE on failure.
*/
static char *handle_orig(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
{
Modified: trunk/res/res_config_sqlite.c
URL: http://svn.digium.com/view/asterisk/trunk/res/res_config_sqlite.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/res/res_config_sqlite.c (original)
+++ trunk/res/res_config_sqlite.c Mon Nov 12 17:44:20 2007
@@ -448,9 +448,9 @@
/*!
* \brief Asterisk callback function for the CLI status command.
*
- * \param fd file descriptor provided by Asterisk to use with ast_cli()
- * \param argc number of arguments
- * \param argv arguments list
+ * \param e CLI command
+ * \param cmd
+ * \param a CLI argument list
* \return RESULT_SUCCESS
*/
static char *handle_cli_show_sqlite_status(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a);
Modified: trunk/res/res_convert.c
URL: http://svn.digium.com/view/asterisk/trunk/res/res_convert.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/res/res_convert.c (original)
+++ trunk/res/res_convert.c Mon Nov 12 17:44:20 2007
@@ -58,9 +58,9 @@
/*!
* \brief Convert a file from one format to another
- * \param fd file descriptor
- * \param argc no arguements
- * \param argv list of arguements
+ * \param e CLI entry
+ * \param cmd command number
+ * \param a list of cli arguments
* \retval CLI_SUCCESS on success.
* \retval CLI_SHOWUSAGE or CLI_FAILURE on failure.
*/
Modified: trunk/res/res_crypto.c
URL: http://svn.digium.com/view/asterisk/trunk/res/res_crypto.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/res/res_crypto.c (original)
+++ trunk/res/res_crypto.c Mon Nov 12 17:44:20 2007
@@ -494,9 +494,9 @@
/*!
* \brief show the list of RSA keys
- * \param fd file descriptor
- * \param argc no of arguements
- * \param argv list of arguements
+ * \param e CLI command
+ * \param cmd
+ * \param a list of CLI arguments
* \return RESULT_SUCCESS
*/
static char *handle_cli_keys_show(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
@@ -540,9 +540,9 @@
/*!
* \brief initialize all RSA keys
- * \param fd file descriptor
- * \param argc no of arguements
- * \param argv list of arguements
+ * \param e CLI command
+ * \param cmd
+ * \param a list of CLI arguments
* \return RESULT_SUCCESS
*/
static char *handle_cli_keys_init(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
Modified: trunk/res/res_features.c
URL: http://svn.digium.com/view/asterisk/trunk/res/res_features.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/res/res_features.c (original)
+++ trunk/res/res_features.c Mon Nov 12 17:44:20 2007
@@ -2583,7 +2583,7 @@
*
* Check right usage, lock parking lot, display parked calls, unlock parking lot list.
* \retval CLI_SUCCESS on success.
- * \retval CLI_SHOWUSAGE on incorrect number of arguements.
+ * \retval CLI_SHOWUSAGE on incorrect number of arguments.
* \retval NULL when tab completion is used.
*/
static char *handle_parkedcalls(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
Modified: trunk/res/res_monitor.c
URL: http://svn.digium.com/view/asterisk/trunk/res/res_monitor.c?view=diff&rev=89202&r1=89201&r2=89202
==============================================================================
--- trunk/res/res_monitor.c (original)
+++ trunk/res/res_monitor.c Mon Nov 12 17:44:20 2007
@@ -80,7 +80,7 @@
" and a target mixed file name which is the same as the leg file names\n"
" only without the in/out designator.\n"
" If MONITOR_EXEC_ARGS is set, the contents will be passed on as\n"
-" additional arguements to MONITOR_EXEC\n"
+" additional arguments to MONITOR_EXEC\n"
" Both MONITOR_EXEC and the Mix flag can be set from the\n"
" administrator interface\n"
"\n"
@@ -419,7 +419,7 @@
/*!
* \brief Start monitor
* \param chan
- * \param data arguements passed fname|options
+ * \param data arguments passed fname|options
* \retval 0 on success.
* \retval -1 on failure.
*/
More information about the asterisk-commits
mailing list