Merge pull request #322 from vim-jp/update_eval

Update terminal.{txt,jax}

Author: h-east

doc/terminal.jax

@@ -115,6 +115,9 @@ Esc を使うことができますが、他のキーが壊れないようにす
    tnoremap <Esc> <C-W>N
    set notimeout ttimeout timeoutlen=100
 
+端末モードマッピングと同様にメニューを作成することもできますが、|:tmenu| ではな
+く |:tlmenu| を使用する必要があります。
+
 <							*options-in-terminal*
 端末ウィンドウを開いて 'buftype' を "terminal" に設定すると、TerminalOpen 自動
 コマンドイベントが発生します。これにより、ウィンドウとバッファ専用のオプション
@@ -230,6 +233,10 @@ Normal ハイライトグループにより決定されます。
 
 			より詳細なオプションを使いたいならば |term_start()| 関
 			数を使ってください。
+			ウィンドウを縦分割するには、次のようにします: >
+				:vertical terminal
+<			または短縮形: >
+				:vert ter
 
 端末に関連付けられたバッファが強制的にアンロードもしくは削除された場合には、
 `job_stop(job, "kill")` を呼んだのと同じようにそのジョブが殺されます。
@@ -521,9 +528,9 @@ VimのほとんどのテストはVimのなかでスクリプトを実行して
 
 関数 ~
 
-term_sendkeys()		端末にキーストロークを送信する (tmap の影響を受けない)
-term_wait()		端末画面が更新されるのを待つ
-term_scrape()		端末画面の内容を検査する
+|term_sendkeys()|	端末にキーストロークを送信する (tmap の影響を受けない)
+|term_wait()|		端末画面が更新されるのを待つ
+|term_scrape()|		端末画面の内容を検査する
 
 
 ==============================================================================
@@ -548,7 +555,7 @@ Vimの画面ダンプテストを書く ~
 - 特定のサイズの端末でVimを実行します。デフォルトは75桁で20行です。これはダン
   プが常にこのサイズであることを確認します。RunVimInTerminal() 関数がこれを処
   理します。Vimコマンドの引数を渡します。
-- term_sendkeys() を使用して任意のコマンドをVimに送信します。例えば: >
+- |term_sendkeys()| を使用して任意のコマンドをVimに送信します。例えば: >
 	call term_sendkeys(buf, ":echo &lines &columns\<CR>")
 - VerifyScreenDump() を使用して、画面が期待どおりの状態になっていることを確認
   します。これは、参照する画面ダンプが src/testdir/dumps/ ディレクトリに存在す
@@ -575,23 +582,23 @@ Vimの画面ダンプテストを書く ~
 							*terminal-screendump*
 
 画面ダンプを作成するには、端末でVim (または他のプログラム)を実行し、目的の状態
-を表示させます。その後、term_dumpwrite() 関数を使用して画面ダンプファイルを作
-成します。例: >
+を表示させます。その後、|term_dumpwrite()| 関数を使用して画面ダンプファイルを
+作成します。例: >
 	:call term_dumpwrite(77, "mysyntax.dump")
 
 この "77" は端末のバッファ番号です。それを見るためには `:ls!` を使用してくださ
 い。
 
-term_dumpload() で画面ダンプを見ることができます: >
+|term_dumpload()| で画面ダンプを見ることができます: >
 	:call term_dumpload("mysyntax.dump")
 
 Vimがまったく同じ画面を表示していることを確認するには、まったく同じ方法でVimを
 再度実行し、目的の状態を表示します。次に、別のファイル名を使用して画面ダンプを
 再度作成します: >
 	:call term_dumpwrite(88, "test.dump")
 
-ファイルがまったく同じものであることを主張するには assert_equalfile() を使いま
-す: >
+ファイルがまったく同じものであることを主張するには |assert_equalfile()| を使い
+ます: >
 	call assert_equalfile("mysyntax.dump", "test.dump")
 
 違いがある場合、v:errors はエラーメッセージを含みます。
@@ -600,8 +607,8 @@ Vimがまったく同じ画面を表示していることを確認するには
 画面ダンプを比較する ~
 						*terminal-diffscreendump*
 
-assert_equalfile() は、何が違うのかを簡単に見分けることはできません。問題を見
-つけるには、term_dumpdiff() を使用します: >
+|assert_equalfile()| は、何が違うのかを簡単に見分けることはできません。問題を
+見つけるには、|term_dumpdiff()| を使用します: >
 	call term_dumpdiff("mysyntax.dump", "test.dump")
 
 これで3つの部分からなるウィンドウが開きます:
@@ -610,7 +617,17 @@ assert_equalfile() は、何が違うのかを簡単に見分けることはで
 3.  2番目のダンプの内容
 
 通常、2番目の部分で何が違うかを見ることができます。1番目または2番目ダンプの位
-置に関連付けるには 'ruler' を使用します。
+置に関連付けるには 'ruler' を使用します。文字は違いの種類を示します:
+	X	異なる文字
+	>	1番目にはカーソルがあるが、2番目にはカーソルがない
+	<	2番目にはカーソルがあるが、1番目にはカーソルがない
+	w	文字の幅が異なる (単一 対 2倍幅)
+	f	文字色が異なる
+	b	背景色が異なる
+	a	属性が異なる (ボールド, 下線, 反転, 等)
+	?	両方に文字がない
+	+	1番目に文字がない
+	-	2番目に文字がない
 
 あるいは、 "s" を押して、1番目と2番目のダンプを入れ替えます。これを何度か実行
 して、テキストの文脈における相違を見つけ出すことができます。
@@ -895,7 +912,7 @@ Vimのウィンドウ幅						*termdebug_wide*
 デバッグを開始した際に Vim のウィンドウ幅を変更し、垂直分割を利用するには次の
 ように設定します: >
   let g:termdebug_wide = 163
-これは :Termdebug を実行した際に &columns を 163 に設定します。元の値はデバッ
+これは `:Termdebug` を実行した際に &columns を 163 に設定します。元の値はデバッ
 ガが終了する際に復元されます。
 g:termdebug_wide が設定されていて、&columnsがすでに g:termdebug_wide より大き
 い場合、&columns を変更せずに垂直分割が使用されます。

en/terminal.txt

@@ -114,6 +114,9 @@ break: >
    tnoremap <Esc> <C-W>N
    set notimeout ttimeout timeoutlen=100
 
+You can also create menus similar to terminal mode mappings, but you have to
+use |:tlmenu| instead of |:tmenu|.
+
 <							*options-in-terminal*
 After opening the terminal window and setting 'buftype' to "terminal" the
 TerminalOpen autocommand event is triggered.  This makes it possible to set
@@ -228,6 +231,10 @@ Syntax ~
 
 			If you want to use more options use the |term_start()|
 			function.
+			If you want to split the window vertically, use: >
+				:vertical terminal
+<			Or short: >
+				:vert ter
 
 When the buffer associated with the terminal is forcibly unloaded or wiped out
 the job is killed, similar to calling `job_stop(job, "kill")` .
@@ -523,9 +530,9 @@ inspects the resulting screen state.
 
 Functions ~
 
-term_sendkeys()		send keystrokes to a terminal (not subject to tmap)
-term_wait()		wait for screen to be updated
-term_scrape()		inspect terminal screen
+|term_sendkeys()|	send keystrokes to a terminal (not subject to tmap)
+|term_wait()|		wait for screen to be updated
+|term_scrape()|		inspect terminal screen
 
 
 ==============================================================================
@@ -552,7 +559,7 @@ src/testdir/test_syntax.vim.  The main parts are:
   characters.  This makes sure the dump is always this size.  The function
   RunVimInTerminal() takes care of this.  Pass it the arguments for the Vim
   command.
-- Send any commands to Vim using term_sendkeys().  For example: >
+- Send any commands to Vim using |term_sendkeys()|.  For example: >
 	call term_sendkeys(buf, ":echo &lines &columns\<CR>")
 - Check that the screen is now in the expected state, using
   VerifyScreenDump().  This expects the reference screen dump to be in the
@@ -580,21 +587,21 @@ Creating a screen dump ~
 							*terminal-screendump*
 
 To create the screen dump, run Vim (or any other program) in a terminal and
-make it show the desired state.  Then use the term_dumpwrite() function to
+make it show the desired state.  Then use the |term_dumpwrite()| function to
 create a screen dump file.  For example: >
 	:call term_dumpwrite(77, "mysyntax.dump")
 
 Here "77" is the buffer number of the terminal.  Use `:ls!` to see it.
 
-You can view the screen dump with term_dumpload(): >
+You can view the screen dump with |term_dumpload()|: >
 	:call term_dumpload("mysyntax.dump")
 
 To verify that Vim still shows exactly the same screen, run Vim again with
 exactly the same way to show the desired state.  Then create a screen dump
 again, using a different file name: >
 	:call term_dumpwrite(88, "test.dump")
 
-To assert that the files are exactly the same use assert_equalfile(): >
+To assert that the files are exactly the same use |assert_equalfile()|: >
 	call assert_equalfile("mysyntax.dump", "test.dump")
 
 If there are differences then v:errors will contain the error message.
@@ -603,8 +610,8 @@ If there are differences then v:errors will contain the error message.
 Comparing screen dumps ~
 						*terminal-diffscreendump*
 
-assert_equalfile() does not make it easy to see what is different.
-To spot the problem use term_dumpdiff(): >
+|assert_equalfile()| does not make it easy to see what is different.
+To spot the problem use |term_dumpdiff()|: >
 	call term_dumpdiff("mysyntax.dump", "test.dump")
 
 This will open a window consisting of three parts:
@@ -613,7 +620,18 @@ This will open a window consisting of three parts:
 3.  The contents of the second dump
 
 You can usually see what differs in the second part.  Use the 'ruler' to
-relate it to the position in the first or second dump.
+relate it to the position in the first or second dump.  Letters indicate the
+kind of difference:
+	X	different character
+	>	cursor in first but not in second
+	<	cursor in second but not in first
+	w	character width differs (single vs double width)
+	f	foreground color differs
+	b	background color differs
+	a	attribute differs (bold, underline, reverse, etc.)
+	?	character missing in both
+	+	character missing in first
+	-	character missing in second
 
 Alternatively, press "s" to swap the first and second dump. Do this several
 times so that you can spot the difference in the context of the text.
@@ -635,7 +653,7 @@ Starting ~
 Load the plugin with this command: >
 	packadd termdebug
 <							*:Termdebug*
-To start debugging use `:Termdebug` or `:TermdebugCommand`` followed by the
+To start debugging use `:Termdebug` or `:TermdebugCommand` followed by the
 command name, for example: >
 	:Termdebug vim
 
@@ -900,7 +918,7 @@ Vim window width						*termdebug_wide*
 To change the width of the Vim window when debugging starts, and use a
 vertical split: >
   let g:termdebug_wide = 163
-This will set &columns to 163 when :Termdebug is used.  The value is restored
+This will set &columns to 163 when `:Termdebug` is used.  The value is restored
 when quitting the debugger.
 If g:termdebug_wide is set and &columns is already larger than
 g:termdebug_wide then a vertical split will be used without changing &columns.