Merge pull request #1569 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 Jun 01
+*options.txt*	For Vim バージョン 9.1.  Last change: 2024 Jun 05
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -1956,13 +1956,14 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	は、|option-backslash| を参照。
 
 					*'commentstring'* *'cms'* *E537*
-'commentstring' 'cms'	文字列	(既定では "/*%s*/")
+'commentstring' 'cms'	文字列	(既定では "/* %s */")
 			バッファについてローカル
 			{|+folding| 機能付きでコンパイルされたときのみ有効}
-	コメント用のテンプレート (雛形)。値の中の "%s" はコメントの内容と置き
-	換えられる。現在のところ、折り畳み用のマーカーを追加するためにのみ使用
-	されている。|fold-marker| を参照。コメントプラグイン |comment-install|
-	でも使用される。
+	コメント用のテンプレート (雛形)。値内の "%s" はコメントテキストに置き
+	換えられ、可能な限りスペースでパディングされるべきである。現在のとこ
+	ろ、折り畳み用のマーカーを追加するために使用されている。|fold-marker|
+	を参照。一般的にコメントプラグインでも使用される (例:
+	|comment-install|)。
 
 			*'compatible'* *'cp'* *'nocompatible'* *'nocp'*
 'compatible' 'cp'	切替	(既定では オン、ファイル|vimrc|または |gvimrc|
@@ -2143,7 +2144,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 
 						*'completeopt'* *'cot'*
 'completeopt' 'cot'	文字列	(既定では "menu,preview")
-			グローバル
+			グローバル／バッファについてローカル |global-local|
 	入力モードでの補完|ins-completion|についてのオプションのコンマ区切りの
 	リスト。サポートされている値は次の通り:
 
@@ -2187,6 +2188,13 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 		    自分で選ぶことを強制する。"menu" か "menuone" と組み合わせ
 		    たときにだけ機能する。
 
+	   fuzzy    補完候補に対して |fuzzy-matching| を有効にする。これによ
+		    り、より柔軟で直感的なマッチングが可能になり、文字をスキッ
+		    プしたり、正確なシーケンスが入力されていなくてもマッチを見
+		    つけることができる。補完候補が選択肢のリストからどのように
+		    削減されるかに違いがあるだけで、(異なる補完タイプを使用し
+		    て) 候補が収集される方法には違いはない。
+
 					*'completepopup'* *'cpp'*
 'completepopup' 'cpp'	字列  (既定では空)
 			グローバル

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.1.  Last change: 2024 Jun 01
+*options.txt*	For Vim version 9.1.  Last change: 2024 Jun 05
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -1909,13 +1909,14 @@ A jump table for the options with a short description can be found at |Q_op|.
 	insert a space.
 
 					*'commentstring'* *'cms'* *E537*
-'commentstring' 'cms'	string	(default "/*%s*/")
+'commentstring' 'cms'	string	(default "/* %s */")
 			local to buffer
 			{not available when compiled without the |+folding|
 			feature}
 	A template for a comment.  The "%s" in the value is replaced with the
-	comment text.  Currently only used to add markers for folding, see
-	|fold-marker|.  Also used by comment plugins |comment-install|.
+	comment text, and should be padded with a space when possible.
+	Currently used to add markers for folding, see |fold-marker| also
+	commonly used by commenting plugins (e.g. |comment-install|).
 
 			*'compatible'* *'cp'* *'nocompatible'* *'nocp'*
 'compatible' 'cp'	boolean	(default on, off when a |vimrc| or |gvimrc|
@@ -2100,7 +2101,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 
 						*'completeopt'* *'cot'*
 'completeopt' 'cot'	string	(default: "menu,preview")
-			global
+			global or local to buffer |global-local|
 	A comma-separated list of options for Insert mode completion
 	|ins-completion|.  The supported values are:
 
@@ -2143,6 +2144,14 @@ A jump table for the options with a short description can be found at |Q_op|.
 		    select one from the menu. Only works in combination with
 		    "menu" or "menuone".
 
+	   fuzzy    Enable |fuzzy-matching| for completion candidates. This
+		    allows for more flexible and intuitive matching, where
+		    characters can be skipped and matches can be found even
+		    if the exact sequence is not typed.  Only makes a
+		    difference how completion candidates are reduced from the
+		    list of alternatives, but not how the candidates are
+		    collected (using different completion types).
+
 					*'completepopup'* *'cpp'*
 'completepopup' 'cpp'	string (default empty)
 			global