diff options
author | Eliel C. Sardanons <eliels@gmail.com> | 2008-11-03 01:01:25 +0000 |
---|---|---|
committer | Eliel C. Sardanons <eliels@gmail.com> | 2008-11-03 01:01:25 +0000 |
commit | 9167a2b5e164687d4c9a0618a42d0dfe30090b9b (patch) | |
tree | 81df3f713ae7c89cfb8228bf411a5e9eb673293a /apps/app_waitforsilence.c | |
parent | a67790c6f53e4b002556eca8438dbd56994ea056 (diff) |
Add XML documentation for:
- WaitForSilence()
- WaitForNoise()
- WaitForRing()
- IVRDemo()
- DBDel()
- DBDeltree()
(issue #13699)
Reported by: snuffy
Patches:
bug13699_20081016.diff uploaded by snuffy (license 35)
(With minor changes)
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@153747 65c4cc65-6c06-0410-ace0-fbb531ad65f3
Diffstat (limited to 'apps/app_waitforsilence.c')
-rw-r--r-- | apps/app_waitforsilence.c | 104 |
1 files changed, 73 insertions, 31 deletions
diff --git a/apps/app_waitforsilence.c b/apps/app_waitforsilence.c index eedbf15ac..1aa777575 100644 --- a/apps/app_waitforsilence.c +++ b/apps/app_waitforsilence.c @@ -48,37 +48,79 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$") #include "asterisk/dsp.h" #include "asterisk/module.h" -static char *app_silence = "WaitForSilence"; -static char *synopsis_silence = "Waits for a specified amount of silence"; -static char *descrip_silence = -" WaitForSilence(silencerequired[,iterations][,timeout]):\n" -"Wait for Silence: Waits for up to 'silencerequired' \n" -"milliseconds of silence, 'iterations' times or once if omitted.\n" -"An optional timeout specified the number of seconds to return\n" -"after, even if we do not receive the specified amount of silence.\n" -"Use 'timeout' with caution, as it may defeat the purpose of this\n" -"application, which is to wait indefinitely until silence is detected\n" -"on the line. This is particularly useful for reverse-911-type\n" -"call broadcast applications where you need to wait for an answering\n" -"machine to complete its spiel before playing a message.\n" -"The timeout parameter is specified only to avoid an infinite loop in\n" -"cases where silence is never achieved. Typically you will want to\n" -"include two or more calls to WaitForSilence when dealing with an answering\n" -"machine; first waiting for the spiel to finish, then waiting for the beep, etc.\n\n" - "Examples:\n" -" - WaitForSilence(500,2) will wait for 1/2 second of silence, twice\n" -" - WaitForSilence(1000) will wait for 1 second of silence, once\n" -" - WaitForSilence(300,3,10) will wait for 300ms silence, 3 times,\n" -" and returns after 10 sec, even if silence is not detected\n\n" -"Sets the channel variable WAITSTATUS with to one of these values:\n" -"SILENCE - if exited with silence detected\n" -"TIMEOUT - if exited without silence detected after timeout\n"; +/*** DOCUMENTATION + <application name="WaitForSilence" language="en_US"> + <synopsis> + Waits for a specified amount of silence. + </synopsis> + <syntax> + <parameter name="silencerequired" required="true" /> + <parameter name="iterations"> + <para>If not specified, defaults to <literal>1</literal>.</para> + </parameter> + <parameter name="timeout"> + <para>Is specified only to avoid an infinite loop in cases where silence is never achieved.</para> + </parameter> + </syntax> + <description> + <para>Waits for up to <replaceable>silencerequired</replaceable> milliseconds of silence, + <replaceable>iterations</replaceable> times. An optional <replaceable>timeout</replaceable> + specified the number of seconds to return after, even if we do not receive the specified amount of silence. + Use <replaceable>timeout</replaceable> with caution, as it may defeat the purpose of this application, which + is to wait indefinitely until silence is detected on the line. This is particularly useful for reverse-911-type + call broadcast applications where you need to wait for an answering machine to complete its spiel before + playing a message.</para> + <para>Typically you will want to include two or more calls to WaitForSilence when dealing with an answering + machine; first waiting for the spiel to finish, then waiting for the beep, etc.</para> + <para>Examples:</para> + <para>WaitForSilence(500,2) will wait for 1/2 second of silence, twice</para> + <para>WaitForSilence(1000) will wait for 1 second of silence, once</para> + <para>WaitForSilence(300,3,10) will wait for 300ms silence, 3 times, and returns after 10 sec, even if silence + is not detected</para> + <para>Sets the channel variable <variable>WAITSTATUS</variable> to one of these values:</para> + <variablelist> + <variable name="WAITSTATUS"> + <value name="SILENCE"> + if exited with silence detected. + </value> + <value name="TIMEOUT"> + if exited without silence detected after timeout. + </value> + </variable> + </variablelist> + </description> + <see-also> + <ref type="application">WaitForNoise</ref> + </see-also> + </application> + <application name="WaitForNoise" language="en_US"> + <synopsis> + Waits for a specified amount of noise. + </synopsis> + <syntax> + <parameter name="noiserequired" required="true" /> + <parameter name="iterations"> + <para>If not specified, defaults to <literal>1</literal>.</para> + </parameter> + <parameter name="timeout"> + <para>Is specified only to avoid an infinite loop in cases where silence is never achieved.</para> + </parameter> + </syntax> + <description> + <para>Waits for up to <replaceable>noiserequired</replaceable> milliseconds of noise, + <replaceable>iterations</replaceable> times. An optional <replaceable>timeout</replaceable> + specified the number of seconds to return after, even if we do not receive the specified amount of noise. + Use <replaceable>timeout</replaceable> with caution, as it may defeat the purpose of this application, which + is to wait indefinitely until noise is detected on the line.</para> + </description> + <see-also> + <ref type="application">WaitForSilence</ref> + </see-also> + </application> + ***/ +static char *app_silence = "WaitForSilence"; static char *app_noise = "WaitForNoise"; -static char *synopsis_noise = "Waits for a specified amount of noise"; -static char *descrip_noise = -"WaitForNoise(noiserequired[,iterations][,timeout]) \n" -"Wait for Noise: The same as Wait for Silance but waits for noise that is above the threshold specified\n"; static int do_waiting(struct ast_channel *chan, int timereqd, time_t waitstart, int timeout, int wait_for_silence) { struct ast_frame *f = NULL; @@ -211,8 +253,8 @@ static int load_module(void) { int res; - res = ast_register_application(app_silence, waitforsilence_exec, synopsis_silence, descrip_silence); - res |= ast_register_application(app_noise, waitfornoise_exec, synopsis_noise, descrip_noise); + res = ast_register_application_xml(app_silence, waitforsilence_exec); + res |= ast_register_application_xml(app_noise, waitfornoise_exec); return res; } |