Index: apps/app_adsiprog.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_adsiprog.c,v
retrieving revision 1.19
diff -u -r1.19 app_adsiprog.c
--- apps/app_adsiprog.c	26 Oct 2005 19:48:14 -0000	1.19
+++ apps/app_adsiprog.c	4 Nov 2005 13:17:09 -0000
@@ -19,6 +19,7 @@
 /*! \file
  * \brief Program Asterisk ADSI Scripts into phone
  * 
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_alarmreceiver.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_alarmreceiver.c,v
retrieving revision 1.19
diff -u -r1.19 app_alarmreceiver.c
--- apps/app_alarmreceiver.c	26 Oct 2005 19:48:14 -0000	1.19
+++ apps/app_alarmreceiver.c	4 Nov 2005 13:17:10 -0000
@@ -18,6 +18,7 @@
 
 /*! \file
  * \brief Central Station Alarm receiver for Ademco Contact ID  
+ * \author Steve Rodgers <hwstar@rodgers.sdcoxmail.com>
  * 
  * *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** 
  *
@@ -25,6 +26,7 @@
  *
  * *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING ***
  *
+ * \ingroup applications
  */ 
  
 #include <string.h>
Index: apps/app_authenticate.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_authenticate.c,v
retrieving revision 1.19
diff -u -r1.19 app_authenticate.c
--- apps/app_authenticate.c	26 Oct 2005 19:48:14 -0000	1.19
+++ apps/app_authenticate.c	4 Nov 2005 13:17:10 -0000
@@ -19,6 +19,7 @@
 /*! \file
  * \brief Execute arbitrary authenticate commands
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_cdr.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_cdr.c,v
retrieving revision 1.10
diff -u -r1.10 app_cdr.c
--- apps/app_cdr.c	24 Oct 2005 20:12:05 -0000	1.10
+++ apps/app_cdr.c	4 Nov 2005 13:17:10 -0000
@@ -19,6 +19,7 @@
 /*! \file
  * \brief Applications connected with CDR engine
  *
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_chanisavail.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_chanisavail.c,v
retrieving revision 1.26
diff -u -r1.26 app_chanisavail.c
--- apps/app_chanisavail.c	26 Oct 2005 19:48:14 -0000	1.26
+++ apps/app_chanisavail.c	4 Nov 2005 13:17:10 -0000
@@ -1,25 +1,26 @@
 /*
- * Asterisk -- An open source telephony toolkit.
- *
- * Copyright (C) 1999 - 2005, Digium, Inc.
- *
- * Mark Spencer <markster@digium.com>
- * James Golovich <james@gnuinter.net>
- *
- * 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.
- *
- * This program is free software, distributed under the terms of
- * the GNU General Public License Version 2. See the LICENSE file
- * at the top of the source tree.
- */
+* Asterisk -- An open source telephony toolkit.
+*
+* Copyright (C) 1999 - 2005, Digium, Inc.
+*
+* Mark Spencer <markster@digium.com>
+* James Golovich <james@gnuinter.net>
+*
+* 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.
+*
+* This program is free software, distributed under the terms of
+* the GNU General Public License Version 2. See the LICENSE file
+* at the top of the source tree.
+*/
 
 /*! \file
- * \brief Check if Channel is Available
- * 
+* \brief Check if Channel is Available
+* 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_chanspy.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_chanspy.c,v
retrieving revision 1.29
diff -u -r1.29 app_chanspy.c
--- apps/app_chanspy.c	28 Oct 2005 23:01:13 -0000	1.29
+++ apps/app_chanspy.c	4 Nov 2005 13:17:10 -0000
@@ -19,6 +19,7 @@
 /*! \file
  * \brief ChanSpy: Listen in on any channel.
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_controlplayback.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_controlplayback.c,v
retrieving revision 1.17
diff -u -r1.17 app_controlplayback.c
--- apps/app_controlplayback.c	26 Oct 2005 19:48:14 -0000	1.17
+++ apps/app_controlplayback.c	4 Nov 2005 13:17:10 -0000
@@ -19,6 +19,7 @@
 /*! \file
  * \brief Trivial application to control playback of a sound file
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_curl.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_curl.c,v
retrieving revision 1.15
diff -u -r1.15 app_curl.c
--- apps/app_curl.c	26 Oct 2005 19:48:14 -0000	1.15
+++ apps/app_curl.c	4 Nov 2005 13:17:10 -0000
@@ -20,6 +20,7 @@
 /*! \file
  * \brief Curl - App to load a URL
  * 
+ * \ingroup applications
  */
  
 #include <stdlib.h>
Index: apps/app_cut.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_cut.c,v
retrieving revision 1.18
diff -u -r1.18 app_cut.c
--- apps/app_cut.c	1 Nov 2005 21:02:07 -0000	1.18
+++ apps/app_cut.c	4 Nov 2005 13:17:11 -0000
@@ -18,6 +18,7 @@
 /*! \file
  * \brief Cut application
  *
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_datetime.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_datetime.c,v
retrieving revision 1.7
diff -u -r1.7 app_datetime.c
--- apps/app_datetime.c	24 Oct 2005 20:12:05 -0000	1.7
+++ apps/app_datetime.c	4 Nov 2005 13:17:11 -0000
@@ -19,6 +19,7 @@
 /*! \file
  * \brief Time of day - Report the time of day
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_db.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_db.c,v
retrieving revision 1.17
diff -u -r1.17 app_db.c
--- apps/app_db.c	26 Oct 2005 19:48:14 -0000	1.17
+++ apps/app_db.c	4 Nov 2005 13:17:11 -0000
@@ -22,6 +22,7 @@
  *
  * \brief Database access functions
  *
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_dial.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_dial.c,v
retrieving revision 1.175
diff -u -r1.175 app_dial.c
--- apps/app_dial.c	26 Oct 2005 19:48:14 -0000	1.175
+++ apps/app_dial.c	4 Nov 2005 13:17:13 -0000
@@ -20,6 +20,7 @@
  *
  * \brief dial() & retrydial() - Trivial application to dial a channel and send an URL on answer
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_dictate.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_dictate.c,v
retrieving revision 1.9
diff -u -r1.9 app_dictate.c
--- apps/app_dictate.c	26 Oct 2005 19:48:14 -0000	1.9
+++ apps/app_dictate.c	4 Nov 2005 13:17:13 -0000
@@ -22,6 +22,7 @@
  *
  * \brief Virtual Dictation Machine Application For Asterisk
  *
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_directed_pickup.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_directed_pickup.c,v
retrieving revision 1.7
diff -u -r1.7 app_directed_pickup.c
--- apps/app_directed_pickup.c	26 Oct 2005 19:48:14 -0000	1.7
+++ apps/app_directed_pickup.c	4 Nov 2005 13:17:13 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Directed Call Pickup Support
  *
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_directory.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_directory.c,v
retrieving revision 1.49
diff -u -r1.49 app_directory.c
--- apps/app_directory.c	26 Oct 2005 19:48:14 -0000	1.49
+++ apps/app_directory.c	4 Nov 2005 13:17:13 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Provide a directory of extensions
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_disa.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_disa.c,v
retrieving revision 1.41
diff -u -r1.41 app_disa.c
--- apps/app_disa.c	27 Oct 2005 02:48:56 -0000	1.41
+++ apps/app_disa.c	4 Nov 2005 13:17:13 -0000
@@ -3,7 +3,6 @@
  *
  * Copyright (C) 1999 - 2005, Digium, Inc.
  *
- * Jim Dixon <jim@lambdatel.com>
  *
  * Made only slightly more sane by Mark Spencer <markster@digium.com>
  *
@@ -21,7 +20,10 @@
 /*! \file
  *
  * \brief DISA -- Direct Inward System Access Application
+ *
+ * \author Jim Dixon <jim@lambdatel.com>
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_dumpchan.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_dumpchan.c,v
retrieving revision 1.14
diff -u -r1.14 app_dumpchan.c
--- apps/app_dumpchan.c	26 Oct 2005 19:48:14 -0000	1.14
+++ apps/app_dumpchan.c	4 Nov 2005 13:17:13 -0000
@@ -22,6 +22,7 @@
  *
  * \brief Application to dump channel variables
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_echo.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_echo.c,v
retrieving revision 1.15
diff -u -r1.15 app_echo.c
--- apps/app_echo.c	24 Oct 2005 20:12:05 -0000	1.15
+++ apps/app_echo.c	4 Nov 2005 13:17:13 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Echo application -- play back what you hear to evaluate latency
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_enumlookup.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_enumlookup.c,v
retrieving revision 1.25
diff -u -r1.25 app_enumlookup.c
--- apps/app_enumlookup.c	26 Oct 2005 19:48:14 -0000	1.25
+++ apps/app_enumlookup.c	4 Nov 2005 13:17:14 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Enumlookup - lookup entry in ENUM
  *
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_eval.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_eval.c,v
retrieving revision 1.10
diff -u -r1.10 app_eval.c
--- apps/app_eval.c	24 Oct 2005 20:12:05 -0000	1.10
+++ apps/app_eval.c	4 Nov 2005 13:17:14 -0000
@@ -19,6 +19,8 @@
  * \brief Eval application
  *
  * \author Tilghman Lesher <app_eval__v001@the-tilghman.com>
+ *
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_exec.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_exec.c,v
retrieving revision 1.9
diff -u -r1.9 app_exec.c
--- apps/app_exec.c	24 Oct 2005 20:12:05 -0000	1.9
+++ apps/app_exec.c	4 Nov 2005 13:17:14 -0000
@@ -20,6 +20,8 @@
  * \brief Exec application
  *
  * \author Tilghman Lesher <app_exec__v001@the-tilghman.com>
+ *
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_externalivr.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_externalivr.c,v
retrieving revision 1.13
diff -u -r1.13 app_externalivr.c
--- apps/app_externalivr.c	26 Oct 2005 19:48:14 -0000	1.13
+++ apps/app_externalivr.c	4 Nov 2005 13:17:14 -0000
@@ -23,6 +23,7 @@
  *
  * \brief External IVR application interface
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_festival.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_festival.c,v
retrieving revision 1.37
diff -u -r1.37 app_festival.c
--- apps/app_festival.c	26 Oct 2005 19:48:14 -0000	1.37
+++ apps/app_festival.c	4 Nov 2005 13:17:14 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Connect to festival
  * 
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_flash.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_flash.c,v
retrieving revision 1.9
diff -u -r1.9 app_flash.c
--- apps/app_flash.c	24 Oct 2005 20:12:05 -0000	1.9
+++ apps/app_flash.c	4 Nov 2005 13:17:14 -0000
@@ -20,6 +20,7 @@
  *
  * \brief App to flash a zap trunk
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_forkcdr.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_forkcdr.c,v
retrieving revision 1.15
diff -u -r1.15 app_forkcdr.c
--- apps/app_forkcdr.c	26 Oct 2005 19:48:14 -0000	1.15
+++ apps/app_forkcdr.c	4 Nov 2005 13:17:14 -0000
@@ -19,6 +19,7 @@
  *
  * \brief Fork CDR application
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_getcpeid.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_getcpeid.c,v
retrieving revision 1.11
diff -u -r1.11 app_getcpeid.c
--- apps/app_getcpeid.c	24 Oct 2005 20:12:05 -0000	1.11
+++ apps/app_getcpeid.c	4 Nov 2005 13:17:14 -0000
@@ -18,8 +18,9 @@
 
 /*! \file
  *
- * \brief Execute arbitrary system commands
+ * \brief Get ADSI CPE ID
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_groupcount.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_groupcount.c,v
retrieving revision 1.25
diff -u -r1.25 app_groupcount.c
--- apps/app_groupcount.c	26 Oct 2005 19:48:14 -0000	1.25
+++ apps/app_groupcount.c	4 Nov 2005 13:17:14 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Group Manipulation Applications
  *
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_hasnewvoicemail.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_hasnewvoicemail.c,v
retrieving revision 1.21
diff -u -r1.21 app_hasnewvoicemail.c
--- apps/app_hasnewvoicemail.c	26 Oct 2005 19:48:14 -0000	1.21
+++ apps/app_hasnewvoicemail.c	4 Nov 2005 13:17:14 -0000
@@ -24,6 +24,7 @@
  *
  * \brief HasVoicemail application
  *
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_ices.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_ices.c,v
retrieving revision 1.12
diff -u -r1.12 app_ices.c
--- apps/app_ices.c	26 Oct 2005 19:48:14 -0000	1.12
+++ apps/app_ices.c	4 Nov 2005 13:17:14 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Stream to an icecast server via ICES (see contrib/asterisk-ices.xml)
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_image.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_image.c,v
retrieving revision 1.12
diff -u -r1.12 app_image.c
--- apps/app_image.c	26 Oct 2005 19:48:14 -0000	1.12
+++ apps/app_image.c	4 Nov 2005 13:17:15 -0000
@@ -20,6 +20,7 @@
  *
  * \brief App to transmit an image
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_intercom.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_intercom.c,v
retrieving revision 1.26
diff -u -r1.26 app_intercom.c
--- apps/app_intercom.c	24 Oct 2005 20:12:05 -0000	1.26
+++ apps/app_intercom.c	4 Nov 2005 13:17:15 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Use /dev/dsp as an intercom.
  * 
+ * \ingroup applications
  */
  
 #include <unistd.h>
Index: apps/app_ivrdemo.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_ivrdemo.c,v
retrieving revision 1.12
diff -u -r1.12 app_ivrdemo.c
--- apps/app_ivrdemo.c	26 Oct 2005 19:48:14 -0000	1.12
+++ apps/app_ivrdemo.c	4 Nov 2005 13:17:15 -0000
@@ -20,6 +20,7 @@
  *
  * \brief IVR Demo application
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_lookupblacklist.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_lookupblacklist.c,v
retrieving revision 1.13
diff -u -r1.13 app_lookupblacklist.c
--- apps/app_lookupblacklist.c	24 Oct 2005 20:12:05 -0000	1.13
+++ apps/app_lookupblacklist.c	4 Nov 2005 13:17:15 -0000
@@ -19,6 +19,8 @@
 /*! \file
  *
  * \brief App to lookup the callerid number, and see if it is blacklisted
+ *
+ * \ingroup applications
  * 
  */
 
Index: apps/app_lookupcidname.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_lookupcidname.c,v
retrieving revision 1.11
diff -u -r1.11 app_lookupcidname.c
--- apps/app_lookupcidname.c	24 Oct 2005 20:12:05 -0000	1.11
+++ apps/app_lookupcidname.c	4 Nov 2005 13:17:15 -0000
@@ -20,6 +20,7 @@
  *
  * \brief App to set callerid name from database, based on directory number
  * 
+ * \ingroup applications
  */
 
 #include <string.h>
Index: apps/app_macro.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_macro.c,v
retrieving revision 1.32
diff -u -r1.32 app_macro.c
--- apps/app_macro.c	26 Oct 2005 19:48:14 -0000	1.32
+++ apps/app_macro.c	4 Nov 2005 13:17:15 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Dial plan macro Implementation
  * 
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_math.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_math.c,v
retrieving revision 1.17
diff -u -r1.17 app_math.c
--- apps/app_math.c	26 Oct 2005 19:48:14 -0000	1.17
+++ apps/app_math.c	4 Nov 2005 13:17:15 -0000
@@ -20,6 +20,7 @@
  *
  * \brief A simple math application
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_md5.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_md5.c,v
retrieving revision 1.12
diff -u -r1.12 app_md5.c
--- apps/app_md5.c	26 Oct 2005 19:48:14 -0000	1.12
+++ apps/app_md5.c	4 Nov 2005 13:17:15 -0000
@@ -20,6 +20,7 @@
  * \brief MD5 checksum application
  * 
  * \todo Remove this deprecated application in 1.3dev
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_meetme.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_meetme.c,v
retrieving revision 1.117
diff -u -r1.117 app_meetme.c
--- apps/app_meetme.c	28 Oct 2005 16:36:10 -0000	1.117
+++ apps/app_meetme.c	4 Nov 2005 13:17:16 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Meet me conference bridge
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_milliwatt.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_milliwatt.c,v
retrieving revision 1.15
diff -u -r1.15 app_milliwatt.c
--- apps/app_milliwatt.c	24 Oct 2005 20:12:05 -0000	1.15
+++ apps/app_milliwatt.c	4 Nov 2005 13:17:16 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Digital Milliwatt Test
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_mixmonitor.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_mixmonitor.c,v
retrieving revision 1.9
diff -u -r1.9 app_mixmonitor.c
--- apps/app_mixmonitor.c	1 Nov 2005 20:57:42 -0000	1.9
+++ apps/app_mixmonitor.c	4 Nov 2005 13:17:16 -0000
@@ -23,6 +23,7 @@
 
 /*! \file
  * \brief MixMonitor() - Record a call and mix the audio during the recording
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_mp3.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_mp3.c,v
retrieving revision 1.31
diff -u -r1.31 app_mp3.c
--- apps/app_mp3.c	26 Oct 2005 19:48:14 -0000	1.31
+++ apps/app_mp3.c	4 Nov 2005 13:17:16 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Silly application to play an MP3 file -- uses mpg123
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_nbscat.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_nbscat.c,v
retrieving revision 1.15
diff -u -r1.15 app_nbscat.c
--- apps/app_nbscat.c	24 Oct 2005 20:12:05 -0000	1.15
+++ apps/app_nbscat.c	4 Nov 2005 13:17:17 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Silly application to play an NBScat file -- uses nbscat8k
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_osplookup.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_osplookup.c,v
retrieving revision 1.14
diff -u -r1.14 app_osplookup.c
--- apps/app_osplookup.c	26 Oct 2005 19:48:14 -0000	1.14
+++ apps/app_osplookup.c	4 Nov 2005 13:17:17 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Open Settlement Protocol Lookup
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_page.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_page.c,v
retrieving revision 1.9
diff -u -r1.9 app_page.c
--- apps/app_page.c	26 Oct 2005 19:48:14 -0000	1.9
+++ apps/app_page.c	4 Nov 2005 13:17:17 -0000
@@ -20,6 +20,7 @@
  *
  * \brief page() - Paging application
  *
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_parkandannounce.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_parkandannounce.c,v
retrieving revision 1.21
diff -u -r1.21 app_parkandannounce.c
--- apps/app_parkandannounce.c	1 Nov 2005 21:11:57 -0000	1.21
+++ apps/app_parkandannounce.c	4 Nov 2005 13:17:17 -0000
@@ -23,6 +23,7 @@
  *
  * \brief ParkAndAnnounce application for Asterisk
  * 
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_playback.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_playback.c,v
retrieving revision 1.24
diff -u -r1.24 app_playback.c
--- apps/app_playback.c	26 Oct 2005 19:48:14 -0000	1.24
+++ apps/app_playback.c	4 Nov 2005 13:17:17 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Trivial application to playback a sound file
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_privacy.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_privacy.c,v
retrieving revision 1.20
diff -u -r1.20 app_privacy.c
--- apps/app_privacy.c	26 Oct 2005 19:48:14 -0000	1.20
+++ apps/app_privacy.c	4 Nov 2005 13:17:17 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Block all calls without Caller*ID, require phone # to be entered
  * 
+ * \ingroup applications
  */
 
 #include <string.h>
@@ -71,8 +72,7 @@
 
 
 
-static int
-privacy_exec (struct ast_channel *chan, void *data)
+static int privacy_exec (struct ast_channel *chan, void *data)
 {
 	int res=0;
 	int retries;
Index: apps/app_queue.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_queue.c,v
retrieving revision 1.174
diff -u -r1.174 app_queue.c
--- apps/app_queue.c	26 Oct 2005 19:48:14 -0000	1.174
+++ apps/app_queue.c	4 Nov 2005 13:17:19 -0000
@@ -19,8 +19,10 @@
 /*! \file
  *
  * \brief True call queues with optional send URL on answer
- * 
  *
+ * \arg Config in \ref Config_qu queues.conf
+ * 
+ * \par Development notes
  * \note 2004-11-25: Persistent Dynamic Members added by:
  *             NetNation Communications (www.netnation.com)
  *             Kevin Lindsay <kevinl@netnation.com>
@@ -49,6 +51,7 @@
  * Fixed to work with CVS as of 2004-02-25 and released as 1.07a
  * by Matthew Enger <m.enger@xi.com.au>
  *
+ * \ingroup applications
  */
 
 #include <stdlib.h>
@@ -192,15 +195,15 @@
 "same way, except it unpauses instead of pausing the given interface.\n"
 "Example: UnpauseQueueMember(|SIP/3000)\n";
 
-/* Persistent Members astdb family */
+/*! \brief Persistent Members astdb family */
 static const char *pm_family = "/Queue/PersistentMembers";
 /* The maximum lengh of each persistent member queue database entry */
 #define PM_MAX_LEN 2048
 
-/* queues.conf [general] option */
+/*! \brief queues.conf [general] option */
 static int queue_persistent_members = 0;
 
-/* queues.conf per-queue weight option */
+/*! \brief queues.conf per-queue weight option */
 static int use_weight = 0;
 
 enum queue_result {
@@ -226,7 +229,7 @@
 	{ QUEUE_FULL, "FULL" },
 };
 
-/* We define a custom "local user" structure because we
+/*! \brief We define a custom "local user" structure because we
    use it not only for keeping track of what is in use but
    also for keeping track of who we're dialing. */
 
@@ -244,34 +247,34 @@
 LOCAL_USER_DECL;
 
 struct queue_ent {
-	struct ast_call_queue *parent;	/* What queue is our parent */
-	char moh[80];			/* Name of musiconhold to be used */
-	char announce[80];		/* Announcement to play for member when call is answered */
-	char context[AST_MAX_CONTEXT];	/* Context when user exits queue */
-	char digits[AST_MAX_EXTENSION];	/* Digits entered while in queue */
-	int pos;			/* Where we are in the queue */
-	int prio;			/* Our priority */
-	int last_pos_said;              /* Last position we told the user */
-	time_t last_periodic_announce_time;	/* The last time we played a periodic anouncement */
-	time_t last_pos;                /* Last time we told the user their position */
-	int opos;			/* Where we started in the queue */
-	int handled;			/* Whether our call was handled */
-	time_t start;			/* When we started holding */
-	time_t expire;			/* When this entry should expire (time out of queue) */
-	struct ast_channel *chan;	/* Our channel */
-	struct queue_ent *next;		/* The next queue entry */
+	struct ast_call_queue *parent;	/*!< What queue is our parent */
+	char moh[80];			/*!< Name of musiconhold to be used */
+	char announce[80];		/*!< Announcement to play for member when call is answered */
+	char context[AST_MAX_CONTEXT];	/*!< Context when user exits queue */
+	char digits[AST_MAX_EXTENSION];	/*!< Digits entered while in queue */
+	int pos;			/*!< Where we are in the queue */
+	int prio;			/*!< Our priority */
+	int last_pos_said;              /*!< Last position we told the user */
+	time_t last_periodic_announce_time;	/*!< The last time we played a periodic anouncement */
+	time_t last_pos;                /*!< Last time we told the user their position */
+	int opos;			/*!< Where we started in the queue */
+	int handled;			/*!< Whether our call was handled */
+	time_t start;			/*!< When we started holding */
+	time_t expire;			/*!< When this entry should expire (time out of queue) */
+	struct ast_channel *chan;	/*!< Our channel */
+	struct queue_ent *next;		/*!< The next queue entry */
 };
 
 struct member {
-	char interface[80];		/* Technology/Location */
-	int penalty;			/* Are we a last resort? */
-	int calls;			/* Number of calls serviced by this member */
-	int dynamic;			/* Are we dynamically added? */
-	int status;			/* Status of queue member */
-	int paused;			/* Are we paused (not accepting calls)? */
-	time_t lastcall;		/* When last successful call was hungup */
-	int dead;			/* Used to detect members deleted in realtime */
-	struct member *next;		/* Next member */
+	char interface[80];		/*!< Technology/Location */
+	int penalty;			/*!< Are we a last resort? */
+	int calls;			/*!< Number of calls serviced by this member */
+	int dynamic;			/*!< Are we dynamically added? */
+	int status;			/*!< Status of queue member */
+	int paused;			/*!< Are we paused (not accepting calls)? */
+	time_t lastcall;		/*!< When last successful call was hungup */
+	int dead;			/*!< Used to detect members deleted in realtime */
+	struct member *next;		/*!< Next member */
 };
 
 /* values used in multi-bit flags in ast_call_queue */
@@ -282,10 +285,10 @@
 
 struct ast_call_queue {
 	ast_mutex_t lock;	
-	char name[80];			/* Name */
-	char moh[80];			/* Music On Hold class to be used */
-	char announce[80];		/* Announcement to play when call is answered */
-	char context[AST_MAX_CONTEXT];	/* Exit context */
+	char name[80];			/*!< Name */
+	char moh[80];			/*!< Music On Hold class to be used */
+	char announce[80];		/*!< Announcement to play when call is answered */
+	char context[AST_MAX_CONTEXT];	/*!< Exit context */
 		unsigned int monjoin:1;
 		unsigned int dead:1;
 		unsigned int joinempty:2;
@@ -298,41 +301,41 @@
 		unsigned int strategy:3;
 		unsigned int maskmemberstatus:1;
 		unsigned int realtime:1;
-	int announcefrequency;          /* How often to announce their position */
-	int periodicannouncefrequency;	/* How often to play periodic announcement */
-	int roundingseconds;            /* How many seconds do we round to? */
-	int holdtime;                   /* Current avg holdtime, based on recursive boxcar filter */
-	int callscompleted;             /* Number of queue calls completed */
-	int callsabandoned;             /* Number of queue calls abandoned */
-	int servicelevel;               /* seconds setting for servicelevel*/
-	int callscompletedinsl;         /* Number of calls answered with servicelevel*/
-	char monfmt[8];                 /* Format to use when recording calls */
-	char sound_next[80];            /* Sound file: "Your call is now first in line" (def. queue-youarenext) */
-	char sound_thereare[80];        /* Sound file: "There are currently" (def. queue-thereare) */
-	char sound_calls[80];           /* Sound file: "calls waiting to speak to a representative." (def. queue-callswaiting)*/
-	char sound_holdtime[80];        /* Sound file: "The current estimated total holdtime is" (def. queue-holdtime) */
-	char sound_minutes[80];         /* Sound file: "minutes." (def. queue-minutes) */
-	char sound_lessthan[80];        /* Sound file: "less-than" (def. queue-lessthan) */
-	char sound_seconds[80];         /* Sound file: "seconds." (def. queue-seconds) */
-	char sound_thanks[80];          /* Sound file: "Thank you for your patience." (def. queue-thankyou) */
-	char sound_reporthold[80];	/* Sound file: "Hold time" (def. queue-reporthold) */
-	char sound_periodicannounce[80];/* Sound file: Custom announce, no default */
-
-	int count;			/* How many entries */
-	int maxlen;			/* Max number of entries */
-	int wrapuptime;			/* Wrapup Time */
-
-	int retry;			/* Retry calling everyone after this amount of time */
-	int timeout;			/* How long to wait for an answer */
-	int weight;                     /* Respective weight */
+	int announcefrequency;          /*!< How often to announce their position */
+	int periodicannouncefrequency;	/*!< How often to play periodic announcement */
+	int roundingseconds;            /*!< How many seconds do we round to? */
+	int holdtime;                   /*!< Current avg holdtime, based on recursive boxcar filter */
+	int callscompleted;             /*!< Number of queue calls completed */
+	int callsabandoned;             /*!< Number of queue calls abandoned */
+	int servicelevel;               /*!< seconds setting for servicelevel*/
+	int callscompletedinsl;         /*!< Number of calls answered with servicelevel*/
+	char monfmt[8];                 /*!< Format to use when recording calls */
+	char sound_next[80];            /*!< Sound file: "Your call is now first in line" (def. queue-youarenext) */
+	char sound_thereare[80];        /*!< Sound file: "There are currently" (def. queue-thereare) */
+	char sound_calls[80];           /*!< Sound file: "calls waiting to speak to a representative." (def. queue-callswaiting)*/
+	char sound_holdtime[80];        /*!< Sound file: "The current estimated total holdtime is" (def. queue-holdtime) */
+	char sound_minutes[80];         /*!< Sound file: "minutes." (def. queue-minutes) */
+	char sound_lessthan[80];        /*!< Sound file: "less-than" (def. queue-lessthan) */
+	char sound_seconds[80];         /*!< Sound file: "seconds." (def. queue-seconds) */
+	char sound_thanks[80];          /*!< Sound file: "Thank you for your patience." (def. queue-thankyou) */
+	char sound_reporthold[80];	/*!< Sound file: "Hold time" (def. queue-reporthold) */
+	char sound_periodicannounce[80];/*!< Sound file: Custom announce, no default */
+
+	int count;			/*!< How many entries */
+	int maxlen;			/*!< Max number of entries */
+	int wrapuptime;			/*!< Wrapup Time */
+
+	int retry;			/*!< Retry calling everyone after this amount of time */
+	int timeout;			/*!< How long to wait for an answer */
+	int weight;                     /*!< Respective weight */
 	
 	/* Queue strategy things */
-	int rrpos;			/* Round Robin - position */
-	int memberdelay;		/* Seconds to delay connecting member to caller */
+	int rrpos;			/*!< Round Robin - position */
+	int memberdelay;		/*!< Seconds to delay connecting member to caller */
 
-	struct member *members;		/* Head of the list of members */
-	struct queue_ent *head;		/* Head of the list of callers */
-	struct ast_call_queue *next;	/* Next call queue */
+	struct member *members;		/*!< Head of the list of members */
+	struct queue_ent *head;		/*!< Head of the list of callers */
+	struct ast_call_queue *next;	/*!< Next call queue */
 };
 
 static struct ast_call_queue *queues = NULL;
@@ -370,7 +373,7 @@
 	return -1;
 }
 
-/* Insert the 'new' entry after the 'prev' entry of queue 'q' */
+/*! \brief Insert the 'new' entry after the 'prev' entry of queue 'q' */
 static inline void insert_entry(struct ast_call_queue *q, struct queue_ent *prev, struct queue_ent *new, int *pos)
 {
 	struct queue_ent *cur;
@@ -565,7 +568,8 @@
 	q->wrapuptime = 0;
 }
 
-/* Configure a queue parameter.
+/*! \brief Configure a queue parameter.
+\par
    For error reporting, line number is passed for .conf static configuration.
    For Realtime queues, linenum is -1.
    The failunknown flag is set for config files (and static realtime) to show
@@ -727,8 +731,9 @@
 }
 
 
-/* Reload a single queue via realtime. Return the queue, or NULL if it doesn't exist.
-   Should be called with the global qlock locked.
+/*!\brief Reload a single queue via realtime.
+   \return Return the queue, or NULL if it doesn't exist.
+   \note Should be called with the global qlock locked.
    When found, the queue is returned with q->lock locked. */
 static struct ast_call_queue *reload_queue_rt(const char *queuename, struct ast_variable *queue_vars, struct ast_config *member_config)
 {
@@ -769,7 +774,7 @@
 	if (!queue_vars) {
 		/* Delete queue from in-core list if it has been deleted in realtime. */
 		if (q) {
-			/* Hmm, can't seem to distinguish a DB failure from a not
+			/*! \note Hmm, can't seem to distinguish a DB failure from a not
 			   found condition... So we might delete an in-core queue
 			   in case of DB failure. */
 			ast_log(LOG_DEBUG, "Queue %s not found in realtime.\n", queuename);
@@ -865,7 +870,7 @@
 	int inserted = 0;
 	enum queue_member_status stat;
 
-	/* Load from realtime before taking the global qlock, to avoid blocking all
+	/*! \note Load from realtime before taking the global qlock, to avoid blocking all
 	   queue operations while waiting for the DB.
 
 	   This will be two separate database transactions, so we might
@@ -3314,7 +3319,9 @@
 	return q ? strdup(q->name) : NULL;
 }
 
-/* JDG: callback to display queues status in manager */
+/*!\brief callback to display queues status in manager 
+   \addtogroup Group_AMI 
+ */
 static int manager_queues_show( struct mansession *s, struct message *m )
 {
 	char *a[] = { "show", "queues" };
Index: apps/app_random.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_random.c,v
retrieving revision 1.12
diff -u -r1.12 app_random.c
--- apps/app_random.c	26 Oct 2005 19:48:14 -0000	1.12
+++ apps/app_random.c	4 Nov 2005 13:17:19 -0000
@@ -20,6 +20,7 @@
  * \brief Random application
  *
  * \author Tilghman Lesher <asterisk__app_random__200508@the-tilghman.com>
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_read.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_read.c,v
retrieving revision 1.26
diff -u -r1.26 app_read.c
--- apps/app_read.c	26 Oct 2005 19:48:14 -0000	1.26
+++ apps/app_read.c	4 Nov 2005 13:17:19 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Trivial application to read a variable
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_readfile.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_readfile.c,v
retrieving revision 1.12
diff -u -r1.12 app_readfile.c
--- apps/app_readfile.c	26 Oct 2005 19:48:14 -0000	1.12
+++ apps/app_readfile.c	4 Nov 2005 13:17:19 -0000
@@ -20,6 +20,7 @@
  *
  * \brief ReadFile application -- Reads in a File for you.
  *
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_realtime.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_realtime.c,v
retrieving revision 1.16
diff -u -r1.16 app_realtime.c
--- apps/app_realtime.c	26 Oct 2005 19:48:14 -0000	1.16
+++ apps/app_realtime.c	4 Nov 2005 13:17:19 -0000
@@ -21,6 +21,7 @@
  *
  * \brief RealTime App
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_record.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_record.c,v
retrieving revision 1.42
diff -u -r1.42 app_record.c
--- apps/app_record.c	1 Nov 2005 17:22:25 -0000	1.42
+++ apps/app_record.c	4 Nov 2005 13:17:19 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Trivial application to record a sound file
  *
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_rpt.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_rpt.c,v
retrieving revision 1.46
diff -u -r1.46 app_rpt.c
--- apps/app_rpt.c	26 Oct 2005 19:48:14 -0000	1.46
+++ apps/app_rpt.c	4 Nov 2005 13:17:22 -0000
@@ -17,15 +17,17 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Radio Repeater / Remote Base program 
+ * \brief Radio Repeater / Remote Base program 
+ * \author Jim Dixon, WB6NIL <jim@lambdatel.com>
  *  version 0.36 10/26/05
+ * \ingroup applications
  * 
- * See http://www.zapatatelephony.org/app_rpt.html
+ * \arg See http://www.zapatatelephony.org/app_rpt.html
  *
  *
- * Repeater / Remote Functions:
+ * \par Repeater / Remote Functions:
  * "Simple" Mode:  * - autopatch access, # - autopatch hangup
  * Normal mode:
  * See the function list in rpt.conf
Index: apps/app_sayunixtime.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_sayunixtime.c,v
retrieving revision 1.14
diff -u -r1.14 app_sayunixtime.c
--- apps/app_sayunixtime.c	24 Oct 2005 20:12:05 -0000	1.14
+++ apps/app_sayunixtime.c	4 Nov 2005 13:17:22 -0000
@@ -19,6 +19,7 @@
  *
  * \brief SayUnixTime application
  * 
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_senddtmf.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_senddtmf.c,v
retrieving revision 1.15
diff -u -r1.15 app_senddtmf.c
--- apps/app_senddtmf.c	26 Oct 2005 19:48:14 -0000	1.15
+++ apps/app_senddtmf.c	4 Nov 2005 13:17:22 -0000
@@ -20,6 +20,7 @@
  *
  * \brief App to send DTMF digits
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_sendtext.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_sendtext.c,v
retrieving revision 1.13
diff -u -r1.13 app_sendtext.c
--- apps/app_sendtext.c	26 Oct 2005 19:48:14 -0000	1.13
+++ apps/app_sendtext.c	4 Nov 2005 13:17:22 -0000
@@ -20,6 +20,9 @@
  *
  * \brief App to transmit a text message
  * 
+ * Requires support of sending text messages from channel driver
+ *
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_setcallerid.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setcallerid.c,v
retrieving revision 1.14
diff -u -r1.14 app_setcallerid.c
--- apps/app_setcallerid.c	26 Oct 2005 19:48:14 -0000	1.14
+++ apps/app_setcallerid.c	4 Nov 2005 13:17:22 -0000
@@ -20,6 +20,7 @@
  *
  * \brief App to set callerid
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_setcdruserfield.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setcdruserfield.c,v
retrieving revision 1.12
diff -u -r1.12 app_setcdruserfield.c
--- apps/app_setcdruserfield.c	24 Oct 2005 20:12:05 -0000	1.12
+++ apps/app_setcdruserfield.c	4 Nov 2005 13:17:22 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Applictions connected with CDR engine
  * 
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_setcidname.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setcidname.c,v
retrieving revision 1.15
diff -u -r1.15 app_setcidname.c
--- apps/app_setcidname.c	26 Oct 2005 19:48:14 -0000	1.15
+++ apps/app_setcidname.c	4 Nov 2005 13:17:22 -0000
@@ -20,6 +20,7 @@
  *
  * \brief App to set callerid
  *
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_setcidnum.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setcidnum.c,v
retrieving revision 1.15
diff -u -r1.15 app_setcidnum.c
--- apps/app_setcidnum.c	24 Oct 2005 20:12:05 -0000	1.15
+++ apps/app_setcidnum.c	4 Nov 2005 13:17:22 -0000
@@ -21,6 +21,7 @@
  *
  * \brief App to set callerid number
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_setrdnis.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setrdnis.c,v
retrieving revision 1.10
diff -u -r1.10 app_setrdnis.c
--- apps/app_setrdnis.c	24 Oct 2005 20:12:05 -0000	1.10
+++ apps/app_setrdnis.c	4 Nov 2005 13:17:22 -0000
@@ -21,6 +21,7 @@
  *
  * \brief App to set rdnis
  *
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_settransfercapability.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_settransfercapability.c,v
retrieving revision 1.10
diff -u -r1.10 app_settransfercapability.c
--- apps/app_settransfercapability.c	24 Oct 2005 20:12:05 -0000	1.10
+++ apps/app_settransfercapability.c	4 Nov 2005 13:17:22 -0000
@@ -20,6 +20,7 @@
  *
  * \brief App to set the ISDN Transfer Capability
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_skel.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_skel.c,v
retrieving revision 1.17
diff -u -r1.17 app_skel.c
--- apps/app_skel.c	26 Oct 2005 19:48:14 -0000	1.17
+++ apps/app_skel.c	4 Nov 2005 13:17:22 -0000
@@ -20,6 +20,8 @@
  *
  * \brief Skeleton application
  * 
+ * This is a skeleton for development of an Asterisk application */
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_sms.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_sms.c,v
retrieving revision 1.30
diff -u -r1.30 app_sms.c
--- apps/app_sms.c	24 Oct 2005 20:12:05 -0000	1.30
+++ apps/app_sms.c	4 Nov 2005 13:17:23 -0000
@@ -17,6 +17,7 @@
 /*! \file
  *
  * \brief SMS application - ETSI ES 201 912 protocol 1 implimentation
+ * \ingroup applications
  * 
  */
 
Index: apps/app_softhangup.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_softhangup.c,v
retrieving revision 1.13
diff -u -r1.13 app_softhangup.c
--- apps/app_softhangup.c	26 Oct 2005 19:48:14 -0000	1.13
+++ apps/app_softhangup.c	4 Nov 2005 13:17:23 -0000
@@ -20,6 +20,7 @@
  *
  * \brief SoftHangup application
  * 
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_sql_postgres.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_sql_postgres.c,v
retrieving revision 1.17
diff -u -r1.17 app_sql_postgres.c
--- apps/app_sql_postgres.c	26 Oct 2005 19:48:14 -0000	1.17
+++ apps/app_sql_postgres.c	4 Nov 2005 13:17:23 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Connect to PostgreSQL
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_striplsd.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_striplsd.c,v
retrieving revision 1.10
diff -u -r1.10 app_striplsd.c
--- apps/app_striplsd.c	24 Oct 2005 20:12:05 -0000	1.10
+++ apps/app_striplsd.c	4 Nov 2005 13:17:23 -0000
@@ -20,6 +20,7 @@
  *
  * \brief striplsd: Strip trailing digits app
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_substring.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_substring.c,v
retrieving revision 1.15
diff -u -r1.15 app_substring.c
--- apps/app_substring.c	24 Oct 2005 20:12:05 -0000	1.15
+++ apps/app_substring.c	4 Nov 2005 13:17:23 -0000
@@ -20,6 +20,7 @@
  *
  * \brief substr
  *
+ * \ingroup applications
  * \todo Deprecate this application in 1.3dev
  */
 
Index: apps/app_system.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_system.c,v
retrieving revision 1.22
diff -u -r1.22 app_system.c
--- apps/app_system.c	26 Oct 2005 19:48:14 -0000	1.22
+++ apps/app_system.c	4 Nov 2005 13:17:23 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Execute arbitrary system commands
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_talkdetect.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_talkdetect.c,v
retrieving revision 1.17
diff -u -r1.17 app_talkdetect.c
--- apps/app_talkdetect.c	26 Oct 2005 19:48:14 -0000	1.17
+++ apps/app_talkdetect.c	4 Nov 2005 13:17:23 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Playback a file with audio detect
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_test.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_test.c,v
retrieving revision 1.16
diff -u -r1.16 app_test.c
--- apps/app_test.c	26 Oct 2005 19:48:14 -0000	1.16
+++ apps/app_test.c	4 Nov 2005 13:17:24 -0000
@@ -21,6 +21,7 @@
  *
  * \brief Applications to test connection and produce report in text file
  * 
+ * \ingroup applications
  */
 
 #include <sys/types.h>
Index: apps/app_transfer.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_transfer.c,v
retrieving revision 1.18
diff -u -r1.18 app_transfer.c
--- apps/app_transfer.c	26 Oct 2005 19:48:14 -0000	1.18
+++ apps/app_transfer.c	4 Nov 2005 13:17:24 -0000
@@ -20,6 +20,9 @@
  *
  * \brief Transfer a caller
  * 
+ * Requires transfer support from channel driver
+ *
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_txtcidname.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_txtcidname.c,v
retrieving revision 1.22
diff -u -r1.22 app_txtcidname.c
--- apps/app_txtcidname.c	26 Oct 2005 19:48:14 -0000	1.22
+++ apps/app_txtcidname.c	4 Nov 2005 13:17:24 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Caller*id name lookup - Look up the caller's name via DNS
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_url.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_url.c,v
retrieving revision 1.15
diff -u -r1.15 app_url.c
--- apps/app_url.c	26 Oct 2005 19:48:14 -0000	1.15
+++ apps/app_url.c	4 Nov 2005 13:17:24 -0000
@@ -19,6 +19,7 @@
 /*! \file
  * \brief App to transmit a URL
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_userevent.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_userevent.c,v
retrieving revision 1.11
diff -u -r1.11 app_userevent.c
--- apps/app_userevent.c	26 Oct 2005 19:48:14 -0000	1.11
+++ apps/app_userevent.c	4 Nov 2005 13:17:24 -0000
@@ -18,6 +18,7 @@
  *
  * \brief UserEvent application -- send manager event
  * 
+ * \ingroup applications
  */
 
 
Index: apps/app_verbose.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_verbose.c,v
retrieving revision 1.9
diff -u -r1.9 app_verbose.c
--- apps/app_verbose.c	24 Oct 2005 20:12:05 -0000	1.9
+++ apps/app_verbose.c	4 Nov 2005 13:17:24 -0000
@@ -19,6 +19,7 @@
  *
  * \brief Verbose logging application
  *
+ * \ingroup applications
  */
 
 #include <stdio.h>
Index: apps/app_voicemail.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_voicemail.c,v
retrieving revision 1.258
diff -u -r1.258 app_voicemail.c
--- apps/app_voicemail.c	1 Nov 2005 02:20:30 -0000	1.258
+++ apps/app_voicemail.c	4 Nov 2005 13:17:27 -0000
@@ -29,6 +29,9 @@
  *
  * \brief Comedian Mail - Voicemail System
  * 
+ * \par See also
+ * \arg \ref Config_vm
+ * \ingroup applications
  */
 
 #include <stdlib.h>
@@ -126,59 +129,62 @@
 
 static int load_config(void);
 
-/* Syntaxes supported, not really language codes.
-	en - English
-	de - German
-	es - Spanish
-	fr - French
-	it = Italian
-	nl - Dutch
-	pt - Portuguese
-	gr - Greek
-	no - Norwegian
-	se - Swedish
+/*! \page vmlang Voicemail Language Syntaxes Supported
+
+	\par Syntaxes supported, not really language codes.
+	\arg \b en - English
+	\arg \b de - German
+	\arg \b es - Spanish
+	\arg \b fr - French
+	\arg \b it = Italian
+	\arg \b nl - Dutch
+	\arg \b pt - Portuguese
+	\arg \b gr - Greek
+	\arg \b no - Norwegian
+	\arg \b se - Swedish
 
 German requires the following additional soundfile:
-1F	einE (feminine)
+\arg \b 1F	einE (feminine)
 
 Spanish requires the following additional soundfile:
-1M      un (masculine)
+\arg \b 1M      un (masculine)
 
 Dutch, Portuguese & Spanish require the following additional soundfiles:
-vm-INBOXs	singular of 'new'
-vm-Olds		singular of 'old/heard/read'
+\arg \b vm-INBOXs	singular of 'new'
+\arg \b vm-Olds		singular of 'old/heard/read'
 
 NB these are plural:
-vm-INBOX	nieuwe (nl)
-vm-Old		oude (nl)
+\arg \b vm-INBOX	nieuwe (nl)
+\arg \b vm-Old		oude (nl)
 
 Swedish uses:
-vm-nytt		singular of 'new'
-vm-nya		plural of 'new'
-vm-gammalt	singular of 'old'
-vm-gamla	plural of 'old'
-digits/ett	'one', not always same as 'digits/1'
+\arg \b vm-nytt		singular of 'new'
+\arg \b vm-nya		plural of 'new'
+\arg \b vm-gammalt	singular of 'old'
+\arg \b vm-gamla	plural of 'old'
+\arg \b digits/ett	'one', not always same as 'digits/1'
 
 Norwegian uses:
-vm-ny		singular of 'new'
-vm-nye		plural of 'new'
-vm-gammel	singular of 'old'
-vm-gamle	plural of 'old'
+\arg \b vm-ny		singular of 'new'
+\arg \b vm-nye		plural of 'new'
+\arg \b vm-gammel	singular of 'old'
+\arg \b vm-gamle	plural of 'old'
 
 Dutch also uses:
-nl-om		'at'?
+\arg \b nl-om		'at'?
 
 Spanish also uses:
-vm-youhaveno
+\arg \b vm-youhaveno
 
 Italian requires the following additional soundfile:
 
 For vm_intro_it:
-vm-nuovo	new
-vm-nuovi	new plural
-vm-vecchio	old
-vm-vecchi	old plural
-Don't use vm-INBOX or vm-Old, because they are the name of the INBOX and Old folders,
+\arg \b vm-nuovo	new
+\arg \b vm-nuovi	new plural
+\arg \b vm-vecchio	old
+\arg \b vm-vecchi	old plural
+
+\note Don't use vm-INBOX or vm-Old, because they are the name of the INBOX and Old folders,
 spelled among others when you have to change folder. For the above reasons, vm-INBOX
 and vm-Old are spelled plural, to make them sound more as folder name than an adjective.
 
@@ -192,25 +198,25 @@
 	unsigned char iobuf[BASEMAXINLINE];
 };
 
-/* Structure for linked list of users */
+/*! Structure for linked list of users */
 struct ast_vm_user {
-	char context[AST_MAX_CONTEXT];	/* Voicemail context */
-	char mailbox[AST_MAX_EXTENSION];/* Mailbox id, unique within vm context */
-	char password[80];		/* Secret pin code, numbers only */
-	char fullname[80];		/* Full name, for directory app */
-	char email[80];			/* E-mail address */
-	char pager[80];			/* E-mail address to pager (no attachment) */
-	char serveremail[80];		/* From: Mail address */
-	char mailcmd[160];		/* Configurable mail command */
-	char language[MAX_LANGUAGE];    /* Config: Language setting */
-	char zonetag[80];		/* Time zone */
+	char context[AST_MAX_CONTEXT];	/*!< Voicemail context */
+	char mailbox[AST_MAX_EXTENSION];/*!< Mailbox id, unique within vm context */
+	char password[80];		/*!< Secret pin code, numbers only */
+	char fullname[80];		/*!< Full name, for directory app */
+	char email[80];			/*!< E-mail address */
+	char pager[80];			/*!< E-mail address to pager (no attachment) */
+	char serveremail[80];		/*!< From: Mail address */
+	char mailcmd[160];		/*!< Configurable mail command */
+	char language[MAX_LANGUAGE];    /*!< Config: Language setting */
+	char zonetag[80];		/*!< Time zone */
 	char callback[80];
 	char dialout[80];
-	char uniqueid[20];		/* Unique integer identifier */
+	char uniqueid[20];		/*!< Unique integer identifier */
 	char exit[80];
-	unsigned int flags;		/* VM_ flags */	
+	unsigned int flags;		/*!< VM_ flags */	
 	int saydurationm;
-	int maxmsg;			/* Maximum number of msgs per folder for this mailbox */
+	int maxmsg;			/*!< Maximum number of msgs per folder for this mailbox */
 	struct ast_vm_user *next;
 };
 
Index: apps/app_waitforring.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_waitforring.c,v
retrieving revision 1.10
diff -u -r1.10 app_waitforring.c
--- apps/app_waitforring.c	24 Oct 2005 20:12:05 -0000	1.10
+++ apps/app_waitforring.c	4 Nov 2005 13:17:27 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Wait for Ring Application
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_waitforsilence.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_waitforsilence.c,v
retrieving revision 1.12
diff -u -r1.12 app_waitforsilence.c
--- apps/app_waitforsilence.c	24 Oct 2005 20:12:05 -0000	1.12
+++ apps/app_waitforsilence.c	4 Nov 2005 13:17:27 -0000
@@ -22,10 +22,11 @@
 /*! \file
  *
  * \brief Wait for Silence
- *   - Waits for up to 'x' milliseconds of silence, 'y' times
- *   - WaitForSilence(500,2) will wait for 1/2 second of silence, twice
- *   - WaitForSilence(1000,1) will wait for 1 second of silence, once
+ *   - Waits for up to 'x' milliseconds of silence, 'y' times \n
+ *   - WaitForSilence(500,2) will wait for 1/2 second of silence, twice \n
+ *   - WaitForSilence(1000,1) will wait for 1 second of silence, once \n
  *
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_while.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_while.c,v
retrieving revision 1.14
diff -u -r1.14 app_while.c
--- apps/app_while.c	26 Oct 2005 19:48:14 -0000	1.14
+++ apps/app_while.c	4 Nov 2005 13:17:27 -0000
@@ -20,6 +20,7 @@
  *
  * \brief While Loop and ExecIf Implementations
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_zapateller.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_zapateller.c,v
retrieving revision 1.14
diff -u -r1.14 app_zapateller.c
--- apps/app_zapateller.c	26 Oct 2005 19:48:14 -0000	1.14
+++ apps/app_zapateller.c	4 Nov 2005 13:17:27 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Playback the special information tone to get rid of telemarketers
  * 
+ * \ingroup applications
  */
  
 #include <string.h>
Index: apps/app_zapbarge.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_zapbarge.c,v
retrieving revision 1.14
diff -u -r1.14 app_zapbarge.c
--- apps/app_zapbarge.c	26 Oct 2005 19:48:14 -0000	1.14
+++ apps/app_zapbarge.c	4 Nov 2005 13:17:27 -0000
@@ -23,6 +23,7 @@
  *
  * \brief Zap Barge support
  * 
+ * \ingroup applications
  */
 
 #include <stdlib.h>
Index: apps/app_zapras.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_zapras.c,v
retrieving revision 1.16
diff -u -r1.16 app_zapras.c
--- apps/app_zapras.c	24 Oct 2005 20:12:05 -0000	1.16
+++ apps/app_zapras.c	4 Nov 2005 13:17:27 -0000
@@ -20,6 +20,7 @@
  *
  * \brief Execute an ISDN RAS
  * 
+ * \ingroup applications
  */
 
 #include <sys/ioctl.h>
Index: apps/app_zapscan.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_zapscan.c,v
retrieving revision 1.23
diff -u -r1.23 app_zapscan.c
--- apps/app_zapscan.c	24 Oct 2005 20:12:05 -0000	1.23
+++ apps/app_zapscan.c	4 Nov 2005 13:17:28 -0000
@@ -25,6 +25,7 @@
  *
  * \brief Zap Scanner
  *
+ * \ingroup applications
  */
 
 #include <stdlib.h>