Fix inconsistent section orders

This commit is contained in:
George Peter Banyard 2022-03-13 22:37:31 +00:00
parent 104bc5c203
commit 41f8ef5540
No known key found for this signature in database
GPG key ID: 3306078E3194AEBD
3 changed files with 46 additions and 57 deletions

View file

@ -90,6 +90,18 @@
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
As of PHP 7.1.0, an <classname>ArgumentCountError</classname> will be thrown if the <parameter>callback</parameter> function
requires more than 2 parameters (the value and key of the array member),
or more than 3 parameters if the <parameter>arg</parameter> is also passed.
Previously, in this case
an error of level <link linkend="errorfunc.constants">E_WARNING</link> would be generated each time
<function>array_walk</function> calls <parameter>callback</parameter>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
@ -113,17 +125,6 @@
</informaltable>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
As of PHP 7.1.0, an <classname>ArgumentCountError</classname> will be thrown if the <parameter>callback</parameter> function
requires more than 2 parameters (the value and key of the array member),
or more than 3 parameters if the <parameter>arg</parameter> is also passed.
Previously, in this case
an error of level <link linkend="errorfunc.constants">E_WARNING</link> would be generated each time
<function>array_walk</function> calls <parameter>callback</parameter>.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>

View file

@ -96,30 +96,6 @@
</informaltable>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<warning>
<para>
The expected magic database format changed in PHP 5.3.11 and 5.4.1.
Due to this, the internal magic database was upgraded. This mostly effects
code where an external magic database is used: reading an older magic file
will now fail.
Also, some textual representations of the mime types has changed, for
instance for PHP would be "PHP script, ASCII text" instead of "PHP script
text" returned.
</para>
</warning>
<note>
<para>
Generally, using the bundled magic database (by leaving
<parameter>magic_database</parameter> and the <literal>MAGIC</literal>
environment variables unset) is the best course of action unless you
specifically need a custom magic database.
</para>
</note>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
@ -167,6 +143,18 @@ text/plain; charset=us-ascii
</screen>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Generally, using the bundled magic database (by leaving
<parameter>magic_database</parameter> and the <literal>MAGIC</literal>
environment variables unset) is the best course of action unless you
specifically need a custom magic database.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

View file

@ -42,6 +42,28 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>request</parameter> is now nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@ -65,28 +87,6 @@ $server->handle();
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>request</parameter> is now nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>