Skip to content

Commit 8a247c2

Browse files
committed
fpm : fix XML by converting para to simpara tags via script
1 parent dc4029a commit 8a247c2

5 files changed

Lines changed: 51 additions & 56 deletions

File tree

reference/fpm/book.xml

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,23 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: fab4ea95f4fe1471be947602d0e9be32fb802265 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
4-
<book xml:id="book.fpm" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
4+
<book xmlns="http://docbook.org/ns/docbook" xml:id="book.fpm">
55
<?phpdoc extension-membership="core" ?>
66
<title>Gerenciador de processos FastCGI</title>
77

88
<preface xml:id="intro.fpm">
99
&reftitle.intro;
1010
&fpm.intro;
11-
<para>
11+
<simpara>
1212
Este SAPI vem junto com o PHP.
13-
</para>
13+
</simpara>
1414
</preface>
1515

1616
&reference.fpm.setup;
1717
&reference.fpm.observability;
1818
&reference.fpm.reference;
1919

2020
</book>
21-
2221
<!-- Keep this comment at the end of the file
2322
Local variables:
2423
mode: sgml

reference/fpm/functions/fastcgi-finish-request.xml

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: cbac1ecf71d754707d69bdc344c4031c157eaa54 Maintainer: leonardolara Status: ready -->
3-
4-
<refentry xml:id="function.fastcgi-finish-request" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.fastcgi-finish-request">
54
<refnamediv>
65
<refname>fastcgi_finish_request</refname>
76
<refpurpose>Envia todos os dados de resposta ao cliente</refpurpose>
@@ -11,13 +10,13 @@
1110
&reftitle.description;
1211
<methodsynopsis>
1312
<type>bool</type><methodname>fastcgi_finish_request</methodname>
14-
<void />
13+
<void/>
1514
</methodsynopsis>
16-
<para>
15+
<simpara>
1716
Esta função envia todos os dados de resposta para o cliente e finaliza a requisição.
1817
Isso permite que tarefas demoradas sejam executadas sem
1918
que a conexão com o cliente seja mantida aberta.
20-
</para>
19+
</simpara>
2120
</refsect1>
2221

2322
<refsect1 role="parameters">
@@ -27,12 +26,11 @@
2726

2827
<refsect1 role="returnvalues">
2928
&reftitle.returnvalues;
30-
<para>
29+
<simpara>
3130
&return.success;
32-
</para>
31+
</simpara>
3332
</refsect1>
3433
</refentry>
35-
3634
<!-- Keep this comment at the end of the file
3735
Local variables:
3836
mode: sgml
@@ -52,4 +50,4 @@ End:
5250
vim600: syn=xml fen fdm=syntax fdl=2 si
5351
vim: et tw=78 syn=sgml
5452
vi: ts=1 sw=1
55-
-->
53+
-->

reference/fpm/functions/fpm-get-status.xml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 5764345c8662c22b570bf453650a9dd584bd3abb Maintainer: leonardolara Status: ready -->
3-
<refentry xml:id="function.fpm-get-status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: leonardolara Status: ready -->
3+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.fpm-get-status">
44
<refnamediv>
55
<refname>fpm_get_status</refname>
66
<refpurpose>Retorna o status do pool FPM atual</refpurpose>
@@ -12,15 +12,15 @@
1212
<type class="union"><type>array</type><type>false</type></type><methodname>fpm_get_status</methodname>
1313
<void/>
1414
</methodsynopsis>
15-
<para>
15+
<simpara>
1616
Esta função retorna o status completo do pool FPM atual como um array associativo. Sempre
1717
retorna o status completo, incluindo informações por processo. Consulte o
1818
<link linkend="fpm.status">guia da página de status do FPM</link> para mais
1919
detalhes.
20-
</para>
21-
<para>
20+
</simpara>
21+
<simpara>
2222
Observe que esta função estará definida somente se o FPM estiver sendo usado para servir o script.
23-
</para>
23+
</simpara>
2424
</refsect1>
2525

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

3131
<refsect1 role="returnvalues">
3232
&reftitle.returnvalues;
33-
<para>
33+
<simpara>
3434
Array associativo contendo o status completo do pool FPM,&return.falseforfailure;.
35-
</para>
35+
</simpara>
3636
</refsect1>
3737
</refentry>
3838
<!-- Keep this comment at the end of the file

reference/fpm/setup.xml

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: b2e83b46c6aa7f8278e80d3c0e8a049b7583f6cc Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
2+
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: fernandowobeto Status: ready -->
3+
<!-- CREDITS: fernandowobeto -->
44
<chapter xml:id="fpm.setup">
55
&reftitle.setup;
66

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

1313
</chapter>
14-
1514
<!-- Keep this comment at the end of the file
1615
Local variables:
1716
mode: sgml

reference/fpm/status.xml

Lines changed: 26 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,36 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: a4429100780d1d0d6ce204c11ad223f6526990ab Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
3-
4-
<sect1 xml:id="fpm.status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
2+
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: leonardolara Status: ready -->
3+
<!-- CREDITS: fernandowobeto,leonardolara -->
4+
<sect1 xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="fpm.status">
55
<title>Página de status</title>
66

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

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

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

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

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

3535
<informalexample>
3636
<programlisting role="apache-conf">
@@ -44,20 +44,20 @@
4444
</programlisting>
4545
</informalexample>
4646

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

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

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

6262
<simplelist>
6363
<member><literal>html</literal></member>
@@ -66,13 +66,13 @@
6666
<member><literal>xml</literal></member>
6767
</simplelist>
6868

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

73-
<para>
73+
<simpara>
7474
Exemplos de URLs de páginas de status:
75-
</para>
75+
</simpara>
7676

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

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

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

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

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

@@ -299,8 +299,7 @@
299299
</informaltable>
300300
</sect2>
301301
</sect1>
302-
303-
<!-- Keep this comment at the end of the file
302+
<!-- Keep this comment at the end of the file
304303
Local variables:
305304
mode: sgml
306305
sgml-omittag:t

0 commit comments

Comments
 (0)