Align section headings with the latest (5.4) migration on-line doc.

This will aid future reuse of UPGRADING text.

diff --git a/UPGRADING b/UPGRADING
index dabdf98d2c4ba05ea034c7619045393604c6678c..6a19917e3129e374c153cebfc6922fb3d4cc015d 100755 (executable)
--- a/UPGRADING
+++ b/UPGRADING
@@ -1,192 +1,82 @@
 $Id$
 
-UPGRADE NOTES - PHP X.Y
+PHP X.Y UPGRADE NOTES
+
+1. Backward Incompatible Changes
+2. New Features
+2. Changes in SAPI modules
+3. Deprecated Functionality
+4. Changed Functions
+5. New Functions
+6. New Classes and Interfaces
+7. Removed Extensions
+8. Other Changes to Extensions
+9. New Global Constants
+10. Changes to INI File Handling
+11. Other Changes
 
-1. Changes made to default configuration
-2. Reserved words and classes
-3. Changes made to engine behaviour
-4. Changes made to existing functions
-5. Changes made to existing methods
-6. Changes made to existing classes
-7. Deprecated
-8. Removed
-9. Extensions:
-     a. moved out to PECL and actively maintained there
-     b. no longer maintained
-     c. with changed behaviour
-     d. no longer possible to disable
-10. Changes in SAPI support
-11. Changes in INI directives
-12. Syntax additions
-13. Windows support
-14. New in PHP X.Y:
-     a. New libraries
-     b. New extensions
-     c. New stream wrappers
-     d. New stream filters
-     e. New functions
-     f. New global constants
-     g. New classes
-     h. New methods
-     i. New class constants
-     j. New hash algorithms
-     k. New Syntax
 
 ========================================
-1. Changes made to default configuration
+1. Backward Incompatible Changes
 ========================================
 
-- 
-
-=============================
-2. Reserved words and classes
-=============================
-
-- 
-
-=============================
-3. Changes made to engine behaviour
-=============================
-
-- 
-
-=====================================
-4. Changes made to existing functions
-=====================================
-
-- 
-
-===================================
-5. Changes made to existing methods
-===================================
-
-- 
-
-===================================
-6. Changes made to existing classes
-===================================
-
-- 
-
-=============
-7. Deprecated
-=============
-
-- The preg_replace /e modifier is now deprecated.
-  You should use preg_replace_callback instead.
-
-==========
-8. Removed
-==========
-
-    a. removed features
-
-       - 
-
-    b. removed ini directives
-
-       - 
-
-    c. removed functions
-
-          - 
-
-    d. removed syntax
-
-       - 
-
-=============
-9. Extensions
-=============
-
-     a. moved out to PECL and actively maintained there
-
-        - 
-
-     b. no longer maintained
-
-        - 
-
-     c. with changed behaviour
-
-        -  
-
-     d. no longer possible to disable
-
-        - 
-
-==========================
-10. Changes in SAPI support
-==========================
-
-- 
-
-=============================
-11. Changes in INI directives
-=============================
-
-- 
-
-====================
-12. Syntax additions
-====================
-
-- 
-
-===================
-13. Windows support
-===================
-
 - Drop Windows XP and 2003 support. (Pierre)
 
-===================
-14. New in PHP X.Y:
-===================
-
-     a. New libraries
+========================================
+2. New Features
+========================================
 
-       - 
 
-     b. New extensions
+========================================
+2. Changes in SAPI modules
+========================================
 
-       - 
 
-     c. New stream wrappers
+========================================
+3. Deprecated Functionality
+========================================
 
-       - 
+- The preg_replace /e modifier is now deprecated.  Use
+  preg_replace_callback instead.
+  (https://wiki.php.net/rfc/remove_preg_replace_eval_modifier)
 
-     d. New stream filters
+========================================
+4. Changed Functions
+========================================
 
-       - 
 
-     e. New functions
+========================================
+5. New Functions
+========================================
 
-       - Extension:
-         - function()
 
-     f. New global constants
+========================================
+6. New Classes and Interfaces
+========================================
 
-       - 
+- SPL:
+  - SplFixedArray::__wakeup()
 
-     g. New classes
+========================================
+7. Removed Extensions
+========================================
 
-       - Extension:
-         - ClassName
-       
-     h. New methods
 
-        - Spl:
-         - SplFixedArray::__wakeup()
+========================================
+8. Other Changes to Extensions
+========================================
 
-     i. New class constants
 
-       - Extension:
-         - ClassName::CONSTANT
+========================================
+9. New Global Constants
+========================================
 
-     j. New Hash algorithms
 
-       - 
+========================================
+10. Changes to INI File Handling
+========================================
 
-     k. New Syntax
 
-       - 
+========================================
+11. Other Changes
+========================================