[Asterisk-cvs] asterisk/apps app_adsiprog.c, 1.20, 1.21 app_authenticate.c, 1.21, 1.22 app_chanisavail.c, 1.28, 1.29 app_controlplayback.c, 1.20, 1.21 app_curl.c, 1.16, 1.17 app_cut.c, 1.20, 1.21 app_datetime.c, 1.8, 1.9 app_db.c, 1.19, 1.20 app_dial.c, 1.182, 1.183 app_directory.c, 1.50, 1.51 app_disa.c, 1.43, 1.44 app_dumpchan.c, 1.15, 1.16 app_echo.c, 1.16, 1.17 app_enumlookup.c, 1.27, 1.28 app_flash.c, 1.10, 1.11 app_getcpeid.c, 1.12, 1.13 app_groupcount.c, 1.27, 1.28 app_ices.c, 1.13, 1.14 app_image.c, 1.14, 1.15 app_intercom.c, 1.27, 1.28 app_lookupblacklist.c, 1.15, 1.16 app_lookupcidname.c, 1.12, 1.13 app_macro.c, 1.33, 1.34 app_math.c, 1.18, 1.19 app_md5.c, 1.14, 1.15 app_meetme.c, 1.121, 1.122 app_mp3.c, 1.32, 1.33 app_nbscat.c, 1.16, 1.17 app_page.c, 1.11, 1.12 app_playback.c, 1.25, 1.26 app_privacy.c, 1.21, 1.22 app_queue.c, 1.176, 1.177 app_read.c, 1.28, 1.29 app_record.c, 1.44, 1.45 app_sayunixtime.c, 1.15, 1.16 app_senddtmf.c, 1.16, 1.17 app_sendtext.c, 1.14, 1.15 app_setcallerid.c, 1.15, 1.16 app_setcdruserfield.c, 1.13, 1.14 app_setcidname.c, 1.16, 1.17 app_setcidnum.c, 1.16, 1.17 app_setrdnis.c, 1.11, 1.12 app_settransfercapability.c, 1.11, 1.12 app_sms.c, 1.31, 1.32 app_softhangup.c, 1.14, 1.15 app_striplsd.c, 1.11, 1.12 app_system.c, 1.23, 1.24 app_talkdetect.c, 1.18, 1.19 app_verbose.c, 1.10, 1.11 app_voicemail.c, 1.262, 1.263 app_zapateller.c, 1.15, 1.16 app_zapras.c, 1.17, 1.18

kpfleming kpfleming
Mon Nov 7 17:10:16 CST 2005


Update of /usr/cvsroot/asterisk/apps
In directory mongoose.digium.com:/tmp/cvs-serv12964/apps

Modified Files:
	app_adsiprog.c app_authenticate.c app_chanisavail.c 
	app_controlplayback.c app_curl.c app_cut.c app_datetime.c 
	app_db.c app_dial.c app_directory.c app_disa.c app_dumpchan.c 
	app_echo.c app_enumlookup.c app_flash.c app_getcpeid.c 
	app_groupcount.c app_ices.c app_image.c app_intercom.c 
	app_lookupblacklist.c app_lookupcidname.c app_macro.c 
	app_math.c app_md5.c app_meetme.c app_mp3.c app_nbscat.c 
	app_page.c app_playback.c app_privacy.c app_queue.c app_read.c 
	app_record.c app_sayunixtime.c app_senddtmf.c app_sendtext.c 
	app_setcallerid.c app_setcdruserfield.c app_setcidname.c 
	app_setcidnum.c app_setrdnis.c app_settransfercapability.c 
	app_sms.c app_softhangup.c app_striplsd.c app_system.c 
	app_talkdetect.c app_verbose.c app_voicemail.c 
	app_zapateller.c app_zapras.c 
Log Message:
application doc update


Index: app_adsiprog.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_adsiprog.c,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- app_adsiprog.c	6 Nov 2005 15:09:46 -0000	1.20
+++ app_adsiprog.c	7 Nov 2005 22:01:21 -0000	1.21
@@ -56,8 +56,9 @@
 
 static char *descrip =
 "  ADSIProg(script): Programs an ADSI Phone with the given script.\n"
-"If none is specified, the default is used.  Returns 0 unless CPE\n" 
-"is hungup.\n";
+"If none is specified, the default script is used.  The reprogramming\n"  
+"will complete successfully, except in cases where the device is  \n"
+"disconnected or hungup.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_authenticate.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_authenticate.c,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- app_authenticate.c	6 Nov 2005 15:09:46 -0000	1.21
+++ app_authenticate.c	7 Nov 2005 22:01:21 -0000	1.22
@@ -65,11 +65,10 @@
 "     r - Remove database key upon successful entry (valid with 'd' only)\n"
 "\n"
 "When using a database key, the value associated with the key can be\n"
-"anything.\n"
-"Returns 0 if the user enters a valid password within three\n"
-"tries, or -1 on hangup.  If the priority n+101 exists and invalid\n"
-"authentication was entered, and the 'j' flag was specified, processing\n"
-"will jump to n+101 and 0 will be returned.\n";
+"anything.  Users have three attempts to authenticate before the line is \n"
+"hungup.  If the passsword is invalid, and the 'j' flag is specified, \n"
+"and priority n+101 exists, the call would be sent to the n+101 priority \n"
+"and executed \n";
 
 STANDARD_LOCAL_USER;
 

Index: app_chanisavail.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_chanisavail.c,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -d -r1.28 -r1.29
--- app_chanisavail.c	6 Nov 2005 18:11:13 -0000	1.28
+++ app_chanisavail.c	7 Nov 2005 22:01:21 -0000	1.29
@@ -52,16 +52,18 @@
 
 static char *descrip = 
 "  ChanIsAvail(Technology/resource[&Technology2/resource2...][|option]): \n"
-"Checks is any of the requested channels are available.  \n"
-"If any of the requested channels are available, the next priority will be n+1,\n"
-"the channel variable ${AVAILCHAN} will be set to the name of the available channel\n"
-"and the ChanIsAvail app will return 0.\n"
-"${AVAILORIGCHAN} is the canonical channel name that was used to create the channel.\n"
-"${AVAILSTATUS} is the status code for the channel.\n"
+"Checks if any of the requested channels are available.  \n"
+"If any of the requested channels are available, the dialplan will continue and:\n"
+"  ${AVAILCHAN} will be set to the name of the available channel\n"
+"  ${AVAILORIGCHAN} is the canonical channel name that was used to create the channel\n"
+"  ${AVAILSTATUS} is the status code for the channel\n"
 "If the option 's' is specified (state), will consider channel unavailable\n"
 "when the channel is in use at all, even if it can take another call.\n"
-"If the option 'j' is specified (jump), the application will jump to n+101 \n"
-"(unless such a priority does not exist, in which case ChanIsAvail will return -1)\n";
+"If none of the requested channels are available, then:\n"
+"  if the option 'j' is specified (jump), the application will jump to n+101\n"
+"    if it exists, otherwise the call will terminate\n"
+"  if the option 'j' is not specified the dialplan will continue and\n"
+"    ${AVAILCHAN} will be empty\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_controlplayback.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_controlplayback.c,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- app_controlplayback.c	6 Nov 2005 15:09:46 -0000	1.20
+++ app_controlplayback.c	7 Nov 2005 22:01:21 -0000	1.21
@@ -48,16 +48,15 @@
 
 static const char *descrip = 
 "ControlPlayback(filename[|skipms[|ffchar[|rewchar[|stopchar[|pausechar[|restartchar[|option]]]]]]]):\n"
-"  Plays  back  a  given  filename (do not put extension). Options may also\n"
+"  Plays back a given filename (do not put extension). Options may also\n"
 "  be included following a pipe symbol.  You can use * and # to rewind and\n"
 "  fast forward the playback specified. If 'stopchar' is added the file will\n"
 "  terminate playback when 'stopchar' is pressed. If 'restartchar' is added, the file\n"
-"  will restart when 'restartchar' is pressed. Returns -1 if the channel\n"
-"  was hung up. \n\n"
-"  The option string may contain zero or the following character:\n"
+"  will restart when 'restartchar' is pressed.\n"
+"  The option string may contain the following character:\n"
 "       'j' -- jump to +101 priority if the file requested isn't found.\n"
 "  This application sets the following channel variable upon completion:\n"
-"     CPLAYBACKSTATUS       The status of the attempt to add a queue member as a text string, one of\n"
+"     CPLAYBACKSTATUS       The status of the attempt as a text string, one of\n"
 "             SUCCESS | USERSTOPPED | ERROR\n"
 "  Example:  exten => 1234,1,ControlPlayback(file|4000|*|#|1|0|5)\n\n";
 

Index: app_curl.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_curl.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- app_curl.c	6 Nov 2005 15:09:46 -0000	1.16
+++ app_curl.c	7 Nov 2005 22:01:21 -0000	1.17
@@ -48,7 +48,7 @@
 
 static char *descrip = 
 "  Curl(URL[|postdata]): Requests the URL.  Mainly used for signalling\n"
-"external applications of an event.  Returns 0 or -1 on fatal error.\n"
+"external applications of an event.  Curl will fail on fatal errors. \n"
 "Argument specified treated as POST data.  Also sets CURL variable with the\n"
 "resulting page.\n";
 

Index: app_cut.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_cut.c,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- app_cut.c	6 Nov 2005 15:09:46 -0000	1.20
+++ app_cut.c	7 Nov 2005 22:01:21 -0000	1.21
@@ -56,7 +56,7 @@
 "  fieldspec - number of the field you want (1-based offset)\n"
 "            may also be specified as a range (with -)\n"
 "            or group of ranges and fields (with &)\n" 
-"  Returns 0 or -1 on hangup or error.\n";
+"  The process with complete on success or fail on hangup or error\n";
 
 static char *app_sort = "Sort";
 static char *app_sort_synopsis = "Sorts a list of keywords and values";
@@ -64,7 +64,7 @@
 "   Sort(<newvar>=<key1>:<val1>[,<key2>:<val2>[[...],<keyN>:<valN>]])\n"
 "Sorts the list provided by using the value as a float to order the list of\n"
 "keywords in ascending order.  Sets the variable provided to the list of\n"
-"sorted keywords.  Always returns 0.\n";
+"sorted keywords. \n";
 
 STANDARD_LOCAL_USER;
 

Index: app_datetime.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_datetime.c,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- app_datetime.c	6 Nov 2005 15:09:46 -0000	1.8
+++ app_datetime.c	7 Nov 2005 22:01:21 -0000	1.9
@@ -45,8 +45,8 @@
 static char *synopsis = "Say the date and time";
 
 static char *descrip = 
-"  DateTime():  Says the current date and time.  Returns -1 on hangup or 0\n"
-"otherwise.\n";
+"  DateTime():  Says the current date and time.  Terminates on hangup or\n"
+"completion.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_db.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_db.c,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- app_db.c	6 Nov 2005 18:30:23 -0000	1.19
+++ app_db.c	7 Nov 2005 22:01:21 -0000	1.20
@@ -48,24 +48,23 @@
 
 static char *g_descrip =
 	"  DBget(varname=family/key[|options]): Retrieves a value from the Asterisk\n"
-	"database and stores it in the given variable.  Always returns 0.  \n"
-	"  The option string may contain zero or the following character:\n"
-	"       'j' -- jump to +101 priority if the file requested family/key isn't found.\n"
+	"database and stores it in the given variable.\n"
+	"  The option string may contain the following character:\n"
+	"       'j' -- jump to +101 priority if the requested family/key isn't found.\n"
 	"  This application sets the following channel variable upon completion:\n"
-	"     DBGETSTATUS       The status of the attempt to add a queue member as a text string, one of\n"
+	"     DBGETSTATUS       The status of the attempt as a text string, one of\n"
 	"             FOUND | NOTFOUND \n";
 
 static char *p_descrip =
 	"  DBput(family/key=value): Stores the given value in the Asterisk\n"
-	"database.  Always returns 0.\n";
+	"database.\n";
 
 static char *d_descrip =
-	"  DBdel(family/key): Deletes a key from the Asterisk database.  Always\n"
-	"returns 0.\n";
+	"  DBdel(family/key): Deletes a key from the Asterisk database.\n";
 
 static char *dt_descrip =
 	"  DBdeltree(family[/keytree]): Deletes a family or keytree from the Asterisk\n"
-	"database.  Always returns 0.\n";
+	"database.\n";
 
 static char *g_app = "DBget";
 static char *p_app = "DBput";

Index: app_dial.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_dial.c,v
retrieving revision 1.182
retrieving revision 1.183
diff -u -d -r1.182 -r1.183
--- app_dial.c	6 Nov 2005 21:00:35 -0000	1.182
+++ app_dial.c	7 Nov 2005 22:01:21 -0000	1.183
@@ -70,14 +70,14 @@
 "which first answered. All other calls placed by the Dial app will be hung up.\n"
 "If a timeout is not specified, the Dial application will wait indefinitely\n"
 "until either one of the called channels answers, the user hangs up, or all\n"
-"channels return busy or error. In general, the dialer will return 0 if it\n"
-"was unable to place the call, or the timeout expired. \n"
+"channels return busy or error. The dialplan will continue execution if the\n"
+"the calls cannot be placed, or if the timeout expires.\n"
 "  For the Privacy and Screening Modes, the DIALSTATUS variable will be set to DONTCALL, \n"
 "if the called party chooses to send the calling party to the 'Go Away' script, and \n"
 "the DIALSTATUS variable will be set to TORTURE, if the called party wants to send the caller to \n"
 "the TORTURE scripts\n"
-"  This application returns -1 if the originating channel hangs up, or if the\n"
-"call is bridged and either of the parties in the bridge terminate the call.\n"
+"  This application will report normal termination if the originating channel hangs up, or if the\n"
+"call is bridged and either of the parties in the bridge ends the call.\n"
 "The option string may contain zero or more of the following characters:\n"
 "	'A(x)' -- play an announcement to the called party, using x as file\n"
 "	'C' -- reset call detail record for this call.\n"

Index: app_directory.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_directory.c,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -d -r1.50 -r1.51
--- app_directory.c	6 Nov 2005 15:09:46 -0000	1.50
+++ app_directory.c	7 Nov 2005 22:01:21 -0000	1.51
@@ -49,14 +49,13 @@
 static char *descrip =
 "  Directory(vm-context[|dial-context[|options]]): Presents the user with a directory\n"
 "of extensions from which they  may  select  by name. The  list  of  names \n"
-"and  extensions  is discovered from  voicemail.conf. The  vm-context  argument\n"
+"and  extensions are retrieved from  voicemail.conf. The  vm-context  argument\n"
 "is required, and specifies  the  context  of voicemail.conf to use.  The\n"
 "dial-context is the context to use for dialing the users, and defaults to\n"
 "the vm-context if unspecified. The 'f' option causes the directory to match\n"
 "based on the first name in voicemail.conf instead of the last name.\n"
-"Returns 0 unless the user hangs up. It  also sets up the channel on exit\n"
-"to enter the extension the user selected.  If the user enters '0' and there\n"
-"exists an extension 'o' in the current context, the directory will exit with 0\n"
+"The query should yield a contact unless the caller disconnects.\n"
+"It  also sets up the channel on exit to enter the extension the user selected.\n"  "If the user enters '0' and there exists an extension 'o' in the current \n"" context, the directory will contact the extension associated with 'o'\n"
 "and call control will resume at that extension.  Entering '*' will exit similarly,\n"
 "but to the 'a' extension, much like app_voicemail's behavior.\n";
 

Index: app_disa.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_disa.c,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -d -r1.43 -r1.44
--- app_disa.c	7 Nov 2005 04:10:41 -0000	1.43
+++ app_disa.c	7 Nov 2005 22:01:21 -0000	1.44
@@ -95,7 +95,6 @@
 	"If the user enters an invalid extension and extension \"i\" (invalid) \n"
 	"exists in the context, it will be used.\n";
 
-
 STANDARD_LOCAL_USER;
 
 LOCAL_USER_DECL;

Index: app_dumpchan.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_dumpchan.c,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- app_dumpchan.c	6 Nov 2005 15:09:46 -0000	1.15
+++ app_dumpchan.c	7 Nov 2005 22:01:21 -0000	1.16
@@ -51,7 +51,7 @@
 "Displays information on channel and listing of all channel\n"
 "variables. If min_verbose_level is specified, output is only\n"
 "displayed when the verbose level is currently set to that number\n"
-"or greater. Always returns 0.\n\n";
+"or greater. \n";
 
 STANDARD_LOCAL_USER;
 

Index: app_echo.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_echo.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- app_echo.c	6 Nov 2005 15:09:46 -0000	1.16
+++ app_echo.c	7 Nov 2005 22:01:21 -0000	1.17
@@ -45,8 +45,9 @@
 static char *synopsis = "Echo audio read back to the user";
 
 static char *descrip = 
-"  Echo():  Echo audio read from channel back to the channel. Returns 0\n"
-"if the user exits with the '#' key, or -1 if the user hangs up.\n";
+"  Echo():  Echo audio read from channel back to the channel. \n"
+"User can exit the application by either pressing the '#' key, \n"
+"or hanging up.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_enumlookup.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_enumlookup.c,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -d -r1.27 -r1.28
--- app_enumlookup.c	6 Nov 2005 18:36:37 -0000	1.27
+++ app_enumlookup.c	7 Nov 2005 22:01:21 -0000	1.28
@@ -55,7 +55,6 @@
 "  EnumLookup(exten[|option]):  Looks up an extension via ENUM and sets\n"
 "the variable 'ENUM'. For VoIP URIs this variable will \n"
 "look like 'TECHNOLOGY/URI' with the appropriate technology.\n"
-"Returns -1 on hangup, or 0 on completion\n"
 "Currently, the enumservices SIP, H323, IAX, IAX2 and TEL are recognized. \n"
 "\nReturns status in the ENUMSTATUS channel variable:\n"
 "    ERROR	Failed to do a lookup\n"

Index: app_flash.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_flash.c,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- app_flash.c	6 Nov 2005 15:09:46 -0000	1.10
+++ app_flash.c	7 Nov 2005 22:01:21 -0000	1.11
@@ -56,8 +56,7 @@
 static char *descrip = 
 "  Flash(): Sends a flash on a zap trunk.  This is only a hack for\n"
 "people who want to perform transfers and such via AGI and is generally\n"
-"quite useless otherwise.  Returns 0 on success or -1 if this is not\n"
-"a zap trunk\n";
+"quite useless oths application will only work on Zap trunks.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_getcpeid.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_getcpeid.c,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- app_getcpeid.c	6 Nov 2005 15:09:46 -0000	1.12
+++ app_getcpeid.c	7 Nov 2005 22:01:21 -0000	1.13
@@ -48,8 +48,7 @@
 
 static char *descrip =
 "  GetCPEID: Obtains and displays ADSI CPE ID and other information in order\n"
-"to properly setup zapata.conf for on-hook operations.\n"
-"Returns -1 on hangup only.\n";
+"to properly setup zapata.conf for on-hook operations.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_groupcount.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_groupcount.c,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -d -r1.27 -r1.28
--- app_groupcount.c	6 Nov 2005 18:42:39 -0000	1.27
+++ app_groupcount.c	7 Nov 2005 22:01:21 -0000	1.28
@@ -256,7 +256,7 @@
 "Usage: GetGroupCount([groupname][@category])\n"
 "  Calculates the group count for the specified group, or uses\n"
 "the current channel's group if not specifed (and non-empty).\n"
-"Stores result in GROUPCOUNT.  Always returns 0.\n"
+"Stores result in GROUPCOUNT. \n"
 "This application has been deprecated, please use the function\n"
 "GroupCount.\n";
 

Index: app_ices.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_ices.c,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- app_ices.c	6 Nov 2005 15:09:46 -0000	1.13
+++ app_ices.c	7 Nov 2005 22:01:21 -0000	1.14
@@ -57,8 +57,7 @@
 static char *descrip = 
 "  ICES(config.xml) Streams to an icecast server using ices\n"
 "(available separately).  A configuration file must be supplied\n"
-"for ices (see examples/asterisk-ices.conf).  Returns  -1  on\n"
-"hangup or 0 otherwise.\n";
+"for ices (see examples/asterisk-ices.conf). \n";
 
 STANDARD_LOCAL_USER;
 

Index: app_image.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_image.c,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- app_image.c	6 Nov 2005 19:19:59 -0000	1.14
+++ app_image.c	7 Nov 2005 22:01:21 -0000	1.15
@@ -49,12 +49,13 @@
 
 static char *descrip = 
 "  SendImage(filename): Sends an image on a channel. \n"
-"SendImage only  returns  0 if  the  image was sent correctly or if\n"
-"the channel does not support image transport, and -1 otherwise.\n"
-"The option string may contain zero or the following character:\n"
+"If the channel supports image transport but the image send\n"
+"fails, the channel will be hung up. Otherwise, the dialplan\n"
+"continues execution.\n"
+"The option string may contain the following character:\n"
 "	'j' -- jump to priority n+101 if the channel doesn't support image transport\n"
 "This application sets the following channel variable upon completion:\n"
-"	SENDIMAGESTATUS		The status is the attempt to send an image as a text string, one of\n"
+"	SENDIMAGESTATUS		The status is the result of the attempt as a text string, one of\n"
 "		OK | NOSUPPORT \n";			
 
 STANDARD_LOCAL_USER;

Index: app_intercom.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_intercom.c,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -d -r1.27 -r1.28
--- app_intercom.c	6 Nov 2005 15:09:46 -0000	1.27
+++ app_intercom.c	7 Nov 2005 22:01:21 -0000	1.28
@@ -68,8 +68,7 @@
 static char *synopsis = "(Obsolete) Send to Intercom";
 static char *descrip = 
 "  Intercom(): Sends the user to the intercom (i.e. /dev/dsp).  This program\n"
-"is generally considered  obselete by the chan_oss module.  Returns 0 if the\n"
-"user exits with a DTMF tone, or -1 if they hangup.\n";
+"is generally considered  obselete by the chan_oss module.  User can terminate\n"with a DTMF tone, or by hangup.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_lookupblacklist.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_lookupblacklist.c,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- app_lookupblacklist.c	6 Nov 2005 19:44:39 -0000	1.15
+++ app_lookupblacklist.c	7 Nov 2005 22:01:21 -0000	1.16
@@ -53,14 +53,12 @@
 static char *descrip =
   "  LookupBlacklist(options): Looks up the Caller*ID number on the active\n"
   "channel in the Asterisk database (family 'blacklist').  \n"
-  "Returns 0.  Does nothing if no Caller*ID was received on the\n"
-  "channel.\n"
-  "The option string may contain zero or the following character:\n"
+  "The option string may contain the following character:\n"
   "	'j' -- jump to n+101 priority if the number/name is found in the blacklist\n"
   "This application sets the following channel variable upon completion:\n"
   "	LOOKUPBLSTATUS		The status of the Blacklist lookup as a text string, one of\n"
   "		FOUND | NOTFOUND\n"
-  "Example: database put blacklist <name/number> 1\n";
+  "Example: exten => 1234,1,LookupBlacklist()\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_lookupcidname.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_lookupcidname.c,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- app_lookupcidname.c	6 Nov 2005 15:09:46 -0000	1.12
+++ app_lookupcidname.c	7 Nov 2005 22:01:22 -0000	1.13
@@ -54,7 +54,7 @@
   "Caller*ID name.  Does nothing if no Caller*ID was received on the\n"
   "channel.  This is useful if you do not subscribe to Caller*ID\n"
   "name delivery, or if you want to change the names on some incoming\n"
-  "calls.  Always returns 0.\n";
+  "calls.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_macro.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_macro.c,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -d -r1.33 -r1.34
--- app_macro.c	6 Nov 2005 15:09:46 -0000	1.33
+++ app_macro.c	7 Nov 2005 22:01:22 -0000	1.34
@@ -58,7 +58,6 @@
 "${ARG1}, ${ARG2}, etc in the macro context.\n"
 "If you Goto out of the Macro context, the Macro will terminate and control\n"
 "will be returned at the location of the Goto.\n"
-"Macro returns -1 if any step in the macro returns -1, and 0 otherwise.\n" 
 "If ${MACRO_OFFSET} is set at termination, Macro will attempt to continue\n"
 "at priority MACRO_OFFSET + N + 1 if such a step exists, and N + 1 otherwise.\n";
 

Index: app_math.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_math.c,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -d -r1.18 -r1.19
--- app_math.c	6 Nov 2005 15:09:46 -0000	1.18
+++ app_math.c	7 Nov 2005 22:01:22 -0000	1.19
@@ -69,7 +69,7 @@
 "Perform floating point calculation on number 1 to number 2 and \n"
 "store the result in returnvar.  Valid ops are: \n"
 "    +,-,/,*,%,<,>,>=,<=,==\n"
-"and behave as their C equivalents.  Always returns 0.\n";
+"and behave as their C equivalents.\n";
 
 #define ADDFUNCTION 0
 #define DIVIDEFUNCTION 1

Index: app_md5.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_md5.c,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- app_md5.c	6 Nov 2005 22:02:18 -0000	1.14
+++ app_md5.c	7 Nov 2005 22:01:22 -0000	1.15
@@ -46,7 +46,7 @@
 static char *desc_md5 = "Calculate MD5 checksum";
 static char *synopsis_md5 = 
 "  MD5(<var>=<string>): Calculates a MD5 checksum on <string>.\n"
-"Returns hash value in a channel variable. Always return 0\n";
+"Returns hash value in a channel variable. \n";
 
 static char *app_md5check = "MD5Check";
 static char *desc_md5check = "Check MD5 checksum";

Index: app_meetme.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_meetme.c,v
retrieving revision 1.121
retrieving revision 1.122
diff -u -d -r1.121 -r1.122
--- app_meetme.c	6 Nov 2005 15:09:46 -0000	1.121
+++ app_meetme.c	7 Nov 2005 22:01:22 -0000	1.122
@@ -69,7 +69,7 @@
 "  MeetMe([confno][,[options][,pin]]): Enters the user into a specified MeetMe conference.\n"
 "If the conference number is omitted, the user will be prompted to enter\n"
 "one. \n"
-"MeetMe returns 0 if user pressed # to exit (see option 'p'), otherwise -1.\n"
+"User can exit the conference by hangup, or if the 'p' option is specified, by pressing '#'.\n"
 "Please note: A ZAPTEL INTERFACE MUST BE INSTALLED FOR CONFERENCING TO WORK!\n\n"
 
 "The option string may contain zero or more of the following characters:\n"
@@ -103,9 +103,10 @@
 "             if that variable is not defined.\n";
 
 static char *descrip2 =
-"  MeetMeCount(confno[|var]): Plays back the number of users in the specifiedi\n"
+"  MeetMeCount(confno[|var]): Plays back the number of users in the specified\n"
 "MeetMe conference. If var is specified, playback will be skipped and the value\n"
-"will be returned in the variable. Returns 0 on success or -1 on a hangup.\n"
+"will be returned in the variable. Upon app completion, MeetMeCount will hangup the\n"
+"channel, unless priority n+1 exists, in which case priority progress will continue.\n"
 "A ZAPTEL INTERFACE MUST BE INSTALLED FOR CONFERENCING FUNCTIONALITY.\n";
 
 static char *descrip3 = 

Index: app_mp3.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_mp3.c,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -d -r1.32 -r1.33
--- app_mp3.c	6 Nov 2005 15:09:46 -0000	1.32
+++ app_mp3.c	7 Nov 2005 22:01:22 -0000	1.33
@@ -54,9 +54,9 @@
 static char *synopsis = "Play an MP3 file or stream";
 
 static char *descrip = 
-"  MP3Player(location) Executes mpg123 to play the given location\n"
-"which typically would be a filename o a URL. User can exit by pressing any key\n."
-"Returns  -1  on hangup or 0 otherwise."; 
+"  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."; 
 
 STANDARD_LOCAL_USER;
 

Index: app_nbscat.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_nbscat.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- app_nbscat.c	6 Nov 2005 15:09:46 -0000	1.16
+++ app_nbscat.c	7 Nov 2005 22:01:22 -0000	1.17
@@ -60,8 +60,7 @@
 
 static char *descrip = 
 "  NBScat: Executes nbscat to listen to the local NBS stream.\n"
-"Returns  -1  on\n hangup or 0 otherwise. User can exit by \n"
-"pressing any key\n.";
+"User can exit by pressing any key\n.";
 
 STANDARD_LOCAL_USER;
 

Index: app_page.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_page.c,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- app_page.c	6 Nov 2005 15:09:46 -0000	1.11
+++ app_page.c	7 Nov 2005 22:01:22 -0000	1.12
@@ -54,9 +54,8 @@
 "them into a conference bridge as muted participants.  The original\n"
 "caller is dumped into the conference as a speaker and the room is\n"
 "destroyed when the original caller leaves.  Valid options are:\n"
-"	d - full duplex audio\n"
-"	q - quiet, do not play beep to caller\n"
-"Always returns -1.\n";
+"        d - full duplex audio\n"
+"	 q - quiet, do not play beep to caller\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_playback.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_playback.c,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -d -r1.25 -r1.26
--- app_playback.c	6 Nov 2005 15:09:46 -0000	1.25
+++ app_playback.c	7 Nov 2005 22:01:22 -0000	1.26
@@ -51,10 +51,9 @@
 "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 channel will\n"
+"off hook.  Otherwise, unless 'noanswer' is specified, the channel will\n"
 "be answered before the sound is played. Not all channels support playing\n"
-"messages while still hook. Returns -1 if the channel was hung up.  If the\n"
-"file does not exist, will jump to priority n+101 if present.\n";
+"messages while still hook. If the file does not exist, will jump to priority n+101 if present.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_privacy.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_privacy.c,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- app_privacy.c	6 Nov 2005 15:09:46 -0000	1.21
+++ app_privacy.c	7 Nov 2005 22:01:22 -0000	1.22
@@ -59,7 +59,7 @@
   "at least a 10 digit phone number, and if there exists a priority n + 101,\n"
   "where 'n' is the priority of the current instance, then  the\n"
   "channel  will  be  setup  to continue at that priority level.\n"
-  "Otherwise, it returns 0.  Does nothing if Caller*ID was received on the\n"
+  "Otherwise, the call is hungup.  Does nothing if Caller*ID was received on the\n"
   "channel.\n"
   "  Configuration file privacy.conf contains two variables:\n"
   "   maxretries  default 3  -maximum number of attempts the caller is allowed to input a callerid.\n"

Index: app_queue.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_queue.c,v
retrieving revision 1.176
retrieving revision 1.177
diff -u -d -r1.176 -r1.177
--- app_queue.c	6 Nov 2005 15:09:46 -0000	1.176
+++ app_queue.c	7 Nov 2005 22:01:22 -0000	1.177
@@ -125,9 +125,8 @@
 static char *descrip =
 "  Queue(queuename[|options[|URL][|announceoverride][|timeout]]):\n"
 "Queues an incoming call in a particular call queue as defined in queues.conf.\n"
-"  This application returns -1 if the originating channel hangs up, or if the\n"
-"call is bridged and  either of the parties in the bridge terminate the call.\n"
-"Returns 0 if the queue is full, nonexistent, or has no members.\n"
+"This application will return to the dialplan if the queue does not exist, or\n"
+"any of the join options cause the caller to not enter the queue.\n"
 "The option string may contain zero or more of the following characters:\n"
 "      'd' -- data-quality (modem) call (minimum delay).\n"
 "      'h' -- allow callee to hang up by hitting *.\n"
@@ -156,7 +155,6 @@
 "Dynamically adds interface to an existing queue.\n"
 "If the interface is already in the queue and there exists an n+101 priority\n"
 "then it will then jump to this priority.  Otherwise it will return an error\n"
-"Returns -1 if there is an error.\n"
 "Example: AddQueueMember(techsupport|SIP/3000)\n"
 "";
 
@@ -167,7 +165,6 @@
 "Dynamically removes interface to an existing queue\n"
 "If the interface is NOT in the queue and there exists an n+101 priority\n"
 "then it will then jump to this priority.  Otherwise it will return an error\n"
-"Returns -1 if there is an error.\n"
 "Example: RemoveQueueMember(techsupport|SIP/3000)\n"
 "";
 
@@ -182,8 +179,8 @@
 "queuename is given, the interface is paused in every queue it is a\n"
 "member of.  If the interface is not in the named queue, or if no queue\n"
 "is given and the interface is not in any queue, it will jump to\n"
-" priority n+101, if it exists.  Returns -1 if the interface is not\n"
-"found and no extension to jump to exists, 0 otherwise.\n"
+" priority n+101, if it exists.  The application will fail if the interface is not\n"
+"found and no extension to jump to exists.\n"
 "Example: PauseQueueMember(|SIP/3000)\n";
 
 static char *app_upqm = "UnpauseQueueMember" ;

Index: app_read.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_read.c,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -d -r1.28 -r1.29
--- app_read.c	6 Nov 2005 15:09:46 -0000	1.28
+++ app_read.c	7 Nov 2005 22:01:22 -0000	1.29
@@ -62,7 +62,7 @@
 "  attempts   -- if greater than 1, that many attempts will be made in the \n"
 "                event no data is entered.\n"
 "  timeout    -- if greater than 0, that value will override the default timeout.\n\n"
-"Returns -1 on hangup or error and 0 otherwise.\n";
+"Read should disconnect if the function fails or errors out.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_record.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_record.c,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -d -r1.44 -r1.45
--- app_record.c	6 Nov 2005 15:09:46 -0000	1.44
+++ app_record.c	7 Nov 2005 22:01:22 -0000	1.45
@@ -66,7 +66,8 @@
 "incremented by one each time the file is recorded. \n\n"
 "Use 'show file formats' to see the available formats on your system\n\n"
 "User can press '#' to terminate the recording and continue to the next priority.\n\n"
-"Returns -1 when the user hangs up.\n";
+"If the user should hangup during a recording, all data will be lost and the\n"
+"application will teminate. \n";
 
 STANDARD_LOCAL_USER;
 

Index: app_sayunixtime.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_sayunixtime.c,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- app_sayunixtime.c	6 Nov 2005 15:09:46 -0000	1.15
+++ app_sayunixtime.c	7 Nov 2005 22:01:22 -0000	1.16
@@ -54,8 +54,7 @@
 "  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"
-"              defaults to \"ABdY 'digits/at' IMp\"\n"
-"  Returns 0 or -1 on hangup.\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"
@@ -63,8 +62,7 @@
 "  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"
-"              defaults to \"ABdY 'digits/at' IMp\"\n"
-"  Returns 0 or -1 on hangup.\n";
+"              defaults to \"ABdY 'digits/at' IMp\"\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_senddtmf.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_senddtmf.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- app_senddtmf.c	6 Nov 2005 15:09:46 -0000	1.16
+++ app_senddtmf.c	7 Nov 2005 22:01:22 -0000	1.17
@@ -48,9 +48,10 @@
 static char *synopsis = "Sends arbitrary DTMF digits";
 
 static char *descrip = 
-"  SendDTMF(digits[|timeout_ms]): Sends DTMF digits on a channel. \n"
-"  Accepted digits: 0-9, *#abcd\n"
-" Returns 0 on success or -1 on a hangup.\n";
+" SendDTMF(digits[|timeout_ms]): Sends DTMF digits on a channel. \n"
+" Accepted digits: 0-9, *#abcd\n"
+" The application will either pass the assigned digits or terminate if it\n"
+" encounters an error.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_sendtext.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_sendtext.c,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- app_sendtext.c	6 Nov 2005 15:09:46 -0000	1.14
+++ app_sendtext.c	7 Nov 2005 22:01:22 -0000	1.15
@@ -59,8 +59,7 @@
 "\n"
 "At this moment, text is supposed to be 7 bit ASCII in most channels.\n"
 "Old deprecated behavior: \n"
-" SendText only returns 0 if the text was sent correctly or if\n"
-" the channel does not support text transport.\n"
+" SendText should continue with the next priority upon successful execution.\n"
 " If the client does not support text transport, and there exists a\n"
 " step with priority n + 101, then execution will continue at that step.\n";
 

Index: app_setcallerid.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setcallerid.c,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- app_setcallerid.c	6 Nov 2005 15:09:46 -0000	1.15
+++ app_setcallerid.c	7 Nov 2005 22:01:22 -0000	1.16
@@ -50,7 +50,7 @@
 
 static char *descrip2 = 
 "  SetCallerPres(presentation): Set Caller*ID presentation on a call.\n"
-"  Always returns 0.  Valid presentations are:\n"
+"  Valid presentations are:\n"
 "\n"
 "      allowed_not_screened    : Presentation Allowed, Not Screened\n"
 "      allowed_passed_screen   : Presentation Allowed, Passed Screen\n" 
@@ -95,7 +95,7 @@
 
 static char *descrip = 
 "  SetCallerID(clid[|a]): Set Caller*ID on a call to a new\n"
-"value.  Sets ANI as well if a flag is used.  Always returns 0\n";
+"value.  Sets ANI as well if a flag is used. \n";
 
 static int setcallerid_exec(struct ast_channel *chan, void *data)
 {

Index: app_setcdruserfield.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setcdruserfield.c,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- app_setcdruserfield.c	6 Nov 2005 15:09:46 -0000	1.13
+++ app_setcdruserfield.c	7 Nov 2005 22:01:22 -0000	1.14
@@ -52,8 +52,7 @@
                "       can use for data not stored anywhere else in the record.\n"
                "       CDR records can be used for billing or storing other arbitrary data\n"
                "       (I.E. telephone survey responses)\n"
-               "       Also see AppendCDRUserField().\n"
-               "       Always returns 0\n";
+               "       Also see AppendCDRUserField().\n";
 
 		
 static char *setcdruserfield_app = "SetCDRUserField";
@@ -68,8 +67,7 @@
                "       can use for data not stored anywhere else in the record.\n"
                "       CDR records can be used for billing or storing other arbitrary data\n"
                "       (I.E. telephone survey responses)\n"
-               "       Also see SetCDRUserField().\n"
-               "       Always returns 0\n";
+               "       Also see SetCDRUserField().\n";
 		
 static char *appendcdruserfield_app = "AppendCDRUserField";
 static char *appendcdruserfield_synopsis = "Append to the CDR user field";

Index: app_setcidname.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setcidname.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- app_setcidname.c	6 Nov 2005 15:09:46 -0000	1.16
+++ app_setcidname.c	7 Nov 2005 22:01:22 -0000	1.17
@@ -51,7 +51,7 @@
 "  SetCIDName(cname[|a]): Set Caller*ID Name on a call to a new\n"
 "value, while preserving the original Caller*ID number.  This is\n"
 "useful for providing additional information to the called\n"
-"party. Always returns 0\n"
+"party. \n"
 "SetCIDName has been deprecated in favor of the function\n"
 "CALLERID(name)\n";
 

Index: app_setcidnum.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setcidnum.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- app_setcidnum.c	6 Nov 2005 15:09:46 -0000	1.16
+++ app_setcidnum.c	7 Nov 2005 22:01:22 -0000	1.17
@@ -52,7 +52,7 @@
 "  SetCIDNum(cnum[|a]): Set Caller*ID Number on a call to a new\n"
 "value, while preserving the original Caller*ID name.  This is\n"
 "useful for providing additional information to the called\n"
-"party. Sets ANI as well if a flag is used.  Always returns 0\n"
+"party. Sets ANI as well if a flag is used.\n"
 "SetCIDNum has been deprecated in favor of the function\n"
 "CALLERID(number)\n";
 

Index: app_setrdnis.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_setrdnis.c,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- app_setrdnis.c	6 Nov 2005 15:09:46 -0000	1.11
+++ app_setrdnis.c	7 Nov 2005 22:01:22 -0000	1.12
@@ -50,7 +50,7 @@
 
 static char *descrip = 
 "  SetRDNIS(cnum): Set RDNIS Number on a call to a new\n"
-"value.  Always returns 0\n"
+"value.\n"
 "SetRDNIS has been deprecated in favor of the function\n"
 "CALLERID(rdnis)\n";
 

Index: app_settransfercapability.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_settransfercapability.c,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- app_settransfercapability.c	6 Nov 2005 15:09:46 -0000	1.11
+++ app_settransfercapability.c	7 Nov 2005 22:01:22 -0000	1.12
@@ -58,7 +58,7 @@
 static char *descrip = 
 "  SetTransferCapability(transfercapability): Set the ISDN Transfer \n"
 "Capability of a call to a new value.\n"
-"Always returns 0.  Valid Transfer Capabilities are:\n"
+"Valid Transfer Capabilities are:\n"
 "\n"
 "  SPEECH             : 0x00 - Speech (default, voice calls)\n"
 "  DIGITAL            : 0x08 - Unrestricted digital information (data calls)\n"

Index: app_sms.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_sms.c,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -d -r1.31 -r1.32
--- app_sms.c	6 Nov 2005 15:09:46 -0000	1.31
+++ app_sms.c	7 Nov 2005 22:01:22 -0000	1.32
@@ -67,8 +67,7 @@
 
 static char *descrip =
 	"  SMS(name|[a][s]):  SMS handles exchange of SMS data with a call to/from SMS capabale\n"
-	"phone or SMS PSTN service centre. Can send and/or receive SMS messages.\n"
-	"Returns 0 if call handled correctly, or -1 if there were any problems.\n"
+	"phone or SMS PSTN service center. Can send and/or receive SMS messages.\n"
 	"Works to ETSI ES 201 912 compatible with BT SMS PSTN service in UK\n"
 	"Typical usage is to use to handle called from the SMS service centre CLI,\n"
 	"or to set up a call using 'outgoing' or manager interface to connect\n"

Index: app_softhangup.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_softhangup.c,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- app_softhangup.c	6 Nov 2005 15:09:46 -0000	1.14
+++ app_softhangup.c	7 Nov 2005 22:01:22 -0000	1.15
@@ -44,7 +44,8 @@
 static char *tdesc = "Hangs up the requested channel";
 
 static char *desc = "  SoftHangup(Technology/resource|options)\n"
-"Hangs up the requested channel.  Always returns 0\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";
 

Index: app_striplsd.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_striplsd.c,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- app_striplsd.c	6 Nov 2005 15:09:46 -0000	1.11
+++ app_striplsd.c	7 Nov 2005 22:01:22 -0000	1.12
@@ -44,8 +44,7 @@
 static char *descrip =
 "  StripLSD(count): Strips the trailing  'count'  digits  from  the  channel's\n"
 "associated extension. For example, the  number  5551212 when stripped with a\n"
-"count of 4 would be changed to 555.  This app always returns 0, and the PBX\n"
-"will continue processing at the next priority for the *new* extension.\n"
+"count of 4 would be changed to 555.  The PBX will continue processing at the\n""next priority for the *new* extension.\n"
 "  So, for  example, if  priority 3 of 5551212  is  StripLSD 4, the next step\n"
 "executed will be priority 4 of 555.  If you switch into an  extension which\n"
 "has no first step, the PBX will treat it as though the user dialed an\n"

Index: app_system.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_system.c,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -d -r1.23 -r1.24
--- app_system.c	6 Nov 2005 15:09:46 -0000	1.23
+++ app_system.c	7 Nov 2005 22:01:22 -0000	1.24
@@ -55,8 +55,8 @@
 static char *chanvar = "SYSTEMSTATUS";
 
 static char *descrip =
-"  System(command): Executes a command  by  using  system(). Returns -1 on\n"
-"failure to execute the specified command. \n"
+"  System(command): Executes a command  by  using  system(). If the command\n"
+"fails, the console should report a fallthrough. \n"
 "Result of execution is returned in the SYSTEMSTATUS channel variable:\n"
 "   FAILURE	Could not execute the specified command\n"
 "   SUCCESS	Specified command successfully executed\n"
@@ -66,11 +66,10 @@
 "a priority n + 101, where 'n' is the priority of the current instance,\n"
 "then  the  channel  will  be  setup to continue at that priority level.\n"
 "Note that this jump functionality has been deprecated and will only occur\n"
-"if the global priority jumping option is enabled in extensions.conf.\n"
-" Otherwise, System returns 0.\n";
+"if the global priority jumping option is enabled in extensions.conf.\n";
 
 static char *descrip2 =
-"  TrySystem(command): Executes a command  by  using  system(). Returns 0\n"
+"  TrySystem(command): Executes a command  by  using  system().\n"
 "on any situation.\n"
 "Result of execution is returned in the SYSTEMSTATUS channel variable:\n"
 "   FAILURE	Could not execute the specified command\n"
@@ -80,7 +79,7 @@
 "Old behaviour:\nIf  the command itself executes but is in error, and if\n"
 "there exists a priority n + 101, where 'n' is the priority of the current\n"
 "instance, then  the  channel  will  be  setup  to continue at that\n"
-"priority level.  Otherwise, System returns 0.\n";
+"priority level.  Otherwise, System will terminate.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_talkdetect.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_talkdetect.c,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -d -r1.18 -r1.19
--- app_talkdetect.c	6 Nov 2005 15:09:46 -0000	1.18
+++ app_talkdetect.c	7 Nov 2005 22:01:22 -0000	1.19
@@ -55,8 +55,7 @@
 "yet less than 'max' ms is followed by silence for at least 'sil' ms then\n"
 "the audio playback is aborted and processing jumps to the 'talk' extension\n"
 "if available.  If unspecified, sil, min, and max default to 1000, 100, and\n"
-"infinity respectively.  Returns -1 on hangup, and 0 on successful playback\n"
-"completion with no exit conditions.\n";
+"infinity respectively.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_verbose.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_verbose.c,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- app_verbose.c	6 Nov 2005 15:09:46 -0000	1.10
+++ app_verbose.c	7 Nov 2005 22:01:22 -0000	1.11
@@ -46,8 +46,7 @@
 
 static char *verbose_descrip =
 "Verbose([<level>|]<message>)\n"
-"  level must be an integer value.  If not specified, defaults to 0."
-"  Always returns 0.\n";
+"  level must be an integer value.  If not specified, defaults to 0.\n";
 
 STANDARD_LOCAL_USER;
 

Index: app_voicemail.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_voicemail.c,v
retrieving revision 1.262
retrieving revision 1.263
diff -u -d -r1.262 -r1.263
--- app_voicemail.c	6 Nov 2005 15:09:46 -0000	1.262
+++ app_voicemail.c	7 Nov 2005 22:01:22 -0000	1.263
@@ -308,8 +308,7 @@
 "and there exists a priority n + 101, then that priority will be taken next.\n"
 "When multiple mailboxes are specified, the unavailable or busy message\n"
 "will be taken from the first mailbox specified.\n"
-"Returns -1 on error or mailbox not found, or if the user hangs up.\n"
-"Otherwise, it returns 0.\n";
+"Execution will fail if the mailbox does not exist, or if the user disconnects.\n";
 
 static char *synopsis_vmain =
 "Enter voicemail system";

Index: app_zapateller.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_zapateller.c,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- app_zapateller.c	6 Nov 2005 15:09:46 -0000	1.15
+++ app_zapateller.c	7 Nov 2005 22:01:22 -0000	1.16
@@ -46,10 +46,10 @@
 
 static char *descrip = 
 "  Zapateller(options):  Generates special information tone to block\n"
-"telemarketers from calling you.  Returns 0 normally or -1 on hangup.\n"
-"Options is a pipe-delimited list of options.  The following options\n"
-"are available: 'answer' causes the line to be answered before playing\n"
-"the tone, 'nocallerid' causes Zapateller to only play the tone if there\n"
+"telemarketers from calling you.  Options is a pipe-delimited list of\n" 
+"options.  The following options are available:\n"
+"'answer' causes the line to be answered before playing the tone,\n" 
+"'nocallerid' causes Zapateller to only play the tone if there\n"
 "is no callerid information available.  Options should be separated by |\n"
 "characters\n";
 

Index: app_zapras.c
===================================================================
RCS file: /usr/cvsroot/asterisk/apps/app_zapras.c,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -d -r1.17 -r1.18
--- app_zapras.c	6 Nov 2005 15:09:46 -0000	1.17
+++ app_zapras.c	7 Nov 2005 22:01:22 -0000	1.18
@@ -69,7 +69,7 @@
 "The channel must be a clear channel (i.e. PRI source) and a Zaptel\n"
 "channel to be able to use this function (No modem emulation is included).\n"
 "Your pppd must be patched to be zaptel aware. Arguments should be\n"
-"separated by | characters.  Always returns -1.\n";
+"separated by | characters.\n";
 
 STANDARD_LOCAL_USER;
 




More information about the svn-commits mailing list