[asterisk-commits] tilghman: branch 1.4 r58939 - in /branches/1.4: apps/ main/

[asterisk-commits at lists.digium.com]

Author: tilghman
Date: Thu Mar 15 18:11:33 2007
New Revision: 58939

URL: http://svn.digium.com/view/asterisk?view=rev&rev=58939
Log:
Expand deprecation warnings from simply warning on use to the builtin documentation.

Modified:
    branches/1.4/apps/app_hasnewvoicemail.c
    branches/1.4/apps/app_setcdruserfield.c
    branches/1.4/apps/app_settransfercapability.c
    branches/1.4/main/pbx.c

Modified: branches/1.4/apps/app_hasnewvoicemail.c
URL: http://svn.digium.com/view/asterisk/branches/1.4/apps/app_hasnewvoicemail.c?view=diff&rev=58939&r1=58938&r2=58939
==============================================================================
--- branches/1.4/apps/app_hasnewvoicemail.c (original)
+++ branches/1.4/apps/app_hasnewvoicemail.c Thu Mar 15 18:11:33 2007
@@ -63,7 +63,8 @@
 "	'j' -- jump to priority n+101, if there is voicemail in the folder indicated.\n"
 "  This application sets the following channel variable upon completion:\n"
 "	HASVMSTATUS		The result of the voicemail check returned as a text string as follows\n"
-"		<# of messages in the folder, 0 for NONE>\n";
+"		<# of messages in the folder, 0 for NONE>\n"
+"\nThis application has been deprecated in favor of the VMCOUNT() function\n";
 
 static char *app_hasnewvoicemail = "HasNewVoicemail";
 static char *hasnewvoicemail_synopsis = "Conditionally branches to priority + 101 with the right options set";
@@ -75,7 +76,8 @@
 "	'j' -- jump to priority n+101, if there is new voicemail in folder 'folder' or INBOX\n"
 "  This application sets the following channel variable upon completion:\n"
 "	HASVMSTATUS		The result of the new voicemail check returned as a text string as follows\n"
-"		<# of messages in the folder, 0 for NONE>\n";
+"		<# of messages in the folder, 0 for NONE>\n"
+"\nThis application has been deprecated in favor of the VMCOUNT() function\n";
 
 
 static int hasvoicemail_exec(struct ast_channel *chan, void *data)

Modified: branches/1.4/apps/app_setcdruserfield.c
URL: http://svn.digium.com/view/asterisk/branches/1.4/apps/app_setcdruserfield.c?view=diff&rev=58939&r1=58938&r2=58939
==============================================================================
--- branches/1.4/apps/app_setcdruserfield.c (original)
+++ branches/1.4/apps/app_setcdruserfield.c Thu Mar 15 18:11:33 2007
@@ -52,7 +52,8 @@
                "       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";
+               "       Also see AppendCDRUserField().\n"
+			   "\nThis application is deprecated in favor of Set(CDR(userfield)=...)\n";
 
 		
 static char *setcdruserfield_app = "SetCDRUserField";
@@ -67,7 +68,8 @@
                "       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";
+               "       Also see SetCDRUserField().\n"
+			   "\nThis application is deprecated in favor of Set(CDR(userfield)=...)\n";
 		
 static char *appendcdruserfield_app = "AppendCDRUserField";
 static char *appendcdruserfield_synopsis = "Append to the CDR user field";

Modified: branches/1.4/apps/app_settransfercapability.c
URL: http://svn.digium.com/view/asterisk/branches/1.4/apps/app_settransfercapability.c?view=diff&rev=58939&r1=58938&r2=58939
==============================================================================
--- branches/1.4/apps/app_settransfercapability.c (original)
+++ branches/1.4/apps/app_settransfercapability.c Thu Mar 15 18:11:33 2007
@@ -66,6 +66,7 @@
 "  DIGITAL_W_TONES    : 0x11 - Unrestricted digital information with tones/announcements\n"
 "  VIDEO              : 0x18 - Video\n"
 "\n"
+"This application is deprecated in favor of Set(CHANNEL(transfercapability)=...)\n"
 ;
 
 static int settransfercapability_exec(struct ast_channel *chan, void *data)

Modified: branches/1.4/main/pbx.c
URL: http://svn.digium.com/view/asterisk/branches/1.4/main/pbx.c?view=diff&rev=58939&r1=58938&r2=58939
==============================================================================
--- branches/1.4/main/pbx.c (original)
+++ branches/1.4/main/pbx.c Thu Mar 15 18:11:33 2007
@@ -436,6 +436,7 @@
 	"Set a global variable to a given value",
 	"  SetGlobalVar(variable=value): This application sets a given global variable to\n"
 	"the specified value.\n"
+	"\n\nThis application is deprecated in favor of Set(GLOBAL(var)=value)\n"
 	},
 
 	{ "Set", pbx_builtin_setvar,
@@ -450,6 +451,9 @@
 	"  Options:\n"
 	"    g - Set variable globally instead of on the channel\n"
 	"        (applies only to variables, not functions)\n"
+	"\n\nThe use of Set to set multiple variables at once and the g flag have both\n"
+	"been deprecated.  Please use multiple Set calls and the GLOBAL() dialplan\n"
+	"function instead.\n"
 	},
 
 	{ "ImportVar", pbx_builtin_importvar,