Doxygen Updates - janitor work

Doxygen updates including mistakes, misspellings, missing parameters, updates for Doxygen style.  Some missing txt file links are removed but their content or essense will be included in some later updates.  A majority of the txt files were removed in the 1.6 era but never noted. The HR and EXTREF are simple changes that make the documentation more compatable with more versions of Doxygen.

Further updates coming.

(issue ASTERISK-20259)


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@373330 65c4cc65-6c06-0410-ace0-fbb531ad65f3

7 files changed, 9 insertions, 8 deletions

diff --git a/channels/chan_console.c b/channels/chan_console.c
index dce9f01bb..5eef4c3c8 100644
--- a/channels/chan_console.c
+++ b/channels/chan_console.c
@@ -29,7 +29,7 @@
  * 
  * \ingroup channel_drivers
  *
- * \extref Portaudio http://www.portaudio.com/
+ * Portaudio http://www.portaudio.com/
  *
  * To install portaudio v19 from svn, check it out using the following command:
  *  - svn co https://www.portaudio.com/repos/portaudio/branches/v19-devel
diff --git a/channels/chan_h323.c b/channels/chan_h323.c
index 9fae0390c..9aba21a38 100644
--- a/channels/chan_h323.c
+++ b/channels/chan_h323.c
@@ -29,7 +29,7 @@
  *
  * \par See also
  * \arg Config_h323
- * \extref OpenH323 http://www.voxgratia.org/
+ * OpenH323 http://www.voxgratia.org/
  *
  * \ingroup channel_drivers
  */
diff --git a/channels/chan_jingle.c b/channels/chan_jingle.c
index 29329c6c6..dfc2ea9b3 100644
--- a/channels/chan_jingle.c
+++ b/channels/chan_jingle.c
@@ -22,7 +22,7 @@
  *
  * \brief Jingle Channel Driver
  *
- * \extref Iksemel http://iksemel.jabberstudio.org/
+ * Iksemel http://iksemel.jabberstudio.org/
  * 
  * \ingroup channel_drivers
  */
diff --git a/channels/chan_misdn.c b/channels/chan_misdn.c
index da45db9c3..3578bc54e 100644
--- a/channels/chan_misdn.c
+++ b/channels/chan_misdn.c
@@ -24,7 +24,7 @@
  *
  * \author Christian Richter <crich@beronet.com>
  *
- * \extref MISDN http://www.misdn.org/
+ * MISDN http://www.misdn.org/
  *
  * \ingroup channel_drivers
  */
diff --git a/channels/chan_motif.c b/channels/chan_motif.c
index 70629f4e0..77c446723 100644
--- a/channels/chan_motif.c
+++ b/channels/chan_motif.c
@@ -22,7 +22,7 @@
  *
  * \brief Motif Jingle Channel Driver
  *
- * \extref Iksemel http://iksemel.jabberstudio.org/
+ * Iksemel http://iksemel.jabberstudio.org/
  *
  * \ingroup channel_drivers
  */
diff --git a/channels/sip/include/sdp_crypto.h b/channels/sip/include/sdp_crypto.h
index aa553cb00..da1035e87 100644
--- a/channels/sip/include/sdp_crypto.h
+++ b/channels/sip/include/sdp_crypto.h
@@ -65,7 +65,8 @@ int sdp_crypto_process(struct sdp_crypto *p, const char *attr, struct ast_rtp_in
  * \details
  * The offer is stored on the sdp_crypto struct in a_crypto
  *
- * \param A valid sdp_crypto struct
+ * \param p A valid sdp_crypto struct
+ * \param taglen Length
  *
  * \retval 0 success
  * \retval nonzero failure
diff --git a/channels/sip/reqresp_parser.c b/channels/sip/reqresp_parser.c
index 2ff5e6b8d..7893aace5 100644
--- a/channels/sip/reqresp_parser.c
+++ b/channels/sip/reqresp_parser.c
@@ -1523,9 +1523,9 @@ AST_TEST_DEFINE(parse_contact_header_test)
  * item is found that is not supported, it is copied to the unsupported
  * out buffer.
  *
- * \param option list
+ * \param options list
  * \param unsupported out buffer (optional)
- * \param unsupported out buffer length (optional)
+ * \param unsupported_len out buffer length (optional)
  */
 unsigned int parse_sip_options(const char *options, char *unsupported, size_t unsupported_len)
 {