rquadling Wed Jul 11 08:38:48 2007 UTC
Modified files: /phpdoc/en/appendices migration4.xml Log: Updated migration4 - thank you Simion Onea. http://cvs.php.net/viewvc.cgi/phpdoc/en/appendices/migration4.xml?r1=1.40&r2=1.41&diff_format=u Index: phpdoc/en/appendices/migration4.xml diff -u phpdoc/en/appendices/migration4.xml:1.40 phpdoc/en/appendices/migration4.xml:1.41 --- phpdoc/en/appendices/migration4.xml:1.40 Wed Jun 20 22:24:10 2007 +++ phpdoc/en/appendices/migration4.xml Wed Jul 11 08:38:48 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.40 $ --> +<!-- $Revision: 1.41 $ --> <appendix xml:id="migration4" xmlns="http://docbook.org/ns/docbook"> <title>Migrating from PHP 3 to PHP 4</title> @@ -132,8 +132,8 @@ type lines! You have to convert these yourself. </simpara> <para> - To convert your Apache configuration files, run the apconf-conv.sh - script (available in the scripts/apache/ directory). For example: + To convert your Apache configuration files, run the <filename>apconf-conv.sh</filename> + script (available in the <filename>scripts/apache/</filename> directory). For example: <informalexample> <programlisting role="shell"> <![CDATA[ @@ -159,10 +159,10 @@ </para> <simpara> Likewise, your old &htaccess; files will be saved with - an .orig prefix. + an .orig suffix. </simpara> <simpara> - The conversion scripts require awk to be installed. + The conversion scripts require 'awk' to be installed. </simpara> </section> @@ -187,7 +187,7 @@ a different file. </para> <para> - It still perfectly legal to include additional code within loops + It is still perfectly legal to include additional code within loops or other control structures, only the controlling keywords and corresponding curly braces <literal>{...}</literal> have to be within the same compile unit (file or <function>eval</function>ed @@ -241,7 +241,7 @@ When upgrading code or servers from PHP 3 to PHP 4 you should check these settings and calls to <function>error_reporting</function> or you might disable - reporting the new error types, especially E_COMPILE_ERROR. This + reporting the new error types, especially <literal>E_COMPILE_ERROR</literal>. This may lead to empty documents without any feedback of what happened or where to look for the problem. </para> @@ -257,7 +257,7 @@ <para> This has lead to a lot of unreproducible bug reports in the past where people reported script engine problems they were not - capable to track down while the &true; case was usually some + capable to track down while the true case was usually some missing '}' in a required file that the parser was not able to report due to a misconfigured error reporting system. </para> @@ -278,8 +278,8 @@ the intended thing now, could easily be broken by changes in other places. PHP 4 will output a lot of notice messages in such situations where PHP 3 didn't. The easy fix is to just - turn off E_NOTICE messages, but it is usually a good idea to fix - the code instead. + turn off <literal>E_NOTICE</literal> messages, but it is usually + a good idea to fix the code instead. </para> <para> The most common case that will now produce notice messages is the @@ -324,8 +324,8 @@ <section xml:id='migration4.empty'> <title><literal>empty("0")</literal></title> <para> - The perhaps most controversial change in behavior has happened to the - behavior of the <function>empty</function>. A String containing + Perhaps the most controversial change in behavior has happened to + <function>empty</function>. A String containing only the character '0' (zero) is now considered empty while it wasn't in PHP 3. </para> @@ -361,7 +361,7 @@ possible to change the behavior of the parser (now embedded in the Zend engine) at runtime as parsing already happened by then. So the function <function>short_tags</function> no longer - exists. You can still change the parsers behavior by setting + exists. You can still change the parser's behavior by setting appropriate values in the &php.ini; file. </para> <para>