Merge "confbridge: announce to the marked users when they join an empty conference"
[asterisk/asterisk.git] / UPGRADE.txt
index 91d9edc..53e9c4a 100644 (file)
 === UPGRADE-11.txt  -- Upgrade info for 10 to 11
 === UPGRADE-12.txt  -- Upgrade info for 11 to 12
 === UPGRADE-13.txt  -- Upgrade info for 12 to 13
+=== UPGRADE-14.txt  -- Upgrade info for 13 to 14
+=== UPGRADE-15.txt  -- Upgrade info for 14 to 15
+=== UPGRADE-16.txt  -- Upgrade info for 15 to 16
 ===========================================================
 
-Channel Drivers:
+New in 17.0.0:
 
-chan_dahdi:
- - For users using the FXO port (FXS signaling) distinctive ring detection
-   feature, you will need to adjust the dringX count values.  The count
-   values now only record ring end events instead of any DAHDI event.  A
-   ring-ring-ring pattern would exceed the pattern limits and stop
-   Caller-ID detection.
+chan_sip:
+ - The chan_sip module is now deprecated, users should migrate to the
+   replacement module chan_pjsip.  See guides at the Asterisk Wiki:
+     https://wiki.asterisk.org/wiki/x/tAHOAQ
+     https://wiki.asterisk.org/wiki/x/hYCLAQ
 
-Core:
- - The REF_DEBUG compiler flag is now used to enable refdebug by default.
-   The setting can be overridden in asterisk.conf by setting refdebug in
-   the options category.  No recompile is required to enable/disable it.
+func_callerid:
+ - The CALLERPRES() dialplan function, deprecated in Asterisk 1.8, has been
+   removed.
 
- - Modified processing of command-line options to first parse only what
-   is necessary to read asterisk.conf. Once asterisk.conf is fully loaded,
-   the remaining options are processed.  The -X option now applies to
-   asterisk.conf only.  To enable #exec for other config files you must
-   set execincludes=yes in asterisk.conf.  Any other option set on the
-   command-line will now override the equivalent setting from asterisk.conf.
+res_parking:
+ - The PARKINGSLOT channel variable, deprecated in Asterisk 12 in favor of the
+   PARKING_SPACE channel variable, will no longer be set.
 
-AMI:
- - The 'ModuleCheck' Action's Version key will no longer show the module
-   version. The value will always be blank.
+res_xmpp:
+ - The JabberStatus application, deprecated in Asterisk 12, has been removed.
 
-CLI:
- - The 'core show file version' command has been removed. When Asterisk
-   moved to Git, the source control version support was removed. As a
-   result, the CLi command was no longer useful and was removed as well.
+Channels:
+ - The core no longer uses the stasis cache for channels snapshots.
+   The following APIs are no longer available:
+       ast_channel_topic_cached()
+       ast_channel_topic_all_cached()
+   The ast_channel_cache_all() and ast_channel_cache_by_name() functions
+   now returns an ao2_container of ast_channel_snapshots rather than a
+   container of stasis_messages therefore you can't call stasis_cache
+   functions on it.
+   The ast_channel_topic_all() function now returns a normal topic,
+   not a cached one so you can't use stasis cache functions on it either.
+   The ast_channel_snapshot_type() stasis message now has the
+   ast_channel_snapshot_update structure as it's data.
+   ast_channel_snapshot_get_latest() still returns the latest snapshot.
 
-Logging:
- - The first callid created is now 1 instead of 0.  The value 0
-   is now reserved to represent a lack of callid.
+Applications
+ - The JabberStatus application, deprecated in Asterisk 12, has been removed.
 
-AMI:
- - The Command action now sends the output from the CLI command as a series
-   of Output headers for each line instead of as a block of text with the
-   --END COMMAND-- delimiter to match the output from other actions.
+Bridging
+ - The bridging core no longer uses the stasis cache for bridge
+   snapshots.  The latest bridge snapshot is now stored on the
+   ast_bridge structure itself.
+ - The following APIs are no longer available since the stasis cache
+   is no longer used:
+     ast_bridge_topic_cached()
+     ast_bridge_topic_all_cached()
+ - A topic pool is now used for individual bridge topics.
+ - The ast_bridge_cache() function was removed since there's no
+   longer a separate container of snapshots.
+ - A new function "ast_bridges()" was created to retrieve the
+   container of all bridges.  Users formerly calling
+   ast_bridge_cache() can use the new function to iterate over
+   bridges and retrieve the latest snapshot directly from the
+   bridge.
+ - The ast_bridge_snapshot_get_latest() function was renamed to
+   ast_bridge_get_snapshot_by_uniqueid().
+ - A new function "ast_bridge_get_snapshot()" was created to retrieve
+   the bridge snapshot directly from the bridge structure.
+ - The ast_bridge_topic_all() function now returns a normal topic
+   not a cached one so you can't use stasis cache functions on it
+   either.
+ - The ast_bridge_snapshot_type() stasis message now has the
+   ast_bridge_snapshot_update structure as it's data.  It contains
+   the last snapshot and the new one.
 
-   Commands that fail to execute (no such command, invalid syntax etc.) now
-   return an Error response instead of Success.
-
-===========================================================
-===========================================================