[Asterisk-cvs] asterisk/apps app_dial.c,1.87,1.88

[markster at lists.digium.com]

Update of /usr/cvsroot/asterisk/apps
In directory localhost.localdomain:/tmp/cvs-serv12791/apps

Modified Files:
	app_dial.c 
Log Message:
Update dial documentation (bug #2096)


Index: app_dial.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_dial.c,v
retrieving revision 1.87
retrieving revision 1.88
diff -u -d -r1.87 -r1.88
--- app_dial.c	17 Jul 2004 20:58:00 -0000	1.87
+++ app_dial.c	19 Jul 2004 19:47:21 -0000	1.88
@@ -61,8 +61,9 @@
 "The option string may contain zero or more of the following characters:\n"
 "      't' -- allow the called user transfer the calling user by hitting #.\n"
 "      'T' -- allow the calling user to transfer the call by hitting #.\n"
-"      'f' -- Forces callerid to be set as the extension of the line making/redirecting the outgoing call.\n"
-"             For example, some PSTNs don't allow callerids from other extensions then the ones\n"
+"      'f' -- Forces callerid to be set as the extension of the line \n"
+"             making/redirecting the outgoing call. For example, some PSTNs\n"
+"             don't allow callerids from other extensions then the ones\n"
 "             that are assigned to you.\n"
 "      'r' -- indicate ringing to the calling party, pass no audio until answered.\n"
 "      'm' -- provide hold music to the calling party until answered.\n"
@@ -73,20 +74,28 @@
 "      'A(x)' -- play an announcement to the called party, using x as file\n"
 "      'S(x)' -- hangup the call after x seconds AFTER called party picked up\n"  	
 "      'D([digits])'  -- Send DTMF digit string *after* called party has answered\n"
-"                        but before the bridge. (w=500ms sec pause)\n"
-"      'L(x[:y][:z])' -- Limit the call to 'x' ms warning when 'y' ms are left (repeated every 'z' ms)\n"
-"                     -- Only 'x' is required, 'y' and 'z' are optional.\n"
-"                     -- The following special variables are optional:\n"
-"                       ** LIMIT_PLAYAUDIO_CALLER    (default yes) Play sounds to the caller.\n"
-"                       ** LIMIT_PLAYAUDIO_CALLEE    Play sounds to the callee.\n"
-"                       ** LIMIT_TIMEOUT_FILE        File to play when time is up.\n"
-"                       ** LIMIT_CONNECT_FILE        File to play when call begins.\n"
-"                       ** LIMIT_WARNING_FILE        File to play as warning if 'y' is defined.\n"
-"                     -- 'timeleft' is a special sound macro to auto-say the time left and is the default.\n\n"
+"             but before the bridge. (w=500ms sec pause)\n"
+"      'L(x[:y][:z])' -- Limit the call to 'x' ms warning when 'y' ms are left\n"
+"             repeated every 'z' ms) Only 'x' is required, 'y' and 'z' are optional.\n"
+"             The following special variables are optional:\n"
+"             * LIMIT_PLAYAUDIO_CALLER    yes|no (default yes)\n"
+"                                         Play sounds to the caller.\n"
+"             * LIMIT_PLAYAUDIO_CALLEE    yes|no\n"
+"                                         Play sounds to the callee.\n"
+"             * LIMIT_TIMEOUT_FILE        File to play when time is up.\n"
+"             * LIMIT_CONNECT_FILE        File to play when call begins.\n"
+"             * LIMIT_WARNING_FILE        File to play as warning if 'y' is defined.\n"
+"                        'timeleft' is a special sound macro to auto-say the time \n"
+"                        left and is the default.\n\n"
 "  In addition to transferring the call, a call may be parked and then picked\n"
 "up by another user.\n"
-"  The optional URL will be sent to the called party if the channel supports\n"
-"it.\n";
+"  The optional URL will be sent to the called party if the channel supports it.\n"
+"  This application sets the following channel variables upon completion:\n"
+"      DIALEDTIME    Time from dial to answer\n" 
+"      ANSWEREDTIME  Time for actual call\n"
+"      DIALSTATUS    The status of the call as a text string, one of\n"
+"             CHANUNAVAIL | CONGESTION | NOANSWER | BUSY | ANSWER | CANCEL\n"
+"";
 
 /* We define a customer "local user" structure because we
    use it not only for keeping track of what is in use but