1
0
mirror of https://github.com/php/doc-ja.git synced 2026-03-23 22:52:11 +01:00

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

This commit is contained in:
Gina Peter Banyard
2026-01-25 15:17:23 +00:00
parent d31534dbdc
commit ff82169f18
14 changed files with 111 additions and 121 deletions

View File

@@ -1,19 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<book xml:id="book.bzip2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.bzip2">
<?phpdoc extension-membership="bundledexternal" ?>
<title>Bzip2</title>
<!-- {{{ preface -->
<preface xml:id="intro.bzip2">
&reftitle.intro;
<para>
<simpara>
bzip2関数は、bzip2 (.bz2)
圧縮されたファイルを透過的に読み書きするために使用します。
</para>
</simpara>
</preface>
<!-- }}} -->
@@ -22,7 +21,6 @@
&reference.bzip2.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -43,4 +41,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -1,16 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: hirokawa Status: ready -->
<section xml:id="bzip2.installation" xmlns="http://docbook.org/ns/docbook">
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="bzip2.installation">
&reftitle.install;
<para>
<simpara>
PHP の <acronym>bzip2</acronym> サポートはデフォルトでは有効となっていません。
bzip2 サポートを有効とするには、PHP をコンパイルする際に設定オプション
<option role="configure">--with-bz2[=DIR]</option>
を使用する必要があります。
</para>
を使用する必要があります。
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,14 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<chapter xml:id="bzip2.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="bzip2.examples">
&reftitle.examples;
<para>
<simpara>
この例は、テンポラリファイルをオープンし、テスト用の文字列を書き込みます。
この後、このファイルの内容を出力します。
</para>
</simpara>
<example>
<title>簡単な bzip2 の例</title>
<programlisting role="php">
@@ -43,7 +42,6 @@ bzclose($bz);
</programlisting>
</example>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -64,4 +62,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzclose">
<refnamediv>
@@ -13,9 +13,9 @@
<type>bool</type><methodname>bzclose</methodname>
<methodparam><type>resource</type><parameter>bz</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
与えられた bzip2 ファイルポインタを閉じます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -23,19 +23,19 @@
<varlistentry>
<term><parameter>bz</parameter></term>
<listitem>
<para>
<simpara>
ファイルポインタ。これは有効である必要があり、
<function>bzopen</function> によりオープンされたファイルを指している必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzcompress">
<refnamediv>
@@ -15,10 +15,10 @@
<methodparam choice="opt"><type>int</type><parameter>block_size</parameter><initializer>4</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>work_factor</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>bzcompress</function> は、与えられた文字列を圧縮し、
bzip2 形式のデータとして返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -26,41 +26,41 @@
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
圧縮する文字列
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>block_size</parameter></term>
<listitem>
<para>
<simpara>
圧縮時のブロック長を指定します。
1 から 9 の数とする必要があります。この場合、9
の圧縮度が最大ですが、リソースの消費量も最大となります。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>work_factor</parameter></term>
<listitem>
<para>
<simpara>
繰り返しが多い、最悪の入力データの場合の圧縮処理の動作を制御します。
この値は、0 から 250 までとなり、0 は特別な場合です。
</para>
<para>
</simpara>
<simpara>
<parameter>work_factor</parameter> によらず、
生成される出力は同じになります。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
圧縮された文字列、もしくはエラー時はエラー数
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.bzdecompress">
<refnamediv>
@@ -14,10 +14,10 @@
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>use_less_memory</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>bzdecompress</function> は、bzip2
形式のデータを含む文字列を解凍します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -25,33 +25,33 @@
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
解凍する文字列
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>use_less_memory</parameter></term>
<listitem>
<para>
<simpara>
&true; の場合、よりメモリの消
費量が少ない (所要メモリは最大2300K程度まで少なくなります)
別の圧縮アルゴリズムが使用されますが、速度は約半分になってしまいます。
</para>
<para>
</simpara>
<simpara>
この機能に関する詳細については、<link xlink:href="&url.bzip2;">bzip2
ドキュメント</link> を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
解凍された文字列、もしくは or &false;
エラー時はエラー数を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzerrno">
<refnamediv>
@@ -13,10 +13,10 @@
<type>int</type><methodname>bzerrno</methodname>
<methodparam><type>resource</type><parameter>bz</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
与えられたファイルポインタから返された bzip2
エラーのエラー番号を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -24,20 +24,20 @@
<varlistentry>
<term><parameter>bz</parameter></term>
<listitem>
<para>
<simpara>
ファイルポインタ。これは有効である必要があり、
<function>bzopen</function> によりオープンされたファイルを指してい
る必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
整数としてのエラー番号を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzerror">
<refnamediv>
@@ -13,10 +13,10 @@
<type>array</type><methodname>bzerror</methodname>
<methodparam><type>resource</type><parameter>bz</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
与えられたファイルポインタから返された bzip2
エラーのエラー番号とエラー文字列を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -24,21 +24,21 @@
<varlistentry>
<term><parameter>bz</parameter></term>
<listitem>
<para>
<simpara>
ファイルポインタ。これは有効である必要があり、
<function>bzopen</function> によりオープンされたファイルを指してい
る必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
<literal>errno</literal> エントリにエラーコード、<literal>errstr</literal>
エントリにエラーメッセージを持つ連想配列を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzerrstr">
<refnamediv>
@@ -13,10 +13,10 @@
<type>string</type><methodname>bzerrstr</methodname>
<methodparam><type>resource</type><parameter>bz</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
与えられたファイルポインタから返された bzip2
エラーのエラーの文字列を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -24,20 +24,20 @@
<varlistentry>
<term><parameter>bz</parameter></term>
<listitem>
<para>
<simpara>
ファイルポインタ。これは有効である必要があり、
<function>bzopen</function> によりオープンされたファイルを指してい
る必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
エラーメッセージを含む文字列を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzflush">
<refnamediv>
@@ -15,11 +15,11 @@
<type>bool</type><methodname>bzflush</methodname>
<methodparam><type>resource</type><parameter>bz</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
バッファリングされた全ての bzip2 データをファイルポインタ
<parameter>bz</parameter> に書き込むことが想定された関数です。
しかし、libbz2 では null な関数として実装されており、何もしません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,20 +27,20 @@
<varlistentry>
<term><parameter>bz</parameter></term>
<listitem>
<para>
<simpara>
ファイルポインタ。これは有効である必要があり、
<function>bzopen</function> によりオープンされたファイルを指してい
る必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzopen">
<refnamediv>
@@ -14,10 +14,10 @@
<methodparam><type class="union"><type>string</type><type>resource</type></type><parameter>file</parameter></methodparam>
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>bzopen</function> は、
bzip2 (<filename>.bz2</filename>) ファイルを読み書き用にオープンします。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -25,29 +25,29 @@
<varlistentry>
<term><parameter>file</parameter></term>
<listitem>
<para>
<simpara>
オープンするファイル名、あるいは既存のストリームリソース
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
<simpara>
<literal>'r'</literal> (読み込み) と <literal>'w'</literal> (書き込み) だけをサポートしています。
それ以外を指定すると <function>bzopen</function>&false; を返します。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
オープンできなかった場合、<function>bzopen</function>&false;
を返します。それ以外の場合は、
新規にオープンされたファイルへのポインタが返されます。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzread">
<refnamediv>
@@ -14,14 +14,14 @@
<methodparam><type>resource</type><parameter>bz</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>length</parameter><initializer>1024</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>bzread</function> は、与えられた bzip2
ファイルポインタから読み込みます。
</para>
<para>
</simpara>
<simpara>
読み込みは、(圧縮前の状態で) <parameter>length</parameter>
バイトが読み込まれたか、EOF に達したかのどちらか最初に来た方で終了します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -29,30 +29,30 @@
<varlistentry>
<term><parameter>bz</parameter></term>
<listitem>
<para>
<simpara>
ファイルポインタ。これは有効である必要があり、
<function>bzopen</function> によりオープンされたファイルを指してい
る必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>length</parameter></term>
<listitem>
<para>
<simpara>
指定されない場合、<function>bzread</function>
は一度に (圧縮前の状態で) 1024バイト読み込みます。
最大で 8192 バイト (圧縮前) までを一度に読み込みます。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
非圧縮データ、もしくはエラー時に &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b621a6e473bc13afb6a0f50f73318178f81df2e3 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka,mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzwrite">
<refnamediv>
@@ -15,10 +15,10 @@
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>bzwrite</function> は、文字列を与えられた bzip2
ファイルストリームに書き込みます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -26,38 +26,38 @@
<varlistentry>
<term><parameter>bz</parameter></term>
<listitem>
<para>
<simpara>
ファイルポインタ。これは有効である必要があり、
<function>bzopen</function> によりオープンされたファイルを指してい
る必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
書き込むデータ
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>length</parameter></term>
<listitem>
<para>
<simpara>
指定した場合、
(圧縮前の) <parameter>length</parameter> バイト分の書き込みが終ったか、
<parameter>data</parameter> の終端に達したかで書き込みは終了します。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
書き込んだバイト数、もしくはエラー時に &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">

View File

@@ -1,20 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 765b2d6eec7dfbaeed900b32aa91a1360d73df42 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<chapter xml:id="bzip2.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="bzip2.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="bzip2.requirements">
&reftitle.required;
<para>
このモジュールは、Julian Seward により作成された
<simpara>
このモジュールは、Julian Seward により作成された
<link xlink:href="&url.bzip2;">bzip2</link>ライブラリの関数を使用しています。
このモジュールには、bzip2/libbzip2
のバージョン &gt;= 1.0.x が必要です。
</para>
</simpara>
</section>
<!-- }}} -->
@@ -25,15 +24,14 @@
<!-- {{{ Resources -->
<section xml:id="bzip2.resources">
&reftitle.resources;
<para>
<simpara>
この拡張モジュールは、リソース型として処理を行う
bz2 ファイルを指すファイルポインタを定義します。
</para>
</simpara>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -54,4 +52,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->