Doxygen updates, formatting.

misdn stuff needs a lot of doxygenification

(Hello, Qwell :-) )


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

10 files changed, 57 insertions, 0 deletions

diff --git a/channels/DialTone.h b/channels/DialTone.h
index 098ed44d7..e71ba0c7d 100644
--- a/channels/DialTone.h
+++ b/channels/DialTone.h
@@ -9,6 +9,11 @@
   *
   */
 
+/*! \file
+ * \brief
+ * 8-bit raw data
+ */
+
 static unsigned char DialTone[] = {
 0xff, 0xab, 0x9d, 0x96, 0x91, 0x90, 0x91, 0x96, 0x9c, 0xaa, 
 0xd9, 0x2f, 0x1f, 0x19, 0x15, 0x14, 0x15, 0x19, 0x1f, 0x2c, 
diff --git a/channels/gentone.c b/channels/gentone.c
index 29bd88e91..fc97e389e 100644
--- a/channels/gentone.c
+++ b/channels/gentone.c
@@ -1,6 +1,11 @@
 /* Generate a header file for a particular 
    single or double frequency */
 
+/*! \file
+ * \brief
+ * Generate a header file for a particular single or double frequency 
+ */
+
 #include <stdio.h>
 #include <math.h>
 #include <string.h>
diff --git a/channels/iax2.h b/channels/iax2.h
index 99748814d..b3947fffa 100644
--- a/channels/iax2.h
+++ b/channels/iax2.h
@@ -10,6 +10,15 @@
  * This program is free software, distributed under the terms of
  * the GNU General Public License
  */
+
+/*! \file
+ * \brief
+ *
+ * Implementation of Inter-Asterisk eXchange, version 2
+ * \ref iax2-parser.c
+ * \ref iax2-parser.h
+ * \ref chan_iax2.c
+ */
  
 #ifndef _IAX2_H
 #define _IAX2_H
diff --git a/channels/misdn/chan_misdn_config.h b/channels/misdn/chan_misdn_config.h
index f9475bd03..8c27f4f24 100644
--- a/channels/misdn/chan_misdn_config.h
+++ b/channels/misdn/chan_misdn_config.h
@@ -11,6 +11,12 @@
  * the GNU General Public License
  */
 
+/*! \file \brief
+ * Interface to mISDN - Config
+ * \author Christian Richter <crich@beronet.com>
+ */
+
+
 
 
 #ifndef CHAN_MISDN_CONFIG_H
diff --git a/channels/misdn/ie.c b/channels/misdn/ie.c
index 9c783cd10..817e3d8cb 100644
--- a/channels/misdn/ie.c
+++ b/channels/misdn/ie.c
@@ -15,6 +15,11 @@
  * the GNU General Public License
  */
 
+/*! \file \brief
+ * Interface to mISDN
+ * \author Christian Richter <crich@beronet.com>
+ */
+
 /*
   the pointer of enc_ie_* always points to the IE itself
   if qi is not NULL (TE-mode), offset is set
diff --git a/channels/misdn/isdn_lib.c b/channels/misdn/isdn_lib.c
index 888887d6e..67ecb47fa 100644
--- a/channels/misdn/isdn_lib.c
+++ b/channels/misdn/isdn_lib.c
@@ -11,6 +11,12 @@
  * the GNU General Public License
  */
 
+/*! \file \brief
+ * Interface to mISDN
+ * \author Christian Richter <crich@beronet.com>
+ */
+
+
 
 #include <syslog.h>
 #include <mISDNuser/isdn_debug.h>
diff --git a/channels/misdn/isdn_lib.h b/channels/misdn/isdn_lib.h
index 5dc374c4f..731d497b3 100644
--- a/channels/misdn/isdn_lib.h
+++ b/channels/misdn/isdn_lib.h
@@ -11,6 +11,13 @@
  * the GNU General Public License
  */
 
+/*! \file \brief
+ * 
+ * Interface to mISDN
+ *
+ * \author Christian Richter <crich@beronet.com>
+ */
+
 #ifndef TE_LIB
 #define TE_LIB
 
diff --git a/channels/misdn/isdn_msg_parser.c b/channels/misdn/isdn_msg_parser.c
index 720f43d0d..ebaf6a92f 100644
--- a/channels/misdn/isdn_msg_parser.c
+++ b/channels/misdn/isdn_msg_parser.c
@@ -11,6 +11,12 @@
  * the GNU General Public License
  */
 
+/*! \file \brief
+ * Interface to mISDN - message parser
+ * \author Christian Richter <crich@beronet.com>
+ */
+
+
 
 #include "isdn_lib_intern.h"
 
diff --git a/channels/misdn/portinfo.c b/channels/misdn/portinfo.c
index bcb9f0313..8223164e5 100644
--- a/channels/misdn/portinfo.c
+++ b/channels/misdn/portinfo.c
@@ -1,3 +1,7 @@
+/*! \file \brief
+ * Interface to mISDN - ???
+ * \author Christian Richter <crich@beronet.com>
+ */
 
 
 #include "isdn_lib.h"
diff --git a/channels/ringtone.h b/channels/ringtone.h
index 559c42a7b..f4eac96fc 100644
--- a/channels/ringtone.h
+++ b/channels/ringtone.h
@@ -1,5 +1,9 @@
 /* ringtone.h: Generated from frequencies 440 and 480 
    by gentone.  200 samples  */
+/*! \file
+    \brief
+ Generated from frequencies 440 and 480 by gentone.  200 samples 
+*/
 static short ringtone[200] = {
 	    0, 11581, 21659, 28927, 32445, 31764, 26981, 18727, 
 	 8084, -3559, -14693, -23875, -29927, -32083, -30088, -24228,