Merge pull request #888 from tsuyoshicho/update/cmd-opt-20210223

Update {cmdline,options}.{txt,jax}

Author: k-takata

doc/cmdline.jax

@@ -1,4 +1,4 @@
-*cmdline.txt*   For Vim バージョン 8.2.  Last change: 2020 Sep 14
+*cmdline.txt*   For Vim バージョン 8.2.  Last change: 2021 Jan 26
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -800,7 +800,7 @@ Exコマンドの、ファイル名が使えるところでは、以下の文字
 	#	代替ファイル名に置き換えられる。		  *:_#* *c_#*
 		これはウィンドウごとに記憶される。
 	#n	(ここで n は数) バッファ n のファイル名に置き	  *:_#0* *:_#n*
-	        換えられる。"#0" は "#" と同じ。		  *c_#n*
+		換えられる。"#0" は "#" と同じ。		  *c_#n*
 	##	引数リスト内の全てのファイル名を、空白で区切って  *:_##* *c_##*
 		列挙したものに置き換えられる。ファイル名の中の空白には、
 		全て前に '\' が付けられる。
@@ -809,6 +809,16 @@ Exコマンドの、ファイル名が使えるところでは、以下の文字
 		この番号については |:oldfiles| や |v:oldfiles| を参照。
 		*E809*
 		{|+eval| と |+viminfo| 機能つきでコンパイルされたときのみ有効}
+|Vim9-script| では # がコメントの開始に使われるため、%% を代替ファイル名として
+使う:
+	%	カレントファイル名に置き換えられる。
+	%%	代替ファイル名に置き換えられる。		*:_%%* *c_%%*
+	%%n	(ここで n は数) バッファ n のファイル名に置き	*:_%%0* *:_%%n*
+		換えられる。"%%0" は "%%" と同じ。		*c_%%n*
+	%%%	引数リスト内の全てのファイル名を、空白で区切っ	*:_%%%* *c_%%%#*
+		て列挙したものに置き換えられる。
+	%%<n	(n は > 0 の数値)。				*:_%%<* *c_%%<*
+		n 番目の old file 名に置き換えられる。
 
 Note: "#<n" 以外は、ユーザーに打ち込まれた通りのファイル名を与えることに注意
 {訳注: 普通、カレントディレクトリのファイルは、パスを付けずにファイル名のみを
@@ -1039,7 +1049,7 @@ Note: ファイル名が来る筈の所では、ワイルドカードの展開
 コマンドラインウィンドウでは、普通のウィンドウでテキストを編集するのと同じよう
 にコマンドラインを編集できる。コマンドラインウィンドウは特殊なウィンドウで、普
 通の方法でそこから出ることはできない。
-{Vimが |+cmdline_hist| 機能付きでコンパイルされたときのみ有効である。}
+{Vimが |+cmdwin| 機能付きでコンパイルされたときのみ有効である。}
 
 
 開 始						*c_CTRL-F* *q:* *q/* *q?*

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 8.2.  Last change: 2020 Dec 21
+*options.txt*	For Vim バージョン 8.2.  Last change: 2021 Feb 13
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -474,7 +474,7 @@ Note 展開されるオプションの値の長さ制限に注意。システム
 			    CTRL-?		  CTRL-H
 			    CTRL-?以外		  CTRL-?
 
-			(CTRL-? は8進数で 0177、16進数で 0x7f)
+			(CTRL-? は8進数で 0o177、16進数で 0x7f)
 
 			ターミナルのデリートキーのキーコードが違っているが、バッ
 			クスペースのキーコードは正しいときは、次のコマンドをファ
@@ -1615,7 +1615,11 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 			{VimのGUIバージョンか |+xterm_clipboard| 機能付きでコ
 			ンパイルされたもののみ有効}
 	コンマ区切りのキーワードのリストを指定する。
-	認識されるのは、以下のキーワードである。
+	Note: 要素の1つとして "exclude:" がある場合、要素を後ろに追加すること
+	はできない。従って += で後方への要素の追加ではなく ^= を使って前方への
+	追加をする。例: >
+		set clipboard^=unnamed
+<	認識されるのは、以下のキーワードである。
 
 						*clipboard-unnamed*
 	unnamed		これが含まれると、コピー、削除、変更、ペーストなどの操
@@ -2694,6 +2698,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 		foldcolumn:{n}	差分モードの開始時にオプション 'foldcolumn' を
 				{n}に設定する。
 
+		followwrap	'wrap' オプションにそのまま従う。
+
 		internal	内部diffライブラリを使用する。'diffexpr' が設
 				定されている場合は無視される。 *E960*
 				バッファを書き込むときにメモリが不足すると、こ
@@ -3252,7 +3258,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	通常のファイル名文字だけが使える。"/\*?[|<>" は不正である。
 
 						*'fillchars'* *'fcs'*
-'fillchars' 'fcs'	文字列	(既定では "vert:|,fold:-")
+'fillchars' 'fcs'	文字列	(既定では "vert:|,fold:-,eob:~")
 			グローバル
 			{|+folding| 機能付きでコンパイルされたときのみ有効}
 	ステータス行と垂直分割の区切りを埋める文字を設定する。値にはキーワード
@@ -3263,7 +3269,11 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	  stlnc:文字	' ' か '='	非カレントウィンドウのステータス行
 	  vert:文字	'|'		垂直分割の区切り |:vsplit|
 	  fold:文字	'-'		'foldtext' での空白部分
+	  foldopen:文字	'-'		折り畳みの先頭のマーク
+	  foldclose:文字'+'		閉じられた折り畳みのマーク
+	  foldsep:文字	'|'		開いた折り畳みの中間文字
 	  diff:文字	'-'		'diff' での削除された行
+	  eob:文字	'~'		バッファ終端以降の空行
 
 	指定されなかったキーワードについては、既定値が使われる。"stl" と
 	"stlnc" には、強調表示が行われているときは空白が、行われていないときは
@@ -3283,6 +3293,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	  vert:文字	VertSplit		|hl-VertSplit|
 	  fold:文字	Folded			|hl-Folded|
 	  diff:文字	DiffDelete		|hl-DiffDelete|
+	  eob:文字	EndOfBuffer		|hl-EndOfBuffer|
 
 		*'fixendofline'* *'fixeol'* *'nofixendofline'* *'nofixeol'*
 'fixendofline' 'fixeol'	切替	(既定ではオン)
@@ -3295,7 +3306,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	オプション 'endofline' を参照。
 
 					*'fkmap'* *'fk'* *'nofkmap'* *'nofk'*
-'fkmap' 'fk'		切替	(既定ではオフ)			*E198*
+'fkmap' 'fk'		切替	(既定ではオフ)
 			グローバル
 			{|+rightleft| 機能付きでコンパイルされたときのみ有効}
 	このオプションはペルシア語を使うためのもので、削除された。|farsi.txt|
@@ -4892,7 +4903,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 
 						*'listchars'* *'lcs'*
 'listchars' 'lcs'	文字列	(既定では "eol:$")
-			グローバル
+			グローバル／ウィンドウについてローカル |global-local|
 	'list' モードと |:list| コマンドでの表示に使われる文字を設定する。値は
 	指定文字列のコンマ区切りのリストである。
 							*lcs-eol*
@@ -4923,7 +4934,12 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 							*lcs-space*
 	  space:文字	スペースの表示に使われる文字。指定されないと、スペース
 			は空白のまま。
-							*lcs-trail*
+							*lcs-lead*
+	  lead:文字	先頭のスペースの表示に使われる文字。指定されないと、先
+			頭のスペースは空白のまま。行頭のスペースでは "space"
+			の設定を上書きする。"tab:" と組み合せられる、例えば: >
+				:set listchars+=tab:>-,lead:.
+<							*lcs-trail*
 	  trail:文字	行末のスペースの表示に使われる文字。指定されないと、行
 			末のスペースは空白のまま。行末のスペースでは "space"
 			の設定を上書きする。
@@ -5255,7 +5271,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	NOTE: このオプションは 'compatible' がオンになるとViの既定値に設定され、
 	'compatible' がオフになるとVimの既定値に設定されるので注意。
 
-						*'mouse'* *E538*
+						*'mouse'*
 'mouse'			文字列	(既定では "", GUI版とWin32では "a",
 				|defaults.vim| 内で "a" か "nvi" に設定される)
 			グローバル
@@ -6235,7 +6251,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 <
 				*'runtimepath'* *'rtp'* *vimfiles*
 'runtimepath' 'rtp'	文字列	(既定値:
-					Unix: "$HOME/.vim,
+					Unix:  "$HOME/.vim,
 						$VIM/vimfiles,
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
@@ -6245,7 +6261,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
 						home:vimfiles/after"
-					PC:    "$HOME/vimfiles,
+					MS-Windows: "$HOME/vimfiles,
 						$VIM/vimfiles,
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
@@ -6257,8 +6273,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 						$VIM/vimfiles,
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
-						$BE_USER_SETTINGS/vim/after")
-					VMS: "sys$login:vimfiles,
+						$BE_USER_SETTINGS/vim/after"
+					VMS:   "sys$login:vimfiles,
 						$VIM/vimfiles,
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
@@ -6330,9 +6346,12 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 'scroll' 'scr'		数値	(既定では、ウィンドウ高の半分)
 			ウィンドウについてローカル
 	コマンド CTRL-U や CTRL-D でスクロールする行数。ウィンドウのサイズが変
-	わると、ウィンドウの行数の半分に設定される。CTRL-U や CTRL-D を、カウ
-	ントを指定して使うと、カウントはオプション 'scroll' の値として使われる。
-	":set scroll=0" とすると、値はウィンドウ高の半分に戻る。
+	わると、ウィンドウの行数の半分に設定される。'scroll' オプションを設定
+	した後で、|status-line| か 'tabline' オプションを有効にした場合におき
+	る。
+	CTRL-U や CTRL-D を、カウントを指定して使うと、カウントはオプション
+	'scroll' の値として使われる。":set scroll=0" とすると、値はウィンドウ
+	高の半分に戻る。
 
 			*'scrollbind'* *'scb'* *'noscrollbind'* *'noscb'*
 'scrollbind' 'scb'	切替	(既定ではオフ)

en/cmdline.txt

@@ -1,4 +1,4 @@
-*cmdline.txt*   For Vim version 8.2.  Last change: 2020 Sep 14
+*cmdline.txt*   For Vim version 8.2.  Last change: 2021 Jan 26
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -849,6 +849,16 @@ function |expand()|.
 		file name n.  See |:oldfiles| or |v:oldfiles| to get the
 		number.							*E809*
 		{only when compiled with the |+eval| and |+viminfo| features}
+In |Vim9-script| # is used to start a comment, use %% for the alternate file
+name:
+	%	Is replaced with the current file name.
+	%%	Is replaced with the alternate file name.	*:_%%* *c_%%*
+	%%n	(where n is a number) is replaced with		*:_%%0* *:_%%n*
+		the file name of buffer n.  "%%0" is the same as "%%".   *c_%%n*
+	%%%	Is replaced with all names in the argument	*:_%%%* *c_%%%#*
+		list concatenated, separated by spaces.
+	%%<n	(where n is a number > 0) is replaced with old  *:_%%<* *c_%%<*
+		file name n.
 
 Note that these, except "#<n", give the file name as it was typed.  If an
 absolute path is needed (when using the file name from a different directory),
@@ -1086,7 +1096,7 @@ Also see |`=|.
 In the command-line window the command line can be edited just like editing
 text in any window.  It is a special kind of window, because you cannot leave
 it in a normal way.
-{not available when compiled without the |+cmdline_hist| feature}
+{not available when compiled without the |+cmdwin| feature}
 
 
 OPEN						*c_CTRL-F* *q:* *q/* *q?*

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 8.2.  Last change: 2020 Dec 21
+*options.txt*	For Vim version 8.2.  Last change: 2021 Feb 13
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -438,7 +438,7 @@ the system, mostly it is something like 256 or 1024 characters.
 				  CTRL-?	CTRL-H
 				not CTRL-?	CTRL-?
 
-			(CTRL-? is 0177 octal, 0x7f hex)
+			(CTRL-? is 0o177 octal, 0x7f hex)
 
 			If your delete key terminal code is wrong, but the
 			code for backspace is alright, you can put this in
@@ -1568,7 +1568,11 @@ A jump table for the options with a short description can be found at |Q_op|.
 			{only in GUI versions or when the |+xterm_clipboard|
 			feature is included}
 	This option is a list of comma separated names.
-	These names are recognized:
+	Note: if one of the items is "exclude:", then you can't add an item
+	after that.  Therefore do append an item with += but use ^= to
+	prepend, e.g.: >
+		set clipboard^=unnamed
+<	These names are recognized:
 
 						*clipboard-unnamed*
 	unnamed		When included, Vim will use the clipboard register '*'
@@ -2677,6 +2681,8 @@ A jump table for the options with a short description can be found at |Q_op|.
 		foldcolumn:{n}	Set the 'foldcolumn' option to {n} when
 				starting diff mode.  Without this 2 is used.
 
+		followwrap	Follow the 'wrap' option and leave as it is.
+
 		internal	Use the internal diff library.  This is
 				ignored when 'diffexpr' is set.  *E960*
 				When running out of memory when writing a
@@ -3229,7 +3235,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Only normal file name characters can be used, "/\*?[|<>" are illegal.
 
 						*'fillchars'* *'fcs'*
-'fillchars' 'fcs'	string	(default "vert:|,fold:-")
+'fillchars' 'fcs'	string	(default "vert:|,fold:-,eob:~")
 			global
 			{not available when compiled without the |+folding|
 			feature}
@@ -3241,7 +3247,11 @@ A jump table for the options with a short description can be found at |Q_op|.
 	  stlnc:c	' ' or '='	statusline of the non-current windows
 	  vert:c	'|'		vertical separators |:vsplit|
 	  fold:c	'-'		filling 'foldtext'
+	  foldopen:c	'-'		mark the beginning of a fold
+	  foldclose:c	'+'		show a closed fold
+	  foldsep:c	'|'		open fold middle character
 	  diff:c	'-'		deleted lines of the 'diff' option
+	  eob:c		'~'		empty lines below the end of a buffer
 
 	Any one that is omitted will fall back to the default.  For "stl" and
 	"stlnc" the space will be used when there is highlighting, '^' or '='
@@ -3261,6 +3271,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	  vert:c	VertSplit		|hl-VertSplit|
 	  fold:c	Folded			|hl-Folded|
 	  diff:c	DiffDelete		|hl-DiffDelete|
+	  eob:c		EndOfBuffer		|hl-EndOfBuffer|
 
 		*'fixendofline'* *'fixeol'* *'nofixendofline'* *'nofixeol'*
 'fixendofline' 'fixeol'	boolean	(default on)
@@ -3273,7 +3284,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	See the 'endofline' option.
 
 					*'fkmap'* *'fk'* *'nofkmap'* *'nofk'*
-'fkmap' 'fk'		boolean (default off)			*E198*
+'fkmap' 'fk'		boolean (default off)
 			global
 			{only available when compiled with the |+rightleft|
 			feature}
@@ -4846,7 +4857,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 
 						*'listchars'* *'lcs'*
 'listchars' 'lcs'	string	(default "eol:$")
-			global
+			global or local to window |global-local|
 	Strings to use in 'list' mode and for the |:list| command.  It is a
 	comma separated list of string settings.
 							*lcs-eol*
@@ -4877,7 +4888,13 @@ A jump table for the options with a short description can be found at |Q_op|.
 							*lcs-space*
 	  space:c	Character to show for a space.  When omitted, spaces
 			are left blank.
-							*lcs-trail*
+							*lcs-lead*
+	  lead:c	Character to show for leading spaces.  When omitted,
+			leading spaces are blank.  Overrides the "space"
+			setting for leading spaces.  You can combine it with
+			"tab:", for example: >
+				:set listchars+=tab:>-,lead:.
+<							*lcs-trail*
 	  trail:c	Character to show for trailing spaces.  When omitted,
 			trailing spaces are blank.  Overrides the "space"
 			setting for trailing spaces.
@@ -5221,7 +5238,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	NOTE: This option is set to the Vi default value when 'compatible' is
 	set and to the Vim default value when 'compatible' is reset.
 
-						*'mouse'* *E538*
+						*'mouse'*
 'mouse'			string	(default "", "a" for GUI and Win32,
 					set to "a" or "nvi" in |defaults.vim|)
 			global
@@ -6226,7 +6243,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 <
 				*'runtimepath'* *'rtp'* *vimfiles*
 'runtimepath' 'rtp'	string	(default:
-					Unix: "$HOME/.vim,
+					Unix:  "$HOME/.vim,
 						$VIM/vimfiles,
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
@@ -6236,7 +6253,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
 						home:vimfiles/after"
-					PC:    "$HOME/vimfiles,
+					MS-Windows: "$HOME/vimfiles,
 						$VIM/vimfiles,
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
@@ -6248,8 +6265,8 @@ A jump table for the options with a short description can be found at |Q_op|.
 						$VIM/vimfiles,
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
-						$BE_USER_SETTINGS/vim/after")
-					VMS: "sys$login:vimfiles,
+						$BE_USER_SETTINGS/vim/after"
+					VMS:   "sys$login:vimfiles,
 						$VIM/vimfiles,
 						$VIMRUNTIME,
 						$VIM/vimfiles/after,
@@ -6321,7 +6338,9 @@ A jump table for the options with a short description can be found at |Q_op|.
 			local to window
 	Number of lines to scroll with CTRL-U and CTRL-D commands.  Will be
 	set to half the number of lines in the window when the window size
-	changes.  If you give a count to the CTRL-U or CTRL-D command it will
+	changes.  This may happen when enabling the |status-line| or
+	'tabline' option after setting the 'scroll' option.
+	If you give a count to the CTRL-U or CTRL-D command it will
 	be used as the new value for 'scroll'.  Reset to half the window
 	height with ":set scroll=0".