Fix lone section order issues in various extensions

Part of php#658
Girgias · Jun 6, 2021 · 9a883ae · 9a883ae
1 parent b87e842
commit 9a883ae
Show file tree

Hide file tree

Showing 23 changed files with 200 additions and 118 deletions.
diff --git a/reference/apcu/functions/apcu-fetch.xml b/reference/apcu/functions/apcu-fetch.xml
@@ -50,6 +50,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>PECL apcu 3.0.17</entry>
+      <entry>
+       The <parameter>success</parameter> parameter was added.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -74,28 +96,6 @@ string(3) "BAR"
   </para>
  </refsect1>
 
- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <informaltable>
-   <tgroup cols="2">
-    <thead>
-     <row>
-      <entry>&Version;</entry>
-      <entry>&Description;</entry>
-     </row>
-    </thead>
-    <tbody>
-     <row>
-      <entry>PECL apcu 3.0.17</entry>
-      <entry>
-       The <parameter>success</parameter> parameter was added.
-      </entry>
-     </row>
-    </tbody>
-   </tgroup>
-  </informaltable>
- </refsect1>
-
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

diff --git a/reference/array/functions/array-unique.xml b/reference/array/functions/array-unique.xml
@@ -162,26 +162,26 @@ array(2) {
    </example>
   </para>
  </refsect1>
-
- <refsect1 role="seealso">
-  &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>array_count_values</function></member>
-   </simplelist>
-  </para>
- </refsect1>
 
  <refsect1 role="notes">
   &reftitle.notes;
   <note>
    <simpara>
-    Note that <function>array_unique</function> is not intended to 
+    Note that <function>array_unique</function> is not intended to
     work on multi dimensional arrays.
    </simpara>
   </note>
  </refsect1>
 
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>array_count_values</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/reference/bc/functions/bcpowmod.xml b/reference/bc/functions/bcpowmod.xml
@@ -63,17 +63,7 @@
    is <literal>0</literal> or <parameter>exponent</parameter> is negative.
   </para>
  </refsect1>
-
- <refsect1 role="notes">
-  &reftitle.notes;
-  <note>
-   <para>
-    Because this method uses the modulus operation, numbers which are not
-    positive integers may give unexpected results.
-   </para>
-  </note>
- </refsect1>
-
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -118,7 +108,17 @@ $b = bcmod(bcpow($x, $y), $mod);
    </informalexample>
   </para>
  </refsect1>
-
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Because this method uses the modulus operation, numbers which are not
+    positive integers may give unexpected results.
+   </para>
+  </note>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

diff --git a/reference/com/functions/com-create-guid.xml b/reference/com/functions/com-create-guid.xml
@@ -19,6 +19,12 @@
    Microsoft convention is to enclose a GUID in curly braces.
   </para>
  </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>

diff --git a/reference/cubrid/cubridmysql/cubrid-unbuffered-query.xml b/reference/cubrid/cubridmysql/cubrid-unbuffered-query.xml
@@ -49,18 +49,6 @@
   </para>
  </refsect1>
 
- <refsect1 role="notes">
-  &reftitle.notes;
-  <note>
-   <para>
-    The benefits of <function>cubrid_unbuffered_query</function> come
-    at a cost: you cannot use <function>cubrid_num_rows</function> and
-    <function>cubrid_data_seek</function> on a result set returned from
-    <function>cubrid_unbuffered_query</function>. 
-   </para>
-  </note>
- </refsect1>
-
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
@@ -89,6 +77,18 @@
   </example>
  </refsect1>
 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    The benefits of <function>cubrid_unbuffered_query</function> come
+    at a cost: you cannot use <function>cubrid_num_rows</function> and
+    <function>cubrid_data_seek</function> on a result set returned from
+    <function>cubrid_unbuffered_query</function>.
+   </para>
+  </note>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/dba/functions/dba-list.xml b/reference/dba/functions/dba-list.xml
@@ -15,14 +15,19 @@
    <function>dba_list</function> list all open database files.
   </para>
  </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    An associative array, in the form <literal>resourceid =&gt; filename</literal>.
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/exec/functions/proc-nice.xml b/reference/exec/functions/proc-nice.xml
@@ -101,24 +101,6 @@
   </para>
  </refsect1>
 
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-   <example>
-    <title>Using <function>proc_nice</function> to set the process priority to high</title>
-    <programlisting role="php">
-<![CDATA[
-<?php
-// Highest priority
-proc_nice(-20);
-?>
-]]>
-    </programlisting>
-   </example>
-  </para>
-
- </refsect1>
-
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -143,6 +125,24 @@ proc_nice(-20);
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Using <function>proc_nice</function> to set the process priority to high</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Highest priority
+proc_nice(-20);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+
+ </refsect1>
+
  <refsect1 role="notes">
   &reftitle.notes;
   <note>

diff --git a/reference/exif/functions/exif-thumbnail.xml b/reference/exif/functions/exif-thumbnail.xml
@@ -77,30 +77,7 @@
    thumbnail.
   </para>
  </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-   <example>
-    <title><function>exif_thumbnail</function> example</title>
-    <programlisting role="php">
-<![CDATA[
-<?php
-$image = exif_thumbnail('/path/to/image.jpg', $width, $height, $type);
 
-if ($image!==false) {
-    header('Content-type: ' .image_type_to_mime_type($type));
-    echo $image;
-    exit;
-} else {
-    // no thumbnail available, handle the error here
-    echo 'No thumbnail available';
-}
-?>
-]]>
-    </programlisting>
-   </example>
-  </para>
- </refsect1>
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -116,7 +93,7 @@ if ($image!==false) {
       <row>
        <entry>7.2.0</entry>
        <entry>
-        The <parameter>file</parameter> parameter now supports both local files 
+        The <parameter>file</parameter> parameter now supports both local files
         and stream resources.
        </entry>
       </row>
@@ -125,6 +102,32 @@ if ($image!==false) {
    </informaltable>
   </para>
  </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>exif_thumbnail</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$image = exif_thumbnail('/path/to/image.jpg', $width, $height, $type);
+
+if ($image!==false) {
+    header('Content-type: ' .image_type_to_mime_type($type));
+    echo $image;
+    exit;
+} else {
+    // no thumbnail available, handle the error here
+    echo 'No thumbnail available';
+}
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="notes">
   &reftitle.notes;
   <note>

diff --git a/reference/filter/functions/filter-list.xml b/reference/filter/functions/filter-list.xml
@@ -14,6 +14,12 @@
   </methodsynopsis>
 
  </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>

diff --git a/reference/fpm/functions/fastcgi-finish-request.xml b/reference/fpm/functions/fastcgi-finish-request.xml
@@ -20,6 +20,11 @@
   </para>
  </refsect1>
 
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>

diff --git a/reference/geoip/functions/geoip-db-get-all-info.xml b/reference/geoip/functions/geoip-db-get-all-info.xml
@@ -47,6 +47,12 @@
   </para>
 
  </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>

diff --git a/reference/inotify/functions/inotify-init.xml b/reference/inotify/functions/inotify-init.xml
@@ -18,6 +18,11 @@
    <function>inotify_add_watch</function>
   </para>
  </refsect1><!-- }}} -->
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
 
  <refsect1 role="returnvalues"><!-- {{{ -->
   &reftitle.returnvalues;

diff --git a/reference/lzf/functions/lzf-optimized-for.xml b/reference/lzf/functions/lzf-optimized-for.xml
@@ -18,14 +18,19 @@
    Determines what was LZF extension optimized for during compilation.
   </para>
  </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    Returns 1 if LZF was optimized for speed, 0 for compression.
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml