[DOC-CVS] [doc-en] master: fpm : fix XML by converting para to simpara tags via script (#5206)

Author: Gina Peter Banyard (Girgias)
Committer: GitHub (web-flow)
Pusher: Girgias
Date: 2026-01-26T14:25:33Z

Commit: https://github.com/php/doc-en/commit/0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368
Raw diff: https://github.com/php/doc-en/commit/0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368.diff

fpm : fix XML by converting para to simpara tags via script (#5206)

Changed paths:
  M  reference/fpm/book.xml
  M  reference/fpm/functions/fastcgi-finish-request.xml
  M  reference/fpm/functions/fpm-get-status.xml
  M  reference/fpm/setup.xml
  M  reference/fpm/status.xml


Diff:

diff --git a/reference/fpm/book.xml b/reference/fpm/book.xml
index 2d071a65fceb..190467779037 100644
--- a/reference/fpm/book.xml
+++ b/reference/fpm/book.xml
@@ -1,16 +1,15 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-
-<book xml:id="book.fpm" xmlns="http://docbook.org/ns/docbook">
+<book xmlns="http://docbook.org/ns/docbook" xml:id="book.fpm">
  <?phpdoc extension-membership="core" ?>
  <title>FastCGI Process Manager</title>
 
  <preface xml:id="intro.fpm">
   &reftitle.intro;
   &fpm.intro;
-  <para>
+  <simpara>
    This SAPI is bundled with PHP.
-  </para>
+  </simpara>
  </preface>
 
  &reference.fpm.setup;
@@ -18,7 +17,6 @@
  &reference.fpm.reference;
 
 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/fpm/functions/fastcgi-finish-request.xml b/reference/fpm/functions/fastcgi-finish-request.xml
index 04e9c3815365..56fa18c17544 100644
--- a/reference/fpm/functions/fastcgi-finish-request.xml
+++ b/reference/fpm/functions/fastcgi-finish-request.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-
-<refentry xml:id="function.fastcgi-finish-request" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.fastcgi-finish-request">
  <refnamediv>
   <refname>fastcgi_finish_request</refname>
   <refpurpose>Flushes all response data to the client</refpurpose>
@@ -11,13 +10,13 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>fastcgi_finish_request</methodname>
-   <void />
+   <void/>
   </methodsynopsis>
-  <para>
+  <simpara>
    This function flushes all response data to the client and finishes the
    request. This allows for time consuming tasks to be performed without
    leaving the connection to the client open.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -27,12 +26,11 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
+  <simpara>
    &return.success;
-  </para>
+  </simpara>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/fpm/functions/fpm-get-status.xml b/reference/fpm/functions/fpm-get-status.xml
index 182ba7e85c0b..925e10ac3c1b 100644
--- a/reference/fpm/functions/fpm-get-status.xml
+++ b/reference/fpm/functions/fpm-get-status.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.fpm-get-status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.fpm-get-status">
  <refnamediv>
   <refname>fpm_get_status</refname>
   <refpurpose>Returns the current FPM pool status</refpurpose>
@@ -12,15 +12,15 @@
    <type class="union"><type>array</type><type>false</type></type><methodname>fpm_get_status</methodname>
    <void/>
   </methodsynopsis>
-  <para>
+  <simpara>
    This function returns the full current FPM pool status as an associative array. It always
    returns the full status, including per-process status information. See the
    <link linkend="fpm.status">FPM status page guide</link> for further
    details.
-  </para>
-  <para>
+  </simpara>
+  <simpara>
    Note that this function will only be defined if FPM is being used to serve the script.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -30,9 +30,9 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
+  <simpara>
    Associative array containing the full FPM pool status,&return.falseforfailure;.
-  </para>
+  </simpara>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/fpm/setup.xml b/reference/fpm/setup.xml
index afb79feca9f3..738999d4ce4a 100644
--- a/reference/fpm/setup.xml
+++ b/reference/fpm/setup.xml
@@ -1,17 +1,15 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-
 <chapter xml:id="fpm.setup">
  &reftitle.setup;
 
- <para>
+ <simpara>
   Information on installing and configuring FPM can be found in the
   <link linkend="install.fpm">installation and configuration section</link> of
   the PHP manual.
- </para>
+ </simpara>
 
 </chapter>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/fpm/status.xml b/reference/fpm/status.xml
index ce39df4bfbec..59f83ea0298f 100644
--- a/reference/fpm/status.xml
+++ b/reference/fpm/status.xml
@@ -1,36 +1,35 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-
-<sect1 xml:id="fpm.status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<sect1 xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="fpm.status">
  <title>Status Page</title>
- 
- <para>
+
+ <simpara>
   This page provides information on the setup and contents of the FPM status page. See also
   <function>fpm_get_status</function>.
- </para>
+ </simpara>
 
  <sect2 xml:id="fpm.status.configuration">
   <title>Configuration</title>
-  
-  <para>
+
+  <simpara>
    The FPM status page can be enabled by setting the
    <link linkend="pm.status-path">pm.status_path</link> configuration parameter in the FPM pool
    configuration.
-  </para>
+  </simpara>
 
   <caution>
-   <para>
+   <simpara>
     For security the FPM status page should be restricted to internal requests or known client IPs
     only as the page reveals request URLs and information about available resources.
-   </para>
+   </simpara>
   </caution>
-  
-  <para>
+
+  <simpara>
    Depending on the web server configuration it might be needed to configure the web server to
    allow requests directly to this path, bypassing any PHP scripts. An example of a configuration
    for Apache with FPM listening on UDS and <literal>pm.status_path</literal> set to
    <literal>/fpm-status</literal> would look like:
-  </para>
+  </simpara>
 
   <informalexample>
    <programlisting role="apache-conf">
@@ -44,21 +43,21 @@
    </programlisting>
   </informalexample>
 
-  <para>
+  <simpara>
    After reloading or restarting both FPM and the web server the status page will be accessible from
    the browser (as long as the request comes from an allowed IP address if the IP restriction was
    configured).
-  </para>
+  </simpara>
  </sect2>
 
  <sect2 xml:id="fpm.status.parameters">
   <title>Query Parameters</title>
 
-  <para>
+  <simpara>
    The format of the status page output can be altered by specifying one of the following query
    parameters:
-  </para>
-  
+  </simpara>
+
   <simplelist>
    <member><literal>html</literal></member>
    <member><literal>json</literal></member>
@@ -66,14 +65,14 @@
    <member><literal>xml</literal></member>
   </simplelist>
 
-  <para>
+  <simpara>
    Additional information can also be returned using the <literal>full</literal> query parameter.
-  </para>
-  
-  <para>
+  </simpara>
+
+  <simpara>
    Example status page URLs:
-  </para>
-  
+  </simpara>
+
   <simplelist>
    <member>
     <literal>https://localhost/fpm-status</literal>
@@ -93,16 +92,16 @@
    </member>
   </simplelist>
  </sect2>
- 
+
  <sect2 xml:id="fpm.status.contents">
   <title>Displayed Information</title>
 
-  <para>
+  <simpara>
    Date/Time values use the unix timestamp format in JSON and XML output, otherwise they use
    the format resulting in the following example date
    <literal>"03/Jun/2021:07:21:46 +0100"</literal>.
-  </para>
-  
+  </simpara>
+
   <table>
    <title>Basic information - Always displayed on the status page</title>
    <tgroup cols="2">
@@ -249,8 +248,8 @@
       <entry>last request cpu</entry>
       <entry>
        The %cpu of the last request. This will be 0 if the process is not Idle because the
-       calculation is done when the request processing is complete. 
-       The value can exceed 100%, because metric will tell which percentage of the total cpu time was used in the last request - 
+       calculation is done when the request processing is complete.
+       The value can exceed 100%, because metric will tell which percentage of the total cpu time was used in the last request -
        takes processes on all cores into account, whereas the 100% is for one core only.
       </entry>
      </row>
@@ -266,16 +265,16 @@
   </table>
 
   <note>
-   <para>
+   <simpara>
     All values are specific to the pool and are reset when FPM is restarted.
-   </para>
+   </simpara>
   </note>
 
   <note>
-   <para>
+   <simpara>
     OpenMetrics format output uses different parameter types to better suit the OpenMetrics format.
     The parameters and descriptions of their values are included in the OpenMetrics format output.
-   </para>
+   </simpara>
   </note>
  </sect2>
 
@@ -299,8 +298,7 @@
   </informaltable>
  </sect2>
 </sect1>
-
- <!-- Keep this comment at the end of the file
+<!-- Keep this comment at the end of the file
  Local variables:
  mode: sgml
  sgml-omittag:t