Merge pull request #1722 from vim-jp/hh-update-options

Update options.{txt,jax}

Author: h-east

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 9.1.  Last change: 2024 Sep 26
+*options.txt*	For Vim バージョン 9.1.  Last change: 2024 Oct 02
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -1694,12 +1694,13 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 'cedit'			文字列	(Viの既定値: "", Vimの既定値: CTRL-F)
 			グローバル
 	コマンドラインモードで、コマンドラインウィンドウを開くために使われる
-	キー。オプション 'compatible' がオフならば、既定では CTRL-F である。
-	non-printable なキー {訳注: 文書先頭を参照} しか指定できない。キーは単
-	一の文字として設定することもできるが、それでは入力しにくい。<> を使っ
-	た表記を推奨する。例: >
-		:exe "set cedit=\<C-Y>"
-		:exe "set cedit=\<Esc>"
+	キー。'compatible' がオフの場合、デフォルトは CTRL-F である。
+	表示不可文字なキーのみが許可される。
+	キーは単一文字で指定できるが、入力が困難である。推奨される方法は、
+	|key-notation|  (例: <Up>、<C-F>) またはキャレット付きの文字 (例: `^F`
+	は CTRL-F) を使用することだ。例: >
+		:set cedit=^Y
+		:set cedit=<Esc>
 <	|Nvi| にもこのオプションがあるが、最初の1文字だけが使用される。
 	|cmdwin| を参照。
 	NOTE: このオプションは 'compatible' がオフになるとVimの既定値に設定さ
@@ -2143,6 +2144,16 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	セキュリティ上の理由から、このオプションを |modeline| または |sandbox|
 	内で設定することはできない。
 
+						*'completeitemalign'* *'cia'*
+'completeitemalign' 'cia' 文字列 (既定では "abbr,kind,menu")
+			  グローバル
+	コンマで区切られた |complete-items| のリストで、挿入モード補完中にポッ
+	プアップメニューの項目の配置と表示順序を制御する。サポートされている値
+	は、abbr、kind、および menu である。これらのオプションを使用すると、補
+	完項目がポップアップメニューに表示される方法をカスタマイズできる。
+	Note: どのような順序であっても、常にこれら 3 つの値を含んでいなければ
+	ならない。
+
 						*'completeopt'* *'cot'*
 'completeopt' 'cot'	文字列	(既定では "menu,preview")
 			グローバル／バッファについてローカル |global-local|
@@ -3514,15 +3525,15 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	中でこうする。
 		/* vim: set filetype=idl : */ ~
 	|FileType| |filetypes|
-	値の中にドットが現れると、それが2つのファイルタイプ名の区切りとなる。
-	例:
+	値にドットが含まれる場合、これは 2 つのファイルタイプ名を区切るため、
+	ファイルタイプには使用しないこと。例:
 		/* vim: set filetype=c.doxygen : */ ~
 	こうすると最初にファイルタイプ "c" を使い、次にファイルタイプ "doxygen"
 	を使う。これはファイルタイププラグインと構文ファイル両方に適用される。
 	2個以上のドットが現れてもよい。
 	このオプションは 'cpoptions' のフラグ 's' や 'S' にかかわらず、別のバッ
 	ファにはコピーされない。
-	通常のファイル名文字だけが使える。"/\*?[|<>" は不正である。
+	英数字、'-'、'_' のみ使用できる。
 
 						*'fillchars'* *'fcs'*
 'fillchars' 'fcs'	文字列	(既定では "vert:|,fold:-,eob:~")
@@ -5036,7 +5047,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	このオプションを適正なキーマップ名に設定すると、キーマッピングが有効に
 	なるようにオプション 'iminsert' が 1 になるという影響がある。また
 	'imsearch' も、元が -1 でない限り 1 になる。
-	通常のファイル名文字だけが使用できる。"/\*?[|<>" は不正である。
+	英数字、'.'、'-'、'_' のみ使用できる。
 
 					*'keymodel'* *'km'*
 'keymodel' 'km'		文字列	(既定では "")
@@ -8141,7 +8152,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	このオプションの値を引数にして発生するということだ。
 	'cpoptions' のフラグ 's' や 'S' にかかわらず、このオプションの値は別の
 	バッファにはコピーされない。
-	通常のファイル名文字だけが使える。"/\*?[|<>" は不正である。
+	英数字、'.'、'-'、'_' のみ使用できる。
 
 						*'tabclose'* *'tcl'*
 'tabclose' 'tcl'	文字列	(既定では "")

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.1.  Last change: 2024 Sep 26
+*options.txt*	For Vim version 9.1.  Last change: 2024 Oct 02
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -1651,9 +1651,10 @@ A jump table for the options with a short description can be found at |Q_op|.
 	The default is CTRL-F when 'compatible' is off.
 	Only non-printable keys are allowed.
 	The key can be specified as a single character, but it is difficult to
-	type.  The preferred way is to use the <> notation.  Examples: >
-		:exe "set cedit=\<C-Y>"
-		:exe "set cedit=\<Esc>"
+	type.  The preferred way is to use |key-notation| (e.g. <Up>, <C-F>) or
+	a letter preceded with a caret (e.g. `^F` is CTRL-F).  Examples: >
+		:set cedit=^Y
+		:set cedit=<Esc>
 <	|Nvi| also has this option, but it only uses the first character.
 	See |cmdwin|.
 	NOTE: This option is set to the Vim default value when 'compatible'
@@ -2101,6 +2102,16 @@ A jump table for the options with a short description can be found at |Q_op|.
 	This option cannot be set from a |modeline| or in the |sandbox|, for
 	security reasons.
 
+						*'completeitemalign'* *'cia'*
+'completeitemalign' 'cia' string (default: "abbr,kind,menu")
+			  global
+	A comma-separated list of |complete-items| that controls the alignment
+	and display order of items in the popup menu during Insert mode
+	completion. The supported values are abbr, kind, and menu. These
+	options allow to customize how the completion items are shown in the
+	popup menu.  Note: must always contain those three values in any
+	order.
+
 						*'completeopt'* *'cot'*
 'completeopt' 'cot'	string	(default: "menu,preview")
 			global or local to buffer |global-local|
@@ -3492,14 +3503,14 @@ A jump table for the options with a short description can be found at |Q_op|.
 		/* vim: set filetype=idl : */ ~
 	|FileType| |filetypes|
 	When a dot appears in the value then this separates two filetype
-	names.  Example:
+	names, it should therefore not be used for a filetype.  Example:
 		/* vim: set filetype=c.doxygen : */ ~
 	This will use the "c" filetype first, then the "doxygen" filetype.
 	This works both for filetype plugins and for syntax files.  More than
 	one dot may appear.
 	This option is not copied to another buffer, independent of the 's' or
 	'S' flag in 'cpoptions'.
-	Only normal file name characters can be used, "/\*?[|<>" are illegal.
+	Only alphanumeric characters, '-' and '_' can be used.
 
 						*'fillchars'* *'fcs'*
 'fillchars' 'fcs'	string	(default "vert:|,fold:-,eob:~")
@@ -4981,7 +4992,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Setting this option to a valid keymap name has the side effect of
 	setting 'iminsert' to one, so that the keymap becomes effective.
 	'imsearch' is also set to one, unless it was -1
-	Only normal file name characters can be used, "/\*?[|<>" are illegal.
+	Only alphanumeric characters, '.', '-' and '_' can be used.
 
 					*'keymodel'* *'km'*
 'keymodel' 'km'		string	(default "")
@@ -8101,7 +8112,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Syntax autocommand event is triggered with the value as argument.
 	This option is not copied to another buffer, independent of the 's' or
 	'S' flag in 'cpoptions'.
-	Only normal file name characters can be used, "/\*?[|<>" are illegal.
+	Only alphanumeric characters, '.', '-' and '_' can be used.
 
 						*'tabclose'* *'tcl'*
 'tabclose' 'tcl'	string	(default "")