diff --git a/apps/app_adsiprog.c b/apps/app_adsiprog.c index 518a02113b1c0e7e859f9e542aec97be1b49b4f1..d13dba32baa59404c7983b9b13702a9242c30063 100644 --- a/apps/app_adsiprog.c +++ b/apps/app_adsiprog.c @@ -25,6 +25,16 @@ * \ingroup applications */ +/*! + * \li The application app_adsiprog uses the configuration file \ref adsi.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page adsi.conf adsi.conf + * \verbinclude adsi.conf.sample + */ + /*** MODULEINFO <depend>res_adsi</depend> <support_level>extended</support_level> @@ -1585,6 +1595,16 @@ static int unload_module(void) return ast_unregister_application(app); } +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. + */ static int load_module(void) { if (ast_register_application_xml(app, adsi_exec)) diff --git a/apps/app_alarmreceiver.c b/apps/app_alarmreceiver.c index fb01b002ed888ec39b6f6ff1ade0644cb4782c14..40275410fbb06ead550ceb5bb0b3f666120cb2a0 100644 --- a/apps/app_alarmreceiver.c +++ b/apps/app_alarmreceiver.c @@ -30,6 +30,16 @@ * \ingroup applications */ +/*! + * \li The application app_alarmreceiver uses the configuration file \ref alarmreceiver.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page alarmreceiver.conf alarmreceiver.conf + * \verbinclude alarmreceiver.conf.sample + */ + /*** MODULEINFO <support_level>extended</support_level> ***/ @@ -724,11 +734,15 @@ static int unload_module(void) return ast_unregister_application(app); } -/** - * \brief Register Alarm Receiver App - * - * \retval 0 success - * \retval -1 failure +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. */ static int load_module(void) { diff --git a/apps/app_amd.c b/apps/app_amd.c index 597aac39ce1593647fb746af6ee11a3c6abd455b..3d6169d086aa6ad5d11652494089135bf97c71b2 100644 --- a/apps/app_amd.c +++ b/apps/app_amd.c @@ -24,6 +24,18 @@ * \brief Answering machine detection * * \author Claude Klimos (claude.klimos@aheeva.com) + * + * \ingroup applications + */ + +/*! + * \li The application app_amd uses the configuration file \ref amd.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page amd.conf amd.conf + * \verbinclude amd.conf.sample */ /*** MODULEINFO @@ -487,6 +499,16 @@ static int unload_module(void) return ast_unregister_application(app); } +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. + */ static int load_module(void) { if (load_config(0)) diff --git a/apps/app_confbridge.c b/apps/app_confbridge.c index e6ee85b99ca478600ca3add3ec2efb6d63b27bd4..480666e98ca0b4727af85dc1749cc402d2c695a3 100644 --- a/apps/app_confbridge.c +++ b/apps/app_confbridge.c @@ -28,6 +28,16 @@ * \ingroup applications */ +/*! + * \li The application app_confbridge uses the configuration file \ref confbridge.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page confbridge.conf confbridge.conf + * \verbinclude confbridge.conf.sample + */ + /*** MODULEINFO <support_level>core</support_level> ***/ @@ -2827,7 +2837,16 @@ static int unload_module(void) return res; } -/*! \brief Called when module is being loaded */ +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. + */ static int load_module(void) { int res = 0; diff --git a/apps/app_festival.c b/apps/app_festival.c index d875b7acb7f048ee577d0430d6bde516a2aa4d22..c4ad0f6b9bbc20d6a52e9523598aa6c01c2d3fcf 100644 --- a/apps/app_festival.c +++ b/apps/app_festival.c @@ -27,6 +27,16 @@ * \ingroup applications */ +/*! + * \li The application app_festival uses the configuration file \ref festival.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page festival.conf festival.conf + * \verbinclude festival.conf.sample + */ + /*** MODULEINFO <support_level>extended</support_level> ***/ @@ -537,6 +547,16 @@ static int unload_module(void) return ast_unregister_application(app); } +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. + */ static int load_module(void) { struct ast_flags config_flags = { 0 }; diff --git a/apps/app_followme.c b/apps/app_followme.c index 9f39c329d64175a96030ce799c12b984f936c7f3..97e3213a7aea56d4ec8665e3380b1542507b55e6 100644 --- a/apps/app_followme.c +++ b/apps/app_followme.c @@ -23,11 +23,19 @@ * * \author BJ Weschke <bweschke@btwtech.com> * - * \arg See \ref Config_followme - * * \ingroup applications */ +/*! + * \li The application app_followme uses the configuration file \ref followme.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page followme.conf followme.conf + * \verbinclude followme.conf.sample + */ + /*** MODULEINFO <depend>chan_local</depend> <support_level>core</support_level> @@ -1555,6 +1563,16 @@ static int unload_module(void) return 0; } +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. + */ static int load_module(void) { if(!reload_followme(0)) diff --git a/apps/app_meetme.c b/apps/app_meetme.c index 4669f36acbbb0d1466960cd168a9338a92f3f0b6..8b71a71e0045f213a14b9cefcd38a974f5ca1b63 100644 --- a/apps/app_meetme.c +++ b/apps/app_meetme.c @@ -29,6 +29,16 @@ * \ingroup applications */ +/*! + * \li The application app_meetme uses configuration file \ref meetme.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page meetme.conf meetme.conf + * \verbinclude meetme.conf.sample + */ + /*** MODULEINFO <depend>dahdi</depend> <defaultenabled>no</defaultenabled> @@ -7572,8 +7582,16 @@ static int unload_module(void) return res; } - - +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. + */ static int load_module(void) { int res = 0; diff --git a/apps/app_queue.c b/apps/app_queue.c index 963ac24a369d9b9787fbb89b755abc86f36fc2c4..0dc2ca64d931afd189d050964d3c7d8063b02354 100644 --- a/apps/app_queue.c +++ b/apps/app_queue.c @@ -22,8 +22,6 @@ * * \author Mark Spencer <markster@digium.com> * - * \arg Config in \ref Config_qu queues.conf - * * \par Development notes * \note 2004-11-25: Persistent Dynamic Members added by: * NetNation Communications (www.netnation.com) @@ -56,6 +54,15 @@ * \ingroup applications */ +/*! + * \li The application app_queues uses configuration file \ref queues.conf + * \addtogroup configuration_file + */ + +/*! \page queues.conf queues.conf + * \verbinclude queues.conf.sample + */ + /*** MODULEINFO <use type="module">res_monitor</use> <support_level>core</support_level> @@ -9689,6 +9696,16 @@ static int unload_module(void) return res; } +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. + */ static int load_module(void) { int res; diff --git a/apps/app_skel.c b/apps/app_skel.c index 17412bf6492868b437e672f53162dd91a7e68fa6..4c12a4ac87b4ccc2dfe988b36fa14718262fa069 100644 --- a/apps/app_skel.c +++ b/apps/app_skel.c @@ -29,6 +29,16 @@ * \ingroup applications */ +/*! + * \li The application app_skel uses configuration file \ref app_skel.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page app_skel.conf app_skel.conf + * \verbinclude app_skel.conf.sample + */ + /*** MODULEINFO <defaultenabled>no</defaultenabled> <support_level>core</support_level> @@ -651,10 +661,12 @@ static int unload_module(void) /*! * \brief Load the module * - * \par The configuration file - * - * The application app_skel uses a configuration file. - * \verbinclude app_skel.conf.sample + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. */ static int load_module(void) { diff --git a/apps/app_voicemail.c b/apps/app_voicemail.c index 5e8b4e86f795ddb54efa46a4258fc4b1ee48c8e7..67305818266c07a53ccc0fce4324fa50b57fa2a3 100644 --- a/apps/app_voicemail.c +++ b/apps/app_voicemail.c @@ -28,7 +28,7 @@ * \par See also * \arg \ref Config_vm * \note For information about voicemail IMAP storage, https://wiki.asterisk.org/wiki/display/AST/IMAP+Voicemail+Storage - * \ingroup applications + * \ingroup applications * \todo This module requires res_adsi to load. This needs to be optional * during compilation. * @@ -37,6 +37,16 @@ * with a plan to clean this up. */ +/*! + * \li The application app_voicemail uses configuration file \ref voicemail.conf + * \addtogroup configuration_file Configuration Files + */ + +/*! + * \page voicemail.conf voicemail.conf + * \verbinclude voicemail.conf.sample + */ + /*** MODULEINFO <use type="module">res_adsi</use> <use type="module">res_smdi</use> @@ -14277,6 +14287,16 @@ static int unload_module(void) return res; } +/*! + * \brief Load the module + * + * Module loading including tests for configuration or dependencies. + * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE, + * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails + * 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. + */ static int load_module(void) { int res;