Contributions are ready for review
| From: | phpdoc at lists dot php dot net | Date: | Mon, 16 Jan 2017 13:00:03 +0000 |
| Subject: | Contributions are ready for review | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969386486@lists.php.net to get a copy of this message | ||
Hello PHP EN Documentation team,
There are contributions within the online editor queue for this language.
Please review, then commit or delete these patches.
Patches for review :
-----------------------
New file: en/reference/pcntl/functions/pcntl-signal-get-handler.xml
By: David Walker on 2017-01-10 08:31:37
===================================================================
--- en/reference/pcntl/functions/pcntl-signal-get-handler.xml
+++ en/reference/pcntl/functions/pcntl-signal-get-handler.xml
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 299488 $ -->
+
+<refentry xml:id="function.pcntl-signal-get-handler" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>pcntl_signal_get_handler</refname>
+ <refpurpose>Get the current handler for specified signal</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int|string</type><methodname>pcntl_signal_get_handler</methodname>
+
<methodparam><type>int</type><parameter>signo</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>pcntl_signal_get_handler</function> function will get the current
handler for the specified <parameter>signo</parameter>.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <variablelist>
+ <varlistentry>
+ <term><parameter>signo</parameter></term>
+ <listitem>
+ <para>
+ The signal number.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ This function may return an integer value that refers to
<constant>SIG_DFL</constant> or <constant>SIG_IGN</constant>. If you set a
custom handler a string value containing the function name is returned.
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog"><!-- {{{ -->
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Enter the version of change here</entry>
+ <entry>
+ Describe the change
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>pcntl_signal_get_handler</function> example</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+var_dump(pcntl_signal_get_handler(SIGUSR1)); // Outputs: int(0)
+
+function pcntl_test($signo) {}
+pcntl_signal(SIGUSR1, 'pcntl_test');
+var_dump(pcntl_signal_get_handler(SIGUSR1)); // Outputs: string(10) "pcntl_test"
+
+pcntl_signal(SIGUSR1, SIG_DFL);
+var_dump(pcntl_signal_get_handler(SIGUSR1)); // Outputs: int(0)
+
+pcntl_signal(SIGUSR1, SIG_IGN);
+var_dump(pcntl_signal_get_handler(SIGUSR1)); // Outputs: int(1)
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <simplelist>
+ <member><function>pcntl_signal</function></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71823
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71823
------------------------------------------------------------------
Modified: en/reference/array/functions/array-filter.xml
By: Jesse Donat on 2016-04-04 10:13:45
===================================================================
--- en/reference/array/functions/array-filter.xml
+++ en/reference/array/functions/array-filter.xml
@@ -240,6 +240,12 @@
added, deleted or unset) the behavior of this function is undefined.
</para>
</caution>
+
+ <caution>
+ <para>
+ As of PHP7 the value of the callback may no longer be used by reference.
+ </para>
+ </caution>
</refsect1>
<refsect1 role="seealso">
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=66717
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=66717
------------------------------------------------------------------
Modified: en/reference/apcu/apcuiterator/gettotalhits.xml
By: Walt Sorensen on 2016-10-10 08:53:27
===================================================================
--- en/reference/apcu/apcuiterator/gettotalhits.xml
+++ en/reference/apcu/apcuiterator/gettotalhits.xml
@@ -38,7 +38,7 @@
<simplelist>
<member><methodname>APCUIterator::getTotalCount</methodname></member>
<member><methodname>APCUIterator::getTotalSize</methodname></member>
- <member><function>apc_cache_info</function></member>
+ <member><function>apcu_cache_info</function></member>
</simplelist>
</refsect1>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69090
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69090
------------------------------------------------------------------
Modified: en/reference/apcu/apcuiterator/gettotalcount.xml
By: Walt Sorensen on 2016-10-10 08:54:02
===================================================================
--- en/reference/apcu/apcuiterator/gettotalcount.xml
+++ en/reference/apcu/apcuiterator/gettotalcount.xml
@@ -38,7 +38,7 @@
<simplelist>
<member><methodname>APCUIterator::getTotalHits</methodname></member>
<member><methodname>APCUIterator::getTotalSize</methodname></member>
- <member><function>apc_cache_info</function></member>
+ <member><function>apcu_cache_info</function></member>
</simplelist>
</refsect1>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69091
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69091
------------------------------------------------------------------
Modified: en/reference/apcu/constants.xml
By: Walt Sorensen on 2016-10-10 09:14:09
===================================================================
--- en/reference/apcu/constants.xml
+++ en/reference/apcu/constants.xml
@@ -5,6 +5,21 @@
&reftitle.constants;
&extension.constants;
+ <title>The APCu Constants</title>
+ <titleabbrev>APCu Constants</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ APCu Constants intro -->
+ <section xml:id="apcu.constants.intro">
+ &reftitle.intro;
+ <para>
+ The APCu Constants below are the same as defined in the APC extension, and will only be
available when the extension has either been compiled into PHP or dynamically loaded at runtime.
+ </para>
+ </section>
+<!-- }}} -->
+ </partintro>
+
<para>
<variablelist>
<varlistentry xml:id="constant.apcu-iter-all">
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69094
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69094
------------------------------------------------------------------
Modified: en/install/windows/manual.xml
By: Walt Sorensen on 2016-10-10 14:17:12
===================================================================
--- en/install/windows/manual.xml
+++ en/install/windows/manual.xml
@@ -6,8 +6,8 @@
<title>Choose Web Server</title>
<para>
<itemizedlist spacing="compact">
- <listitem>
- <para>
+ <listitem>
+ <para>
IIS is builtin to Windows.
On Windows Server, use Server Manager to add the IIS role. Be sure to include the CGI Role
Feature.
@@ -78,17 +78,17 @@
There are 4 types of PHP builds:
<itemizedlist spacing="compact">
<listitem>
- <para>Thread-Safe(TS) - use for single process web serves, like Apache with
mod_php</para>
+ <para>Thread-Safe(TS) - use for single process web serves, like Apache with
mod_php</para>
</listitem>
<listitem>
- <para>Non-Thread-Safe(NTS) - use for IIS and other FastCGI web servers (Apache with
mod_fastcgi) and recommended for command-line scripts</para>
+ <para>Non-Thread-Safe(NTS) - use for IIS and other FastCGI web servers (Apache with
mod_fastcgi) and recommended for command-line scripts</para>
</listitem>
<listitem>
- <para>x86 - production use of PHP 5.5 or 5.6 or 7.0.</para>
+ <para>x86 - production use of PHP 5.5 or 5.6 or 7.0.</para>
</listitem>
<listitem>
- <para>x64 - production use of PHP 7.0+ unless its a 32-bit only version of Windows. 5.5 and
5.6 x64 are expiremental.</para>
- </listitem>
+ <para>x64 - production use of PHP 7.0+ unless its a 32-bit only version of Windows. 5.5
and 5.6 x64 are expiremental.</para>
+ </listitem>
</itemizedlist>
</para>
</sect2>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69107
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69107
------------------------------------------------------------------
Modified: en/reference/spl/recursivearrayiterator.xml
By: John Flatness on 2016-10-24 18:10:15
===================================================================
--- en/reference/spl/recursivearrayiterator.xml
+++ en/reference/spl/recursivearrayiterator.xml
@@ -40,6 +40,13 @@
</oointerface>
</classsynopsisinfo>
+ <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
+ <fieldsynopsis>
+ <modifier>const</modifier>
+ <type>integer</type>
+ <varname
linkend="recursivearrayiterator.constants.child-arrays-only">CHILD_ARRAYS_ONLY</varname>
+ <initializer>4</initializer>
+ </fieldsynopsis>
<!-- }}} -->
<!-- {{{ If the property is documented below (xml:id=recursivearrayiterator.props) use this
@@ -59,6 +66,45 @@
</section>
+ <section xml:id="recursivearrayiterator.constants">
+ &reftitle.constants;
+ <section xml:id="recursivearrayiterator.constants.flags">
+ <title>RecursiveArrayIterator Flags</title>
+ <variablelist>
+ <varlistentry xml:id="recursivearrayiterator.constants.child-arrays-only">
+
<term><constant>RecursiveArrayIterator::CHILD_ARRAYS_ONLY</constant></term>
+ <listitem>
+ <para>Treat only arrays (not objects) as having children for recursive
iteration.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ </section>
+
+ <section 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>
+ <constant>CHILD_ARRAYS_ONLY</constant> flag was added.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </section>
+
<!-- {{{ RecursiveArrayIterator properties
<section xml:id="recursivearrayiterator.props">
&reftitle.properties;
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69697
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69697
------------------------------------------------------------------
Modified: en/reference/opcache/ini.xml
By: Arnout Boks on 2016-11-09 23:22:04
===================================================================
--- en/reference/opcache/ini.xml
+++ en/reference/opcache/ini.xml
@@ -524,7 +524,7 @@
<para>
If
<link
linkend="ini.opcache.log-verbosity-level">opcache.log_verbosity_level</link>
- is set to 3 or above, an error will be recorded in the error log when
+ is set to 2 or above, a warning will be recorded in the error log when
this occurs.
</para>
</listitem>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69887
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69887
------------------------------------------------------------------
Modified: en/language/types/type-juggling.xml
By: Pedro Magalhães on 2016-11-10 10:43:59
===================================================================
--- en/language/types/type-juggling.xml
+++ en/language/types/type-juggling.xml
@@ -150,10 +150,6 @@
</itemizedlist>
<para>
- (binary) casting and b prefix forward support was added in PHP 5.2.1
- </para>
-
- <para>
Note that tabs and spaces are allowed inside the parentheses, so the
following are functionally equivalent:
</para>
@@ -167,20 +163,6 @@
?>
]]>
</programlisting>
-
- <para>
- Casting literal <type>string</type>s and variables to binary
- <type>string</type>s:
- </para>
-
- <programlisting role="php">
-<![CDATA[
-<?php
-$binary = (binary) $string;
-$binary = b"binary string";
-?>
-]]>
- </programlisting>
</informalexample>
<note>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=69890
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=69890
------------------------------------------------------------------
Modified: en/reference/strings/functions/sha1.xml
By: Joel Hutchinson on 2016-11-17 08:12:07
===================================================================
--- en/reference/strings/functions/sha1.xml
+++ en/reference/strings/functions/sha1.xml
@@ -6,6 +6,15 @@
<refpurpose>Calculate the sha1 hash of a string</refpurpose>
</refnamediv>
+ <refsynopsisdiv>
+ <warning>
+ ¬e.passwordhashing;
+ <simplelist role="alternatives">
+ <member><function>password_hash</function></member>
+ </simplelist>
+ </warning>
+ </refsynopsisdiv>
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -72,11 +81,6 @@
</example>
</para>
</refsect1>
-
- <refsect1 role="notes">
- &reftitle.notes;
- ¬e.passwordhashing;
- </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=70048
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=70048
------------------------------------------------------------------
Modified: en/reference/strings/functions/md5.xml
By: Joel Hutchinson on 2016-11-17 08:12:18
===================================================================
--- en/reference/strings/functions/md5.xml
+++ en/reference/strings/functions/md5.xml
@@ -6,6 +6,15 @@
<refpurpose>Calculate the md5 hash of a string</refpurpose>
</refnamediv>
+ <refsynopsisdiv>
+ <warning>
+ ¬e.passwordhashing;
+ <simplelist role="alternatives">
+ <member><function>password_hash</function></member>
+ </simplelist>
+ </warning>
+ </refsynopsisdiv>
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -72,11 +81,6 @@
</example>
</para>
</refsect1>
-
- <refsect1 role="notes">
- &reftitle.notes;
- ¬e.passwordhashing;
- </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=70045
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=70045
------------------------------------------------------------------
Modified: en/reference/mqseries/functions/mqseries-connx.xml
By: rjhdby on 2016-12-29 02:36:17
===================================================================
--- en/reference/mqseries/functions/mqseries-connx.xml
+++ en/reference/mqseries/functions/mqseries-connx.xml
@@ -5,7 +5,7 @@
<refname>mqseries_connx</refname>
<refpurpose>MQSeries MQCONNX</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -23,8 +23,13 @@
provides a queue manager connection handle, which is used by the application
on subsequent MQ calls.
</para>
+ <para>
+ The <function>mqseries_connx</function> call is like the
+ <function>mqseries_conn</function> (MQCONN) call, except that MQCONNX
+ allows options to be specified to control the way that the call works.
+ </para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -47,7 +52,7 @@
<para>See also the MQCNO structure.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term>
<parameter>hConn</parameter>
@@ -76,12 +81,12 @@
</variablelist>
</para>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>&return.void;</para>
</refsect1>
-
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -151,7 +156,7 @@
</example>
</para>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71425
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71425
------------------------------------------------------------------
Modified: en/reference/mqseries/functions/mqseries-get.xml
By: rjhdby on 2016-12-29 03:02:51
===================================================================
--- en/reference/mqseries/functions/mqseries-get.xml
+++ en/reference/mqseries/functions/mqseries-get.xml
@@ -155,19 +155,11 @@
printf("GET CompCode:%d Reason:%d Text:%s<br>", $comp_code, $reason,
mqseries_strerror($reason));
}
- // open connection to the queue manager
- mqseries_conn('WMQ1', $conn, $comp_code, $reason);
-// $conn now hold the reference to the connection to the queue manager.
+// close the object reference $obj
+ mqseries_close($conn, $obj, MQSERIES_MQCO_NONE, $comp_code, $reason);
-// open the connection to the testq queue
- mqseries_open(
- $conn,
- array('ObjectName' => 'TESTQ'),
- MQSERIES_MQOO_INPUT_AS_Q_DEF | MQSERIES_MQOO_FAIL_IF_QUIESCING |
MQSERIES_MQOO_OUTPUT,
- $obj,
- $comp_code,
- $reason);
-// $obj now holds the reference to the object (TESTQ)
+// disconnect from the queue manager.
+ mqseries_disc($conn, $comp_code, $reason);
?>
]]>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71432
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71432
------------------------------------------------------------------
Modified: en/reference/mqseries/functions/mqseries-put1.xml
By: rjhdby on 2016-12-29 03:10:21
===================================================================
--- en/reference/mqseries/functions/mqseries-put1.xml
+++ en/reference/mqseries/functions/mqseries-put1.xml
@@ -5,7 +5,7 @@
<refname>mqseries_put1</refname>
<refpurpose>MQSeries MQPUT1</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -23,8 +23,16 @@
<function>mqseries_put1</function>
(MQPUT1) call puts one message on a queue. The queue need not be open.
</para>
+ <para>
+ You can use both the <function>mqseries_put</function> and
<function>mqseries_put1</function>
+ calls to put messages on a queue; which call to use depends on the circumstances.
+ Use the <function>mqseries_put</function> (MQPUT) call to place multiple messages on
the same queue.
+ Use the <function>mqseries_put1</function> (MQPUT1) call to put only one message on
a queue.
+ This call encapsulates the MQOPEN, MQPUT, and MQCLOSE calls into a single call, minimizing the
+ number of calls that must be issued.
+ </para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -66,7 +74,7 @@
<para>Put message options (MQPMO).</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term>
<parameter>compCode</parameter>
@@ -86,12 +94,12 @@
</variablelist>
</para>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>&return.void;</para>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71433
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71433
------------------------------------------------------------------
Modified: en/reference/mqseries/functions/mqseries-set.xml
By: rjhdby on 2016-12-29 03:24:58
===================================================================
--- en/reference/mqseries/functions/mqseries-set.xml
+++ en/reference/mqseries/functions/mqseries-set.xml
@@ -35,7 +35,7 @@
<variablelist>
<varlistentry>
<term>
- <parameter>hConn</parameter>
+ <parameter>hconn</parameter>
</term>
<listitem>
<para>Connection handle.</para>
@@ -43,6 +43,63 @@
</listitem>
</varlistentry>
<varlistentry>
+ <term>
+ <parameter>hobj</parameter>
+ </term>
+ <listitem>
+ <para>Object handle.</para>
+ <para>This handle represents the object to be used.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>selectorcount</parameter>
+ </term>
+ <listitem>
+ <para>Count of selectors.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>selectors</parameter>
+ </term>
+ <listitem>
+ <para>Array of attribute selectors.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>intattrcount</parameter>
+ </term>
+ <listitem>
+ <para>Count of integer attributes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>intattrs</parameter>
+ </term>
+ <listitem>
+ <para>Array of integer attributes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>charattrlength</parameter>
+ </term>
+ <listitem>
+ <para>Length of character attributes buffer.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <parameter>charattrs</parameter>
+ </term>
+ <listitem>
+ <para>Character attributes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
<term>
<parameter>compCode</parameter>
</term>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71437
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71437
------------------------------------------------------------------
Modified: en/reference/ev/evloop.xml
By: rjhdby on 2017-01-05 23:38:11
===================================================================
--- en/reference/ev/evloop.xml
+++ en/reference/ev/evloop.xml
@@ -19,7 +19,7 @@
</para>
<para>
Having threads we have to create a loop per thread, and use the
- <emphasis>the default loop</emphasis>
+ <emphasis>default loop</emphasis>
in the parent thread.
</para>
<para>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71782
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71782
------------------------------------------------------------------
Modified: en/language/constants.xml
By: rjhdby on 2017-01-08 00:09:53
===================================================================
--- en/language/constants.xml
+++ en/language/constants.xml
@@ -225,7 +225,7 @@
</simpara>
<para>
- There are eight magical constants that change depending on
+ There are nine magical constants that change depending on
where they are used. For example, the value of
<constant>__LINE__</constant> depends on the line that it's
used on in your script. All these "magical" constants are resolved
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71798
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71798
------------------------------------------------------------------
Modified: en/reference/exec/functions/proc-nice.xml
By: rjhdby on 2017-01-08 00:55:23
===================================================================
--- en/reference/exec/functions/proc-nice.xml
+++ en/reference/exec/functions/proc-nice.xml
@@ -110,7 +110,7 @@
<![CDATA[
<?php
// Highest priority
-proc_nice(-20)
+proc_nice(-20);
?>
]]>
</programlisting>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71804
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71804
------------------------------------------------------------------
Modified: en/reference/mcrypt/constants.xml
By: leigh on 2017-01-11 07:16:44
===================================================================
--- en/reference/mcrypt/constants.xml
+++ en/reference/mcrypt/constants.xml
@@ -16,40 +16,40 @@
<listitem>
<simpara>
<constant>MCRYPT_MODE_ECB</constant> (<literal>electronic
- codebook</literal>) is suitable for random data,
- such as encrypting other keys. Since data there is short and random,
- the disadvantages of ECB have a favorable negative effect.
+ codebook</literal>) is a block cipher mode that is generally
+ unsuitable for most purposes. The use of this mode is not recommended.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_CBC</constant> (<literal>cipher block
- chaining</literal>) is especially suitable for
- encrypting files where the security is increased over <literal>ECB</literal>
- significantly.
+ chaining</literal>) is a block cipher mode that is significantly
+ more secure than <literal>ECB</literal> mode.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_CFB</constant> (<literal>cipher
- feedback</literal>) is the best mode for encrypting byte
- streams where single bytes must be encrypted.
+ feedback, in 8-bit mode</literal>) is a stream cipher mode.
+ It is recommended to use <literal>NCFB</literal> mode rather
+ than <literal>CFB</literal> mode.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_OFB</constant> (<literal>output feedback, in
- 8bit</literal>) is comparable to <literal>CFB</literal>, but
+ 8-bit mode</literal>) is a stream cipher mode comparable to
<literal>CFB</literal>, but
can be used in applications where error propagation cannot
- be tolerated. It's insecure (because it operates in 8bit
- mode) so it is not recommended to use it.
+ be tolerated.
+ It is recommended to use <literal>NOFB</literal> mode rather
+ than <literal>OFB</literal> mode.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_NOFB</constant> (<literal>output feedback,
- in nbit</literal>) is comparable to OFB, but
- more secure because it operates on the block size of the algorithm.
+ in n-bit mode</literal>) is comparable to <literal>OFB</literal> mode,
+ but operates on the full block size of the algorithm.
</simpara>
</listitem>
<listitem>
@@ -60,6 +60,25 @@
</listitem>
</itemizedlist>
</para>
+
+ <para>
+ Mcrypt supports some other modes of operation for which there are no predefined constants.
+ They can be utilised by passing a string in place of the missing constants.
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <constant>"ctr"</constant> (<literal>counter mode</literal>)
is a stream cipher mode.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>"ncfb"</constant> (<literal>cipher feedback,
+ in n-bit mode</literal>) is comparable to <literal>CFB</literal> mode,
+ but operates on the full block size of the algorithm.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
<para>
Some other mode and random device constants:
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71828
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71828
------------------------------------------------------------------
Modified: en/reference/ds/ds/sequence/apply.xml
By: rjhdby on 2017-01-13 01:15:00
===================================================================
--- en/reference/ds/ds/sequence/apply.xml
+++ en/reference/ds/ds/sequence/apply.xml
@@ -60,7 +60,7 @@
<programlisting role="php">
<![CDATA[
<?php
-$sequence = new DsVector([1, 2, 3]);
+$sequence = new DsSequence([1, 2, 3]);
$sequence->apply(function($value) { return $value * 2; });
print_r($sequence);
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71841
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71841
------------------------------------------------------------------
Modified: en/appendices/reserved.constants.core.xml
By: anonymous on 2017-01-13 14:39:41
===================================================================
--- en/appendices/reserved.constants.core.xml
+++ en/appendices/reserved.constants.core.xml
@@ -123,7 +123,7 @@
</term>
<listitem>
<simpara>
-
+ The operating system PHP was built for.
</simpara>
</listitem>
</varlistentry>
=> Put this change into your patches : https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=71858
=> Delete this change: https://edit.php.net/?project=php&action=deleteThisChange&idDB=71858
------------------------------------------------------------------
--
https://edit.php.net/
This email is send automatically by the Php Docbook Online Editor.