Re: Contributions are ready for review
| From: | Pasindu De Silva | Date: | Tue, 09 Jan 2018 12:31:09 +0000 |
| Subject: | Re: Contributions are ready for review | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386869@lists.php.net to get a copy of this message | ||
On Mon, Jan 8, 2018 at 9:00 PM, <phpdoc@lists.php.net> wrote:
> 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/phpdbg/reference.xml
> By: Grummfy on 2017-07-06 14:40:49
> ===================================================================
> --- en/reference/phpdbg/reference.xml
> +++ en/reference/phpdbg/reference.xml
> @@ -0,0 +1,42 @@
> +<?xml version="1.0" encoding="utf-8"?>
> +<!-- $Revision: 295472 $ -->
> +
> +<reference xml:id="ref.extname"
> xmlns="http://docbook.org/ns/docbook"
> xmlns:xlink="http://www.w3.org/1999/xlink">
> + <title>PHPDbg &Functions;</title>
> +
> +<!-- Generally should not be used, only in rare cases where you find no
> other place for it.
> + <partintro>
> + <section xml:id="extname.foobar">
> + &reftitle.foobar;
> + <para>
> + Some text here.
> + </para>
> + </section>
> + </partintro>
> +-->
> +
> + &reference.phpdbg.entities.functions;
> +
> +</reference>
> +
> +<!-- 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=74455
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=74455
>
> ------------------------------
> ------------------------------------
>
> New file: en/reference/phpdbg/book.xml
> By: Grummfy on 2017-07-06 14:46:58
> ===================================================================
> --- en/reference/phpdbg/book.xml
> +++ en/reference/phpdbg/book.xml
> @@ -0,0 +1,43 @@
> +<?xml version="1.0" encoding="utf-8"?>
> +<!-- $Revision: 295472 $ -->
> +
> +<book xml:id="book.extname"
> xmlns="http://docbook.org/ns/docbook"
> xmlns:xlink="http://www.w3.org/1999/xlink">
> + <title>PHPDbg</title>
> + <titleabbrev>PHPDbg</titleabbrev>
> +
> + <!-- {{{ preface -->
> + <preface xml:id="intro.extname">
> + &reftitle.intro;
> + <para>
> + Implemented as a SAPI module, phpdbg can exert complete control over
> the environment without impacting the functionality or performance of your
> code.
> + </para>
> + </preface>
> + <!-- }}} -->
> +
> + &reference.phpdbg.setup;
> + &reference.phpdbg.cli;
> + &reference.phpdbg.reference;
> +
> +</book>
> +
> +<!-- 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=74454
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=74454
>
> ------------------------------
> ------------------------------------
>
> New file: en/reference/phpdbg/setup.xml
> By: Grummfy on 2017-07-06 14:47:12
> ===================================================================
> --- en/reference/phpdbg/setup.xml
> +++ en/reference/phpdbg/setup.xml
> @@ -0,0 +1,59 @@
> +<?xml version="1.0" encoding="utf-8"?>
> +<!-- $Revision: 295472 $ -->
> +
> +<chapter xml:id="phpdbg.setup"
> xmlns="http://docbook.org/ns/docbook"
> xmlns:xlink="http://www.w3.org/1999/xlink">
> + &reftitle.setup;
> +
> + <!-- {{{ Requirements -->
> + <section xml:id="phpdbg.requirements">
> + &reftitle.required;
> + &no.requirement;
> + </section>
> + <!-- }}} -->
> +
> + <!-- {{{ Installation -->
> + <section xml:id="phpdbg.installation">
> + &reftitle.install;
> + &no.install;
> + </section>
> + <!-- or &reference.phpdbg.entities.configure; -->
> + <!-- }}} -->
> +
> + <!-- {{{ Configuration -->
> + <section xml:id="phpdbg.configuration">
> + &reftitle.runtime;
> + &no.config;
> + </section>
> + <!-- or &reference.phpdbg.entities.ini; -->
> + <!-- }}} -->
> +
> + <!-- {{{ Resources -->
> + <section xml:id="phpdbg.resources">
> + &reftitle.resources;
> + &no.resource;
> + </section>
> + <!-- }}} -->
> +
> +</chapter>
> +
> +<!-- 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=74456
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=74456
>
> ------------------------------
> ------------------------------------
>
> New file: en/reference/phpdbg/functions/phpdbg-start-oplog.xml
> By: Grummfy on 2017-07-06 15:13:23
> ===================================================================
> --- en/reference/phpdbg/functions/phpdbg-start-oplog.xml
> +++ en/reference/phpdbg/functions/phpdbg-start-oplog.xml
> @@ -0,0 +1,46 @@
> +<?xml version="1.0" encoding="utf-8"?>
> +<!-- $Revision: 299488 $ -->
> +
> +<refentry xml:id="function.phpdbg-start-oplog" xmlns="
> http://docbook.org/ns/docbook"
> xmlns:xlink="http://www.w3.org/1999/xlink">
> + <refnamediv>
> + <refname>phpdbg_start_oplog</refname>
> + <refpurpose>Start registring code coverage</refpurpose>
> + </refnamediv>
> +
> + <refsect1 role="description">
> + &reftitle.description;
> + <methodsynopsis>
> + <type>void</type><methodname>phpdbg_start_oplog</methodname>
> + <void/>
> + </methodsynopsis>
> + </refsect1>
> +
> + <refsect1 role="returnvalues">
> + &reftitle.returnvalues;
> + <para>
> + No return value.
> + </para>
> + </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=74458
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=74458
>
> ------------------------------
> ------------------------------------
>
> New file: en/reference/ftp/functions/ftp-mlsd.xml
> By: anonymous on 2017-12-12 06:15:44
> ===================================================================
> --- en/reference/ftp/functions/ftp-mlsd.xml
> +++ en/reference/ftp/functions/ftp-mlsd.xml
> @@ -0,0 +1,205 @@
> +<?xml version="1.0" encoding="utf-8"?>
> +<!-- $Revision: 297028 $ -->
> +<refentry xml:id="function.ftp-mlsd" xmlns="
> 9.:v^http://docbook.org/ns/docbook
> ">
> + <refnamediv>
> + <refname>ftp_mlsd</refname>
> + <refpurpose>Returns a list of files in the given directory</refpurpose>
> + </refnamediv>
> + <refsect1 role="description">
> + &reftitle.description;
> + <methodsynopsis>
> + <type>array</type><methodname>ftp_mlsd</methodname>
> + <methodparam><type>resource</type><parameter>ftp_stream</
> parameter></methodparam>
> + <methodparam><type>string</type><parameter>directory</
> parameter></methodparam>
> + </methodsynopsis>
> + </refsect1>
> + <refsect1 role="parameters">
> + &reftitle.parameters;
> + <para>
> + <variablelist>
> + <varlistentry>
> + <term><parameter>ftp_stream</parameter></term>
> + <listitem>
> + <para>
> + The link identifier of the FTP connection.
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term><parameter>directory</parameter></term>
> + <listitem>
> + <para>
> + The directory to be listed.
> + </para>
> + </listitem>
> + </varlistentry>
> + </variablelist>
> + </para>
> + </refsect1>
> + <refsect1 role="returnvalues">
> + &reftitle.returnvalues;
> + <para>
> + Returns an array of arrays with file infos from the specified
> directory on success or
> + &false; on error.
> + </para>
> + </refsect1>
> + <refsect1 role="examples">
> + &reftitle.examples;
> + <para>
> + <example>
> + <title><function>ftp_mlsd</function> example</title>
> + <programlisting role="php">
> +<![CDATA[
> +<?php
> +
> +// set up basic connection
> +$conn_id = ftp_connect($ftp_server);
> +
> +// login with username and password
> +$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
> +
> +// get contents of the current directory
> +$contents = ftp_mlsd($conn_id, ".");
> +
> +// output $contents
> +var_dump($contents);
> +
> +?>
> +]]>
> + </programlisting>
> + &example.outputs.similar;
> + <screen>
> +<![CDATA[
> +array(5) {
> + [0]=>
> + array(8) {
> + ["name"]=>
> + string(1) "."
> + ["modify"]=>
> + string(14) "20171212154511"
> + ["perm"]=>
> + string(7) "flcdmpe"
> + ["type"]=>
> + string(4) "cdir"
> + ["unique"]=>
> + string(11) "811U5740002"
> + ["UNIX.group"]=>
> + string(2) "33"
> + ["UNIX.mode"]=>
> + string(4) "0755"
> + ["UNIX.owner"]=>
> + string(2) "33"
> + }
> + [1]=>
> + array(8) {
> + ["name"]=>
> + string(2) ".."
> + ["modify"]=>
> + string(14) "20171212154511"
> + ["perm"]=>
> + string(7) "flcdmpe"
> + ["type"]=>
> + string(4) "pdir"
> + ["unique"]=>
> + string(11) "811U5740002"
> + ["UNIX.group"]=>
> + string(2) "33"
> + ["UNIX.mode"]=>
> + string(4) "0755"
> + ["UNIX.owner"]=>
> + string(2) "33"
> + }
> + [2]=>
> + array(8) {
> + ["name"]=>
> + string(11) "public_html"
> + ["modify"]=>
> + string(14) "20171211171525"
> + ["perm"]=>
> + string(7) "flcdmpe"
> + ["type"]=>
> + string(3) "dir"
> + ["unique"]=>
> + string(11) "811U5740525"
> + ["UNIX.group"]=>
> + string(2) "33"
> + ["UNIX.mode"]=>
> + string(4) "0755"
> + ["UNIX.owner"]=>
> + string(2) "33"
> + }
> + [3]=>
> + array(8) {
> + ["name"]=>
> + string(10) "public_ftp"
> + ["modify"]=>
> + string(14) "20171211174536"
> + ["perm"]=>
> + string(7) "flcdmpe"
> + ["type"]=>
> + string(3) "dir"
> + ["unique"]=>
> + string(11) "811U57405EE"
> + ["UNIX.group"]=>
> + string(2) "33"
> + ["UNIX.mode"]=>
> + string(4) "0755"
> + ["UNIX.owner"]=>
> + string(2) "33"
> + }
> + [4]=>
> + array(8) {
> + ["name"]=>
> + string(3) "www"
> + ["modify"]=>
> + string(14) "www"
> + ["perm"]=>
> + string(7) "flcdmpe"
> + ["type"]=>
> + string(3) "dir"
> + ["unique"]=>
> + string(11) "811U5740780"
> + ["UNIX.group"]=>
> + string(2) "33"
> + ["UNIX.mode"]=>
> + string(4) "0755"
> + ["UNIX.owner"]=>
> + string(2) "33"
> + }
> +}
> +]]>
> + </screen>
> + </example>
> + </para>
> + </refsect1>
> + <refsect1 role="seealso">
> + &reftitle.seealso;
> + <para>
> + <simplelist>
> + <member><function>ftp_rawlist</function></member>
> + <member><function>ftp_nlist</function></member>
> + </simplelist>
> + </para>
> + </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=77328
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=77328
>
> ------------------------------
> ------------------------------------
>
> 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/ibase/functions/ibase-delete-user.xml
> By: on 2017-07-07 04:09:46
> ===================================================================
> --- en/reference/ibase/functions/ibase-delete-user.xml
> +++ en/reference/ibase/functions/ibase-delete-user.xml
> @@ -14,10 +14,32 @@
> <methodparam><type>string</type><parameter>user_name</
> parameter></methodparam>
> </methodsynopsis>
>
> - &warn.undocumented.func;
> -
> </refsect1>
>
> + <refsect1 role="parameters">
> + &reftitle.parameters;
> + <para>
> + <variablelist>
> + <varlistentry>
> + <term><parameter>service_handle</parameter></term>
> + <listitem>
> + <para>
> + The handle on the database server service.
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term><parameter>user_name</parameter></term>
> + <listitem>
> + <para>
> + The login name of the user you want to delete from database.
> + </para>
> + </listitem>
> + </varlistentry>
> + </variablelist>
> + </para>
> + </refsect1>
> +
> <refsect1 role="returnvalues">
> &reftitle.returnvalues;
> <para>
>
>
> => Put this change into your patches :
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=74462d
> H\6Q
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=74462
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ibase/functions/ibase-modify-user.xml
> By: on 2017-07-07 04:11:50
> ===================================================================
> --- en/reference/ibase/functions/ibase-modify-user.xml
> +++ en/reference/ibase/functions/ibase-modify-user.xml
> @@ -17,9 +17,64 @@
> <methodparam
> choice="opt"><type>string</type><parameter>middle_name</
> parameter></methodparam>
> <methodparam
> choice="opt"><type>string</type><parameter>last_name</
> parameter></methodparam>
> </methodsynopsis>
> - &warn.undocumented.func;
> </refsect1>
>
> + <refsect1 role="parameters">
> + &reftitle.parameters;
> + <para>
> + <variablelist>
> + <varlistentry>
> + <term><parameter>service_handle</parameter></term>
> + <listitem>
> + <para>
> + The handle on the database server service.
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term><parameter>user_name</parameter></term>
> + <listitem>
> + <para>
> + The login name of the database user to modify.
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term><parameter>password</parameter></term>
> + <listitem>
> + <para>
> + The user's new password.
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term><parameter>first_name</parameter></term>
> + <listitem>
> + <para>
> + The user's new first name.
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term><parameter>middle_name</parameter></term>
> + <listitem>
> + <para>
> + The user's new middle name.
> + </para>
> + </listitem>
> + </varlistentry>
> + <varlistentry>
> + <term><parameter>last_name</parameter></term>
> + <listitem>
> + <para>
> + The user's new last name.
> + </para>
> + </listitem>
> + </varlistentry>
> + </variablelist>
> + </para>
> + </refsect1>
> +
> <refsect1 role="returnvalues">
> &reftitle.returnvalues;
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=74463
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=74463
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/json/jsonserializable/jsonserialize.xml
> By: Trent Harvey on 2017-08-21 14:06:28
> ===================================================================
> --- en/reference/json/jsonserializable/jsonserialize.xml
> +++ en/reference/json/jsonserializable/jsonserialize.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
>
> <type>mixed</type><methodname>JsonSerializable::jsonSerialize</methodname>
> + <modifier>public</modifier> <type>mixed</type><methodname>
> JsonSerializable::jsonSerialize</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75063
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75063
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/arrayaccess/offsetexists.xml
> By: Trent Harvey on 2017-08-21 14:14:28
> ===================================================================
> --- en/language/predefined/arrayaccess/offsetexists.xml
> +++ en/language/predefined/arrayaccess/offsetexists.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>boolean</type><methodname>ArrayAccess::offsetExists</methodname>
> + <modifier>public</modifier> <type>boolean</type><
> methodname>ArrayAccess::offsetExists</methodname>
> <methodparam><type>mixed</type><parameter>offset</
> parameter></methodparam>
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75064
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75064
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/arrayaccess/offsetget.xml
> By: Trent Harvey on 2017-08-21 14:14:31
> ===================================================================
> --- en/language/predefined/arrayaccess/offsetget.xml
> +++ en/language/predefined/arrayaccess/offsetget.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>mixed</type><methodname>ArrayAccess::offsetGet</methodname>
> + <modifier>public</modifier> <type>mixed</type><methodname>
> ArrayAccess::offsetGet</methodname>
> <methodparam><type>mixed</type><parameter>offset</
> parameter></methodparam>
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75065
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75065
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/arrayaccess/offsetset.xml
> By: Trent Harvey on 2017-08-21 14:14:46
> ===================================================================
> --- en/language/predefined/arrayaccess/offsetset.xml
> +++ en/language/predefined/arrayaccess/offsetset.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>void</type><methodname>ArrayAccess::offsetSet</methodname>
> + <modifier>public</modifier> <type>void</type><methodname>
> ArrayAccess::offsetSet</methodname>
> <methodparam><type>mixed</type><parameter>offset</
> parameter></methodparam>
> <methodparam><type>mixed</type><parameter>value</
> parameter></methodparam>
> </methodsynopsis>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75066
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75066
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/arrayaccess/offsetunset.xml
> By: Trent Harvey on 2017-08-21 14:14:53
> ===================================================================
> --- en/language/predefined/arrayaccess/offsetunset.xml
> +++ en/language/predefined/arrayaccess/offsetunset.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>void</type><methodname>ArrayAccess::offsetUnset</methodname>
> + <modifier>public</modifier> <type>void</type><methodname>
> ArrayAccess::offsetUnset</methodname>
> <methodparam><type>mixed</type><parameter>offset</
> parameter></methodparam>
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
> h
> CLR=+ahttps://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75067
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75067
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/serializable/unserialize.xml
> By: Trent Harvey on 2017-08-21 14:16:23
> ===================================================================
> --- en/language/predefined/serializable/unserialize.xml
> +++ en/language/predefined/serializable/unserialize.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>void</type><methodname>Serializable::unserialize</methodname>
> + <modifier>public</modifier> <type>void</type><methodname>
> Serializable::unserialize</methodname>
> <methodparam><type>string</type><parameter>serialized</
> parameter></methodparam>
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75068
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75068
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/serializable/serialize.xml
> By: Trent Harvey on 2017-08-21 14:16:28
> ===================================================================
> --- en/language/predefined/serializable/serialize.xml
> +++ en/language/predefined/serializable/serialize.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>string</type><methodname>Serializable::serialize</methodname>
> + <modifier>public</modifier> <type>string</type><
> methodname>Serializable::serialize</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75069
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75069
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/iterator/current.xml
> By: Trent Harvey on 2017-08-21 14:17:08
> ===================================================================
> --- en/language/predefined/iterator/current.xml
> +++ en/language/predefined/iterator/current.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>mixed</type><methodname>Iterator::current</methodname>
> + <modifier>public</modifier> <type>mixed</type><methodname>
> Iterator::current</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75070n<7Cs
>
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75070
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/iterator/key.xml
> By: Trent Harvey on 2017-08-21 14:17:14
> ===================================================================
> --- en/language/predefined/iterator/key.xml
> +++ en/language/predefined/iterator/key.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>scalar</type><methodname>Iterator::key</methodname>
> + <modifier>public</modifier> <type>scalar</type><
> methodname>Iterator::key</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75071
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75071
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/iterator/next.xml
> By: Trent Harvey on 2017-08-21 14:17:22
> ===================================================================
> --- en/language/predefined/iterator/next.xml
> +++ en/language/predefined/iterator/next.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>void</type><methodname>Iterator::next</methodname>
> + <modifier>public</modifier> <type>void</type><methodname>
> Iterator::next</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75072
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75072
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/iterator/rewind.xml
> By: Trent Harvey on 2017-08-21 14:17:30
> ===================================================================
> --- en/language/predefined/iterator/rewind.xml
> +++ en/language/predefined/iterator/rewind.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>void</type><methodname>Iterator::rewind</methodname>
> + <modifier>public</modifier> <type>void</type><methodname>
> Iterator::rewind</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75073
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75073
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/iterator/valid.xml
> By: Trent Harvey on 2017-08-21 14:17:38
> ===================================================================
> --- en/language/predefined/iterator/valid.xml
> +++ en/language/predefined/iterator/valid.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>boolean</type><methodname>Iterator::valid</methodname>
> + <modifier>public</modifier> <type>boolean</type><
> methodname>Iterator::valid</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75074
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75074
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/throwable/getcode.xml
> By: Trent Harvey on 2017-08-21 14:18:57
> ===================================================================
> --- en/language/predefined/throwable/getcode.xml
> +++ en/language/predefined/throwable/getcode.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>int</type><methodname>Throwable::getCode</methodname>
> + <modifier>public</modifier> <type>int</type><methodname>
> Throwable::getCode</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75075
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75075
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/throwable/getfile.xml
> By: Trent Harvey on 2017-08-21 14:19:05
> ===================================================================
> --- en/language/predefined/throwable/getfile.xml
> +++ en/language/predefined/throwable/getfile.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>string</type><methodname>Throwable::getFile</methodname>
> + <modifier>public</modifier> <type>string</type><
> methodname>Throwable::getFile</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75076
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75076
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/throwable/getline.xml
> By: Trent Harvey on 2017-08-21 14:19:14
> ===================================================================
> --- en/language/predefined/throwable/getline.xml
> +++ en/language/predefined/throwable/getline.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>int</type><methodname>Throwable::getLine</methodname>
> + <modifier>public</modifier> <type>int</type><methodname>
> Throwable::getLine</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75077
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75077
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/throwable/getmessage.xml
> By: Trent Harvey on 2017-08-21 14:19:23
> ===================================================================
> --- en/language/predefined/throwable/getmessage.xml
> +++ en/language/predefined/throwable/getmessage.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>string</type><methodname>Throwable::getMessage</methodname>
> + <modifier>public</modifier>
> <type>string</type><methodname>Throwable::
> getMessage</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75078
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75078
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/throwable/getprevious.xml
> By: Trent Harvey on 2017-08-21 14:19:31
> ===================================================================
> --- en/language/predefined/throwable/getprevious.xml
> +++ en/language/predefined/throwable/getprevious.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>Throwable</type><methodname>Throwable::getPrevious</methodname>
> + <modifier>public</modifier> <type>Throwable</type><
> methodname>Throwable::getPrevious</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75079
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75079
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/throwable/gettrace.xml
> By: Trent Harvey on 2017-08-21 14:19:40
> ===================================================================
> --- en/language/predefined/throwable/gettrace.xml
> +++ en/language/predefined/throwable/gettrace.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>array</type><methodname>Throwable::getTrace</methodname>
> + <modifier>public</modifier> <type>array</type><methodname>
> Throwable::getTrace</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75080
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75080
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/throwable/gettraceasstring.xml
> By: Trent Harvey on 2017-08-21 14:19:49
> ===================================================================
> --- en/language/predefined/throwable/gettraceasstring.xml
> +++ en/language/predefined/throwable/gettraceasstring.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>string</type><methodname>Throwable::getTraceAsString</methodname>
> + <modifier>public</modifier>
> <type>string</type><methodname>Throwable::
> getTraceAsString</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75081
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75081
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/throwable/tostring.xml
> By: Trent Harvey on 2017-08-21 14:19:56
> ===================================================================
> --- en/language/predefined/throwable/tostring.xml
> +++ en/language/predefined/throwable/tostring.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>string</type><methodname>Throwable::__toString</methodname>
> + <modifier>public</modifier> <type>string</type><
> methodname>Throwable::__toString</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75082
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75082
>
> ------------------------------
> ------------------------------------
>
> Modified: en/language/predefined/iteratoraggregate/getiterator.xml
> By: Trent Harvey on 2017-08-21 14:20:10
> ===================================================================
> --- en/language/predefined/iteratoraggregate/getiterator.xml
> +++ en/language/predefined/iteratoraggregate/getiterator.xml
> @@ -10,7 +10,7 @@
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> - <modifier>abstract</modifier> <modifier>public</modifier>
> <type>Traversable</type><methodname>IteratorAggregate::
> getIterator</methodname>
> + <modifier>public</modifier> <type>Traversable</type><
> methodname>IteratorAggregate::getIterator</methodname>
> <void />
> </methodsynopsis>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75083
> => Delete this change: https://edit.php.net/?project=
> <\ph
> php&action=deleteThisChange&idDB=75083
>
>
The commit message for the above patch is - Pre-defined interfaces such as
ArrayAccess and JsonSerializable incorrectly spec'd their method signatures
as "abstract". They are interfaces and not classes and cannot have
"abstract" methods. Because they are interfaces it is assumed they are
"abstract" and have no concrete implementation in their definition and must
be implemented by the class which uses it.
Is abstracts in interfaces a convention in docs to be more verbose ?
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/var/functions/settype.xml
> By: Siim Kallari on 2017-08-25 23:00:06
> ===================================================================
> --- en/reference/var/functions/settype.xml
> +++ en/reference/var/functions/settype.xml
> @@ -5,7 +5,7 @@
> <refname>settype</refname>
> <refpurpose>Set the type of a variable</refpurpose>
> </refnamediv>
> -
> +
> <refsect1 role="description">
> &reftitle.description;
> <methodsynopsis>
> @@ -18,7 +18,7 @@
> <parameter>type</parameter>.
> </para>
> </refsect1>
> -
> +
> <refsect1 role="parameters">
> &reftitle.parameters;
> <para>
> @@ -79,14 +79,22 @@
> </variablelist>
> </para>
> </refsect1>
> -
> +
> <refsect1 role="returnvalues">
> &reftitle.returnvalues;
> +
> + <refsect1 role="returnvalues"><!-- {{{ -->
> + &reftitle.returnvalues;
> + <para>
> + What this function returns, first on success, then failure.
> + If simply true on success and false on failure, just use
> &return.success; here.
> + </para>
> + </refsect1><!-- }}} -->
> <para>
> - &return.success;
> + Returns true on success or emits PHP Warning on failure.
> </para>
> </refsect1>
> -
> +
> <refsect1 role="examples">
> &reftitle.examples;
> <para>
> @@ -97,16 +105,18 @@
> <?php
> $foo = "5bar"; // string
> $bar = true; // boolean
> +$baz = 123; // integer
>
> settype($foo, "integer"); // $foo is now 5 (integer)
> settype($bar, "string"); // $bar is now "1" (string)
> +settype($baz, "baz"); // PHP warning: settype(): Invalid type on line 1
> ?>
> ]]>
> </programlisting>
> </example>
> </para>
> </refsect1>
> -
> +
> <refsect1 role="notes">
> &reftitle.notes;
> <note>
> @@ -115,7 +125,7 @@
> </para>
> </note>
> </refsect1>
> -
> +
> <refsect1 role="seealso">
> &reftitle.seealso;
> <para>
> @@ -126,7 +136,7 @@
> </simplelist>
> </para>
> </refsect1>
> -
> +
> </refentry>
>
> <!-- Keep this comment at the end of the file
>
>
> => Put this change into your patches :
> T*`
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75108
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75108
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/strings/functions/addslashes.xml
> By: Stefan on 2017-08-30 10:52:32
> ===================================================================
> --- en/reference/strings/functions/addslashes.xml
> +++ en/reference/strings/functions/addslashes.xml
> @@ -13,48 +13,45 @@
> <methodparam><type>string</type><parameter>str</
> parameter></methodparam>
> </methodsynopsis>
> <para>
> - Returns a string with backslashes before characters that need to be
> - escaped. These characters are single quote (<literal>'</literal>),
> - double quote (<literal>"</literal>), backslash
> - (<literal></literal>) and NUL (the &null; byte).
> + Returns a string with backslashes added before characters that need to
> be
> + escaped. These characters are:
> + <simplelist>
> + <member>single quote (<literal>'</literal>)</member>
> + <member>double quote (<literal>"</literal>)</member>
> + <member>backslash (<literal></literal>)</member>
> + <member>NUL (the &null; byte)</member>
> + </simplelist>
> </para>
> <para>
> - An example use of <function>addslashes</function> is when you're
> - entering data into string that is evaluated by PHP. For example,
> - <literal>O'Reilly</literal> is stored in $str, you need to escape
> - $str. (e.g. eval("echo '".addslashes($str)."';"); )
> + A use case of <function>addslashes</function> is escaping the
> aforementioned
> + characters in a string that is to be evaluated by PHP:
> + <informalexample>
> + <programlisting role="php">
> +<![CDATA[
> +<?php
> +$str = "O'Reilly?";
> +eval("echo '" . addslashes($str) . "';");
> +?>
> +]]>
> + </programlisting>
> + </informalexample>
> </para>
> <para>
> - To escape database parameters, DBMS specific escape function
> - (e.g. <function>mysqli_real_escape_string</function> for MySQL or
> - <function>pg_escape_literal</function>, <function>pg_escape_string</
> function>
> - for PostgreSQL) should be used for security reasons. DBMSes have
> - differect escape specification for identifiers (e.g. Table name,
> - field name) than parameters. Some DBMS such as PostgreSQL provides
> - identifier escape
> - function, <function>pg_escape_identifier</function>, but not all
> - DBMS provides identifier escape API. If this is the case, refer to
> - your database system manual for proper escaping method.
> + To escape database parameters, DBMS-specific escape functions
> + should be used, for security reasons. Note that DBMS can have
> + different escape functions for parameters and identifiers
> + (table names/columns etc.).
> + See the <refs>database</refs> page for a full list of supported
> + database extensions and plugins.
> </para>
> <para>
> - If your DBMS doesn't have an escape function and the DBMS
> - uses <literal></literal> to escape special chars, you might be
> - able to use this function only when this escape method is adequate for
> - your database. Please note that use
> - of <function>addslashes</function> for database parameter escaping
> - can be cause of security issues on most databases.
> - </para>
> - <para>
> - The PHP directive <link linkend="ini.magic-quotes-gpc">
> - magic_quotes_gpc</link> was <literal>on</literal> by default before
> - PHP 5.4, and it essentially ran <function>addslashes</function> on
> - all GET, POST, and COOKIE data. Do not
> - use <function>addslashes</function> on strings that have already
> - been escaped with
> - <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> as
> you'll
> - then do double escaping. The function
> - <function>get_magic_quotes_gpc</function> may come in handy for
> - checking this.
> + Prior to PHP 5.4.0, the PHP directive <link
> linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>
> + was <literal>on</literal> by default and it essentially ran
> <function>addslashes</function>
> + on all GET, POST and COOKIE data.
> + <function>addslashes</function> must not be used on strings that have
> already
> + been escaped with <link linkend="ini.magic-quotes-gpc"
> >magic_quotes_gpc</link>,
> + as the strings will be double escaped.
> <function>get_magic_quotes_gpc</function>
> can be used to check
> + if <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> is
> <literal>on</literal>.
> </para>
> </refsect1>
>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75172
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75172
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ftp/functions/ftp-set-option.xml
> By: Jeroen Spee on 2017-09-26 05:07:44
> ===================================================================
> --- en/reference/ftp/functions/ftp-set-option.xml
> +++ en/reference/ftp/functions/ftp-set-option.xml
> @@ -56,6 +56,13 @@
> This is enabled by default.
> </entry>
> </row>
> + <row>
> + <entry><constant>FTP_USEPASVADDRESS</constant></entry>
> + <entry>
> + When disabled, PHP will ignore the IP address returned by the
> FTP server in response to the PASV command and instead use the IP address
> that was supplied in the ftp_connect().
> + <parameter>value</parameter> must be a boolean.
> + </entry>
> + </row>
> </tbody>
> </tgroup>
> </table>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75682
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75682
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/spl/recursivedirectoryiterator/getsubpath.xml
> By: Tim Siebels on 2017-10-12 05:58:37
> ===================================================================
> --- en/reference/spl/recursivedirectoryiterator/getsubpath.xml
> +++ en/reference/spl/recursivedirectoryiterator/getsubpath.xml
> @@ -14,11 +14,8 @@
> <void />
> </methodsynopsis>
> <para>
> - Gets the sub path.
> + Returns the sub path relative to the directory given in the
> constructor.
> </para>
> -
> - &warn.undocumented.func;
> -
> </refsect1>
>
> <refsect1 role="parameters">
> @@ -29,7 +26,44 @@
> <refsect1 role="returnvalues">
> &reftitle.returnvalues;
> <para>
> - The sub path (sub directory).
> + The sub path.
> + </para>
> + </refsect1>
> +
> + <refsect1 role="examples">
> + &reftitle.examples;
> + <para>
> + <example xml:id="function-name.example.basic">
> + <title><function>getSubPath</function> example</title>
> + <para>
> +
> + </para>
> + <programlisting role="php">
> + <![CDATA[
> + $directory = '/tmp';
> +
> + $it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($
> directory));
> +
> + foreach ($it as $file) {
> + echo 'SubPathName: ' . $it->getSubPathName() . "n";
> + echo 'SubPath: ' . $it->getSubPath() . "nn";
> + }
> + ]]>
> + </programlisting>
> + &example.outputs.similar;
> + <screen>
> + <![CDATA[
> + SubPathName: fruit/apple.xml
> + SubPath: fruit
> +
> + SubPathName: stuff.xml
> + SubPath:
> +
> + SubPathName: veggies/carrot.xml
> + SubPath: veggies
> + ]]>
> + </screen>
> + </example>
> </para>
> </refsect1>
>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75835
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75835
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/spl/recursivedirectoryiterator/getsubpathname.xml
> By: Tim Siebels on 2017-10-12 06:01:50
> ===================================================================
> --- en/reference/spl/recursivedirectoryiterator/getsubpathname.xml
> +++ en/reference/spl/recursivedirectoryiterator/getsubpathname.xml
> @@ -16,9 +16,6 @@
> <para>
> Gets the sub path and filename.
> </para>
> -
> - &warn.undocumented.func;
> -
> </refsect1>
>
> <refsect1 role="parameters">
> @@ -32,6 +29,43 @@
> The sub path (sub directory) and filename.
> </para>
> </refsect1>
> +
> + <refsect1 role="examples">
> + &reftitle.examples;
> + <para>
> + <example xml:id="function-name.example.basic">
> + <title><function>getSubPathname</function> example</title>
> + <para>
> +
> + </para>
> + <programlisting role="php">
> + <![CDATA[
> + $directory = '/tmp';
> +
> + $it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($
> directory));
> +
> + foreach ($it as $file) {
> + echo 'SubPathName: ' . $it->getSubPathName() . "n";
> + echo 'SubPath: ' . $it->getSubPath() . "nn";
> + }
> + ]]>
> + </programlisting>
> + &example.outputs.similar;
> + <screen>
> + <![CDATA[
> + SubPathName: fruit/apple.xml
> + SubPath: fruit
> +
> + SubPathName: stuff.xml
> + SubPath:
> +
> + SubPathName: veggies/carrot.xml
> + SubPath: veggies
> + ]]>
> + </screen>
> + </example>
> + </para>
> + </refsect1>
>
> <refsect1 role="seealso">
> &reftitle.seealso;
>
>
> => Put this change into your patches :
> F
> C0; j&Qhttps://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75836
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75836
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/info/functions/get-included-files.xml
> By: Kevin Abel on 2017-10-14 14:01:33
> ===================================================================
> --- en/reference/info/functions/get-included-files.xml
> +++ en/reference/info/functions/get-included-files.xml
> @@ -73,16 +73,6 @@
> </para>
> </refsect1>
>
> - <refsect1 role="notes">
> - &reftitle.notes;
> - <note>
> - <para>
> - Files included using the <literal>auto_prepend_file</literal>
> - configuration directive are not included in the returned array.
> - </para>
> - </note>
> - </refsect1>
> -
> <refsect1 role="seealso">
> &reftitle.seealso;
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75873
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75873
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/yaf/yaf-route-regex.xml
> By: anonymous on 2017-10-16 19:25:46
> ===================================================================
> --- en/reference/yaf/yaf-route-regex.xml
> +++ en/reference/yaf/yaf-route-regex.xml
> @@ -33,7 +33,7 @@
>
> <ooclass>
> <modifier>extends</modifier>
> - <classname>Yaf_Route_Interface</classname>
> + <classname>Yaf_Route</classname>
> </ooclass>
>
> <oointerface>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=75883
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=75883
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ldap/functions/ldap-modify.xml
> By: mcmic on 2017-11-09 04:57:12
> ===================================================================
> --- en/reference/ldap/functions/ldap-modify.xml
> +++ en/reference/ldap/functions/ldap-modify.xml
> @@ -1,5 +1,5 @@
> <?xml version="1.0" encoding="utf-8"?>
> -<!-- $Revision: 343425 $ -->
> +<!-- $Revision: 297028 $ -->
> <refentry xml:id="function.ldap-modify"
> xmlns="http://docbook.org/ns/
> docbook">
> <refnamediv>
> <refname>ldap_modify</refname>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=76254
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=76254
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ldap/functions/ldap-mod-add.xml
> By: mcmic on 2017-11-09 05:19:02
> ===================================================================
> --- en/reference/ldap/functions/ldap-mod-add.xml
> +++ en/reference/ldap/functions/ldap-mod-add.xml
> @@ -1,5 +1,5 @@
> <?xml version="1.0" encoding="utf-8"?>
> -<!-- $Revision: 343425 $ -->
> +<!-- $Revision: 297028 $ -->
> <refentry xml:id="function.ldap-mod-add"
> xmlns="http://docbook.org/ns/
> docbook">
> <refnamediv>
> <refname>ldap_mod_add</refname>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=76256
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=76256
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ldap/functions/ldap-mod-del.xml
> By: mcmic on 2017-11-09 05:19:08
> ===================================================================
> --- en/reference/ldap/functions/ldap-mod-del.xml
> +++ en/reference/ldap/functions/ldap-mod-del.xml
> @@ -1,5 +1,5 @@
> <?xml version="1.0" encoding="utf-8"?>
> -<!-- $Revision: 343425 $ -->
> +<!-- $Revision: 297028 $ -->
> <refentry xml:id="function.ldap-mod-del"
> xmlns="http://docbook.org/ns/
> docbook">
> <refnamediv>
> <refname>ldap_mod_del</refname>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=76257
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=76257
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ldap/functions/ldap-mod-replace.xml
> By: mcmic on 2017-11-09 05:19:52
> ===================================================================
> --- en/reference/ldap/functions/ldap-mod-replace.xml
> +++ en/reference/ldap/functions/ldap-mod-replace.xml
> @@ -1,5 +1,5 @@
> <?xml version="1.0" encoding="utf-8"?>
> -<!-- $Revision: 343425 $ -->
> +<!-- $Revision: 297028 $ -->
> <refentry xml:id="function.ldap-mod-replace" xmlns="
> http://docbook.org/ns/docbook">
> <refnamediv>
> <refname>ldap_mod_replace</refname>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=76255
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=76255
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/classobj/functions/get-class.xml
> By: Sergey Podgornyy on 2017-11-28 22:56:33
> ===================================================================
> --- en/reference/classobj/functions/get-class.xml
> +++ en/reference/classobj/functions/get-class.xml
> @@ -49,7 +49,7 @@
> object.
> </para>
> <para>
> - If <parameter>object</parameter> is omitted when inside a class, the
> + If <parameter>object</parameter> is omitted or equals &null; (before
> PHP 7.2.0) when inside a class, the
> name of that class is returned.
> </para>
> <para>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=76703
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=76703
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ldap/functions/ldap-connect.xml
> By: Mesut Vatansever on 2017-12-01 04:19:48
> ===================================================================
> --- en/reference/ldap/functions/ldap-connect.xml
> +++ en/reference/ldap/functions/ldap-connect.xml
> @@ -17,11 +17,13 @@
> Creates an LDAP link identifier and checks whether the given
> <parameter>host</parameter> and <parameter>port</parameter> are
> plausible.
> </para>
> - <para>
> - Note: This function does <emphasis>not</emphasis> open a connection.
> - It checks whether the given parameters are plausible and can be used
> - to open a connection as soon as one is needed.
> - </para>
> + <note>
> + <simpara>
> + Note: This function does <emphasis>not</emphasis> open a connection.
> + It checks whether the given parameters are plausible and can be used
> + to open a connection as soon as one is needed.
> + </simpara>
> + </note>
> </refsect1>
>
> <refsect1 role="parameters">
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=76897
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=76897
>
> ------------------------------
> ------------------------------------
>
> Modified: en/chapters/intro.xml
> By: Barb H. on 2017-12-01 18:38:55
> ===================================================================
> --- en/chapters/intro.xml
> +++ en/chapters/intro.xml
> @@ -31,39 +31,55 @@
> ?>
>
> </body>
> + <refsect1 role="description"><!-- {{{ -->
> + &reftitle.description;
> + <methodsynopsis>
> + <!-- Example: All functions have this -->
> + <type>thereturned type</type><methodname>func_name</methodname>
> + <!-- Example: Required parameter -->
> + <methodparam><type>param1type</type><parameter>
> firstparameter</parameter></methodparam>
> + <!-- Example: Optional parameter, also by reference -->
> + <methodparam choice="opt"><type>int</type><parameter
> role="reference">
> secondparameter</parameter></methodparam>
> + <!-- Example: If no methodparams exist (void), use this -->
> + <void />
> + </methodsynopsis>
> + <para>
> + The function description goes here.
> + </para>
> + </refsect1><!-- }}} -->
> </html>
> ]]>
> </programlisting>
> </example>
> </para>
> <para>
> - Instead of lots of commands to output HTML (as seen in C or Perl),
> + Rather than require a lot of commands to output HTML (as seen in C or
> Perl),
> PHP pages contain HTML with embedded code that does
> "something" (in this case, output "Hi, I'm a PHP script!").
> The PHP code is enclosed in special <link
> linkend="language.basic-syntax.phpmode">start and end processing
> instructions <code><?php</code> and
> <code>?></code></link>
> - that allow you to jump into and out of "PHP mode."
> + that allow you to jump in and out of "PHP mode."
> </para>
> <para>
> What distinguishes PHP from something like client-side JavaScript
> is that the code is executed on the server, generating HTML which
> - is then sent to the client. The client would receive
> + is then sent to the client. The client receives
> the results of running that script, but would not know
> what the underlying code was. You can even configure your web server
> - to process all your HTML files with PHP, and then there's really no
> + to process all your HTML files with PHP, so there's really no
> way that users can tell what you have up your sleeve.
> </para>
> <para>
> - The best things in using PHP are that it is extremely simple
> + The best thing about using PHP is that it is extremely simple
> for a newcomer, but offers many advanced features for
> - a professional programmer. Don't be afraid reading the long
> - list of PHP's features. You can jump in, in a short time, and
> + a professional programmer. Don't be afraid to read the long
> + list of PHP's features. You can jump in and
> start writing simple scripts in a few hours.
> </para>
> <para>
> Although PHP's development is focused on server-side scripting,
> - you can do much more with it. Read on, and see more in the
> + you can do much more with it. To find out how much more, read the
> <link linkend="intro-whatcando">What can PHP do?</link> section,
> or go right to the <link linkend="tutorial">introductory
> tutorial</link> if you are only interested in web programming.
> @@ -74,81 +90,93 @@
> <info><title>What can PHP do?</title></info>
> <para>
> Anything. PHP is mainly focused on server-side scripting,
> - so you can do anything any other CGI program can do, such
> + so you can do the same things any other CGI program can do, such
> as collect form data, generate dynamic page content, or
> - send and receive cookies. But PHP can do much more.
> + send and receive cookies. And PHP can do much more.
> </para>
> <para>
> There are three main areas where PHP scripts are used.
> <itemizedlist>
> <listitem>
> <simpara>
> - Server-side scripting. This is the most traditional
> - and main target field for PHP. You need three things
> - to make this work: the PHP parser (CGI or server
> - module), a web server and a web browser. You need to
> - run the web server, with a connected PHP installation.
> - You can access the PHP program output with a web browser,
> - viewing the PHP page through the server. All these can
> - run on your home machine if you are just experimenting
> - with PHP programming. See the
> + Server-Side Scripting: This is the most traditional
> + and main purpose of PHP. You need three pieces
> + to make this work: a PHP parser (CGI or server
> + module), a web server, and a web browser. The web server
> + runs with a connected PHP installation which parses PHP code.
> + You can see the PHP program output using a web browser
> + with a URL address to your files on the web server. If you
> + are just experimenting with PHP programming, all of these
> + pieces can run on your home machine. See the
> <link linkend="install">installation instructions</link>
> section for more information.
> </simpara>
> </listitem>
> <listitem>
> <simpara>
> - Command line scripting. You can make a PHP script
> - to run it without any server or browser.
> - You only need the PHP parser to use it this way.
> - This type of usage is ideal for scripts regularly
> - executed using cron (on *nix or Linux) or Task Scheduler (on
> + Command Line Scripting: You can run PHP code
> + without any server or browser. To be used this way,
> + only the PHP parser is required.
> + It is ideal for scripts regularly executed
> + using cron (on *nix or Linux) or Task Scheduler (on
> Windows). These scripts can also be used for simple text
> processing tasks. See the section about
> - <link linkend="features.commandline">Command line usage of
> PHP</link>
> + <link linkend="features.commandline">command line usage of
> PHP</link>
> for more information.
> </simpara>
> </listitem>
> <listitem>
> <simpara>
> - Writing desktop applications. PHP is probably
> - not the very best language to create a desktop
> - application with a graphical user interface, but if
> - you know PHP very well, and would like to use some
> - advanced PHP features in your client-side applications
> - you can also use PHP-GTK to write such programs. You also
> + Writing Desktop Applications: PHP is probably
> + not the best language to create a desktop
> + application with a graphical user interface, but the
> + PHP-GTK extension enables you to do this. As an
> + extension, it is not included in the main distribution.
> + If you know PHP very well and would like to use some
> + advanced PHP features in your client-side applications,
> + you can use PHP-GTK to write such programs. You also
> have the ability to write cross-platform applications this
> - way. PHP-GTK is an extension to PHP, not available in
> - the main distribution. If you are interested
> - in PHP-GTK, visit <link xlink:href="&url.php.gtk;">its
> + way. If you are interested in PHP-GTK, visit
> + <link xlink:href="&url.php.gtk;">its
> own website</link>.
> </simpara>
> </listitem>
> </itemizedlist>
> </para>
> <para>
> - PHP can be <link linkend="install">used</link> on all major
> operating
> systems, including
> + PHP can be <link linkend="install">installed</link> on all major
> operating systems, including
> Linux, many Unix variants (including HP-UX, Solaris and OpenBSD),
> - Microsoft Windows, Mac OS X, RISC OS, and probably others.
> + Microsoft Windows, Mac OS X, RISC OS, and others.
> PHP also has support for most of the web servers today. This
> - includes Apache, IIS, and many others. And this includes any
> + includes Apache, IIS, and many others as well as any
> web server that can utilize the FastCGI PHP binary, like lighttpd
> - and nginx. PHP works as either a module, or as a CGI processor.
> + and nginx. PHP can work either as a module or as a CGI processor.
> </para>
> <para>
> - So with PHP, you have the freedom of choosing an operating
> - system and a web server. Furthermore, you also have the choice
> + Not only does PHP offer you the freedom to choose your
> + operating system and web server, you also have the choice
> of using procedural programming or object oriented
> - programming (OOP), or a mixture of them both.
> - </para>
> - <para>
> - With PHP you are not limited to output HTML. PHP's abilities
> - includes outputting images, PDF files and even Flash movies
> - (using libswf and Ming) generated on the fly. You can also
> - output easily any text, such as XHTML and any other XML file.
> - PHP can autogenerate these files, and save them in the file
> - system, instead of printing it out, forming a server-side
> - cache for your dynamic content.
> + programming (OOP) or even a mixture of both. And your output
> + is not limited to HTML. PHP can output
> + images, PDF files and Flash movies, using
> + libswf and Ming, generated on the fly.
> + </para>
> + <para>
> + PHP has many useful <link linkend="refs.basic.text">
> + text processing</link> features including tools for
> + working with Perl compatible regular expressions (<link
> + linkend="book.pcre">PCRE</link>) and
> + <link linkend="refs.xml">parsing and accessing XML</link>.
> + PHP standardizes all of the XML extensions on the solid
> + base of <link linkend="book.libxml">libxml2</link>.
> + The XML feature set of PHP is extended with support for
> + <link linkend="book.simplexml">SimpleXML</link>, <link
> + linkend="book.xmlreader">XMLReader</link> and
> + <link linkend="book.xmlwriter">XMLWriter</link>.
> + These text processing features enable you to easily
> + create text-based files such as XHTML and other XML files.
> + PHP can print them or save them in the file system
> + forming a server-side cache for your dynamic content.
> </para>
> <para>
> One of the strongest and most significant features in PHP is its
> @@ -162,37 +190,31 @@
> like CouchDB.
> </para>
> <para>
> - PHP also has support for talking to other services using protocols
> + PHP supports talking to other services using protocols
> such as LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (on Windows) and
> countless others. You can also open raw network sockets and
> interact using any other protocol. PHP has support for the WDDX
> complex data exchange between virtually all Web programming
> - languages. Talking about interconnection, PHP has support for
> + languages. PHP interconnection even offers support for
> instantiation of Java objects and using them transparently
> as PHP objects.
> </para>
> <para>
> - PHP has useful <link linkend="refs.basic.text">text
> processing</link>
> features,
> - which includes the Perl compatible regular expressions (<link
> linkend="book.pcre">PCRE</link>),
> - and many extensions and tools to <link linkend="refs.xml">parse and
> access XML documents</link>.
> - PHP standardizes all of the XML extensions on the solid base of <link
> linkend="book.libxml">libxml2</link>,
> - and extends the feature set adding <link linkend="book.simplexml">
> SimpleXML</link>,
> - <link linkend="book.xmlreader">XMLReader</link> and <link
> linkend="book.xmlwriter">XMLWriter</link> support.
> - </para>
> - <para>
> - And many other interesting extensions exist, which are categorized
> both
> - <link linkend="extensions">alphabetically</link> and by <link
> linkend="funcref">category</link>.
> - And there are additional PECL extensions that may or may not be
> documented
> - within the PHP manual itself, like <link xlink:href="&url.xdebug;">
> XDebug</link>.
> - </para>
> - <para>
> - As you can see this page is not enough to list all
> - the features and benefits PHP can offer. Read on in
> - the sections about <link linkend="install">installing
> - PHP</link>, and see the <link linkend="funcref">function
> - reference</link> part for explanation of the extensions
> - mentioned here.
> + Many other interesting extensions exist in PHP which are categorized
> both
> + <link linkend="extensions">alphabetically</link> and by <link
> linkend="funcref">category</link>. There are additional PECL extensions
> + that may or may not be documented within the PHP manual itself, like
> <link xlink:href="&url.xdebug;">XDebug</link>.
> + </para>
> + <para>
> + This page is not enough to list all
> + the features and benefits PHP offers. Get started by
> + <link linkend="install">installing
> + PHP</link>. Read the <link linkend="funcref">function
> + reference</link> for explanations of the extensions to PHP
> + mentioned here. With your PHP environment set up, check out
> + <link linkend="tutorial">a simple tutorial</link> or explore
> + <link linkend="langref">the language reference</link> section.
> </para>
> +
> </section>
>
> </chapter>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=76914
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=76914
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/sqlite/functions/sqlite-escape-string.xml
> By: Tim van Dijen on 2017-12-08 12:43:41
> ===================================================================
> --- en/reference/sqlite/functions/sqlite-escape-string.xml
> +++ en/reference/sqlite/functions/sqlite-escape-string.xml
> @@ -40,7 +40,7 @@
> The <type>string</type> being quoted.
> </para>
> <para>
> - If the <parameter>item</parameter> contains a
> <literal>NUL</literal>
> + If the <parameter>item</parameter> contains a
> <literal>NULL</literal>
> character, or if it begins with a character whose ordinal value is
> <literal>0x01</literal>, PHP will apply a binary encoding scheme
> so that
> you can safely store and retrieve binary data.
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=77224
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=77224
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ftp/functions/ftp-nlist.xml
> By: anonymous on 2017-12-12 05:58:31
> ===================================================================
> --- en/reference/ftp/functions/ftp-nlist.xml
> +++ en/reference/ftp/functions/ftp-nlist.xml
> @@ -90,6 +90,7 @@
> <para>
> <simplelist>
> <member><function>ftp_rawlist</function></member>
> + <member><function>ftp_mlsd</function></member>
> </simplelist>
> </para>
> </refsect1>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=77324
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=77324
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ftp/functions/ftp-rawlist.xml
> By: anonymous on 2017-12-12 05:59:52
> ===================================================================
> --- en/reference/ftp/functions/ftp-rawlist.xml
> +++ en/reference/ftp/functions/ftp-rawlist.xml
> @@ -109,6 +109,7 @@
> <para>
> <simplelist>
> <member><function>ftp_nlist</function></member>
> + <member><function>ftp_mlsd</function></member>
> </simplelist>
> </para>
> </refsect1>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=77325
> => Delete this change: https://edit.php.net/?project=^A
> 9R
> php&action=deleteThisChange&idDB=77325
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/ftp/versions.xml
> By: anonymous on 2017-12-12 06:18:56
> ===================================================================
> --- en/reference/ftp/versions.xml
> +++ en/reference/ftp/versions.xml
> @@ -19,6 +19,7 @@
> <function name='ftp_login' from='PHP 4, PHP 5, PHP 7'/>
> <function name='ftp_mdtm' from='PHP 4, PHP 5, PHP 7'/>
> <function name='ftp_mkdir' from='PHP 4, PHP 5, PHP 7'/>
> + <function name='ftp_mlsd' from='PHP 7.2'/>
> <function name='ftp_nb_continue' from='PHP 4 >= 4.3.0, PHP 5, PHP
> 7'/>
> <function name='ftp_nb_fget' from='PHP 4 >= 4.3.0, PHP 5, PHP
> 7'/>
> <function name='ftp_nb_fput' from='PHP 4 >= 4.3.0, PHP 5, PHP
> 7'/>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=77329
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=77329
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/funchand/functions/call-user-func.xml
> By: anonymous on 2017-12-17 16:19:24
> ===================================================================
> --- en/reference/funchand/functions/call-user-func.xml
> +++ en/reference/funchand/functions/call-user-func.xml
> @@ -54,20 +54,21 @@
> }
>
> $a = 0;
> +// Warning: Parameter 1 to increment() expected to be a reference, value
> given in ...
> call_user_func('increment', $a);
> -echo $a."n";
> +echo "Passed by value: ".$a."n";
>
> // You can use this instead
> call_user_func_array('increment', array(&$a));
> -echo $a."n";
> +echo "Passed by reference: ".$a."n";
> ?>
> ]]>
> </programlisting>
> &example.outputs;
> <screen>
> <![CDATA[
> -0
> -1
> +Passed by value: 0
> +Passed by reference: 1
> ]]>
> </screen>
> </example>
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=77526
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=77526
>
> ------------------------------
> ------------------------------------
>
> Modified: en/reference/var/functions/unset.xml
> By: anonymous on 2018-01-01 13:15:30
> ===================================================================
> --- en/reference/var/functions/unset.xml
> +++ en/reference/var/functions/unset.xml
> @@ -100,7 +100,7 @@
> </programlisting>
> </informalexample>
> </para>
> - &example.outputs;
> + &example.outputs;
> <para>
> <informalexample>
> <screen>
> @@ -138,7 +138,7 @@
> </programlisting>
> </informalexample>
> </para>
> - &example.outputs;
> + &example.outputs;
> <para>
> <informalexample>
> <screen>
> @@ -151,7 +151,7 @@
> </informalexample>
> </para>
> </refsect1>
> -
> +
> <refsect1 role="parameters">
> &reftitle.parameters;
> <para>
> @@ -175,14 +175,14 @@
> </variablelist>
> </para>
> </refsect1>
> -
> +
> <refsect1 role="returnvalues">
> &reftitle.returnvalues;
> <para>
> &return.void;
> </para>
> </refsect1>
> -
> +
> <refsect1 role="examples">
> &reftitle.examples;
> <para>
> @@ -206,6 +206,9 @@
> <example>
> <title>Using <literal>(unset)</literal> casting</title>
> <para>
> + &warn.deprecated.feature-7-2-0;
> + </para>
> + <para>
> <literal>(unset)</literal> casting is often confused with the
> <function>unset</function> function. <literal>(unset)</literal>
> casting serves only as a <literal>NULL</literal>-type cast, for
> @@ -231,7 +234,7 @@
> </example>
> </para>
> </refsect1>
> -
> +
> <refsect1 role="notes">
> &reftitle.notes;
> ¬e.language-construct;
> @@ -266,7 +269,7 @@
> </simplelist>
> </para>
> </refsect1>
> -
> +
> </refentry>
>
> <!-- Keep this comment at the end of the file
>
>
> => Put this change into your patches :
>
> https://edit.php.net/?project=php&action=putIntoMyPatches&idDB=78177
> => Delete this change:
> https://edit.php.net/?project=
> php&action=deleteThisChange&idDB=78177
>
> ------------------------------
> ------------------------------------
>
>
>
>
> --
> https://edit.php.net/
> This email is send automatically by the Php Docbook Online Editor.
>
--
*Pasindu De Silva**ppasindud@gmail.com <ppasindud@gmail.com>*