Skip to content

Commit b63df9b

Browse files
GirgiasGirgias
committed
fpm : fix XML by converting para to simpara tags via script
1 parent f0583e9 commit b63df9b

File tree

5 files changed

+57
-64
lines changed

5 files changed

+57
-64
lines changed

‎reference/fpm/book.xml‎

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

88
<preface xml:id="intro.fpm">
99
&reftitle.intro;
1010
&fpm.intro;
11-
<para>
11+
<simpara>
1212
この SAPI は、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: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: cbac1ecf71d754707d69bdc344c4031c157eaa54 Maintainer: satoruyoshida Status: ready -->
4-
<refentry xml:id="function.fastcgi-finish-request" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: satoruyoshida Status: ready -->
4+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.fastcgi-finish-request">
55
<refnamediv>
66
<refname>fastcgi_finish_request</refname>
77
<refpurpose>すべてのレスポンスデータをクライアントにフラッシュする</refpurpose>
@@ -11,14 +11,14 @@
1111
&reftitle.description;
1212
<methodsynopsis>
1313
<type>bool</type><methodname>fastcgi_finish_request</methodname>
14-
<void />
14+
<void/>
1515
</methodsynopsis>
16-
<para>
16+
<simpara>
1717
この関数は、すべてのレスポンスデータをクライアントにフラッシュし、
1818
リクエストを終わらせます。
1919
これにより、クライアントへの接続を開いたままにすることなく、
2020
時間のかかる処理を実行することができます。
21-
</para>
21+
</simpara>
2222
</refsect1>
2323

2424
<refsect1 role="parameters">
@@ -28,12 +28,11 @@
2828

2929
<refsect1 role="returnvalues">
3030
&reftitle.returnvalues;
31-
<para>
31+
<simpara>
3232
&return.success;
33-
</para>
33+
</simpara>
3434
</refsect1>
3535
</refentry>
36-
3736
<!-- Keep this comment at the end of the file
3837
Local variables:
3938
mode: sgml

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

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 5764345c8662c22b570bf453650a9dd584bd3abb Maintainer: mumumu Status: ready -->
4-
5-
<refentry xml:id="function.fpm-get-status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: mumumu Status: ready -->
4+
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.fpm-get-status">
65
<refnamediv>
76
<refname>fpm_get_status</refname>
87
<refpurpose>現在の FPMプール の状態を返す</refpurpose>
@@ -14,16 +13,16 @@
1413
<type class="union"><type>array</type><type>false</type></type><methodname>fpm_get_status</methodname>
1514
<void/>
1615
</methodsynopsis>
17-
<para>
16+
<simpara>
1817
この関数は、現在の FPMプール の状態を全て格納し、連想配列で返します。
1918
この関数は、プロセス単位の情報を含んだ、全ての状態を常に返します。
2019
詳細については、
2120
<link linkend="fpm.status">FPM の情報ページ</link>
2221
を参照ください。
23-
</para>
24-
<para>
22+
</simpara>
23+
<simpara>
2524
この関数は、FPM を使ってスクリプトを実行している場合にだけ定義されることに注意して下さい。
26-
</para>
25+
</simpara>
2726
</refsect1>
2827

2928
<refsect1 role="parameters">
@@ -33,13 +32,12 @@
3332

3433
<refsect1 role="returnvalues">
3534
&reftitle.returnvalues;
36-
<para>
35+
<simpara>
3736
FPMプール の状態を全て含む連想配列を返します。
3837
&return.falseforfailure;
39-
</para>
38+
</simpara>
4039
</refsect1>
4140
</refentry>
42-
4341
<!-- Keep this comment at the end of the file
4442
Local variables:
4543
mode: sgml

‎reference/fpm/setup.xml‎

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

7-
<para>
7+
<simpara>
88
FPM のインストールおよび設定についての情報は、PHP マニュアルの
99
<link linkend="install.fpm">インストールと設定</link> で見つかります。
10-
</para>
10+
</simpara>
1111

1212
</chapter>
13-
1413
<!-- Keep this comment at the end of the file
1514
Local variables:
1615
mode: sgml

‎reference/fpm/status.xml‎

Lines changed: 35 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,46 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: a4429100780d1d0d6ce204c11ad223f6526990ab Maintainer: mumumu Status: ready -->
4-
5-
<sect1 xml:id="fpm.status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<!-- EN-Revision: 0ba9e74ebc71fc8aa5fcd0f5f48654a4a6a83368 Maintainer: mumumu Status: ready -->
4+
<sect1 xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="fpm.status">
65
<title>FPM の情報ページ</title>
7-
8-
<para>
6+
7+
<simpara>
98
このページは、FPM の情報ページをセットアップする方法の説明と、
109
表示される内容について記しています。
1110
<function>fpm_get_status</function> も参照ください。
12-
</para>
11+
</simpara>
1312

1413
<sect2 xml:id="fpm.status.configuration">
1514
<title>設定</title>
16-
17-
<para>
15+
16+
<simpara>
1817
FPM の情報ページは、
1918
FPM プールの設定にある
2019
<link linkend="pm.status-path">pm.status_path</link>
2120
パラメータを設定することで有効にできます。
22-
</para>
21+
</simpara>
2322

2423
<caution>
25-
<para>
24+
<simpara>
2625
セキュリティを考慮して、
2726
FPM の情報ページへのアクセスは、
2827
内部的なリクエスト
2928
または既知のクライアントIPからのリクエストに限定すべきです。
3029
なぜなら、この情報ページはリクエストURLや、
3130
利用可能なリソースに関する情報を晒してしまっているからです。
32-
</para>
31+
</simpara>
3332
</caution>
34-
35-
<para>
33+
34+
<simpara>
3635
ウェブサーバーの設定によっては、
3736
PHP スクリプトをバイパスさせ、
3837
このパスへの直接アクセスを許可する必要があるかもしれません。
3938
Unix Domain Socket(UDS) 経由で listen している FPM と
40-
Apache を設定する例は、下記のようになります。
39+
Apache を設定する例は、下記のようになります。
4140
ここでは、
42-
<literal>pm.status_path</literal> に <literal>/fpm-status</literal>
41+
<literal>pm.status_path</literal> に <literal>/fpm-status</literal>
4342
を設定しています:
44-
</para>
43+
</simpara>
4544

4645
<informalexample>
4746
<programlisting role="apache-conf">
@@ -55,37 +54,37 @@
5554
</programlisting>
5655
</informalexample>
5756

58-
<para>
57+
<simpara>
5958
FPM とウェブサーバーをリロードまたは再起動した後、
6059
情報ページがブラウザからアクセスできるようになっているはずです。
6160
(IP アドレス制限が設定されている場合は、
6261
リクエストが許可したIPアドレスから来ている場合に限ります)
63-
</para>
62+
</simpara>
6463
</sect2>
6564

6665
<sect2 xml:id="fpm.status.parameters">
6766
<title>クエリパラメータ</title>
6867

69-
<para>
68+
<simpara>
7069
情報ページの出力フォーマットは、以下のクエリパラメータのうちひとつを指定することで変更できます:
71-
</para>
72-
70+
</simpara>
71+
7372
<simplelist>
7473
<member><literal>html</literal></member>
7574
<member><literal>json</literal></member>
7675
<member><literal>openmetrics</literal></member>
7776
<member><literal>xml</literal></member>
7877
</simplelist>
7978

80-
<para>
79+
<simpara>
8180
クエリパラメータ <literal>full</literal> を使うことで、
8281
追加の情報を出力させることもできます。
83-
</para>
84-
85-
<para>
82+
</simpara>
83+
84+
<simpara>
8685
情報ページのURLの例は、下記のとおりです:
87-
</para>
88-
86+
</simpara>
87+
8988
<simplelist>
9089
<member>
9190
<literal>https://localhost/fpm-status</literal>
@@ -105,17 +104,17 @@
105104
</member>
106105
</simplelist>
107106
</sect2>
108-
107+
109108
<sect2 xml:id="fpm.status.contents">
110109
<title>表示される情報</title>
111110

112-
<para>
111+
<simpara>
113112
日付/時刻 の値は、JSON と XML 出力では Unixタイムスタンプを使います。
114113
それ以外の場合は、
115114
<literal>"03/Jun/2021:07:21:46 +0100"</literal>
116115
のようなフォーマットを使います。
117-
</para>
118-
116+
</simpara>
117+
119118
<table>
120119
<title>基本情報 - 常に表示されます</title>
121120
<tgroup cols="2">
@@ -285,18 +284,18 @@
285284
</table>
286285

287286
<note>
288-
<para>
287+
<simpara>
289288
プールに特有の全ての値は、FPM が再起動されるとリセットされます。
290-
</para>
289+
</simpara>
291290
</note>
292291

293292
<note>
294-
<para>
293+
<simpara>
295294
OpenMetrics フォーマットの出力は、
296295
OpenMetrics に準拠した、異なるパラメータタイプを使います。
297296
出力のパラメータとその説明は、
298297
OpenMetrics フォーマット出力に含まれています。
299-
</para>
298+
</simpara>
300299
</note>
301300
</sect2>
302301

@@ -320,8 +319,7 @@
320319
</informaltable>
321320
</sect2>
322321
</sect1>
323-
324-
<!-- Keep this comment at the end of the file
322+
<!-- Keep this comment at the end of the file
325323
Local variables:
326324
mode: sgml
327325
sgml-omittag:t

0 commit comments

Comments
 (0)