diff --git a/doc/windows.jax b/doc/windows.jax index 87f8208b5..0f5ed1a18 100644 --- a/doc/windows.jax +++ b/doc/windows.jax @@ -1,4 +1,4 @@ -*windows.txt* For Vim バージョン 8.0. Last change: 2016 Dec 01 +*windows.txt* For Vim バージョン 8.1. Last change: 2018 Apr 24 VIMリファレンスマニュアル by Bram Moolenaar @@ -235,6 +235,11 @@ CTRL-W ^ ":split #" と同じ。つまり、ウィンドウを2つに分割し ファイルを編集する。カウントが指定された場合は ":split #N" と 同じ。つまり、ウィンドウを分割してバッファNを編集する。 + *CTRL-W_:* +CTRL-W : |:| と同じ。: コマンドラインを編集する。 + すべてのVimコマンドが CTRL-W または 'termkey' から始められなけ + ればならない端末ウィンドウの中で役に立つ。 + オプション 'splitbelow' と 'splitright' が新しいウィンドウが現れる場所に影響を 及ぼすことに注意。 @@ -353,9 +358,9 @@ CTRL-W CTRL-C *CTRL-W_CTRL-C* *:hide* :hid[e] :{count}hid[e] - カレントウィンドウがスクリーン上の最後のウィンドウでなければ、 - カレントウィンドウを終了する。 {count} については |:quit| コマ - ンドを参照。 + {count} なし: カレントウィンドウがスクリーン上の最後のウィンド + ウでなければ、カレントウィンドウを終了する。 + もし {count} が与えられた場合、{count} ウィンドウを終了する。 (他のウィンドウがバッファを編集していなく、かつ 'bufhidden' の 値が "unload", "delete", "wipe" のいずれでもないならば)その @@ -634,7 +639,8 @@ CTRL-W | カレントウィンドウの幅を N桁にする (デフォルト:可 41. :buffers バッファの表示 [N] の意味はコマンドによって異なる。 - ?2、?3、?4のコマンドにおいては、[N]は前方/後方に移動するバッファ数 + 2/12/22/32、3/13/23/33、4/14/24/34のコマンドにおいては、[N]は前方/後方に移動 + するバッファ数 1、21のコマンドにおいては、[N]は引数番号、デフォルトはカレント引数 11、31のコマンドにおいては、[N]はバッファ番号、デフォルトはカレントバッファ 19、39のコマンドにおいては、[N]はカウント @@ -729,7 +735,6 @@ Note: ":next" は例外である。なぜならこのコマンドは Vi との ページで開かれる。最後のウィンドウが空ならそのウィンドウが使わ れる。 |++opt| と |+cmd| も参照。 - {GUI 機能つきでコンパイルされたときのみ使用可能} ============================================================================== 8. 全てのバッファ／ウィンドウに対してコマンド実行 *list-repeat* @@ -750,8 +755,7 @@ Note: ":next" は例外である。なぜならこのコマンドは Vi との {cmd} は '|' を含んで複数のコマンドを連結していてもよ い。 {cmd} はウィンドウの開閉、並べ替えをしてはならない。 - {Vi にはない} {|+listcmds| 機能なしでコンパイルされた場 - 合は使用できない} + {Vi にはない} |:tabdo|、|:argdo|、|:bufdo|、|:cdo|、|:ldo|、|:cfdo|、 |:lfdo|も参照。 @@ -779,8 +783,7 @@ Note: ":next" は例外である。なぜならこのコマンドは Vi との Note:このコマンドを実行している間、Syntax 自動コマンド イベントが 'eventignore' に追加され、無効化される。 これは各バッファの編集を大幅にスピードアップさせる。 - {Vi にはない} {|+listcmds| 機能なしでコンパイルされた - 場合は使用できない} + {Vi にはない} |:tabdo|、|:argdo|、|:windo|、|:cdo|、|:ldo|、|:cfdo|、 |:lfdo| も参照。 @@ -994,7 +997,6 @@ CTRL-W g } *CTRL-W_g}* ている。これにより、毎回ファイルを保存したり読み込んだりしなくても、また、ウィ ンドウ内にファイルを残しておかなくても、他のバッファをウィンドウに表示すること が可能となる。 -{|+listcmds| 機能なしでコンパイルされた場合には使用できない} *:buffer-!* 'hidden' ('hi') オプションがセットされている場合は、":edit", ":next", ":tag" @@ -1053,6 +1055,9 @@ CTRL-W g } *CTRL-W_g}* 示されていない |hidden-buffer| - 'modifiable' がオフのバッファ = リードオンリーのバッファ + R 実行中のジョブありの端末バッファ + F 終了したジョブありの端末バッファ + ? ジョブなしの端末バッファ: `:terminal NONE` + 変更のあるバッファ x 読み込みエラーのあるバッファ @@ -1067,6 +1072,9 @@ CTRL-W g } *CTRL-W_g}* x 読み込みエラーのあるバッファ % 現在のバッファ # 代替バッファ + R 実行中のジョブありの複数の端末バッファ + F 終了したジョブありの複数の端末バッファ + ? ジョブなしの複数の端末バッファ: `:terminal NONE` フラグの合成は互いの "and" を意味します。例えば: h+ 変更された隠れバッファ a+ 変更されたアクティブバッファ @@ -1100,10 +1108,8 @@ CTRL-W g } *CTRL-W_g}* :%bdelete " delete all buffers :bdelete[!] {bufname} *E93* *E94* - ":bdelete[!] [N]" と同様だが、バッファを名前で指定する。数字が - 名前になっているバッファは、その数字では参照されない。つまり、 - バッファ番号として使用されてしまう。バッファ名中のスペースの前 - にはバックスラッシュを入れる必要がある。 + ":bdelete[!] [N]" と同様だが、バッファを名前で指定する。 + |{bufname}| を参照。 :bdelete[!] N1 N2 ... ":bdelete[!]" をバッファN1、N2、等に対して実行する。引数には @@ -1139,10 +1145,8 @@ CTRL-W g } *CTRL-W_g}* 用される。 :bunload[!] {bufname} - ":bunload[!] [N]" と同様だが、バッファを名前で指定する。数字が - 名前になっているバッファは、その数字では参照されない。つまり、 - バッファ番号として使用されてしまう。バッファ名中のスペースの前 - にはバックスラッシュを入れる必要がある。 + ":bunload[!] [N]" と同様だが、バッファを名前で指定する。 + |{bufname}| も参照。 :N,Mbunload[!] ":bunload[!]" を N から M まで(N,Mを含む)の全てのバッファに対 して実行する。 @@ -1160,10 +1164,15 @@ CTRL-W g } *CTRL-W_g}* 'buflisted' フラグを設定することなく編集する。 |+cmd| も参照。 -:[N]b[uffer][!] [+cmd] {bufname} - バッファリストの {bufname} のバッファを編集する。 [!]について - は |:buffer-!| を参照。これはバッファリストにないバッファも - 'buflisted' フラグを設定することなく編集する。 +:[N]b[uffer][!] [+cmd] {bufname} *{bufname}* + バッファリストの {bufname} のバッファを編集する。部分的な名前 + も、バッファリスト内で一意である限り動作する。 + バッファ名が数字であるバッファはその名前で参照することはできな + いことに注意。代わりにバッファ番号を使う。 + バッファ名の中のスペースの前にバックスラッシュを差し込む。 + [!] については |:buffer-!| を参照。 + これはバッファリストにないバッファも 'buflisted' フラグを設定 + することなく編集する。 |+cmd| も参照。 :[N]sb[uffer] [+cmd] [N] *:sb* *:sbuffer* @@ -1175,9 +1184,9 @@ CTRL-W g } *CTRL-W_g}* |+cmd| も参照。 :[N]sb[uffer] [+cmd] {bufname} - ウィンドウを分割しバッファリストの {bufname} バッファを編集す - る。これはバッファリストにないバッファも 'buflisted' フラグを - 設定することなく編集する。 + ウィンドウを分割しバッファリストの |{bufname}| バッファを編集 + する。これはバッファリストにないバッファも 'buflisted' フラグ + を設定することなく編集する。 Note: 別名でカレントバッファのコピーを作って、それを別のウィン ドウで表示したいのなら、次のようにすること: > :w foobar | sp # @@ -1299,6 +1308,9 @@ help ヘルプファイルを保持する。|:help| コマンドによっての ない。ヘルプバッファに対する 'buflisted' オプションはリセット される。 +terminal 端末ウィンドウバッファ、|terminal| を参照。ジョブが終了するま + でその内容を読み取ったり変更したりすることはできない。 + directory ディレクトリの内容を表示する。ファイルエクスプローラープラグイ ンで使用されている。このバッファは以下の設定で作成される: > :setlocal buftype=nowrite diff --git a/en/windows.txt b/en/windows.txt index fac738188..e88cfcb93 100644 --- a/en/windows.txt +++ b/en/windows.txt @@ -1,4 +1,4 @@ -*windows.txt* For Vim version 8.0. Last change: 2016 Dec 01 +*windows.txt* For Vim version 8.1. Last change: 2018 Apr 24 VIM REFERENCE MANUAL by Bram Moolenaar @@ -222,6 +222,11 @@ CTRL-W ^ Does ":split #", split window in two and edit alternate file. When a count is given, it becomes ":split #N", split window and edit buffer N. + *CTRL-W_:* +CTRL-W : Does the same as typing |:| : edit a command line. Useful in a + terminal window, where all Vim commands must be preceded with + CTRL-W or 'termkey'. + Note that the 'splitbelow' and 'splitright' options influence where a new window will appear. @@ -339,8 +344,9 @@ CTRL-W CTRL-C *CTRL-W_CTRL-C* *:hide* :hid[e] :{count}hid[e] - Quit the current window, unless it is the last window on the - screen. For {count} see |:quit| command. + Without {count}: Quit the current window, unless it is the + last window on the screen. + If {count} is given quit the {count} window. The buffer becomes hidden (unless there is another window editing it or 'bufhidden' is "unload", "delete" or "wipe"). @@ -613,7 +619,8 @@ The minimal height and width of a window is set with 'winminheight' and 41. :buffers list of buffers The meaning of [N] depends on the command: - [N] is number of buffers to go forward/backward on ?2, ?3, and ?4 + [N] is the number of buffers to go forward/backward on 2/12/22/32, + 3/13/23/33, and 4/14/24/34 [N] is an argument number, defaulting to current argument, for 1 and 21 [N] is a buffer number, defaulting to current buffer, for 11 and 31 [N] is a count for 19 and 39 @@ -704,7 +711,6 @@ can also get to them with the buffer list commands, like ":bnext". When using the |:tab| modifier each argument is opened in a tab page. The last window is used if it's empty. Also see |++opt| and |+cmd|. - {only available when compiled with a GUI} ============================================================================== 8. Do a command in all buffers or windows *list-repeat* @@ -725,8 +731,7 @@ can also get to them with the buffer list commands, like ":bnext". the current window. {cmd} can contain '|' to concatenate several commands. {cmd} must not open or close windows or reorder them. - {not in Vi} {not available when compiled without the - |+listcmds| feature} + {not in Vi} Also see |:tabdo|, |:argdo|, |:bufdo|, |:cdo|, |:ldo|, |:cfdo| and |:lfdo| @@ -754,8 +759,7 @@ can also get to them with the buffer list commands, like ":bnext". autocommand event is disabled by adding it to 'eventignore'. This considerably speeds up editing each buffer. - {not in Vi} {not available when compiled without the - |+listcmds| feature} + {not in Vi} Also see |:tabdo|, |:argdo|, |:windo|, |:cdo|, |:ldo|, |:cfdo| and |:lfdo| @@ -968,7 +972,6 @@ is no word under the cursor, and a few other things: > A hidden buffer is not displayed in a window, but is still loaded into memory. This makes it possible to jump from file to file, without the need to read or write the file every time you get another buffer in a window. -{not available when compiled without the |+listcmds| feature} *:buffer-!* If the option 'hidden' ('hid') is set, abandoned buffers are kept for all @@ -1026,6 +1029,9 @@ list of buffers. |unlisted-buffer| displayed in a window |hidden-buffer| - a buffer with 'modifiable' off = a readonly buffer + R a terminal buffer with a running job + F a terminal buffer with a finished job + ? a terminal buffer without a job: `:terminal NONE` + a modified buffer x a buffer with read errors @@ -1040,6 +1046,9 @@ list of buffers. |unlisted-buffer| x buffers with a read error % current buffer # alternate buffer + R terminal buffers with a running job + F terminal buffers with a finished job + ? terminal buffers without a job: `:terminal NONE` Combining flags means they are "and"ed together, e.g.: h+ hidden buffers which are modified a+ active buffers which are modified @@ -1074,10 +1083,8 @@ list of buffers. |unlisted-buffer| < :bdelete[!] {bufname} *E93* *E94* - Like ":bdelete[!] [N]", but buffer given by name. Note that a - buffer whose name is a number cannot be referenced by that - name; use the buffer number instead. Insert a backslash - before a space in a buffer name. + Like ":bdelete[!] [N]", but buffer given by name, see + |{bufname}|. :bdelete[!] N1 N2 ... Do ":bdelete[!]" for buffer N1, N2, etc. The arguments can be @@ -1114,10 +1121,8 @@ list of buffers. |unlisted-buffer| into a loaded buffer. :bunload[!] {bufname} - Like ":bunload[!] [N]", but buffer given by name. Note that a - buffer whose name is a number cannot be referenced by that - name; use the buffer number instead. Insert a backslash - before a space in a buffer name. + Like ":bunload[!] [N]", but buffer given by name. + Also see |{bufname}|. :N,Mbunload[!] Do ":bunload[!]" for all buffers in the range N to M |inclusive|. @@ -1135,10 +1140,16 @@ list of buffers. |unlisted-buffer| list, without setting the 'buflisted' flag. Also see |+cmd|. -:[N]b[uffer][!] [+cmd] {bufname} - Edit buffer for {bufname} from the buffer list. See - |:buffer-!| for [!]. This will also edit a buffer that is not - in the buffer list, without setting the 'buflisted' flag. +:[N]b[uffer][!] [+cmd] {bufname} *{bufname}* + Edit buffer for {bufname} from the buffer list. A partial + name also works, so long as it is unique in the list of + buffers. + Note that a buffer whose name is a number cannot be referenced + by that name; use the buffer number instead. + Insert a backslash before a space in a buffer name. + See |:buffer-!| for [!]. + This will also edit a buffer that is not in the buffer list, + without setting the 'buflisted' flag. Also see |+cmd|. :[N]sb[uffer] [+cmd] [N] *:sb* *:sbuffer* @@ -1150,7 +1161,7 @@ list of buffers. |unlisted-buffer| Also see |+cmd|. :[N]sb[uffer] [+cmd] {bufname} - Split window and edit buffer for {bufname} from the buffer + Split window and edit buffer for |{bufname}| from the buffer list. This will also edit a buffer that is not in the buffer list, without setting the 'buflisted' flag. Note: If what you want to do is split the buffer, make a copy @@ -1272,6 +1283,9 @@ help Contains a help file. Will only be created with the |:help| and can't be changed. The 'buflisted' option will be reset for a help buffer. +terminal A terminal window buffer, see |terminal|. The contents cannot + be read or changed until the job ends. + directory Displays directory contents. Can be used by a file explorer plugin. The buffer is created with these settings: > :setlocal buftype=nowrite