Doxygen updates and corrections

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

channels/chan_zap.c

@@ -637,7 +637,7 @@ static struct zt_pvt {
  * statement is reached, the current zt_chan_conf is used to configure the 
  * channel (struct zt_pvt)
  *
- * @seealso zt_chan_init for the default values.
+ * \see zt_chan_init for the default values.
  */
 struct zt_chan_conf {
 	struct zt_pvt chan;

include/asterisk/doxyref.h

@@ -44,6 +44,7 @@
  *  \arg \ref ConfigFiles
  *  \arg \ref SoundFiles included in the Asterisk distribution
  *  \arg \ref AstCREDITS : A Thank You to contributors
+ *  \arg \ref extref 
  \n\n
  * \section weblinks Web sites
  * \arg \b Main:  Asterisk Developer's website http://www.asterisk.org/developers/

include/asterisk/frame.h

@@ -495,8 +495,9 @@ struct ast_frame *ast_smoother_read(struct ast_smoother *s);
 void ast_frame_dump(const char *name, struct ast_frame *f, char *prefix);
 
 /*! \page AudioCodecPref Audio Codec Preferences
+
 	In order to negotiate audio codecs in the order they are configured
-	in <channel>.conf for a device, we set up codec preference lists
+	in \<channel\>.conf for a device, we set up codec preference lists
 	in addition to the codec capabilities setting. The capabilities
 	setting is a bitmask of audio and video codecs with no internal
 	order. This will reflect the offer given to the other side, where

main/manager.c

@@ -22,6 +22,8 @@
  *
  * \author Mark Spencer <markster@digium.com>
  *
+ * \extref OpenSSL http://www.openssl.org - for AMI/SSL 
+ *
  * At the moment this file contains a number of functions, namely:
  *
  * - data structures storing AMI state
@@ -117,8 +119,10 @@ static int num_sessions;
 
 static int manager_debug;	/*!< enable some debugging code in the manager */
 
-/*!
+/*! \brief
  * Descriptor for a manager session, either on the AMI socket or over HTTP.
+ *
+ * \note
  * AMI session have managerid == 0; the entry is created upon a connect,
  * and destroyed with the socket.
  * HTTP sessions have managerid != 0, the value is used as a search key
@@ -155,6 +159,7 @@ struct mansession {
 static AST_LIST_HEAD_STATIC(sessions, mansession);
 
 /*! \brief user descriptor, as read from the config file.
+ *
  * \note It is still missing some fields -- e.g. we can have multiple permit and deny
  * lines which are not supported here, and readperm/writeperm/writetimeout
  * are not stored.
@@ -2157,10 +2162,12 @@ static int process_message(struct mansession *s, const struct message *m)
 
 /*!
  * Read one full line (including crlf) from the manager socket.
+ * \note \verbatim
  * \r\n is the only valid terminator for the line.
  * (Note that, later, '\0' will be considered as the end-of-line marker,
  * so everything between the '\0' and the '\r\n' will not be used).
  * Also note that we assume output to have at least "maxlen" space.
+ * \endverbatim
  */
 static int get_input(struct mansession *s, char *output)
 {