Fix some doxygen warnings.

(closes issue #17336)
Reported by: snuffy
Patches:
      doxygen-fixes1.diff uploaded by snuffy (license 35)
Tested by: russell

git-svn-id: http://svn.digium.com/svn/asterisk/trunk@268969 f38db490-d61c-443f-a65b-d21fe96a405b

5 files changed, 8 insertions, 7 deletions

diff --git a/main/ast_expr2f.c b/main/ast_expr2f.c
index f65c4f49f..384da3039 100644
--- a/main/ast_expr2f.c
+++ b/main/ast_expr2f.c
@@ -1966,8 +1966,8 @@ YY_BUFFER_STATE ast_yy_scan_string (yyconst char * yystr , yyscan_t yyscanner)
 
 /** Setup the input buffer state to scan the given bytes. The next call to ast_yylex() will
  * scan from a @e copy of @a bytes.
- * @param bytes the byte buffer to scan
- * @param len the number of bytes in the buffer pointed to by @a bytes.
+ * @param yybytes the byte buffer to scan
+ * @param _yybytes_len the number of bytes in the buffer pointed to by @a bytes.
  * @param yyscanner The scanner object.
  * @return the newly allocated buffer state object.
  */
@@ -2128,7 +2128,7 @@ void ast_yyset_lineno (int  line_number , yyscan_t yyscanner)
 }
 
 /** 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)
diff --git a/main/audiohook.c b/main/audiohook.c
index 67dfb25a7..031f36e7e 100644
--- a/main/audiohook.c
+++ b/main/audiohook.c
@@ -371,8 +371,8 @@ int ast_audiohook_attach(struct ast_channel *chan, struct ast_audiohook *audioho
 }
 
 /*! \brief Update audiohook's status
- * \param audiohook status enum
  * \param audiohook Audiohook structure
+ * \param status Audiohook status enum
  *
  * \note once status is updated to DONE, this function can not be used to set the
  * status back to any other setting.  Setting DONE effectively locks the status as such.
diff --git a/main/ccss.c b/main/ccss.c
index 4cb133899..efdcbb17f 100644
--- a/main/ccss.c
+++ b/main/ccss.c
@@ -1453,7 +1453,7 @@ struct extension_child_dialstring {
 	 * to find the dialstring that corresponds to that device, and we use the
 	 * stored device name as a way to find it.
 	 *
-	 * Note that there is one particular case where the device name stored here
+	 * \note There is one particular case where the device name stored here
 	 * will be empty. This is the case where we fail to request a channel, but we
 	 * still can make use of generic call completion. In such a case, since we never
 	 * were able to request the channel, we can't find what its device name is. In
diff --git a/main/features.c b/main/features.c
index 6c85241db..fff94feeb 100644
--- a/main/features.c
+++ b/main/features.c
@@ -2415,7 +2415,7 @@ static int remap_feature(const char *name, const char *value)
 
 /*!
  * \brief Helper function for feature_interpret and ast_feature_detect
- * \param chan,peer,config,code,sense,dynamic_features char buf,feature flags,operation,feature
+ * \param chan,peer,config,code,sense,dynamic_features_buf,features,operation,feature
  *
  * Lock features list, browse for code, unlock list
  * If a feature is found and the operation variable is set, that feature's
@@ -2605,7 +2605,7 @@ static void set_config_flags(struct ast_channel *chan, struct ast_channel *peer,
 
 /*! 
  * \brief Get feature and dial
- * \param caller,transferee,type,format,data,timeout,outstate,cid_num,cid_name,igncallerstate
+ * \param caller,transferee,type,format,data,timeout,outstate,cid_num,cid_name,igncallerstate,language
  *
  * Request channel, set channel variables, initiate call,check if they want to disconnect
  * go into loop, check if timeout has elapsed, check if person to be transfered hung up,
diff --git a/main/pbx.c b/main/pbx.c
index 8e5aa4686..7e8882b61 100644
--- a/main/pbx.c
+++ b/main/pbx.c
@@ -4571,6 +4571,7 @@ static void set_ext_pri(struct ast_channel *c, const char *exten, int pri)
 
 /*!
  * \brief collect digits from the channel into the buffer.
+ * \param c, buf, buflen, pos
  * \param waittime is in milliseconds
  * \retval 0 on timeout or done.
  * \retval -1 on error.