Skip to content

Commit 89aa72b

Browse files
KentarouTakedaKentarouTakeda
authored
doc-en と同期し &true;/&false;/&null; のエンティティ化ほかを反映（32ファイル） (#408)
* &true;/&false;/&null; のエンティティ化ほかを同期（18ファイル） php/doc-en@911fe79de7 (Use &true;/&false;/&null; entities for boolean/null constants) のマークアップ変更を反映。 - <literal>true/false/null</literal> のうち PHP の定数を表す箇所を &true;/&false;/&null; に置換（型表記の <type>false</type>、コード例内、 引用符付きの入力値リテラルは原文どおり保持） - あわせて同一リビジョン範囲の para→simpara 置換、雛形コメントの除去 （php/doc-en@c62ef37e0d）、PHP_INI_* から <constant>INI_*</constant> への 変更（php/doc-en@d4d5216e7a）、union 型の null 後置 （php/doc-en@77485af088）をミラー - reference/win32service/rightinfo/get-full-username.xml は、原文が同一 リビジョンで returnvalues の散文も書き換えているため訳文を更新。原文が "returns only the username" と限定を明示する形になったのに合わせ 「ユーザー名のみを返します」とし、旧原文の連鎖構造に由来する「ユーザー名も」 の「も」を落とした - language/enumerations.xml と language/oop5/overloading.xml は既に &null; を 使用済みのため EN-Revision のみ更新 対象: language (6), reference/datetime (3), reference/mbstring (2), reference/pdo (2), reference/filter (1), reference/info (1), reference/intl (1), reference/reflection (1), reference/win32service (1) * PECL 拡張の綴り修正と DocBook 整形を同期（14ファイル） php/doc-en@6047c10c1f (Fix codespell typos in actively maintained PECL extensions) の変更を反映。訳文の散文に変更はない。 - 英語の綴り修正は、日本語版に逐語コピーされたまま残っている英語（未訳の パラメータ説明・サンプルコード内のコメントや文字列）にのみ反映。和訳済みの 箇所は原文の綴り修正が訳文に影響しないため変更していない - あわせてルート要素の属性順（xmlns / xml:id）と para→simpara の整形をミラー - reference/oci8/ini.xml では oci8.prefetch_lob_size の Changeable の誤りを 修正（INI_ALL → INI_SYSTEM）。原文が当該行を書き換えている同期対象行であり、 INI_ALL は ini_set() で実行時に変更できるという原文と正反対の意味になる 対象: reference/imagick (10), reference/oci8 (2), reference/ibm_db2 (1), reference/memcached (1)
1 parent a818fd9 commit 89aa72b

32 files changed

Lines changed: 96 additions & 101 deletions

File tree

‎language/control-structures/include.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55

66
<sect1 xml:id="function.include" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -179,7 +179,7 @@ include 'http://www.example.com/file.php?foo=1&bar=2';
179179
</para>
180180
<simpara>
181181
値の返し方: <literal>include</literal> に失敗したときには
182-
<literal>FALSE</literal> を返し、警告を発生させます。
182+
&false; を返し、警告を発生させます。
183183
成功した場合の戻り値は、インクルードしたファイル側で変更していない限りは
184184
<literal>1</literal> です。
185185
インクルードしたファイルの中で <function>return</function> を実行すれば、

‎language/enumerations.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 8af3521cb43f54c652baaf8dbbcb786b79a5d04e Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: mumumu Status: ready -->
44
<chapter xml:id="language.enumerations" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
55
<title>列挙型(Enum)</title>
66
<sect1 xml:id="language.enumerations.overview">

‎language/oop5/overloading.xml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d6f54016d62904cfd8200604aadd5e3f0d9bad97 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55

66
<sect1 xml:id="language.oop5.overloading" xmlns="http://docbook.org/ns/docbook">

‎language/predefined/weakreference.xml‎

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 7caf0c13762e7db3e7002b1286f23b65d940e2d0 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: mumumu Status: ready -->
44
<reference xml:id="class.weakreference" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
55

66
<title>WeakReference クラス</title>
77
<titleabbrev>WeakReference</titleabbrev>
88

99
<partintro>
1010

11-
<!-- {{{ WeakReference intro -->
1211
<section xml:id="weakreference.intro">
1312
&reftitle.intro;
1413
<para>
@@ -19,16 +18,14 @@
1918
元のオブジェクトは、<link linkend="features.gc.refcounting-basics">refcount</link> が 0 になると破棄されます。
2019
弱い参照を作成しても、参照されているオブジェクトの <literal>refcount</literal> は増加しません。
2120
</para>
22-
<para>
21+
<simpara>
2322
<classname>WeakReference</classname> クラスはシリアライズできません。
24-
</para>
23+
</simpara>
2524
</section>
26-
<!-- }}} -->
2725

2826
<section xml:id="weakreference.synopsis">
2927
&reftitle.classsynopsis;
3028

31-
<!-- {{{ Synopsis -->
3229
<classsynopsis class="class">
3330
<ooclass>
3431
<modifier>final</modifier>
@@ -43,7 +40,6 @@
4340
<xi:fallback/>
4441
</xi:include>
4542
</classsynopsis>
46-
<!-- }}} -->
4743

4844
</section>
4945

@@ -96,7 +92,7 @@ NULL
9692
<entry>
9793
<methodname>WeakReference::__debugInfo</methodname> の出力に、
9894
参照されたオブジェクトを含むようになりました。また、参照が有効ではなくなっている場合は、
99-
参照されたオブジェクトは <literal>NULL</literal> となります。
95+
参照されたオブジェクトは &null; となります。
10096
</entry>
10197
</row>
10298
</tbody>

‎language/types/array.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: bfdd82f3f6cde571a61de3fcea28a03145374dda Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<sect1 xml:id="language.types.array">
66
<title>配列</title>
@@ -125,7 +125,7 @@ var_dump($array1, $array2);
125125
<listitem>
126126
<simpara>
127127
<type>Null</type> は空文字列にキャストされます。つまり、キーに
128-
<literal>null</literal> を指定すると、実際には <literal>""</literal> として格納されます。
128+
&null; を指定すると、実際には <literal>""</literal> として格納されます。
129129
</simpara>
130130
</listitem>
131131
<listitem>

‎language/types/declarations.xml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 0ece873cecfc4dacd14e8bebbec12c6e00de56a0 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: mumumu Status: ready -->
44

55
<sect1 xml:id="language.types.declarations">
66
<title>型宣言</title>
@@ -313,14 +313,14 @@ Stack trace:
313313
</note>
314314

315315
<note>
316-
<para>
317-
デフォルト値に <literal>null</literal> を指定することで、
316+
<simpara>
317+
デフォルト値に &null; を指定することで、
318318
null を許容するパラメータを指定することができます。
319319
これは、子クラスでデフォルト値が変更された場合にクラスの互換性が壊れ、
320320
型宣言で <type>null</type>
321321
型を追加しなければならなくなるため、おすすめできません。
322322
この振る舞いは、PHP 8.4 以降は推奨されなくなっています。
323-
</para>
323+
</simpara>
324324
<example>
325325
<title>引数にnullを許容する古いやり方</title>
326326
<programlisting role="php">

‎reference/datetime/dateinterval/createfromdatestring.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 82f00c8d4d4f09fa5a363bc0c6f48e0c80eea72d Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55

66
<refentry xml:id="dateinterval.createfromdatestring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -99,7 +99,7 @@
9999
は <exceptionname>DateMalformedIntervalStringException</exceptionname>
100100
をスローするようになりました。
101101
これより前のバージョンでは、
102-
警告が発生して <literal>false</literal> を返していました。
102+
警告が発生して &false; を返していました。
103103
<function>date_interval_create_from_date_string</function>
104104
は変更されていません。
105105
</entry>

‎reference/datetime/datetime/modify.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 9eb962113cadccc164d196003062ff5d893de3a5 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55

66
<refentry xml:id="datetime.modify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -87,7 +87,7 @@
8787
は <exceptionname>DateMalformedStringException</exceptionname>
8888
をスローするようになりました。
8989
これより前のバージョンでは、
90-
警告が発生して <literal>false</literal> を返していました。
90+
警告が発生して &false; を返していました。
9191
<function>date_modify</function> は変更されていません。
9292
</entry>
9393
</row>

‎reference/datetime/datetimeimmutable/modify.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 726154e3c846bc0e16c60542377ea806df32e55d Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55

66
<refentry xml:id="datetimeimmutable.modify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -78,7 +78,7 @@
7878
は <exceptionname>DateMalformedStringException</exceptionname>
7979
をスローするようになりました。
8080
これより前のバージョンでは、
81-
警告が発生して <literal>false</literal> を返していました。
81+
警告が発生して &false; を返していました。
8282
</entry>
8383
</row>
8484
</tbody>

‎reference/filter/constants.xml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 1c5ff30e9ae64bd4fd7ebbd0cccfb1e642e1b02c Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: takagi Status: ready -->
44
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
55
<!-- Credits: mumumu -->
66

@@ -288,7 +288,7 @@
288288
<literal>"1"</literal>,
289289
2進数、8進数、16進数記法の <literal>1</literal>,
290290
科学的記法を含む <literal>1.0</literal>,
291-
<literal>"true"</literal>, <literal>true</literal>,
291+
<literal>"true"</literal>, &true;,
292292
<literal>"on"</literal>,
293293
<literal>"yes"</literal>
294294
に対して、&true; を返します。
@@ -297,7 +297,7 @@
297297
<literal>"0"</literal>,
298298
2進数、8進数、16進数記法の <literal>0</literal>,
299299
科学的記法を含む <literal>0.0</literal>,
300-
<literal>"false"</literal>, <literal>false</literal>,
300+
<literal>"false"</literal>, &false;,
301301
<literal>"off"</literal>,
302302
<literal>"no"</literal>,
303303
<literal>""</literal> に対して、&false; を返します。

0 commit comments

Comments
 (0)