Update dial documentation (bug #2096)

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

1 files changed, 23 insertions, 14 deletions

diff --git a/apps/app_dial.c b/apps/app_dial.c
index 43ff0c30d..c44860f60 100755
--- a/apps/app_dial.c
+++ b/apps/app_dial.c
@@ -61,8 +61,9 @@ static char *descrip =
 "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 @@ static char *descrip =
 "      '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