Doxygen Updates - Title update

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

(issue ASTERISK-20259)


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

res/Makefile

@@ -1,5 +1,5 @@
 #
-# Asterisk -- A telephony toolkit for Linux.
+# Asterisk -- An open source telephony toolkit.
 # 
 # Makefile for resource modules
 #

res/res_calendar.c

@@ -23,8 +23,7 @@
  * \todo Support writing attendees
  */
 
-/*!
+/*! \li \ref res_calendar.c uses the configuration file \ref calendar.conf
- * \li The resource res_calendar uses the configuration file \ref calendar.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_clialiases.c

@@ -26,8 +26,7 @@
  * CLI commands.
  */
 
-/*!
+/*! \li \ref res_clialiases.c uses the configuration file \ref cli_aliases.conf
- * \li The resource res_clialiases uses the configuration file \ref cli_aliases.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_config_ldap.c

@@ -1,5 +1,5 @@
 /*
- * Asterisk -- A telephony toolkit for Linux.
+ * Asterisk -- An open source telephony toolkit.
  *
  * Copyright (C) 2005, Oxymium sarl
  * Manuel Guesdon <mguesdon@oxymium.net> - LDAP RealTime Driver Author/Adaptor
@@ -31,8 +31,7 @@
  * OpenLDAP http://www.openldap.org
  */
 
-/*!
+/*! \li \ref res_config_ldap.c uses the configuration file \ref res_ldap.conf
- * \li The resource res_config_ldap uses the configuration file \ref res_ldap.conf
  * \addtogroup configuration_file Configuration Files
  */
 
@@ -1561,6 +1560,9 @@ static struct ast_config_engine ldap_engine = {
  * tests return AST_MODULE_LOAD_FAILURE. If the module can not load the 
  * configuration file or other non-critical problem return 
  * AST_MODULE_LOAD_DECLINE. On success return AST_MODULE_LOAD_SUCCESS.
+ *
+ * \todo Don't error or warn on a default install. If the config is
+ * default we should not attempt to connect to a server. -lathama
  */
 static int load_module(void)
 {

res/res_config_pgsql.c

@@ -1,5 +1,5 @@
 /*
- * Asterisk -- A telephony toolkit for Linux.
+ * Asterisk -- An open source telephony toolkit.
  *
  * Copyright (C) 1999-2010, Digium, Inc.
  *

res/res_config_sqlite.c

@@ -71,8 +71,7 @@
  * \brief res_config_sqlite module.
  */
 
-/*! 
+/*! \li \ref res_config_sqlite.c uses the configuration file \ref res_config_sqlite.conf
- * \li The resource res_config_sqlite uses the configuration file \ref res_config_sqlite.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_config_sqlite3.c

@@ -29,8 +29,7 @@
  * \ingroup resources
  */
 
-/*!
+/*! \li \ref res_config_sqlite3.c uses the configuration file \ref res_config_sqlite3.conf
- * \li The resource res_config_sqlite3 uses the configuration file \ref res_config_sqlite3.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_curl.c

@@ -26,8 +26,7 @@
  * 
  */
 
-/*!
+/*! \li \ref res_curl.c uses the configuration file \ref res_curl.conf
- * \li The resource res_curl uses the configuration file \ref res_curl.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_fax.c

@@ -54,8 +54,7 @@
  * \ingroup applications
  */
 
-/*!
+/*! \li \ref res_fax.c uses the configuration file \ref res_fax.conf
- * \li The resource res_fax uses the configuration file \ref res_fax.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_jabber.c

@@ -30,6 +30,15 @@
  *
  */
 
+/*! \li \ref res_jabber.c uses the configuration file \ref jabber.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
+/*! 
+ * \page jabber.conf jabber.conf
+ * \verbinclude jabber.conf.sample
+ */
+
 /*** MODULEINFO
         <defaultenabled>no</defaultenabled>
 	<depend>iksemel</depend>

res/res_limit.c

@@ -1,5 +1,5 @@
 /*
- * Asterisk -- A telephony toolkit for Linux.
+ * Asterisk -- An open source telephony toolkit.
  *
  * Resource limits
  * 

res/res_musiconhold.c

@@ -23,8 +23,7 @@
  * \author Mark Spencer <markster@digium.com>
  */
 
-/*!
+/*! \li \ref res_musiconhold.c uses the configuration file \ref musiconhold.conf
- * \li The resource res_musiconhold uses the configuration file \ref musiconhold.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_odbc.c

@@ -30,8 +30,7 @@
  * \arg See also: \ref cdr_odbc
  */
 
-/*! 
+/*! \li \ref res_odbc.c uses the configuration file \ref res_odbc.conf
- * \li The resource res_odbc uses the configuration file \ref res_odbc.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_phoneprov.c

@@ -26,8 +26,7 @@
  * \author Terry Wilson <twilson@digium.com>
  */
 
-/*! 
+/*! \li \ref res_phoneprov.c uses the configuration file \ref phoneprov.conf and \ref users.conf and \ref sip.conf
- * \li The resource res_phoneprov uses the configuration file \ref phoneprov.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_smdi.c

@@ -1,5 +1,5 @@
 /*
- * Asterisk -- A telephony toolkit for Linux.
+ * Asterisk -- An open source telephony toolkit.
  *
  * Copyright (C) 2005-2008, Digium, Inc.
  *
@@ -31,8 +31,7 @@
  * polling thread handle it.
  */
 
-/*!
+/*! \li \ref res_smdi.c uses the configuration file \ref smdi.conf
- * \li The resource res_smdi uses the configuration file \ref smdi.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_snmp.c

@@ -17,8 +17,7 @@
  *	 http://net-snmp.sourceforge.net/
  */
 
-/*!
+/*! \li \ref res_snmp.c uses the configuration file \ref res_snmp.conf
- * \li The resource res_snmp uses the configuration file \ref res_snmp.conf
  * \addtogroup configuration_file Configuration Files
  */
 

res/res_xmpp.c

@@ -31,8 +31,7 @@
  *
  */
 
-/*! 
+/*! \li \ref res_xmpp.c uses the configuration file \ref xmpp.conf and \ref jabber.conf
- * \li The resource res_xmpp uses the configuration file \ref xmpp.conf
  * \addtogroup configuration_file Configuration Files
  */