[asterisk-commits] mmichelson: trunk r89044 - in /trunk: apps/ channels/ main/ res/

SVN commits to the Asterisk project asterisk-commits at lists.digium.com
Tue Nov 6 13:04:46 CST 2007


Author: mmichelson
Date: Tue Nov  6 13:04:45 2007
New Revision: 89044

URL: http://svn.digium.com/view/asterisk?view=rev&rev=89044
Log:
"show application <foo>" changes for clarity.

(closes issue #11171, reported and patched by blitzrage)

Many thanks!


Modified:
    trunk/apps/app_amd.c
    trunk/apps/app_chanisavail.c
    trunk/apps/app_chanspy.c
    trunk/apps/app_directed_pickup.c
    trunk/apps/app_exec.c
    trunk/apps/app_festival.c
    trunk/apps/app_followme.c
    trunk/apps/app_forkcdr.c
    trunk/apps/app_getcpeid.c
    trunk/apps/app_macro.c
    trunk/apps/app_minivm.c
    trunk/apps/app_mixmonitor.c
    trunk/apps/app_morsecode.c
    trunk/apps/app_mp3.c
    trunk/apps/app_nbscat.c
    trunk/apps/app_playback.c
    trunk/apps/app_readfile.c
    trunk/apps/app_sayunixtime.c
    trunk/apps/app_sms.c
    trunk/apps/app_softhangup.c
    trunk/apps/app_speech_utils.c
    trunk/apps/app_stack.c
    trunk/apps/app_test.c
    trunk/apps/app_waitforring.c
    trunk/apps/app_waitforsilence.c
    trunk/apps/app_while.c
    trunk/channels/chan_agent.c
    trunk/channels/chan_sip.c
    trunk/main/pbx.c
    trunk/res/res_features.c
    trunk/res/res_indications.c
    trunk/res/res_monitor.c
    trunk/res/res_musiconhold.c

Modified: trunk/apps/app_amd.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_amd.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_amd.c (original)
+++ trunk/apps/app_amd.c Tue Nov  6 13:04:45 2007
@@ -69,7 +69,7 @@
 "- 'maximumNumberOfWords'is the maximum number of words in the greeting. \n"
 "   If exceeded then MACHINE.\n"
 "- 'silenceThreshold' is the silence threshold.\n"
-"This application sets the following channel variable upon completion:\n"
+"This application sets the following channel variables upon completion:\n"
 "    AMDSTATUS - This is the status of the answering machine detection.\n"
 "                Possible values are:\n"
 "                MACHINE | HUMAN | NOTSURE | HANGUP\n"

Modified: trunk/apps/app_chanisavail.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_chanisavail.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_chanisavail.c (original)
+++ trunk/apps/app_chanisavail.c Tue Nov  6 13:04:45 2007
@@ -55,14 +55,15 @@
 static char *descrip = 
 "  ChanIsAvail(Technology/resource[&Technology2/resource2...][,options]): \n"
 "This application will check to see if any of the specified channels are\n"
-"available. The following variables will be set by this application:\n"
-"  ${AVAILCHAN}     - the name of the available channel, if one exists\n"
-"  ${AVAILORIGCHAN} - the canonical channel name that was used to create the channel\n"
-"  ${AVAILSTATUS}   - the status code for the available channel\n"
+"available.\n"
 "  Options:\n"
-"    s - Consider the channel unavailable if the channel is in use at all\n"
+"    s - Consider the channel unavailable if the channel is in use at all.\n"
 "    t - Simply checks if specified channels exist in the channel list\n"
-"        (implies option s) \n";
+"        (implies option s).\n"
+"This application sets the following channel variable upon completion:\n"
+"  AVAILCHAN     - the name of the available channel, if one exists\n"
+"  AVAILORIGCHAN - the canonical channel name that was used to create the channel\n"
+"  AVAILSTATUS   - the status code for the available channel\n";
 
 
 static int chanavail_exec(struct ast_channel *chan, void *data)

Modified: trunk/apps/app_chanspy.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_chanspy.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_chanspy.c (original)
+++ trunk/apps/app_chanspy.c Tue Nov  6 13:04:45 2007
@@ -73,7 +73,7 @@
 "        and a digit sequence.\n"
 "  Options:\n"
 "    b             - Only spy on channels involved in a bridged call.\n"
-"    g(grp)        - Match only channels where their ${SPYGROUP} variable is set to\n"
+"    g(grp)        - Match only channels where their SPYGROUP variable is set to\n"
 "                    contain 'grp' in an optional : delimited list.\n"
 "    q             - Don't play a beep when beginning to spy on a channel, or speak the\n"
 "                    selected channel name.\n"

Modified: trunk/apps/app_directed_pickup.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_directed_pickup.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_directed_pickup.c (original)
+++ trunk/apps/app_directed_pickup.c Tue Nov  6 13:04:45 2007
@@ -49,7 +49,7 @@
 static const char *app = "Pickup";
 static const char *synopsis = "Directed Call Pickup";
 static const char *descrip =
-"  Pickup([extension[@context][&extension2 at context...]]):  This application can\n"
+"  Pickup([extension[@context][&extension2@[context]...]]):  This application can\n"
 "pickup any ringing channel that is calling the specified extension.  If no\n"
 "context is specified, the current context will be used. If you use the special\n"
 "string \"PICKUPMARK\" for the context parameter, for example 10 at PICKUPMARK,\n"

Modified: trunk/apps/app_exec.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_exec.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_exec.c (original)
+++ trunk/apps/app_exec.c Tue Nov  6 13:04:45 2007
@@ -61,8 +61,8 @@
 static char *app_exec = "Exec";
 static char *exec_synopsis = "Executes dialplan application";
 static char *exec_descrip =
-"Usage: Exec(appname(arguments))\n"
-"  Allows an arbitrary application to be invoked even when not\n"
+"  Exec(appname(arguments)):\n"
+"Allows an arbitrary application to be invoked even when not\n"
 "hardcoded into the dialplan.  If the underlying application\n"
 "terminates the dialplan, or if the application cannot be found,\n"
 "Exec will terminate the dialplan.\n"
@@ -72,11 +72,11 @@
 static char *app_tryexec = "TryExec";
 static char *tryexec_synopsis = "Executes dialplan application, always returning";
 static char *tryexec_descrip =
-"Usage: TryExec(appname(arguments))\n"
-"  Allows an arbitrary application to be invoked even when not\n"
+"  TryExec(appname(arguments)):\n"
+"Allows an arbitrary application to be invoked even when not\n"
 "hardcoded into the dialplan. To invoke external applications\n"
 "see the application System.  Always returns to the dialplan.\n"
-"The channel variable TRYSTATUS will be set to:\n"
+"The channel variable TRYSTATUS will be set to one of:\n"
 "    SUCCESS   if the application returned zero\n"
 "    FAILED    if the application returned non-zero\n"
 "    NOAPP     if the application was not found or was not specified\n";
@@ -84,7 +84,7 @@
 static char *app_execif = "ExecIf";
 static char *execif_synopsis = "Executes dialplan application, conditionally";
 static char *execif_descrip = 
-"Usage:  ExecIF (<expr>?<app>(<data>):<app2>(<data2>))\n"
+"  ExecIF (<expr>?<app>(<data>):<app2>(<data2>))\n"
 "If <expr> is true, execute and return the result of <app>(<data>).\n"
 "If <expr> is true, but <app> is not found, then the application\n"
 "will return a non-zero value.\n";

Modified: trunk/apps/app_festival.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_festival.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_festival.c (original)
+++ trunk/apps/app_festival.c Tue Nov  6 13:04:45 2007
@@ -66,7 +66,7 @@
 static char *synopsis = "Say text to the user";
 
 static char *descrip = 
-"  Festival(text[,intkeys]):  Connect to Festival, send the argument, get back the waveform,"
+"  Festival(text[,intkeys]):  Connect to Festival, send the argument, get back the waveform,\n"
 "play it to the user, allowing any given interrupt keys to immediately terminate and return\n"
 "the value, or 'any' to allow any number back (useful in dialplan)\n";
 

Modified: trunk/apps/app_followme.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_followme.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_followme.c (original)
+++ trunk/apps/app_followme.c Tue Nov  6 13:04:45 2007
@@ -61,7 +61,7 @@
 static char *app = "FollowMe";
 static char *synopsis = "Find-Me/Follow-Me application";
 static char *descrip = 
-"  FollowMe(followmeid,options):\n"
+"  FollowMe(followmeid[,options]):\n"
 "This application performs Find-Me/Follow-Me functionality for the caller\n"
 "as defined in the profile matching the <followmeid> parameter in\n"
 "followme.conf. If the specified <followmeid> profile doesn't exist in\n"

Modified: trunk/apps/app_forkcdr.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_forkcdr.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_forkcdr.c (original)
+++ trunk/apps/app_forkcdr.c Tue Nov  6 13:04:45 2007
@@ -47,8 +47,9 @@
 "Forks the Call Data Record";
 static char *descrip = 
 "  ForkCDR([options]):  Causes the Call Data Record to fork an additional\n"
-	"cdr record starting from the time of the fork call\n"
-"If the option 'v' is passed all cdr variables will be passed along also.\n";
+"cdr record starting from the time of the fork call\n"
+"  Options:\n"
+"    v  - If the option is passed all cdr variables will be passed along also.\n";
 
 
 static void ast_cdr_fork(struct ast_channel *chan) 

Modified: trunk/apps/app_getcpeid.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_getcpeid.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_getcpeid.c (original)
+++ trunk/apps/app_getcpeid.c Tue Nov  6 13:04:45 2007
@@ -48,7 +48,7 @@
 static char *synopsis = "Get ADSI CPE ID";
 
 static char *descrip =
-"  GetCPEID: Obtains and displays ADSI CPE ID and other information in order\n"
+"  GetCPEID(): Obtains and displays ADSI CPE ID and other information in order\n"
 "to properly setup zapata.conf for on-hook operations.\n";
 
 

Modified: trunk/apps/app_macro.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_macro.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_macro.c (original)
+++ trunk/apps/app_macro.c Tue Nov  6 13:04:45 2007
@@ -79,7 +79,7 @@
 "  MacroIf(<expr>?macroname_a[,arg1][:macroname_b[,arg1]])\n"
 "Executes macro defined in <macroname_a> if <expr> is true\n"
 "(otherwise <macroname_b> if provided)\n"
-"Arguments and return values as in application macro()\n";
+"Arguments and return values as in application Macro()\n";
 
 static char *exclusive_descrip =
 "  MacroExclusive(macroname,arg1,arg2...):\n"

Modified: trunk/apps/app_minivm.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_minivm.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_minivm.c (original)
+++ trunk/apps/app_minivm.c Tue Nov  6 13:04:45 2007
@@ -230,7 +230,7 @@
 
 static char *synopsis_minivm_record = "Receive Mini-Voicemail and forward via e-mail";
 static char *descrip_minivm_record = 
-	"Syntax: MinivmRecord(username at domain[,options])\n"
+	"  MinivmRecord(username at domain[,options]):\n"
 	"This application is part of the Mini-Voicemail system, configured in minivm.conf.\n"
 	"MiniVM records audio file in configured format and forwards message to e-mail and pager.\n"
 	"If there's no user account for that address, a temporary account will\n"
@@ -253,7 +253,7 @@
 
 static char *synopsis_minivm_greet = "Play Mini-Voicemail prompts";
 static char *descrip_minivm_greet = 
-	"Syntax: MinivmGreet(username at domain[,options])\n"
+	"  MinivmGreet(username at domain[,options]):\n"
 	"This application is part of the Mini-Voicemail system, configured in minivm.conf.\n"
 	"MinivmGreet() plays default prompts or user specific prompts for an account.\n"
 	"Busy and unavailable messages can be choosen, but will be overridden if a temporary\n"
@@ -270,7 +270,7 @@
 
 static char *synopsis_minivm_notify = "Notify voicemail owner about new messages.";
 static char *descrip_minivm_notify = 
-	"Syntax: MinivmNotify(username at domain[,template])\n"
+	"  MinivmNotify(username at domain[,template]):\n"
 	"This application is part of the Mini-Voicemail system, configured in minivm.conf.\n"
 	"MiniVMnotify forwards messages about new voicemail to e-mail and pager.\n"
 	"If there's no user account for that address, a temporary account will\n"
@@ -289,7 +289,7 @@
 
 static char *synopsis_minivm_delete = "Delete Mini-Voicemail voicemail messages";
 static char *descrip_minivm_delete = 
-	"Syntax: MinivmDelete(filename)\n"
+	"  MinivmDelete(filename):\n"
 	"This application is part of the Mini-Voicemail system, configured in minivm.conf.\n"
 	"It deletes voicemail file set in MVM_FILENAME or given filename.\n"
 	"\n"
@@ -300,7 +300,7 @@
 
 static char *synopsis_minivm_accmess = "Record account specific messages";
 static char *descrip_minivm_accmess = 
-	"Syntax: MinivmAccmess(username at domain,option)\n"
+	"  MinivmAccmess(username at domain,option):\n"
 	"This application is part of the Mini-Voicemail system, configured in minivm.conf.\n"
 	"Use this application to record account specific audio/video messages for\n"
 	"busy, unavailable and temporary messages.\n"

Modified: trunk/apps/app_mixmonitor.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_mixmonitor.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_mixmonitor.c (original)
+++ trunk/apps/app_mixmonitor.c Tue Nov  6 13:04:45 2007
@@ -60,7 +60,7 @@
 static const char *app = "MixMonitor";
 static const char *synopsis = "Record a call and mix the audio during the recording";
 static const char *desc = ""
-"  MixMonitor(<file>.<ext>[,<options>[,<command>]])\n\n"
+"  MixMonitor(<file>.<ext>[,<options>[,<command>]]):\n"
 "Records the audio on the current channel to the specified file.\n"
 "If the filename is an absolute path, uses that path, otherwise\n"
 "creates the file in the configured monitoring directory from\n"
@@ -83,7 +83,7 @@
 static const char *stop_app = "StopMixMonitor";
 static const char *stop_synopsis = "Stop recording a call through MixMonitor";
 static const char *stop_desc = ""
-"  StopMixMonitor()\n\n"
+"  StopMixMonitor():\n"
 "Stops the audio recording that was started with a call to MixMonitor()\n"
 "on the current channel.\n"
 "";

Modified: trunk/apps/app_morsecode.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_morsecode.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_morsecode.c (original)
+++ trunk/apps/app_morsecode.c Tue Nov  6 13:04:45 2007
@@ -46,7 +46,7 @@
 static char *morsecode_synopsis = "Plays morse code";
 
 static char *morsecode_descrip =
-"Usage: Morsecode(<string>)\n"
+"  Morsecode(<string>):\n"
 "Plays the Morse code equivalent of the passed string.  If the variable\n"
 "MORSEDITLEN is set, it will use that value for the length (in ms) of the dit\n"
 "(defaults to 80).  Additionally, if MORSETONE is set, it will use that tone\n"

Modified: trunk/apps/app_mp3.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_mp3.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_mp3.c (original)
+++ trunk/apps/app_mp3.c Tue Nov  6 13:04:45 2007
@@ -55,7 +55,7 @@
 static char *synopsis = "Play an MP3 file or stream";
 
 static char *descrip = 
-"  MP3Player(location) Executes mpg123 to play the given location,\n"
+"  MP3Player(location): Executes mpg123 to play the given location,\n"
 "which typically would be a filename or a URL. User can exit by pressing\n"
 "any key on the dialpad, or by hanging up."; 
 

Modified: trunk/apps/app_nbscat.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_nbscat.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_nbscat.c (original)
+++ trunk/apps/app_nbscat.c Tue Nov  6 13:04:45 2007
@@ -60,8 +60,8 @@
 static char *synopsis = "Play an NBS local stream";
 
 static char *descrip = 
-"  NBScat: Executes nbscat to listen to the local NBS stream.\n"
-"User can exit by pressing any key\n.";
+"  NBScat(): Executes nbscat to listen to the local NBS stream.\n"
+"User can exit by pressing any key.\n";
 
 
 static int NBScatplay(int fd)

Modified: trunk/apps/app_playback.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_playback.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_playback.c (original)
+++ trunk/apps/app_playback.c Tue Nov  6 13:04:45 2007
@@ -53,8 +53,8 @@
 
 static char *descrip = 
 "  Playback(filename[&filename2...][,option]):  Plays back given filenames (do not put\n"
-"extension). Options may also be included following a pipe symbol. The 'skip'\n"
-"option causes the playback of the message to be skipped if the channel\n"
+"extension). Options may also be included following a comma.\n"
+"The 'skip' option causes the playback of the message to be skipped if the channel\n"
 "is not in the 'up' state (i.e. it hasn't been  answered  yet). If 'skip' is \n"
 "specified, the application will return immediately should the channel not be\n"
 "off hook.  Otherwise, unless 'noanswer' is specified, the channel will\n"

Modified: trunk/apps/app_readfile.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_readfile.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_readfile.c (original)
+++ trunk/apps/app_readfile.c Tue Nov  6 13:04:45 2007
@@ -44,13 +44,13 @@
 
 static char *app_readfile = "ReadFile";
 
-static char *readfile_synopsis = "ReadFile(varname=file,length)";
+static char *readfile_synopsis = "Read the contents of a text file into a channel variable";
 
 static char *readfile_descrip =
 "ReadFile(varname=file,length)\n"
-"  Varname - Result stored here.\n"
-"  File - The name of the file to read.\n"
-"  Length - Maximum number of characters to capture.\n";
+"  varname  - Result stored here.\n"
+"  file     - The name of the file to read.\n"
+"  length   - Maximum number of characters to capture.\n";
 
 
 static int readfile_exec(struct ast_channel *chan, void *data)

Modified: trunk/apps/app_sayunixtime.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_sayunixtime.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_sayunixtime.c (original)
+++ trunk/apps/app_sayunixtime.c Tue Nov  6 13:04:45 2007
@@ -50,19 +50,19 @@
 
 static char *sayunixtime_descrip =
 "SayUnixTime([unixtime][,[timezone][,format]])\n"
-"  unixtime: time, in seconds since Jan 1, 1970.  May be negative.\n"
+"  unixtime  - time, in seconds since Jan 1, 1970.  May be negative.\n"
 "              defaults to now.\n"
-"  timezone: timezone, see /usr/share/zoneinfo for a list.\n"
+"  timezone  - timezone, see /usr/share/zoneinfo for a list.\n"
 "              defaults to machine default.\n"
-"  format:   a format the time is to be said in.  See voicemail.conf.\n"
+"  format    - a format the time is to be said in.  See voicemail.conf.\n"
 "              defaults to \"ABdY 'digits/at' IMp\"\n";
 static char *datetime_descrip =
 "DateTime([unixtime][,[timezone][,format]])\n"
-"  unixtime: time, in seconds since Jan 1, 1970.  May be negative.\n"
+"  unixtime  - time, in seconds since Jan 1, 1970.  May be negative.\n"
 "              defaults to now.\n"
-"  timezone: timezone, see /usr/share/zoneinfo for a list.\n"
+"  timezone  - timezone, see /usr/share/zoneinfo for a list.\n"
 "              defaults to machine default.\n"
-"  format:   a format the time is to be said in.  See voicemail.conf.\n"
+"  format:   - a format the time is to be said in.  See voicemail.conf.\n"
 "              defaults to \"ABdY 'digits/at' IMp\"\n";
 
 

Modified: trunk/apps/app_sms.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_sms.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_sms.c (original)
+++ trunk/apps/app_sms.c Tue Nov  6 13:04:45 2007
@@ -88,13 +88,13 @@
 	"service centre to SMS()\n"
 	"name is the name of the queue used in /var/spool/asterisk/sms\n"
 	"Arguments:\n"
-	" a: answer, i.e. send initial FSK packet.\n"
-	" s: act as service centre talking to a phone.\n"
-	" t: use protocol 2 (default used is protocol 1).\n"
-	" p(N): set the initial delay to N ms (default is 300).\n"
-	"addr and body are a deprecated format to send messages out.\n"
-	" s: set the Status Report Request (SRR) bit.\n"
-	" o: the body should be coded as octets not 7-bit symbols.\n"
+	" a  - answer, i.e. send initial FSK packet.\n"
+	" s  - act as service centre talking to a phone.\n"
+	" t  - use protocol 2 (default used is protocol 1).\n"
+	" p(N)  - set the initial delay to N ms (default is 300).\n"
+	"         addr and body are a deprecated format to send messages out.\n"
+	" s  - set the Status Report Request (SRR) bit.\n"
+	" o  - the body should be coded as octets not 7-bit symbols.\n"
 	"Messages are processed as per text file message queues.\n" 
 	"smsq (a separate software) is a command to generate message\n"
 	"queues and send messages.\n"

Modified: trunk/apps/app_softhangup.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_softhangup.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_softhangup.c (original)
+++ trunk/apps/app_softhangup.c Tue Nov  6 13:04:45 2007
@@ -45,11 +45,11 @@
 
 static char *synopsis = "Soft Hangup Application";
 
-static char *desc = "SoftHangup(Technology/resource[,options])\n"
+static char *desc = "  SoftHangup(Technology/resource[,options]):\n"
 "Hangs up the requested channel.  If there are no channels to hangup,\n"
 "the application will report it.\n"
-"- 'options' may contain the following letter:\n"
-"     'a' : hang up all channels on a specified device instead of a single resource\n";
+"  Options:\n"
+"     'a'  - hang up all channels on a specified device instead of a single resource\n";
 
 static char *app = "SoftHangup";
 

Modified: trunk/apps/app_speech_utils.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_speech_utils.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_speech_utils.c (original)
+++ trunk/apps/app_speech_utils.c Tue Nov  6 13:04:45 2007
@@ -45,49 +45,57 @@
 
 /* Descriptions for each application */
 static char *speechcreate_descrip =
-"SpeechCreate(engine name)\n"
-"This application creates information to be used by all the other applications. It must be called before doing any speech recognition activities such as activating a grammar.\n"
+"  SpeechCreate(engine name):\n"
+"This application creates information to be used by all the other applications.\n"
+"It must be called before doing any speech recognition activities such as activating a grammar.\n"
 "It takes the engine name to use as the argument, if not specified the default engine will be used.\n";
 
 static char *speechactivategrammar_descrip =
-"SpeechActivateGrammar(Grammar Name)\n"
-"This activates the specified grammar to be recognized by the engine. A grammar tells the speech recognition engine what to recognize, \n"
-	"and how to portray it back to you in the dialplan. The grammar name is the only argument to this application.\n";
+"  SpeechActivateGrammar(Grammar Name):\n"
+"This activates the specified grammar to be recognized by the engine.\n"
+"A grammar tells the speech recognition engine what to recognize, and how to portray it back to you \n"
+"in the dialplan. The grammar name is the only argument to this application.\n";
 
 static char *speechstart_descrip =
-"SpeechStart()\n"
-	"Tell the speech recognition engine that it should start trying to get results from audio being fed to it. This has no arguments.\n";
+"  SpeechStart():\n"
+"Tell the speech recognition engine that it should start trying to get results from audio being \n"
+"fed to it. This has no arguments.\n";
 
 static char *speechbackground_descrip =
-"SpeechBackground(Sound File,Timeout)\n"
-"This application plays a sound file and waits for the person to speak. Once they start speaking playback of the file stops, and silence is heard.\n"
-"Once they stop talking the processing sound is played to indicate the speech recognition engine is working.\n"
-"Once results are available the application returns and results (score and text) are available using dialplan functions.\n"
-"The first text and score are ${SPEECH_TEXT(0)} AND ${SPEECH_SCORE(0)} while the second are ${SPEECH_TEXT(1)} and ${SPEECH_SCORE(1)}.\n"
-"The first argument is the sound file and the second is the timeout integer in seconds. Note the timeout will only start once the sound file has stopped playing.\n";
+"  SpeechBackground(Sound File,Timeout):\n"
+"This application plays a sound file and waits for the person to speak. Once they start speaking playback\n"
+"of the file stops, and silence is heard. Once they stop talking the processing sound is played to indicate\n"
+"the speech recognition engine is working. Once results are available the application returns and results \n"
+"(score and text) are available using dialplan functions.\n"
+"The first text and score are ${SPEECH_TEXT(0)} AND ${SPEECH_SCORE(0)} while the second are ${SPEECH_TEXT(1)}\n"
+"and ${SPEECH_SCORE(1)}.\n"
+"The first argument is the sound file and the second is the timeout integer in seconds. Note the timeout will\n"
+"only start once the sound file has stopped playing.\n";
 
 static char *speechdeactivategrammar_descrip =
-"SpeechDeactivateGrammar(Grammar Name)\n"
-	"This deactivates the specified grammar so that it is no longer recognized. The only argument is the grammar name to deactivate.\n";
+"  SpeechDeactivateGrammar(Grammar Name):\n"
+"This deactivates the specified grammar so that it is no longer recognized.\n"
+"The only argument is the grammar name to deactivate.\n";
 
 static char *speechprocessingsound_descrip =
-"SpeechProcessingSound(Sound File)\n"
-"This changes the processing sound that SpeechBackground plays back when the speech recognition engine is processing and working to get results.\n"
-	"It takes the sound file as the only argument.\n";
+"  SpeechProcessingSound(Sound File):\n"
+"This changes the processing sound that SpeechBackground plays back when the speech recognition engine is\n"
+"processing and working to get results.\n"
+"It takes the sound file as the only argument.\n";
 
 static char *speechdestroy_descrip =
-"SpeechDestroy()\n"
+"  SpeechDestroy():\n"
 "This destroys the information used by all the other speech recognition applications.\n"
 "If you call this application but end up wanting to recognize more speech, you must call SpeechCreate\n"
 	"again before calling any other application. It takes no arguments.\n";
 
 static char *speechload_descrip =
-"SpeechLoadGrammar(Grammar Name,Path)\n"
+"  SpeechLoadGrammar(Grammar Name,Path):\n"
 "Load a grammar only on the channel, not globally.\n"
 "It takes the grammar name as first argument and path as second.\n";
 
 static char *speechunload_descrip =
-"SpeechUnloadGrammar(Grammar Name)\n"
+"  SpeechUnloadGrammar(Grammar Name):\n"
 "Unload a grammar. It takes the grammar name as the only argument.\n";
 
 /*! \brief Helper function used by datastores to destroy the speech structure upon hangup */

Modified: trunk/apps/app_stack.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_stack.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_stack.c (original)
+++ trunk/apps/app_stack.c Tue Nov  6 13:04:45 2007
@@ -55,20 +55,20 @@
 static const char *pop_synopsis = "Remove one address from gosub stack";
 
 static const char *gosub_descrip =
-"Gosub([[context,]exten,]priority[(arg1[,...][,argN])])\n"
-"  Jumps to the label specified, saving the return address.\n";
+"  Gosub([[context,]exten,]priority[(arg1[,...][,argN])]):\n"
+"Jumps to the label specified, saving the return address.\n";
 static const char *gosubif_descrip =
-"GosubIf(condition?labeliftrue[(arg1[,...])][:labeliffalse[(arg1[,...])]])\n"
-"  If the condition is true, then jump to labeliftrue.  If false, jumps to\n"
+"  GosubIf(condition?labeliftrue[(arg1[,...])][:labeliffalse[(arg1[,...])]]):\n"
+"If the condition is true, then jump to labeliftrue.  If false, jumps to\n"
 "labeliffalse, if specified.  In either case, a jump saves the return point\n"
 "in the dialplan, to be returned to with a Return.\n";
 static const char *return_descrip =
-"Return([return-value])\n"
-"  Jumps to the last label on the stack, removing it.  The return value, if\n"
+"  Return([return-value]):\n"
+"Jumps to the last label on the stack, removing it.  The return value, if\n"
 "any, is saved in the channel variable GOSUB_RETVAL.\n";
 static const char *pop_descrip =
-"StackPop()\n"
-"  Removes last label on the stack, discarding it.\n";
+"  StackPop():\n"
+"Removes last label on the stack, discarding it.\n";
 
 
 static void gosub_free(void *data);

Modified: trunk/apps/app_test.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_test.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_test.c (original)
+++ trunk/apps/app_test.c Tue Nov  6 13:04:45 2007
@@ -49,13 +49,13 @@
 #include "asterisk/utils.h"
 
 static char *tests_descrip = 
-	 "TestServer(): Perform test server function and write call report.\n"
+	 "  TestServer(): Perform test server function and write call report.\n"
 	 "Results stored in /var/log/asterisk/testreports/<testid>-server.txt";
 static char *tests_app = "TestServer";
 static char *tests_synopsis = "Execute Interface Test Server";
 
 static char *testc_descrip = 
-	 "TestClient(testid): Executes test client with given testid.\n"
+	 "  TestClient(testid): Executes test client with given testid.\n"
 	 "Results stored in /var/log/asterisk/testreports/<testid>-client.txt";
 
 static char *testc_app = "TestClient";

Modified: trunk/apps/app_waitforring.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_waitforring.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_waitforring.c (original)
+++ trunk/apps/app_waitforring.c Tue Nov  6 13:04:45 2007
@@ -45,7 +45,7 @@
 
 static char *synopsis = "Wait for Ring Application";
 
-static char *desc = "  WaitForRing(timeout)\n"
+static char *desc = "  WaitForRing(timeout):\n"
 "Returns 0 after waiting at least timeout seconds. and\n"
 "only after the next ring has completed.  Returns 0 on\n"
 "success or -1 on hangup\n";

Modified: trunk/apps/app_waitforsilence.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_waitforsilence.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_waitforsilence.c (original)
+++ trunk/apps/app_waitforsilence.c Tue Nov  6 13:04:45 2007
@@ -52,7 +52,7 @@
 static char *app = "WaitForSilence";
 static char *synopsis = "Waits for a specified amount of silence";
 static char *descrip =
-"  WaitForSilence(silencerequired[,iterations][,timeout]) \n"
+"  WaitForSilence(silencerequired[,iterations][,timeout]):\n"
 "Wait for Silence: Waits for up to 'silencerequired' \n"
 "milliseconds of silence, 'iterations' times or once if omitted.\n"
 "An optional timeout specified the number of seconds to return\n"

Modified: trunk/apps/app_while.c
URL: http://svn.digium.com/view/asterisk/trunk/apps/app_while.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/apps/app_while.c (original)
+++ trunk/apps/app_while.c Tue Nov  6 13:04:45 2007
@@ -46,30 +46,26 @@
 
 static char *start_app = "While";
 static char *start_desc = 
-"Usage:  While(<expr>)\n"
-"Start a While Loop.  Execution will return to this point when\n"
-"EndWhile is called until expr is no longer true.\n";
+"  While(<expr>): Start a While Loop.  Execution will return to this\n"
+"point when EndWhile() is called until expr is no longer true.\n";
 
 static char *start_synopsis = "Start a while loop";
 
 
 static char *stop_app = "EndWhile";
 static char *stop_desc = 
-"Usage:  EndWhile()\n"
-"Return to the previous called While\n";
+"  EndWhile(): Return to the previous called While()\n";
 
 static char *stop_synopsis = "End a while loop";
 
 static char *exit_app = "ExitWhile";
 static char *exit_desc =
-"Usage:  ExitWhile()\n"
-"Exits a While loop, whether or not the conditional has been satisfied.\n";
+"  ExitWhile(): Exits a While() loop, whether or not the conditional has been satisfied.\n";
 static char *exit_synopsis = "End a While loop";
 
 static char *continue_app = "ContinueWhile";
 static char *continue_desc =
-"Usage:  ContinueWhile()\n"
-"Returns to the top of the while loop and re-evaluates the conditional.\n";
+"  ContinueWhile(): Returns to the top of the while loop and re-evaluates the conditional.\n";
 static char *continue_synopsis = "Restart a While loop";
 
 #define VAR_SIZE 64

Modified: trunk/channels/chan_agent.c
URL: http://svn.digium.com/view/asterisk/trunk/channels/chan_agent.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/channels/chan_agent.c (original)
+++ trunk/channels/chan_agent.c Tue Nov  6 13:04:45 2007
@@ -89,7 +89,7 @@
 "when a new call comes in. The agent can dump the call by pressing\n"
 "the star key.\n"
 "The option string may contain zero or more of the following characters:\n"
-"      's' -- silent login - do not announce the login ok segment after agent logged in/off\n";
+"      's' -- silent login - do not announce the login ok segment after agent logged on/off\n";
 
 static const char descrip3[] =
 "  AgentMonitorOutgoing([options]):\n"
@@ -97,11 +97,11 @@
 "comparison of the callerid of the current interface and the global variable \n"
 "placed by the AgentCallbackLogin application. That's why it should be used only\n"
 "with the AgentCallbackLogin app. Uses the monitoring functions in chan_agent \n"
-"instead of Monitor application. That have to be configured in the agents.conf file.\n"
+"instead of Monitor application. That has to be configured in the agents.conf file.\n"
 "\nReturn value:\n"
 "Normally the app returns 0 unless the options are passed.\n"
 "\nOptions:\n"
-"	'd' - make the app return -1 if there is an error condition"
+"	'd' - make the app return -1 if there is an error condition\n"
 "	'c' - change the CDR so that the source of the call is 'Agent/agent_id'\n"
 "	'n' - don't generate the warnings when there is no callerid or the\n"
 "	      agentid is not known.\n"

Modified: trunk/channels/chan_sip.c
URL: http://svn.digium.com/view/asterisk/trunk/channels/chan_sip.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/channels/chan_sip.c (original)
+++ trunk/channels/chan_sip.c Tue Nov  6 13:04:45 2007
@@ -18703,14 +18703,14 @@
 }
 
 static char *synopsis_dtmfmode = "Change the dtmfmode for a SIP call";
-static char *descrip_dtmfmode = "SIPDtmfMode(inband|info|rfc2833): Changes the dtmfmode for a SIP call\n";
+static char *descrip_dtmfmode = "  SIPDtmfMode(inband|info|rfc2833): Changes the dtmfmode for a SIP call\n";
 static char *app_dtmfmode = "SIPDtmfMode";
 
 static char *app_sipaddheader = "SIPAddHeader";
 static char *synopsis_sipaddheader = "Add a SIP header to the outbound call";
 
 static char *descrip_sipaddheader = ""
-"  SIPAddHeader(Header: Content)\n"
+"  SIPAddHeader(Header: Content):\n"
 "Adds a header to a SIP call placed with DIAL.\n"
 "Remember to user the X-header if you are adding non-standard SIP\n"
 "headers, like \"X-Asterisk-Accountcode:\". Use this with care.\n"

Modified: trunk/main/pbx.c
URL: http://svn.digium.com/view/asterisk/trunk/main/pbx.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/main/pbx.c (original)
+++ trunk/main/pbx.c Tue Nov  6 13:04:45 2007
@@ -435,11 +435,12 @@
 	},
 
 	{ "NoOp", pbx_builtin_noop,
-	"Do Nothing",
-	"  NoOp(): This applicatiion does nothing. However, it is useful for debugging\n"
+	"Do Nothing (No Operation)",
+	"  NoOp(): This application does nothing. However, it is useful for debugging\n"
 	"purposes. Any text that is provided as arguments to this application can be\n"
 	"viewed at the Asterisk CLI. This method can be used to see the evaluations of\n"
-	"variables or functions without having any effect."
+	"variables or functions without having any effect. Alternatively, see the\n"
+  "Verbose() application for finer grain control of output at custom verbose levels.\n"
 	},
 
 	{ "Progress", pbx_builtin_progress,

Modified: trunk/res/res_features.c
URL: http://svn.digium.com/view/asterisk/trunk/res/res_features.c?view=diff&rev=89044&r1=89043&r2=89044
==============================================================================
--- trunk/res/res_features.c (original)
+++ trunk/res/res_features.c Tue Nov  6 13:04:45 2007
@@ -134,7 +134,7 @@
 /* module and CLI command definitions */
 static char *synopsis = "Answer a parked call";
 
-static char *descrip = "ParkedCall(exten):"
+static char *descrip = "ParkedCall(exten): "
 "Used to connect to a parked call.  This application is always\n"
 "registered internally and does not need to be explicitly added\n"
 "into the dialplan, although you should include the 'parkedcalls'\n"
@@ -144,14 +144,14 @@
 
 static char *synopsis2 = "Park yourself";
 
-static char *descrip2 = "Park():"
+static char *descrip2 = "Park(): "
 "Used to park yourself (typically in combination with a supervised\n"
 "transfer to know the parking space). This application is always\n"
 "registered internally and does not need to be explicitly added\n"
 "into the dialplan, although you should include the 'parkedcalls'\n"
 "context (or the context specified in features.conf).\n\n"
 "If you set the PARKINGEXTEN variable to an extension in your\n"
-"parking context, park() will park the call on that extension, unless\n"
+"parking context, Park() will park the call on that extension, unless\n"
 "it already exists. In that case, execution will continue at next\n"
 "priority.\n" ;
 
@@ -3107,12 +3107,14 @@
 static char *app_bridge = "Bridge";
 static char *bridge_synopsis = "Bridge two channels";
 static char *bridge_descrip =
-"Usage: Bridge(channel[|options])\n"
+"Usage: Bridge(channel[,options])\n"
 "	Allows the ability to bridge two channels via the dialplan.\n"
 "The current channel is bridged to the specified 'channel'.\n"
-"The following options are supported:\n"
-"   p - Play a courtesy tone to 'channel'.\n"
-"BRIDGERESULT dial plan variable will contain SUCCESS, FAILURE, LOOP, NONEXISTENT or INCOMPATIBLE.\n";
+"  Options:\n"
+"    p - Play a courtesy tone to 'channel'.\n"
+"This application sets the following channel variable upon completion:\n"

[... 125 lines stripped ...]



More information about the asterisk-commits mailing list