Update channel.jax

Author: h-east

doc/channel.jax

@@ -1,4 +1,4 @@
-*channel.txt*      For Vim バージョン 8.0.  Last change: 2016 Dec 02
+*channel.txt*      For Vim バージョン 8.1.  Last change: 2018 Apr 18
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -16,12 +16,13 @@ Netbeans インターフェイスもチャネルを使っています。|netbean
 3. チャネルを開く			|channel-open|
 4. JSON、JS チャネルを使う		|channel-use|
 5. チャネルコマンド			|channel-commands|
-6. RAW、NL チャネルをつかう		|channel-raw|
+6. RAW、NL チャネルを使う		|channel-raw|
 7. その他のチャネル機能			|channel-more|
 8. チャネルでジョブを開始する		|job-start|
 9. チャネルなしでジョブを開始する	|job-start-nochannel|
 10. ジョブオプション			|job-options|
 11. ジョブを制御する			|job-control|
+12. プロンプトバッファを使う		|prompt-buffer|
 
 {Vi にはこれらの機能はありません}
 {Vim が |+channel| 機能付きでコンパイルされたときのみ有効}
@@ -490,6 +491,12 @@ JS または JSON チャネルの場合、これは1つのデコードされた
 ンを使用します: >
     let job = job_start(command, {"callback": "MyHandler"}) 
 
+システムによっては、ジョブを開始するとVimをバックグラウンドに置くことができ、
+開始されたジョブはフォーカスを取得します。これを避けるには `foreground()` 関数
+を使用してください。これは、早く呼び出されたとき、コールバックハンドラ内に置い
+たとき、またはジョブが開始した後にタイマーを使用して呼び出すときは、必ずしも機
+能しない場合があります。
+
 ch_evalraw() でコマンドにメッセージを送ることができます。チャネルが JSON また
 は JS モードの場合、ch_evalexpr() を使用できます。
 
@@ -513,9 +520,9 @@ ch_evalraw() でコマンドにメッセージを送ることができます。
 デフォルトでは、これはバッファ全体を読み込みます。これは "in_top" と "in_bot"
 オプションで変更できます。
 
-特殊モードは、in_top が 0 に設定され、in_bot が設定されていない場合です。バッ
-ファに行が追加されるたびに、最後の 1 行がジョブ stdin に送信されます。これによ
-り、最後の行を編集し、Enter を押したときに送信することができます。
+特殊モードは、"in_top" が 0 に設定され、"in_bot" が設定されていない場合です。
+バッファに行が追加されるたびに、最後の 1 行がジョブ stdin に送信されます。これ
+により、最後の行を編集し、Enter を押したときに送信することができます。
 							*channel-close-in*
 特殊モードを使用しないときは、最後の行が書き込まれた後にパイプまたはソケットが
 閉じられます。これは、入力が終了した読み取り終了を知らせます。|ch_close_in()|
@@ -606,7 +613,7 @@ job_setoptions(job, {options}) を使用して、ジョブの開始後にいく
 "close_cb": handler	チャネルが閉じられるときのコールバック。
 			|ch_open()| の "close_cb" と同じです。|close_cb| 参照。
 						*job-drop*
-"drop"			メッセージをいつドロップするかを指定します。
+"drop": when		メッセージをいつドロップするかを指定します。
 			|ch_open()| の "drop" と同様(|channel-drop| 参照)。
 			"auto" の場合、exit_cb は考慮されません。
 						*job-exit_cb*
@@ -619,12 +626,12 @@ job_setoptions(job, {options}) を使用して、ジョブの開始後にいく
 			データがバッファリングされ、プロセスが終了した後もコー
 			ルバックが呼び出されることに注意してください。
 							*job-timeout*
-"timeout"		ブロッキング時にリクエストを待つ時間 (例: ch_evalexpr()
+"timeout": time		ブロッキング時にリクエストを待つ時間 (例: ch_evalexpr()
 			を使用するとき。ミリ秒単位。デフォルトは 2000 (2 秒)
 			です。
 						*out_timeout* *err_timeout*
-"out_timeout"		stdout のタイムアウト。パイプ使用時のみ。
-"err_timeout"		stderr のタイムアウト。パイプ使用時のみ。
+"out_timeout": time	stdout のタイムアウト。パイプ使用時のみ。
+"err_timeout": time	stderr のタイムアウト。パイプ使用時のみ。
 			Note: "timeout" を設定すると、パーツ固有のモードが上書
 			きされます。したがって、最初に "timeout" を設定し、後
 			でパーツ固有のモードを設定します。
@@ -636,8 +643,9 @@ job_setoptions(job, {options}) を使用して、ジョブの開始後にいく
 			デフォルトは "term" です。
 
 						*job-term*
-"term":"open"		ターミナルを起動し、ジョブ stdin/stdout/stderr を接続
-			します。
+"term":"open"		新しいウィンドウでターミナルを起動し、ジョブ
+			stdin/stdout/stderr を接続します。`:terminal` を使用す
+			ることと同じです。
 			NOTE: まだ実装されていません!
 
 "channel": {channel}	新しいチャネルを作成する代わりに、既存のチャネルを使用
@@ -647,6 +655,11 @@ job_setoptions(job, {options}) を使用して、ジョブの開始後にいく
 			性があります。
 			既存のコールバックやその他の設定が残っています。
 
+"pty": 1		可能であれば、パイプのかわりに pty (疑似 tty) を使いま
+			す。これは端末ウィンドウとの組み合わせで最も便利です。
+			|terminal| を参照。
+			{Unix系システムのみ}
+
 				*job-in_io* *in_top* *in_bot* *in_name* *in_buf*
 "in_io": "null"		stdin を切断する (/dev/null から読み込む)
 "in_io": "pipe"		標準入力がチャネルに接続されている (デフォルト)
@@ -687,6 +700,10 @@ job_setoptions(job, {options}) を使用して、ジョブの開始後にいく
 "block_write": number	テストのためにのみ: stdin への他のすべての書き込みをブ
 			ロックするふりをする
 
+"env": dict		新しいプロセスのための環境変数
+"cwd": "/path/to/dir"	新しいプロセスのためのカレント作業ディレクトリ。ディレ
+			クトリが存在しない場合は、エラーが発生します
+
 
 バッファへの書き込み ~
 							*out_io-buffer*
@@ -722,10 +739,6 @@ out_io または err_io モードが "buffer" で、コールバックがある
 output..." に設定するかどうかを指定するために使用できます。デフォルトではメッ
 セージを追加します。"err_msg" はチャネルエラーでも同じです。
 
-'modifiable' オプションをオフにしたり、'modifiable' オフなバッファを書き込んだ
-りすることができます。つまり、行がバッファに追加されますが、ユーザーはバッファ
-を簡単に変更できません。
-
 既存のバッファに 'modifiable' が指定されておらず、"out_modifiable" または
 "err_modifiable" オプションがゼロでない場合、エラーが発生し、バッファに書き込
 まれません。
@@ -761,5 +774,47 @@ output..." に設定するかどうかを指定するために使用できます
 
 他のオプションについては、|job_stop()| 参照。
 
+==============================================================================
+12. プロンプトバッファを使う				*prompt-buffer*
+
+Vimのウィンドウでジョブのための入力をタイプしたい場合、いくつかのオプションが
+あります:
+- 通常のバッファを使用して、すべての起こりうるコマンドを自分で処理します。
+  たくさんの起こりうるコマンドが存在するので、これは複雑になります。
+- 端末ウィンドウを使用します。入力した内容がジョブに直接送られ、ジョブの出力が
+  ウィンドウに直接表示される場合は、これはうまく機能します。
+  |terminal-window| 参照。
+- これは、Vimでジョブからの出力 (フィルタリングされている可能性もある) を表示
+  している間に、ジョブのための行を入力しているときにうまく動作します。
+
+プロンプトバッファは、'buftype' を "prompt" に設定することによって作成されま
+す。通常は、新規作成バッファでのみおこないます。
+
+ユーザーは、バッファの最後の行に1行のテキストを編集して入力することができます。
+プロンプト行でEnterキーを押すと、|prompt_setcallback()| が呼び出されます。通常
+は、その行をジョブに送信します。 別のコールバックは、ジョブからの出力を受け取
+り、プロンプトの下の (次のプロンプトの上) バッファに表示します。
+
+プロンプトの後の最後の行のテキストのみが編集可能です。残りのバッファはノーマル
+モードのコマンドでは変更できません。|append()| などの関数を呼び出すことで変更
+できます。他のコマンドを使用すると、バッファを壊す可能性があります。
+
+'buftype' を "prompt" に設定した後、Vimは自動的に挿入モードを開始しません。挿
+入モードに入るには `:startinsert` を使います。これにより、ユーザは行の入力を開
+始できます。
+
+プロンプトのテキストは、|prompt_setprompt()| 関数で設定できます。
+
+ユーザーはノーマルモードに移行し、バッファ内を移動できます。これは、古い出力の
+参照やテキストのコピーに便利です。
+
+CTRL-W キーを使用して次のウィンドウに切り替えるための CTRL-W w などのウィンド
+ウコマンドを開始できます。これは挿入モードでも機能します (単語を削除するには
+Shift-CTRL-W を使用します)。ウィンドウを離れるとき挿入モードは停止します。プロ
+ンプトウィンドウに戻ると、挿入モードが復元されます。
+
+"a", "i", "A" や "I" などの挿入モードを開始するコマンドは、最終行にカーソルを
+移動します。"A" は行頭に移動し、"I" は行頭に移動します。
+
 
- vim:tw=78:ts=8:ft=help:norl:
+ vim:tw=78:ts=8:noet:ft=help:norl: