Skip to content

Commit

Permalink
[DOC] Update PTY documents
Browse files Browse the repository at this point in the history
- Fix markups as RDoc.
- Remove already descriptions of removed methods.
  • Loading branch information
nobu committed Apr 7, 2024
1 parent 6bfabd0 commit eaa6e4b
Show file tree
Hide file tree
Showing 2 changed files with 39 additions and 43 deletions.
32 changes: 17 additions & 15 deletions doc/pty/README.expect.ja
@@ -1,21 +1,23 @@
README for expect
= README for expect
by A. Ito, 28 October, 1998

Expectライブラリは,tcl の expect パッケージと似たような機能を
Expectライブラリは,tcl の expect パッケージと似たような機能を
IOクラスに追加します.

追加されるメソッドの使い方は次の通りです.
追加されるメソッドの使い方は次の通りです.

IO#expect(pattern,timeout=9999999)
[IO#expect(pattern,timeout=9999999)]

pattern は String か Regexp のインスタンス,timeout は Fixnum
のインスタンスです.timeout は省略できます.
このメソッドがブロックなしで呼ばれた場合,まずレシーバである
IOオブジェクトから pattern にマッチするパターンが読みこまれる
まで待ちます.パターンが得られたら,そのパターンに関する配列を
返します.配列の最初の要素は,pattern にマッチするまでに読みこ
まれた内容の文字列です.2番目以降の要素は,pattern の正規表現
の中にアンカーがあった場合に,そのアンカーにマッチする部分です.
もしタイムアウトが起きた場合は,このメソッドはnilを返します.
このメソッドがブロック付きで呼ばれた場合には,マッチした要素の
配列がブロック引数として渡され,ブロックが評価されます.
_pattern_ は String か Regexp のインスタンス,_timeout_ は Fixnum
のインスタンスです._timeout_ は省略できます.

このメソッドがブロックなしで呼ばれた場合,まずレシーバである
IOオブジェクトから _pattern_ にマッチするパターンが読みこまれる
まで待ちます.パターンが得られたら,そのパターンに関する配列を
返します.配列の最初の要素は,_pattern_ にマッチするまでに読みこ
まれた内容の文字列です.2番目以降の要素は,_pattern_ の正規表現
の中にアンカーがあった場合に,そのアンカーにマッチする部分です.
もしタイムアウトが起きた場合は,このメソッドは +nil+ を返します.

このメソッドがブロック付きで呼ばれた場合には,マッチした要素の
配列がブロック引数として渡され,ブロックが評価されます.
50 changes: 22 additions & 28 deletions doc/pty/README.ja
@@ -1,27 +1,26 @@
pty 拡張モジュール version 0.3 by A.ito
= pty 拡張モジュール version 0.3 by A.ito

1. はじめに

この拡張モジュールは,仮想tty (pty) を通して適当なコマンドを
実行する機能を ruby に提供します.
この拡張モジュールは,仮想tty (pty) を通して適当なコマンドを
実行する機能を ruby に提供します.

2. インストール

次のようにしてインストールしてください.
次のようにしてインストールしてください.

(1) ruby extconf.rb
1. <tt>ruby extconf.rb</tt>
を実行すると Makefile が生成されます.

を実行すると Makefile が生成されます.

(2) make; make install を実行してください.
2. <tt>make; make install</tt> を実行してください.

3. 何ができるか

この拡張モジュールは,PTY というモジュールを定義します.その中
には,次のようなモジュール関数が含まれています.
この拡張モジュールは,PTY というモジュールを定義します.その中
には,次のようなモジュール関数が含まれています.

getpty(command)
spawn(command)
[PTY.getpty(command)]
[PTY.spawn(command)]

この関数は,仮想ttyを確保し,指定されたコマンドをその仮想tty
の向こうで実行し,配列を返します.戻り値は3つの要素からなる
Expand All @@ -35,20 +34,15 @@ pty 拡張モジュール version 0.3 by A.ito
のみ例外が発生します.子プロセスをモニターしているスレッドはブロッ
クを抜けるときに終了します.

protect_signal
reset_signal

廃止予定です.

PTY.open
[PTY.open]

仮想ttyを確保し,マスター側に対応するIOオブジェクトとスレーブ側に
対応するFileオブジェクトの配列を返します.ブロック付きで呼び出さ
れた場合は,これらの要素はブロックパラメータとして渡され,ブロッ
クから返された結果を返します.また、このマスターIOとスレーブFile
は、ブロックを抜けるときにクローズ済みでなければクローズされます.

PTY.check(pid[, raise=false])
[PTY.check(pid[, raise=false])]

pidで指定された子プロセスの状態をチェックし,実行中であればnilを
返します.終了しているか停止している場合、第二引数が偽であれば、
Expand All @@ -57,20 +51,20 @@ pty 拡張モジュール version 0.3 by A.ito

4. 利用について

伊藤彰則が著作権を保有します.
伊藤彰則が著作権を保有します.

ソースプログラムまたはドキュメントに元の著作権表示が改変されずに
表示されている場合に限り,誰でも,このソフトウェアを無償かつ著作
権者に無断で利用・配布・改変できます.利用目的は限定されていませ
ん.
ソースプログラムまたはドキュメントに元の著作権表示が改変されずに
表示されている場合に限り,誰でも,このソフトウェアを無償かつ著作
権者に無断で利用・配布・改変できます.利用目的は限定されていませ
ん.

このプログラムの利用・配布その他このプログラムに関係する行為によ
って生じたいかなる損害に対しても,作者は一切責任を負いません.
このプログラムの利用・配布その他このプログラムに関係する行為によ
って生じたいかなる損害に対しても,作者は一切責任を負いません.

5. バグ報告等

バグレポートは歓迎します.
バグレポートは歓迎します.

aito@ei5sun.yz.yamagata-u.ac.jp

まで電子メールでバグレポートをお送りください.
まで電子メールでバグレポートをお送りください.

0 comments on commit eaa6e4b

Please sign in to comment.