Doxygen documentation update from oej (issue #5505)

git-svn-id: http://svn.digium.com/svn/asterisk/trunk@6847 f38db490-d61c-443f-a65b-d21fe96a405b

10 files changed, 28 insertions, 22 deletions

diff --git a/res/res_adsi.c b/res/res_adsi.c
index 3ebe53bda..18e7849f3 100755
--- a/res/res_adsi.c
+++ b/res/res_adsi.c
@@ -18,9 +18,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * ADSI support 
+ * \brief ADSI support 
  * 
  */
 
diff --git a/res/res_agi.c b/res/res_agi.c
index 5645b79cb..36e0e2803 100755
--- a/res/res_agi.c
+++ b/res/res_agi.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Asterisk Gateway Interface
+ * \brief AGI - the Asterisk Gateway Interface
  * 
  */
 
diff --git a/res/res_config_odbc.c b/res/res_config_odbc.c
index e1d6e83b6..73d280d0b 100755
--- a/res/res_config_odbc.c
+++ b/res/res_config_odbc.c
@@ -5,7 +5,6 @@
  *
  * Mark Spencer <markster@digium.com>
  *
- * res_config_odbc.c <odbc+odbc plugin for portable configuration engine >
  * Copyright (C) 2004 - 2005 Anthony Minessale II <anthmct@yahoo.com>
  *
  * 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 <stdlib.h>
diff --git a/res/res_crypto.c b/res/res_crypto.c
index 006238c2d..037ff8e79 100755
--- a/res/res_crypto.c
+++ b/res/res_crypto.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Provide Cryptographic Signature capability
+ * \brief Provide Cryptographic Signature capability
  * 
  */
 
diff --git a/res/res_features.c b/res/res_features.c
index 87fe851d5..2d1f852fe 100755
--- a/res/res_features.c
+++ b/res/res_features.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
  *
- * Routines implementing call parking
+ * \brief Routines implementing call parking
  * 
  */
 
diff --git a/res/res_indications.c b/res/res_indications.c
index 18b486fb3..f53ea7665 100755
--- a/res/res_indications.c
+++ b/res/res_indications.c
@@ -3,7 +3,6 @@
  *
  * Copyright (C) 2002, Pauline Middelink
  *
- * Pauline Middelink <middelink@polyware.nl>
  *
  * 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 <middelink@polyware.nl>
+ *
  * Load the country specific dialtones into the asterisk PBX.
  */
  
diff --git a/res/res_monitor.c b/res/res_monitor.c
index 7b048cb74..89fb5aef9 100755
--- a/res/res_monitor.c
+++ b/res/res_monitor.c
@@ -16,9 +16,9 @@
  * at the top of the source tree.
  */
 
-/* 
+/*! \file
  *
- * res_monitor.c 
+ * \brief PBX channel monitoring
  *
  */
  
diff --git a/res/res_musiconhold.c b/res/res_musiconhold.c
index 8d9c845b8..e029265dd 100755
--- a/res/res_musiconhold.c
+++ b/res/res_musiconhold.c
@@ -16,9 +16,11 @@
  * at the top of the source tree.
  */
 
-/*
+/*! \file
+ *
+ * \brief Routines implementing music on hold
  *
- * Routines implementing music on hold
+ * \arg See also \ref Config_moh
  * 
  */
 
diff --git a/res/res_odbc.c b/res/res_odbc.c
index 2c58ce72e..987275a19 100755
--- a/res/res_odbc.c
+++ b/res/res_odbc.c
@@ -20,9 +20,11 @@
  */
 
 
-/*
- *
+/*! \file
  *
+ * \brief ODBC resource manager
+ * 
+ * \arg See also: \ref cdrodbc
  *
  */
 
diff --git a/res/res_osp.c b/res/res_osp.c
index dca948c72..41ca8c0cf 100755
--- a/res/res_osp.c
+++ b/res/res_osp.c
@@ -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 <sys/types.h>