Index: acl.c =================================================================== RCS file: /usr/cvsroot/asterisk/acl.c,v retrieving revision 1.57 diff -u -r1.57 acl.c --- acl.c 14 Sep 2005 20:46:49 -0000 1.57 +++ acl.c 24 Oct 2005 15:23:27 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Various sorts of access control + * \brief Various sorts of access control * */ Index: aescrypt.c =================================================================== RCS file: /usr/cvsroot/asterisk/aescrypt.c,v retrieving revision 1.2 diff -u -r1.2 aescrypt.c --- aescrypt.c 7 Jan 2004 20:45:50 -0000 1.2 +++ aescrypt.c 24 Oct 2005 15:23:27 -0000 @@ -30,7 +30,9 @@ --------------------------------------------------------------------------- Issue Date: 26/08/2003 - This file contains the code for implementing encryption and decryption +*/ +/*! \file +\brief This file contains the code for implementing encryption and decryption for AES (Rijndael) for block and key sizes of 16, 24 and 32 bytes. It can optionally be replaced by code written in assembler using NASM. For further details see the file aesopt.h Index: aeskey.c =================================================================== RCS file: /usr/cvsroot/asterisk/aeskey.c,v retrieving revision 1.2 diff -u -r1.2 aeskey.c --- aeskey.c 7 Jan 2004 20:45:50 -0000 1.2 +++ aeskey.c 24 Oct 2005 15:23:27 -0000 @@ -30,7 +30,9 @@ --------------------------------------------------------------------------- Issue Date: 26/08/2003 - This file contains the code for implementing the key schedule for AES +*/ +/*! \file +\brief This file contains the code for implementing the key schedule for AES (Rijndael) for block and key sizes of 16, 24, and 32 bytes. See aesopt.h for further details including optimisation. */ Index: alaw.c =================================================================== RCS file: /usr/cvsroot/asterisk/alaw.c,v retrieving revision 1.5 diff -u -r1.5 alaw.c --- alaw.c 14 Sep 2005 20:46:49 -0000 1.5 +++ alaw.c 24 Oct 2005 15:23:27 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * u-Law to Signed linear conversion + * \brief u-Law to Signed linear conversion * */ Index: app.c =================================================================== RCS file: /usr/cvsroot/asterisk/app.c,v retrieving revision 1.76 diff -u -r1.76 app.c --- app.c 14 Sep 2005 20:46:49 -0000 1.76 +++ app.c 24 Oct 2005 15:23:28 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Convenient Application Routines + * \brief Convenient Application Routines * */ Index: asterisk.c =================================================================== RCS file: /usr/cvsroot/asterisk/asterisk.c,v retrieving revision 1.183 diff -u -r1.183 asterisk.c --- asterisk.c 29 Sep 2005 02:38:24 -0000 1.183 +++ asterisk.c 24 Oct 2005 15:23:28 -0000 @@ -1,10 +1,19 @@ -/* - * Asterisk -- An open source telephony toolkit. +/*! + * \mainpage Asterisk -- An Open Source Telephony Toolkit + * \image html asterisk-logo.gif + * + * \arg \ref DevDoc + * \arg \ref ConfigFiles + * + * \section copyright Copyright and author * * Copyright (C) 1999 - 2005, Digium, Inc. + * Asterisk is a trade mark registered by Digium, Inc. * - * Mark Spencer + * \author Mark Spencer + * Also see \ref AstCREDITS * + * \section license License * 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; @@ -14,12 +23,15 @@ * 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. + * + * \verbinclude LICENSE + * */ -/* - * - * Top level source file for asterisk - * +/*! \file + \brief Top level source file for Asterisk - the Open Source PBX. Implementation + of PBX core functions and CLI interface. + */ #include @@ -78,6 +90,8 @@ #include "asterisk/linkedlists.h" #include "asterisk/devicestate.h" +#include "asterisk/doxyref.h" /* Doxygen documentation */ + #include "defaults.h" #ifndef AF_LOCAL @@ -116,19 +130,20 @@ char record_cache_dir[AST_CACHE_DIR_LEN] = AST_TMP_DIR; char debug_filename[AST_FILENAME_MAX] = ""; -static int ast_socket = -1; /* UNIX Socket for allowing remote control */ -static int ast_consock = -1; /* UNIX Socket for controlling another asterisk */ +static int ast_socket = -1; /*!< UNIX Socket for allowing remote control */ +static int ast_consock = -1; /*!< UNIX Socket for controlling another asterisk */ int ast_mainpid; struct console { - int fd; /* File descriptor */ - int p[2]; /* Pipe */ - pthread_t t; /* Thread of handler */ + int fd; /*!< File descriptor */ + int p[2]; /*!< Pipe */ + pthread_t t; /*!< Thread of handler */ }; static struct ast_atexit { void (*func)(void); struct ast_atexit *next; } *atexits = NULL; + AST_MUTEX_DEFINE_STATIC(atexitslock); time_t ast_startuptime; @@ -222,6 +237,7 @@ " Shows the revision numbers of the files used to build this copy of Asterisk.\n" " Optional regular expression pattern is used to filter the file list.\n"; +/*! CLI command to list module versions */ static int handle_show_version_files(int fd, int argc, char *argv[]) { #define FORMAT "%-25.25s %-40.40s\n" @@ -343,7 +359,7 @@ return write(fd, s, strlen(s) + 1); } -/* NULL handler so we can collect the child exit status */ +/*! NULL handler so we can collect the child exit status */ static void null_sig_handler(int signal) { @@ -408,7 +424,7 @@ return res; } -/* +/*! * write the string to all attached console clients */ static void ast_network_puts(const char *string) @@ -420,7 +436,7 @@ } } -/* +/*! * write the string to the console, and all attached * console clients */ @@ -657,13 +673,15 @@ return 1; } +/*! Urgent handler + Called by soft_hangup to interrupt the poll, read, or other + system call. We don't actually need to do anything though. + Remember: Cannot EVER ast_log from within a signal handler + SLD: seems to be some pthread activity relating to the printf anyway: + which is leading to a deadlock? + */ static void urg_handler(int num) { - /* Called by soft_hangup to interrupt the poll, read, or other - system call. We don't actually need to do anything though. */ - /* Cannot EVER ast_log from within a signal handler */ - /* SLD: seems to be some pthread activity relating to the printf anyway: - * which is leading to a deadlock? */ #if 0 if (option_debug > 2) printf("-- Asterisk Urgent handler\n"); @@ -698,9 +716,9 @@ signal(sig, child_handler); } +/*! Set an X-term or screen title */ static void set_title(char *text) { - /* Set an X-term or screen title */ if (getenv("TERM") && strstr(getenv("TERM"), "xterm")) fprintf(stdout, "\033]2;%s\007", text); } @@ -711,12 +729,12 @@ fprintf(stdout, "\033]1;%s\007", text); } +/*! We set ourselves to a high priority, that we might pre-empt everything + else. If your PBX has heavy activity on it, this is a good thing. */ int ast_set_priority(int pri) { struct sched_param sched; memset(&sched, 0, sizeof(sched)); - /* We set ourselves to a high priority, that we might pre-empt everything - else. If your PBX has heavy activity on it, this is a good thing. */ #ifdef __linux__ if (pri) { sched.sched_priority = 10; Index: astmm.c =================================================================== RCS file: /usr/cvsroot/asterisk/astmm.c,v retrieving revision 1.22 diff -u -r1.22 astmm.c --- astmm.c 29 Sep 2005 04:34:11 -0000 1.22 +++ astmm.c 24 Oct 2005 15:23:28 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Memory Management + * \brief Memory Management * */ Index: autoservice.c =================================================================== RCS file: /usr/cvsroot/asterisk/autoservice.c,v retrieving revision 1.14 diff -u -r1.14 autoservice.c --- autoservice.c 14 Sep 2005 20:46:49 -0000 1.14 +++ autoservice.c 24 Oct 2005 15:23:28 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Automatic channel service routines + * \brief Automatic channel service routines * */ Index: callerid.c =================================================================== RCS file: /usr/cvsroot/asterisk/callerid.c,v retrieving revision 1.36 diff -u -r1.36 callerid.c --- callerid.c 14 Sep 2005 20:46:49 -0000 1.36 +++ callerid.c 24 Oct 2005 15:23:28 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * CallerID Generation support + * \brief CallerID Generation support * */ Index: cdr.c =================================================================== RCS file: /usr/cvsroot/asterisk/cdr.c,v retrieving revision 1.53 diff -u -r1.53 cdr.c --- cdr.c 14 Sep 2005 20:46:49 -0000 1.53 +++ cdr.c 24 Oct 2005 15:23:28 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Call Detail Record API + * \brief Call Detail Record API * * Includes code and algorithms from the Zapata library. * Index: channel.c =================================================================== RCS file: /usr/cvsroot/asterisk/channel.c,v retrieving revision 1.251 diff -u -r1.251 channel.c --- channel.c 20 Oct 2005 22:45:47 -0000 1.251 +++ channel.c 24 Oct 2005 15:23:29 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Channel Management + * \brief Channel Management * */ Index: chanvars.c =================================================================== RCS file: /usr/cvsroot/asterisk/chanvars.c,v retrieving revision 1.12 diff -u -r1.12 chanvars.c --- chanvars.c 5 Oct 2005 21:11:17 -0000 1.12 +++ chanvars.c 24 Oct 2005 15:23:29 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Channel Variables + * \brief Channel Variables * */ Index: cli.c =================================================================== RCS file: /usr/cvsroot/asterisk/cli.c,v retrieving revision 1.101 diff -u -r1.101 cli.c --- cli.c 11 Oct 2005 20:20:40 -0000 1.101 +++ cli.c 24 Oct 2005 15:23:29 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Standard Command Line Interface + * \brief Standard Command Line Interface * */ Index: config.c =================================================================== RCS file: /usr/cvsroot/asterisk/config.c,v retrieving revision 1.78 diff -u -r1.78 config.c --- config.c 17 Oct 2005 13:53:50 -0000 1.78 +++ config.c 24 Oct 2005 15:23:29 -0000 @@ -16,10 +16,12 @@ * at the top of the source tree. */ -/* +/*! \file * - * Configuration File Parser - * + * \brief Configuration File Parser + * + * Includes the Asterisk Realtime API - ARA + * See README.realtime */ #include Index: db.c =================================================================== RCS file: /usr/cvsroot/asterisk/db.c,v retrieving revision 1.23 diff -u -r1.23 db.c --- db.c 28 Sep 2005 23:10:13 -0000 1.23 +++ db.c 24 Oct 2005 15:23:30 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Channel Management + * \brief ASTdb Management * * * DB3 is licensed under Sleepycat Public License and is thus incompatible Index: devicestate.c =================================================================== RCS file: /usr/cvsroot/asterisk/devicestate.c,v retrieving revision 1.8 diff -u -r1.8 devicestate.c --- devicestate.c 17 Oct 2005 15:41:55 -0000 1.8 +++ devicestate.c 24 Oct 2005 15:23:30 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Device state management + * \brief Device state management * */ Index: dns.c =================================================================== RCS file: /usr/cvsroot/asterisk/dns.c,v retrieving revision 1.18 diff -u -r1.18 dns.c --- dns.c 14 Sep 2005 20:46:49 -0000 1.18 +++ dns.c 24 Oct 2005 15:23:30 -0000 @@ -18,10 +18,11 @@ * at the top of the source tree. */ -/* +/*! \file * - * DNS Support for Asterisk + * \brief DNS Support for Asterisk * + * \author Thorsten Lockert */ #include Index: dnsmgr.c =================================================================== RCS file: /usr/cvsroot/asterisk/dnsmgr.c,v retrieving revision 1.8 diff -u -r1.8 dnsmgr.c --- dnsmgr.c 14 Sep 2005 20:46:49 -0000 1.8 +++ dnsmgr.c 24 Oct 2005 15:23:30 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Background DNS update manager + * \brief Background DNS update manager * */ Index: dsp.c =================================================================== RCS file: /usr/cvsroot/asterisk/dsp.c,v retrieving revision 1.49 diff -u -r1.49 dsp.c --- dsp.c 15 Sep 2005 15:44:25 -0000 1.49 +++ dsp.c 24 Oct 2005 15:23:30 -0000 @@ -19,9 +19,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Convenience Signal Processing routines + * \brief Convenience Signal Processing routines * */ Index: enum.c =================================================================== RCS file: /usr/cvsroot/asterisk/enum.c,v retrieving revision 1.33 diff -u -r1.33 enum.c --- enum.c 23 Sep 2005 02:40:38 -0000 1.33 +++ enum.c 24 Oct 2005 15:23:30 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * ENUM Support for Asterisk + * \brief ENUM Support for Asterisk * */ Index: file.c =================================================================== RCS file: /usr/cvsroot/asterisk/file.c,v retrieving revision 1.78 diff -u -r1.78 file.c --- file.c 16 Oct 2005 23:26:35 -0000 1.78 +++ file.c 24 Oct 2005 15:23:31 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Generic File Format Support. + * \brief Generic File Format Support. * */ Index: frame.c =================================================================== RCS file: /usr/cvsroot/asterisk/frame.c,v retrieving revision 1.64 diff -u -r1.64 frame.c --- frame.c 29 Sep 2005 17:40:24 -0000 1.64 +++ frame.c 24 Oct 2005 15:23:31 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Frame manipulation routines + * \brief Frame manipulation routines * */ Index: fskmodem.c =================================================================== RCS file: /usr/cvsroot/asterisk/fskmodem.c,v retrieving revision 1.9 diff -u -r1.9 fskmodem.c --- fskmodem.c 14 Sep 2005 20:46:49 -0000 1.9 +++ fskmodem.c 24 Oct 2005 15:23:31 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * FSK Modulator/Demodulator + * \brief FSK Modulator/Demodulator * */ Index: image.c =================================================================== RCS file: /usr/cvsroot/asterisk/image.c,v retrieving revision 1.17 diff -u -r1.17 image.c --- image.c 14 Sep 2005 20:46:49 -0000 1.17 +++ image.c 24 Oct 2005 15:23:31 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Channel Management + * \brief Image Management * */ Index: indications.c =================================================================== RCS file: /usr/cvsroot/asterisk/indications.c,v retrieving revision 1.29 diff -u -r1.29 indications.c --- indications.c 16 Oct 2005 03:07:15 -0000 1.29 +++ indications.c 24 Oct 2005 15:23:32 -0000 @@ -3,7 +3,6 @@ * * Copyright (C) 2002, Pauline Middelink * - * Pauline Middelink * * See http://www.asterisk.org for more information about * the Asterisk project. Please do not directly contact @@ -16,10 +15,12 @@ * at the top of the source tree. */ -/* +/*! \file * - * Tone Management + * \brief Tone Management * + * \author Pauline Middelink + * * This set of function allow us to play a list of tones on a channel. * Each element has two frequencies, which are mixed together and a * duration. For silence both frequencies can be set to 0. Index: io.c =================================================================== RCS file: /usr/cvsroot/asterisk/io.c,v retrieving revision 1.14 diff -u -r1.14 io.c --- io.c 14 Sep 2005 20:46:49 -0000 1.14 +++ io.c 24 Oct 2005 15:23:32 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * I/O Managment (Derived from Cheops-NG) + * \brief I/O Managment (Derived from Cheops-NG) * */ Index: jitterbuf.c =================================================================== RCS file: /usr/cvsroot/asterisk/jitterbuf.c,v retrieving revision 1.20 diff -u -r1.20 jitterbuf.c --- jitterbuf.c 15 Sep 2005 15:44:26 -0000 1.20 +++ jitterbuf.c 24 Oct 2005 15:23:32 -0000 @@ -19,9 +19,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * jitterbuf: an application-independent jitterbuffer + * \brief jitterbuf: an application-independent jitterbuffer * */ Index: loader.c =================================================================== RCS file: /usr/cvsroot/asterisk/loader.c,v retrieving revision 1.52 diff -u -r1.52 loader.c --- loader.c 26 Sep 2005 17:17:56 -0000 1.52 +++ loader.c 24 Oct 2005 15:23:32 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Module Loader + * \brief Module Loader * */ Index: logger.c =================================================================== RCS file: /usr/cvsroot/asterisk/logger.c,v retrieving revision 1.85 diff -u -r1.85 logger.c --- logger.c 5 Oct 2005 00:21:56 -0000 1.85 +++ logger.c 24 Oct 2005 15:23:32 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Asterisk Logger +/*! \file + * \brief Asterisk Logger * * Logging routines * Index: manager.c =================================================================== RCS file: /usr/cvsroot/asterisk/manager.c,v retrieving revision 1.127 diff -u -r1.127 manager.c --- manager.c 14 Oct 2005 20:37:40 -0000 1.127 +++ manager.c 24 Oct 2005 15:23:33 -0000 @@ -16,12 +16,13 @@ * at the top of the source tree. */ -/* +/*! \file * - * The Asterisk Management Interface - AMI + * \brief The Asterisk Management Interface - AMI * * Channel Management and more * + * \ref manconf */ #include @@ -100,7 +101,7 @@ static struct manager_action *first_action = NULL; AST_MUTEX_DEFINE_STATIC(actionlock); -/* If you are calling carefulwrite, it is assumed that you are calling +/*! If you are calling ast_carefulwrite, it is assumed that you are calling it on a file descriptor that _DOES_ have NONBLOCK set. This way, there is only one system call made to do a write, unless we actually have a need to wait. This way, we get better performance. */ @@ -131,7 +132,7 @@ return res; } -/*--- authority_to_str: Convert authority code to string with serveral options */ +/*! authority_to_str: Convert authority code to string with serveral options */ static char *authority_to_str(int authority, char *res, int reslen) { int running_total = 0, i; @@ -334,7 +335,7 @@ return head; } -/* NOTE: +/*! NOTE: Callers of astman_send_error(), astman_send_response() or astman_send_ack() must EITHER hold the session lock _or_ be running in an action callback (in which case s->busy will be non-zero). In either of these cases, there is no need to lock-protect the session's @@ -342,7 +343,6 @@ be read until either the current action finishes or get_input() obtains the session lock. */ - void astman_send_error(struct mansession *s, struct message *m, char *error) { char *id = astman_get_header(m,"ActionID"); @@ -371,7 +371,7 @@ astman_send_response(s, m, "Success", msg); } -/* Tells you if smallstr exists inside bigstr +/*! Tells you if smallstr exists inside bigstr which is delim by delim and uses no buf or stringsep ast_instring("this|that|more","this",',') == 1; @@ -452,7 +452,7 @@ return ret; } -/* +/*! Rather than braindead on,off this now can also accept a specific int mask value or a ',' delim list of mask strings (the same as manager.conf) -anthm */ Index: md5.c =================================================================== RCS file: /usr/cvsroot/asterisk/md5.c,v retrieving revision 1.15 diff -u -r1.15 md5.c --- md5.c 6 Jun 2005 22:12:18 -0000 1.15 +++ md5.c 24 Oct 2005 15:23:33 -0000 @@ -1,4 +1,6 @@ -/* MD5 checksum routines used for authentication. Not covered by GPL, but + +/*!\file +\brief MD5 checksum routines used for authentication. Not covered by GPL, but in the public domain as per the copyright below */ /* Index: muted.c =================================================================== RCS file: /usr/cvsroot/asterisk/muted.c,v retrieving revision 1.12 diff -u -r1.12 muted.c --- muted.c 15 Sep 2005 15:44:26 -0000 1.12 +++ muted.c 24 Oct 2005 15:23:33 -0000 @@ -19,8 +19,8 @@ * at the top of the source tree. */ -/* - * Mute Daemon +/*! \file + * \brief Mute Daemon * * Specially written for Malcolm Davenport, but I think I'll use it too * Index: netsock.c =================================================================== RCS file: /usr/cvsroot/asterisk/netsock.c,v retrieving revision 1.2 diff -u -r1.2 netsock.c --- netsock.c 14 Sep 2005 20:46:49 -0000 1.2 +++ netsock.c 24 Oct 2005 15:23:33 -0000 @@ -17,9 +17,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Network socket handling + * \brief Network socket handling * */ Index: pbx.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx.c,v retrieving revision 1.288 diff -u -r1.288 pbx.c --- pbx.c 18 Oct 2005 19:16:13 -0000 1.288 +++ pbx.c 24 Oct 2005 15:23:35 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Core PBX routines. + * \brief Core PBX routines. * */ Index: plc.c =================================================================== RCS file: /usr/cvsroot/asterisk/plc.c,v retrieving revision 1.8 diff -u -r1.8 plc.c --- plc.c 15 Sep 2005 15:44:26 -0000 1.8 +++ plc.c 24 Oct 2005 15:23:35 -0000 @@ -22,9 +22,9 @@ * This version is disclaimed to DIGIUM for inclusion in the Asterisk project. */ -/* +/*! \file * - * SpanDSP - a series of DSP components for telephony + * \brief SpanDSP - a series of DSP components for telephony * */ Index: privacy.c =================================================================== RCS file: /usr/cvsroot/asterisk/privacy.c,v retrieving revision 1.8 diff -u -r1.8 privacy.c --- privacy.c 14 Sep 2005 20:46:49 -0000 1.8 +++ privacy.c 24 Oct 2005 15:23:35 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Privacy Routines + * \brief Privacy Routines * */ Index: rtp.c =================================================================== RCS file: /usr/cvsroot/asterisk/rtp.c,v retrieving revision 1.150 diff -u -r1.150 rtp.c --- rtp.c 14 Oct 2005 17:02:20 -0000 1.150 +++ rtp.c 24 Oct 2005 15:23:36 -0000 @@ -17,7 +17,7 @@ */ /*! - * \file rtp.c + * \file * \brief Supports RTP and RTCP with Symmetric RTP support for NAT traversal. * * RTP is deffined in RFC 3550. Index: say.c =================================================================== RCS file: /usr/cvsroot/asterisk/say.c,v retrieving revision 1.70 diff -u -r1.70 say.c --- say.c 27 Sep 2005 02:25:12 -0000 1.70 +++ say.c 24 Oct 2005 15:23:38 -0000 @@ -17,9 +17,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Say numbers and dates (maybe words one day too) + * \brief Say numbers and dates (maybe words one day too) * * 12-16-2004 : Support for Greek added by InAccess Networks (work funded by HOL, www.hol.gr) * George Konstantoulakis Index: sched.c =================================================================== RCS file: /usr/cvsroot/asterisk/sched.c,v retrieving revision 1.25 diff -u -r1.25 sched.c --- sched.c 14 Sep 2005 20:46:49 -0000 1.25 +++ sched.c 24 Oct 2005 15:23:38 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Scheduler Routines (from cheops-NG) + * \brief Scheduler Routines (from cheops-NG) * */ Index: slinfactory.c =================================================================== RCS file: /usr/cvsroot/asterisk/slinfactory.c,v retrieving revision 1.3 diff -u -r1.3 slinfactory.c --- slinfactory.c 17 Oct 2005 17:54:05 -0000 1.3 +++ slinfactory.c 24 Oct 2005 15:23:38 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * A machine to gather up arbitrary frames and convert them + * \brief A machine to gather up arbitrary frames and convert them * to raw slinear on demand. * */ Index: srv.c =================================================================== RCS file: /usr/cvsroot/asterisk/srv.c,v retrieving revision 1.17 diff -u -r1.17 srv.c --- srv.c 14 Sep 2005 20:46:49 -0000 1.17 +++ srv.c 24 Oct 2005 15:23:38 -0000 @@ -18,9 +18,11 @@ * at the top of the source tree. */ -/* +/*! \file * - * ENUM Support for Asterisk + * \brief DNS SRV Record Lookup Support for Asterisk + * + * \arg See also \ref AstENUM * */ Index: tdd.c =================================================================== RCS file: /usr/cvsroot/asterisk/tdd.c,v retrieving revision 1.8 diff -u -r1.8 tdd.c --- tdd.c 14 Sep 2005 20:46:49 -0000 1.8 +++ tdd.c 24 Oct 2005 15:23:38 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * TTY/TDD Generation support + * \brief TTY/TDD Generation support * */ Index: term.c =================================================================== RCS file: /usr/cvsroot/asterisk/term.c,v retrieving revision 1.14 diff -u -r1.14 term.c --- term.c 14 Sep 2005 20:46:49 -0000 1.14 +++ term.c 24 Oct 2005 15:23:38 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Terminal Routines + * \brief Terminal Routines * */ Index: translate.c =================================================================== RCS file: /usr/cvsroot/asterisk/translate.c,v retrieving revision 1.43 diff -u -r1.43 translate.c --- translate.c 14 Sep 2005 20:46:49 -0000 1.43 +++ translate.c 24 Oct 2005 15:23:38 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Translate via the use of pseudo channels + * \brief Translate via the use of pseudo channels * */ Index: ulaw.c =================================================================== RCS file: /usr/cvsroot/asterisk/ulaw.c,v retrieving revision 1.6 diff -u -r1.6 ulaw.c --- ulaw.c 14 Sep 2005 20:46:49 -0000 1.6 +++ ulaw.c 24 Oct 2005 15:23:38 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * u-Law to Signed linear conversion + * \brief u-Law to Signed linear conversion * */ Index: utils.c =================================================================== RCS file: /usr/cvsroot/asterisk/utils.c,v retrieving revision 1.75 diff -u -r1.75 utils.c --- utils.c 21 Oct 2005 14:09:03 -0000 1.75 +++ utils.c 24 Oct 2005 15:23:39 -0000 @@ -14,10 +14,13 @@ * at the top of the source tree. */ -/* +/*! \file * - * Utility functions + * \brief Utility functions * + * \note These are important for portability and security, + * so please use them in favour of other routines. + * Please consult the CODING GUIDELINES for more information. */ #include Index: apps/app_adsiprog.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_adsiprog.c,v retrieving revision 1.17 diff -u -r1.17 app_adsiprog.c --- apps/app_adsiprog.c 19 Oct 2005 18:19:01 -0000 1.17 +++ apps/app_adsiprog.c 24 Oct 2005 15:23:39 -0000 @@ -16,9 +16,8 @@ * at the top of the source tree. */ -/* - * - * Program Asterisk ADSI Scripts into phone +/*! \file + * \brief Program Asterisk ADSI Scripts into phone * */ Index: apps/app_alarmreceiver.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_alarmreceiver.c,v retrieving revision 1.17 diff -u -r1.17 app_alarmreceiver.c --- apps/app_alarmreceiver.c 19 Oct 2005 18:19:01 -0000 1.17 +++ apps/app_alarmreceiver.c 24 Oct 2005 15:23:40 -0000 @@ -16,9 +16,8 @@ * at the top of the source tree. */ -/* - * - * Central Station Alarm receiver for Ademco Contact ID +/*! \file + * \brief Central Station Alarm receiver for Ademco Contact ID * * *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** WARNING *** * Index: apps/app_authenticate.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_authenticate.c,v retrieving revision 1.17 diff -u -r1.17 app_authenticate.c --- apps/app_authenticate.c 19 Oct 2005 18:19:01 -0000 1.17 +++ apps/app_authenticate.c 24 Oct 2005 15:23:40 -0000 @@ -16,9 +16,8 @@ * at the top of the source tree. */ -/* - * - * Execute arbitrary authenticate commands +/*! \file + * \brief Execute arbitrary authenticate commands * */ Index: apps/app_cdr.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_cdr.c,v retrieving revision 1.9 diff -u -r1.9 app_cdr.c --- apps/app_cdr.c 19 Oct 2005 18:19:01 -0000 1.9 +++ apps/app_cdr.c 24 Oct 2005 15:23:40 -0000 @@ -16,9 +16,8 @@ * at the top of the source tree. */ -/* - * - * Applictions connected with CDR engine +/*! \file + * \brief Applications connected with CDR engine * */ Index: apps/app_chanisavail.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_chanisavail.c,v retrieving revision 1.24 diff -u -r1.24 app_chanisavail.c --- apps/app_chanisavail.c 19 Oct 2005 18:19:01 -0000 1.24 +++ apps/app_chanisavail.c 24 Oct 2005 15:23:40 -0000 @@ -17,9 +17,8 @@ * at the top of the source tree. */ -/* - * - * Check if Channel is Available +/*! \file + * \brief Check if Channel is Available * */ Index: apps/app_chanspy.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_chanspy.c,v retrieving revision 1.27 diff -u -r1.27 app_chanspy.c --- apps/app_chanspy.c 19 Oct 2005 18:19:01 -0000 1.27 +++ apps/app_chanspy.c 24 Oct 2005 15:23:40 -0000 @@ -16,9 +16,8 @@ * at the top of the source tree. */ -/* - * - * ChanSpy Listen in on any channel. +/*! \file + * \brief ChanSpy: Listen in on any channel. * */ Index: apps/app_controlplayback.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_controlplayback.c,v retrieving revision 1.15 diff -u -r1.15 app_controlplayback.c --- apps/app_controlplayback.c 19 Oct 2005 18:19:01 -0000 1.15 +++ apps/app_controlplayback.c 24 Oct 2005 15:23:40 -0000 @@ -16,9 +16,8 @@ * at the top of the source tree. */ -/* - * - * Trivial application to control playback a sound file +/*! \file + * \brief Trivial application to control playback of a sound file * */ Index: apps/app_curl.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_curl.c,v retrieving revision 1.13 diff -u -r1.13 app_curl.c --- apps/app_curl.c 19 Oct 2005 18:19:01 -0000 1.13 +++ apps/app_curl.c 24 Oct 2005 15:23:40 -0000 @@ -17,9 +17,8 @@ * */ -/* - * - * Curl - App to load a URL +/*! \file + * \brief Curl - App to load a URL * */ Index: apps/app_cut.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_cut.c,v retrieving revision 1.16 diff -u -r1.16 app_cut.c --- apps/app_cut.c 19 Oct 2005 18:19:01 -0000 1.16 +++ apps/app_cut.c 24 Oct 2005 15:23:40 -0000 @@ -15,9 +15,8 @@ * */ -/* - * - * Cut application +/*! \file + * \brief Cut application * */ Index: apps/app_datetime.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_datetime.c,v retrieving revision 1.6 diff -u -r1.6 app_datetime.c --- apps/app_datetime.c 18 Oct 2005 22:52:21 -0000 1.6 +++ apps/app_datetime.c 24 Oct 2005 15:23:40 -0000 @@ -16,9 +16,8 @@ * at the top of the source tree. */ -/* - * - * Time of day - Report the time of day +/*! \file + * \brief Time of day - Report the time of day * */ Index: apps/app_db.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_db.c,v retrieving revision 1.15 diff -u -r1.15 app_db.c --- apps/app_db.c 19 Oct 2005 18:19:01 -0000 1.15 +++ apps/app_db.c 24 Oct 2005 15:23:40 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Database access functions + * \brief Database access functions * */ Index: apps/app_dial.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_dial.c,v retrieving revision 1.173 diff -u -r1.173 app_dial.c --- apps/app_dial.c 20 Oct 2005 16:42:53 -0000 1.173 +++ apps/app_dial.c 24 Oct 2005 15:23:41 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Trivial application to dial a channel and send an URL on answer + * \brief dial() & retrydial() - Trivial application to dial a channel and send an URL on answer * */ Index: apps/app_dictate.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_dictate.c,v retrieving revision 1.7 diff -u -r1.7 app_dictate.c --- apps/app_dictate.c 19 Oct 2005 18:19:01 -0000 1.7 +++ apps/app_dictate.c 24 Oct 2005 15:23:41 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Virtual Dictation Machine Application For Asterisk + * \brief Virtual Dictation Machine Application For Asterisk * */ Index: apps/app_directed_pickup.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_directed_pickup.c,v retrieving revision 1.5 diff -u -r1.5 app_directed_pickup.c --- apps/app_directed_pickup.c 19 Oct 2005 18:19:01 -0000 1.5 +++ apps/app_directed_pickup.c 24 Oct 2005 15:23:41 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Directed Call Pickup Support + * \brief Directed Call Pickup Support * */ Index: apps/app_directory.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_directory.c,v retrieving revision 1.47 diff -u -r1.47 app_directory.c --- apps/app_directory.c 19 Oct 2005 18:19:01 -0000 1.47 +++ apps/app_directory.c 24 Oct 2005 15:23:41 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Provide a directory of extensions + * \brief Provide a directory of extensions * */ Index: apps/app_disa.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_disa.c,v retrieving revision 1.38 diff -u -r1.38 app_disa.c --- apps/app_disa.c 23 Oct 2005 01:39:40 -0000 1.38 +++ apps/app_disa.c 24 Oct 2005 15:23:41 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * DISA -- Direct Inward System Access Application + * \brief DISA -- Direct Inward System Access Application * */ Index: apps/app_dumpchan.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_dumpchan.c,v retrieving revision 1.12 diff -u -r1.12 app_dumpchan.c --- apps/app_dumpchan.c 19 Oct 2005 18:19:01 -0000 1.12 +++ apps/app_dumpchan.c 24 Oct 2005 15:23:41 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Application to dump channel variables + * \brief Application to dump channel variables * */ Index: apps/app_echo.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_echo.c,v retrieving revision 1.14 diff -u -r1.14 app_echo.c --- apps/app_echo.c 18 Oct 2005 22:52:21 -0000 1.14 +++ apps/app_echo.c 24 Oct 2005 15:23:41 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Echo application -- play back what you hear to evaluate latency + * \brief Echo application -- play back what you hear to evaluate latency * */ Index: apps/app_enumlookup.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_enumlookup.c,v retrieving revision 1.23 diff -u -r1.23 app_enumlookup.c --- apps/app_enumlookup.c 19 Oct 2005 18:19:01 -0000 1.23 +++ apps/app_enumlookup.c 24 Oct 2005 15:23:41 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Enumlookup - lookup entry in ENUM + * \brief Enumlookup - lookup entry in ENUM * */ Index: apps/app_eval.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_eval.c,v retrieving revision 1.9 diff -u -r1.9 app_eval.c --- apps/app_eval.c 19 Oct 2005 18:19:01 -0000 1.9 +++ apps/app_eval.c 24 Oct 2005 15:23:41 -0000 @@ -15,10 +15,10 @@ * */ -/* - * - * Eval application +/*! \file + * \brief Eval application * + * \author Tilghman Lesher */ #include Index: apps/app_exec.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_exec.c,v retrieving revision 1.8 diff -u -r1.8 app_exec.c --- apps/app_exec.c 18 Oct 2005 22:52:21 -0000 1.8 +++ apps/app_exec.c 24 Oct 2005 15:23:41 -0000 @@ -15,10 +15,11 @@ * */ -/* +/*! \file * - * Exec application + * \brief Exec application * + * \author Tilghman Lesher */ #include Index: apps/app_externalivr.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_externalivr.c,v retrieving revision 1.11 diff -u -r1.11 app_externalivr.c --- apps/app_externalivr.c 19 Oct 2005 18:19:01 -0000 1.11 +++ apps/app_externalivr.c 24 Oct 2005 15:23:41 -0000 @@ -19,9 +19,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * External IVR application interface + * \brief External IVR application interface * */ Index: apps/app_festival.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_festival.c,v retrieving revision 1.35 diff -u -r1.35 app_festival.c --- apps/app_festival.c 19 Oct 2005 18:19:01 -0000 1.35 +++ apps/app_festival.c 24 Oct 2005 15:23:41 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Connect to festival + * \brief Connect to festival * */ Index: apps/app_flash.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_flash.c,v retrieving revision 1.8 diff -u -r1.8 app_flash.c --- apps/app_flash.c 18 Oct 2005 22:52:21 -0000 1.8 +++ apps/app_flash.c 24 Oct 2005 15:23:41 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to flash a zap trunk + * \brief App to flash a zap trunk * */ Index: apps/app_forkcdr.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_forkcdr.c,v retrieving revision 1.13 diff -u -r1.13 app_forkcdr.c --- apps/app_forkcdr.c 18 Oct 2005 22:52:21 -0000 1.13 +++ apps/app_forkcdr.c 24 Oct 2005 15:23:42 -0000 @@ -15,9 +15,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Fork CDR application + * \brief Fork CDR application * */ Index: apps/app_getcpeid.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_getcpeid.c,v retrieving revision 1.10 diff -u -r1.10 app_getcpeid.c --- apps/app_getcpeid.c 18 Oct 2005 22:52:21 -0000 1.10 +++ apps/app_getcpeid.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Execute arbitrary system commands + * \brief Execute arbitrary system commands * */ Index: apps/app_groupcount.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_groupcount.c,v retrieving revision 1.23 diff -u -r1.23 app_groupcount.c --- apps/app_groupcount.c 19 Oct 2005 18:19:01 -0000 1.23 +++ apps/app_groupcount.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Group Manipulation Applications + * \brief Group Manipulation Applications * */ Index: apps/app_hasnewvoicemail.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_hasnewvoicemail.c,v retrieving revision 1.19 diff -u -r1.19 app_hasnewvoicemail.c --- apps/app_hasnewvoicemail.c 19 Oct 2005 18:19:02 -0000 1.19 +++ apps/app_hasnewvoicemail.c 24 Oct 2005 15:23:42 -0000 @@ -20,9 +20,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * HasVoicemail application + * \brief HasVoicemail application * */ Index: apps/app_ices.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_ices.c,v retrieving revision 1.10 diff -u -r1.10 app_ices.c --- apps/app_ices.c 19 Oct 2005 18:19:02 -0000 1.10 +++ apps/app_ices.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Stream to an icecast server via ICES (see contrib/asterisk-ices.xml) + * \brief Stream to an icecast server via ICES (see contrib/asterisk-ices.xml) * */ Index: apps/app_image.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_image.c,v retrieving revision 1.10 diff -u -r1.10 app_image.c --- apps/app_image.c 19 Oct 2005 18:19:02 -0000 1.10 +++ apps/app_image.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to transmit an image + * \brief App to transmit an image * */ Index: apps/app_intercom.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_intercom.c,v retrieving revision 1.25 diff -u -r1.25 app_intercom.c --- apps/app_intercom.c 19 Oct 2005 18:19:02 -0000 1.25 +++ apps/app_intercom.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Use /dev/dsp as an intercom. + * \brief Use /dev/dsp as an intercom. * */ Index: apps/app_ivrdemo.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_ivrdemo.c,v retrieving revision 1.10 diff -u -r1.10 app_ivrdemo.c --- apps/app_ivrdemo.c 19 Oct 2005 18:19:02 -0000 1.10 +++ apps/app_ivrdemo.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * IVR Demo application + * \brief IVR Demo application * */ Index: apps/app_lookupblacklist.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_lookupblacklist.c,v retrieving revision 1.12 diff -u -r1.12 app_lookupblacklist.c --- apps/app_lookupblacklist.c 18 Oct 2005 22:52:21 -0000 1.12 +++ apps/app_lookupblacklist.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to lookup the callerid number, and see if it is blacklisted + * \brief App to lookup the callerid number, and see if it is blacklisted * */ Index: apps/app_lookupcidname.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_lookupcidname.c,v retrieving revision 1.10 diff -u -r1.10 app_lookupcidname.c --- apps/app_lookupcidname.c 18 Oct 2005 22:52:21 -0000 1.10 +++ apps/app_lookupcidname.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to set callerid name from database, based on directory number + * \brief App to set callerid name from database, based on directory number * */ Index: apps/app_macro.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_macro.c,v retrieving revision 1.30 diff -u -r1.30 app_macro.c --- apps/app_macro.c 19 Oct 2005 18:19:02 -0000 1.30 +++ apps/app_macro.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Macro Implementation + * \brief Dial plan macro Implementation * */ Index: apps/app_math.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_math.c,v retrieving revision 1.15 diff -u -r1.15 app_math.c --- apps/app_math.c 19 Oct 2005 18:19:02 -0000 1.15 +++ apps/app_math.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * simple math application + * \brief A simple math application * */ Index: apps/app_md5.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_md5.c,v retrieving revision 1.10 diff -u -r1.10 app_md5.c --- apps/app_md5.c 19 Oct 2005 18:19:02 -0000 1.10 +++ apps/app_md5.c 24 Oct 2005 15:23:42 -0000 @@ -15,10 +15,11 @@ */ -/* +/*! \file * - * MD5 checksum application + * \brief MD5 checksum application * + * \todo Remove this deprecated application in 1.3dev */ #include Index: apps/app_meetme.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_meetme.c,v retrieving revision 1.114 diff -u -r1.114 app_meetme.c --- apps/app_meetme.c 19 Oct 2005 18:19:02 -0000 1.114 +++ apps/app_meetme.c 24 Oct 2005 15:23:42 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Meet me conference bridge + * \brief Meet me conference bridge * */ Index: apps/app_milliwatt.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_milliwatt.c,v retrieving revision 1.14 diff -u -r1.14 app_milliwatt.c --- apps/app_milliwatt.c 19 Oct 2005 18:19:02 -0000 1.14 +++ apps/app_milliwatt.c 24 Oct 2005 15:23:43 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Digital Milliwatt Test + * \brief Digital Milliwatt Test * */ Index: apps/app_mp3.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_mp3.c,v retrieving revision 1.29 diff -u -r1.29 app_mp3.c --- apps/app_mp3.c 19 Oct 2005 18:19:02 -0000 1.29 +++ apps/app_mp3.c 24 Oct 2005 15:23:43 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Silly application to play an MP3 file -- uses mpg123 + * \brief Silly application to play an MP3 file -- uses mpg123 * */ Index: apps/app_muxmon.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_muxmon.c,v retrieving revision 1.4 diff -u -r1.4 app_muxmon.c --- apps/app_muxmon.c 19 Oct 2005 18:19:02 -0000 1.4 +++ apps/app_muxmon.c 24 Oct 2005 15:23:43 -0000 @@ -1,7 +1,6 @@ /* * Asterisk -- A telephony toolkit for Linux. * - * muxmon Application For Asterisk * * Copyright (C) 2005, Anthony Minessale II * @@ -11,6 +10,10 @@ * the GNU General Public License */ +/*! \file + * \brief muxmon() - record a call natively + */ + #include #include #include Index: apps/app_nbscat.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_nbscat.c,v retrieving revision 1.14 diff -u -r1.14 app_nbscat.c --- apps/app_nbscat.c 19 Oct 2005 18:19:02 -0000 1.14 +++ apps/app_nbscat.c 24 Oct 2005 15:23:43 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Silly application to play an NBScat file -- uses nbscat8k + * \brief Silly application to play an NBScat file -- uses nbscat8k * */ Index: apps/app_osplookup.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_osplookup.c,v retrieving revision 1.12 diff -u -r1.12 app_osplookup.c --- apps/app_osplookup.c 19 Oct 2005 18:19:02 -0000 1.12 +++ apps/app_osplookup.c 24 Oct 2005 15:23:43 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Open Settlement Protocol Lookup + * \brief Open Settlement Protocol Lookup * */ Index: apps/app_page.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_page.c,v retrieving revision 1.7 diff -u -r1.7 app_page.c --- apps/app_page.c 19 Oct 2005 18:19:02 -0000 1.7 +++ apps/app_page.c 24 Oct 2005 15:23:43 -0000 @@ -16,9 +16,9 @@ * */ -/* +/*! \file * - * Paging application + * \brief page() - Paging application * */ Index: apps/app_parkandannounce.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_parkandannounce.c,v retrieving revision 1.18 diff -u -r1.18 app_parkandannounce.c --- apps/app_parkandannounce.c 19 Oct 2005 18:19:02 -0000 1.18 +++ apps/app_parkandannounce.c 24 Oct 2005 15:23:43 -0000 @@ -19,9 +19,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * ParkAndAnnounce application for Asterisk + * \brief ParkAndAnnounce application for Asterisk * */ Index: apps/app_playback.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_playback.c,v retrieving revision 1.22 diff -u -r1.22 app_playback.c --- apps/app_playback.c 19 Oct 2005 18:19:02 -0000 1.22 +++ apps/app_playback.c 24 Oct 2005 15:23:43 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Trivial application to playback a sound file + * \brief Trivial application to playback a sound file * */ Index: apps/app_privacy.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_privacy.c,v retrieving revision 1.18 diff -u -r1.18 app_privacy.c --- apps/app_privacy.c 18 Oct 2005 22:52:21 -0000 1.18 +++ apps/app_privacy.c 24 Oct 2005 15:23:43 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Block all calls without Caller*ID, require phone # to be entered + * \brief Block all calls without Caller*ID, require phone # to be entered * */ Index: apps/app_queue.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_queue.c,v retrieving revision 1.172 diff -u -r1.172 app_queue.c --- apps/app_queue.c 19 Oct 2005 18:19:02 -0000 1.172 +++ apps/app_queue.c 24 Oct 2005 15:23:44 -0000 @@ -16,12 +16,12 @@ * at the top of the source tree. */ -/* +/*! \file * - * True call queues with optional send URL on answer + * \brief True call queues with optional send URL on answer * * - * 2004-11-25: Persistent Dynamic Members added by: + * \note 2004-11-25: Persistent Dynamic Members added by: * NetNation Communications (www.netnation.com) * Kevin Lindsay * @@ -31,9 +31,9 @@ * configured with the 'persistent_members=<1|0>' setting in the * '[general]' category in queues.conf. The default is on. * - * 2004-06-04: Priorities in queues added by inAccess Networks (work funded by Hellas On Line (HOL) www.hol.gr). + * \note 2004-06-04: Priorities in queues added by inAccess Networks (work funded by Hellas On Line (HOL) www.hol.gr). * - * These features added by David C. Troy : + * \note These features added by David C. Troy : * - Per-queue holdtime calculation * - Estimated holdtime announcement * - Position announcement @@ -49,8 +49,6 @@ * Fixed to work with CVS as of 2004-02-25 and released as 1.07a * by Matthew Enger * - * This program is free software, distributed under the terms of - * the GNU General Public License */ #include Index: apps/app_random.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_random.c,v retrieving revision 1.10 diff -u -r1.10 app_random.c --- apps/app_random.c 19 Oct 2005 18:19:02 -0000 1.10 +++ apps/app_random.c 24 Oct 2005 15:23:44 -0000 @@ -15,10 +15,11 @@ * */ -/* +/*! \file * - * Random application + * \brief Random application * + * \author Tilghman Lesher */ #include Index: apps/app_read.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_read.c,v retrieving revision 1.24 diff -u -r1.24 app_read.c --- apps/app_read.c 19 Oct 2005 18:19:02 -0000 1.24 +++ apps/app_read.c 24 Oct 2005 15:23:44 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Trivial application to read a variable + * \brief Trivial application to read a variable * */ Index: apps/app_readfile.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_readfile.c,v retrieving revision 1.10 diff -u -r1.10 app_readfile.c --- apps/app_readfile.c 19 Oct 2005 18:19:02 -0000 1.10 +++ apps/app_readfile.c 24 Oct 2005 15:23:44 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * ReadFile application -- Reads in a File for you. + * \brief ReadFile application -- Reads in a File for you. * */ Index: apps/app_realtime.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_realtime.c,v retrieving revision 1.14 diff -u -r1.14 app_realtime.c --- apps/app_realtime.c 19 Oct 2005 18:19:02 -0000 1.14 +++ apps/app_realtime.c 24 Oct 2005 15:23:44 -0000 @@ -17,9 +17,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * RealTime App + * \brief RealTime App * */ Index: apps/app_record.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_record.c,v retrieving revision 1.39 diff -u -r1.39 app_record.c --- apps/app_record.c 19 Oct 2005 18:19:02 -0000 1.39 +++ apps/app_record.c 24 Oct 2005 15:23:44 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Trivial application to record a sound file + * \brief Trivial application to record a sound file * */ Index: apps/app_rpt.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_rpt.c,v retrieving revision 1.43 diff -u -r1.43 app_rpt.c --- apps/app_rpt.c 23 Sep 2005 03:07:06 -0000 1.43 +++ apps/app_rpt.c 24 Oct 2005 15:23:45 -0000 @@ -17,9 +17,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Radio Repeater / Remote Base program + * \brief Radio Repeater / Remote Base program * version 0.31 09/15/05 * * See http://www.zapatatelephony.org/app_rpt.html Index: apps/app_sayunixtime.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_sayunixtime.c,v retrieving revision 1.13 diff -u -r1.13 app_sayunixtime.c --- apps/app_sayunixtime.c 18 Oct 2005 22:52:21 -0000 1.13 +++ apps/app_sayunixtime.c 24 Oct 2005 15:23:45 -0000 @@ -15,9 +15,9 @@ * */ -/* +/*! \file * - * SayUnixTime application + * \brief SayUnixTime application * */ Index: apps/app_senddtmf.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_senddtmf.c,v retrieving revision 1.13 diff -u -r1.13 app_senddtmf.c --- apps/app_senddtmf.c 19 Oct 2005 18:19:02 -0000 1.13 +++ apps/app_senddtmf.c 24 Oct 2005 15:23:45 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to send DTMF digits + * \brief App to send DTMF digits * */ Index: apps/app_sendtext.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_sendtext.c,v retrieving revision 1.11 diff -u -r1.11 app_sendtext.c --- apps/app_sendtext.c 19 Oct 2005 18:19:02 -0000 1.11 +++ apps/app_sendtext.c 24 Oct 2005 15:23:45 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to transmit a text message + * \brief App to transmit a text message * */ Index: apps/app_setcallerid.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_setcallerid.c,v retrieving revision 1.12 diff -u -r1.12 app_setcallerid.c --- apps/app_setcallerid.c 19 Oct 2005 18:19:02 -0000 1.12 +++ apps/app_setcallerid.c 24 Oct 2005 15:23:45 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to set callerid + * \brief App to set callerid * */ Index: apps/app_setcdruserfield.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_setcdruserfield.c,v retrieving revision 1.11 diff -u -r1.11 app_setcdruserfield.c --- apps/app_setcdruserfield.c 19 Oct 2005 18:19:02 -0000 1.11 +++ apps/app_setcdruserfield.c 24 Oct 2005 15:23:45 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Applictions connected with CDR engine + * \brief Applictions connected with CDR engine * */ Index: apps/app_setcidname.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_setcidname.c,v retrieving revision 1.13 diff -u -r1.13 app_setcidname.c --- apps/app_setcidname.c 19 Oct 2005 18:19:02 -0000 1.13 +++ apps/app_setcidname.c 24 Oct 2005 15:23:45 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to set callerid + * \brief App to set callerid * */ Index: apps/app_setcidnum.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_setcidnum.c,v retrieving revision 1.14 diff -u -r1.14 app_setcidnum.c --- apps/app_setcidnum.c 19 Oct 2005 18:19:02 -0000 1.14 +++ apps/app_setcidnum.c 24 Oct 2005 15:23:45 -0000 @@ -17,9 +17,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to set callerid + * \brief App to set callerid number * */ Index: apps/app_setrdnis.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_setrdnis.c,v retrieving revision 1.9 diff -u -r1.9 app_setrdnis.c --- apps/app_setrdnis.c 19 Oct 2005 18:19:02 -0000 1.9 +++ apps/app_setrdnis.c 24 Oct 2005 15:23:45 -0000 @@ -17,9 +17,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to set rdnis + * \brief App to set rdnis * */ Index: apps/app_settransfercapability.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_settransfercapability.c,v retrieving revision 1.9 diff -u -r1.9 app_settransfercapability.c --- apps/app_settransfercapability.c 19 Oct 2005 18:19:02 -0000 1.9 +++ apps/app_settransfercapability.c 24 Oct 2005 15:23:45 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * App to set the ISDN Transfer Capability + * \brief App to set the ISDN Transfer Capability * */ Index: apps/app_skel.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_skel.c,v retrieving revision 1.15 diff -u -r1.15 app_skel.c --- apps/app_skel.c 19 Oct 2005 18:19:02 -0000 1.15 +++ apps/app_skel.c 24 Oct 2005 15:23:45 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Skeleton application + * \brief Skeleton application * */ Index: apps/app_sms.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_sms.c,v retrieving revision 1.29 diff -u -r1.29 app_sms.c --- apps/app_sms.c 19 Oct 2005 18:19:02 -0000 1.29 +++ apps/app_sms.c 24 Oct 2005 15:23:45 -0000 @@ -14,9 +14,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * SMS application - ETSI ES 201 912 protocol 1 implimentation + * \brief SMS application - ETSI ES 201 912 protocol 1 implimentation * */ Index: apps/app_softhangup.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_softhangup.c,v retrieving revision 1.11 diff -u -r1.11 app_softhangup.c --- apps/app_softhangup.c 19 Oct 2005 18:19:02 -0000 1.11 +++ apps/app_softhangup.c 24 Oct 2005 15:23:45 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * SoftHangup application + * \brief SoftHangup application * */ Index: apps/app_sql_postgres.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_sql_postgres.c,v retrieving revision 1.15 diff -u -r1.15 app_sql_postgres.c --- apps/app_sql_postgres.c 19 Oct 2005 18:19:02 -0000 1.15 +++ apps/app_sql_postgres.c 24 Oct 2005 15:23:46 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Connect to PostgreSQL + * \brief Connect to PostgreSQL * */ Index: apps/app_striplsd.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_striplsd.c,v retrieving revision 1.9 diff -u -r1.9 app_striplsd.c --- apps/app_striplsd.c 19 Oct 2005 18:19:02 -0000 1.9 +++ apps/app_striplsd.c 24 Oct 2005 15:23:46 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Skeleton application (?) + * \brief striplsd: Strip trailing digits app * */ Index: apps/app_substring.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_substring.c,v retrieving revision 1.14 diff -u -r1.14 app_substring.c --- apps/app_substring.c 19 Oct 2005 18:19:02 -0000 1.14 +++ apps/app_substring.c 24 Oct 2005 15:23:46 -0000 @@ -16,10 +16,11 @@ * at the top of the source tree. */ -/* +/*! \file * - * Skeleton application (?) - * + * \brief substr + * + * \todo Deprecate this application in 1.3dev */ #include Index: apps/app_system.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_system.c,v retrieving revision 1.20 diff -u -r1.20 app_system.c --- apps/app_system.c 19 Oct 2005 18:19:02 -0000 1.20 +++ apps/app_system.c 24 Oct 2005 15:23:46 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Execute arbitrary system commands + * \brief Execute arbitrary system commands * */ Index: apps/app_talkdetect.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_talkdetect.c,v retrieving revision 1.15 diff -u -r1.15 app_talkdetect.c --- apps/app_talkdetect.c 19 Oct 2005 18:19:02 -0000 1.15 +++ apps/app_talkdetect.c 24 Oct 2005 15:23:46 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Playback a file with audio detect + * \brief Playback a file with audio detect * */ Index: apps/app_test.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_test.c,v retrieving revision 1.14 diff -u -r1.14 app_test.c --- apps/app_test.c 19 Oct 2005 18:19:02 -0000 1.14 +++ apps/app_test.c 24 Oct 2005 15:23:46 -0000 @@ -17,9 +17,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Applications to test connection and produce report in text file + * \brief Applications to test connection and produce report in text file * */ Index: apps/app_transfer.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_transfer.c,v retrieving revision 1.16 diff -u -r1.16 app_transfer.c --- apps/app_transfer.c 19 Oct 2005 18:19:02 -0000 1.16 +++ apps/app_transfer.c 24 Oct 2005 15:23:46 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Transfer a caller + * \brief Transfer a caller * */ Index: apps/app_txtcidname.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_txtcidname.c,v retrieving revision 1.20 diff -u -r1.20 app_txtcidname.c --- apps/app_txtcidname.c 19 Oct 2005 18:19:02 -0000 1.20 +++ apps/app_txtcidname.c 24 Oct 2005 15:23:46 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Caller*id name lookup - Look up the caller's name via DNS + * \brief Caller*id name lookup - Look up the caller's name via DNS * */ Index: apps/app_url.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_url.c,v retrieving revision 1.13 diff -u -r1.13 app_url.c --- apps/app_url.c 19 Oct 2005 18:19:02 -0000 1.13 +++ apps/app_url.c 24 Oct 2005 15:23:46 -0000 @@ -16,9 +16,8 @@ * at the top of the source tree. */ -/* - * - * App to transmit a URL +/*! \file + * \brief App to transmit a URL * */ Index: apps/app_userevent.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_userevent.c,v retrieving revision 1.9 diff -u -r1.9 app_userevent.c --- apps/app_userevent.c 19 Oct 2005 18:19:02 -0000 1.9 +++ apps/app_userevent.c 24 Oct 2005 15:23:46 -0000 @@ -14,9 +14,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * UserEvent application -- send manager event + * \brief UserEvent application -- send manager event * */ Index: apps/app_verbose.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_verbose.c,v retrieving revision 1.8 diff -u -r1.8 app_verbose.c --- apps/app_verbose.c 19 Oct 2005 18:19:02 -0000 1.8 +++ apps/app_verbose.c 24 Oct 2005 15:23:46 -0000 @@ -15,9 +15,9 @@ * */ -/* +/*! \file * - * Verbose application + * \brief Verbose logging application * */ Index: apps/app_voicemail.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_voicemail.c,v retrieving revision 1.253 diff -u -r1.253 app_voicemail.c --- apps/app_voicemail.c 19 Oct 2005 18:19:02 -0000 1.253 +++ apps/app_voicemail.c 24 Oct 2005 15:23:47 -0000 @@ -11,8 +11,6 @@ * 05-10-2005 : Support for Swedish and Norwegian added by Daniel Nylander, http://www.danielnylander.se/ * * 05-11-2005 : An option for maximum number of messsages per mailbox added by GDS Partners (www.gdspartners.com) - * Stojan Sljivic - * * 07-11-2005 : An issue with voicemail synchronization has been fixed by GDS Partners (www.gdspartners.com) * Stojan Sljivic * @@ -27,9 +25,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Voicemail System + * \brief Comedian Mail - Voicemail System * */ @@ -1400,7 +1398,7 @@ } if (len) { res = write(ofd, buf, len); - if (res != len) { + if (errno == ENOMEM || errno == ENOSPC || res != len) { ast_log(LOG_WARNING, "Write failed on %s (%d of %d): %s\n", outfile, res, len, strerror(errno)); close(ifd); close(ofd); Index: apps/app_waitforring.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_waitforring.c,v retrieving revision 1.9 diff -u -r1.9 app_waitforring.c --- apps/app_waitforring.c 19 Oct 2005 18:19:02 -0000 1.9 +++ apps/app_waitforring.c 24 Oct 2005 15:23:47 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Wait for Ring Application + * \brief Wait for Ring Application * */ Index: apps/app_waitforsilence.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_waitforsilence.c,v retrieving revision 1.11 diff -u -r1.11 app_waitforsilence.c --- apps/app_waitforsilence.c 19 Oct 2005 18:19:02 -0000 1.11 +++ apps/app_waitforsilence.c 24 Oct 2005 15:23:47 -0000 @@ -19,9 +19,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Wait for Silence + * \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 Index: apps/app_while.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_while.c,v retrieving revision 1.12 diff -u -r1.12 app_while.c --- apps/app_while.c 19 Oct 2005 18:19:02 -0000 1.12 +++ apps/app_while.c 24 Oct 2005 15:23:47 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * While Loop and ExecIf Implementations + * \brief While Loop and ExecIf Implementations * */ Index: apps/app_zapateller.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_zapateller.c,v retrieving revision 1.12 diff -u -r1.12 app_zapateller.c --- apps/app_zapateller.c 19 Oct 2005 18:19:02 -0000 1.12 +++ apps/app_zapateller.c 24 Oct 2005 15:23:47 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Playback the special information tone to get rid of telemarketers + * \brief Playback the special information tone to get rid of telemarketers * */ Index: apps/app_zapbarge.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_zapbarge.c,v retrieving revision 1.12 diff -u -r1.12 app_zapbarge.c --- apps/app_zapbarge.c 19 Oct 2005 18:19:02 -0000 1.12 +++ apps/app_zapbarge.c 24 Oct 2005 15:23:47 -0000 @@ -19,9 +19,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Zap Barge support + * \brief Zap Barge support * */ Index: apps/app_zapras.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_zapras.c,v retrieving revision 1.15 diff -u -r1.15 app_zapras.c --- apps/app_zapras.c 19 Oct 2005 18:19:02 -0000 1.15 +++ apps/app_zapras.c 24 Oct 2005 15:23:47 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Execute an ISDN RAS + * \brief Execute an ISDN RAS * */ Index: apps/app_zapscan.c =================================================================== RCS file: /usr/cvsroot/asterisk/apps/app_zapscan.c,v retrieving revision 1.22 diff -u -r1.22 app_zapscan.c --- apps/app_zapscan.c 18 Oct 2005 22:52:21 -0000 1.22 +++ apps/app_zapscan.c 24 Oct 2005 15:23:47 -0000 @@ -21,9 +21,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Zap Scanner + * \brief Zap Scanner * */ Index: channels/chan_agent.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_agent.c,v retrieving revision 1.159 diff -u -r1.159 chan_agent.c --- channels/chan_agent.c 14 Oct 2005 00:46:13 -0000 1.159 +++ channels/chan_agent.c 24 Oct 2005 15:23:47 -0000 @@ -17,11 +17,10 @@ */ -/** - * Implementation of Agents +/*! \file + * \brief Implementation of Agents * - * @file chan_agent.c - * @brief This file is the implementation of Agents modules. + * This file is the implementation of Agents modules. * It is a dynamic module that is loaded by Asterisk. At load time, load_module is run. */ Index: channels/chan_alsa.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_alsa.c,v retrieving revision 1.49 diff -u -r1.49 chan_alsa.c --- channels/chan_alsa.c 16 Oct 2005 16:05:41 -0000 1.49 +++ channels/chan_alsa.c 24 Oct 2005 15:23:48 -0000 @@ -16,6 +16,10 @@ * at the top of the source tree. */ +/*! \file + * \brief ALSA sound card channel driver + */ + #include #include Index: channels/chan_features.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_features.c,v retrieving revision 1.17 diff -u -r1.17 chan_features.c --- channels/chan_features.c 14 Sep 2005 20:46:49 -0000 1.17 +++ channels/chan_features.c 24 Oct 2005 15:23:48 -0000 @@ -16,11 +16,11 @@ * at the top of the source tree. */ -/* +/*! \file * - * feature Proxy Channel + * \brief feature Proxy Channel * - * *** Experimental code **** + * \note *** Experimental code **** * */ Index: channels/chan_h323.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_h323.c,v retrieving revision 1.130 diff -u -r1.130 chan_h323.c --- channels/chan_h323.c 15 Sep 2005 17:08:52 -0000 1.130 +++ channels/chan_h323.c 24 Oct 2005 15:23:48 -0000 @@ -21,9 +21,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * This file is part of the chan_h323 driver for Asterisk + * \brief This file is part of the chan_h323 driver for Asterisk * */ Index: channels/chan_iax2.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_iax2.c,v retrieving revision 1.360 diff -u -r1.360 chan_iax2.c --- channels/chan_iax2.c 23 Oct 2005 18:11:54 -0000 1.360 +++ channels/chan_iax2.c 24 Oct 2005 15:23:50 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Implementation of Inter-Asterisk eXchange Version 2 + * \brief Implementation of Inter-Asterisk eXchange Version 2 * */ Index: channels/chan_local.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_local.c,v retrieving revision 1.54 diff -u -r1.54 chan_local.c --- channels/chan_local.c 19 Oct 2005 03:45:49 -0000 1.54 +++ channels/chan_local.c 24 Oct 2005 15:23:50 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Local Proxy Channel + * \brief Local Proxy Channel * */ Index: channels/chan_mgcp.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_mgcp.c,v retrieving revision 1.130 diff -u -r1.130 chan_mgcp.c --- channels/chan_mgcp.c 14 Sep 2005 20:46:49 -0000 1.130 +++ channels/chan_mgcp.c 24 Oct 2005 15:23:50 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Implementation of Media Gateway Control Protocol + * \brief Implementation of Media Gateway Control Protocol * */ Index: channels/chan_modem.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_modem.c,v retrieving revision 1.46 diff -u -r1.46 chan_modem.c --- channels/chan_modem.c 14 Sep 2005 20:46:49 -0000 1.46 +++ channels/chan_modem.c 24 Oct 2005 15:23:51 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * A/Open ITU-56/2 Voice Modem Driver (Rockwell, IS-101, and others) + * \brief A/Open ITU-56/2 Voice Modem Driver (Rockwell, IS-101, and others) * */ Index: channels/chan_modem_i4l.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_modem_i4l.c,v retrieving revision 1.31 diff -u -r1.31 chan_modem_i4l.c --- channels/chan_modem_i4l.c 14 Sep 2005 20:46:49 -0000 1.31 +++ channels/chan_modem_i4l.c 24 Oct 2005 15:23:51 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * ISDN4Linux TTY Driver + * \brief ISDN4Linux TTY Driver * */ Index: channels/chan_nbs.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_nbs.c,v retrieving revision 1.18 diff -u -r1.18 chan_nbs.c --- channels/chan_nbs.c 14 Sep 2005 20:46:49 -0000 1.18 +++ channels/chan_nbs.c 24 Oct 2005 15:23:51 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Generic Linux Telephony Interface driver + * \brief Generic Linux Telephony Interface driver * */ Index: channels/chan_oss.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_oss.c,v retrieving revision 1.58 diff -u -r1.58 chan_oss.c --- channels/chan_oss.c 16 Oct 2005 16:05:41 -0000 1.58 +++ channels/chan_oss.c 24 Oct 2005 15:23:51 -0000 @@ -19,9 +19,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * + * \brief Channel driver for OSS sound cards * */ Index: channels/chan_phone.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_phone.c,v retrieving revision 1.56 diff -u -r1.56 chan_phone.c --- channels/chan_phone.c 14 Sep 2005 20:46:49 -0000 1.56 +++ channels/chan_phone.c 24 Oct 2005 15:23:51 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Generic Linux Telephony Interface driver + * \brief Generic Linux Telephony Interface driver * */ Index: channels/chan_sip.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_sip.c,v retrieving revision 1.895 diff -u -r1.895 chan_sip.c --- channels/chan_sip.c 23 Oct 2005 01:31:17 -0000 1.895 +++ channels/chan_sip.c 24 Oct 2005 15:23:53 -0000 @@ -16,10 +16,16 @@ * at the top of the source tree. */ -/* - * - * Implementation of Session Initiation Protocol +/*! + * \file + * \brief Implementation of Session Initiation Protocol * + * Implementation of RFC 3261 - without S/MIME, TCP and TLS support + * Configuration file \link page20sip sip.conf \endlink + * + * \todo SIP over TCP + * \todo SIP over TLS + * \todo Better support of forking */ Index: channels/chan_skinny.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_skinny.c,v retrieving revision 1.91 diff -u -r1.91 chan_skinny.c --- channels/chan_skinny.c 14 Sep 2005 20:46:50 -0000 1.91 +++ channels/chan_skinny.c 24 Oct 2005 15:23:54 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Implementation of the Skinny protocol + * \brief Implementation of the Skinny protocol * */ Index: channels/chan_vpb.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_vpb.c,v retrieving revision 1.96 diff -u -r1.96 chan_vpb.c --- channels/chan_vpb.c 14 Oct 2005 17:02:20 -0000 1.96 +++ channels/chan_vpb.c 24 Oct 2005 15:23:55 -0000 @@ -22,9 +22,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * VoiceTronix Interface driver + * \brief VoiceTronix Interface driver * */ Index: channels/chan_zap.c =================================================================== RCS file: /usr/cvsroot/asterisk/channels/chan_zap.c,v retrieving revision 1.534 diff -u -r1.534 chan_zap.c --- channels/chan_zap.c 22 Oct 2005 12:15:07 -0000 1.534 +++ channels/chan_zap.c 24 Oct 2005 15:23:57 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Zaptel Pseudo TDM interface + * \brief Zaptel Pseudo TDM interface * */ Index: funcs/func_callerid.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_callerid.c,v retrieving revision 1.6 diff -u -r1.6 func_callerid.c --- funcs/func_callerid.c 14 Sep 2005 20:46:50 -0000 1.6 +++ funcs/func_callerid.c 24 Oct 2005 15:23:57 -0000 @@ -14,9 +14,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Caller ID related dialplan functions + * \brief Caller ID related dialplan functions * */ Index: funcs/func_cdr.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_cdr.c,v retrieving revision 1.6 diff -u -r1.6 func_cdr.c --- funcs/func_cdr.c 14 Sep 2005 20:46:50 -0000 1.6 +++ funcs/func_cdr.c 24 Oct 2005 15:23:57 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Call Detail Record related dialplan functions + * \brief Call Detail Record related dialplan functions * */ Index: funcs/func_db.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_db.c,v retrieving revision 1.6 diff -u -r1.6 func_db.c --- funcs/func_db.c 14 Sep 2005 20:46:50 -0000 1.6 +++ funcs/func_db.c 24 Oct 2005 15:23:57 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Functions for interaction with the Asterisk database + * \brief Functions for interaction with the Asterisk database * */ Index: funcs/func_enum.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_enum.c,v retrieving revision 1.4 diff -u -r1.4 func_enum.c --- funcs/func_enum.c 18 Oct 2005 21:06:48 -0000 1.4 +++ funcs/func_enum.c 24 Oct 2005 15:23:57 -0000 @@ -18,10 +18,10 @@ * at the top of the source tree. */ -/* - * - * Enum Functions +/*! \file * + * \brief ENUM Functions + * \arg See also AstENUM */ #include Index: funcs/func_env.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_env.c,v retrieving revision 1.4 diff -u -r1.4 func_env.c --- funcs/func_env.c 14 Sep 2005 20:46:50 -0000 1.4 +++ funcs/func_env.c 24 Oct 2005 15:23:57 -0000 @@ -14,9 +14,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Environment related dialplan functions + * \brief Environment related dialplan functions * */ Index: funcs/func_groupcount.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_groupcount.c,v retrieving revision 1.7 diff -u -r1.7 func_groupcount.c --- funcs/func_groupcount.c 14 Sep 2005 20:46:50 -0000 1.7 +++ funcs/func_groupcount.c 24 Oct 2005 15:23:57 -0000 @@ -14,9 +14,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Channel group related dialplan functions + * \brief Channel group related dialplan functions * */ Index: funcs/func_language.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_language.c,v retrieving revision 1.3 diff -u -r1.3 func_language.c --- funcs/func_language.c 14 Sep 2005 20:46:50 -0000 1.3 +++ funcs/func_language.c 24 Oct 2005 15:23:57 -0000 @@ -14,9 +14,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Language related dialplan functions + * \brief Language related dialplan functions * */ Index: funcs/func_logic.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_logic.c,v retrieving revision 1.10 diff -u -r1.10 func_logic.c --- funcs/func_logic.c 14 Sep 2005 20:46:50 -0000 1.10 +++ funcs/func_logic.c 24 Oct 2005 15:23:57 -0000 @@ -15,9 +15,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Conditional logic dialplan functions + * \brief Conditional logic dialplan functions * */ Index: funcs/func_math.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_math.c,v retrieving revision 1.2 diff -u -r1.2 func_math.c --- funcs/func_math.c 14 Sep 2005 20:46:50 -0000 1.2 +++ funcs/func_math.c 24 Oct 2005 15:23:57 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Maths relatad dialplan functions + * \brief Maths relatad dialplan functions * */ Index: funcs/func_md5.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_md5.c,v retrieving revision 1.5 diff -u -r1.5 func_md5.c --- funcs/func_md5.c 14 Sep 2005 20:46:50 -0000 1.5 +++ funcs/func_md5.c 24 Oct 2005 15:23:57 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * MD5 digest related dialplan functions + * \brief MD5 digest related dialplan functions * */ Index: funcs/func_moh.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_moh.c,v retrieving revision 1.2 diff -u -r1.2 func_moh.c --- funcs/func_moh.c 14 Sep 2005 20:46:50 -0000 1.2 +++ funcs/func_moh.c 24 Oct 2005 15:23:57 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Functions for reading or setting the MusicOnHold class + * \brief Functions for reading or setting the MusicOnHold class * */ Index: funcs/func_strings.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_strings.c,v retrieving revision 1.11 diff -u -r1.11 func_strings.c --- funcs/func_strings.c 17 Oct 2005 17:54:32 -0000 1.11 +++ funcs/func_strings.c 24 Oct 2005 15:23:57 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * String manipulation dialplan functions + * \brief String manipulation dialplan functions * */ Index: funcs/func_timeout.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_timeout.c,v retrieving revision 1.3 diff -u -r1.3 func_timeout.c --- funcs/func_timeout.c 14 Sep 2005 20:46:50 -0000 1.3 +++ funcs/func_timeout.c 24 Oct 2005 15:23:57 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Channel timeout related dialplan functions + * \brief Channel timeout related dialplan functions * */ Index: funcs/func_uri.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/func_uri.c,v retrieving revision 1.2 diff -u -r1.2 func_uri.c --- funcs/func_uri.c 14 Sep 2005 20:46:50 -0000 1.2 +++ funcs/func_uri.c 24 Oct 2005 15:23:57 -0000 @@ -16,12 +16,12 @@ * at the top of the source tree. */ -/* +/*! \file * - * URI encoding / decoding + * \brief URI encoding / decoding * - * For now this code only supports 8 bit characters, not unicode, - * which we ultimately will need to support. + * \note For now this code only supports 8 bit characters, not unicode, + which we ultimately will need to support. * */ @@ -40,7 +40,7 @@ #include "asterisk/app.h" #include "asterisk/module.h" -/*--- builtin_function_uriencode: Encode URL according to RFC 2396 */ +/*! \brief builtin_function_uriencode: Encode URL according to RFC 2396 */ static char *builtin_function_uriencode(struct ast_channel *chan, char *cmd, char *data, char *buf, size_t len) { char uri[BUFSIZ]; @@ -56,7 +56,7 @@ return buf; } -/*--- builtin_function_uridecode: Decode URI according to RFC 2396 */ +/*!\brief builtin_function_uridecode: Decode URI according to RFC 2396 */ static char *builtin_function_uridecode(struct ast_channel *chan, char *cmd, char *data, char *buf, size_t len) { if (!data || ast_strlen_zero(data)) { Index: funcs/pbx_functions.c =================================================================== RCS file: /usr/cvsroot/asterisk/funcs/pbx_functions.c,v retrieving revision 1.5 diff -u -r1.5 pbx_functions.c --- funcs/pbx_functions.c 14 Sep 2005 20:46:50 -0000 1.5 +++ funcs/pbx_functions.c 24 Oct 2005 15:23:57 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Builtin dialplan functions + * \brief Builtin dialplan functions * */ Index: pbx/dundi-parser.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx/dundi-parser.c,v retrieving revision 1.10 diff -u -r1.10 dundi-parser.c --- pbx/dundi-parser.c 14 Sep 2005 20:46:50 -0000 1.10 +++ pbx/dundi-parser.c 24 Oct 2005 15:23:58 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Distributed Universal Number Discovery (DUNDi) + * \brief Distributed Universal Number Discovery (DUNDi) * */ Index: pbx/pbx_ael.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx/pbx_ael.c,v retrieving revision 1.14 diff -u -r1.14 pbx_ael.c --- pbx/pbx_ael.c 13 Oct 2005 15:36:29 -0000 1.14 +++ pbx/pbx_ael.c 24 Oct 2005 15:23:58 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Compile symbolic Asterisk Extension Logic into Asterisk extensions + * \brief Compile symbolic Asterisk Extension Logic into Asterisk extensions * */ Index: pbx/pbx_config.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx/pbx_config.c,v retrieving revision 1.70 diff -u -r1.70 pbx_config.c --- pbx/pbx_config.c 13 Oct 2005 22:55:28 -0000 1.70 +++ pbx/pbx_config.c 24 Oct 2005 15:23:58 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Populate and remember extensions from static config file + * \brief Populate and remember extensions from static config file * */ Index: pbx/pbx_dundi.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx/pbx_dundi.c,v retrieving revision 1.44 diff -u -r1.44 pbx_dundi.c --- pbx/pbx_dundi.c 18 Oct 2005 21:03:49 -0000 1.44 +++ pbx/pbx_dundi.c 24 Oct 2005 15:23:58 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Distributed Universal Number Discovery (DUNDi) + * \brief Distributed Universal Number Discovery (DUNDi) * */ Index: pbx/pbx_gtkconsole.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx/pbx_gtkconsole.c,v retrieving revision 1.20 diff -u -r1.20 pbx_gtkconsole.c --- pbx/pbx_gtkconsole.c 14 Sep 2005 20:46:50 -0000 1.20 +++ pbx/pbx_gtkconsole.c 24 Oct 2005 15:23:59 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * GTK Console monitor -- very kludgy right now + * \brief GTK Console monitor -- very kludgy right now * */ Index: pbx/pbx_loopback.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx/pbx_loopback.c,v retrieving revision 1.8 diff -u -r1.8 pbx_loopback.c --- pbx/pbx_loopback.c 14 Sep 2005 20:46:50 -0000 1.8 +++ pbx/pbx_loopback.c 24 Oct 2005 15:23:59 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Loopback PBX Module + * \brief Loopback PBX Module * */ Index: pbx/pbx_realtime.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx/pbx_realtime.c,v retrieving revision 1.12 diff -u -r1.12 pbx_realtime.c --- pbx/pbx_realtime.c 14 Sep 2005 20:46:50 -0000 1.12 +++ pbx/pbx_realtime.c 24 Oct 2005 15:23:59 -0000 @@ -16,10 +16,11 @@ * at the top of the source tree. */ -/* +/*! \file * - * Realtime PBX Module + * \brief Realtime PBX Module * + * \arg See also: \ref AstARA */ #include Index: pbx/pbx_spool.c =================================================================== RCS file: /usr/cvsroot/asterisk/pbx/pbx_spool.c,v retrieving revision 1.31 diff -u -r1.31 pbx_spool.c --- pbx/pbx_spool.c 12 Oct 2005 20:18:13 -0000 1.31 +++ pbx/pbx_spool.c 24 Oct 2005 15:23:59 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Full-featured outgoing call spool support + * \brief Full-featured outgoing call spool support * */ Index: res/res_adsi.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_adsi.c,v retrieving revision 1.17 diff -u -r1.17 res_adsi.c --- res/res_adsi.c 14 Sep 2005 20:46:50 -0000 1.17 +++ res/res_adsi.c 24 Oct 2005 15:23:59 -0000 @@ -18,9 +18,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * ADSI support + * \brief ADSI support * */ Index: res/res_agi.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_agi.c,v retrieving revision 1.51 diff -u -r1.51 res_agi.c --- res/res_agi.c 4 Oct 2005 22:35:43 -0000 1.51 +++ res/res_agi.c 24 Oct 2005 15:23:59 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Asterisk Gateway Interface + * \brief AGI - the Asterisk Gateway Interface * */ Index: res/res_config_odbc.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_config_odbc.c,v retrieving revision 1.29 diff -u -r1.29 res_config_odbc.c --- res/res_config_odbc.c 14 Sep 2005 20:46:50 -0000 1.29 +++ res/res_config_odbc.c 24 Oct 2005 15:23:59 -0000 @@ -5,7 +5,6 @@ * * Mark Spencer * - * res_config_odbc.c * Copyright (C) 2004 - 2005 Anthony Minessale II * * See http://www.asterisk.org for more information about @@ -19,10 +18,11 @@ * at the top of the source tree. */ -/* - * +/*! \file * + * \brief odbc+odbc plugin for portable configuration engine * + * http://www.unixodbc.org */ #include Index: res/res_crypto.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_crypto.c,v retrieving revision 1.27 diff -u -r1.27 res_crypto.c --- res/res_crypto.c 16 Oct 2005 03:08:58 -0000 1.27 +++ res/res_crypto.c 24 Oct 2005 15:23:59 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Provide Cryptographic Signature capability + * \brief Provide Cryptographic Signature capability * */ Index: res/res_features.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_features.c,v retrieving revision 1.74 diff -u -r1.74 res_features.c --- res/res_features.c 13 Oct 2005 23:58:33 -0000 1.74 +++ res/res_features.c 24 Oct 2005 15:24:00 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * Routines implementing call parking + * \brief Routines implementing call parking * */ Index: res/res_indications.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_indications.c,v retrieving revision 1.15 diff -u -r1.15 res_indications.c --- res/res_indications.c 14 Sep 2005 20:46:50 -0000 1.15 +++ res/res_indications.c 24 Oct 2005 15:24:00 -0000 @@ -3,7 +3,6 @@ * * Copyright (C) 2002, Pauline Middelink * - * Pauline Middelink * * See http://www.asterisk.org for more information about * the Asterisk project. Please do not directly contact @@ -16,10 +15,12 @@ * at the top of the source tree. */ -/** @file res_indications.c +/*! \file res_indications.c * - * Load the indications + * \brief Load the indications * + * \author Pauline Middelink + * * Load the country specific dialtones into the asterisk PBX. */ Index: res/res_monitor.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_monitor.c,v retrieving revision 1.38 diff -u -r1.38 res_monitor.c --- res/res_monitor.c 14 Sep 2005 20:46:50 -0000 1.38 +++ res/res_monitor.c 24 Oct 2005 15:24:00 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* +/*! \file * - * res_monitor.c + * \brief PBX channel monitoring * */ Index: res/res_musiconhold.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_musiconhold.c,v retrieving revision 1.72 diff -u -r1.72 res_musiconhold.c --- res/res_musiconhold.c 19 Oct 2005 03:51:25 -0000 1.72 +++ res/res_musiconhold.c 24 Oct 2005 15:24:01 -0000 @@ -16,9 +16,11 @@ * at the top of the source tree. */ -/* +/*! \file * - * Routines implementing music on hold + * \brief Routines implementing music on hold + * + * \arg See also \ref Config_moh * */ Index: res/res_odbc.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_odbc.c,v retrieving revision 1.20 diff -u -r1.20 res_odbc.c --- res/res_odbc.c 13 Oct 2005 18:01:31 -0000 1.20 +++ res/res_odbc.c 24 Oct 2005 15:24:01 -0000 @@ -20,9 +20,11 @@ */ -/* - * +/*! \file * + * \brief ODBC resource manager + * + * \arg See also: \ref cdrodbc * */ Index: res/res_osp.c =================================================================== RCS file: /usr/cvsroot/asterisk/res/res_osp.c,v retrieving revision 1.24 diff -u -r1.24 res_osp.c --- res/res_osp.c 4 Oct 2005 23:28:57 -0000 1.24 +++ res/res_osp.c 24 Oct 2005 15:24:01 -0000 @@ -16,10 +16,11 @@ * at the top of the source tree. */ -/* +/*! \file * - * Provide Open Settlement Protocol capability + * \brief Provide Open Settlement Protocol capability * + * \arg See also: \ref chan_sip.c */ #include Index: include/asterisk/acl.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/acl.h,v retrieving revision 1.16 diff -u -r1.16 acl.h --- include/asterisk/acl.h 30 Aug 2005 18:32:09 -0000 1.16 +++ include/asterisk/acl.h 24 Oct 2005 15:24:01 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Access Control of various sorts +/*! \file + * \brief Access Control of various sorts */ #ifndef _ASTERISK_ACL_H Index: include/asterisk/adsi.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/adsi.h,v retrieving revision 1.11 diff -u -r1.11 adsi.h --- include/asterisk/adsi.h 7 Sep 2005 18:55:03 -0000 1.11 +++ include/asterisk/adsi.h 24 Oct 2005 15:24:01 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * ADSI Support (built upon Caller*ID) +/*! \file + * \brief ADSI Support (built upon Caller*ID) */ #ifndef _ASTERISK_ADSI_H Index: include/asterisk/aes.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/aes.h,v retrieving revision 1.3 diff -u -r1.3 aes.h --- include/asterisk/aes.h 30 Aug 2005 18:32:09 -0000 1.3 +++ include/asterisk/aes.h 24 Oct 2005 15:24:01 -0000 @@ -39,8 +39,10 @@ and/or fitness for purpose. --------------------------------------------------------------------------- Issue Date: 26/08/2003 +*/ +/*!\file - This file contains the definitions required to use AES in C. See aesopt.h + \brief This file contains the definitions required to use AES in C. See aesopt.h for optimisation details. */ Index: include/asterisk/agi.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/agi.h,v retrieving revision 1.3 diff -u -r1.3 agi.h --- include/asterisk/agi.h 30 Aug 2005 18:32:09 -0000 1.3 +++ include/asterisk/agi.h 24 Oct 2005 15:24:01 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * AGI Extension interfaces +/*! \file + * \brief AGI Extension interfaces - Asterisk Gateway Interface */ #ifndef _ASTERISK_AGI_H Index: include/asterisk/alaw.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/alaw.h,v retrieving revision 1.4 diff -u -r1.4 alaw.h --- include/asterisk/alaw.h 30 Aug 2005 18:32:09 -0000 1.4 +++ include/asterisk/alaw.h 24 Oct 2005 15:24:01 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * A-Law to Signed linear conversion +/*! \file + * \brief A-Law to Signed linear conversion */ #ifndef _ASTERISK_ALAW_H Index: include/asterisk/app.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/app.h,v retrieving revision 1.39 diff -u -r1.39 app.h --- include/asterisk/app.h 14 Sep 2005 17:20:24 -0000 1.39 +++ include/asterisk/app.h 24 Oct 2005 15:24:01 -0000 @@ -15,9 +15,9 @@ * at the top of the source tree. */ -/* - * Application convenience functions, designed to give consistent - * look and feel to Asterisk apps. +/*! \file + * \brief Application convenience functions, designed to give consistent + look and feel to Asterisk apps. */ #ifndef _ASTERISK_APP_H Index: include/asterisk/astdb.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/astdb.h,v retrieving revision 1.3 diff -u -r1.3 astdb.h --- include/asterisk/astdb.h 30 Aug 2005 18:32:09 -0000 1.3 +++ include/asterisk/astdb.h 24 Oct 2005 15:24:01 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Persistant data storage (akin to *doze registry) +/*! \file + * \brief Persistant data storage (akin to *doze registry) */ #ifndef _ASTERISK_ASTDB_H Index: include/asterisk/astmm.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/astmm.h,v retrieving revision 1.3 diff -u -r1.3 astmm.h --- include/asterisk/astmm.h 30 Aug 2005 18:32:09 -0000 1.3 +++ include/asterisk/astmm.h 24 Oct 2005 15:24:01 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Asterisk memory usage debugging +/*! \file + * \brief Asterisk memory usage debugging */ #ifndef NO_AST_MM Index: include/asterisk/astosp.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/astosp.h,v retrieving revision 1.4 diff -u -r1.4 astosp.h --- include/asterisk/astosp.h 30 Aug 2005 18:32:09 -0000 1.4 +++ include/asterisk/astosp.h 24 Oct 2005 15:24:01 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * OSP support +/*! \file + * \brief OSP support (Open Settlement Protocol) */ #ifndef _ASTERISK_OSP_H Index: include/asterisk/callerid.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/callerid.h,v retrieving revision 1.13 diff -u -r1.13 callerid.h --- include/asterisk/callerid.h 30 Aug 2005 18:32:09 -0000 1.13 +++ include/asterisk/callerid.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * CallerID (and other GR30) Generation support +/*! \file + * \brief CallerID (and other GR30) Generation support * Includes code and algorithms from the Zapata library. */ Index: include/asterisk/causes.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/causes.h,v retrieving revision 1.9 diff -u -r1.9 causes.h --- include/asterisk/causes.h 30 Aug 2005 18:32:09 -0000 1.9 +++ include/asterisk/causes.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Internal Asterisk hangup causes +/*! \file + * \brief Internal Asterisk hangup causes */ #ifndef _ASTERISK_CAUSES_H Index: include/asterisk/cdr.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/cdr.h,v retrieving revision 1.29 diff -u -r1.29 cdr.h --- include/asterisk/cdr.h 30 Aug 2005 18:32:09 -0000 1.29 +++ include/asterisk/cdr.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Call Detail Record API +/*! \file + * \brief Call Detail Record API */ #ifndef _ASTERISK_CDR_H @@ -104,26 +104,23 @@ typedef int (*ast_cdrbe)(struct ast_cdr *cdr); -/*! Allocate a record */ -/*! +/*! \brief Allocate a CDR record * Returns a malloc'd ast_cdr structure, returns NULL on error (malloc failure) */ extern struct ast_cdr *ast_cdr_alloc(void); -/*! Duplicate a record */ -/*! +/*! \brief Duplicate a record * Returns a malloc'd ast_cdr structure, returns NULL on error (malloc failure) */ extern struct ast_cdr *ast_cdr_dup(struct ast_cdr *cdr); -/*! Free a record */ -/* \param cdr ast_cdr structure to free +/*! \brief Free a CDR record + * \param cdr ast_cdr structure to free * Returns nothing important */ extern void ast_cdr_free(struct ast_cdr *cdr); -/*! Initialize based on a channel */ -/*! +/*! \brief Initialize based on a channel * \param cdr Call Detail Record to use for channel * \param chan Channel to bind CDR with * Initializes a CDR and associates it with a particular channel Index: include/asterisk/channel.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/channel.h,v retrieving revision 1.106 diff -u -r1.106 channel.h --- include/asterisk/channel.h 16 Oct 2005 16:12:51 -0000 1.106 +++ include/asterisk/channel.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * General Asterisk channel definitions. +/*! \file + * \brief General Asterisk PBX channel definitions. */ #ifndef _ASTERISK_CHANNEL_H Index: include/asterisk/chanvars.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/chanvars.h,v retrieving revision 1.7 diff -u -r1.7 chanvars.h --- include/asterisk/chanvars.h 30 Aug 2005 18:32:09 -0000 1.7 +++ include/asterisk/chanvars.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Channel Variables +/*! \file + * \brief Channel Variables */ #ifndef _ASTERISK_CHANVARS_H Index: include/asterisk/cli.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/cli.h,v retrieving revision 1.9 diff -u -r1.9 cli.h --- include/asterisk/cli.h 30 Aug 2005 18:32:09 -0000 1.9 +++ include/asterisk/cli.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Standard Command Line Interface +/*! \file + * \brief Standard Command Line Interface */ #ifndef _ASTERISK_CLI_H @@ -42,7 +42,7 @@ #define AST_CLI_COMPLETE_EOF "_EOF_" -/*! A command line entry */ +/*! \brief A command line entry */ struct ast_cli_entry { /*! Null terminated list of the words of the command */ char *cmda[AST_MAX_CMD_LEN]; @@ -60,14 +60,13 @@ int inuse; }; -/*! Interprets a command */ -/*! Interpret a command s, sending output to fd +/*! \brief Interprets a command + * Interpret a command s, sending output to fd * Returns 0 on succes, -1 on failure */ extern int ast_cli_command(int fd, char *s); -/*! Registers a command or an array of commands */ -/*! +/*! \brief Registers a command or an array of commands * \param e which cli entry to register * Register your own command * Returns 0 on success, -1 on failure @@ -75,14 +74,14 @@ extern int ast_cli_register(struct ast_cli_entry *e); /*! + * \brief Register multiple commands * \param e pointer to first cli entry to register * \param len number of entries to register - * Register multiple commands */ extern void ast_cli_register_multiple(struct ast_cli_entry *e, int len); -/*! Unregisters a command or an array of commands */ -/*! +/*! \brief Unregisters a command or an array of commands + * * \param e which cli entry to unregister * Unregister your own command. You must pass a completed ast_cli_entry structure * Returns 0. @@ -90,14 +89,14 @@ extern int ast_cli_unregister(struct ast_cli_entry *e); /*! + * \brief Unregister multiple commands * \param e pointer to first cli entry to unregister * \param len number of entries to unregister - * Unregister multiple commands */ extern void ast_cli_unregister_multiple(struct ast_cli_entry *e, int len); -/*! Readline madness */ -/* Useful for readline, that's about it +/*! \brief Readline madness + * Useful for readline, that's about it * Returns 0 on success, -1 on failure */ extern char *ast_cli_generator(char *, char *, int); Index: include/asterisk/compat.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/compat.h,v retrieving revision 1.2 diff -u -r1.2 compat.h --- include/asterisk/compat.h 8 Sep 2005 02:26:35 -0000 1.2 +++ include/asterisk/compat.h 24 Oct 2005 15:24:02 -0000 @@ -1,7 +1,5 @@ /* * Asterisk -- A telephony toolkit for Linux. - * - * General Definitions for Asterisk top level program * * Copyright (C) 1999-2005, Mark Spencer * @@ -11,6 +9,10 @@ * the GNU General Public License */ +/*! \file + * \brief General Definitions for Asterisk top level program + */ + #ifndef _COMPAT_H #define _COMPAT_H Index: include/asterisk/compiler.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/compiler.h,v retrieving revision 1.2 diff -u -r1.2 compiler.h --- include/asterisk/compiler.h 30 Aug 2005 18:32:09 -0000 1.2 +++ include/asterisk/compiler.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Compiler-specific macros and other items +/*! \file + * \brief Compiler-specific macros and other items */ #ifndef _ASTERISK_COMPILER_H Index: include/asterisk/config.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/config.h,v retrieving revision 1.23 diff -u -r1.23 config.h --- include/asterisk/config.h 30 Aug 2005 18:32:09 -0000 1.23 +++ include/asterisk/config.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Configuration File Parser +/*! \file + * \brief Configuration File Parser */ #ifndef _ASTERISK_CONFIG_H @@ -37,8 +37,8 @@ char *name; char *value; int lineno; - int object; /* 0 for variable, 1 for object */ - int blanklines; /* Number of blanklines following entry */ + int object; /*!< 0 for variable, 1 for object */ + int blanklines; /*!< Number of blanklines following entry */ struct ast_comment *precomments; struct ast_comment *sameline; struct ast_variable *next; @@ -59,8 +59,7 @@ struct ast_config_engine *next; }; -/*! Load a config file */ -/*! +/*! \brief Load a config file * \param configfile path of file to open. If no preceding '/' character, path is considered relative to AST_CONFIG_DIR * Create a config structure from a given configuration file. * @@ -68,16 +67,14 @@ */ struct ast_config *ast_config_load(const char *filename); -/*! Destroys a config */ -/*! +/*! \brief Destroys a config * \param config pointer to config data structure * Free memory associated with a given config * */ void ast_config_destroy(struct ast_config *config); -/*! Goes through categories */ -/*! +/*! \brief Goes through categories * \param config Which config structure you wish to "browse" * \param prev A pointer to a previous category. * This funtion is kind of non-intuitive in it's use. To begin, one passes NULL as the second arguement. It will return a pointer to the string of the first category in the file. From here on after, one must then pass the previous usage's return value as the second pointer, and it will return a pointer to the category name afterwards. @@ -86,8 +83,7 @@ */ char *ast_category_browse(struct ast_config *config, const char *prev); -/*! Goes through variables */ -/*! +/*! \brief Goes through variables * Somewhat similar in intent as the ast_category_browse. * List variables of config file category * @@ -95,8 +91,7 @@ */ struct ast_variable *ast_variable_browse(const struct ast_config *config, const char *category); -/*! Gets a variable */ -/*! +/*! \brief Gets a variable * \param config which (opened) config to use * \param category category under which the variable lies * \param value which variable you wish to get the data for @@ -106,8 +101,7 @@ */ char *ast_variable_retrieve(const struct ast_config *config, const char *category, const char *variable); -/*! Retrieve a category if it exists */ -/*! +/*! \brief Retrieve a category if it exists * \param config which config to use * \param category_name name of the category you're looking for * This will search through the categories within a given config file for a match. @@ -116,8 +110,7 @@ */ struct ast_category *ast_category_get(const struct ast_config *config, const char *category_name); -/*! Check for category duplicates */ -/*! +/*! \brief Check for category duplicates * \param config which config to use * \param category_name name of the category you're looking for * This will search through the categories within a given config file for a match. @@ -126,8 +119,7 @@ */ int ast_category_exist(const struct ast_config *config, const char *category_name); -/*! Retrieve realtime configuration */ -/*! +/*! \brief Retrieve realtime configuration * \param family which family/config to lookup * \param keyfield which field to use as the key * \param lookup which value to look for in the key field to match the entry. @@ -138,8 +130,7 @@ */ struct ast_variable *ast_load_realtime(const char *family, ...); -/*! Retrieve realtime configuration */ -/*! +/*! \brief Retrieve realtime configuration * \param family which family/config to lookup * \param keyfield which field to use as the key * \param lookup which value to look for in the key field to match the entry. @@ -151,8 +142,7 @@ */ struct ast_config *ast_load_realtime_multientry(const char *family, ...); -/*! Update realtime configuration */ -/*! +/*! \brief Update realtime configuration * \param family which family/config to be updated * \param keyfield which field to use as the key * \param lookup which value to look for in the key field to match the entry. @@ -163,21 +153,24 @@ */ int ast_update_realtime(const char *family, const char *keyfield, const char *lookup, ...); -/*! Check if realtime engine is configured for family - returns 1 if family is configured in realtime and engine exists - \param family which family/config to be checked +/*! \brief Check if realtime engine is configured for family + * returns 1 if family is configured in realtime and engine exists + * \param family which family/config to be checked */ int ast_check_realtime(const char *family); -/*! Free variable list */ -/*! +/*! \brief Free variable list * \param var the linked list of variables to free * This function frees a list of variables. */ void ast_variables_destroy(struct ast_variable *var); +/*! \brief Register config engine */ int ast_config_engine_register(struct ast_config_engine *newconfig); + +/*! \brief Deegister config engine */ int ast_config_engine_deregister(struct ast_config_engine *del); + int register_config_cli(void); void read_config_maps(void); Index: include/asterisk/crypto.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/crypto.h,v retrieving revision 1.8 diff -u -r1.8 crypto.h --- include/asterisk/crypto.h 16 Oct 2005 03:08:58 -0000 1.8 +++ include/asterisk/crypto.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Provide cryptographic signature routines +/*! \file + * \brief Provide cryptographic signature routines */ #ifndef _ASTERISK_CRYPTO_H @@ -35,8 +35,7 @@ struct ast_key; -/*! Retrieve a key */ -/*! +/*! \brief Retrieve a key * \param name of the key we are retrieving * \param int type of key (AST_KEY_PUBLIC or AST_KEY_PRIVATE) * @@ -44,8 +43,7 @@ */ extern struct ast_key *(*ast_key_get)(const char *key, int type); -/*! Check the authenticity of a message signature using a given public key */ -/*! +/*! \brief Check the authenticity of a message signature using a given public key * \param key a public key to use to verify * \param msg the message that has been signed * \param sig the proposed valid signature in mime64-like encoding @@ -55,8 +53,7 @@ */ extern int (*ast_check_signature)(struct ast_key *key, const char *msg, const char *sig); -/*! Check the authenticity of a message signature using a given public key */ -/*! +/*! \brief Check the authenticity of a message signature using a given public key * \param key a public key to use to verify * \param msg the message that has been signed * \param sig the proposed valid signature in raw binary representation @@ -76,6 +73,7 @@ * */ extern int (*ast_sign)(struct ast_key *key, char *msg, char *sig); + /*! * \param key a private key to use to create the signature * \param msg the message to sign Index: include/asterisk/devicestate.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/devicestate.h,v retrieving revision 1.4 diff -u -r1.4 devicestate.h --- include/asterisk/devicestate.h 17 Oct 2005 15:41:55 -0000 1.4 +++ include/asterisk/devicestate.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Device state management +/*! \file + * \brief Device state management */ #ifndef _ASTERISK_DEVICESTATE_H @@ -44,12 +44,12 @@ typedef int (*ast_devstate_cb_type)(const char *dev, int state, void *data); -/*! Convert device state to text string for output */ -/*! \param devstate Current device state */ +/*! \brief Convert device state to text string for output + * \param devstate Current device state + */ const char *devstate2str(int devstate); -/*! Search the Channels by Name */ -/*! +/*! \brief Search the Channels by Name * \param device like a dialstring * Search the Device in active channels by compare the channelname against * the devicename. Compared are only the first chars to the first '-' char. @@ -58,8 +58,7 @@ */ int ast_parse_device_state(const char *device); -/*! Asks a channel for device state */ -/*! +/*! \brief Asks a channel for device state * \param device like a dialstring * Asks a channel for device state, data is normaly a number from dialstring * used by the low level module @@ -69,8 +68,7 @@ */ int ast_device_state(const char *device); -/*! Tells Asterisk the State for Device is changed */ -/*! +/*! \brief Tells Asterisk the State for Device is changed * \param fmt devicename like a dialstring with format parameters * Asterisk polls the new extensionstates and calls the registered * callbacks for the changed extensions @@ -80,8 +78,7 @@ __attribute__ ((format (printf, 1, 2))); -/*! Tells Asterisk the State for Device is changed */ -/*! +/*! \brief Tells Asterisk the State for Device is changed * \param device devicename like a dialstrin * Asterisk polls the new extensionstates and calls the registered * callbacks for the changed extensions @@ -89,8 +86,7 @@ */ int ast_device_state_changed_literal(const char *device); -/*! Registers a device state change callback */ -/*! +/*! \brief Registers a device state change callback * \param data to pass to callback * The callback is called if the state for extension is changed * Return -1 on failure, ID on success Index: include/asterisk/dns.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/dns.h,v retrieving revision 1.4 diff -u -r1.4 dns.h --- include/asterisk/dns.h 30 Aug 2005 18:32:09 -0000 1.4 +++ include/asterisk/dns.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,9 @@ * at the top of the source tree. */ -/* - * DNS support +/*! \file + * \brief DNS support for Asterisk + * \author Thorsten Lockert */ #ifndef _ASTERISK_DNS_H Index: include/asterisk/dnsmgr.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/dnsmgr.h,v retrieving revision 1.2 diff -u -r1.2 dnsmgr.h --- include/asterisk/dnsmgr.h 30 Aug 2005 18:32:09 -0000 1.2 +++ include/asterisk/dnsmgr.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Background DNS update manager +/*! \file + * \brief Background DNS update manager */ #ifndef _ASTERISK_DNSMGR_H Index: include/asterisk/dsp.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/dsp.h,v retrieving revision 1.9 diff -u -r1.9 dsp.h --- include/asterisk/dsp.h 30 Aug 2005 18:32:09 -0000 1.9 +++ include/asterisk/dsp.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Convenient Signal Processing routines +/*! \file + * \brief Convenient Signal Processing routines */ #ifndef _ASTERISK_DSP_H @@ -56,55 +56,56 @@ struct ast_dsp *ast_dsp_new(void); void ast_dsp_free(struct ast_dsp *dsp); -/* Set threshold value for silence */ + +/*! \brief Set threshold value for silence */ void ast_dsp_set_threshold(struct ast_dsp *dsp, int threshold); -/* Set number of required cadences for busy */ +/*! \brief Set number of required cadences for busy */ void ast_dsp_set_busy_count(struct ast_dsp *dsp, int cadences); -/* Set expected lengths of the busy tone */ +/*! \brief Set expected lengths of the busy tone */ void ast_dsp_set_busy_pattern(struct ast_dsp *dsp, int tonelength, int quietlength); -/* Scans for progress indication in audio */ +/*! \brief Scans for progress indication in audio */ int ast_dsp_call_progress(struct ast_dsp *dsp, struct ast_frame *inf); -/* Set zone for doing progress detection */ +/*! \brief Set zone for doing progress detection */ int ast_dsp_set_call_progress_zone(struct ast_dsp *dsp, char *zone); -/* Return AST_FRAME_NULL frames when there is silence, AST_FRAME_BUSY on +/*! \brief Return AST_FRAME_NULL frames when there is silence, AST_FRAME_BUSY on busies, and call progress, all dependent upon which features are enabled */ struct ast_frame *ast_dsp_process(struct ast_channel *chan, struct ast_dsp *dsp, struct ast_frame *inf); -/* Return non-zero if this is silence. Updates "totalsilence" with the total +/*! \brief Return non-zero if this is silence. Updates "totalsilence" with the total number of seconds of silence */ int ast_dsp_silence(struct ast_dsp *dsp, struct ast_frame *f, int *totalsilence); -/* Return non-zero if historically this should be a busy, request that +/*! \brief Return non-zero if historically this should be a busy, request that ast_dsp_silence has already been called */ int ast_dsp_busydetect(struct ast_dsp *dsp); -/* Return non-zero if DTMF hit was found */ +/*! \brief Return non-zero if DTMF hit was found */ int ast_dsp_digitdetect(struct ast_dsp *dsp, struct ast_frame *f); -/* Reset total silence count */ +/*! \brief Reset total silence count */ void ast_dsp_reset(struct ast_dsp *dsp); -/* Reset DTMF detector */ +/*! \brief Reset DTMF detector */ void ast_dsp_digitreset(struct ast_dsp *dsp); -/* Select feature set */ +/*! \brief Select feature set */ void ast_dsp_set_features(struct ast_dsp *dsp, int features); -/* Get pending DTMF/MF digits */ +/*! \brief Get pending DTMF/MF digits */ int ast_dsp_getdigits(struct ast_dsp *dsp, char *buf, int max); -/* Set digit mode */ +/*! \brief Set digit mode */ int ast_dsp_digitmode(struct ast_dsp *dsp, int digitmode); -/* Get tstate (Tone State) */ +/*! \brief Get tstate (Tone State) */ int ast_dsp_get_tstate(struct ast_dsp *dsp); -/* Get tcount (Threshold counter) */ +/*! \brief Get tcount (Threshold counter) */ int ast_dsp_get_tcount(struct ast_dsp *dsp); #endif /* _ASTERISK_DSP_H */ Index: include/asterisk/dundi.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/dundi.h,v retrieving revision 1.10 diff -u -r1.10 dundi.h --- include/asterisk/dundi.h 30 Aug 2005 18:32:09 -0000 1.10 +++ include/asterisk/dundi.h 24 Oct 2005 15:24:02 -0000 @@ -16,8 +16,9 @@ * at the top of the source tree. */ -/* - * Distributed Universal Number Discovery (DUNDi) +/*! \file + * \brief Distributed Universal Number Discovery (DUNDi) + * See also \ref AstDUNDI */ #ifndef _ASTERISK_DUNDI_H @@ -27,7 +28,7 @@ #define DUNDI_PORT 4520 -/* A DUNDi Entity ID is essentially a MAC address, brief and unique */ +/*!\brief A DUNDi Entity ID is essentially a MAC address, brief and unique */ struct _dundi_eid { unsigned char eid[6]; } __attribute__ ((__packed__)); @@ -35,12 +36,12 @@ typedef struct _dundi_eid dundi_eid; struct dundi_hdr { - unsigned short strans; /* Source transaction */ - unsigned short dtrans; /* Destination transaction */ - unsigned char iseqno; /* Next expected incoming sequence number */ - unsigned char oseqno; /* Outgoing sequence number */ - unsigned char cmdresp; /* Command / Response */ - unsigned char cmdflags; /* Command / Response specific flags*/ + unsigned short strans; /*!< Source transaction */ + unsigned short dtrans; /*!< Destination transaction */ + unsigned char iseqno; /*!< Next expected incoming sequence number */ + unsigned char oseqno; /*!< Outgoing sequence number */ + unsigned char cmdresp; /*!< Command / Response */ + unsigned char cmdflags; /*!< Command / Response specific flags*/ unsigned char ies[0]; } __attribute__ ((__packed__)); @@ -50,60 +51,60 @@ unsigned char iedata[0]; } __attribute__ ((__packed__)); -#define DUNDI_FLAG_RETRANS (1 << 16) /* Applies to dtrans */ -#define DUNDI_FLAG_RESERVED (1 << 16) /* Applies to strans */ +#define DUNDI_FLAG_RETRANS (1 << 16) /*!< Applies to dtrans */ +#define DUNDI_FLAG_RESERVED (1 << 16) /*!< Applies to strans */ -#define DUNDI_PROTO_NONE 0 /* No answer yet */ -#define DUNDI_PROTO_IAX 1 /* IAX version 2 */ -#define DUNDI_PROTO_SIP 2 /* Session Initiation Protocol */ -#define DUNDI_PROTO_H323 3 /* ITU H.323 */ - -#define DUNDI_FLAG_NONEXISTENT (0) /* Isn't and can't be a valid number */ -#define DUNDI_FLAG_EXISTS (1 << 0) /* Is a valid number */ -#define DUNDI_FLAG_MATCHMORE (1 << 1) /* Might be valid if you add more digits */ -#define DUNDI_FLAG_CANMATCH (1 << 2) /* Might be a match */ -#define DUNDI_FLAG_IGNOREPAT (1 << 3) /* Keep dialtone */ -#define DUNDI_FLAG_RESIDENTIAL (1 << 4) /* Destination known to be residential */ -#define DUNDI_FLAG_COMMERCIAL (1 << 5) /* Destination known to be commercial */ -#define DUNDI_FLAG_MOBILE (1 << 6) /* Destination known to be cellular/mobile */ -#define DUNDI_FLAG_NOUNSOLICITED (1 << 7) /* No unsolicited calls of any kind through this route */ -#define DUNDI_FLAG_NOCOMUNSOLICIT (1 << 8) /* No commercial unsolicited calls through this route */ - -#define DUNDI_HINT_NONE (0) -#define DUNDI_HINT_TTL_EXPIRED (1 << 0) /* TTL Expired */ -#define DUNDI_HINT_DONT_ASK (1 << 1) /* Don't ask for anything beginning with data */ -#define DUNDI_HINT_UNAFFECTED (1 << 2) /* Answer not affected by entity list */ - -struct dundi_encblock { /* AES-128 encrypted block */ - unsigned char iv[16]; /* Initialization vector of random data */ - unsigned char encdata[0]; /* Encrypted / compressed data */ +#define DUNDI_PROTO_NONE 0 /*!< No answer yet */ +#define DUNDI_PROTO_IAX 1 /*!< IAX version 2 */ +#define DUNDI_PROTO_SIP 2 /*!< Session Initiation Protocol */ +#define DUNDI_PROTO_H323 3 /*!< ITU H.323 */ + +#define DUNDI_FLAG_NONEXISTENT (0) /*!< Isn't and can't be a valid number */ +#define DUNDI_FLAG_EXISTS (1 << 0) /*!< Is a valid number */ +#define DUNDI_FLAG_MATCHMORE (1 << 1) /*!< Might be valid if you add more digits */ +#define DUNDI_FLAG_CANMATCH (1 << 2) /*!< Might be a match */ +#define DUNDI_FLAG_IGNOREPAT (1 << 3) /*!< Keep dialtone */ +#define DUNDI_FLAG_RESIDENTIAL (1 << 4) /*!< Destination known to be residential */ +#define DUNDI_FLAG_COMMERCIAL (1 << 5) /*!< Destination known to be commercial */ +#define DUNDI_FLAG_MOBILE (1 << 6) /*!< Destination known to be cellular/mobile */ +#define DUNDI_FLAG_NOUNSOLICITED (1 << 7) /*!< No unsolicited calls of any kind through this route */ +#define DUNDI_FLAG_NOCOMUNSOLICIT (1 << 8) /*!< No commercial unsolicited calls through this route */ + +#define DUNDI_HINT_NONE (0) +#define DUNDI_HINT_TTL_EXPIRED (1 << 0) /*!< TTL Expired */ +#define DUNDI_HINT_DONT_ASK (1 << 1) /*!< Don't ask for anything beginning with data */ +#define DUNDI_HINT_UNAFFECTED (1 << 2) /*!< Answer not affected by entity list */ + +struct dundi_encblock { /*!< AES-128 encrypted block */ + unsigned char iv[16]; /*!< Initialization vector of random data */ + unsigned char encdata[0]; /*!< Encrypted / compressed data */ } __attribute__ ((__packed__)); struct dundi_answer { - dundi_eid eid; /* Original source of answer */ - unsigned char protocol; /* Protocol (DUNDI_PROTO_*) */ - unsigned short flags; /* Flags relating to answer */ - unsigned short weight; /* Weight of answers */ - unsigned char data[0]; /* Protocol specific URI */ + dundi_eid eid; /*!< Original source of answer */ + unsigned char protocol; /*!< Protocol (DUNDI_PROTO_*) */ + unsigned short flags; /*!< Flags relating to answer */ + unsigned short weight; /*!< Weight of answers */ + unsigned char data[0]; /*!< Protocol specific URI */ } __attribute__ ((__packed__)); struct dundi_hint { - unsigned short flags; /* Flags relating to answer */ - unsigned char data[0]; /* For data for hint */ + unsigned short flags; /*!< Flags relating to answer */ + unsigned char data[0]; /*!< For data for hint */ } __attribute__ ((__packed__)); -#define DUNDI_CAUSE_SUCCESS 0 /* Success */ -#define DUNDI_CAUSE_GENERAL 1 /* General unspecified failure */ -#define DUNDI_CAUSE_DYNAMIC 2 /* Requested entity is dynamic */ -#define DUNDI_CAUSE_NOAUTH 3 /* No or improper authorization */ -#define DUNDI_CAUSE_DUPLICATE 4 /* Duplicate request */ -#define DUNDI_CAUSE_TTL_EXPIRED 5 /* Expired TTL */ -#define DUNDI_CAUSE_NEEDKEY 6 /* Need new session key to decode */ -#define DUNDI_CAUSE_BADENCRYPT 7 /* Badly encrypted data */ +#define DUNDI_CAUSE_SUCCESS 0 /*!< Success */ +#define DUNDI_CAUSE_GENERAL 1 /*!< General unspecified failure */ +#define DUNDI_CAUSE_DYNAMIC 2 /*!< Requested entity is dynamic */ +#define DUNDI_CAUSE_NOAUTH 3 /*!< No or improper authorization */ +#define DUNDI_CAUSE_DUPLICATE 4 /*!< Duplicate request */ +#define DUNDI_CAUSE_TTL_EXPIRED 5 /*!< Expired TTL */ +#define DUNDI_CAUSE_NEEDKEY 6 /*!< Need new session key to decode */ +#define DUNDI_CAUSE_BADENCRYPT 7 /*!< Badly encrypted data */ struct dundi_cause { - unsigned char causecode; /* Numerical cause (DUNDI_CAUSE_*) */ - char desc[0]; /* Textual description */ + unsigned char causecode; /*!< Numerical cause (DUNDI_CAUSE_*) */ + char desc[0]; /*!< Textual description */ } __attribute__ ((__packed__)); struct dundi_peer_status { @@ -113,7 +114,7 @@ dundi_eid peereid; } __attribute__ ((__packed__)); -#define DUNDI_PEER_PRIMARY (1 << 0) +#define DUNDI_PEER_PRIMARY (1 << 0) #define DUNDI_PEER_SECONDARY (1 << 1) #define DUNDI_PEER_UNAVAILABLE (1 << 2) #define DUNDI_PEER_REGISTERED (1 << 3) @@ -122,73 +123,73 @@ #define DUNDI_PEER_PCMOD_OUTBOUND (1 << 6) #define DUNDI_PEER_PCMOD_INBOUND (1 << 7) -#define DUNDI_COMMAND_FINAL (0x80) /* Or'd with other flags */ +#define DUNDI_COMMAND_FINAL (0x80) /*!< Or'd with other flags */ -#define DUNDI_COMMAND_ACK (0 | 0x40) /* Ack a message */ -#define DUNDI_COMMAND_DPDISCOVER 1 /* Request discovery */ -#define DUNDI_COMMAND_DPRESPONSE (2 | 0x40) /* Respond to a discovery request */ -#define DUNDI_COMMAND_EIDQUERY 3 /* Request information for a peer */ -#define DUNDI_COMMAND_EIDRESPONSE (4 | 0x40) /* Response to a peer query */ -#define DUNDI_COMMAND_PRECACHERQ 5 /* Pre-cache Request */ -#define DUNDI_COMMAND_PRECACHERP (6 | 0x40) /* Pre-cache Response */ -#define DUNDI_COMMAND_INVALID (7 | 0x40) /* Invalid dialog state (does not require ack) */ -#define DUNDI_COMMAND_UNKNOWN (8 | 0x40) /* Unknown command */ -#define DUNDI_COMMAND_NULL 9 /* No-op */ -#define DUNDI_COMMAND_REGREQ (10) /* Register Request */ -#define DUNDI_COMMAND_REGRESPONSE (11 | 0x40) /* Register Response */ -#define DUNDI_COMMAND_CANCEL (12) /* Cancel transaction entirely */ -#define DUNDI_COMMAND_ENCRYPT (13) /* Send an encrypted message */ -#define DUNDI_COMMAND_ENCREJ (14 | 0x40) /* Reject an encrypted message */ +#define DUNDI_COMMAND_ACK (0 | 0x40) /*!< Ack a message */ +#define DUNDI_COMMAND_DPDISCOVER 1 /*!< Request discovery */ +#define DUNDI_COMMAND_DPRESPONSE (2 | 0x40) /*!< Respond to a discovery request */ +#define DUNDI_COMMAND_EIDQUERY 3 /*!< Request information for a peer */ +#define DUNDI_COMMAND_EIDRESPONSE (4 | 0x40) /*!< Response to a peer query */ +#define DUNDI_COMMAND_PRECACHERQ 5 /*!< Pre-cache Request */ +#define DUNDI_COMMAND_PRECACHERP (6 | 0x40) /*!< Pre-cache Response */ +#define DUNDI_COMMAND_INVALID (7 | 0x40) /*!< Invalid dialog state (does not require ack) */ +#define DUNDI_COMMAND_UNKNOWN (8 | 0x40) /*!< Unknown command */ +#define DUNDI_COMMAND_NULL 9 /*!< No-op */ +#define DUNDI_COMMAND_REGREQ (10) /*!< Register Request */ +#define DUNDI_COMMAND_REGRESPONSE (11 | 0x40) /*!< Register Response */ +#define DUNDI_COMMAND_CANCEL (12) /*!< Cancel transaction entirely */ +#define DUNDI_COMMAND_ENCRYPT (13) /*!< Send an encrypted message */ +#define DUNDI_COMMAND_ENCREJ (14 | 0x40) /*!< Reject an encrypted message */ -#define DUNDI_COMMAND_STATUS 15 /* Status command */ +#define DUNDI_COMMAND_STATUS 15 /*!< Status command */ /* * Remember that some information elements may occur * more than one time within a message */ -#define DUNDI_IE_EID 1 /* Entity identifier (dundi_eid) */ -#define DUNDI_IE_CALLED_CONTEXT 2 /* DUNDi Context (string) */ -#define DUNDI_IE_CALLED_NUMBER 3 /* Number of equivalent (string) */ -#define DUNDI_IE_EID_DIRECT 4 /* Entity identifier (dundi_eid), direct connect */ -#define DUNDI_IE_ANSWER 5 /* An answer (struct dundi_answer) */ -#define DUNDI_IE_TTL 6 /* Max TTL for this request / Remaining TTL for the response (short)*/ -#define DUNDI_IE_VERSION 10 /* DUNDi version (should be 1) (short) */ -#define DUNDI_IE_EXPIRATION 11 /* Recommended expiration (short) */ -#define DUNDI_IE_UNKNOWN 12 /* Unknown command (byte) */ -#define DUNDI_IE_CAUSE 14 /* Success or cause of failure */ -#define DUNDI_IE_REQEID 15 /* EID being requested for EIDQUERY*/ -#define DUNDI_IE_ENCDATA 16 /* AES-128 encrypted data */ -#define DUNDI_IE_SHAREDKEY 17 /* RSA encrypted AES-128 key */ -#define DUNDI_IE_SIGNATURE 18 /* RSA Signature of encrypted shared key */ -#define DUNDI_IE_KEYCRC32 19 /* CRC32 of encrypted key (int) */ -#define DUNDI_IE_HINT 20 /* Answer hints (struct ast_hint) */ - -#define DUNDI_IE_DEPARTMENT 21 /* Department, for EIDQUERY (string) */ -#define DUNDI_IE_ORGANIZATION 22 /* Organization, for EIDQUERY (string) */ -#define DUNDI_IE_LOCALITY 23 /* City/Locality, for EIDQUERY (string) */ -#define DUNDI_IE_STATE_PROV 24 /* State/Province, for EIDQUERY (string) */ -#define DUNDI_IE_COUNTRY 25 /* Country, for EIDQUERY (string) */ -#define DUNDI_IE_EMAIL 26 /* E-mail addy, for EIDQUERY (string) */ -#define DUNDI_IE_PHONE 27 /* Contact Phone, for EIDQUERY (string) */ -#define DUNDI_IE_IPADDR 28 /* IP Address, for EIDQUERY (string) */ -#define DUNDI_IE_CACHEBYPASS 29 /* Bypass cache (empty) */ +#define DUNDI_IE_EID 1 /*!< Entity identifier (dundi_eid) */ +#define DUNDI_IE_CALLED_CONTEXT 2 /*!< DUNDi Context (string) */ +#define DUNDI_IE_CALLED_NUMBER 3 /*!< Number of equivalent (string) */ +#define DUNDI_IE_EID_DIRECT 4 /*!< Entity identifier (dundi_eid), direct connect */ +#define DUNDI_IE_ANSWER 5 /*!< An answer (struct dundi_answer) */ +#define DUNDI_IE_TTL 6 /*!< Max TTL for this request / Remaining TTL for the response (short)*/ +#define DUNDI_IE_VERSION 10 /*!< DUNDi version (should be 1) (short) */ +#define DUNDI_IE_EXPIRATION 11 /*!< Recommended expiration (short) */ +#define DUNDI_IE_UNKNOWN 12 /*!< Unknown command (byte) */ +#define DUNDI_IE_CAUSE 14 /*!< Success or cause of failure */ +#define DUNDI_IE_REQEID 15 /*!< EID being requested for EIDQUERY*/ +#define DUNDI_IE_ENCDATA 16 /*!< AES-128 encrypted data */ +#define DUNDI_IE_SHAREDKEY 17 /*!< RSA encrypted AES-128 key */ +#define DUNDI_IE_SIGNATURE 18 /*!< RSA Signature of encrypted shared key */ +#define DUNDI_IE_KEYCRC32 19 /*!< CRC32 of encrypted key (int) */ +#define DUNDI_IE_HINT 20 /*!< Answer hints (struct ast_hint) */ + +#define DUNDI_IE_DEPARTMENT 21 /*!< Department, for EIDQUERY (string) */ +#define DUNDI_IE_ORGANIZATION 22 /*!< Organization, for EIDQUERY (string) */ +#define DUNDI_IE_LOCALITY 23 /*!< City/Locality, for EIDQUERY (string) */ +#define DUNDI_IE_STATE_PROV 24 /*!< State/Province, for EIDQUERY (string) */ +#define DUNDI_IE_COUNTRY 25 /*!< Country, for EIDQUERY (string) */ +#define DUNDI_IE_EMAIL 26 /*!< E-mail addy, for EIDQUERY (string) */ +#define DUNDI_IE_PHONE 27 /*!< Contact Phone, for EIDQUERY (string) */ +#define DUNDI_IE_IPADDR 28 /*!< IP Address, for EIDQUERY (string) */ +#define DUNDI_IE_CACHEBYPASS 29 /*!< Bypass cache (empty) */ -#define DUNDI_IE_PEERSTATUS 30 /* Peer/peer status (struct dundi_peer_status) */ +#define DUNDI_IE_PEERSTATUS 30 /*!< Peer/peer status (struct dundi_peer_status) */ -#define DUNDI_FLUFF_TIME 2000 /* Amount of time for answer */ -#define DUNDI_TTL_TIME 200 /* Incremental average time */ +#define DUNDI_FLUFF_TIME 2000 /*!< Amount of time for answer */ +#define DUNDI_TTL_TIME 200 /*!< Incremental average time */ #define DUNDI_DEFAULT_RETRANS 5 #define DUNDI_DEFAULT_RETRANS_TIMER 1000 -#define DUNDI_DEFAULT_TTL 120 /* In seconds/hops like TTL */ +#define DUNDI_DEFAULT_TTL 120 /*!< In seconds/hops like TTL */ #define DUNDI_DEFAULT_VERSION 1 -#define DUNDI_DEFAULT_CACHE_TIME 3600 /* In seconds */ -#define DUNDI_DEFAULT_KEY_EXPIRE 3600 /* Life of shared key In seconds */ -#define DUNDI_DEF_EMPTY_CACHE_TIME 60 /* In seconds, cache of empty answer */ -#define DUNDI_WINDOW 1 /* Max 1 message in window */ +#define DUNDI_DEFAULT_CACHE_TIME 3600 /*!< In seconds */ +#define DUNDI_DEFAULT_KEY_EXPIRE 3600 /*!< Life of shared key In seconds */ +#define DUNDI_DEF_EMPTY_CACHE_TIME 60 /*!< In seconds, cache of empty answer */ +#define DUNDI_WINDOW 1 /*!< Max 1 message in window */ -#define DEFAULT_MAXMS 2000 +#define DEFAULT_MAXMS 2000 struct dundi_result { unsigned int flags; @@ -212,14 +213,14 @@ char ipaddr[80]; }; -/* Lookup the given number in the given dundi context (or e164 if unspecified) using the given callerid (if specified) and return up to maxret results in the array specified. +/*! \brief Lookup the given number in the given dundi context (or e164 if unspecified) using the given callerid (if specified) and return up to maxret results in the array specified. returns the number of results found or -1 on a hangup of teh channel. */ int dundi_lookup(struct dundi_result *result, int maxret, struct ast_channel *chan, const char *dcontext, const char *number, int nocache); -/* Retrieve information on a specific EID */ +/*! \brief Retrieve information on a specific EID */ int dundi_query_eid(struct dundi_entity_info *dei, const char *dcontext, dundi_eid eid); -/* Pre-cache to push upstream peers */ +/*! \brief Pre-cache to push upstream peers */ int dundi_precache(const char *dcontext, const char *number); #endif /* _ASTERISK_DUNDI_H */ Index: include/asterisk/endian.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/endian.h,v retrieving revision 1.5 diff -u -r1.5 endian.h --- include/asterisk/endian.h 8 Sep 2005 02:19:02 -0000 1.5 +++ include/asterisk/endian.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Asterisk architecture endianess compatibility definitions +/*! \file + * \brief Asterisk architecture endianess compatibility definitions */ #ifndef _ASTERISK_ENDIAN_H Index: include/asterisk/enum.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/enum.h,v retrieving revision 1.7 diff -u -r1.7 enum.h --- include/asterisk/enum.h 14 Sep 2005 01:36:15 -0000 1.7 +++ include/asterisk/enum.h 24 Oct 2005 15:24:03 -0000 @@ -16,10 +16,6 @@ * at the top of the source tree. */ -/* - * ENUM support - */ - /*! \file enum.h \brief DNS and ENUM functions */ @@ -45,6 +41,7 @@ */ extern int ast_get_enum(struct ast_channel *chan, const char *number, char *location, int maxloc, char *technology, int maxtech, char* suffix, char* options); + /*! \brief Lookup DNS TXT record (used by app TXTCIDnum \param chan Channel \param number E164 number with or without the leading + Index: include/asterisk/features.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/features.h,v retrieving revision 1.6 diff -u -r1.6 features.h --- include/asterisk/features.h 30 Aug 2005 18:32:09 -0000 1.6 +++ include/asterisk/features.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Call Parking and Pickup API +/*! \file + * \brief Call Parking and Pickup API * Includes code and algorithms from the Zapata library. */ @@ -30,7 +30,7 @@ #define FEATURE_SNAME_LEN 32 #define FEATURE_EXTEN_LEN 32 -/* main call feature structure */ +/*! \brief main call feature structure */ struct ast_call_feature { int feature_mask; char *fname; @@ -46,8 +46,8 @@ -/*! Park a call and read back parked location */ -/*! \param chan the channel to actually be parked +/*! \brief Park a call and read back parked location + * \param chan the channel to actually be parked \param host the channel which will have the parked location read to Park the channel chan, and read back the parked location to the host. If the call is not picked up within a specified period of @@ -57,8 +57,9 @@ \param extout is a parameter to an int that will hold the parked location, or NULL if you want */ extern int ast_park_call(struct ast_channel *chan, struct ast_channel *host, int timeout, int *extout); -/*! Park a call via a masqueraded channel */ -/*! \param rchan the real channel to be parked + +/*! \brief Park a call via a masqueraded channel + * \param rchan the real channel to be parked \param host the channel to have the parking read to Masquerade the channel rchan into a new, empty channel which is then parked with ast_park_call @@ -67,25 +68,27 @@ */ extern int ast_masq_park_call(struct ast_channel *rchan, struct ast_channel *host, int timeout, int *extout); -/*! Determine system parking extension */ -/*! Returns the call parking extension for drivers that provide special +/*! \brief Determine system parking extension + * Returns the call parking extension for drivers that provide special call parking help */ extern char *ast_parking_ext(void); -extern char *ast_pickup_ext(void); -/*! Bridge a call, optionally allowing redirection */ +/*! \brief Determine system call pickup extension */ +extern char *ast_pickup_ext(void); +/*! \brief Bridge a call, optionally allowing redirection */ extern int ast_bridge_call(struct ast_channel *chan, struct ast_channel *peer,struct ast_bridge_config *config); +/*! \brief Pickup a call */ extern int ast_pickup_call(struct ast_channel *chan); -/*! register new feature into feature_set +/*! \brief register new feature into feature_set \param feature an ast_call_feature object which contains a keysequence and a callback function which is called when this keysequence is pressed during a call. */ extern void ast_register_feature(struct ast_call_feature *feature); -/*! unregister feature from feature_set +/*! \brief unregister feature from feature_set \param feature the ast_call_feature object which was registered before*/ extern void ast_unregister_feature(struct ast_call_feature *feature); Index: include/asterisk/file.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/file.h,v retrieving revision 1.27 diff -u -r1.27 file.h --- include/asterisk/file.h 16 Oct 2005 16:12:51 -0000 1.27 +++ include/asterisk/file.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Generic File Format Support. +/*! \file + * \brief Generic File Format Support. */ #ifndef _ASTERISK_FILE_H Index: include/asterisk/frame.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/frame.h,v retrieving revision 1.58 diff -u -r1.58 frame.h --- include/asterisk/frame.h 29 Sep 2005 17:40:24 -0000 1.58 +++ include/asterisk/frame.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Asterisk internal frame definitions. +/*! \file + * \brief Asterisk internal frame definitions. */ #ifndef _ASTERISK_FRAME_H Index: include/asterisk/fskmodem.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/fskmodem.h,v retrieving revision 1.2 diff -u -r1.2 fskmodem.h --- include/asterisk/fskmodem.h 30 Aug 2005 18:32:09 -0000 1.2 +++ include/asterisk/fskmodem.h 24 Oct 2005 15:24:03 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* - * FSK Modem Support - * Includes code and algorithms from the Zapata library. +/*! \file + * \brief FSK Modem Support + * \note Includes code and algorithms from the Zapata library. */ #ifndef _ASTERISK_FSKMODEM_H @@ -57,7 +57,8 @@ float cola_demod[NCOLA]; /* Cola de muestras demoduladas */ } fsk_data; -/* Retrieve a serial byte into outbyte. Buffer is a pointer into a series of +/* \brief Retrieve a serial byte into outbyte. + Buffer is a pointer into a series of shorts and len records the number of bytes in the buffer. len will be overwritten with the number of bytes left that were not consumed, and the return value is as follows: Index: include/asterisk/image.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/image.h,v retrieving revision 1.4 diff -u -r1.4 image.h --- include/asterisk/image.h 30 Aug 2005 18:32:09 -0000 1.4 +++ include/asterisk/image.h 24 Oct 2005 15:24:03 -0000 @@ -16,14 +16,14 @@ * at the top of the source tree. */ -/* - * General Asterisk channel definitions. +/*! \file + * \brief General Asterisk channel definitions for image handling */ #ifndef _ASTERISK_IMAGE_H #define _ASTERISK_IMAGE_H -/*! structure associated with registering an image format */ +/*! \brief structure associated with registering an image format */ struct ast_imager { /*! Name */ char *name; Index: include/asterisk/indications.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/indications.h,v retrieving revision 1.5 diff -u -r1.5 indications.h --- include/asterisk/indications.h 30 Aug 2005 18:32:09 -0000 1.5 +++ include/asterisk/indications.h 24 Oct 2005 15:24:03 -0000 @@ -8,8 +8,8 @@ * channels for your use. */ -/* - * BSD Telephony Of Mexico "Tormenta" Tone Zone Support 2/22/01 +/*! \file + * \brief BSD Telephony Of Mexico "Tormenta" Tone Zone Support 2/22/01 * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published by Index: include/asterisk/inline_api.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/inline_api.h,v retrieving revision 1.2 diff -u -r1.2 inline_api.h --- include/asterisk/inline_api.h 30 Aug 2005 18:32:09 -0000 1.2 +++ include/asterisk/inline_api.h 24 Oct 2005 15:24:03 -0000 @@ -16,14 +16,12 @@ * at the top of the source tree. */ -/* - * Inlinable API function macro - */ - #ifndef __ASTERISK_INLINEAPI_H #define __ASTERISK_INLINEAPI_H -/* +/*! \file + * \brief Inlinable API function macro + Small API functions that are candidates for inlining need to be specially declared and defined, to ensure that the 'right thing' always happens. For example: Index: include/asterisk/io.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/io.h,v retrieving revision 1.9 diff -u -r1.9 io.h --- include/asterisk/io.h 26 Sep 2005 17:17:56 -0000 1.9 +++ include/asterisk/io.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * I/O Management (derived from Cheops-NG) +/*! \file + * \brief I/O Management (derived from Cheops-NG) */ #ifndef _ASTERISK_IO_H Index: include/asterisk/localtime.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/localtime.h,v retrieving revision 1.3 diff -u -r1.3 localtime.h --- include/asterisk/localtime.h 30 Aug 2005 18:32:09 -0000 1.3 +++ include/asterisk/localtime.h 24 Oct 2005 15:24:03 -0000 @@ -17,8 +17,8 @@ * at the top of the source tree. */ -/* - * Custom localtime functions for multiple timezones +/*! \file + * \brief Custom localtime functions for multiple timezones */ #ifndef _ASTERISK_LOCALTIME_H Index: include/asterisk/lock.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/lock.h,v retrieving revision 1.37 diff -u -r1.37 lock.h --- include/asterisk/lock.h 9 Sep 2005 05:35:14 -0000 1.37 +++ include/asterisk/lock.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * General Asterisk channel definitions. +/*! \file + * \brief General Asterisk channel locking definitions. */ #ifndef _ASTERISK_LOCK_H @@ -35,7 +35,7 @@ #ifdef __APPLE__ /* Provide the Linux initializers for MacOS X */ -#define PTHREAD_MUTEX_RECURSIVE_NP PTHREAD_MUTEX_RECURSIVE +#define PTHREAD_MUTEX_RECURSIVE_NP PTHREAD_MUTEX_RECURSIVE #define PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP { 0x4d555458, \ { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, \ 0x20 } } Index: include/asterisk/manager.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/manager.h,v retrieving revision 1.21 diff -u -r1.21 manager.h --- include/asterisk/manager.h 4 Oct 2005 22:25:15 -0000 1.21 +++ include/asterisk/manager.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * AMI - Asterisk Management Interface +/*! \file + * \brief AMI - Asterisk Management Interface * External call management support */ Index: include/asterisk/md5.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/md5.h,v retrieving revision 1.5 diff -u -r1.5 md5.h --- include/asterisk/md5.h 30 Aug 2005 18:32:09 -0000 1.5 +++ include/asterisk/md5.h 24 Oct 2005 15:24:03 -0000 @@ -16,6 +16,10 @@ * at the top of the source tree. */ +/*!\file + * \brief MD5 digest functions + */ + #ifndef _ASTERISK_MD5_H #define _ASTERISK_MD5_H Index: include/asterisk/monitor.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/monitor.h,v retrieving revision 1.5 diff -u -r1.5 monitor.h --- include/asterisk/monitor.h 30 Aug 2005 18:32:09 -0000 1.5 +++ include/asterisk/monitor.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Channel monitoring +/*! \file + * \brief Channel monitoring */ #ifndef _ASTERISK_MONITOR_H Index: include/asterisk/musiconhold.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/musiconhold.h,v retrieving revision 1.5 diff -u -r1.5 musiconhold.h --- include/asterisk/musiconhold.h 30 Aug 2005 18:32:09 -0000 1.5 +++ include/asterisk/musiconhold.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Music on hold handling +/*! \file + * \brief Music on hold handling */ #ifndef _ASTERISK_MOH_H Index: include/asterisk/netsock.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/netsock.h,v retrieving revision 1.2 diff -u -r1.2 netsock.h --- include/asterisk/netsock.h 30 Aug 2005 18:32:09 -0000 1.2 +++ include/asterisk/netsock.h 24 Oct 2005 15:24:03 -0000 @@ -17,8 +17,8 @@ * at the top of the source tree. */ -/* - * Network socket handling +/*! \file + * \brief Network socket handling */ #ifndef _ASTERISK_NETSOCK_H Index: include/asterisk/options.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/options.h,v retrieving revision 1.17 diff -u -r1.17 options.h --- include/asterisk/options.h 30 Aug 2005 18:32:09 -0000 1.17 +++ include/asterisk/options.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Options provided by main asterisk program +/*! \file + * \brief Options provided by main asterisk program */ #ifndef _ASTERISK_OPTIONS_H Index: include/asterisk/pbx.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/pbx.h,v retrieving revision 1.53 diff -u -r1.53 pbx.h --- include/asterisk/pbx.h 13 Sep 2005 21:59:45 -0000 1.53 +++ include/asterisk/pbx.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Core PBX routines and definitions. +/*! \file + * \brief Core PBX routines and definitions. */ #ifndef _ASTERISK_PBX_H Index: include/asterisk/plc.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/plc.h,v retrieving revision 1.3 diff -u -r1.3 plc.h --- include/asterisk/plc.h 22 Mar 2005 19:24:32 -0000 1.3 +++ include/asterisk/plc.h 24 Oct 2005 15:24:03 -0000 @@ -1,9 +1,9 @@ -/* - * SpanDSP - a series of DSP components for telephony +/*! \file + * \brief SpanDSP - a series of DSP components for telephony * * plc.h * - * Written by Steve Underwood + * \author Steve Underwood * * Copyright (C) 2004 Steve Underwood * @@ -27,7 +27,6 @@ * This version is disclaimed to DIGIUM for inclusion in the Asterisk project. */ -/*! \file */ #if !defined(_PLC_H_) #define _PLC_H_ Index: include/asterisk/privacy.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/privacy.h,v retrieving revision 1.2 diff -u -r1.2 privacy.h --- include/asterisk/privacy.h 30 Aug 2005 18:32:10 -0000 1.2 +++ include/asterisk/privacy.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Persistant data storage (akin to *doze registry) +/*! \file + * \brief Persistant data storage (akin to *doze registry) */ #ifndef _ASTERISK_PRIVACY_H Index: include/asterisk/res_odbc.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/res_odbc.h,v retrieving revision 1.6 diff -u -r1.6 res_odbc.h --- include/asterisk/res_odbc.h 13 Oct 2005 18:01:31 -0000 1.6 +++ include/asterisk/res_odbc.h 24 Oct 2005 15:24:03 -0000 @@ -18,8 +18,8 @@ * at the top of the source tree. */ -/* - * ODBC resource manager +/*! \file + * \brief ODBC resource manager */ #ifndef _ASTERISK_RES_ODBC_H Index: include/asterisk/rtp.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/rtp.h,v retrieving revision 1.26 diff -u -r1.26 rtp.h --- include/asterisk/rtp.h 13 Oct 2005 18:27:54 -0000 1.26 +++ include/asterisk/rtp.h 24 Oct 2005 15:24:03 -0000 @@ -20,7 +20,7 @@ * \file rtp.h * \brief Supports RTP and RTCP with Symmetric RTP support for NAT traversal. * - * RTP is deffined in RFC 3550. + * RTP is defined in RFC 3550. */ #ifndef _ASTERISK_RTP_H Index: include/asterisk/say.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/say.h,v retrieving revision 1.13 diff -u -r1.13 say.h --- include/asterisk/say.h 30 Aug 2005 18:32:10 -0000 1.13 +++ include/asterisk/say.h 24 Oct 2005 15:24:03 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Say numbers and dates (maybe words one day too) +/*! \file + * \brief Say numbers and dates (maybe words one day too) */ #ifndef _ASTERISK_SAY_H Index: include/asterisk/sched.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/sched.h,v retrieving revision 1.10 diff -u -r1.10 sched.h --- include/asterisk/sched.h 30 Aug 2005 18:32:10 -0000 1.10 +++ include/asterisk/sched.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Scheduler Routines (derived from cheops) +/*! \file + * \brief Scheduler Routines (derived from cheops) */ #ifndef _ASTERISK_SCHED_H Index: include/asterisk/slinfactory.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/slinfactory.h,v retrieving revision 1.2 diff -u -r1.2 slinfactory.h --- include/asterisk/slinfactory.h 30 Aug 2005 18:32:10 -0000 1.2 +++ include/asterisk/slinfactory.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * A machine to gather up arbitrary frames and convert them +/*! \file + * \brief A machine to gather up arbitrary frames and convert them * to raw slinear on demand. */ Index: include/asterisk/srv.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/srv.h,v retrieving revision 1.4 diff -u -r1.4 srv.h --- include/asterisk/srv.h 30 Aug 2005 18:32:10 -0000 1.4 +++ include/asterisk/srv.h 24 Oct 2005 15:24:04 -0000 @@ -28,7 +28,7 @@ /*! \file srv.h \brief Support for DNS SRV records, used in to locate SIP services. - Note: The Asterisk DNS SRV record support is broken, it only + \note Note: The Asterisk DNS SRV record support is broken, it only supports the first DNS SRV record and will give no load balancing or failover support. */ Index: include/asterisk/strings.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/strings.h,v retrieving revision 1.11 diff -u -r1.11 strings.h --- include/asterisk/strings.h 1 Oct 2005 15:41:27 -0000 1.11 +++ include/asterisk/strings.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * String manipulation functions +/*! \file + * \brief String manipulation functions */ #ifndef _ASTERISK_STRINGS_H Index: include/asterisk/tdd.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/tdd.h,v retrieving revision 1.4 diff -u -r1.4 tdd.h --- include/asterisk/tdd.h 30 Aug 2005 18:32:10 -0000 1.4 +++ include/asterisk/tdd.h 24 Oct 2005 15:24:04 -0000 @@ -16,9 +16,9 @@ * at the top of the source tree. */ -/* - * TTY/TDD Generation support - * Includes code and algorithms from the Zapata library. +/*! \file + * \brief TTY/TDD Generation support + * \note Includes code and algorithms from the Zapata library. */ #ifndef _ASTERISK_TDD_H Index: include/asterisk/term.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/term.h,v retrieving revision 1.4 diff -u -r1.4 term.h --- include/asterisk/term.h 30 Aug 2005 18:32:10 -0000 1.4 +++ include/asterisk/term.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Handy terminal functions for vt* terms +/*! \file + * \brief Handy terminal functions for vt* terms */ #ifndef _ASTERISK_TERM_H @@ -29,22 +29,22 @@ #define ESC 0x1b #define ATTR_RESET 0 -#define ATTR_BRIGHT 1 +#define ATTR_BRIGHT 1 #define ATTR_DIM 2 #define ATTR_UNDER 4 #define ATTR_BLINK 5 #define ATTR_REVER 7 -#define ATTR_HIDDEN 8 +#define ATTR_HIDDEN 8 #define COLOR_BLACK 30 #define COLOR_GRAY 30 | 128 -#define COLOR_RED 31 -#define COLOR_BRRED 31 | 128 -#define COLOR_GREEN 32 +#define COLOR_RED 31 +#define COLOR_BRRED 31 | 128 +#define COLOR_GREEN 32 #define COLOR_BRGREEN 32 | 128 -#define COLOR_BROWN 33 +#define COLOR_BROWN 33 #define COLOR_YELLOW 33 | 128 -#define COLOR_BLUE 34 +#define COLOR_BLUE 34 #define COLOR_BRBLUE 34 | 128 #define COLOR_MAGENTA 35 #define COLOR_BRMAGENTA 35 | 128 Index: include/asterisk/time.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/time.h,v retrieving revision 1.8 diff -u -r1.8 time.h --- include/asterisk/time.h 30 Aug 2005 18:32:10 -0000 1.8 +++ include/asterisk/time.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Time-related functions and macros +/*! \file + * \brief Time-related functions and macros */ #ifndef _ASTERISK_TIME_H Index: include/asterisk/transcap.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/transcap.h,v retrieving revision 1.2 diff -u -r1.2 transcap.h --- include/asterisk/transcap.h 30 Aug 2005 18:32:10 -0000 1.2 +++ include/asterisk/transcap.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * General Asterisk channel definitions. +/*! \file + * \brief General Asterisk channel transcoding definitions. */ #ifndef _ASTERISK_TRANSCAP_H Index: include/asterisk/translate.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/translate.h,v retrieving revision 1.9 diff -u -r1.9 translate.h --- include/asterisk/translate.h 30 Aug 2005 18:32:10 -0000 1.9 +++ include/asterisk/translate.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Translate via the use of pseudo channels +/*! \file + * \brief Translate via the use of pseudo channels */ #ifndef _ASTERISK_TRANSLATE_H Index: include/asterisk/ulaw.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/ulaw.h,v retrieving revision 1.4 diff -u -r1.4 ulaw.h --- include/asterisk/ulaw.h 30 Aug 2005 18:32:10 -0000 1.4 +++ include/asterisk/ulaw.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * u-Law to Signed linear conversion +/*! \file + * \brief u-Law to Signed linear conversion */ #ifndef _ASTERISK_ULAW_H Index: include/asterisk/unaligned.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/unaligned.h,v retrieving revision 1.3 diff -u -r1.3 unaligned.h --- include/asterisk/unaligned.h 30 Aug 2005 18:32:10 -0000 1.3 +++ include/asterisk/unaligned.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Handle unaligned data access +/*! \file + * \brief Handle unaligned data access */ #ifndef _ASTERISK_UNALIGNED_H Index: include/asterisk/utils.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/utils.h,v retrieving revision 1.45 diff -u -r1.45 utils.h --- include/asterisk/utils.h 16 Oct 2005 03:10:33 -0000 1.45 +++ include/asterisk/utils.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Utility functions +/*! \file + * \brief Utility functions */ #ifndef _ASTERISK_UTILS_H @@ -34,7 +34,9 @@ #include "asterisk/time.h" #include "asterisk/strings.h" -/* Note: +/*! \note + \verbatim + Note: It is very important to use only unsigned variables to hold bit flags, as otherwise you can fall prey to the compiler's sign-extension antics if you try to use the top two bits in @@ -46,13 +48,13 @@ type of variable, a warning message similar to this: warning: comparison of distinct pointer types lacks cast - will be generated. The "dummy" variable below is used to make these comparisons. Also note that at -O2 or above, this type-safety checking does _not_ produce any additional object code at all. + \endverbatim */ extern unsigned int __unsigned_int_flags_dummy; Index: include/asterisk/vmodem.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/vmodem.h,v retrieving revision 1.20 diff -u -r1.20 vmodem.h --- include/asterisk/vmodem.h 30 Aug 2005 18:32:10 -0000 1.20 +++ include/asterisk/vmodem.h 24 Oct 2005 15:24:04 -0000 @@ -16,8 +16,8 @@ * at the top of the source tree. */ -/* - * Voice Modem Definitions +/*! \file + * \brief Voice Modem Definitions */ #ifndef _ASTERISK_VMODEM_H @@ -35,13 +35,13 @@ #define MODEM_DEV_SPKRPHONE 6 #define MODEM_DEV_HANDSET 9 -#define MODEM_DTMF_NONE (1 << 0) -#define MODEM_DTMF_AST (1 << 1) -#define MODEM_DTMF_I4L (1 << 2) +#define MODEM_DTMF_NONE (1 << 0) +#define MODEM_DTMF_AST (1 << 1) +#define MODEM_DTMF_I4L (1 << 2) /* Thirty millisecond sections */ -#define MODEM_MAX_LEN 30 -#define MODEM_MAX_BUF MODEM_MAX_LEN * 16 +#define MODEM_MAX_LEN 30 +#define MODEM_MAX_BUF MODEM_MAX_LEN * 16 #define AST_MAX_INIT_STR 256