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

diff --git a/apps/app_hasnewvoicemail.c b/apps/app_hasnewvoicemail.c
index 33204bbe9ce7cbd34ecd949eb333d9a625c55af5..17e2838edb72df3f00109a13f5b938db014d2a6c 100644 (file)
--- a/apps/app_hasnewvoicemail.c
+++ b/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)

diff --git a/apps/app_setcdruserfield.c b/apps/app_setcdruserfield.c
index d6a4f2b06e0284564b02fcbba280bddad116b8c1..ccfbcedd2d2bde78265a66af354a508e7aef69bc 100644 (file)
--- a/apps/app_setcdruserfield.c
+++ b/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";

diff --git a/apps/app_settransfercapability.c b/apps/app_settransfercapability.c
index ff67a42820ce711405dd9b6af68018e126c41592..e29b44e2277f818b6681bd1ea9cb28704e91f58b 100644 (file)
--- a/apps/app_settransfercapability.c
+++ b/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)

diff --git a/main/pbx.c b/main/pbx.c
index 0bdd29baa05fe3e74eacb87355a5d2fb8e0afed2..0bc6ac584dbb40ce2cb799f242e14691a91f2cae 100644 (file)
--- a/main/pbx.c
+++ b/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,