svn: /phpdoc/en/trunk/ appendices/ini.xml features/safe-mode.xml language/references.xml language-snippets.ent reference/sybase/ini.xml

danbrown Thu, 13 Aug 2009 03:32:47 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=287196 Log: Added PHP 5.3 deprecation warning. Changed paths: U phpdoc/en/trunk/appendices/ini.xml U phpdoc/en/trunk/features/safe-mode.xml U phpdoc/en/trunk/language/references.xml U phpdoc/en/trunk/language-snippets.ent U phpdoc/en/trunk/reference/sybase/ini.xml Modified: phpdoc/en/trunk/appendices/ini.xml =================================================================== --- phpdoc/en/trunk/appendices/ini.xml 2009-08-13 03:06:09 UTC (rev 287195) +++ phpdoc/en/trunk/appendices/ini.xml 2009-08-13 03:32:47 UTC (rev 287196) @@ -1569,7 +1569,7 @@ <entry><link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link></entry> <entry>"1"</entry> <entry>PHP_INI_PERDIR</entry> - <entry>PHP_INI_ALL in PHP &lt;= 4.2.3. Removed in PHP 6.0.0.</entry> + <entry>PHP_INI_ALL in PHP &lt;= 4.2.3. Deprecated in PHP 5.3.0. Removed in PHP 6.0.0.</entry> </row> <row> <entry><link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link></entry> @@ -2421,7 +2421,7 @@ <entry><link linkend="ini.register-long-arrays">register_long_arrays</link></entry> <entry>"1"</entry> <entry>PHP_INI_PERDIR</entry> - <entry>Available since PHP 5.0.0. Removed in PHP 6.0.0.</entry> + <entry>Available since PHP 5.0.0. Deprecated in PHP 5.3.0. Removed in PHP 6.0.0.</entry> </row> <row> <entry><link linkend="ini.report-memleaks">report_memleaks</link></entry> @@ -2457,7 +2457,7 @@ <entry><link linkend="ini.safe-mode">safe_mode</link></entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> - <entry>Removed in PHP 6.0.0.</entry> + <entry>Deprecated in PHP 5.3.0. Removed in PHP 6.0.0.</entry> </row> <row> <entry><link linkend="ini.safe-mode-allowed-env-vars">safe_mode_allowed_env_vars</link></entry> @@ -3812,8 +3812,8 @@ <listitem> <para> Whether to warn when arguments are passed by reference - at function call time. This method is deprecated and is likely to be - unsupported in future versions of PHP/Zend. The encouraged method of + at function call time. This method is deprecated in PHP 5.3.0 and is likely + to be unsupported in future versions of PHP/Zend. The encouraged method of specifying which arguments should be passed by reference is in the function declaration. You're encouraged to try and turn this option Off and make sure your scripts work properly with it in order to ensure they will work @@ -4064,7 +4064,8 @@ <entry>register_long_arrays</entry> <entry>"1"</entry> <entry>PHP_INI_PERDIR</entry> - <entry>Available since PHP 5.0.0.</entry> + <entry>Available since PHP 5.0.0. Deprecated in PHP 5.3.0. Removed in + PHP 6.0.0.</entry> </row> <row> <entry>post_max_size</entry> @@ -4349,9 +4350,9 @@ like <varname>$_GET</varname>. </simpara> <simpara> - This directive became available in PHP 5.0.0 and was dropped in PHP - 6.0.0. + This directive became available in PHP 5.0.0. </simpara> + &warn.deprecated.feature-5-3-0.removed-6-0-0; </listitem> </varlistentry> Modified: phpdoc/en/trunk/features/safe-mode.xml =================================================================== --- phpdoc/en/trunk/features/safe-mode.xml 2009-08-13 03:06:09 UTC (rev 287195) +++ phpdoc/en/trunk/features/safe-mode.xml 2009-08-13 03:32:47 UTC (rev 287196) @@ -12,7 +12,7 @@ </para> <warning> <para> - Safe Mode was removed in PHP 6.0.0. + Safe Mode is deprecated in PHP 5.3.0 and is removed in PHP 6.0.0. </para> </warning> @@ -106,6 +106,7 @@ If PHP is compiled with <literal>--enable-safe-mode</literal> then defaults to On, otherwise Off. </para> + &warn.deprecated.feature-5-3-0.removed-6-0-0; </listitem> </varlistentry> <varlistentry xml:id="ini.safe-mode-gid"> Modified: phpdoc/en/trunk/language/references.xml =================================================================== --- phpdoc/en/trunk/language/references.xml 2009-08-13 03:06:09 UTC (rev 287195) +++ phpdoc/en/trunk/language/references.xml 2009-08-13 03:32:47 UTC (rev 287196) @@ -254,11 +254,15 @@ ]]> </programlisting> </informalexample> - Note that there's no reference sign on a function call - only on - function definitions. Function definitions alone are enough to - correctly pass the argument by reference. In recent versions of PHP - you will get a warning saying that "call-time pass-by-reference" is - deprecated when you use &amp; in <literal>foo(&amp;$a);</literal>. + <note> + <simpara> + There is no reference sign on a function call - only on + function definitions. Function definitions alone are enough to + correctly pass the argument by reference. As of PHP 5.3.0, + you will get a warning saying that "call-time pass-by-reference" is + deprecated when you use &amp; in <literal>foo(&amp;$a);</literal>. + </simpara> + </note> </para> <para> The following things can be passed by reference: @@ -318,7 +322,7 @@ </programlisting> </informalexample> These requirements are for PHP 4.0.4 and later. - </para> + </para> </sect1> <sect1 xml:id="language.references.return"> Modified: phpdoc/en/trunk/language-snippets.ent =================================================================== --- phpdoc/en/trunk/language-snippets.ent 2009-08-13 03:06:09 UTC (rev 287195) +++ phpdoc/en/trunk/language-snippets.ent 2009-08-13 03:32:47 UTC (rev 287196) @@ -129,6 +129,11 @@ extension may change without notice in a future release of PHP. This extension should be used at your own risk.</simpara></warning>'> +<!ENTITY warn.deprecated.feature-5-3-0 '<warning +xmlns="http://docbook.org/ns/docbook"><simpara>This feature has been +<emphasis>DEPRECATED</emphasis> as of PHP 5.3.0. Relying on this feature +is highly discouraged.</simpara></warning>'> + <!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>This feature has been <emphasis>DEPRECATED</emphasis> as of PHP 5.3.0 and <emphasis>REMOVED</emphasis> as of PHP 6.0.0. Modified: phpdoc/en/trunk/reference/sybase/ini.xml =================================================================== --- phpdoc/en/trunk/reference/sybase/ini.xml 2009-08-13 03:06:09 UTC (rev 287195) +++ phpdoc/en/trunk/reference/sybase/ini.xml 2009-08-13 03:32:47 UTC (rev 287196) @@ -62,7 +62,7 @@ <entry><link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link></entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> - <entry>Removed in PHP 6.0.0.</entry> + <entry>Deprecated in PHP 5.3.0. Removed in PHP 6.0.0.</entry> </row> </tbody> </tgroup> @@ -161,6 +161,7 @@ will be escaped. </para> </note> + &warn.deprecated.feature-5-3-0.removed-6-0-0; </listitem> </varlistentry>