Merge "func_odbc: Add missing unlock's to acf_odbc_read."
[asterisk/asterisk.git] / UPGRADE-1.6.txt
index 8fb0a0f..4ae4401 100644 (file)
@@ -1,10 +1,20 @@
 =========================================================
+===
 === Information for upgrading from Asterisk 1.4 to 1.6
 ===
+=== These files document all the changes that MUST be taken
+=== into account when upgrading between the Asterisk
+=== versions listed below. These changes may require that
+=== you modify your configuration files, dialplan or (in
+=== some cases) source code if you have your own Asterisk
+=== modules or patches. These files also includes advance
+=== notice of any functionality that has been marked as
+=== 'deprecated' and may be removed in a future release,
+=== along with the suggested replacement functionality.
 ===
 === UPGRADE-1.2.txt -- Upgrade info for 1.0 to 1.2
 === UPGRADE-1.4.txt -- Upgrade info for 1.2 to 1.4
-=== UPGRADE.txt     -- Upgrade info for 1.4 to 1.6
+===
 =========================================================
 
 AEL:
@@ -29,7 +39,7 @@ Core:
   sound file installer in the Makefile).
 
 * The ast_expr2 stuff has been modified to handle floating-point numbers.
-  Numbers of the format D.D are now acceptable input for the expr parser, 
+  Numbers of the format D.D are now acceptable input for the expr parser,
   Where D is a string of base-10 digits. All math is now done in "long double",
   if it is available on your compiler/architecture. This was half-way between
   a bug-fix (because the MATH func returns fp by default), and an enhancement.
@@ -38,7 +48,7 @@ Core:
   of rounding/truncation, along with a set of common floating point operations,
   like sin, cos, tan, log, pow, etc. The ability to call external functions
   like CDR(), etc. was also added, without having to use the ${...} notation.
+
 * The delimiter passed to applications has been changed to the comma (','), as
   that is what people are used to using within extensions.conf.  If you are
   using realtime extensions, you will need to translate your existing dialplan
@@ -56,6 +66,17 @@ Core:
   arguments of AGI applications.  After converting to use the ',' delimiter,
   change this option to res_agi=1.6.
 
+* As a side effect of the application delimiter change, many places that used
+  to need quotes in order to get the proper meaning are no longer required.
+  You now only need to quote strings in configuration files if you literally
+  want quotation marks within a string.
+
+* Any applications run that contain the pipe symbol but not a comma symbol will
+  get a warning printed to the effect that the application delimiter has changed.
+  However, there are legitimate reasons why this might be useful in certain
+  situations, so this warning can be turned off with the dontwarn option in
+  asterisk.conf.
+
 * The logger.conf option 'rotatetimestamp' has been deprecated in favor of
   'rotatestrategy'.  This new option supports a 'rotate' strategy that more
   closely mimics the system logger in terms of file rotation.
@@ -169,7 +190,7 @@ Formats:
 Channel Drivers:
 
 * SIP: a small upgrade to support the "Record" button on the SNOM360,
-  which sends a sip INFO message with a "Record: on" or "Record: off" 
+  which sends a sip INFO message with a "Record: on" or "Record: off"
   header. If Asterisk is set up (via features.conf) to accept "One Touch Monitor"
   requests (by default, via '*1'), then the user-configured dialpad sequence
   is generated, and recording can be started and stopped via this button. The
@@ -183,11 +204,17 @@ Channel Drivers:
   now renamed to "counteronpeer".
 
 * SIP: The "username" option is now renamed to "defaultuser" to match "defaultip".
-  These are used only before registration to call a peer with the uri 
+  These are used only before registration to call a peer with the uri
        sip:defaultuser@defaultip
-  The "username" setting still work, but is deprecated and will not work in 
+  The "username" setting still work, but is deprecated and will not work in
   the next version of Asterisk.
 
+* SIP: The old "insecure" options, deprecated in 1.4, have been removed.
+  "insecure=very" should be changed to "insecure=port,invite"
+  "insecure=yes" should be changed to "insecure=port"
+  Be aware that some telephony providers show the invalid syntax in their
+  sample configurations.
+
 * chan_local.c: the comma delimiter inside the channel name has been changed to a
   semicolon, in order to make the Local channel driver compatible with the comma
   delimiter change in applications.
@@ -214,7 +241,7 @@ Channel Drivers:
 Configuration:
 
 * pbx_dundi.c: tos parameter changed to use new values. Old values like lowdelay,
-  lowcost and other is not acceptable now. Look into qos.tex for description of 
+  lowcost and other is not acceptable now. Look into qos.tex for description of
   this parameter.
 
 * queues.conf: the queue-lessthan sound file option is no longer available, and the
@@ -222,7 +249,7 @@ Configuration:
 
 Manager:
 
-* Manager has been upgraded to version 1.1 with a lot of changes. 
+* Manager has been upgraded to version 1.1 with a lot of changes.
   Please check doc/manager_1_1.txt for information
 
 * The IAXpeers command output has been changed to more closely resemble the