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

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

This commit is contained in:
Gina Peter Banyard
2026-01-18 22:08:27 +00:00
parent a3ed5d7cdf
commit 78713279e0
7 changed files with 62 additions and 73 deletions

View File

@@ -1,30 +1,28 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: takagi Status: ready -->
<book xml:id="book.expect" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: ca6054f609661c9d0513aad1e7db1d8fdf33bed8 Maintainer: takagi Status: ready -->
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.expect">
<?phpdoc extension-membership="pecl" ?>
<title>Expect</title>
<!-- {{{ preface -->
<preface xml:id="intro.expect">
&reftitle.intro;
<para>
<simpara>
この拡張モジュールは、PTY を経由したプロセス同士の対話機能を提供します。
<link linkend="ref.filesystem">ファイルシステム関数</link>
<link linkend="wrappers.expect"><literal>expect://</literal> ラッパー</link>
を利用すれば、シンプルでより直感的なインターフェイスが利用できるでしょう。
</para>
</simpara>
</preface>
<!-- }}} -->
&reference.expect.setup;
&reference.expect.constants;
&reference.expect.examples;
&reference.expect.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -45,4 +43,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -1,24 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fbc4ef92fa953823ed73021e462bd291499dc633 Maintainer: takagi Status: ready -->
<section xml:id="expect.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: ca6054f609661c9d0513aad1e7db1d8fdf33bed8 Maintainer: takagi Status: ready -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="expect.installation">
&reftitle.install;
<para>
<simpara>
&pecl.moved;
&pecl.info;
<link xlink:href="&url.pecl.package;expect">&url.pecl.package;expect</link>.
</para>
<para>
</simpara>
<simpara>
これらの関数を使用するには、<option role="configure">--with-expect[=DIR]</option>
オプションを使用して expect サポートつきで PHP をコンパイルする必要があります。
</para>
<para>
</simpara>
<simpara>
Windows ユーザーは、これらの関数を使用するためには &php.ini; の中で
<filename>php_expect.dll</filename> を有効にします。
&pecl.windows.download;
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -39,4 +38,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: takagi Status: ready -->
<chapter xml:id="expect.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: ca6054f609661c9d0513aad1e7db1d8fdf33bed8 Maintainer: takagi Status: ready -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="expect.examples">
&reftitle.examples;
<section xml:id="expect.examples-usage">
<title>Expect の使用例</title>
<example>
<title>Expect の使用例</title>
<para>
<simpara>
この例ではリモートホストに SSH 経由で接続し、接続先の稼働時間を表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -26,7 +25,7 @@ switch (expect_expectl ($stream, $cases)) {
case PASSWORD:
fwrite ($stream, "password\n");
break;
default:
die ("リモートホストへの接続時にエラーが発生しました!\n");
}
@@ -40,11 +39,11 @@ fclose ($stream);
</programlisting>
</example>
<para>
<simpara>
次の例は、リモートホストに接続して
インストールされている OS が 32 ビットか 64 ビットかを確認し、
それぞれのパッケージのアップデートを実行します。
</para>
</simpara>
<example>
<title>もうひとつの Expect の使用例</title>
<programlisting role="php">
@@ -116,7 +115,6 @@ fclose ($stream);
</example>
</section>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -137,4 +135,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: 1ad8299bbc5c7d1b5dcf6883aaba0f7dbc4f116f Maintainer: takagi Status: ready -->
<!-- EN-Revision: ca6054f609661c9d0513aad1e7db1d8fdf33bed8 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.expect-expectl">
<refnamediv>
@@ -17,11 +17,11 @@
<methodparam><type>array</type><parameter>cases</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter role="reference">match</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
プロセスの出力がパターンに一致する・指定した時間が経過する・
あるいは <acronym>EOF</acronym> に達するのいずれかにあてはまるまで待ち続けます。
</para>
<para>
</simpara>
<simpara>
<parameter>match</parameter>
を指定すると、検索結果がそこに保存されます。
一致した文字列が <parameter>match[0]</parameter> に保存され、
@@ -29,7 +29,7 @@
<parameter>match[1]</parameter><parameter>match[2]</parameter>
と順に、最大 <parameter>match[9]</parameter> まで
(libexpect の制限です) 保存されます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -37,10 +37,10 @@
<varlistentry>
<term><parameter>expect</parameter></term>
<listitem>
<para>
<simpara>
事前に <function>expect_popen</function> でオープンした
Expect ストリーム。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -100,17 +100,17 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
一致したパターンに関連付けられた値を返します。
</para>
<para>
</simpara>
<simpara>
この関数の実行に失敗した場合は、
<link linkend="constant.exp-eof"><constant>EXP_EOF</constant></link>
<link linkend="constant.exp-timeout"><constant>EXP_TIMEOUT</constant></link>
あるいは
<link linkend="constant.exp-fullbuffer"><constant>EXP_FULLBUFFER</constant></link>
を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1ad8299bbc5c7d1b5dcf6883aaba0f7dbc4f116f Maintainer: takagi Status: ready -->
<!-- EN-Revision: ca6054f609661c9d0513aad1e7db1d8fdf33bed8 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.expect-popen">
<refnamediv>
<refname>expect_popen</refname>
@@ -13,10 +13,10 @@
<type>resource</type><methodname>expect_popen</methodname>
<methodparam><type>string</type><parameter>command</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Bourne シェル経由でコマンドを実行し、プロセスへの PTY ストリームを
オープンします。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -24,21 +24,21 @@
<varlistentry>
<term><parameter>command</parameter></term>
<listitem>
<para>
<simpara>
実行するコマンド。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
プロセスの標準入力・標準出力・標準エラー出力への PTY ストリームを返します。
</para>
<para>
</simpara>
<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: 1ad8299bbc5c7d1b5dcf6883aaba0f7dbc4f116f Maintainer: takagi Status: ready -->
<!-- EN-Revision: ca6054f609661c9d0513aad1e7db1d8fdf33bed8 Maintainer: takagi Status: ready -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="expect.configuration">
&reftitle.runtime;
&extension.runtime;
@@ -59,18 +59,18 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
データを待ち受ける際のタイムアウト時間です。
<function>expect_expectl</function> 関数で使用されます。
</para>
<para>
</simpara>
<simpara>
"-1" を指定すると、タイムアウトを発生させないようにします。
</para>
</simpara>
<note>
<para>
<simpara>
"0" を指定すると、<function>expect_expectl</function> 関数は
結果を直ちに返します。
</para>
</simpara>
</note>
</listitem>
</varlistentry>
@@ -81,11 +81,11 @@
<type>bool</type>
</term>
<listitem>
<para>
<simpara>
expect が、子プロセスの出力を標準出力に送るかどうかを指定します。
典型的な対話型プログラムは入力した内容を表示するので、これを使用すれば
対話の両方の側を表示することができます。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -95,16 +95,16 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
子プロセスの出力内容が書き込まれるファイルの名前。もしファイルが
存在しない場合は新しく作成されます。
</para>
</simpara>
<note>
<para>
<simpara>
この設置が空欄でなかった場合、
<link linkend="ini.expect.loguser">expect.loguser</link> の設定内容に
かかわらず出力が書き込まれます。
</para>
</simpara>
</note>
</listitem>
</varlistentry>
@@ -115,10 +115,10 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
パターン内のアスタリスクとのマッチに使うバッファのデフォルトサイズ
(2000 バイト) を変更します。
</para>
</simpara>
</listitem>
</varlistentry>

View File

@@ -1,17 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: takagi Status: ready -->
<chapter xml:id="expect.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: ca6054f609661c9d0513aad1e7db1d8fdf33bed8 Maintainer: takagi Status: ready -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="expect.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="expect.requirements">
&reftitle.required;
<para>
<simpara>
このモジュールは <link xlink:href="&url.expect;">expect</link> ライブラリの
関数を使用します。libexpect バージョン &gt;= 5.43.0 が必要です。
</para>
</simpara>
</section>
<!-- }}} -->
@@ -26,16 +25,15 @@
<!-- {{{ Resources -->
<section xml:id="expect.resources">
&reftitle.resources;
<para>
<simpara>
<function>expect_popen</function> は、オープンした PTY
ストリームを返します。これを <function>expect_expectl</function>
で使用します。
</para>
</simpara>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -56,4 +54,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->