From 2c52c79e107224755c484b2b7571419f62485f57 Mon Sep 17 00:00:00 2001
From: Russell Bryant <russell@russellbryant.com>
Date: Thu, 1 May 2008 17:28:25 +0000
Subject: [PATCH] Clarify the deprecation notice about Macro() to note that it
 will not be removed for the sake of backwards compatibility, since it is a
 non-trivial task to convert existing large dialplans that depend on Macro()
 to use GoSub(), instead.

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@114931 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 UPGRADE.txt | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/UPGRADE.txt b/UPGRADE.txt
index 0bdbf6f3f8..b01ab9c1ce 100644
--- a/UPGRADE.txt
+++ b/UPGRADE.txt
@@ -92,7 +92,12 @@ Applications:
   Gosub()/Return() applications.  To replace MacroExclusive(), we have
   introduced dialplan functions LOCK(), TRYLOCK(), and UNLOCK().  You may use
   these functions in any location where you desire to ensure that only one
-  channel is executing that path at any one time.
+  channel is executing that path at any one time.  The Macro() applications
+  are deprecated for performance reasons.  However, since Macro() has been
+  around for a long time and so many dialplans depend heavily on it, it will
+  not be removed for the sake of backwards compatibility.  It is also worth
+  noting that using both Macro() and GoSub() at the same time is _heavily_
+  discouraged.
 * Read() now sets a READSTATUS variable on exit.  It does NOT automatically
   return -1 (and hangup) anymore on error.  If you want to hangup on error,
   you need to do so explicitly in your dialplan.
-- 
GitLab