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: http://svn.digium.com/svn/asterisk/trunk@114931 f38db490-d61c-443f-a65b-d21fe96a405b

1 files changed, 6 insertions, 1 deletions

diff --git a/UPGRADE.txt b/UPGRADE.txt
index 0bdbf6f3f..b01ab9c1c 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.