Fix indications by koron

Author: rbtnn

doc/eval.jax

@@ -890,7 +890,7 @@ expr8がリストならば、インデックスexpr1aとexpr1bの間の要素か
 
 |Funcref|に対してexpr8[expr1]やexpr8[expr1a : expr1b]を使うとエラーになる。
 
-部分リストでスコープと変数でのコロンの扱いに注意してください: >
+部分リストでスコープと変数に続くコロンとの混乱に注意してください: >
 	mylist[n:]     " 変数nは使える
 	mylist[s:]     " スコープs:を使うとエラー！
 
@@ -1295,9 +1295,9 @@ v:cmdbang	v:cmdargと同じく読み書きコマンドを実行したとき設
 
 				*v:completed_item* *completed_item-variable*
 v:completed_item
-		最も最近補完された単語を含まれた|complete-items|の
-		|Dictionary|が|CompleteDone|イベント後に設定される。
-		補完に失敗した時、その|Dictionary|は空です。
+		最も最近補完された単語を含まれた|complete-items|の|Dictionary|
+		が|CompleteDone|イベント後に設定される。補完に失敗した時、その
+		|Dictionary|は空である。
 
 					*v:count* *count-variable*
 v:count		最後に実行されたノーマルモードコマンドに渡されたコマンドの実行
@@ -1343,13 +1343,14 @@ v:errmsg	最後に表示されたエラーメッセージ。この変数は代
 <		また "errmsg" は、以前の版のVimとの互換性の為に動作する。
 
 					*v:errors* *errors-variable*
-v:errors	テスト用関数によって見つかったエラー。例えば|assert_true()|。
-		これは文字列のリストです。
+v:errors	|assert_true()|のような、テスト用関数によって見つかったエラー。
+		これは文字列のリストである。
 		テスト用関数はテストに失敗した時にエラーを末尾に追加する。
-		古い結果を削除する方法はそれを空にする: >
+		古い結果を削除する方法はこの変数を空にする: >
 	:let v:errors = []
-<		もし|v:errors|にリストでないどんな値が入っていても、
-		テスト用関数が空のリストを設定する。
+<		たとえ|v:errors| にリスト以外のいかなる値をセットしたとしても、
+		(次に実行される時に)テスト用関数によって空のリストが設定(上書
+		き)される。
 
 					*v:exception* *exception-variable*
 v:exception	最も直近に捕捉され、まだ終了していない例外の値。
@@ -1509,8 +1510,7 @@ v:none		空の文字列。JSONでは空の要素として使われる。
 <			none ~
 
 					*v:null* *null-variable*
-v:null		空の文字列。JSONでは "null" して使われる。
-		|jsonencode()|を参照。
+v:null		空の文字列。JSONでは "null" して使われる。|jsonencode()|を参照。
 		数値として使われた時、これは 0 として評価される。
 		文字列として使われた時、これは "null" として評価される。 >
 			echo v:null
@@ -1837,7 +1837,7 @@ getbufvar( {expr}, {varname} [, {def}])
 				任意	バッファ{expr}の変数 {varname}
 getchar( [expr])		数値	ユーザーから1文字を取得する
 getcharmod( )			数値	修飾キーの状態を表す数値を取得
-getcharsearch()			辞書	last character search
+getcharsearch()			辞書	最後の文字検索を取得
 getcmdline()			文字列	現在のコマンドラインを取得
 getcmdpos()			数値	コマンドラインのカーソル位置を取得
 getcmdtype()			文字列	現在のコマンドラインの種類を取得
@@ -2001,7 +2001,7 @@ server2client( {clientid}, {string})
 serverlist()			文字列	利用可能なサーバーのリストを取得
 setbufvar( {expr}, {varname}, {val})	バッファ{expr}内の変数{varname}に{val}
 					をセット
-setcharsearch( {dict})		辞書	set character search from {dict}
+setcharsearch( {dict})		辞書	文字検索を{dict}に設定
 setcmdpos( {pos})		数値	コマンドライン内のカーソル位置を設定
 setline( {lnum}, {line})	数値	行{lnum}に{line}(文字列)をセット
 setloclist( {nr}, {list}[, {action}])
@@ -2096,7 +2096,7 @@ winrestcmd()			文字列	ウィンドウサイズを復元するコマンド
 winrestview( {dict})		なし	現在のウィンドウのビューを復元
 winsaveview()			辞書	現在のウィンドウのビューを保存
 winwidth( {nr})			数値	ウィンドウ{nr}の幅を取得
-wordcount()			辞書	バイト/文字/単語の情報を取得
+wordcount()			辞書	バイト/文字/単語の統計情報を取得
 writefile( {list}, {fname} [, {flags}])
 				数値	行のリストをファイル{fname}に書き込む
 xor( {expr}, {expr})		数値	ビット排他的論理和
@@ -2194,11 +2194,11 @@ argv([{nr}])	結果は引数リスト内の、{nr}番目のファイル。|argli
 assert_equal({expected}, {actual} [, {msg}])
 		{expected}と{actual}が等しくない時、|v:errors|にエラーメッセージ
 		を追加する。
-		暗黙的な変換はしない。文字列 "4" は数値 4 とは異なる。
-		そして、数値 4 は浮動小数点数 4.0 も同じく。
-		ここで'ignorecase'の値が使われないことは重要です。
-		もし{msg}が省略された場合、"Expected {expected} but got
-		 {actual}"という形式のメッセージが生成される。
+		暗黙的な変換はしない。文字列 "4" は数値 4 とは異なる。 そして、
+		数値 4 は浮動小数点数 4.0 も同じく。ここで'ignorecase'の値が使
+		われないことは重要である。
+		{msg}が省略された場合、"Expected {expected} but got {actual}"
+		という形式のメッセージが生成される。
 		例: >
 	assert_equal('foo', 'bar')
 <		以下の結果が|v:errors|に追加される:
@@ -2208,8 +2208,7 @@ assert_exception({error} [, {msg}])			*assert_exception()*
 		v:exception に{error}が含まれていない時、|v:errors|にエラーメッ
 		セージを追加する。
 		これは例外を投げるコマンドのテストを行う場合に使うことができる。
-		エラー番号を使うと、コロンより先の翻訳の問題を避けることができ
-		る: >
+		コロンが続くエラー番号を使えば、翻訳の問題を回避できる: >
 			try
 			  失敗するコマンド
 			  call assert_false(1, 'command should have failed')
@@ -2225,18 +2224,18 @@ assert_fails({cmd} [, {error}])					*assert_fails()*
 assert_false({actual} [, {msg}])				*assert_false()*
 		{actual}がfalseでない場合、|v:errors|にエラーメッセージを追加す
 		る。|assert_equal()|のような。
-		ゼロである時、その値はfalseとなります。{actual}が数値でない場
-		合、テストが失敗します。
-		もし{msg}が省略された場合、"Expected False but got {actual}"と
-		いう形式のメッセージが生成される。
+		ゼロである時、その値はfalseである。{actual}が数値でない場合、
+		テストが失敗する。
+		{msg}が省略された場合、"Expected False but got {actual}"という
+		形式のメッセージが生成される。
 
 assert_true({actual} [, {msg}])					*assert_true()*
 		{actual}がtrueでない場合、|v:errors|にエラーメッセージを追加する
 		。|assert_equal()|のような。
-		非ゼロである時、その値はtrueとなります。{actual}が数値でない場
-		合、テストが失敗します。
-		もし{msg}が省略された場合、"Expected True but got {actual}"と
-		いう形式のメッセージが生成される。
+		非ゼロである時、その値はtrueである。{actual}が数値でない場合、
+		テストが失敗する。
+		{msg}が省略された場合、"Expected True but got {actual}"という
+		形式のメッセージが生成される。
 
 asin({expr})						*asin()*
 		{expr} の逆正弦 (アークサイン) をラジアンで返す。
@@ -2612,14 +2611,14 @@ confirm({msg} [, {choices} [, {default} [, {type}]]])
 connect({address}, {mode} [, {callback}])		*connect()*
 		{address}へのチャンネルを開く。|channel|を参照。
 
-		{address}は"ホスト名:ポート"の形式です。
+		{address}は"ホスト名:ポート"の形式である。
 		例えば"localhost:8765"。
 
-		{mode}は"json"か"raw"のどちらかです。これらの意味については
+		{mode}は"json"か"raw"のどちらかである。これらの意味については
 		|channel-mode|を参照。
 
 		{callback}はチャンネルから受信されたメッセージをハンドルする関
-		数です。|channel-callback|を参照。
+		数である。|channel-callback|を参照。
 
 							*copy()*
 copy({expr})	{expr}のコピーを作る。数値と文字列の場合は、{expr}そのものとコ
@@ -2745,7 +2744,7 @@ deepcopy({expr}[, {noref}])				*deepcopy()* *E698*
 delete({fname} [, {flags}])					*delete()*
 		{flags}を指定しないもくは{flags}を空で指定する: ファイル
 		{fname}を削除する。
-		これはまた{fname}がシンボリックリンクの時でも動作する。
+		これは{fname}がシンボリックリンクの時でも動作する。
 
 		{flags}が"d"の場合: ディレクトリ{fname}を削除する。
 		これはディレクトリ{fname}が空でない場合は失敗する。
@@ -2755,7 +2754,7 @@ delete({fname} [, {flags}])					*delete()*
 		シンボリックリンク自身が削除され、それが示すものではない。
 
 		結果は数値であり、削除に成功すれば 0 、削除に失敗すれば -1 で
-		す。
+		ある。
 
 		バッファから行を削除するには|:delete|を使う。行番号が変数に入っ
 		ている場合は|:exe|を使う。
@@ -3074,9 +3073,9 @@ feedkeys({string} [, {mode}])				*feedkeys()*
 		'i'	追加する代わりに文字を挿入する。(上記参照)
 		'x'	先行入力が空になるまでコマンドを実行する。
 			これは":normal!"を使うのと似ている。
-			あなたは'x'なしで数回feedkeys()を呼ぶか、'x'ありで1回
-			({string}が空でも可能)feedkeys()を呼ぶことで先行入力を
-			すべて実行できる。
+			'x'なしで数回feedkeys()を呼ぶか、'x'ありで1回({string}
+			が空でも可能)feedkeys()を呼ぶことで先行入力をすべて実
+			行できる。
 		戻り値は常に0。
 
 							*filereadable()*
@@ -3427,14 +3426,15 @@ getcharsearch()						*getcharsearch()*
 		現在の文字検索の情報である{dict}を返し、この辞書は下記のエント
 		リを持つ:
 
-		    char	文字検索(|t|, |f|, |T|, or |F|)で以前に使われた文字。
+		    char	文字検索(|t|, |f|, |T|, or |F|)で以前に使われた文字
+				。
 				もし文字検索が実行されていないなら空文字列。
 		    forward	文字検索の方向。1は前方、0は後方。
 		    until	文字検索の種類。1は|t|もしくは|T|の文字検索、0は
 				|f|もしくは|F|の文字検索。
 
-		これは前回の文字検索を考慮せず常に|;|や|,|の前方/後方検索を使うこ
-		とができる: >
+		下記の設定は前回の文字検索の方向に関わらず、
+		|;| で前方検索、|,| で後方検索を常に行えるようになり便利である: >
 			:nnoremap <expr> ; getcharsearch().forward ? ';' : ','
 			:nnoremap <expr> , getcharsearch().forward ? ',' : ';'
 <		|setcharsearch()|も参照。
@@ -3485,8 +3485,8 @@ getcurpos()	カーソルの位置を返す。これは getpos('.') に似てい
 <
 							*getcwd()*
 getcwd([{winnr} [, {tabnr}]])
-		結果は現在の作業ディレクトリ名の文字列です。
-		引数が指定されない場合、現在のウィンドウです。
+		結果は現在の作業ディレクトリ名の文字列である。
+		引数が指定されない場合、現在のウィンドウである。
 
 		{winnr}が指定された場合、現在のタブページ内の{winnr}のウィンド
 		ウのローカルカレントディレクトリを返す。
@@ -3551,8 +3551,8 @@ getftype({fname})					*getftype()*
 			getftype("/home")
 <		Note "link" などの種別はそれをサポートしているシステムでのみ返
 		される。"dir" と "file" しか返らないシステムもある。
-		MS-Windowsでディレクトリのシンボリックリンクは"link"の代わりに
-		"dir"を返される。
+		MS-Windowsでは、ディレクトリへのシンボリックリンクは"link"の代
+		わりに"dir"を返す。
 
 							*getline()*
 getline({lnum} [, {end}])
@@ -3818,11 +3818,11 @@ haslocaldir([{winnr} [, {tabnr}]])			*haslocaldir()*
 		結果は数値でウィンドウが|:lcd|によってローカルなカレントディレ
 		クトリを持つようセットされているなら1、そうでないなら0となる。
 
-		引数が指定されない場合、現在のウィンドウです。
+		引数が指定されない場合、現在のウィンドウを対象とする。
 		{winnr}が指定された場合、現在のタブページ内の{winnr}のウィンド
-		ウです。
+		ウを対象とする。
 		{winnr}と{tabnr}が指定された場合、{tabnr}のタブページ内の
-		{winnr}のウィンドウです。
+		{winnr}のウィンドウを対象とする。
 		もし引数が不正の場合、空文字列を返す。
 
 hasmapto({what} [, {mode} [, {abbr}]])			*hasmapto()*
@@ -4143,21 +4143,22 @@ join({list} [, {sep}])					*join()*
 jsondecode({string})					*jsondecode()*
 		これはJSONフォーマットの文字列を解析し、それと同等のVimの値を
 		返す。JSONとVimの値の関係は|jsonencode()|を参照。
-		デコードは寛容です:
+		デコードは寛容である:
 		- 配列やオブジェクトの末尾カンマは無視される。
 		- 配列内の空要素、2つのカンマの間がホワイトスペースもしくは無
 		  い場合はv:noneとされる。
 		- オブジェクトのメンバ名が文字列でない場合、それは文字列に変換
 		  される。例えば数値123は文字列"123"として使われる。
-		- 多くの浮動小数点数を認識する。例えば"1.0"である"1."。
-		その結果は有効なVimの型にしなければならない:
-		- オブジェクトのメンバ名を空にすることは許されない。
-		- オブジェクトのメンバ名が重複することは許されない。
+		- 多くの浮動小数点数を認識する。例えば"1."は"1.0"として認識さ
+		  れる。
+		結果は必ずVimの型として有効になる:
+		- オブジェクトの空のメンバ名は許されない。
+		- オブジェクトのメンバ名の重複は許されない。
 
 jsonencode({expr})					*jsonencode()*
 		{expr}をJSONフォーマットの文字列にエンコードし、この文字列を返
 		す。
-		このエンコードはここに記載されている:
+		このエンコード方式の詳細はここに記載されている:
 		https://tools.ietf.org/html/rfc7159.html
 		Vimの値は以下の通りに変換される:
 		   数値			10進数
@@ -4173,11 +4174,11 @@ jsonencode({expr})					*jsonencode()*
 		   v:none		nothing
 		   v:null		"null"
 		Note JSON標準では空要素は許されないが、v:noneを使うことで許さ
-		れる。これは配列内で要素を省略する時に使えるでしょう:
+		れている。これは配列内で要素を省略する時に使えるでしょう:
 			[0,,,,,5] ~
 		これはずっと効率的であるが:
 			[0,null,null,null,null,5] ~
-		けど、厳格なJSONパーサでは許可しないだろう。
+		である。しかし、厳格なJSONパーサでは許可しないだろう。
 
 keys({dict})						*keys()*
 		{dict}の全キーからなるリストを返す。リストの順序は不定である。
@@ -4749,9 +4750,9 @@ perleval({expr})					*perleval()*
 		リストは Vim の |List| 型に変換される。
 		辞書は Vim の |Dictionary| 型に変換される。文字列ではない辞書
 		のキーはエラーになる。
-		もし値が変換できない場合、Perlに於ける文字列して返される。
-		Note: もしあなたがアレイかハッシュを望むなら、{expr}はその参照
-		にしなければならない。
+		もし値が変換できない場合、Perlに於ける文字列として返される。
+		Note: もし配列かハッシュが必要ならば、{expr}ではそれらへの参照
+		を返す必要がある。
 		例: >
 			:echo perleval('[1 .. 4]')
 <			[1, 2, 3, 4]
@@ -5458,11 +5459,13 @@ setbufvar({expr}, {varname}, {val})			*setbufvar()*
 setcharsearch({dict})					*setcharsearch()*
 		現在の文字検索の情報を{dict}に設定する。
 		この辞書は下記のエントリを1以上持つ:
+
 		    char	続いて起こる|,|や|;|コマンドで使われる文字。
 				空文字列の場合、文字検索を解除する。
 		    forward	文字検索の方向。1は前方、0は後方。
 		    until	文字検索の種類。1は|t|もしくは|T|の文字検索、0は
 				|f|もしくは|F|の文字検索。
+
 		これはユーザーの文字検索のセーブ/リストアを使うことができる: >
 			:let prevsearch = getcharsearch()
 			:" Perform a command which clobbers user's search
@@ -5767,7 +5770,7 @@ sort({list} [, {func} [, {dict}]])			*sort()* *E702*
 
 		{func} が 'N' ならすべての要素は数値順にソートされる。これは
 		'n'に似ているが、数値を含む文字列はその文字列が表す数値として
-		扱われる。　				
+		扱われる。
 
 		{func} が 'f' ならすべての要素は数値順にソートされる。すべての
 		値は数値か浮動小数点数でなければならない。
@@ -6429,8 +6432,8 @@ type({expr})	{expr}の型を示す数値を返す:
 			リスト:	      3
 			辞書:	      4
 			浮動小数点数: 5
-			真偽値:	      6 (v:false や v:true)
-			特殊値:	      7 (v:null や v:none)
+			真偽値:	      6 (v:false と v:true)
+			特殊値:	      7 (v:null と v:none)
 		マジックナンバーを使わずに、次のような使い方をすべきである: >
 			:if type(myvar) == type(0)
 			:if type(myvar) == type("")
@@ -6678,8 +6681,8 @@ winwidth({nr})						*winwidth()*
   :endif
 <
 wordcount()						*wordcount()*
-		この結果は現在のバッファのバイト/文字/単語統計情報の辞書です。
-		これは|g_CTRL-G|が提供する情報と同じです。
+		この結果は現在のバッファのバイト/文字/単語統計情報の辞書である。
+		これは|g_CTRL-G|が提供する情報と同じである。
 		この値には下記が含まれる:
 			bytes		バッファ内のバイト数
 			chars		バッファ内の文字数