Move music on hold related applications documentation to XML.
Move MusicOnHold, SetMusicOnHold, StartMusicOnHold, StopMusicOnHold static documentation to the new AstXML form. (issue #15245) Reported by: eliel Patches: res_musiconhold_static_conversion.txt uploaded by lmadsen (license 10) (with some fixes and formatting by me) git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@199413 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
parent
4f94236de5
commit
515166ba37
1 changed files with 80 additions and 51 deletions
|
@ -70,53 +70,82 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
|
||||||
|
|
||||||
#define INITIAL_NUM_FILES 8
|
#define INITIAL_NUM_FILES 8
|
||||||
|
|
||||||
static char *play_moh = "MusicOnHold";
|
/*** DOCUMENTATION
|
||||||
static char *wait_moh = "WaitMusicOnHold";
|
<application name="MusicOnHold" language="en_US">
|
||||||
static char *set_moh = "SetMusicOnHold";
|
<synopsis>
|
||||||
static char *start_moh = "StartMusicOnHold";
|
Play Music On Hold indefinitely.
|
||||||
static char *stop_moh = "StopMusicOnHold";
|
</synopsis>
|
||||||
|
<syntax>
|
||||||
|
<parameter name="class" required="true" />
|
||||||
|
<parameter name="duration" />
|
||||||
|
</syntax>
|
||||||
|
<description>
|
||||||
|
<para>Plays hold music specified by class. If omitted, the default music
|
||||||
|
source for the channel will be used. Change the default class with
|
||||||
|
Set(CHANNEL(musicclass)=...). If duration is given, hold music will be played
|
||||||
|
specified number of seconds. If duration is ommited, music plays indefinitely.
|
||||||
|
Returns <literal>0</literal> when done, <literal>-1</literal> on hangup.</para>
|
||||||
|
</description>
|
||||||
|
</application>
|
||||||
|
<application name="WaitMusicOnHold" language="en_US">
|
||||||
|
<synopsis>
|
||||||
|
Wait, playing Music On Hold.
|
||||||
|
</synopsis>
|
||||||
|
<syntax>
|
||||||
|
<parameter name="delay" required="true" />
|
||||||
|
</syntax>
|
||||||
|
<description>
|
||||||
|
<para> !!! DEPRECATED. Use MusicOnHold instead !!!</para>
|
||||||
|
<para>Plays hold music specified number of seconds. Returns <literal>0</literal> when done,
|
||||||
|
or <literal>-1</literal> on hangup. If no hold music is available, the delay will still occur
|
||||||
|
with no sound.</para>
|
||||||
|
<para> !!! DEPRECATED. Use MusicOnHold instead !!!</para>
|
||||||
|
</description>
|
||||||
|
</application>
|
||||||
|
<application name="SetMusicOnHold" language="en_US">
|
||||||
|
<synopsis>
|
||||||
|
Set default Music On Hold class.
|
||||||
|
</synopsis>
|
||||||
|
<syntax>
|
||||||
|
<parameter name="class" required="yes" />
|
||||||
|
</syntax>
|
||||||
|
<description>
|
||||||
|
<para>!!! DEPRECATED. USe Set(CHANNEL(musicclass)=...) instead !!!</para>
|
||||||
|
<para>Sets the default class for music on hold for a given channel.
|
||||||
|
When music on hold is activated, this class will be used to select which
|
||||||
|
music is played.</para>
|
||||||
|
<para>!!! DEPRECATED. USe Set(CHANNEL(musicclass)=...) instead !!!</para>
|
||||||
|
</description>
|
||||||
|
</application>
|
||||||
|
<application name="StartMusicOnHold" language="en_US">
|
||||||
|
<synopsis>
|
||||||
|
Play Music On Hold.
|
||||||
|
</synopsis>
|
||||||
|
<syntax>
|
||||||
|
<parameter name="class" required="true" />
|
||||||
|
</syntax>
|
||||||
|
<description>
|
||||||
|
<para>Starts playing music on hold, uses default music class for channel.
|
||||||
|
Starts playing music specified by class. If omitted, the default music
|
||||||
|
source for the channel will be used. Always returns <literal>0</literal>.</para>
|
||||||
|
</description>
|
||||||
|
</application>
|
||||||
|
<application name="StopMusicOnHold" language="en_US">
|
||||||
|
<synopsis>
|
||||||
|
Stop playing Music On Hold.
|
||||||
|
</synopsis>
|
||||||
|
<syntax />
|
||||||
|
<description>
|
||||||
|
<para>Stops playing music on hold.</para>
|
||||||
|
</description>
|
||||||
|
</application>
|
||||||
|
***/
|
||||||
|
|
||||||
static char *play_moh_syn = "Play Music On Hold indefinitely";
|
static const char play_moh[] = "MusicOnHold";
|
||||||
static char *wait_moh_syn = "Wait, playing Music On Hold";
|
static const char wait_moh[] = "WaitMusicOnHold";
|
||||||
static char *set_moh_syn = "Set default Music On Hold class";
|
static const char set_moh[] = "SetMusicOnHold";
|
||||||
static char *start_moh_syn = "Play Music On Hold";
|
static const char start_moh[] = "StartMusicOnHold";
|
||||||
static char *stop_moh_syn = "Stop Playing Music On Hold";
|
static const char stop_moh[] = "StopMusicOnHold";
|
||||||
|
|
||||||
static char *play_moh_desc = " MusicOnHold(class[,duration]):\n"
|
|
||||||
"Plays hold music specified by class. If omitted, the default\n"
|
|
||||||
"music source for the channel will be used. Change the default \n"
|
|
||||||
"class with Set(CHANNEL(musicclass)=...).\n"
|
|
||||||
"If duration is given, hold music will be played specified number\n"
|
|
||||||
"of seconds. If duration is ommited, music plays indefinitely.\n"
|
|
||||||
"Returns 0 when done, -1 on hangup.\n";
|
|
||||||
|
|
||||||
static char *wait_moh_desc = " WaitMusicOnHold(delay):\n"
|
|
||||||
"\n"
|
|
||||||
" !!! DEPRECATED. Use MusicOnHold instead !!!\n"
|
|
||||||
"\n"
|
|
||||||
"Plays hold music specified number of seconds. Returns 0 when\n"
|
|
||||||
"done, or -1 on hangup. If no hold music is available, the delay will\n"
|
|
||||||
"still occur with no sound.\n"
|
|
||||||
"\n"
|
|
||||||
" !!! DEPRECATED. Use MusicOnHold instead !!!\n";
|
|
||||||
|
|
||||||
static char *set_moh_desc = " SetMusicOnHold(class):\n"
|
|
||||||
"\n"
|
|
||||||
" !!! DEPRECATED. USe Set(CHANNEL(musicclass)=...) instead !!!\n"
|
|
||||||
"\n"
|
|
||||||
"Sets the default class for music on hold for a given channel. When\n"
|
|
||||||
"music on hold is activated, this class will be used to select which\n"
|
|
||||||
"music is played.\n"
|
|
||||||
"\n"
|
|
||||||
" !!! DEPRECATED. USe Set(CHANNEL(musicclass)=...) instead !!!\n";
|
|
||||||
|
|
||||||
static char *start_moh_desc = " StartMusicOnHold(class):\n"
|
|
||||||
"Starts playing music on hold, uses default music class for channel.\n"
|
|
||||||
"Starts playing music specified by class. If omitted, the default\n"
|
|
||||||
"music source for the channel will be used. Always returns 0.\n";
|
|
||||||
|
|
||||||
static char *stop_moh_desc = " StopMusicOnHold(): "
|
|
||||||
"Stops playing music on hold.\n";
|
|
||||||
|
|
||||||
static int respawn_time = 20;
|
static int respawn_time = 20;
|
||||||
|
|
||||||
|
@ -1667,17 +1696,17 @@ static int load_module(void)
|
||||||
local_ast_moh_cleanup);
|
local_ast_moh_cleanup);
|
||||||
}
|
}
|
||||||
|
|
||||||
res = ast_register_application(play_moh, play_moh_exec, play_moh_syn, play_moh_desc);
|
res = ast_register_application_xml(play_moh, play_moh_exec);
|
||||||
ast_register_atexit(ast_moh_destroy);
|
ast_register_atexit(ast_moh_destroy);
|
||||||
ast_cli_register_multiple(cli_moh, ARRAY_LEN(cli_moh));
|
ast_cli_register_multiple(cli_moh, ARRAY_LEN(cli_moh));
|
||||||
if (!res)
|
if (!res)
|
||||||
res = ast_register_application(wait_moh, wait_moh_exec, wait_moh_syn, wait_moh_desc);
|
res = ast_register_application_xml(wait_moh, wait_moh_exec);
|
||||||
if (!res)
|
if (!res)
|
||||||
res = ast_register_application(set_moh, set_moh_exec, set_moh_syn, set_moh_desc);
|
res = ast_register_application_xml(set_moh, set_moh_exec);
|
||||||
if (!res)
|
if (!res)
|
||||||
res = ast_register_application(start_moh, start_moh_exec, start_moh_syn, start_moh_desc);
|
res = ast_register_application_xml(start_moh, start_moh_exec);
|
||||||
if (!res)
|
if (!res)
|
||||||
res = ast_register_application(stop_moh, stop_moh_exec, stop_moh_syn, stop_moh_desc);
|
res = ast_register_application_xml(stop_moh, stop_moh_exec);
|
||||||
|
|
||||||
return AST_MODULE_LOAD_SUCCESS;
|
return AST_MODULE_LOAD_SUCCESS;
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in a new issue