php/archived-doc-ja
1
0
Fork 0
mirror of https://github.com/php/doc-ja.git synced 2026-03-23 22:52:11 +01:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-18 22:20:48 +00:00
parent 7a8b7b5509
commit 29cbdce9d0
41 changed files with 502 additions and 519 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
reference/ev/book.xml
View File

@@ -1,41 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0f7d81c13c60336b1f8662d3d52a942358bd0c7c Maintainer: takagi Status: ready -->
<book xml:id="book.ev" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.ev">
<?phpdoc extension-membership="pecl" ?>
<title>Ev</title>
<titleabbrev>Ev</titleabbrev>
<preface xml:id="intro.ev">
&reftitle.intro;
<para>
<simpara>
この拡張モジュールは、
<link
xlink:href="&url.libev;">libev</link> ライブラリへのインターフェイスを提供します。
<link xlink:href="&url.libev;">libev</link> ライブラリへのインターフェイスを提供します。
このライブラリは、C で書かれたハイパフォーマンスで高機能なイベントループです。
</para>
</simpara>
&note.no-windows.extension;
<para>
<simpara>
<emphasis>Libev</emphasis>
はイベントループです。何か興味のあるイベント
(ファイルディスクリプタが読み込み可能になった、あるいはタイムアウトが発生したなど)
を登録すると、そのイベントの発生元を管理してプログラムにイベントを提供します。
</para>
<para>
</simpara>
<simpara>
そのためには、イベントループハンドラを実行して
プロセス (あるいはスレッド) を完全に制御する必要があります。
イベントとの通信には、コールバックの仕組みを利用します。
</para>
<para>
</simpara>
<simpara>
興味のあるイベントを登録するには、イベントウォッチャーを登録します。
そして、ウォッチャーを開始して libev に手渡します。
</para>
<para>
</simpara>
<simpara>
詳細は
<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod">
libev のドキュメント</link> を参照ください。
</para>
</simpara>
</preface>
&reference.ev.setup;

12
reference/ev/configure.xml
View File

@@ -1,18 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8d666e819852f6b0561b40fcf8689b747568865c Maintainer: takagi Status: ready -->
<section xml:id="ev.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.installation">
&reftitle.install;
<para>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;ev">&url.pecl.package;ev</link>
</para>
<para>
</simpara>
<simpara>
手動でのインストールの方法については、パッケージのソースに含まれる
<filename>INSTALL.md</filename>
ファイルをごらんください。
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:

177
reference/ev/ev.xml
View File

@@ -1,16 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<reference xml:id="class.ev" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.ev" role="class">
<title>Ev クラス</title>
<titleabbrev>Ev</titleabbrev>
<partintro>
<!-- {{{ Ev intro -->
<section xml:id="ev.intro">
&reftitle.intro;
<para>
<simpara>
Ev は静的クラスで、デフォルトのループへのアクセスや各種共通操作へのアクセスを提供します。
</para>
</simpara>
</section>
<!-- }}} -->
<section xml:id="ev.synopsis">
@@ -237,7 +237,7 @@
</fieldsynopsis>
<!--}}}-->
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.ev')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.ev')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"/>
</classsynopsis>
<!-- }}} -->
</section>
@@ -254,9 +254,9 @@
<constant>Ev::FLAG_AUTO</constant>
</term>
<listitem>
<para>
<simpara>
デフォルトのフラグの値。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.flag-noenv">
@@ -264,14 +264,14 @@
<constant>Ev::FLAG_NOENV</constant>
</term>
<listitem>
<para>
<simpara>
このフラグを使う (あるいは setuid や setgid でプログラムを実行する) と、
<literal>libev</literal> は環境変数
<varname>LIBEV_FLAGS</varname> を見ません。
それ以外の場合 (デフォルト) は、
<varname>LIBEV_FLAGS</varname> が見つかった場合は
その内容でフラグを上書きします。パフォーマンステストやバグの調査のときに有用です。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.flag-forkcheck">
@@ -279,7 +279,7 @@
<constant>Ev::FLAG_FORKCHECK</constant>
</term>
<listitem>
<para>
<simpara>
libev が繰り返しのたびにフォークをチェックするようにします。毎回手動で
<methodname>EvLoop::fork</methodname> を呼ぶことがなくなります。
これを実現するために、ループ内での繰り返しの旅に
@@ -287,7 +287,7 @@
そのため、繰り返しの回数が増えるとイベントループがスローダウンするかもしれませんが、
通常は気になるほどではありません。このフラグの設定を上書きしたり、
環境変数 <varname>LIBEV_FLAGS</varname> で指定したりすることはできません。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.flag-noinotify">
@@ -295,11 +295,10 @@
<constant>Ev::FLAG_NOINOTIFY</constant>
</term>
<listitem>
<para>
<simpara>
このフラグを指定すると、
<literal>libev</literal>
は <link
xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_stat_code_did_the_file_attri">ev_stat</link>
は <link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_stat_code_did_the_file_attri">ev_stat</link>
ウォッチャーに
<literal>inotify</literal> API を使わなくなります。
このフラグは inotify ファイルディスクリプタを節約するのに便利です。
@@ -307,7 +306,7 @@
ウォッチャーを使ったループのたびに
<literal>inotify</literal>
ハンドルをひとつずつ消費することになります。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.flag-signalfd">
@@ -315,15 +314,13 @@
<constant>Ev::FLAG_SIGNALFD</constant>
</term>
<listitem>
<para>
<simpara>
このフラグを指定すると、
<literal>libev</literal>
は
<link
xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_signal_code_signal_me_when_a">ev_signal</link>
<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_signal_code_signal_me_when_a">ev_signal</link>
(および
<link
xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_child_code_watch_out_for_pro">ev_child</link>
<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_child_code_watch_out_for_pro">ev_child</link>
) ウォッチャーに
<literal>signalfd</literal> API を使おうとします。
この API はシグナルを同期的に配送し、高速に処理したり
@@ -331,7 +328,7 @@
また、スレッドを使ったときのシグナル処理も、
スレッド内でシグナルが適切にブロックされている限りはシンプルになります。
デフォルトでは <literal>signalfd</literal> を使いません。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.flag-nosigmask">
@@ -339,15 +336,15 @@
<constant>Ev::FLAG_NOSIGMASK</constant>
</term>
<listitem>
<para>
<simpara>
このフラグを指定すると、
<literal>libev</literal> はシグナルのマスクを変更しないようにします。
具体的には、シグナルが受信されるまではブロックしないようになるということです。
</para>
<para>
</simpara>
<simpara>
これは、自前のシグナル処理をするときに便利です。
また、特定のスレッドでだけシグナルを処理するという場合にも有用です。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -365,14 +362,14 @@
<constant>Ev::RUN_NOWAIT</constant>
</term>
<listitem>
<para>
<simpara>
イベントループが新しいイベントを探し、
新しいイベントや未処理のイベントを処理するけれども、
もしイベントが見つからない場合は、最初のループですぐに呼び出し元に制御を戻します。
イベントを待つためにプロセスをブロックしたりはしません。
これは、時間のかかる計算をしているときのポーリングなどに便利です。
プログラムの動きを止めることなく新しいイベントを処理できます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.run-once">
@@ -380,14 +377,14 @@
<constant>Ev::RUN_ONCE</constant>
</term>
<listitem>
<para>
<simpara>
イベントループが (必要なら待ち続けてでも) 新しいイベントを探し、
その新しいイベントや未処理のイベントを処理します。
少なくとも一つのイベントがやってくるまで
(libev 自身のイベント間隔になるでしょう。
そのため、ユーザー低位のコールバックが呼ばれる保証はありません) プロセスをブロックし
ループ処理の終了後に呼び出し元に制御を戻します。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -405,9 +402,9 @@
<constant>Ev::BREAK_CANCEL</constant>
</term>
<listitem>
<para>
<simpara>
ブレーク操作をキャンセルします。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.break-one">
@@ -415,13 +412,13 @@
<constant>Ev::BREAK_ONE</constant>
</term>
<listitem>
<para>
<simpara>
一番内側の
<methodname>Ev::run</methodname>
(あるいは
<methodname>EvLoop::run</methodname>
) の呼び出しを返します。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.break-all">
@@ -429,13 +426,13 @@
<constant>Ev::BREAK_ALL</constant>
</term>
<listitem>
<para>
<simpara>
ネストしたすべての
<methodname>Ev::run</methodname>
(あるいは
<methodname>EvLoop::run</methodname>
) の呼び出しを返します。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -450,9 +447,9 @@
<constant>Ev::MINPRI</constant>
</term>
<listitem>
<para>
<simpara>
最小の優先度。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.maxpri">
@@ -460,9 +457,9 @@
<constant>Ev::MAXPRI</constant>
</term>
<listitem>
<para>
<simpara>
最大の優先度。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -477,10 +474,10 @@
<constant>Ev::READ</constant>
</term>
<listitem>
<para>
<simpara>
<classname>EvIo</classname>
ウォッチャーが読み込み可能になったときのファイルディスクリプタ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.write">
@@ -488,10 +485,10 @@
<constant>Ev::WRITE</constant>
</term>
<listitem>
<para>
<simpara>
<classname>EvIo</classname>
ウォッチャーが書き込み可能になったときのファイルディスクリプタ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.timer">
@@ -499,10 +496,10 @@
<constant>Ev::TIMER</constant>
</term>
<listitem>
<para>
<simpara>
<classname>EvTimer</classname>
ウォッチャーがタイムアウトしました。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.periodic">
@@ -510,10 +507,10 @@
<constant>Ev::PERIODIC</constant>
</term>
<listitem>
<para>
<simpara>
<classname>EvPeriodic</classname>
ウォッチャーがタイムアウトしました。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.signal">
@@ -521,10 +518,10 @@
<constant>Ev::SIGNAL</constant>
</term>
<listitem>
<para>
<simpara>
<methodname>EvSignal::__construct</methodname>
のコンストラクタで指定したシグナルを受信しました。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.child">
@@ -532,12 +529,12 @@
<constant>Ev::CHILD</constant>
</term>
<listitem>
<para>
<simpara>
<methodname>EvChild::__construct</methodname>
のコンストラクタで指定した
<parameter>pid</parameter>
が、状態の変更を受信しました。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.stat">
@@ -545,10 +542,10 @@
<constant>Ev::STAT</constant>
</term>
<listitem>
<para>
<simpara>
<classname>EvStat</classname>
ウォッチャーで指定したパスが、その属性を変更しました。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.idle">
@@ -556,11 +553,11 @@
<constant>Ev::IDLE</constant>
</term>
<listitem>
<para>
<simpara>
他のウォッチャーが何もすることがなくなったときに、
<classname>EvIdle</classname>
ウォッチャーが動作します。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.prepare">
@@ -568,7 +565,7 @@
<constant>Ev::PREPARE</constant>
</term>
<listitem>
<para>
<simpara>
すべての
<classname>EvPrepare</classname>
ウォッチャーが、
@@ -577,7 +574,7 @@
イベントループがスリープしたり新しいイベントのポーリングをしたりする直前に
<classname>EvPrepare</classname>
ウォッチャーが起動するということになります。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.check">
@@ -585,7 +582,7 @@
<constant>Ev::CHECK</constant>
</term>
<listitem>
<para>
<simpara>
すべての
<classname>EvCheck</classname>
ウォッチャーが、
@@ -595,7 +592,7 @@
にキューに入ります。つまり、
イベントループ内で優先度が同じ (あるいはより低い) ウォッチャーより前に
<classname>EvCheck</classname> ウォッチャーが起動するということになります。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.embed">
@@ -603,10 +600,10 @@
<constant>Ev::EMBED</constant>
</term>
<listitem>
<para>
<simpara>
<classname>EvEmbed</classname>
で指定した埋め込みイベントループのウォッチャーが注目する必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.custom">
@@ -614,14 +611,14 @@
<constant>Ev::CUSTOM</constant>
</term>
<listitem>
<para>
<simpara>
まだ
<literal>libev</literal>
で送信したりそれ以外の使いかたをしたりはしていませんが、
<literal>libev</literal>
ユーザーが (<methodname>EvWatcher::feed</methodname> などで)
ウォッチャーに通知するために使えます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.error">
@@ -629,18 +626,17 @@
<constant>Ev::ERROR</constant>
</term>
<listitem>
<para>
<simpara>
指定されていないエラーが発生し、ウォッチャーが停止しました。
これが発生する原因として考えられるのは、
<literal>libev</literal> がメモリ不足でウォッチャーをきちんと開始できなかった場合や
ファイルディスクリプタが閉じてしまった場合などがあります。
<literal>libev</literal> は、これらに関してはアプリケーションのバグとみなします。
詳細は
<link
xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#ANATOMY_OF_A_WATCHER_CONTENT">ANATOMY
<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#ANATOMY_OF_A_WATCHER_CONTENT">ANATOMY
OF A WATCHER</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -655,9 +651,9 @@
<constant>Ev::BACKEND_SELECT</constant>
</term>
<listitem>
<para>
<simpara>
<literal>select(2) バックエンド</literal>
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.backend-poll">
@@ -665,9 +661,9 @@
<constant>Ev::BACKEND_POLL</constant>
</term>
<listitem>
<para>
<simpara>
<literal>poll(2) バックエンド</literal>
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.backend-epoll">
@@ -675,11 +671,11 @@
<constant>Ev::BACKEND_EPOLL</constant>
</term>
<listitem>
<para>
<simpara>
Linux 限定の
<literal>epoll(7)</literal>
バックエンド。2.6.9 以前のカーネルでもそれ以降のカーネルでも使えます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.backend-kqueue">
@@ -687,7 +683,7 @@
<constant>Ev::BACKEND_KQUEUE</constant>
</term>
<listitem>
<para>
<simpara>
<literal>kqueue</literal>
バックエンド。大半の BSD システムで利用します。
<classname>EvEmbed</classname> ウォッチャーを使って、
@@ -695,7 +691,7 @@
たとえば、
<literal>kqueue</literal> バックエンドのループを作って、
それをソケットに対してだけ使うこともできます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.backend-devpoll">
@@ -703,9 +699,9 @@
<constant>Ev::BACKEND_DEVPOLL</constant>
</term>
<listitem>
<para>
<simpara>
Solaris 8 バックエンド。現時点では未実装です。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.backend-port">
@@ -713,9 +709,9 @@
<constant>Ev::BACKEND_PORT</constant>
</term>
<listitem>
<para>
<simpara>
Solaris 10 のイベントポート機構で、規模が大きくなっても対応できます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.backend-all">
@@ -723,7 +719,7 @@
<constant>Ev::BACKEND_ALL</constant>
</term>
<listitem>
<para>
<simpara>
壊れているものも含めて、すべてのバックエンドを試します。
これを明示的に使うことは推奨しません。ビット演算子を使って、
<constant>Ev::BACKEND_ALL</constant>
@@ -732,7 +728,7 @@
のようにするか、
<methodname>Ev::recommendedBackends</methodname>
を使うか、あるいは何もバックエンドを指定しないようにしましょう。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ev.constants.backend-mask">
@@ -740,30 +736,29 @@
<constant>Ev::BACKEND_MASK</constant>
</term>
<listitem>
<para>
<simpara>
これはバックエンドではなく、
<parameter>flags</parameter> の中のすべてのバックエンドビットをマスクするものです。
たとえば、環境変数
<varname>LIBEV_FLAGS</varname>
を変更するときに使います。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<!--}}}-->
<note xmlns="http://docbook.org/ns/docbook">
<para>
<simpara>
デフォルトのループの場合は、モジュールの初期化時に
<literal>Ev</literal> が
(もし使えれば) <literal>pthread_atfork</literal> を使って
<link
xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#FUNCTIONS_CONTROLLING_EVENT_LOOPS_CO">ev_loop_fork</link>
<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#FUNCTIONS_CONTROLLING_EVENT_LOOPS_CO">ev_loop_fork</link>
の呼び出しを登録します。
</para>
</simpara>
</note>
<note xmlns="http://docbook.org/ns/docbook">
<para>
<simpara>
<classname>Ev</classname> クラスには、
<emphasis>デフォルトのイベントループ</emphasis> にアクセスするメソッドが用意されています
(<methodname>Ev::iteration</methodname> や <methodname>Ev::depth</methodname> など)。
@@ -771,12 +766,12 @@
(<methodname>EvLoop::__construct</methodname> で作ったもの)
の場合、これらの値にアクセスするには
<classname>EvLoop</classname> クラスのプロパティやメソッドを使います。
</para>
<para>
</simpara>
<simpara>
デフォルトのイベントループ自体のインスタンスを取得するには
<methodname>EvLoop::defaultLoop</methodname>
メソッドを使います。
</para>
</simpara>
</note>
</section>
<!-- }}} -->

14
reference/ev/ev/backend.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.backend" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.backend">
<refnamediv>
<refname>Ev::backend</refname>
<refpurpose>libev が使うバックエンドを表す整数値を返す</refpurpose>
@@ -14,12 +14,12 @@
<modifier>static</modifier>
<type>int</type>
<methodname>Ev::backend</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
<emphasis>libev</emphasis> が使うバックエンドを表す整数値を返します。
<link linkend="ev.constants.watcher-backends">バックエンドのフラグ</link> も参照ください。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,9 +27,9 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
<emphasis>libev</emphasis> が使うバックエンドを表す整数値 (ビットマスク) を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

14
reference/ev/ev/depth.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.depth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.depth">
<refnamediv>
<refname>Ev::depth</refname>
<refpurpose>再帰の深さを返す</refpurpose>
@@ -14,9 +14,9 @@
<modifier>static</modifier>
<type>int</type>
<methodname>Ev::depth</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
<methodname>Ev::run</methodname> に入った回数から
<methodname>Ev::run</methodname> を正常終了した回数を引いた結果、
つまり、再帰の深さを返します。
@@ -26,7 +26,7 @@
になります。ただし、<methodname>Ev::run</methodname>
が再帰的に呼び出されている (あるいは別スレッドから呼び出されている)
場合は、もっと大きな数になります。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -34,10 +34,10 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
<function>ev_depth</function>
は、デフォルトのループの再帰の深さを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

17
reference/ev/ev/embeddablebackends.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 88c8421cbef98b73ac59f58cc60d317c4861fd89 Maintainer: takagi Status: ready -->
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="ev.embeddablebackends" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.embeddablebackends">
<refnamediv>
<refname>Ev::embeddableBackends</refname>
<refpurpose>他のイベントループに埋め込めるバックエンド群を返す</refpurpose>
@@ -15,11 +15,11 @@
<modifier>static</modifier>
<type>int</type>
<methodname>Ev::embeddableBackends</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
他のイベントループに埋め込めるバックエンド群を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,12 +27,11 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
ビットマスクを返します。
<link
linkend="ev.constants.watcher-backends">バックエンドのフラグ</link>
<link linkend="ev.constants.watcher-backends">バックエンドのフラグ</link>
を、ビット <emphasis>OR</emphasis> 演算子で組み合わせたものになります。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;

20
reference/ev/ev/feedsignal.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.feedsignal" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.feedsignal">
<refnamediv>
<refname>Ev::feedSignal</refname>
<refpurpose>シグナルイベントを Ev に送る</refpurpose>
@@ -19,16 +19,16 @@
<parameter>signum</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
シグナルの受信をシミュレートします。
この関数は、いつでもどんなコンテキストでも安全に呼べます。
シグナルハンドラやランダムスレッドからでもだいじょうぶです。
主に、プロセス内で自前のシグナル処理を行う場合に使います。
</para>
<para>
</simpara>
<simpara>
<methodname>Ev::feedSignalEvent</methodname>
とは違い、どのループがシグナルを登録したのかにかかわらず動作します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -38,21 +38,21 @@
<parameter>signum</parameter>
</term>
<listitem>
<para>
<simpara>
シグナル番号。詳細は
<literal>signal(7)</literal>
の man ページを参照ください。
<literal>pcntl</literal> 拡張モジュールが公開する定数も使えます。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

16
reference/ev/ev/feedsignalevent.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 04b11e621f6ccf857368d90262f051a8d40c865d Maintainer: takagi Status: ready -->
<refentry xml:id="ev.feedsignalevent" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.feedsignalevent">
<refnamediv>
<refname>Ev::feedSignalEvent</refname>
<refpurpose>シグナルイベントの情報をデフォルトループに送る</refpurpose>
@@ -19,10 +19,10 @@
<parameter>signum</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
シグナルイベントをデフォルトループに送ります。
Ev は、<parameter>signal</parameter> で指定したシグナルを受け取ったかのように反応します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -32,21 +32,21 @@
<parameter>signum</parameter>
</term>
<listitem>
<para>
<simpara>
シグナル番号。詳細は
<literal>signal(7)</literal>
の man ページを参照ください。
<literal>pcntl</literal> 拡張モジュールが公開する定数も使えます。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

14
reference/ev/ev/iteration.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.iteration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.iteration">
<refnamediv>
<refname>Ev::iteration</refname>
<refpurpose>デフォルトのイベントループが新しいイベントをポーリングした回数を返す</refpurpose>
@@ -14,12 +14,12 @@
<modifier>static</modifier>
<type>int</type>
<methodname>Ev::iteration</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
デフォルトのイベントループが新しいイベントをポーリングした回数を返します。
生成カウンターとして有用です。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,9 +27,9 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
デフォルトのイベントループのポーリング回数を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

14
reference/ev/ev/now.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.now" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.now">
<refnamediv>
<refname>Ev::now</refname>
<refpurpose>デフォルトのイベントループで直近の処理が始まった時刻を返す</refpurpose>
@@ -14,14 +14,14 @@
<modifier>static</modifier>
<type>float</type>
<methodname>Ev::now</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
デフォルトのイベントループで直近の処理が始まった時刻を返します。
これはタイマー (<classname>EvTimer</classname> および
<classname>EvPeriodic</classname>) が基準にしているもので、
通常は <methodname>Ev::time</methodname> を呼ぶよりも高速になります。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -29,9 +29,9 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
デフォルトのイベントループで直近の処理が始まった時刻を表す秒数を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

18
reference/ev/ev/nowupdate.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.nowupdate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.nowupdate">
<refnamediv>
<refname>Ev::nowUpdate</refname>
<refpurpose>カーネルに問い合わせて現在時刻を確認し、処理中の Ev::now が返す時刻を更新する</refpurpose>
@@ -14,19 +14,19 @@
<modifier>static</modifier>
<type>void</type>
<methodname>Ev::nowUpdate</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
カーネルに問い合わせて現在時刻を確認し、処理中の <methodname>Ev::now</methodname>
が返す時刻を更新します。これはコストが高い操作で、通常は自動的に
<methodname>Ev::run</methodname>
の中で実行します。
</para>
<para>
</simpara>
<simpara>
このメソッドが役立つ場面はほとんどありませんが、
たとえば何かのイベントコールバックがイベントループに入らず長時間処理を続けているときに、
<emphasis>libev</emphasis> が把握する現在時刻を更新するというのがその一つになります。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -34,9 +34,9 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

17
reference/ev/ev/recommendedbackends.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="ev.recommendedbackends" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.recommendedbackends">
<refnamediv>
<refname>Ev::recommendedBackends</refname>
<refpurpose>現在のプラットフォーム上でおすすめのバックエンドのビットマスクを返す</refpurpose>
@@ -15,9 +15,9 @@
<modifier>static</modifier>
<type>int</type>
<methodname>Ev::recommendedBackends</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
この <literal>libev</literal> のバイナリに組み込まれたすべてのバックエンドと、
中でもこのプラットフォーム上でおすすめのバックエンドを返します。
おすすめとは、多くのファイルディスクリプタ形式に対応しているということです。
@@ -27,7 +27,7 @@
明示的にリクエストしない限り自動検出できないからです。
このメソッドが返すバックエンドはどれも、明示的に指定しなくても <literal>libev</literal>
で使えます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -35,12 +35,11 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
ビットマスクを返します。
<link
linkend="ev.constants.watcher-backends">バックエンドのフラグ</link>
<link linkend="ev.constants.watcher-backends">バックエンドのフラグ</link>
を、ビット <emphasis>OR</emphasis> 演算子で組み合わせたものになります。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;

26
reference/ev/ev/resume.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.resume" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.resume">
<refnamediv>
<refname>Ev::resume</refname>
<refpurpose>一時停止していたデフォルトのイベントループを再開させる</refpurpose>
@@ -14,33 +14,33 @@
<modifier>static</modifier>
<type>void</type>
<methodname>Ev::resume</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
<methodname>Ev::suspend</methodname>
と
<methodname>Ev::resume</methodname>
が、それぞれループの一時停止と再開に対応します。
</para>
<para>
</simpara>
<simpara>
すべてのタイマーウォッチャーは、
<emphasis>suspend</emphasis> から <emphasis>resume</emphasis>
までの時間だけ遅延します。また、すべての定期ウォッチャーは再スケジュールされます
(つまり、一時停止中に発生したイベントは失うことになります)。
</para>
<para>
</simpara>
<simpara>
<methodname>Ev::suspend</methodname> を呼んだ後は、
そのループ上では <methodname>Ev::resume</methodname> 以外の関数を呼べません。
また、先に <methodname>Ev::suspend</methodname> を呼んでいない状態で
<methodname>Ev::resume</methodname>
は呼べません。
</para>
<para>
</simpara>
<simpara>
<emphasis>suspend</emphasis> や
<emphasis>resume</emphasis> を呼ぶと、
イベントループの時刻を更新するという副作用があります
(<methodname>Ev::nowUpdate</methodname> を参照ください)。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -48,9 +48,9 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

16
reference/ev/ev/run.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.run" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.run">
<refnamediv>
<refname>Ev::run</refname>
<refpurpose>イベントのチェックとデフォルトループのコールバックの呼び出しを開始する</refpurpose>
@@ -19,7 +19,7 @@
<parameter>flags</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
イベントのチェックとデフォルトループのコールバックの呼び出しを開始します。
コールバックが <methodname>Ev::stop</methodname> メソッドを読んだとき、
あるいは flags がゼロ以外のとき (この場合の戻り値は true)
@@ -29,7 +29,7 @@
戻り値の解釈は、一般的に、
<emphasis>もし &true; ならまだ作業が残っている</emphasis>
となります。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -77,18 +77,18 @@
</tgroup>
</table>
</para>
<para>
<simpara>
<link linkend="ev.constants.run-flags">実行フラグ定数</link> も参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

16
reference/ev/ev/sleep.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 508869e1df6458162c162d71669f5e81abd65d50 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.sleep" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.sleep">
<refnamediv>
<refname>Ev::sleep</refname>
<refpurpose>指定した秒数だけプロセスをブロックする</refpurpose>
@@ -19,9 +19,9 @@
<parameter>seconds</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
指定した秒数だけプロセスをブロックします。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -31,18 +31,18 @@
<parameter>seconds</parameter>
</term>
<listitem>
<para>
<simpara>
秒数。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

19
reference/ev/ev/stop.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.stop" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.stop">
<refnamediv>
<refname>Ev::stop</refname>
<refpurpose>デフォルトのイベントループを止める</refpurpose>
@@ -19,9 +19,9 @@
<parameter>how</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
デフォルトのイベントループを止めます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -31,21 +31,20 @@
<parameter>how</parameter>
</term>
<listitem>
<para>
<simpara>
<emphasis>Ev::BREAK_*</emphasis>
<link
linkend="ev.constants.break-flags">定数</link>
<link linkend="ev.constants.break-flags">定数</link>
のいずれか。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

17
reference/ev/ev/supportedbackends.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 88c8421cbef98b73ac59f58cc60d317c4861fd89 Maintainer: takagi Status: ready -->
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="ev.supportedbackends" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.supportedbackends">
<refnamediv>
<refname>Ev::supportedBackends</refname>
<refpurpose>現在の libev の構成でサポートするバックエンド群を返す</refpurpose>
@@ -15,11 +15,11 @@
<modifier>static</modifier>
<type>int</type>
<methodname>Ev::supportedBackends</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
現在の libev の構成でサポートするバックエンド群を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,12 +27,11 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
ビットマスクを返します。
<link
linkend="ev.constants.watcher-backends">バックエンドのフラグ</link>
<link linkend="ev.constants.watcher-backends">バックエンドのフラグ</link>
を、ビット <emphasis>OR</emphasis> 演算子で組み合わせたものになります。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;

22
reference/ev/ev/suspend.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.suspend" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.suspend">
<refnamediv>
<refname>Ev::suspend</refname>
<refpurpose>デフォルトのイベントループを一時停止する</refpurpose>
@@ -14,27 +14,27 @@
<modifier>static</modifier>
<type>void</type>
<methodname>Ev::suspend</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
<methodname>Ev::suspend</methodname>
と
<methodname>Ev::resume</methodname>
が、それぞれループの一時停止と再開に対応します。
</para>
<para>
</simpara>
<simpara>
すべてのタイマーウォッチャーは、
<emphasis>suspend</emphasis> から <emphasis>resume</emphasis>
までの時間だけ遅延します。また、すべての定期ウォッチャーは再スケジュールされます
(つまり、一時停止中に発生したイベントは失うことになります)。
</para>
<para>
</simpara>
<simpara>
<methodname>Ev::suspend</methodname> を呼んだ後は、
そのループ上では <methodname>Ev::resume</methodname> 以外の関数を呼べません。
また、先に <methodname>Ev::suspend</methodname> を呼んでいない状態で
<methodname>Ev::resume</methodname>
は呼べません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -42,9 +42,9 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

14
reference/ev/ev/time.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 508869e1df6458162c162d71669f5e81abd65d50 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.time" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.time">
<refnamediv>
<refname>Ev::time</refname>
<refpurpose>epoch から現在時刻までの秒数を返す</refpurpose>
@@ -14,12 +14,12 @@
<modifier>static</modifier>
<type>float</type>
<methodname>Ev::time</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
epoch から現在時刻までの秒数を返します。
<methodname>Ev::now</methodname> を使うことを検討しましょう。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,9 +27,9 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
epoch から現在時刻までの秒数を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

14
reference/ev/ev/verify.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<refentry xml:id="ev.verify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.verify">
<refnamediv>
<refname>Ev::verify</refname>
<refpurpose>内部の整合性をチェックする (デバッグ用)</refpurpose>
@@ -14,13 +14,13 @@
<modifier>static</modifier>
<type>void</type>
<methodname>Ev::verify</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
内部の整合性をチェック
(<emphasis>libev</emphasis> のデバッグ用)
し、もしデータ構造が壊れている場合はプログラムを終了させます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -28,9 +28,9 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

28
reference/ev/evcheck.xml
View File

@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<reference xml:id="class.evcheck" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.evcheck" role="class">
<title>EvCheck クラス</title>
<titleabbrev>EvCheck</titleabbrev>
<partintro>
<!-- {{{ EvCheck intro -->
<section xml:id="evcheck.intro">
&reftitle.intro;
<para>
<simpara>
<classname>EvPrepare</classname> ウォッチャーと
<classname>EvCheck</classname> ウォッチャーは、
通常はペアで使います。
@@ -16,8 +16,8 @@
ウォッチャーはプロセスをブロックする前に起動し、
<classname>EvCheck</classname>
はブロックした後に起動します。
</para>
<para>
</simpara>
<simpara>
<methodname>EvLoop::run</methodname>
あるいはそれに類するメソッドや関数 (現在のイベントループに入るもの)
は、<classname>EvPrepare</classname> ウォッチャーや
@@ -27,26 +27,26 @@
つまり、処理の流れは常に <classname>EvPrepare</classname>
-&gt; ブロック -&gt; <classname>EvCheck</classname>
となるので、これらのウォッチャーは常にペアで呼ばれ、ブロッキング呼び出しの前後を囲むことになります。
</para>
<para>
</simpara>
<simpara>
主な利用目的は他のイベント機構を <emphasis>libev</emphasis> に統合することで、
少し高度な使いかたになります。変数の変更を追跡したり
自前のウォッチャーを実装したり、net-snmp やコルーチンライブラリを統合したりといった、
さまざまな用途で使えます。
また、何らかのデータをキャッシュしてブロッキングの前にフラッシュするなどの用途で使えることもあります。
</para>
<para>
</simpara>
<simpara>
<classname>EvCheck</classname> には最高の優先度
(<constant>Ev::MAXPRI</constant>) を与えることを推奨します。
これで、ポーリングの後は他のあらゆるウォッチャーよりも先に実行されることが保証されます
(<classname>EvPrepare</classname> ウォッチャーの場合は無鐘鋳です)。
</para>
<para>
</simpara>
<simpara>
また、<classname>EvCheck</classname>
ウォッチャーはイベントをアクティブにしたり送信したりしてはいけません。
<emphasis>libev</emphasis> では対応してはいますが、
他の <classname>EvCheck</classname> ウォッチャーが仕事をする前に実行される可能性があります。
</para>
</simpara>
</section>
<!-- }}} -->
<section xml:id="evcheck.synopsis">
@@ -70,12 +70,12 @@
<!-- }}} -->
<!--<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>-->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('evwatcher.synopsis')/descendant::db:fieldsynopsis)" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('evwatcher.synopsis')/descendant::db:fieldsynopsis)"/>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evcheck')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evcheck')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"/>
</classsynopsis>
<!-- }}} -->
</section>

20
reference/ev/evcheck/construct.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evcheck.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evcheck.construct">
<refnamediv>
<refname>EvCheck::__construct</refname>
<refpurpose>EvCheck ウォッチャーオブジェクトを作る</refpurpose>
@@ -24,10 +24,10 @@
<parameter>priority</parameter>
</methodparam>
</constructorsynopsis>
<para>
<simpara>
<classname>EvCheck</classname>
ウォッチャーオブジェクトを作ります。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -37,10 +37,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -48,9 +48,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -58,9 +58,9 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

24
reference/ev/evcheck/createstopped.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evcheck.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evcheck.createstopped">
<refnamediv>
<refname>EvCheck::createStopped</refname>
<refpurpose>停止した EvCheck ウォッチャーのインスタンスを作る</refpurpose>
@@ -27,9 +27,9 @@
<parameter>priority</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
停止した EvCheck ウォッチャーのインスタンスを作ります。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -39,10 +39,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -50,9 +50,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -60,18 +60,18 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に EvCheck オブジェクトを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

28
reference/ev/evchild.xml
View File

@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<reference xml:id="class.evchild" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.evchild" role="class">
<title>The EvChild class</title>
<titleabbrev>EvChild</titleabbrev>
<partintro>
<!-- {{{ EvChild intro -->
<section xml:id="evchild.intro">
&reftitle.intro;
<para>
<simpara>
<classname>EvChild</classname> ウォッチャーは、子プロセスの状態の変更
(たいていは、停止したり終了したりといったもの)
に反応してこのプロセスが <constant>SIGCHLD</constant> を受け取ったときに起動します。
@@ -17,11 +17,11 @@
ただし、まだイベントループに入っていないとき (あるいはウォッチャーから引き続いているとき) に限ります。
つまり、フォークした直後に子プロセス用のウォッチャーを登録するのはかまいませんが、
フォークした後でイベントループを何回か処理した後で登録したり、次のコールバックの実行時に登録したりすることはできません。
</para>
<para>
</simpara>
<simpara>
<classname>EvChild</classname> ウォッチャーは、
<emphasis>デフォルトループ</emphasis> の中でだけ登録できます。
</para>
</simpara>
</section>
<!-- }}} -->
<section xml:id="evchild.synopsis">
@@ -57,12 +57,12 @@
<varname linkend="evchild.props.rstatus">rstatus</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('evwatcher.synopsis')/descendant::db:fieldsynopsis)" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('evwatcher.synopsis')/descendant::db:fieldsynopsis)"/>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evchild')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evchild')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"/>
</classsynopsis>
<!-- }}} -->
</section>
@@ -75,10 +75,10 @@
<varname>pid</varname>
</term>
<listitem>
<para>
<simpara>
<emphasis>読み込み専用</emphasis>。
このウォッチャーが注目するプロセス ID。<literal>0</literal> の場合はあらゆるプロセス ID を表します。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evchild.props.rpid">
@@ -86,10 +86,10 @@
<varname>rpid</varname>
</term>
<listitem>
<para>
<simpara>
<emphasis>読み込み専用</emphasis>。
状態の変更を検出するプロセスの ID。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evchild.props.rstatus">
@@ -97,10 +97,10 @@
<varname>rstatus</varname>
</term>
<listitem>
<para>
<simpara>
<emphasis>読み込み専用</emphasis>。
<varname>rpid</varname> のプロセス終了ステータス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

54
reference/ev/evchild/construct.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evchild.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evchild.construct">
<refnamediv>
<refname>EvChild::__construct</refname>
<refpurpose>EvChild ウォッチャーオブジェクトを作る</refpurpose>
@@ -23,23 +23,21 @@
<type>callable</type>
<parameter>callback</parameter>
</methodparam>
<methodparam
choice="opt">
<methodparam choice="opt">
<type>mixed</type>
<parameter>data</parameter>
<initializer>&null;</initializer>
</methodparam>
<methodparam
choice="opt">
<methodparam choice="opt">
<type>int</type>
<parameter>priority</parameter>
<initializer>0</initializer>
</methodparam>
</constructorsynopsis>
<para>
<simpara>
<classname>EvChild</classname> ウォッチャーオブジェクトを作ります。
</para>
<para>
</simpara>
<simpara>
プロセス ID <parameter>pid</parameter>
(<parameter>pid</parameter> is <constant>0</constant> の場合は任意の <emphasis>PID</emphasis>)
の状態の変更を受信したときに、コールバックを呼びます
@@ -48,27 +46,27 @@
言い換えると、あるプロセスが <constant>SIGCHLD</constant> を受信したときに、
<emphasis>Ev</emphasis> はすべての変更された子プロセスやゾンビ子プロセスの exit/wait
状態を取得してコールバックを呼びます。
</para>
<para>
</simpara>
<simpara>
<classname>EvChild</classname> が終了してから child ウォッチャーをインストールしてもかまいませんが、
イベントループが次のイテレーションを始める前でないといけません。
たとえば、最初のプロセスが <literal>fork</literal> した後で新しい子プロセスが終了するかもしれません。
そのときは、新しい <emphasis>PID</emphasis> の親にだけ
<classname>EvChild</classname> ウォッチャーをインストールできます。
</para>
<para>
</simpara>
<simpara>
exit/tracing ステータスや <parameter>pid</parameter> にアクセスするには、
ウォッチャーオブジェクトのプロパティ <varname>rstatus</varname> および <varname>rpid</varname>
を使います。
</para>
<para>
</simpara>
<simpara>
一つの <emphasis>PID</emphasis> に対する <emphasis>PID</emphasis>
ウォッチャーの数は無制限で、すべてが呼び出されます。
</para>
<para>
</simpara>
<simpara>
<methodname>EvChild::createStopped</methodname>
メソッドは、新しく作ったウォッチャーを開始させません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -78,9 +76,9 @@
<parameter>pid</parameter>
</term>
<listitem>
<para>
<simpara>
状態の変更を待つプロセスの PID (<constant>0</constant> にすると、すべてのプロセスを対象にします)。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -88,10 +86,10 @@
<parameter>trace</parameter>
</term>
<listitem>
<para>
<simpara>
&false; にすると、プロセスが終了したときにだけウォッチャーをアクティブにします。
&true; の場合は、プロセスが一時停止したり再開したりしたときにもウォッチャーをアクティブにします。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -99,10 +97,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -110,9 +108,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -120,9 +118,9 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

30
reference/ev/evchild/createstopped.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evchild.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evchild.createstopped">
<refnamediv>
<refname>EvChild::createStopped</refname>
<refpurpose>停止した EvChild ウォッチャーのインスタンスを作る</refpurpose>
@@ -35,10 +35,10 @@
<parameter>priority</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
<methodname>EvChild::__construct</methodname>
と同じですが、ウォッチャーを自動的には開始しません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -48,9 +48,9 @@
<parameter>pid</parameter>
</term>
<listitem>
<para>
<simpara>
<methodname>EvChild::__construct</methodname> と同じ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -58,9 +58,9 @@
<parameter>trace</parameter>
</term>
<listitem>
<para>
<simpara>
<methodname>EvChild::__construct</methodname> と同じ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -68,10 +68,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -79,9 +79,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -89,16 +89,16 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para></para>
<simpara/>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

18
reference/ev/evchild/set.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8d666e819852f6b0561b40fcf8689b747568865c Maintainer: takagi Status: ready -->
<refentry xml:id="evchild.set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evchild.set">
<refnamediv>
<refname>EvChild::set</refname>
<refpurpose>ウォッチャーを設定する</refpurpose>
@@ -21,7 +21,7 @@
<parameter>trace</parameter>
</methodparam>
</methodsynopsis>
<para></para>
<simpara/>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -31,9 +31,9 @@
<parameter>pid</parameter>
</term>
<listitem>
<para>
<simpara>
<methodname>EvChild::__construct</methodname> と同じ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -41,18 +41,18 @@
<parameter>trace</parameter>
</term>
<listitem>
<para>
<simpara>
<methodname>EvChild::__construct</methodname> と同じ。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

20
reference/ev/evembed.xml
View File

@@ -1,16 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 33e5f4ef7243bc1282acb1cba93e8f99c1debe68 Maintainer: takagi Status: ready -->
<reference xml:id="class.evembed" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.evembed" role="class">
<title>EvEmbed クラス</title>
<titleabbrev>EvEmbed</titleabbrev>
<partintro>
<!-- {{{ EvEmbed intro -->
<section xml:id="evembed.intro">
&reftitle.intro;
<para>
<simpara>
イベントループを別のイベントループに埋め込むために使います。
</para>
</simpara>
</section>
<!-- }}} -->
<section xml:id="evembed.synopsis">
@@ -41,7 +41,7 @@
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evembed')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evembed')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"/>
</classsynopsis>
<!-- }}} -->
</section>
@@ -54,7 +54,7 @@
<varname>is_active</varname>
</term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="evembed.props.data">
@@ -62,7 +62,7 @@
<varname>data</varname>
</term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="evembed.props.is-pending">
@@ -70,7 +70,7 @@
<varname>is_pending</varname>
</term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="evembed.props.priority">
@@ -78,7 +78,7 @@
<varname>priority</varname>
</term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="evembed.props.embed">
@@ -86,7 +86,7 @@
<varname>embed</varname>
</term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
</variablelist>

35
reference/ev/evembed/construct.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evembed.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evembed.construct">
<refnamediv>
<refname>EvEmbed::__construct</refname>
<refpurpose>EvEmbed オブジェクトを作る</refpurpose>
@@ -28,24 +28,23 @@
<parameter>priority</parameter>
</methodparam>
</constructorsynopsis>
<para>
<simpara>
これは高度なウォッチャー型で、あるイベントループを別のイベントループに埋め込むことができます。
現在は、埋め込みループに対応しているのは IO イベントだけです。
他の型のウォッチャーを使うと、処理が遅延したり不正確な動きになったりする可能性があるので、
使ってはいけません。
</para>
<para>
</simpara>
<simpara>
詳細は、
<link
xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_embed_code_when_one_backend_">
<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#code_ev_embed_code_when_one_backend_">
libev のドキュメント</link>
を参照ください。
</para>
<para>
</simpara>
<simpara>
このウォッチャーは、<emphasis>BSD</emphasis> システムで
<literal>kqueue</literal> が使えないときにも大量のソケットを処理できるようにするのに便利です。
以下の例を参照ください。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -55,11 +54,11 @@
<parameter>other</parameter>
</term>
<listitem>
<para>
<simpara>
<classname>EvLoop</classname> のインスタンス。
埋め込むループです。これは埋め込み可能なものでなければいけません
(<methodname>Ev::embeddableBackends</methodname> を参照ください)。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -67,10 +66,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -78,9 +77,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -88,9 +87,9 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

28
reference/ev/evembed/createstopped.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evembed.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evembed.createstopped">
<refnamediv>
<refname>EvEmbed::createStopped</refname>
<refpurpose>停止した EvEmbed ウォッチャーのインスタンスを作る</refpurpose>
@@ -31,10 +31,10 @@
<parameter>priority</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
<methodname>EvEmbed::__construct</methodname>
と同じですが、ウォッチャーを自動的には開始しません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -44,9 +44,9 @@
<parameter>other</parameter>
</term>
<listitem>
<para>
<simpara>
<methodname>EvEmbed::__construct</methodname> と同じ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -54,10 +54,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -65,9 +65,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -75,18 +75,18 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に、停止した EvEmbed オブジェクトを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

16
reference/ev/evembed/set.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8d666e819852f6b0561b40fcf8689b747568865c Maintainer: takagi Status: ready -->
<refentry xml:id="evembed.set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evembed.set">
<refnamediv>
<refname>EvEmbed::set</refname>
<refpurpose>ウォッチャーを設定する</refpurpose>
@@ -17,11 +17,11 @@
<parameter>other</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
ウォッチャーを設定して、
<parameter>他の</parameter>
イベントループオブジェクトで使えるようにします。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -31,18 +31,18 @@
<parameter>other</parameter>
</term>
<listitem>
<para>
<simpara>
<methodname>EvEmbed::__construct</methodname> と同じ。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

10
reference/ev/evembed/sweep.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: takagi Status: ready -->
<refentry xml:id="evembed.sweep" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evembed.sweep">
<refnamediv>
<refname>EvEmbed::sweep</refname>
<refpurpose>埋め込んだループに対して単一の非ブロックスイープを行う</refpurpose>
@@ -12,7 +12,7 @@
<modifier>public</modifier>
<type>void</type>
<methodname>EvEmbed::sweep</methodname>
<void />
<void/>
</methodsynopsis>
<para>
埋め込んだループに対して単一の非ブロックスイープを行います。
@@ -32,9 +32,9 @@ $other->start(Ev::RUN_NOWAIT);
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

12
reference/ev/evfork.xml
View File

@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 33e5f4ef7243bc1282acb1cba93e8f99c1debe68 Maintainer: takagi Status: ready -->
<reference xml:id="class.evfork" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.evfork" role="class">
<title>EvFork クラス</title>
<titleabbrev>EvFork</titleabbrev>
<partintro>
<!-- {{{ EvFork intro -->
<section xml:id="evfork.intro">
&reftitle.intro;
<para>
<simpara>
Fork ウォッチャーが呼ばれるのは、<literal>fork()</literal> を検出したときです
(通常は、誰かが <methodname>EvLoop::fork</methodname> を呼んで
<emphasis>libev</emphasis> に通知します)。
@@ -17,7 +17,7 @@
また、フォークした後の子プロセス内でだけ起動します。
誰かが間違ったプロセスで <methodname>EvLoop::fork</methodname>
を呼んだとしても、fork ハンドラが起動してしまうことに注意しましょう。
</para>
</simpara>
</section>
<!-- }}} -->
<section xml:id="evfork.synopsis">
@@ -41,12 +41,12 @@
<!-- }}} -->
<!--<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>-->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('evwatcher.synopsis')/descendant::db:fieldsynopsis)" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('evwatcher.synopsis')/descendant::db:fieldsynopsis)"/>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evfork')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evfork')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"/>
</classsynopsis>
<!-- }}} -->
</section>

26
reference/ev/evfork/construct.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evfork.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evfork.construct">
<refnamediv>
<refname>EvFork::__construct</refname>
<refpurpose>EvFork ウォッチャーオブジェクトを作る</refpurpose>
@@ -15,22 +15,20 @@
<type>callable</type>
<parameter>callback</parameter>
</methodparam>
<methodparam
choice="opt">
<methodparam choice="opt">
<type>mixed</type>
<parameter>data</parameter>
<initializer>&null;</initializer>
</methodparam>
<methodparam
choice="opt">
<methodparam choice="opt">
<type>int</type>
<parameter>priority</parameter>
<initializer>0</initializer>
</methodparam>
</constructorsynopsis>
<para>
<simpara>
EvFork ウォッチャーオブジェクトを作り、自動的に開始させます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -40,10 +38,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -51,9 +49,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -61,9 +59,9 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

24
reference/ev/evfork/createstopped.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evfork.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evfork.createstopped">
<refnamediv>
<refname>EvFork::createStopped</refname>
<refpurpose>停止した EvFork ウォッチャーのインスタンスを作る</refpurpose>
@@ -27,10 +27,10 @@
<parameter>priority</parameter>
</methodparam>
</methodsynopsis>
<para>
<simpara>
<methodname>EvFork::__construct</methodname>
と同じですが、ウォッチャーを自動的には開始しません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -40,10 +40,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -51,9 +51,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -61,18 +61,18 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に、停止した EvFork オブジェクトを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

20
reference/ev/evprepare/construct.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evprepare.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evprepare.construct">
<refnamediv>
<refname>EvPrepare::__construct</refname>
<refpurpose>EvPrepare ウォッチャーオブジェクトを作る</refpurpose>
@@ -24,11 +24,11 @@
<parameter>priority</parameter>
</methodparam>
</constructorsynopsis>
<para>
<simpara>
EvPrepare ウォッチャーオブジェクトを作り、自動的に開始させます。
停止状態のウォッチャーが必要なときは、
<methodname>EvPrepare::createStopped</methodname> を使いましょう。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -38,10 +38,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -49,9 +49,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -59,9 +59,9 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

30
reference/ev/evprepare/createstopped.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a42e4f72e36634c5b23221af2de79eafb20d09c Maintainer: takagi Status: ready -->
<refentry xml:id="evprepare.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="evprepare.createstopped">
<refnamediv>
<refname>EvPrepare::createStopped</refname>
<refpurpose>停止した EvPrepare ウォッチャーのインスタンスを作る</refpurpose>
@@ -18,24 +18,22 @@
<type>callable</type>
<parameter>callback</parameter>
</methodparam>
<methodparam
choice="opt">
<methodparam choice="opt">
<type>mixed</type>
<parameter>data</parameter>
<initializer>&null;</initializer>
</methodparam>
<methodparam
choice="opt">
<methodparam choice="opt">
<type>int</type>
<parameter>priority</parameter>
<initializer>0</initializer>
</methodparam>
</methodsynopsis>
<para>
<simpara>
停止した EvPrepare ウォッチャーのインスタンスを作ります。
<methodname>EvPrepare::__construct</methodname> とは違い、
このメソッドはウォッチャーを自動的に開始させません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -45,10 +43,10 @@
<parameter>callback</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
を参照ください。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -56,9 +54,9 @@
<parameter>data</parameter>
</term>
<listitem>
<para>
<simpara>
このウォッチャーに関連づけるカスタムデータ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -66,18 +64,18 @@
<parameter>priority</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-pri">ウォッチャーの優先度</link>。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に EvPrepare オブジェクトを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

36
reference/ev/periodic-modes.xml
View File

@@ -1,19 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<chapter xml:id="ev.periodic-modes" 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="ev.periodic-modes">
<title>Periodic ウォッチャーの操作モード</title>
<para>
<simpara>
<classname>EvPeriodic</classname>
ウォッチャーは、パラメータ
<parameter>offset</parameter>、<parameter>interval</parameter>
および <parameter>reschedule_cb</parameter>
の設定によってさまざまなモードで動作します。
</para>
</simpara>
<orderedlist>
<listitem>
<para>
<simpara>
<emphasis>絶対時刻のタイマー</emphasis>。
このモードでは、<parameter>interval</parameter> = <literal>0</literal>
そして <parameter>reschedule_cb</parameter> = &null; となります。
@@ -21,10 +21,10 @@
時刻の飛びがあっても調整はしません。つまり、
<emphasis>January 1st 2014</emphasis> に実行するように設定した場合は、
システム時刻がこの時刻に達するかこの時刻を過ぎたときに実行されます。
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<emphasis>繰り返しタイマー</emphasis>。
このモードでは、<parameter>interval</parameter> &gt; <literal>0</literal>
そして <parameter>reschedule_cb</parameter> = &null;
@@ -32,7 +32,7 @@
<parameter>offset</parameter> + <constant>N</constant> * <parameter>interval</parameter>
(<constant>N</constant> は何らかの整数) 経過後にタイムアウトするようにスケジュールされ、
その後繰り返します。時刻の飛びは気にしません。
</para>
</simpara>
<para>
これを使うと、システムの時刻に流されないタイマーを作れます。
<programlisting role="php">
@@ -47,27 +47,27 @@ $hourly = EvPeriodic(0, 3600, NULL, function () {
これは、必ずしも <literal>3600</literal> 秒おきにイベントが発生することを意味するものではありません。
システムの時刻が一時間経過するごとにコールバックが呼ばれるというものです。
</para>
<para>
<simpara>
<classname>EvPeriodic</classname> は、
<varname>time</varname> = <parameter>offset</parameter>
(<literal>mod</literal> <parameter>interval</parameter>)
となる次の時刻にコールバックをこのモードで実行しようと試みます。
時刻の飛びは気にしません。
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<emphasis>手動再スケジュールモード</emphasis>。
このモードでは、<parameter>reschedule_cb</parameter>
が <type>callable</type> になります。
</para>
<para>
</simpara>
<simpara>
<parameter>interval</parameter> と <parameter>offset</parameter>
はどちらも無視します。毎回定期ウォッチャーがスケジュールされ、再スケジュールコールバック
(<parameter>reschedule_cb</parameter>) が呼び出されます。
コールバックの最初の引数がウォッチャー、そして二番目の引数が現在時刻となります。
</para>
<para>
</simpara>
<simpara>
このコールバックは、自分自身あるいは他の定期ウォッチャーを停止したり破棄したり
<emphasis>してはいけません</emphasis>。また、
イベントループ関数やメソッドも
@@ -75,13 +75,13 @@ $hourly = EvPeriodic(0, 3600, NULL, function () {
ウォッチャーを止めるには、<literal>1e30</literal>
を返した後で停止します。
このタスクには、<classname>EvPrepare</classname> ウォッチャーが使えます。
</para>
<para>
</simpara>
<simpara>
コールバックは、次の実行時刻を返す必要があります。次の実行時刻は、
コールバックに渡された時刻をベースにしたものです
(つまり、二番目の引数で受け取った時刻と同じかそれよりも大きな値を返します)。
コールバックが呼ばれるのは、通常はイベントが発生する直前ですが、それ以外の場合にも呼ばれる可能性があります。
</para>
</simpara>
<example>
<title>再スケジュールコールバックの利用</title>
<programlisting role="php">

16
reference/ev/setup.xml
View File

@@ -1,27 +1,27 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<chapter xml:id="ev.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.setup">
&reftitle.setup;
<section xml:id="ev.requirements">
&reftitle.required;
<para>
<simpara>
<literal>libev</literal>
ライブラリはこの拡張モジュールに組み込まれているので、
個別にインストールする必要はありません。
</para>
</simpara>
</section>
<section xml:id="ev.installation">
&reftitle.install;
<para>
<simpara>
&pecl.moved;
</para>
<para>
</simpara>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;ev">&url.pecl.package;ev</link>
.
</para>
</simpara>
</section>
</chapter>
<!-- Keep this comment at the end of the file

22
reference/ev/watcher-callbacks.xml
View File

@@ -1,23 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3c63380ab47a48be4f9a54a0e8739b71e7d36d95 Maintainer: takagi Status: ready -->
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.watcher-callbacks">
<title>ウォッチャーのコールバック</title>
<para>
<simpara>
すべてのウォッチャーは、アクティブ (イベントを待ち受け中)
あるいは非アクティブ (一時停止) の状態になります。
コールバックを実行できるのは、アクティブなウォッチャーだけです。
すべてのコールバックは、少なくとも二つの引数を付けて呼ばれます。
<parameter>watcher</parameter> (ウォッチャー)、そして
<parameter>revents</parameter> (受け取ったイベントのビットマスク) です。
</para>
<para>
</simpara>
<simpara>
ウォッチャーのコールバックは、ウォッチャーのコンストラクタ
(<classname>EvWatcher</classname> の派生クラス。
<methodname>EvCheck::__construct</methodname> や
<methodname>EvChild::__construct</methodname> など)
に渡します。コールバックは、次のプロトタイプにしたがわなければいけません。
</para>
</simpara>
<methodsynopsis>
<type>void</type>
<methodname>callback</methodname>
@@ -38,9 +38,9 @@
<parameter>watcher</parameter>
</term>
<listitem>
<para>
<simpara>
<classname>EvWatcher</classname> を継承したクラスのインスタンス。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -48,13 +48,13 @@
<parameter>revents</parameter>
</term>
<listitem>
<para>
<simpara>
<link linkend="ev.constants.watcher-revents">ウォッチャーが受信したイベント</link>
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
<para>
<simpara>
ウォッチャーの型によって、
<parameter>revents</parameter> に関連するビットが割り当てられています。
そのため、複数のウォッチャーに対して同じコールバックを使えます。
@@ -68,7 +68,7 @@
などです。ただ I/O のイベントは例外で、これは
<constant>Ev::READ</constant> と <constant>Ev::WRITE</constant>
の両方のビットを設定します。
</para>
</simpara>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:

20
reference/ev/watchers.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 23ea6be076881a34e1d454e9680968ece085f7f6 Maintainer: takagi Status: ready -->
<chapter xml:id="ev.watchers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: takagi Status: ready -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ev.watchers">
<title>ウォッチャー</title>
<para>
ウォッチャーは、何らかのイベントに関する興味を記録するオブジェクトです。
@@ -19,27 +19,27 @@ Ev::run(Ev::RUN_ONCE);
]]>
</programlisting>
</para>
<para>
<simpara>
すべてのウォッチャーのコンストラクタが、自動的にウォッチャーを開始します。
<literal>createStopped</literal> メソッドを使う
(<methodname>EvIo::createStopped</methodname> など)
と、停止状態のウォッチャーを作れます。
</para>
<para>
</simpara>
<simpara>
ウォッチャーオブジェクトを破棄するときには、自動的にウォッチャーが停止することに注意しましょう。
したがって、コンストラクタやファクトリーメソッドが返すオブジェクトはずっと維持する必要があります。
</para>
<para>
</simpara>
<simpara>
また、ウォッチャーのプロパティ
(<emphasis>set</emphasis> や <varname>priority</varname> etc.)
を変更するすべてのメソッドは、自動的にウォッチャーを停止して
アクティブになったら立ち上げなおすことにも注意しましょう。
つまり、未処理のイベントは失われてしまいます。
</para>
<para>
</simpara>
<simpara>
<link linkend="ev.watcher-callbacks">ウォッチャーのコールバック</link>
も参照ください。
</para>
</simpara>
</chapter>
<!-- Keep this comment at the end of the file
Local variables: