* Added caution note that ticks are deprecated as of 5.3

* Added note in changelog on the following functions that they will throw an E_DEPRECATED notice as of 5.3:
  * mktime() -- is_dst parameter is deprecated
  * register_tick_function()
  * mysql_db_query()
  * mysql_escape_string()
  * setlocale() -- Behavior of passing strings insted of one of the LC_* constants is deprecated


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@265410 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Kalle Sommer Nielsen 2008-08-24 07:26:26 +00:00
parent 79e058a6b3
commit 20a326f84d
7 changed files with 93 additions and 12 deletions

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.164 $ -->
<!-- $Revision: 1.165 $ -->
<chapter xml:id="language.control-structures" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Control Structures</title>
@ -1155,6 +1155,12 @@ declare(ticks=1);
</para>
<sect2 xml:id="control-structures.declare.ticks">
<title>Ticks</title>
<caution>
<simpara>
As of PHP 5.3.0 ticks are deprecated and will be removed
in PHP 6.0.0.
</simpara>
</caution>
<para>A tick is an event that occurs for every
<varname>N</varname> low-level statements executed
by the parser within the <literal>declare</literal> block.

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.24 $ -->
<!-- $Revision: 1.25 $ -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 -->
<refentry xml:id="function.mktime" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@ -129,9 +129,7 @@
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
&date.timezone.errors.description;
</refsect1>
<refsect1 role="changelog">
@ -146,6 +144,13 @@
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
<function>mktime</function> now throws <literal>E_DEPRECATED</literal> notice
if the <parameter>is_dst</parameter> parameter is used.
</entry>
</row>
<row>
<entry>3.0.10</entry>
<entry>Added <parameter>is_dst</parameter> parameter</entry>
@ -160,9 +165,9 @@
as zero.
</entry>
</row>
&date.timezone.errors.changelog;
</tbody>
</tgroup>
</informaltable>

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.14 $ -->
<!-- $Revision: 1.15 $ -->
<refentry xml:id="function.register-tick-function" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>register_tick_function</refname>
@ -79,6 +79,31 @@ register_tick_function(array(&$object, 'my_method'), true);
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
Ticks are now deprecated and <function>register_tick_function</function>
now throws an E_DEPRECATED notice.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<warning>

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.27 $ -->
<!-- $Revision: 1.28 $ -->
<refentry xml:id="function.dl" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dl</refname>
@ -126,6 +126,31 @@ if (!extension_loaded('sqlite')) {
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
This function now throws an E_DEPRECATED notice on all sapi's
except for CLI, CGI and Embed.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.14 $ -->
<!-- $Revision: 1.15 $ -->
<refentry xml:id="function.mysql-db-query" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysql_db_query</refname>
@ -67,6 +67,12 @@
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
This function now throws an E_DEPRECATED notice.
</entry>
</row>
<row>
<entry>4.0.6</entry>
<entry>

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.15 $ -->
<!-- $Revision: 1.16 $ -->
<refentry xml:id="function.mysql-escape-string" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysql_escape_string</refname>
@ -61,6 +61,12 @@
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
This function now throws an E_DEPRECATED notice.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.30 $ -->
<!-- $Revision: 1.31 $ -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.setlocale">
<refnamediv>
<refname>setlocale</refname>
@ -146,6 +146,14 @@
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
This function now throws an E_DEPRECATED notice if a string is passed
to the <parameter>category</parameter> parameter insted of one of the
<literal>LC_*</literal> constants.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>