16 files changed, 43 insertions, 34 deletions
diff --git a/channels/chan_agent.c b/channels/chan_agent.c
index d81aea333..4b9359391 100755
--- a/channels/chan_agent.c
+++ b/channels/chan_agent.c
@@ -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.
  */
 
diff --git a/channels/chan_alsa.c b/channels/chan_alsa.c
index 9d2241eb3..25b251fd4 100755
--- a/channels/chan_alsa.c
+++ b/channels/chan_alsa.c
@@ -16,6 +16,10 @@
  * at the top of the source tree.
  */
 
+/*! \file 
+ * \brief ALSA sound card channel driver 
+ */
+
 
 #include <unistd.h>
 #include <fcntl.h>
diff --git a/channels/chan_features.c b/channels/chan_features.c
index 9e436ae6f..cd69d5d9e 100755
--- a/channels/chan_features.c
+++ b/channels/chan_features.c
@@ -16,11 +16,11 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * feature Proxy Channel
+ * \brief feature Proxy Channel
  * 
- * *** Experimental code ****
+ * \note *** Experimental code ****
  * 
  */
 
diff --git a/channels/chan_h323.c b/channels/chan_h323.c
index 1c0f31b17..e98638bb5 100755
--- a/channels/chan_h323.c
+++ b/channels/chan_h323.c
@@ -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
  *
  */
 
diff --git a/channels/chan_iax2.c b/channels/chan_iax2.c
index e0575500e..2e11a3744 100755
--- a/channels/chan_iax2.c
+++ b/channels/chan_iax2.c
@@ -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
  *
  */
 
diff --git a/channels/chan_local.c b/channels/chan_local.c
index dcd06100a..8e62f1a3f 100755
--- a/channels/chan_local.c
+++ b/channels/chan_local.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Local Proxy Channel
+ * \brief Local Proxy Channel
  * 
  */
 
diff --git a/channels/chan_mgcp.c b/channels/chan_mgcp.c
index 74019bffa..329c72da1 100755
--- a/channels/chan_mgcp.c
+++ b/channels/chan_mgcp.c
@@ -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
  * 
  */
 
diff --git a/channels/chan_modem.c b/channels/chan_modem.c
index c8ee153f0..3eb3ce500 100755
--- a/channels/chan_modem.c
+++ b/channels/chan_modem.c
@@ -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)
  * 
  */
 
diff --git a/channels/chan_modem_i4l.c b/channels/chan_modem_i4l.c
index 72d7b8775..0a5e1d136 100755
--- a/channels/chan_modem_i4l.c
+++ b/channels/chan_modem_i4l.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * ISDN4Linux TTY Driver
+ * \brief ISDN4Linux TTY Driver
  * 
  */
 
diff --git a/channels/chan_nbs.c b/channels/chan_nbs.c
index 7f6ced6b4..3c6583f8f 100755
--- a/channels/chan_nbs.c
+++ b/channels/chan_nbs.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Generic Linux Telephony Interface driver
+ * \brief Generic Linux Telephony Interface driver
  * 
  */
 
diff --git a/channels/chan_oss.c b/channels/chan_oss.c
index 900b69f97..eb5065382 100755
--- a/channels/chan_oss.c
+++ b/channels/chan_oss.c
@@ -19,9 +19,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * 
+ * \brief Channel driver for OSS sound cards
  *
  */
 
diff --git a/channels/chan_phone.c b/channels/chan_phone.c
index ad9f2c723..e1a65b2da 100755
--- a/channels/chan_phone.c
+++ b/channels/chan_phone.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Generic Linux Telephony Interface driver
+ * \brief Generic Linux Telephony Interface driver
  * 
  */
 
diff --git a/channels/chan_sip.c b/channels/chan_sip.c
index accd7b4f1..c5177fe3b 100755
--- a/channels/chan_sip.c
+++ b/channels/chan_sip.c
@@ -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
  */
 
 
diff --git a/channels/chan_skinny.c b/channels/chan_skinny.c
index 1d556d859..498cc12cc 100755
--- a/channels/chan_skinny.c
+++ b/channels/chan_skinny.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Implementation of the Skinny protocol
+ * \brief Implementation of the Skinny protocol
  * 
  */
 
diff --git a/channels/chan_vpb.c b/channels/chan_vpb.c
index 93ab04e67..f27fb4fe2 100755
--- a/channels/chan_vpb.c
+++ b/channels/chan_vpb.c
@@ -22,9 +22,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * VoiceTronix Interface driver
+ * \brief VoiceTronix Interface driver
  * 
  */
 
diff --git a/channels/chan_zap.c b/channels/chan_zap.c
index 7e41b6579..de6448459 100755
--- a/channels/chan_zap.c
+++ b/channels/chan_zap.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Zaptel Pseudo TDM interface 
+ * \brief Zaptel Pseudo TDM interface 
  * 
  */