fpm : fix XML by converting para to simpara tags via script

2026-03-23 22:52:12 +01:00 · 2026-01-26 14:26:40 +00:00
parent dc4029adc2
commit 8a247c21af
5 changed files with 51 additions and 56 deletions
--- a/reference/fpm/book.xml
+++ b/reference/fpm/book.xml
@@ -1,16 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fab4ea95f4fe1471be947602d0e9be32fb802265 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
-
-<book xml:id="book.fpm" xmlns="http://docbook.org/ns/docbook">
+<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: fernandowobeto Status: ready -->
+<!-- CREDITS: fernandowobeto -->
+<book xmlns="http://docbook.org/ns/docbook" xml:id="book.fpm">
 <?phpdoc extension-membership="core" ?>
 <title>Gerenciador de processos FastCGI</title>

 <preface xml:id="intro.fpm">
  &reftitle.intro;
  &fpm.intro;
-  <para>
+  <simpara>
   Este SAPI vem junto com o PHP.
-  </para>
+  </simpara>
 </preface>

 &reference.fpm.setup;
@@ -18,7 +18,6 @@
 &reference.fpm.reference;

 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- 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"?>
-<!-- EN-Revision: cbac1ecf71d754707d69bdc344c4031c157eaa54 Maintainer: leonardolara Status: ready -->
-
-<refentry xml:id="function.fastcgi-finish-request" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: leonardolara Status: ready -->
+<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>Envia todos os dados de resposta ao cliente</refpurpose>
@@ -11,13 +10,13 @@
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>fastcgi_finish_request</methodname>
-   <void />
+   <void/>
  </methodsynopsis>
-  <para>
+  <simpara>
   Esta função envia todos os dados de resposta para o cliente e finaliza a requisição.
   Isso permite que tarefas demoradas sejam executadas sem
   que a conexão com o cliente seja mantida aberta.
-  </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
@@ -52,4 +50,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
-->
+-->
--- 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"?>
-<!-- EN-Revision: 5764345c8662c22b570bf453650a9dd584bd3abb Maintainer: leonardolara Status: ready -->
-<refentry xml:id="function.fpm-get-status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: leonardolara Status: ready -->
+<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>Retorna o status do pool FPM atual</refpurpose>
@@ -12,15 +12,15 @@
   <type class="union"><type>array</type><type>false</type></type><methodname>fpm_get_status</methodname>
   <void/>
  </methodsynopsis>
-  <para>
+  <simpara>
   Esta função retorna o status completo do pool FPM atual como um array associativo. Sempre
   retorna o status completo, incluindo informações por processo. Consulte o
   <link linkend="fpm.status">guia da página de status do FPM</link> para mais
   detalhes.
-  </para>
-  <para>
+  </simpara>
+  <simpara>
   Observe que esta função estará definida somente se o FPM estiver sendo usado para servir o script.
-  </para>
+  </simpara>
 </refsect1>

 <refsect1 role="parameters">
@@ -30,9 +30,9 @@

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
-  <para>
+  <simpara>
   Array associativo contendo o status completo do pool FPM,&return.falseforfailure;.
-  </para>
+  </simpara>
 </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
--- a/reference/fpm/setup.xml
+++ b/reference/fpm/setup.xml
@@ -1,17 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b2e83b46c6aa7f8278e80d3c0e8a049b7583f6cc Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
-
+<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: fernandowobeto Status: ready -->
+<!-- CREDITS: fernandowobeto -->
 <chapter xml:id="fpm.setup">
 &reftitle.setup;

- <para>
+ <simpara>
  Informações sobre instalação e configuração do FPM podem ser encontradas na
  <link linkend="install.fpm">seção de instalação e configuração</link> do
  manual do PHP.
- </para>
+ </simpara>

 </chapter>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/fpm/status.xml
+++ b/reference/fpm/status.xml
@@ -1,36 +1,36 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a4429100780d1d0d6ce204c11ad223f6526990ab Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
-
-<sect1 xml:id="fpm.status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: leonardolara Status: ready -->
+<!-- CREDITS: fernandowobeto,leonardolara -->
+<sect1 xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="fpm.status">
 <title>Página de status</title>

- <para>
+ <simpara>
  Esta página fornece informações sobre a configuração e o conteúdo da página de status do FPM. Veja também
  <function>fpm_get_status</function>.
- </para>
+ </simpara>

 <sect2 xml:id="fpm.status.configuration">
  <title>Configuração</title>

-  <para>
+  <simpara>
   A página de status do FPM pode ser habilitada definindo o parâmetro de configuração
   <link linkend="pm.status-path">pm.status_path</link> na configuração do pool
   FPM.
-  </para>
+  </simpara>

  <caution>
-   <para>
+   <simpara>
    Por segurança, a página de status do FPM deve ser restrita apenas a solicitações internas ou IPs
    de clientes conhecidos, pois a página revela URLs de solicitação e informações sobre os recursos disponíveis.
-   </para>
+   </simpara>
  </caution>

-  <para>
+  <simpara>
   Dependendo da configuração do servidor web, pode ser necessário configurá-lo para
   permitir solicitações diretamente para este caminho, ignorando quaisquer scripts PHP. Um exemplo de configuração
   para Apache com FPM escutando em UDS e <literal>pm.status_path</literal> definido como
   <literal>/fpm-status</literal> seria assim:
-  </para>
+  </simpara>

  <informalexample>
   <programlisting role="apache-conf">
@@ -44,20 +44,20 @@
   </programlisting>
  </informalexample>

-  <para>
+  <simpara>
   Após recarregar ou reiniciar o FPM e o servidor web, a página de status estará acessível a partir
   do navegador (desde que a solicitação venha de um endereço IP permitido se a restrição de IP tiver sido
   configurada).
-  </para>
+  </simpara>
 </sect2>

 <sect2 xml:id="fpm.status.parameters">
  <title>Parâmetros de consulta</title>

-  <para>
+  <simpara>
   O formato da saída da página de status pode ser alterado especificando um dos seguintes parâmetros
   de consulta:
-  </para>
+  </simpara>

  <simplelist>
   <member><literal>html</literal></member>
@@ -66,13 +66,13 @@
   <member><literal>xml</literal></member>
  </simplelist>

-  <para>
+  <simpara>
   Informações adicionais também podem ser retornadas usando o parâmetro de consulta <literal>full</literal>.
-  </para>
+  </simpara>

-  <para>
+  <simpara>
   Exemplos de URLs de páginas de status:
-  </para>
+  </simpara>

  <simplelist>
   <member>
@@ -97,11 +97,11 @@
 <sect2 xml:id="fpm.status.contents">
  <title>Informações exibidas</title>

-  <para>
+  <simpara>
   Os valores de data/hora usam o formato de timestamp Unix na saída JSON e XML; caso contrário, eles usam
   o formato que resulta no seguinte exemplo de data:
   <literal>"03/Jun/2021:07:21:46 +0100"</literal>.
-  </para>
+  </simpara>

  <table>
   <title>Informações básicas - Sempre exibidas na página de status</title>
@@ -266,16 +266,16 @@
  </table>

  <note>
-   <para>
+   <simpara>
    Todos os valores são específicos do pool e são redefinidos quando o FPM é reiniciado.
-   </para>
+   </simpara>
  </note>

  <note>
-   <para>
+   <simpara>
    A saída do formato OpenMetrics usa diferentes tipos de parâmetros para melhor se adequar ao formato OpenMetrics.
    Os parâmetros e as descrições de seus valores estão incluídos na saída do formato OpenMetrics.
-   </para>
+   </simpara>
  </note>
 </sect2>

@@ -299,8 +299,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