Merge pull request #1493 from vim-jp/hh-update-builtin

Update builtin.{txt,jax}

Author: h-east

doc/builtin.jax

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim バージョン 9.1.  Last change: 2024 Apr 04
+*builtin.txt*	For Vim バージョン 9.1.  Last change: 2024 Apr 07
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -238,11 +238,11 @@ getbufvar({buf}, {varname} [, {def}])
 				任意	バッファ{buf}の変数 {varname}
 getcellwidths()			リスト	文字のセル幅の上書き設定を取得
 getchangelist([{buf}])		リスト	変更リスト要素のリスト
-getchar([expr])			数値/文字列	ユーザーから1文字を取得する
+getchar([{expr}])		数値/文字列	ユーザーから1文字を取得する
 getcharmod()			数値	修飾キーの状態を表す数値を取得
 getcharpos({expr})		リスト	カーソル、マーク、その他のカーソル位置
 getcharsearch()			辞書	最後の文字検索を取得
-getcharstr([expr])		文字列	ユーザーから1文字を取得する
+getcharstr([{expr}])		文字列	ユーザーから1文字を取得する
 getcmdcompltype()		文字列	現在のコマンドライン補完のタイプを返す
 getcmdline()			文字列	現在のコマンドラインを取得
 getcmdpos()			数値	コマンドラインのカーソル位置を取得
@@ -424,7 +424,7 @@ menu_info({name} [, {mode}])	辞書	メニューの項目情報を取得する
 min({expr})			数値	{expr}内の要素の最小値
 mkdir({name} [, {flags} [, {prot}]])
 				数値	ディレクトリ{name}を作成
-mode([expr])			文字列	現在の編集モード
+mode([{expr}])			文字列	現在の編集モード
 mzeval({expr})			任意	|MzScheme| の式を評価する
 nextnonblank({lnum})		数値	{lnum}行目以降で空行でない行の行番号
 nr2char({expr} [, {utf8}])	文字列	ASCII/UTF-8コード{expr}で示される文字
@@ -762,7 +762,7 @@ test_override({expr}, {val})	なし	Vimの内部処理を置き換えてテス
 test_refcount({expr})		数値	{expr}の参照カウントを取得
 test_setmouse({row}, {col})	なし	テスト用にマウス位置を設定する
 test_settime({expr})		なし	テスト用に現在の時刻を設定する
-test_srand_seed([seed])		なし	srand() のテスト用に種を設定する
+test_srand_seed([{seed}])	なし	srand() のテスト用に種を設定する
 test_unknown()			任意	テスト用のunknown値
 test_void()			任意	テスト用のvoid値
 timer_info([{id}])		リスト	タイマーに関する情報
@@ -793,7 +793,7 @@ virtcol({expr} [, {list} [, {winid}])
 					カーソルまたはマークのスクリーン桁
 virtcol2col({winid}, {lnum}, {col})
 				数値	スクリーン上の文字のバイトインデックス
-visualmode([expr])		文字列	最後に使われたビジュアルモード
+visualmode([{expr}])		文字列	最後に使われたビジュアルモード
 wildmenumode()			数値	'wildmenu' モードが有効かどうか
 win_execute({id}, {command} [, {silent}])
 				文字列	ウィンドウ{id}で{command}を実行する
@@ -3451,29 +3451,29 @@ getchangelist([{buf}])					*getchangelist()*
 		|method| としても使用できる: >
 			GetBufnr()->getchangelist()
 
-getchar([expr])						*getchar()*
+getchar([{expr}])					*getchar()*
 		ユーザーまたは入力ストリームから1文字を取得する。
-		[expr] が省略された場合、1文字を取得できるまで待つ。
-		[expr] が0の場合、1文字を取得できる時だけ取得する。取得できな
+		{expr} が省略された場合、1文字を取得できるまで待つ。
+		{expr} が0の場合、1文字を取得できる時だけ取得する。取得できな
 			い時は0を返す。
-		[expr] が1の場合は、1文字を取得できるかを判定するだけである。
+		{expr} が1の場合は、1文字を取得できるかを判定するだけである。
 			入力は消費されない。取得できないと判定された時は0を返
 			す。
  		常に文字列として取得したい場合は |getcharstr()| を使用する。
 
-		[expr] が省略されたときや [expr] が0のときは、文字全体または特
+		{expr} が省略されたときや {expr} が0のときは、文字全体または特
 		殊キーを返す。それが1文字なら戻り値は数値である。これを文字列
 		に戻すには |nr2char()| を使う。それ以外の場合にはエンコードし
 		て文字列にして返す。
 		特殊キーとは0x80(10進数で128)で始まるバイト列からなる文字列で
 		ある。これは文字列 "\<Key>" と同じ値である(例: "\<Left>")。戻
 		り値は文字列であり、修飾キー(shift, control, alt)は含まれない。
 
-		[expr] が0や Esc が入力された場合は、これがエスケープシーケン
+		{expr} が0や Esc が入力された場合は、これがエスケープシーケン
 		スの始まりであるかどうかをVimが知るために待つ間、短い遅延があ
 		るだろう。
 
-		[expr] が1のときは最初のバイトだけを返す。1バイト文字の場合、
+		{expr} が1のときは最初のバイトだけを返す。1バイト文字の場合、
 		これはその文字そのものを表す数値である。これを文字列に変換する
 		にはnr2char()を使う。
 
@@ -3578,12 +3578,12 @@ getcharsearch()						*getcharsearch()*
 			:nnoremap <expr> , getcharsearch().forward ? ',' : ';'
 <		|setcharsearch()|も参照。
 
-getcharstr([expr])					*getcharstr()*
+getcharstr([{expr}])					*getcharstr()*
 		ユーザーまたは入力ストリームから1文字を文字列として取得する。
-		[expr] が省略された場合、1文字を取得できるまで待つ。
-		[expr] が0もしくは偽の場合、1文字を取得できる時だけ取得する。
+		{expr} が省略された場合、1文字を取得できるまで待つ。
+		{expr} が0もしくは偽の場合、1文字を取得できる時だけ取得する。
 			取得できない時は空文字列を返す。
-		[expr] が1もしくは真の場合は、1文字を取得できるかを判定するだ
+		{expr} が1もしくは真の場合は、1文字を取得できるかを判定するだ
 			けである。入力は消費されない。取得できないと判定された
 			時は空文字列を返す。
 		結果の数値が文字列に変換される以外は |getchar()| と同様に動作
@@ -6539,8 +6539,8 @@ mkdir({name} [, {flags} [, {prot}]])
 			GetName()->mkdir()
 <
 							*mode()*
-mode([expr])	現在のモードを示す文字列を返す。
-		[expr] に 0 でない数値か空でない文字列 (|non-zero-arg|) を指定
+mode([{expr}])	現在のモードを示す文字列を返す。
+		{expr} に 0 でない数値か空でない文字列 (|non-zero-arg|) を指定
 		した場合、フルモードが返される。それ以外の場合は最初の一文字だ
 		けが返される。
 		|state()| も参照。

en/builtin.txt

@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim version 9.1.  Last change: 2024 Apr 04
+*builtin.txt*	For Vim version 9.1.  Last change: 2024 Apr 07
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -220,12 +220,12 @@ getbufvar({buf}, {varname} [, {def}])
 				any	variable {varname} in buffer {buf}
 getcellwidths()			List	get character cell width overrides
 getchangelist([{buf}])		List	list of change list items
-getchar([expr])			Number or String
+getchar([{expr}])		Number or String
 					get one character from the user
 getcharmod()			Number	modifiers for the last typed character
 getcharpos({expr})		List	position of cursor, mark, etc.
 getcharsearch()			Dict	last character search
-getcharstr([expr])		String	get one character from the user
+getcharstr([{expr}])		String	get one character from the user
 getcmdcompltype()		String	return the type of the current
 					command-line completion
 getcmdline()			String	return the current command-line
@@ -398,7 +398,7 @@ menu_info({name} [, {mode}])	Dict	get menu item information
 min({expr})			Number	minimum value of items in {expr}
 mkdir({name} [, {flags} [, {prot}]])
 				Number	create directory {name}
-mode([expr])			String	current editing mode
+mode([{expr}])			String	current editing mode
 mzeval({expr})			any	evaluate |MzScheme| expression
 nextnonblank({lnum})		Number	line nr of non-blank line >= {lnum}
 nr2char({expr} [, {utf8}])	String	single char with ASCII/UTF-8 value {expr}
@@ -699,7 +699,7 @@ test_override({expr}, {val})	none	test with Vim internal overrides
 test_refcount({expr})		Number	get the reference count of {expr}
 test_setmouse({row}, {col})	none	set the mouse position for testing
 test_settime({expr})		none	set current time for testing
-test_srand_seed([seed])		none	set seed for testing srand()
+test_srand_seed([{seed}])	none	set seed for testing srand()
 test_unknown()			any	unknown value for testing
 test_void()			any	void value for testing
 timer_info([{id}])		List	information about timers
@@ -729,7 +729,7 @@ virtcol({expr} [, {list} [, {winid}])
 					screen column of cursor or mark
 virtcol2col({winid}, {lnum}, {col})
 				Number  byte index of a character on screen
-visualmode([expr])		String	last visual mode used
+visualmode([{expr}])		String	last visual mode used
 wildmenumode()			Number	whether 'wildmenu' mode is active
 win_execute({id}, {command} [, {silent}])
 				String	execute {command} in window {id}
@@ -3455,16 +3455,16 @@ getchangelist([{buf}])					*getchangelist()*
 		Can also be used as a |method|: >
 			GetBufnr()->getchangelist()
 
-getchar([expr])						*getchar()*
+getchar([{expr}])					*getchar()*
 		Get a single character from the user or input stream.
-		If [expr] is omitted, wait until a character is available.
-		If [expr] is 0, only get a character when one is available.
+		If {expr} is omitted, wait until a character is available.
+		If {expr} is 0, only get a character when one is available.
 			Return zero otherwise.
-		If [expr] is 1, only check if a character is available, it is
+		If {expr} is 1, only check if a character is available, it is
 			not consumed.  Return zero if no character available.
 		If you prefer always getting a string use |getcharstr()|.
 
-		Without [expr] and when [expr] is 0 a whole character or
+		Without {expr} and when {expr} is 0 a whole character or
 		special key is returned.  If it is a single character, the
 		result is a Number.  Use |nr2char()| to convert it to a String.
 		Otherwise a String is returned with the encoded character.
@@ -3474,11 +3474,11 @@ getchar([expr])						*getchar()*
 		also a String when a modifier (shift, control, alt) was used
 		that is not included in the character.
 
-		When [expr] is 0 and Esc is typed, there will be a short delay
+		When {expr} is 0 and Esc is typed, there will be a short delay
 		while Vim waits to see if this is the start of an escape
 		sequence.
 
-		When [expr] is 1 only the first byte is returned.  For a
+		When {expr} is 1 only the first byte is returned.  For a
 		one-byte character it is the character itself as a number.
 		Use nr2char() to convert it to a String.
 
@@ -3589,13 +3589,13 @@ getcharsearch()						*getcharsearch()*
 <		Also see |setcharsearch()|.
 
 
-getcharstr([expr])					*getcharstr()*
+getcharstr([{expr}])					*getcharstr()*
 		Get a single character from the user or input stream as a
 		string.
-		If [expr] is omitted, wait until a character is available.
-		If [expr] is 0 or false, only get a character when one is
+		If {expr} is omitted, wait until a character is available.
+		If {expr} is 0 or false, only get a character when one is
 			available.  Return an empty string otherwise.
-		If [expr] is 1 or true, only check if a character is
+		If {expr} is 1 or true, only check if a character is
 			available, it is not consumed.  Return an empty string
 			if no character is available.
 		Otherwise this works like |getchar()|, except that a number
@@ -6648,8 +6648,8 @@ mkdir({name} [, {flags} [, {prot}]])
 			GetName()->mkdir()
 <
 							*mode()*
-mode([expr])	Return a string that indicates the current mode.
-		If [expr] is supplied and it evaluates to a non-zero Number or
+mode([{expr}])	Return a string that indicates the current mode.
+		If {expr} is supplied and it evaluates to a non-zero Number or
 		a non-empty String (|non-zero-arg|), then the full mode is
 		returned, otherwise only the first letter is returned.
 		Also see |state()|.