summaryrefslogtreecommitdiff
path: root/res/res_musiconhold.c
diff options
context:
space:
mode:
authorAndrew Latham <lathama@gmail.com>2012-10-01 23:24:10 +0000
committerAndrew Latham <lathama@gmail.com>2012-10-01 23:24:10 +0000
commite11cc293602b6c35ed94722bc52376acf6c38164 (patch)
treee07bed81cd6d19b703044202933bbc9dd9cf1915 /res/res_musiconhold.c
parent14be2a55144d3a6ee73d6df9442b703b00bfc482 (diff)
Doxygen Cleanup
Start adding configuration file linking and pages. Add module loading doxygen block. Breaking up commits to keep it easy to track (issue ASTERISK-20259) git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@374165 65c4cc65-6c06-0410-ace0-fbb531ad65f3
Diffstat (limited to 'res/res_musiconhold.c')
-rw-r--r--res/res_musiconhold.c22
1 files changed, 20 insertions, 2 deletions
diff --git a/res/res_musiconhold.c b/res/res_musiconhold.c
index ec990d5d1..3c61b26fe 100644
--- a/res/res_musiconhold.c
+++ b/res/res_musiconhold.c
@@ -19,12 +19,20 @@
/*! \file
*
* \brief Routines implementing music on hold
- *
- * \arg See also \ref Config_moh
*
* \author Mark Spencer <markster@digium.com>
*/
+/*!
+ * \li The resource res_musiconhold uses the configuration file \ref musiconhold.conf
+ * \addtogroup configuration_file Configuration Files
+ */
+
+/*!
+ * \page musiconhold.conf musiconhold.conf
+ * \verbinclude musiconhold.conf.sample
+ */
+
/*** MODULEINFO
<conflict>win32</conflict>
<support_level>core</support_level>
@@ -1941,6 +1949,16 @@ static int moh_class_cmp(void *obj, void *arg, int flags)
CMP_MATCH | CMP_STOP;
}
+/*!
+ * \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;