Merge changes from team/group/appdocsxml

This commit introduces the first phase of an effort to manage documentation of the
interfaces in Asterisk in an XML format.  Currently, a new format is available for
applications and dialplan functions.  A good number of conversions to the new format
are also included.

For more information, see the following message to asterisk-dev:

http://lists.digium.com/pipermail/asterisk-dev/2008-October/034968.html


git-svn-id: http://svn.digium.com/svn/asterisk/trunk@153365 f38db490-d61c-443f-a65b-d21fe96a405b

1 files changed, 23 insertions, 10 deletions

diff --git a/apps/app_milliwatt.c b/apps/app_milliwatt.c
index 89063096c..4c6a9ea4c 100644
--- a/apps/app_milliwatt.c
+++ b/apps/app_milliwatt.c
@@ -37,16 +37,29 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 #include "asterisk/channel.h"
 #include "asterisk/pbx.h"
 
-static char *app = "Milliwatt";
-
-static char *synopsis = "Generate a Constant 1004Hz tone at 0dbm (mu-law)";
+/*** DOCUMENTATION
+	<application name="Milliwatt" language="en_US">
+		<synopsis>
+			Generate a Constant 1004Hz tone at 0dbm (mu-law).
+		</synopsis>
+		<syntax>
+			<parameter name="options">
+				<optionlist>
+					<option name="o">
+						<para>Generate the tone at 1000Hz like previous version.</para>
+					</option>
+				</optionlist>
+			</parameter>
+		</syntax>
+		<description>
+			<para>Previous versions of this application generated the tone at 1000Hz.  If for
+			some reason you would prefer that behavior, supply the <literal>o</literal> option to get the
+			old behavior.</para>
+		</description>
+	</application>
+ ***/
 
-static char *descrip = 
-"   Milliwatt([options]): Generate a Constant 1004Hz tone at 0dbm.\n"
-"Previous versions of this application generated the tone at 1000Hz.  If for\n"
-"some reason you would prefer that behavior, supply the 'o' option to get the\n"
-"old behavior.\n"
-"";
+static char *app = "Milliwatt";
 
 static char digital_milliwatt[] = {0x1e,0x0b,0x0b,0x1e,0x9e,0x8b,0x8b,0x9e} ;
 
@@ -161,7 +174,7 @@ static int unload_module(void)
 
 static int load_module(void)
 {
-	return ast_register_application(app, milliwatt_exec, synopsis, descrip);
+	return ast_register_application_xml(app, milliwatt_exec);
 }
 
 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Digital Milliwatt (mu-law) Test Application");