Here is my proposal for a appendices/migration5.xml file:
<appendix id="migration5">
<title>Migrating from PHP 4 to PHP 5</title>
<section id='migration5.changes'>
<title>What has changed in PHP 5</title>
(blah, blah, most code should work, but take special atention in OOP)
</section>
<section id="migration5.configuration">
<title>Migrating Configuration Files</title>
(.htaccess files: new module name and new cgi filename)
</section>
<section id="migration5.cli-cgi">
<title>CLI and CGI</title>
(new filenames and new argc(v) behaviour)
</section>
<section id="migration5.thinchanges">
<title>Thin Changes</title>
(php-src/README.PHP4-TO-PHP5-THIN-CHANGES)
</section>
<section id="migration5.functions">
<title>New Functions</title>
(list of new functions)
</section>
<section id="migration5.extensions">
<title>Changes in Extensions</title>
(new bundled extensions and extensions moved to PECL)
</section>
<section id="migration5.databases">
<title>Databases</title>
(new sqlite and mysqli extensions. mysql not bundled
also porting from mysql_ to mysqli_)
</section>
<section id='migration5.oop'>
<title>New Object Model</title>
<para>
(integrate http://php.net/zend-engine-2.php here)
</para>
</section>
</appendix>
Any comments?
Nuno
