From 46d7e8dafa3602bd96a83706aa8382471e0af4f1 Mon Sep 17 00:00:00 2001
From: "Eliel C. Sardanons" <eliels@gmail.com>
Date: Tue, 4 Nov 2008 14:38:20 +0000
Subject: [PATCH] Add XML documentation for:    Applications      -
 DAHDISendKeypadFacility()      - DAHDISendCallreroutingFacility()

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@154149 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 channels/chan_dahdi.c | 53 ++++++++++++++++++++++++++++++-------------
 1 file changed, 37 insertions(+), 16 deletions(-)

diff --git a/channels/chan_dahdi.c b/channels/chan_dahdi.c
index 3141856871..4752294e55 100644
--- a/channels/chan_dahdi.c
+++ b/channels/chan_dahdi.c
@@ -101,6 +101,41 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 #include "asterisk/event.h"
 #include "asterisk/devicestate.h"
 
+/*** DOCUMENTATION
+	<application name="DAHDISendKeypadFacility" language="en_US">
+		<synopsis>
+			Send digits out of band over a PRI.
+		</synopsis>
+		<syntax>
+			<parameter name="digits" required="true" />
+		</syntax>
+		<description>
+			<para>This application will send the given string of digits in a Keypad
+			Facility IE over the current channel.</para>
+		</description>
+	</application>
+	<application name="DAHDISendCallreroutingFacility" language="en_US">
+		<synopsis>
+			Send QSIG call rerouting facility over a PRI.
+		</synopsis>
+		<syntax argsep="|">
+			<parameter name="destination" required="true">
+				<para>Destination number.</para>	
+			</parameter>
+			<parameter name="original">
+				<para>Original called number.</para>
+			</parameter>
+			<parameter name="reason">
+				<para>Diversion reason, if not specified defaults to <literal>unknown</literal></para>
+			</parameter>
+		</syntax>
+		<description>
+			<para>This application will send a Callrerouting Facility IE over the
+			current channel.</para>
+		</description>
+	</application>
+ ***/
+
 #define SMDI_MD_WAIT_TIMEOUT 1500 /* 1.5 seconds */
 
 static const char *lbostr[] = {
@@ -2913,12 +2948,6 @@ static void destroy_all_channels(void)
 #ifdef HAVE_PRI
 static char *dahdi_send_keypad_facility_app = "DAHDISendKeypadFacility";
 
-static char *dahdi_send_keypad_facility_synopsis = "Send digits out of band over a PRI";
-
-static char *dahdi_send_keypad_facility_descrip = 
-"  DAHDISendKeypadFacility(): This application will send the given string of digits in a Keypad Facility\n"
-"  IE over the current channel.\n";
-
 static int dahdi_send_keypad_facility_exec(struct ast_channel *chan, void *data)
 {
 	/* Data will be our digit string */
@@ -2961,12 +2990,6 @@ static int dahdi_send_keypad_facility_exec(struct ast_channel *chan, void *data)
 
 static char *dahdi_send_callrerouting_facility_app = "DAHDISendCallreroutingFacility";
 
-static char *dahdi_send_callrerouting_facility_synopsis = "Send QSIG call rerouting facility over a PRI";
-
-static char *dahdi_send_callrerouting_facility_descrip =
-"  DAHDISendCallreroutingFacility(): This application will send a Callrerouting Facility\n"
-"  IE over the current channel.\n";
-
 static int dahdi_send_callrerouting_facility_exec(struct ast_channel *chan, void *data)
 {
 	/* Data will be our digit string */
@@ -14798,10 +14821,8 @@ static int load_module(void)
 	}
 	pri_set_error(dahdi_pri_error);
 	pri_set_message(dahdi_pri_message);
-	ast_register_application(dahdi_send_keypad_facility_app, dahdi_send_keypad_facility_exec,
-			dahdi_send_keypad_facility_synopsis, dahdi_send_keypad_facility_descrip);
-	ast_register_application(dahdi_send_callrerouting_facility_app, dahdi_send_callrerouting_facility_exec,
-		dahdi_send_callrerouting_facility_synopsis, dahdi_send_callrerouting_facility_descrip);
+	ast_register_application_xml(dahdi_send_keypad_facility_app, dahdi_send_keypad_facility_exec);
+	ast_register_application_xml(dahdi_send_callrerouting_facility_app, dahdi_send_callrerouting_facility_exec);
 #endif
 #ifdef HAVE_SS7
 	memset(linksets, 0, sizeof(linksets));