Make cURL docs DocBook 5.2 conformant (#3383)

Author: Girgias

reference/curl/functions/curl-multi-setopt.xml

@@ -126,43 +126,47 @@
           <row>
            <entry valign="top"><constant>CURLMOPT_PUSHFUNCTION</constant></entry>
            <entry valign="top">
-            Pass a <type>callable</type> that will be registered to handle server
-            pushes and should have the following signature:
-            <methodsynopsis>
-             <type>int</type><methodname><replaceable>pushfunction</replaceable></methodname>
-             <methodparam><type>resource</type><parameter>parent_ch</parameter></methodparam>
-             <methodparam><type>resource</type><parameter>pushed_ch</parameter></methodparam>
-             <methodparam><type>array</type><parameter>headers</parameter></methodparam>
-            </methodsynopsis>
-            <variablelist>
-             <varlistentry>
-              <term><parameter>parent_ch</parameter></term>
-              <listitem>
-               <para>
-                The parent cURL handle (the request the client made).
-               </para>
-              </listitem>
-             </varlistentry>
-             <varlistentry>
-              <term><parameter>pushed_ch</parameter></term>
-              <listitem>
-               <para>
-                A new cURL handle for the pushed request.
-               </para>
-              </listitem>
-             </varlistentry>
-             <varlistentry>
-              <term><parameter>headers</parameter></term>
-              <listitem>
-               <para>
-                The push promise headers.
-               </para>
-              </listitem>
-             </varlistentry>
-            </variablelist>
-            The push function is supposed to return either
-            <constant>CURL_PUSH_OK</constant> if it can handle the push, or
-            <constant>CURL_PUSH_DENY</constant> to reject it.
+            <para>
+             Pass a <type>callable</type> that will be registered to handle server
+             pushes and should have the following signature:
+             <methodsynopsis>
+              <type>int</type><methodname><replaceable>pushfunction</replaceable></methodname>
+              <methodparam><type>resource</type><parameter>parent_ch</parameter></methodparam>
+              <methodparam><type>resource</type><parameter>pushed_ch</parameter></methodparam>
+              <methodparam><type>array</type><parameter>headers</parameter></methodparam>
+             </methodsynopsis>
+             <variablelist>
+              <varlistentry>
+               <term><parameter>parent_ch</parameter></term>
+               <listitem>
+                <para>
+                 The parent cURL handle (the request the client made).
+                </para>
+               </listitem>
+              </varlistentry>
+              <varlistentry>
+               <term><parameter>pushed_ch</parameter></term>
+               <listitem>
+                <para>
+                 A new cURL handle for the pushed request.
+                </para>
+               </listitem>
+              </varlistentry>
+              <varlistentry>
+               <term><parameter>headers</parameter></term>
+               <listitem>
+                <para>
+                 The push promise headers.
+                </para>
+               </listitem>
+              </varlistentry>
+             </variablelist>
+            </para>
+            <simpara>
+             The push function is supposed to return either
+             <constant>CURL_PUSH_OK</constant> if it can handle the push, or
+             <constant>CURL_PUSH_DENY</constant> to reject it.
+            </simpara>
            </entry>
           </row>
          </tbody>