{map,mlang,options,syntax,testing}.jax: Update Vim 8.2.1678 translate

Author: tsuyoshicho

doc/map.jax

@@ -1,4 +1,4 @@
-*map.txt*       For Vim バージョン 8.2.  Last change: 2020 Aug 01
+*map.txt*       For Vim バージョン 8.2.  Last change: 2020 Sep 06
 
 
 		  VIMリファレンスマニュアル	  by Bram Moolenaar
@@ -188,6 +188,12 @@
 引数に <nowait> を追加します。そしてそのマップは一致する場合に使用され、Vimは
 それ以上入力される文字を待ちません。しかし、既に文字が入力されていた場合はそれ
 が使われます。
+Note: これが動作するのは <nowait> なマッピングが完全にマッチし、なんからかの部
+分マッチを見付ける前です。これが動作するのは:
+- これがバッファローカルなマッピングで唯一マッチし、グローバルなマッピングが見
+  付からない間。
+- これとは別のバッファローカルなマッピングが部分マッチするが、より早く定義され
+  ている (最後の定義したマッピングが最初に見付かる)。
 
 						*:map-<silent>* *:map-silent*
 実行するコマンドがコマンドラインに表示されないようにするには、マップコマンドの
@@ -275,16 +281,8 @@ getchar() によって取得され、返されます。
 CTRL-L で次の番号を挿入し、CTRL-R で番号をリセットします。CTRL-R は空文字列を
 返すので、何も挿入されません。
 
-Note: 特殊キーが機能するようにしたり、テキスト中の CSI バイトをエスケープした
-りするために、特別な処理が行われています。|:map| コマンドも同様の処理を行うの
-で、それが二重に実行されるのを防ぐ必要があります。次のものは機能しません: >
-	:imap <expr> <F3> "<Char-0x611B>"
-なぜなら、<Char- で表記した文字 (あるいは本物の文字) のバイト列は |:imap| コマ
-ンドが解釈されるときにエスケープされ、<expr> で使われるときにもう一度エスケー
-プされるからです。次のものは機能します: >
-	:imap <expr> <F3> "\u611B"
-テキストの末尾以外で 0x80 をシングルバイトとして使った場合、それは機能しませ
-ん。特殊キーとして認識されます。
+Note: テキストの末尾以外で 0x80 をシングルバイトとして使った場合、それは機能し
+ません。特殊キーとして認識されます。
 
 
 1.3 マップとモード					*:map-modes*
@@ -864,34 +862,46 @@ g@{motion}		'operatorfunc' に設定された関数を実行します。
 
 例を示します。これは <F4> を使ってスペースの数を数えます: >
 
-	nmap <silent> <F4> :set opfunc=CountSpaces<CR>g@
-	vmap <silent> <F4> :<C-U>call CountSpaces(visualmode(), 1)<CR>
+	nnoremap <expr> <F4> CountSpaces()
+	xnoremap <expr> <F4> CountSpaces()
+	" <F4> 2回で行に作用
+	nnoremap <expr> <F4><F4> CountSpaces() .. '_'
 
-	function! CountSpaces(type, ...)
-	  let sel_save = &selection
-	  let &selection = "inclusive"
-	  let reg_save = @@
-
-	  if a:0  " ビジュアルモードから呼び出すのに、gv コマンドを使用します。
-	    silent exe "normal! gvy"
-	  elseif a:type == 'line'
-	    silent exe "normal! '[V']y"
-	  else
-	    silent exe "normal! `[v`]y"
+	function CountSpaces(type = '') abort
+	  if a:type == ''
+	    set opfunc=CountSpaces
+	    return 'g@'
 	  endif
 
-	  echomsg strlen(substitute(@@, '[^ ]', '', 'g'))
-
-	  let &selection = sel_save
-	  let @@ = reg_save
+	  let sel_save = &selection
+	  let reg_save = getreginfo('"')
+	  let cb_save = &clipboard
+	  let visual_marks_save = [getpos("'<"), getpos("'>")]
+
+	  try
+	    set clipboard= selection=inclusive
+	    let commands = #{line: "'[V']y", char: "`[v`]y", block: "`[\<c-v>`]y"}
+	    silent exe 'noautocmd keepjumps normal! ' .. get(commands, a:type, '')
+	    echom getreg('"')->count(' ')
+	  finally
+	    call setreg('"', reg_save)
+	    call setpos("'<", visual_marks_save[0])
+	    call setpos("'>", visual_marks_save[1])
+	    let &clipboard = cb_save
+	    let &selection = sel_save
+	  endtry
 	endfunction
 
+<expr> のマッピングを使うことではなんらかのカウントかレジスタの接頭詞を取るこ
+とが可能になります。それにより、CmdlineEnter と CmdlineLeave の自動コマンドを
+トリガーするコマンドラインの使用も回避します。
+
 Note: 一時的に 'selection' を "inclusive" に設定し、'[ から '] まで選択した範
 囲を正しくヤンクできるようにしています。
 
-Note: ビジュアルモードのために別のマップを定義しています。ビジュアルモードで
-":" を押した場合に挿入される "'<,'>" を削除し、関数に visualmode() の値と追加
-の引数を渡しています。
+Note: 'clipboard' オプションの値に `unnamed` か `unnamedplus` が含まれている場
+合、レジスタの `"*` や `"+` が上書きされることを防ぐため、一時的に空に設定され
+ます。
 
 ==============================================================================
 2. 短縮入力 (Abbreviations)		*abbreviations* *Abbreviations*

doc/mlang.jax

@@ -1,4 +1,4 @@
-*mlang.txt*     For Vim バージョン 8.2.  Last change: 2020 Jun 16
+*mlang.txt*     For Vim バージョン 8.2.  Last change: 2020 Aug 15
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 8.2.  Last change: 2020 Aug 13
+*options.txt*	For Vim バージョン 8.2.  Last change: 2020 Sep 06
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -737,6 +737,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	"double" は 'listchars' や 'fillchars' に指定された文字が全角幅になっ
 	てしまう場合は使えない。
 
+	この値は |setcellwidths()| による文字固有の幅を棄却する。
+
 	これらの文字のグリフの幅を、旧い／伝統的なCJKエンコーディングで何オク
 	テットを占めるかだけによって決めているCJKフォントがたくさんある。その
 	エンコーディングではユーロ、登録商標記号、ギリシャ文字、キリル文字は2
@@ -2752,9 +2754,9 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	- UnixとWin32では、指定されたディレクトリ名の末尾がディレクトリの区切
 	  り記号2個("//")で終わっていたら、スワップファイルの名前はフルパスに
 	  従って付けられる。スワップファイルのファイル名をフルパス形式で表し、
-	  ディレクトリの区切り文字をパーセント記号 '%' で置き換えたものが使わ
-	  れる。こうするとスワップファイル格納用ディレクトリの中でもファイル名
-	  の一意性が保証される。
+	  ディレクトリの区切り文字 (Win32のドライブレターのコロンを含む)をパー
+	  セント記号 '%' で置き換えたものが使われる。こうするとスワップファイ
+	  ル格納用ディレクトリの中でもファイル名の一意性が保証される。
 	  Win32では、"\\" で終わることも可能である。ただし、区切り文字のコンマ
 	  の前では "\\" でなく "//" と書かなければならない。"\\" と書くと、コ
 	  ンマがファイル名の一部と解釈されてしまうためである。したがって、'\\'
@@ -4877,7 +4879,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	マルモードでカーソルをタブの上に移動させると、タブが占める桁の最後の位
 	置にカーソルが表示されるが、それと異なる。タブをスペースで表示しつつ、
 	カーソル位置をそのように変えたいなら、次のようにする: >
-		:set list lcs=tab:\ \ 
+		:set list lcs=tab:\ \
 <		{訳注: 最後、バックスラッシュの後にスペースがあることに注意}
 
 	Note オプション 'cpoptions' がフラグ 'L' を含むならば、このオプション
@@ -6820,7 +6822,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 			{|+linebreak| 機能付きでコンパイルされたときのみ有効}
 	折り返された行の先頭に表示する文字列。"> " や "+++ " に設定すると便利
 	である: >
-		:set showbreak=>\ 
+		:set showbreak=>\
 <	スペースの前にバックスラッシュをつけてエスケープしていることに注
 	意。次のようにするともっと簡単である: >
 		:let &showbreak = '+++ '
@@ -7826,8 +7828,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 						*'termwinsize'* *'tws'*
 'termwinsize' 'tws'	文字列	(既定では "")
 			ウィンドウについてローカル
-	|terminal| ウィンドウのサイズ。書式: {rows}x{columns} もしくは
-	{rows}*{columns}
+	|terminal| ウィンドウが開かれるときに利用するサイズ。書式:
+	{rows}x{columns} もしくは {rows}*{columns}
 	- 空の場合、ターミナルはウィンドウからサイズを取得する。
 	- "x" で設定されている場合 (例えば "24x80")、ターミナルのサイズはウィ
 	  ンドウサイズに調節されない。ウィンドウがそれより小さい場合、左上の部
@@ -7838,6 +7840,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	- 行がゼロなら、ウィンドウの高さを使う。
 	- 列がゼロなら、ウィンドウの幅を使う。
 	- "0x0" もしくは "0*0" の場合、空の場合と同じになる。
+	- |term_start()| 内のオプション "term_rows" と "term_cols" によって棄
+	  却されうる。
 
 	例:
 	  "30x0" は 30 行と、現在のウィンドウの幅を使用する。

doc/syntax.jax

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim バージョン 8.2.  Last change: 2020 Jul 28
+*syntax.txt*	For Vim バージョン 8.2.  Last change: 2020 Aug 15
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -1282,7 +1282,7 @@ g:doxygen_enhanced_color
 g:doxygen_enhanced_colour	0	Doxygen コメントに対して標準でないハイ
 					ライトを行う。
 
-doxygen_my_rendering		0	HTML の太字、斜体、html_my_rendering 
+doxygen_my_rendering		0	HTML の太字、斜体、html_my_rendering
 					に対する下線の描画を無効にする。
 
 doxygen_javadoc_autobrief	1	0にすると JavaDoc の autobrief に対す
@@ -1378,7 +1378,7 @@ Euphoria バージョン 3.1.1 (http://www.rapideuphoria.com/) は DOS プラッ
 (http://www.openeuphoria.org/) はそれをサポートしていない。
 
 以下の拡張子のファイルは自動的に Euphoria ファイルタイプとして認識される:
-    
+
 	*.e, *.eu, *.ew, *.ex, *.exu, *.exw
 	*.E, *.EU, *.EW, *.EX, *.EXU, *.EXW
 
@@ -1739,7 +1739,7 @@ Basicだけであり、他のスクリプト言語はまだ加えられていな
 
 htmlプロセッサー言語は複数ある。html.vimはインクルードしやすいように簡素に書か
 れている。html.vimをインクルードするには以下の2行をその言語用の構文ファイルに
-書き足すこと(この例はasp.vimからとった): 
+書き足すこと(この例はasp.vimからとった):
 >
     runtime! syntax/html.vim
     syn cluster htmlPreproc add=asp
@@ -4018,7 +4018,7 @@ contains=CONTAINED
 contains=CONTAINED,{group-name},..
 		"CONTAINED" と同様だが、{group-name}に列挙したグループは除かれ
 		る。
-		
+
 
 "contains" リスト内の{group-name}はパターンであってもよい。そのパターンにマッ
 チするグループ名全てが含まれる("ALLBUT" が使われたときはそれが除かれる)。パター
@@ -4189,7 +4189,7 @@ region item end     -	 yes  -    yes	-    yes  yes
 
 複数のオフセットの間に ',' を入れて連結することができる。例: >
   :syn match String  /"[^"]*"/hs=s+1,he=e-1
-< 
+<
     some "string" text
 	  ^^^^^^		ここがハイライトされる
 
@@ -4411,7 +4411,7 @@ skipパターンも "\n" を含んでよい。ただし次の行の最初の文
 る行数が最大N行になる。これは遅いマシンを使っていて、シンクロナイズする行数が
 少ないとわかっているときに便利である。例: >
    :syntax sync maxlines=500 ccomment
-< 
+<
 						*:syn-sync-linebreaks*
 複数行にマッチする正規表現を使っているとき、ある行に変更を施すと、前の行でマッ
 チしていた正規表現がマッチしなくなってしまうことがある。この場合、変更を施した
@@ -4515,7 +4515,7 @@ Note: "*/" を含む文字列で行をまたぐものがあると、Cコメン
 
 					    *syn-sync-grouphere* *E393* *E394*
     :syntax sync match {sync-group-name} grouphere {group-name} "pattern" ..
-    
+
 	シンクロナイズ用に使うマッチを定義する。{group-name}はマッチのすぐ後に
 	続く構文グループの名前である。ハイライトのためのテキストのパースはマッ
 	チの直後から始まる。この{group-name}がついたリージョンが存在しなければ
@@ -4556,7 +4556,7 @@ Note: "*/" を含む文字列で行をまたぐものがあると、Cコメン
    :syntax sync clear
 
 あるシンクロナイズパターンをクリアするには: >
-   :syntax sync clear {sync-group-name} ..  
+   :syntax sync clear {sync-group-name} ..
 
 ==============================================================================
 12. 構文アイテムのリストを表示する	*:syntax* *:sy* *:syn* *:syn-list*
@@ -4771,7 +4771,7 @@ ctermul={color-nr}				*highlight-ctermul*
 	こでハイライトの設定に可搬性を持たせるため、X11の色設定が使われている
 	(複雑であるが)。以下の色名を、色番号の代わりに使うことができる:
 
-							*cterm-colors* 
+							*cterm-colors*
 	    NR-16   NR-8    COLOR NAME ~
 	    0	    0	    Black
 	    1	    4	    DarkBlue
@@ -4880,7 +4880,7 @@ guisp={color-name}					*highlight-guisp*
 	くる。このためシングルクォートを名前に含めることはできない。
 	例: >
 	    :hi comment guifg='salmon pink'
-< 
+<
 							*gui-colors*
 	推奨されている色名 (これらはほとんどのシステムで利用可能である)
 	    Red		LightRed	DarkRed
@@ -5062,7 +5062,7 @@ Scrollbar	メインウィンドウのスクロールバーの文字と背景。
 							*hl-Tooltip*
 Tooltip		ツールチップのフォント、文字、背景。
 		使用可能なhighlightの引数: font, guibg, guifg.
-    
+
 		NOTE: MotifとAthenaでは 'guifontset' が空かどうかにかかわらず、
 		常に引数fontで実際のフォントセットを指定する。そしてそれが現在
 		の|:language|に結び付けられる。

doc/testing.jax

@@ -1,4 +1,4 @@
-*testing.txt*	For Vim バージョン 8.2.  Last change: 2020 Jul 10
+*testing.txt*	For Vim バージョン 8.2.  Last change: 2020 Sep 06
 
 
 		  VIMリファレンスマニュアル	  by Bram Moolenaar
@@ -290,7 +290,7 @@ assert_exception({error} [, {msg}])			*assert_exception()*
 			endtry
 <
 							*assert_fails()*
-assert_fails({cmd} [, {error} [, {msg} [, {lnum}]]])
+assert_fails({cmd} [, {error} [, {msg} [, {lnum} [, {context}]]]])
 		{cmd}を実行しエラーを生成しなかった場合か、エラーメッセージの
 		中に{error}が見つからない場合、|v:errors| にエラーメッセージを
 		追加する。|assert-return| も参照。
@@ -317,6 +317,9 @@ assert_fails({cmd} [, {error} [, {msg} [, {lnum}]]])
 		時、エラーが報告されるときに行番号と比較される。
 		行番号は関数かスクリプトの行番号になる。
 
+		{context} が存在すると、 パターンとして使われ {lnum} が位置する
+		コンテキスト (スクリプト名か関数名) に対してマッチする。
+
 		Note: ビープ音の発生はエラーとは見なされず、いくつかのコマンド
 		は失敗時にビープ音を鳴らすだけである。これらについては
 		|assert_beeps()| を使用すること。