From 02bcd5bfb6b30bb4f9bff0150a1813cd4c5359c3 Mon Sep 17 00:00:00 2001
From: Andrew Latham <lathama@gmail.com>
Date: Sun, 14 Oct 2012 21:46:45 +0000
Subject: [PATCH] Doxygen Updates - Title update

Update and extend the configuration_file group and enable linking.  Update title that was left behind many years ago.

(issue ASTERISK-20259)


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@375005 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 cdr/Makefile            | 2 +-
 cdr/cdr_adaptive_odbc.c | 9 +++++++++
 cdr/cdr_csv.c           | 4 ++++
 cdr/cdr_custom.c        | 9 +++++++++
 cdr/cdr_manager.c       | 9 +++++++++
 cdr/cdr_odbc.c          | 9 +++++++++
 cdr/cdr_pgsql.c         | 9 +++++++++
 cdr/cdr_radius.c        | 4 ++++
 cdr/cdr_syslog.c        | 9 +++++++++
 9 files changed, 63 insertions(+), 1 deletion(-)

diff --git a/cdr/Makefile b/cdr/Makefile
index 8ea490ae32..865bb3f119 100644
--- a/cdr/Makefile
+++ b/cdr/Makefile
@@ -1,5 +1,5 @@
 #
-# Asterisk -- A telephony toolkit for Linux.
+# Asterisk -- An open source telephony toolkit.
 #
 # Makefile for CDR backends
 #
diff --git a/cdr/cdr_adaptive_odbc.c b/cdr/cdr_adaptive_odbc.c
index 3f4c78654f..4bf3602cbc 100644
--- a/cdr/cdr_adaptive_odbc.c
+++ b/cdr/cdr_adaptive_odbc.c
@@ -24,6 +24,15 @@
  * \ingroup cdr_drivers
  */
 
+/*! \li \ref cdr_adaptive_odbc.c uses the configuration file \ref cdr_adaptive_odbc.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
+/*!
+ * \page cdr_adaptive_odbc.conf cdr_adaptive_odbc.conf
+ * \verbinclude cdr_adaptive_odbc.conf.sample
+ */
+
 /*** MODULEINFO
 	<depend>res_odbc</depend>
 	<support_level>core</support_level>
diff --git a/cdr/cdr_csv.c b/cdr/cdr_csv.c
index b629290ebe..5cfde82d7d 100644
--- a/cdr/cdr_csv.c
+++ b/cdr/cdr_csv.c
@@ -28,6 +28,10 @@
  * \ingroup cdr_drivers
  */
 
+/*! \li \ref cdr_csv.c uses the configuration file \ref cdr.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
 /*** MODULEINFO
 	<support_level>extended</support_level>
  ***/
diff --git a/cdr/cdr_custom.c b/cdr/cdr_custom.c
index b56b7bed15..290e5344da 100644
--- a/cdr/cdr_custom.c
+++ b/cdr/cdr_custom.c
@@ -30,6 +30,15 @@
  * \ingroup cdr_drivers
  */
 
+/*! \li \ref cdr_custom.c uses the configuration file \ref cdr_custom.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
+/*!
+ * \page cdr_custom.conf cdr_custom.conf
+ * \verbinclude cdr_custom.conf.sample
+ */
+
 /*** MODULEINFO
 	<support_level>core</support_level>
  ***/
diff --git a/cdr/cdr_manager.c b/cdr/cdr_manager.c
index 0d9f46dc41..a82bcf9895 100644
--- a/cdr/cdr_manager.c
+++ b/cdr/cdr_manager.c
@@ -25,6 +25,15 @@
  * \ingroup cdr_drivers
  */
 
+/*! \li \ref cdr_manager.c uses the configuration file \ref cdr_manager.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
+/*!
+ * \page cdr_manager.conf cdr_manager.conf
+ * \verbinclude cdr_manager.conf.sample
+ */
+
 /*** MODULEINFO
 	<support_level>core</support_level>
  ***/
diff --git a/cdr/cdr_odbc.c b/cdr/cdr_odbc.c
index e940b9353b..0b601d2925 100644
--- a/cdr/cdr_odbc.c
+++ b/cdr/cdr_odbc.c
@@ -28,6 +28,15 @@
  * \ingroup cdr_drivers
  */
 
+/*! \li \ref cdr_odbc.c uses the configuration file \ref cdr_odbc.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
+/*!
+ * \page cdr_odbc.conf cdr_odbc.conf
+ * \verbinclude cdr_odbc.conf.sample
+ */
+
 /*** MODULEINFO
 	<depend>res_odbc</depend>
 	<support_level>extended</support_level>
diff --git a/cdr/cdr_pgsql.c b/cdr/cdr_pgsql.c
index 7bcbd4a892..906f0227c7 100644
--- a/cdr/cdr_pgsql.c
+++ b/cdr/cdr_pgsql.c
@@ -33,6 +33,15 @@
  * \ingroup cdr_drivers
  */
 
+/*! \li \ref cdr_pgsql.c uses the configuration file \ref cdr_pgsql.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
+/*!
+ * \page cdr_pgsql.conf cdr_pgsql.conf
+ * \verbinclude cdr_pgsql.conf.sample
+ */
+
 /*** MODULEINFO
 	<depend>pgsql</depend>
 	<support_level>extended</support_level>
diff --git a/cdr/cdr_radius.c b/cdr/cdr_radius.c
index 101d1abb2d..92ec8a4b48 100644
--- a/cdr/cdr_radius.c
+++ b/cdr/cdr_radius.c
@@ -28,6 +28,10 @@
  * \ingroup cdr_drivers
  */
 
+/*! \li \ref cdr_radius.c uses the configuration file \ref cdr.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
 /*** MODULEINFO
 	<depend>radius</depend>
 	<support_level>extended</support_level>
diff --git a/cdr/cdr_syslog.c b/cdr/cdr_syslog.c
index e59381280c..8a7f07713a 100644
--- a/cdr/cdr_syslog.c
+++ b/cdr/cdr_syslog.c
@@ -27,6 +27,15 @@
  * \ingroup cdr_drivers
  */
 
+/*! \li \ref cdr_syslog.c uses the configuration file \ref cdr_syslog.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
+/*!
+ * \page cdr_syslog.conf cdr_syslog.conf
+ * \verbinclude cdr_syslog.conf.sample
+ */
+
 /*** MODULEINFO
 	<depend>syslog</depend>
 	<support_level>core</support_level>
-- 
GitLab