Skip to content

Commit e12ddda

Browse files
committed
[reference/phar] sync with en.
1 parent f6e7dba commit e12ddda

File tree

12 files changed

+46
-47
lines changed

12 files changed

+46
-47
lines changed

reference/phar/Phar/copy.xml

Lines changed: 8 additions & 5 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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 8d09722b6d95d2545d5a4c9415c6955efc3a464e Maintainer: takagi Status: ready -->
44
<refentry xml:id="phar.copy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>Phar::copy</refname>
@@ -10,7 +10,7 @@
1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="Phar">
13-
<modifier>public</modifier> <type>bool</type><methodname>Phar::copy</methodname>
13+
<modifier>public</modifier> <type>true</type><methodname>Phar::copy</methodname>
1414
<methodparam><type>string</type><parameter>from</parameter></methodparam>
1515
<methodparam><type>string</type><parameter>to</parameter></methodparam>
1616
</methodsynopsis>
@@ -48,8 +48,7 @@
4848
<refsect1 role="returnvalues">
4949
&reftitle.returnvalues;
5050
<para>
51-
成功した場合に &true; を返します。しかし、より安全を期すなら
52-
try/catch ブロック内で使用して例外がスローされないことを確認するといいでしょう。
51+
&return.true.always;
5352
</para>
5453
</refsect1>
5554

@@ -80,11 +79,14 @@
8079
<programlisting role="php">
8180
<![CDATA[
8281
<?php
82+
8383
try {
8484
$phar = new Phar('myphar.phar');
85+
8586
$phar['a'] = 'hi';
8687
$phar->copy('a', 'b');
87-
echo $phar['b']; // 出力は "hi"
88+
89+
echo $phar['b']; // 出力は "phar://myphar.phar/b"
8890
} catch (Exception $e) {
8991
// エラー処理
9092
}
@@ -93,6 +95,7 @@ try {
9395
// エラー時には例外ではなく E_WARNINGS が発生します
9496
copy('phar://myphar.phar/a', 'phar//myphar.phar/c');
9597
echo file_get_contents('phar://myphar.phar/c'); // 出力は "hi"
98+
9699
?>
97100
]]>
98101
</programlisting>

reference/phar/Phar/decompressFiles.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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="phar.decompressfiles" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>Phar::decompressFiles</refname>
@@ -10,7 +10,7 @@
1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="Phar">
13-
<modifier>public</modifier> <type>bool</type><methodname>Phar::decompressFiles</methodname>
13+
<modifier>public</modifier> <type>true</type><methodname>Phar::decompressFiles</methodname>
1414
<void/>
1515
</methodsynopsis>
1616
&phar.write;
@@ -42,7 +42,7 @@
4242
<refsect1 role="returnvalues">
4343
&reftitle.returnvalues;
4444
<para>
45-
&return.success;
45+
&return.true.always;
4646
</para>
4747
</refsect1>
4848

reference/phar/Phar/delMetadata.xml

Lines changed: 3 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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="phar.delmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>Phar::delMetadata</refname>
@@ -10,7 +10,7 @@
1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="Phar">
13-
<modifier>public</modifier> <type>bool</type><methodname>Phar::delMetadata</methodname>
13+
<modifier>public</modifier> <type>true</type><methodname>Phar::delMetadata</methodname>
1414
<void/>
1515
</methodsynopsis>
1616
&phar.write;
@@ -29,8 +29,7 @@
2929
<refsect1 role="returnvalues">
3030
&reftitle.returnvalues;
3131
<para>
32-
成功した場合に &true; を返します。しかし、より安全を期すなら
33-
try/catch ブロック内で使用して例外がスローされないことを確認するといいでしょう。
32+
&return.true.always;
3433
</para>
3534
</refsect1>
3635

reference/phar/Phar/delete.xml

Lines changed: 3 additions & 5 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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="phar.delete" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>Phar::delete</refname>
@@ -10,7 +10,7 @@
1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="Phar">
13-
<modifier>public</modifier> <type>bool</type><methodname>Phar::delete</methodname>
13+
<modifier>public</modifier> <type>true</type><methodname>Phar::delete</methodname>
1414
<methodparam><type>string</type><parameter>localName</parameter></methodparam>
1515
</methodsynopsis>
1616
&phar.write;
@@ -41,9 +41,7 @@
4141
<refsect1 role="returnvalues">
4242
&reftitle.returnvalues;
4343
<para>
44-
成功した場合に &true; を返します。
45-
しかし、例外がスローされているかどうかを確認したうえで
46-
例外がなければ成功とみなすほうがいいでしょう。
44+
&return.true.always;
4745
</para>
4846
</refsect1>
4947

reference/phar/Phar/unlinkArchive.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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="phar.unlinkarchive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>Phar::unlinkArchive</refname>
@@ -10,7 +10,7 @@
1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="Phar">
13-
<modifier>final</modifier> <modifier>public</modifier> <modifier>static</modifier> <type>bool</type><methodname>Phar::unlinkArchive</methodname>
13+
<modifier>final</modifier> <modifier>public</modifier> <modifier>static</modifier> <type>true</type><methodname>Phar::unlinkArchive</methodname>
1414
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
1515
</methodsynopsis>
1616
<para>
@@ -38,7 +38,7 @@
3838
<refsect1 role="returnvalues">
3939
&reftitle.returnvalues;
4040
<para>
41-
&return.success;
41+
&return.true.always;
4242
</para>
4343
</refsect1>
4444

reference/phar/PharData/copy.xml

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 8d09722b6d95d2545d5a4c9415c6955efc3a464e Maintainer: takagi Status: ready -->
44
<refentry xml:id="phardata.copy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>PharData::copy</refname>
7-
<refpurpose>phar アーカイブ内のファイルを、phar 内で別の新しいファイルとしてコピーする</refpurpose>
7+
<refpurpose>tar/zip アーカイブ内のファイルを、同じアーカイブ内で別の新しいファイルとしてコピーする</refpurpose>
88
</refnamediv>
99

1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="PharData">
13-
<modifier>public</modifier> <type>bool</type><methodname>PharData::copy</methodname>
13+
<modifier>public</modifier> <type>true</type><methodname>PharData::copy</methodname>
1414
<methodparam><type>string</type><parameter>from</parameter></methodparam>
1515
<methodparam><type>string</type><parameter>to</parameter></methodparam>
1616
</methodsynopsis>
@@ -47,8 +47,7 @@
4747
<refsect1 role="returnvalues">
4848
&reftitle.returnvalues;
4949
<para>
50-
成功した場合に &true; を返します。しかし、より安全を期すなら
51-
try/catch ブロック内で使用して例外がスローされないことを確認するといいでしょう。
50+
&return.true.always;
5251
</para>
5352
</refsect1>
5453

@@ -79,10 +78,13 @@
7978
<programlisting role="php">
8079
<![CDATA[
8180
<?php
81+
8282
try {
8383
$phar = new PharData('myphar.tar');
84+
8485
$phar['a'] = 'hi';
8586
$phar->copy('a', 'b');
87+
8688
echo $phar['b']; // 出力は "phar://myphar.tar/b"
8789
} catch (Exception $e) {
8890
// エラー処理
@@ -92,6 +94,7 @@ try {
9294
// エラー時には例外ではなく E_WARNINGS が発生します
9395
copy('phar://myphar.tar/a', 'phar//myphar.tar/c');
9496
echo file_get_contents('phar://myphar.tar/c'); // 出力は "hi"
97+
9598
?>
9699
]]>
97100
</programlisting>

reference/phar/PharData/decompressFiles.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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="phardata.decompressfiles" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>PharData::decompressFiles</refname>
@@ -10,7 +10,7 @@
1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="PharData">
13-
<modifier>public</modifier> <type>bool</type><methodname>PharData::decompressFiles</methodname>
13+
<modifier>public</modifier> <type>true</type><methodname>PharData::decompressFiles</methodname>
1414
<void/>
1515
</methodsynopsis>
1616
&phar.write;
@@ -39,7 +39,7 @@
3939
<refsect1 role="returnvalues">
4040
&reftitle.returnvalues;
4141
<para>
42-
&return.success;
42+
&return.true.always;
4343
</para>
4444
</refsect1>
4545

reference/phar/PharData/delMetadata.xml

Lines changed: 3 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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="phardata.delmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>PharData::delMetadata</refname>
@@ -10,7 +10,7 @@
1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="PharData">
13-
<modifier>public</modifier> <type>bool</type><methodname>PharData::delMetadata</methodname>
13+
<modifier>public</modifier> <type>true</type><methodname>PharData::delMetadata</methodname>
1414
<void/>
1515
</methodsynopsis>
1616
&phar.write;
@@ -29,8 +29,7 @@
2929
<refsect1 role="returnvalues">
3030
&reftitle.returnvalues;
3131
<para>
32-
成功した場合に &true; を返します。しかし、より安全を期すなら
33-
例外がスローされないことを確認するといいでしょう。
32+
&return.true.always;
3433
</para>
3534
</refsect1>
3635

reference/phar/PharData/delete.xml

Lines changed: 3 additions & 5 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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="phardata.delete" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>PharData::delete</refname>
@@ -10,7 +10,7 @@
1010
<refsect1 role="description">
1111
&reftitle.description;
1212
<methodsynopsis role="PharData">
13-
<modifier>public</modifier> <type>bool</type><methodname>PharData::delete</methodname>
13+
<modifier>public</modifier> <type>true</type><methodname>PharData::delete</methodname>
1414
<methodparam><type>string</type><parameter>localName</parameter></methodparam>
1515
</methodsynopsis>
1616

@@ -40,9 +40,7 @@
4040
<refsect1 role="returnvalues">
4141
&reftitle.returnvalues;
4242
<para>
43-
成功した場合に &true; を返します。
44-
しかし、例外がスローされているかどうかを確認したうえで
45-
例外がなければ成功とみなすほうがいいでしょう。
43+
&return.true.always;
4644
</para>
4745
</refsect1>
4846

reference/phar/PharFileInfo/compress.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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: takagi Status: ready -->
44
<refentry xml:id="pharfileinfo.compress" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>PharFileInfo::compress</refname>
@@ -9,7 +9,7 @@
99
<refsect1 role="description">
1010
&reftitle.description;
1111
<methodsynopsis role="PharFileInfo">
12-
<modifier>public</modifier> <type>bool</type><methodname>PharFileInfo::compress</methodname>
12+
<modifier>public</modifier> <type>true</type><methodname>PharFileInfo::compress</methodname>
1313
<methodparam><type>int</type><parameter>compression</parameter></methodparam>
1414
</methodsynopsis>
1515

@@ -47,7 +47,7 @@
4747
<refsect1 role="returnvalues">
4848
&reftitle.returnvalues;
4949
<para>
50-
&return.success;
50+
&return.true.always;
5151
</para>
5252
</refsect1>
5353

0 commit comments

Comments
 (0)