From eaddc4a94bf1dfb95ef889e2dd5521b657845675 Mon Sep 17 00:00:00 2001 From: knu Date: Thu, 19 Jul 2001 05:44:26 +0000 Subject: Rename *.jp to *.ja, since jp is a region code and ja is a language code. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@1629 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ext/pty/MANIFEST | 4 +-- ext/pty/README.expect.ja | 21 ++++++++++++ ext/pty/README.expect.jp | 21 ------------ ext/pty/README.ja | 89 ++++++++++++++++++++++++++++++++++++++++++++++++ ext/pty/README.jp | 89 ------------------------------------------------ 5 files changed, 112 insertions(+), 112 deletions(-) create mode 100644 ext/pty/README.expect.ja delete mode 100644 ext/pty/README.expect.jp create mode 100644 ext/pty/README.ja delete mode 100644 ext/pty/README.jp (limited to 'ext/pty') diff --git a/ext/pty/MANIFEST b/ext/pty/MANIFEST index f46d611e5b..0535a5b7ef 100644 --- a/ext/pty/MANIFEST +++ b/ext/pty/MANIFEST @@ -1,8 +1,8 @@ MANIFEST README README.expect -README.expect.jp -README.jp +README.expect.ja +README.ja depend expect_sample.rb extconf.rb diff --git a/ext/pty/README.expect.ja b/ext/pty/README.expect.ja new file mode 100644 index 0000000000..db84695ee5 --- /dev/null +++ b/ext/pty/README.expect.ja @@ -0,0 +1,21 @@ + README for expect + by A. Ito, 28 October, 1998 + + Expectライブラリは，tcl の expect パッケージと似たような機能を +IOクラスに追加します． + + 追加されるメソッドの使い方は次の通りです． + + IO#expect(pattern,timeout=9999999) + +pattern は String か Regexp のインスタンス，timeout は Fixnum +のインスタンスです．timeout は省略できます． + このメソッドがブロックなしで呼ばれた場合，まずレシーバである +IOオブジェクトから pattern にマッチするパターンが読みこまれる +まで待ちます．パターンが得られたら，そのパターンに関する配列を +返します．配列の最初の要素は，pattern にマッチするまでに読みこ +まれた内容の文字列です．2番目以降の要素は，pattern の正規表現 +の中にアンカーがあった場合に，そのアンカーにマッチする部分です． +もしタイムアウトが起きた場合は，このメソッドはnilを返します． + このメソッドがブロック付きで呼ばれた場合には，マッチした要素の +配列がブロック引数として渡され，ブロックが評価されます． diff --git a/ext/pty/README.expect.jp b/ext/pty/README.expect.jp deleted file mode 100644 index db84695ee5..0000000000 --- a/ext/pty/README.expect.jp +++ /dev/null @@ -1,21 +0,0 @@ - README for expect - by A. Ito, 28 October, 1998 - - Expectライブラリは，tcl の expect パッケージと似たような機能を -IOクラスに追加します． - - 追加されるメソッドの使い方は次の通りです． - - IO#expect(pattern,timeout=9999999) - -pattern は String か Regexp のインスタンス，timeout は Fixnum -のインスタンスです．timeout は省略できます． - このメソッドがブロックなしで呼ばれた場合，まずレシーバである -IOオブジェクトから pattern にマッチするパターンが読みこまれる -まで待ちます．パターンが得られたら，そのパターンに関する配列を -返します．配列の最初の要素は，pattern にマッチするまでに読みこ -まれた内容の文字列です．2番目以降の要素は，pattern の正規表現 -の中にアンカーがあった場合に，そのアンカーにマッチする部分です． -もしタイムアウトが起きた場合は，このメソッドはnilを返します． - このメソッドがブロック付きで呼ばれた場合には，マッチした要素の -配列がブロック引数として渡され，ブロックが評価されます． diff --git a/ext/pty/README.ja b/ext/pty/README.ja new file mode 100644 index 0000000000..5ae4fb06a0 --- /dev/null +++ b/ext/pty/README.ja @@ -0,0 +1,89 @@ +pty 拡張モジュール version 0.3 by A.ito + +1. はじめに + +この拡張モジュールは，仮想tty (pty) を通して適当なコマンドを +実行する機能を ruby に提供します． + +2. インストール + +次のようにしてインストールしてください． + +(1) ruby extconf.rb + + を実行すると Makefile が生成されます． + +(2) make; make install を実行してください． + +3. 何ができるか + +この拡張モジュールは，PTY というモジュールを定義します．その中 +には，次のようなモジュール関数が含まれています． + + getpty(command) + spawn(command) + + この関数は，仮想ttyを確保し，指定されたコマンドをその仮想tty + の向こうで実行し，配列を返します．戻り値は3つの要素からなる + 配列です．最初の要素は仮想ttyから読み出すためのIOオブジェクト， + 2番目は書きこむためのIOオブジェクト，3番目は子プロセスのプロ + セスIDです．この関数がイテレータとして呼ばれた場合，これらの + 要素はブロックパラメータとして渡され，関数自体はnilを返します． + + この関数によって作られたサブプロセスが動いている間，子プロセス + の状態を監視するために SIGCHLD シグナルを捕捉します．子プロセス + が終了したり停止した場合には，例外が発生します．この間，すべての + SIGCHLD が PTY モジュールのシグナルハンドラに捕捉されるので， + サブプロセスを生成する他の関数(system() とか IO.popen()など)を + 使うと，予期しない例外が発生することがあります．これを防ぐため + には，下記のprotect_signal()を参照してください． + + この関数がブロックパラメータ付きで呼ばれた場合には，そのブロック + の中でのみ SIGCHLD が捕捉されます．したがって，ブロックパラメータ + として渡されたIOオブジェクトを，ブロックの外に持ち出して使うの + は勧められません． + + + protect_signal + + この関数はイテレータです．ここで指定されたブロックの中では， + 子プロセスが終了しても例外を発生しません．この関数を使うことで， + PTYの子プロセスが動いている間でも，system()や IO.popen()などの + 関数を安全に使うことができます．例えば， + + PTY.spawn("command_foo") do |r,w| + ... + ... + PTY.protect_signal do + system "some other commands" + end + ... + end + + このような記述により，"some other commands" が終了したときに + 例外が発生するのを防げます． + + reset_signal + + PTY の子プロセスが動いていても，そのプロセスの終了時に例外が発生 + しないようにします． + +4. 利用について + +伊藤彰則が著作権を保有します． + +ソースプログラムまたはドキュメントに元の著作権表示が改変されずに +表示されている場合に限り，誰でも，このソフトウェアを無償かつ著作 +権者に無断で利用・配布・改変できます．利用目的は限定されていませ +ん． + +このプログラムの利用・配布その他このプログラムに関係する行為によ +って生じたいかなる損害に対しても，作者は一切責任を負いません． + +5. バグ報告等 + +バグレポートは歓迎します． + + aito@ei5sun.yz.yamagata-u.ac.jp + +まで電子メールでバグレポートをお送りください． diff --git a/ext/pty/README.jp b/ext/pty/README.jp deleted file mode 100644 index 5ae4fb06a0..0000000000 --- a/ext/pty/README.jp +++ /dev/null @@ -1,89 +0,0 @@ -pty 拡張モジュール version 0.3 by A.ito - -1. はじめに - -この拡張モジュールは，仮想tty (pty) を通して適当なコマンドを -実行する機能を ruby に提供します． - -2. インストール - -次のようにしてインストールしてください． - -(1) ruby extconf.rb - - を実行すると Makefile が生成されます． - -(2) make; make install を実行してください． - -3. 何ができるか - -この拡張モジュールは，PTY というモジュールを定義します．その中 -には，次のようなモジュール関数が含まれています． - - getpty(command) - spawn(command) - - この関数は，仮想ttyを確保し，指定されたコマンドをその仮想tty - の向こうで実行し，配列を返します．戻り値は3つの要素からなる - 配列です．最初の要素は仮想ttyから読み出すためのIOオブジェクト， - 2番目は書きこむためのIOオブジェクト，3番目は子プロセスのプロ - セスIDです．この関数がイテレータとして呼ばれた場合，これらの - 要素はブロックパラメータとして渡され，関数自体はnilを返します． - - この関数によって作られたサブプロセスが動いている間，子プロセス - の状態を監視するために SIGCHLD シグナルを捕捉します．子プロセス - が終了したり停止した場合には，例外が発生します．この間，すべての - SIGCHLD が PTY モジュールのシグナルハンドラに捕捉されるので， - サブプロセスを生成する他の関数(system() とか IO.popen()など)を - 使うと，予期しない例外が発生することがあります．これを防ぐため - には，下記のprotect_signal()を参照してください． - - この関数がブロックパラメータ付きで呼ばれた場合には，そのブロック - の中でのみ SIGCHLD が捕捉されます．したがって，ブロックパラメータ - として渡されたIOオブジェクトを，ブロックの外に持ち出して使うの - は勧められません． - - - protect_signal - - この関数はイテレータです．ここで指定されたブロックの中では， - 子プロセスが終了しても例外を発生しません．この関数を使うことで， - PTYの子プロセスが動いている間でも，system()や IO.popen()などの - 関数を安全に使うことができます．例えば， - - PTY.spawn("command_foo") do |r,w| - ... - ... - PTY.protect_signal do - system "some other commands" - end - ... - end - - このような記述により，"some other commands" が終了したときに - 例外が発生するのを防げます． - - reset_signal - - PTY の子プロセスが動いていても，そのプロセスの終了時に例外が発生 - しないようにします． - -4. 利用について - -伊藤彰則が著作権を保有します． - -ソースプログラムまたはドキュメントに元の著作権表示が改変されずに -表示されている場合に限り，誰でも，このソフトウェアを無償かつ著作 -権者に無断で利用・配布・改変できます．利用目的は限定されていませ -ん． - -このプログラムの利用・配布その他このプログラムに関係する行為によ -って生じたいかなる損害に対しても，作者は一切責任を負いません． - -5. バグ報告等 - -バグレポートは歓迎します． - - aito@ei5sun.yz.yamagata-u.ac.jp - -まで電子メールでバグレポートをお送りください． -- cgit v1.2.3