Expand deprecation warnings from simply warning on use to the builtin documentation.

git-svn-id: https://origsvn.digium.com/svn/asterisk/branches/1.4@58939 65c4cc65-6c06-0410-ace0-fbb531ad65f3

apps/app_hasnewvoicemail.c

@@ -63,7 +63,8 @@ static char *hasvoicemail_descrip =
 "	'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 @@ static char *hasnewvoicemail_descrip =
 "	'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)

apps/app_setcdruserfield.c

@@ -52,7 +52,8 @@ static char *setcdruserfield_descrip =
                "       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 @@ static char *appendcdruserfield_descrip =
                "       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";

apps/app_settransfercapability.c

@@ -66,6 +66,7 @@ static char *descrip =
 "  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)

main/pbx.c

@@ -436,6 +436,7 @@ static struct pbx_builtin {
 	"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 @@ static struct pbx_builtin {
 	"  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,