Skip to content

Update terminal.{txt,jax} #1844

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 27, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion doc/terminal.jax
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*terminal.txt* For Vim バージョン 9.1. Last change: 2024 Nov 19
*terminal.txt* For Vim バージョン 9.1. Last change: 2024 Nov 23


VIMリファレンスマニュアル by Bram Moolenaar
Expand Down Expand Up @@ -196,6 +196,13 @@ Normal ハイライトグループにより決定される。
[command] が NONE の場合ジョブは開始されず、端末の pty
は gdb のようなコマンドによって利用できる。

*terminal-nospecial*
Vim 自体は [command] 内の |cmdline-special| 文字のみを
認識する。その他はすべてそのまま渡される。ワイルドカー
ド、環境変数、またはその他のシェル特殊文字を展開する必
要がある場合は、|term++shell| オプションを検討するこ
と。

[command] がない場合、デフォルトの動作はシェルが終了し
たときに端末を閉じる。この動作は ++noclose 引数で変更
できる。
Expand Down Expand Up @@ -240,10 +247,16 @@ Normal ハイライトグループにより決定される。
ウは使用されない。
++norestore セッションファイルに端末ウィンドウを含
めない。

*term++shell*
++shell {command} を直接実行するのではなく、
`:!command` と同様にシェルを使用する。
*E279*
{Vim: UnixとMS-Windowsでのみ動作する}
結果のコマンドは次のようになる
'shell' 'shellcmdflag' [command]
`:!command` に関連するその他のオプショ
ンは効果がない。
++kill={how} 端末ウィンドウを閉じるときに {how} で
ジョブを終了させる。値については
|term_setkill()| を参照。
Expand Down
15 changes: 14 additions & 1 deletion en/terminal.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
*terminal.txt* For Vim version 9.1. Last change: 2024 Nov 19
*terminal.txt* For Vim version 9.1. Last change: 2024 Nov 23


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -197,6 +197,13 @@ Command syntax ~
if [command] is NONE no job is started, the pty of the
terminal can be used by a command like gdb.

*terminal-nospecial*
Vim itself only recognizes |cmdline-special|
characters inside [command]. Everything else will be
passed untouched. When needed to expand wildcards,
environment variables or other shell specials consider
|term++shell| option.

If [command] is missing the default behavior is to
close the terminal when the shell exits. This can be
changed with the ++noclose argument.
Expand Down Expand Up @@ -241,10 +248,16 @@ Command syntax ~
no window will be used.
++norestore Do not include this terminal window
in a session file.

*term++shell*
++shell Instead of executing {command}
directly, use a shell, like with
`:!command` *E279*
{only works on Unix and MS-Windows}
The resulting command will look like
'shell' 'shellcmdflag' [command]
Other options related to `:!command`
have no effect.
++kill={how} When trying to close the terminal
window kill the job with {how}. See
|term_setkill()| for the values.
Expand Down