[asterisk-commits] lathama: branch lathama/doxygencleanups r373380 - in /team/lathama/doxygencle...

SVN commits to the Asterisk project asterisk-commits at lists.digium.com
Sat Sep 22 12:55:16 CDT 2012


Author: lathama
Date: Sat Sep 22 12:55:07 2012
New Revision: 373380

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=373380
Log:
Slowly adding more fixes and updates.

Modified:
    team/lathama/doxygencleanups/Makefile
    team/lathama/doxygencleanups/addons/chan_mobile.c
    team/lathama/doxygencleanups/apps/app_adsiprog.c
    team/lathama/doxygencleanups/apps/app_followme.c
    team/lathama/doxygencleanups/apps/app_queue.c
    team/lathama/doxygencleanups/apps/app_voicemail.c
    team/lathama/doxygencleanups/channels/chan_sip.c
    team/lathama/doxygencleanups/channels/iax2-provision.c
    team/lathama/doxygencleanups/codecs/speex/speex_resampler.h
    team/lathama/doxygencleanups/contrib/asterisk-ng-doxygen
    team/lathama/doxygencleanups/include/asterisk/doxyref.h
    team/lathama/doxygencleanups/include/asterisk/pbx.h
    team/lathama/doxygencleanups/main/asterisk.c
    team/lathama/doxygencleanups/res/res_timing_kqueue.c
    team/lathama/doxygencleanups/utils/refcounter.c

Modified: team/lathama/doxygencleanups/Makefile
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/Makefile?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/Makefile (original)
+++ team/lathama/doxygencleanups/Makefile Sat Sep 22 12:55:07 2012
@@ -746,6 +746,7 @@
 	doxygen -u contrib/asterisk-ng-doxygen
 	(cat contrib/asterisk-ng-doxygen; echo "HAVE_DOT=$(HAVEDOT)"; \
 	echo "PROJECT_NUMBER=$(ASTERISKVERSION)") | doxygen -
+	rm -f contrib/asterisk-ng-doxygen.bak
 
 install-logrotate:
 	if [ ! -d "$(DESTDIR)$(ASTETCDIR)/../logrotate.d" ]; then \

Modified: team/lathama/doxygencleanups/addons/chan_mobile.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/addons/chan_mobile.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/addons/chan_mobile.c (original)
+++ team/lathama/doxygencleanups/addons/chan_mobile.c Sat Sep 22 12:55:07 2012
@@ -1524,8 +1524,8 @@
 }
 
 /*!
- * \brief Read until '\r\n'.
- * This function consumes the '\r\n' but does not add it to buf.
+ * \brief Read until \verbatim '\r\n'. \endverbatim
+ * This function consumes the \verbatim'\r\n'\endverbatim but does not add it to buf.
  */
 static int rfcomm_read_until_crlf(int rsock, char **buf, size_t count, size_t *in_count)
 {
@@ -1552,7 +1552,7 @@
 
 /*!
  * \brief Read the remainder of an AT SMS prompt.
- * \note the entire parsed string is '\r\n> '
+ * \note the entire parsed string is \verbatim '\r\n> ' \endverbatim
  *
  * By the time this function is executed, only a ' ' is left to read.
  */
@@ -1570,7 +1570,7 @@
 }
 
 /*!
- * \brief Read until a \r\nOK\r\n message.
+ * \brief Read until a \verbatim \r\nOK\r\n \endverbatim message.
  */
 static int rfcomm_read_until_ok(int rsock, char **buf, size_t count, size_t *in_count)
 {
@@ -1667,7 +1667,7 @@
 
 /*!
  * \brief Read the remainder of a +CMGR message.
- * \note the entire parsed string is '+CMGR: ...\r\n...\r\n...\r\n...\r\nOK\r\n'
+ * \note the entire parsed string is \verbatim '+CMGR: ...\r\n...\r\n...\r\n...\r\nOK\r\n' \endverbatim
  */
 static int rfcomm_read_cmgr(int rsock, char **buf, size_t count, size_t *in_count)
 {
@@ -1686,7 +1686,7 @@
 
 /*!
  * \brief Read and AT result code.
- * \note the entire parsed string is '\r\n<result code>\r\n'
+ * \note the entire parsed string is \verbatim '\r\n<result code>\r\n' \endverbatim
  */
 static int rfcomm_read_result(int rsock, char **buf, size_t count, size_t *in_count)
 {
@@ -1724,7 +1724,7 @@
 
 /*!
  * \brief Read the remainder of an AT command.
- * \note the entire parsed string is '<at command>\r'
+ * \note the entire parsed string is \verbatim '<at command>\r' \endverbatim
  */
 static int rfcomm_read_command(int rsock, char **buf, size_t count, size_t *in_count)
 {
@@ -2132,7 +2132,7 @@
  * \brief Parse a CLIP event.
  * \param hfp an hfp_pvt struct
  * \param buf the buffer to parse (null terminated)
- * @note buf will be modified when the CID string is parsed
+ * \note buf will be modified when the CID string is parsed
  * \return NULL on error (parse error) or a pointer to the caller id
  * information in buf
  */
@@ -2178,7 +2178,7 @@
  * \brief Parse a CMTI notification.
  * \param hfp an hfp_pvt struct
  * \param buf the buffer to parse (null terminated)
- * @note buf will be modified when the CMTI message is parsed
+ * \note buf will be modified when the CMTI message is parsed
  * \return -1 on error (parse error) or the index of the new sms message
  */
 static int hfp_parse_cmti(struct hfp_pvt *hfp, char *buf)
@@ -2203,7 +2203,7 @@
  * \param from_number a pointer to a char pointer which will store the from
  * number
  * \param text a pointer to a char pointer which will store the message text
- * @note buf will be modified when the CMGR message is parsed
+ * \note buf will be modified when the CMGR message is parsed
  * \retval -1 parse error
  * \retval 0 success
  */
@@ -2266,7 +2266,7 @@
  * \brief Parse a CUSD answer.
  * \param hfp an hfp_pvt struct
  * \param buf the buffer to parse (null terminated)
- * @note buf will be modified when the CUSD string is parsed
+ * \note buf will be modified when the CUSD string is parsed
  * \return NULL on error (parse error) or a pointer to the cusd message
  * information in buf
  */

Modified: team/lathama/doxygencleanups/apps/app_adsiprog.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/apps/app_adsiprog.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/apps/app_adsiprog.c (original)
+++ team/lathama/doxygencleanups/apps/app_adsiprog.c Sat Sep 22 12:55:07 2012
@@ -23,6 +23,14 @@
  * \author Mark Spencer <markster at digium.com>
  *
  * \ingroup applications
+ */
+
+/*! 
+ * \par Uses configuration files
+ * \verbinclude adsi.conf.sample
+ * \verbinclude asterisk.adsi
+ *
+ * \addtogroup configuration_file Configuration Files
  */
 
 /*** MODULEINFO

Modified: team/lathama/doxygencleanups/apps/app_followme.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/apps/app_followme.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/apps/app_followme.c (original)
+++ team/lathama/doxygencleanups/apps/app_followme.c Sat Sep 22 12:55:07 2012
@@ -23,9 +23,15 @@
  *
  * \author BJ Weschke <bweschke at btwtech.com>
  *
- * \arg See \ref Config_followme
  *
  * \ingroup applications
+ */
+
+/*! 
+ * \par Uses configuration files
+ * \verbinclude followme.conf.sample
+ *
+ * \addtogroup configuration_file
  */
 
 /*** MODULEINFO

Modified: team/lathama/doxygencleanups/apps/app_queue.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/apps/app_queue.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/apps/app_queue.c (original)
+++ team/lathama/doxygencleanups/apps/app_queue.c Sat Sep 22 12:55:07 2012
@@ -54,6 +54,13 @@
  * by Matthew Enger <m.enger at xi.com.au>
  *
  * \ingroup applications
+ */
+
+/*! 
+ * \par Uses configuration files
+ * \verbinclude queues.conf.sample
+ *
+ * \addtogroup configuration_file
  */
 
 /*** MODULEINFO

Modified: team/lathama/doxygencleanups/apps/app_voicemail.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/apps/app_voicemail.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/apps/app_voicemail.c (original)
+++ team/lathama/doxygencleanups/apps/app_voicemail.c Sat Sep 22 12:55:07 2012
@@ -21,20 +21,27 @@
  * \author Mark Spencer <markster at digium.com>
  * \brief Comedian Mail - Voicemail System
  *
- * \extref unixODBC (http://www.unixodbc.org/)
- * \extref A source distribution of University of Washington's IMAP c-client
+ * unixODBC (http://www.unixodbc.org/)
+ * A source distribution of University of Washington's IMAP c-client
  *         (http://www.washington.edu/imap/)
  *
  * \par See also
  * \arg \ref Config_vm
  * \note For information about voicemail IMAP storage, https://wiki.asterisk.org/wiki/display/AST/IMAP+Voicemail+Storage
- * \ingroup applications
- * \note This module requires res_adsi to load. This needs to be optional
+  * \ingroup applications
+ * \todo This module requires res_adsi to load. This needs to be optional
  * during compilation.
  *
- * \note This file is now almost impossible to work with, due to all \#ifdefs.
+ * \todo This file is now almost impossible to work with, due to all \#ifdefs.
  *       Feels like the database code before realtime. Someone - please come up
  *       with a plan to clean this up.
+ */
+
+/*! 
+ * \par Uses configuration files
+ * \verbinclude voicemail.conf.sample
+ *
+ * \addtogroup configuration_file
  */
 
 /*** MODULEINFO

Modified: team/lathama/doxygencleanups/channels/chan_sip.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/channels/chan_sip.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/channels/chan_sip.c (original)
+++ team/lathama/doxygencleanups/channels/chan_sip.c Sat Sep 22 12:55:07 2012
@@ -90,6 +90,14 @@
  * \par Hanging up
  * The PBX issues a hangup on both incoming and outgoing calls through
  * the sip_hangup() function
+ */
+
+/*! 
+ * \par Uses configuration files
+ * \verbinclude sip.conf.sample
+ * \verbinclude sip_notify.conf.sample
+ *
+ * \addtogroup configuration_file
  */
 
 /*!
@@ -729,7 +737,6 @@
 	Default setttings are used as a channel setting and as a default when
 	configuring devices
 */
-/*@{*/
 static char default_language[MAX_LANGUAGE];      /*!< Default language setting for new channels */
 static char default_callerid[AST_MAX_EXTENSION]; /*!< Default caller ID for sip messages */
 static char default_mwi_from[80];                /*!< Default caller ID for MWI updates */
@@ -749,7 +756,6 @@
 static char default_zone[MAX_TONEZONE_COUNTRY];        /*!< Default tone zone for channels created from the SIP driver */
 static unsigned int default_transports;            /*!< Default Transports (enum sip_transport) that are acceptable */
 static unsigned int default_primary_transport;     /*!< Default primary Transport (enum sip_transport) for outbound connections to devices */
-/*@}*/
 
 static struct sip_settings sip_cfg;		/*!< SIP configuration data.
 					\note in the future we could have multiple of these (per domain, per device group etc) */

Modified: team/lathama/doxygencleanups/channels/iax2-provision.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/channels/iax2-provision.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/channels/iax2-provision.c (original)
+++ team/lathama/doxygencleanups/channels/iax2-provision.c Sat Sep 22 12:55:07 2012
@@ -262,10 +262,8 @@
 	memset(&ied, 0, sizeof(ied));
 
 	ast_mutex_lock(&provlock);
-	if (!(ast_db_get("iax/provisioning/cache", template, tmp, sizeof(tmp)))) {
-		ast_log(LOG_ERROR, "ast_db_get failed to retrieve iax/provisioning/cache\n");
-		ast_mutex_unlock(&provlock);
-		return -1;
+	if (ast_db_get("iax/provisioning/cache", template, tmp, sizeof(tmp))) {
+		ast_log(LOG_ERROR, "ast_db_get failed to retrieve iax/provisioning/cache/%s\n", template);
 	}
 	if (sscanf(tmp, "v%30x", version) != 1) {
 		if (strcmp(tmp, "u")) {

Modified: team/lathama/doxygencleanups/codecs/speex/speex_resampler.h
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/codecs/speex/speex_resampler.h?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/codecs/speex/speex_resampler.h (original)
+++ team/lathama/doxygencleanups/codecs/speex/speex_resampler.h Sat Sep 22 12:55:07 2012
@@ -113,14 +113,15 @@
 struct SpeexResamplerState_;
 typedef struct SpeexResamplerState_ SpeexResamplerState;
 
-/** Create a new resampler with integer input and output rates.
- * @param nb_channels Number of channels to be processed
- * @param in_rate Input sampling rate (integer number of Hz).
- * @param out_rate Output sampling rate (integer number of Hz).
- * @param quality Resampling quality between 0 and 10, where 0 has poor quality
- * and 10 has very high quality.
- * @return Newly created resampler state
- * @retval NULL Error: not enough memory
+/** \brief Create a new resampler with integer input and output rates.
+ * \param nb_channels Number of channels to be processed
+ * \param in_rate Input sampling rate (integer number of Hz).
+ * \param out_rate Output sampling rate (integer number of Hz).
+ * \param quality Resampling quality between 0 and 10, where 0 has poor quality
+ * 	and 10 has very high quality.
+ * \param err
+ * \return Newly created resampler state
+ * \retval NULL Error: not enough memory
  */
 SpeexResamplerState *speex_resampler_init(spx_uint32_t nb_channels, 
                                           spx_uint32_t in_rate, 

Modified: team/lathama/doxygencleanups/contrib/asterisk-ng-doxygen
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/contrib/asterisk-ng-doxygen?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/contrib/asterisk-ng-doxygen (original)
+++ team/lathama/doxygencleanups/contrib/asterisk-ng-doxygen Sat Sep 22 12:55:07 2012
@@ -300,7 +300,7 @@
 
 EXTRACT_ALL            = YES
 
-# If the EXTRACT_PRIVATE tag is set to YES all private members of a class 
+# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
 # will be included in the documentation.
 
 EXTRACT_PRIVATE        = NO
@@ -612,7 +612,7 @@
 # excluded from the INPUT source files. This way you can easily exclude a
 # subdirectory from a directory tree whose root is specified with the INPUT tag.
 
-EXCLUDE                = doc/doxygen \
+EXCLUDE                = doc/api \
                          menuselect \
                          res/pjproject \
                          addons/ooh323c/src
@@ -789,7 +789,7 @@
 # If a relative path is entered the value of OUTPUT_DIRECTORY will be
 # put in front of it. If left blank `html' will be used as the default path.
 
-HTML_OUTPUT            = doxygen
+HTML_OUTPUT            = api
 
 # The HTML_FILE_EXTENSION tag can be used to specify the file extension for
 # each generated HTML page (for example: .htm,.php,.asp). If it is left blank
@@ -1228,7 +1228,7 @@
 # If a relative path is entered the value of OUTPUT_DIRECTORY will be
 # put in front of it. If left blank `man' will be used as the default path.
 
-MAN_OUTPUT             = 
+MAN_OUTPUT             =
 
 # The MAN_EXTENSION tag determines the extension that is added to
 # the generated man pages (default is the subroutine's section .3)
@@ -1376,9 +1376,8 @@
 # undefined via #undef or recursively expanded use the := operator
 # instead of the = operator.
 
-PREDEFINED             = \
-            __GNUC__ \
-            __attribute__(x)=
+PREDEFINED             = __GNUC__ \
+                         __attribute__(x)=
 
 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
 # this tag can be used to specify a list of macro names that should be expanded.

Modified: team/lathama/doxygencleanups/include/asterisk/doxyref.h
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/include/asterisk/doxyref.h?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/include/asterisk/doxyref.h (original)
+++ team/lathama/doxygencleanups/include/asterisk/doxyref.h Sat Sep 22 12:55:07 2012
@@ -1,7 +1,7 @@
 /*
  * Asterisk -- An open source telephony toolkit.
  *
- * Copyright (C) 1999 - 2009, Digium, Inc.
+ * Copyright (C) 1999 - 2012, Digium, Inc.
  *
  * See http://www.asterisk.org for more information about
  * the Asterisk project. Please do not directly contact
@@ -17,15 +17,93 @@
 /*! 
  * \file
  *
- * This is the main header file used for generating miscellaneous developer
- * documentation using doxygen.  This also pulls in all of the documentation
- * that is in include/asterisk/doxygen/.
+ * This is the main header file used for generating miscellaneous documentation
+ * using Doxygen.  This also utilizes the documentation in 
+ * include/asterisk/doxygen/ header files.
  */
 
 /* 
- * The following is for Doxygen Developer's documentation generated
- * by running "make progdocs" with doxygen installed on your
- * system.
+ * Doxygen Pages
+ */
+
+/*! \page system_requirements System Requirements
+ *
+ *
+ */
+
+/*! \page downloading_asterisk Downloading Asterisk
+ *
+ *
+ */
+
+/*! \page installing_asterisk Installing Asterisk
+ *
+ *
+ */
+
+/*! \page configuration_files Configuration Files
+ *
+ *
+ */
+
+/*! \page managing_configurations Managing Configurations
+ *
+ *
+ */
+
+/*! \page running_asterisk Running Asterisk
+ *
+ *
+ */
+
+/*! \page digium_support Digium Support
+ *
+ *
+ */
+
+/*! \page coding_guidelines Coding Guidlines
+ *
+ *
+ */
+
+/*! \page subversion_usage Subversion usage
+ *
+ *
+ */
+
+/*! \page
+ *
+ *
+ */
+
+/*! \page
+ *
+ *
+ */
+
+/*! \page
+ *
+ *
+ */
+
+/*! \page
+ *
+ *
+ */
+
+/*! \page
+ *
+ *
+ */
+
+/*! \page
+ *
+ *
+ */
+
+/*! \page
+ *
+ *
  */
 
 /*! 
@@ -58,6 +136,7 @@
  * \arg \ref AstSpeech
  *
  * \section debugconfig Debugging and Configuration References
+ * \arg \ref AstREADME : General Administrator README file
  * \arg \ref AstDebug : Hints on debugging
  * \arg \ref extref 
  * \arg \ref ConfigFiles
@@ -128,19 +207,39 @@
  * \li ast_channel_alloc()
  */
 
+/*! 
+ * \page AstDebug Debugging
+ * \section debug Debugging
+ * \verbinclude backtrace.txt
+ */
+
+/*!
+ * \page AstSpeech The Generic Speech Recognition API
+ * \section debug The Generic Speech Recognition API
+ * \verbinclude speechrec.txt
+ */
+
+/*! 
+ * \page DataStores Channel Data Stores
+ * \section debug Channel Data Stores
+ * \verbinclude datastores.txt
+ */
 
 /*! 
  * \page AstAMI AMI - The Manager Interface
  * \section ami AMI - The manager Interface
  * \arg \link Config_ami Configuration file \endlink
  * \arg \ref manager.c
+ * \verbinclude manager.txt
  */
 
 /*!
  * \page AstARA ARA - The Asterisk Realtime Interface
  * \section realtime ARA - a generic API to storage and retrieval
  * Implemented in \ref config.c 
- * Implemented in \ref pbx_realtime.c
+ * Implemented in \ref pbx_realtime.c 
+ * \verbinclude realtime.txt
+ * \verbinclude extconfig.txt
  */
 
 /*! 
@@ -169,6 +268,7 @@
  * \arg \ref cdr_drivers
  * \arg \ref Config_cdr CDR configuration files
  *
+ * \verbinclude cdrdriver.txt
  */
 
 /*! 
@@ -184,6 +284,7 @@
 /*! 
  * \page AstVideo Video support in Asterisk
  * \section sectAstVideo Video support in Asterisk
+ * \verbinclude video.txt
  */
 
 /*! 
@@ -285,7 +386,9 @@
  * \arg \link cdr_custom Custom CDR driver configuration \endlink
  * \arg \link cdr_ami Manager CDR driver configuration \endlink
  * \arg \link cdr_odbc ODBC CDR driver configuration \endlink
+ * \arg \link cdr_adaptive_odbc Adaptive ODBC CDR driver configuration \endlink
  * \arg \link cdr_pgsql PostgreSQL CDR driver configuration \endlink
+ * \arg \link cdr_radius RADIUS CDR driver configuration \endlink
  * \arg \link cdr_sqlite SQLite 2 CDR driver configuration \endlink
  * \arg \link cdr_sqlite3_custom SQLite 3 CDR driver configuration \endlink
  * \arg \link cdr_syslog Syslog CDR driver configuration \endlink
@@ -490,12 +593,28 @@
  */
 
 /*! 
+ * \page cdr_odbc Adaptive ODBC CDR driver configuration
+ * \arg See also \ref cdrconf
+ * \arg Implemented in \ref cdr_adaptive_odbc.c
+ * \verbinclude cdr_adaptive_odbc.conf.sample
+ * See also:
+ * \arg http://www.unixodbc.org
+ */
+
+/*! 
  * \page cdr_pgsql PostgreSQL CDR driver configuration
  * \arg See also \ref cdrconf
  * \arg Implemented in \ref cdr_pgsql.c
  * See also:
  * \arg http://www.postgresql.org
  * \verbinclude cdr_pgsql.conf.sample
+ */
+
+/*!
+ * \page cdr_radius RADIUS CDR driver configuration
+ * \arg See also \ref cdrconf
+ * \arg Implemented in \ref cdr_radius.c
+ * \verbinclude cdr_radius.conf.sample
  */
 
 /*! 
@@ -539,7 +658,9 @@
  * \arg \link cdr_custom Custom CDR driver configuration \endlink
  * \arg \link cdr_ami Manager CDR driver configuration \endlink
  * \arg \link cdr_odbc ODBC CDR driver configuration \endlink
+ * \arg \link cdr_adaptive_odbc Adaptive ODBC CDR driver configuration \endlink
  * \arg \link cdr_pgsql PostgreSQL CDR driver configuration \endlink
+ * \arg \link cdr_radius RADIUS CDR driver configuration \endlink
  * \arg \link cdr_sqlite SQLite 2 CDR driver configuration \endlink
  * \arg \link cdr_sqlite3_custom SQLite 3 CDR driver configuration \endlink
  * \arg \link cdr_syslog Syslog CDR driver configuration \endlink
@@ -602,6 +723,34 @@
  *
  * Additional sound files are available in the asterisk-addons
  * repository on svn.digium.com
+ */
+
+/*! 
+ * \page AstHTTP AMI over HTTP support
+ * The http.c file includes support for manager transactions over
+ * http.
+ * \section ami AMI - The manager Interface
+ * \arg \link Config_ami Configuration file \endlink
+ */
+
+/*! 
+ * \page res_config_sqlite SQLite Resource driver configuration
+ * \arg Implemented in \ref res_config_sqlite.c
+ * \arg Configuration file:
+ * \verbinclude res_config_sqlite.conf
+ * \arg SQL tables:
+ * \arg See also:
+ * http://www.sqlite.org
+ */
+
+/*
+ * Doxygen Groups
+ */
+
+/*! \addtogroup configuration_file Configuration Files
+ * The following applications, resources and core files use a configuration
+ * file.
+ *
  */
 
 /*! 
@@ -662,22 +811,5 @@
  * \section rtp_engine_blah Asterisk RTP Engines
  */
 
-/*! 
- * \page AstHTTP AMI over HTTP support
- * The http.c file includes support for manager transactions over
- * http.
- * \section ami AMI - The manager Interface
- * \arg \link Config_ami Configuration file \endlink
- */
-
-/*! 
- * \page res_config_sqlite SQLite Resource driver configuration
- * \arg Implemented in \ref res_config_sqlite.c
- * \arg Configuration file:
- * \verbinclude res_config_sqlite.conf.sample
- * \arg SQL tables:
- * \arg See also:
- * http://www.sqlite.org
- */
-
-
+
+

Modified: team/lathama/doxygencleanups/include/asterisk/pbx.h
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/include/asterisk/pbx.h?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/include/asterisk/pbx.h (original)
+++ team/lathama/doxygencleanups/include/asterisk/pbx.h Sat Sep 22 12:55:07 2012
@@ -821,7 +821,7 @@
  * \brief Add a context include
  *
  * \param con context to add the include to
- * \param include value to add
+ * \param value include value to add
  * \param registrar who registered the context
  *
  * Adds an include taking a struct ast_context as the first parameter

Modified: team/lathama/doxygencleanups/main/asterisk.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/main/asterisk.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/main/asterisk.c (original)
+++ team/lathama/doxygencleanups/main/asterisk.c Sat Sep 22 12:55:07 2012
@@ -16,50 +16,134 @@
  * at the top of the source tree.
  */
 
-/* Begin Doxygen Documentation */
 /*!
- * \mainpage Asterisk -- The Open Source Telephony Project
+ * \mainpage Asterisk -- The Open Source Telephony Tool Kit
  *
- * \par Welcome
+ * \section welcome Welcome
+ * This documentation created by the Doxygen project clearly explains the
+ * internals of the <a href="http://asterisk.org">Asterisk</a> Open Source
+ * Telephony Tool Kit. This documentation contains basic examples, developer
+ * documentation, support information, and information for upgrading. Effort
+ * is made to keep this documentation up to date and other resources exist in
+ * tandem with this documentation. Review all sources of reference if you have
+ * a question or concern.
+ * 
+ * \section about About
+ * Asterisk is Open Source Software that forms an Open Source Tool Kit for
+ * creating part or the whole of a system for communication. The Asterisk
+ * software is used around the world for various solutions that enable phone,
+ * video, and all manner of communication. Asterisk development is also 
+ * sponsored by Digium Inc. in Huntsville, AL. Asterisk was created by
+ * Mark Spencer who founded <a href="http://www.digium.com">Digium, Inc.</a>
+ * along with other Open Source Software like Pidgin (Formally GAIM).
  *
- * This documentation created by the Doxygen project clearly explains the
- * internals of the Asterisk software. This documentation contains basic
- * examples, developer documentation, support information, and information
- * for upgrading.
+ * \section installation Installation
+ * To install Asterisk on your system there are a few steps depending
+ * on the platform and desired setup. Use these resources to keep moving!
+ * \li \ref system_requirements System Requirements
+ * \li \ref downloading_asterisk Downloading Asterisk
+ * \li \ref installing_asterisk Installing Asterisk
  * 
- * 
- * 
- * \par Developer Documentation for Asterisk
+ * \section configuration Configuration
+ * All software needs a little configuration, and Asterisk is no 
+ * different. Learn about where and how Asterisk is configured in this section.
+ * \li \ref configuration_files Configuration Files
+ * \li \ref managing_configurations Managing Configurations
+ * \li \ref running_asterisk Running Asterisk
  *
- * This is the main developer documentation for Asterisk. It is
- * generated by running "make progdocs" from the Asterisk source tree.
+ * \section support Support
+ * There are many sources of support both free and commercial. If you need
+ * support for your installation try the commumity resources or contact Digium.
+ * Directly attempting to contact the developers may not yeild the best results.
+ * \li \ref community_support Community Support
+ * \li \ref digium_support Digium Support
  *
- * In addition to the information available on the Asterisk source code,
- * please see the appendices for information on coding guidelines,
- * release management, commit policies, and more.
+ * \section community Community
+ * Asterisk is a big project and has a busy community. Look at the
+ * resources for questions and stick around to help answer questions.
+ * \li \ref asterisk_community_resources Asterisk Community Resources
  *
- * \arg \ref AsteriskArchitecture
+ * \section development Development
+ * Many developers work on Asterisk everyday.  If you need to do some
+ * development on Asterisk then the following will be very helpful.
+ * \li \ref coding_guidelines Coding Guidlines
+ * \li \ref subversion_usage Subversion usage
+ *
+ * \li \ref AsteriskArchitecture
  *
  * \par Additional documentation
- * \arg \ref Licensing
- * \arg \ref DevDoc
- * \arg \ref ConfigFiles
+ * \li \ref Licensing
+ * \li \ref DevDoc
+ * \li \ref ConfigFiles
  *
- * \section copyright Copyright and Author
+ * \section copyright Copyright and Authors
  *
  * Copyright (C) 1999 - 2012, Digium, Inc.
  * Asterisk is a <a href="http://www.digium.com/en/company/view-policy.php?id=Trademark-Policy">registered trademark</a>
  * of <a href="http://www.digium.com">Digium, Inc</a>.
  *
  * \author Mark Spencer <markster at digium.com>
+ * \li \ref credits Credits
+ */
+
+/*!
+ * \page asterisk_community_resources Asterisk Community Resources
+ * \par Websites
+ * \li http://www.asterisk.org Asterisk Homepage
+ * \li http://wiki.asterisk.org Asterisk Wiki
  *
- * See http://www.asterisk.org for more information about
- * the Asterisk project. Please do not directly contact
- * any of the maintainers of this project for assistance;
- * the project provides a web site, mailing lists, and IRC
- * channels for your use.
+ * \par Mailing Lists
+ * All lists: http://lists.digium.com/mailman/listinfo
  *
- * \todo Add pages for mailinglists, IRC, etc...
+ * \li aadk-commits	SVN commits to the AADK repository
+ * \li asterisk-addons-commits	SVN commits to the Asterisk addons project
+ * \li asterisk-announce	[no description available]
+ * \li asterisk-biz	Commercial and Business-Oriented Asterisk Discussion
+ * \li Asterisk-BSD	Asterisk on BSD discussion
+ * \li asterisk-bugs	[no description available]
+ * \li asterisk-commits	SVN commits to the Asterisk project
+ * \li asterisk-dev	Asterisk Developers Mailing List
+ * \li asterisk-doc	Discussions regarding The Asterisk Documentation Project
+ * \li asterisk-embedded	Asterisk Embedded Development
+ * \li asterisk-gui	Asterisk GUI project discussion
+ * \li asterisk-gui-commits	SVN commits to the Asterisk-GUI project
+ * \li asterisk-ha-clustering	Asterisk High Availability and Clustering List - Non-Commercial Discussion
+ * \li Asterisk-i18n	Discussion of Asterisk internationalization
+ * \li asterisk-r2	[no description available]
+ * \li asterisk-scf-commits	Commits to the Asterisk SCF project code repositories
+ * \li asterisk-scf-committee	Asterisk SCF Steering Committee discussions
+ * \li asterisk-scf-dev	Asterisk SCF Developers Mailing List
+ * \li asterisk-scf-wiki-changes	Changes to the Asterisk SCF space on wiki.asterisk.org
+ * \li asterisk-security	Asterisk Security Discussion
+ * \li asterisk-speech-rec	Use of speech recognition in Asterisk
+ * \li asterisk-ss7	[no description available]
+ * \li asterisk-users	Asterisk Users Mailing List - Non-Commercial Discussion
+ * \li asterisk-video	Development discussion of video media support in Asterisk
+ * \li asterisk-wiki-changes	Changes to the Asterisk space on wiki.asterisk.org
+ * \li asterisknow	AsteriskNOW Discussion
+ * \li dahdi-commits	SVN commits to the DAHDI project
+ * \li digium-announce	Digium Product Announcements
+ * \li Dundi	Distributed Universal Number Discovery
+ * \li libiax2-commits	SVN commits to the libiax2 project
+ * \li libpri-commits	SVN commits to the libpri project
+ * \li libss7-commits	SVN commits to the libss7 project
+ * \li svn-commits	SVN commits to the Digium repositories
+ * \li Test-results	Results from automated testing
+ * \li thirdparty-commits	SVN commits to the Digium third-party software repository
+ * \li zaptel-commits	SVN commits to the Zaptel project
+ *
+ * \par Forums
+ * Forums are located at http://forums.asterisk.org/
+ *
+ * \par IRC
+ * Use http://www.freenode.net IRC server to connect with Asterisk
+ * developers and users in realtime.
+ * 
+ * \li #asterisk Asterisk Users Room
+ * \li #asterisk-dev Asterisk Developers Room
+ *
+ * If you would like to add a resource to this list please create an issue
+ * on the issue tracker with a patch.
  */
 
 /*! \file

Modified: team/lathama/doxygencleanups/res/res_timing_kqueue.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/res/res_timing_kqueue.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/res/res_timing_kqueue.c (original)
+++ team/lathama/doxygencleanups/res/res_timing_kqueue.c Sat Sep 22 12:55:07 2012
@@ -3,7 +3,7 @@
  *
  * Copyright (C) 2010, Digium, Inc.
  *
- * Tilghman Lesher tlesher AT digium DOT com
+ * Tilghman Lesher \verbatim <tlesher AT digium DOT com> \endverbatim
  *
  * See http://www.asterisk.org for more information about
  * the Asterisk project. Please do not directly contact
@@ -18,9 +18,11 @@
 
 /*!
  * \file
- * \author Tilghman Lesher tlesher AT digium DOT com
+ * \author Tilghman Lesher \verbatim <tlesher AT digium DOT com> \endverbatim
  *
  * \brief kqueue timing interface
+ *
+ * \ingroup resource
  */
 
 /*** MODULEINFO

Modified: team/lathama/doxygencleanups/utils/refcounter.c
URL: http://svnview.digium.com/svn/asterisk/team/lathama/doxygencleanups/utils/refcounter.c?view=diff&rev=373380&r1=373379&r2=373380
==============================================================================
--- team/lathama/doxygencleanups/utils/refcounter.c (original)
+++ team/lathama/doxygencleanups/utils/refcounter.c Sat Sep 22 12:55:07 2012
@@ -15,9 +15,10 @@
  * the GNU General Public License Version 2. See the LICENSE file
  * at the top of the source tree.
  */
+
 /*! \file
  *
- *  \brief A program to read in the /tmp/refs file generated
+ * \brief A program to read in the /tmp/refs file generated
  *         by astobj2 code when the REF_DEBUG macro is defined.
  *         It will read in the file line by line, and
  *         sort the data out by object, and check to see
@@ -28,15 +29,15 @@
  *         this program reads in the /tmp/refs file and 
  *         generates no output. No news is good news.
  *  The contents of the /tmp/refs file looks like this:
- *
-0x84fd718 -1   astobj2.c:926:cd_cb_debug (deref object via container destroy) [@1]
-0x84fd718 =1   chan_sip.c:19760:build_user (allocate a user struct)
-0x84fd718 +1   chan_sip.c:21558:reload_config (link user into users table) [@1]
-0x84fd718 -1   chan_sip.c:2376:unref_user (Unref the result of build_user. Now, the table link is the only one left.) [@2]
-0x84fd718 **call destructor** astobj2.c:926:cd_cb_debug (deref object via container destroy)
- *
- *
- *  \author Steve Murphy <murf at digium.com>
+ * \verbatim
+ * 0x84fd718 -1   astobj2.c:926:cd_cb_debug (deref object via container destroy) [@1]
+ * 0x84fd718 =1   chan_sip.c:19760:build_user (allocate a user struct)
+ * 0x84fd718 +1   chan_sip.c:21558:reload_config (link user into users table) [@1]
+ * 0x84fd718 -1   chan_sip.c:2376:unref_user (Unref the result of build_user. Now, the table link is the only one left.) [@2]
+ * 0x84fd718 **call destructor** astobj2.c:926:cd_cb_debug (deref object via container destroy)
+ * \endverbatim
+ *
+ * \author Steve Murphy <murf at digium.com>
  */
 
 /*** MODULEINFO




More information about the asterisk-commits mailing list