Merge pull request #1866 from h-east/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 Dec 03
+*options.txt*	For Vim バージョン 9.1.  Last change: 2024 Dec 07
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -4476,8 +4476,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 			グローバル
 	":" によるコマンドと以前に使った検索パターンの履歴は保存されるわけだが、
 	このオプションはそれぞれの履歴に何個の項目が保存されるかを指定する (記
-	憶するメッセージ数については、|cmdline-editing| および 'msghistory' を
-	参照)。
+	憶するメッセージ数については、|cmdline-editing| および 'messagesopt'
+	を参照)。
 	最大値は10000。
 	NOTE: このオプションは 'compatible' がオンになるとViの既定値に設定され、
 	'compatible' がオフになるとVimの既定値に設定されるので注意。
@@ -5682,6 +5682,29 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	に対して使われる。このオプションを変更しても直接の効果はなく、メニュー
 	を更新しなければならない。
 
+						*'messagesopt'* *'mopt'*
+'messagesopt' 'mopt'	文字列	(既定では "hit-enter,history:500")
+			グローバル
+
+	メッセージ出力のためのオプション設定。以下の項目から構成される。項目は
+	コンマで区切る必要がある。
+
+	hit-enter	メッセージが 'cmdheight' のサイズより長い場合は、
+			|hit-enter| プロンプトを使用する。
+
+	wait:{n}	|hit-enter| プロンプトを使用する代わりに、ユーザーが
+			メッセージを読む機会が得られるように、単純に {n} ミリ
+			秒間ウェイトする。{n} の最大値は 10000 である。ウェイ
+			トを無効にするには 0 を使用する (ただし、ユーザーは重
+			要なメッセージを見逃す可能性がある)。
+			この項目は、"hit-enter" が指定される場合は無視される
+			が、"hit-enter" が指定されない場合は必須である。
+
+	history:{n}	|:messages| 履歴に記憶されるエントリ数を決定する。最大
+			値は 10000 である。
+			ゼロに設定すると、メッセージ履歴がクリアされる。
+			この項目は常に指定する必要がある。
+
 						*'mkspellmem'* *'msm'*
 'mkspellmem' 'msm'	文字列	(既定では "460000,2000,500")
 			グローバル
@@ -5959,12 +5982,6 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 	GUI版, Win32とUnixのxtermでのみ有効。ダブルクリックなどとして認識され
 	るクリックとクリックの間の時間を、ミリ秒単位で設定する。
 
-						*'msghistory'* *'mhi'*
-'msghistory' 'mhi'	数値	(既定では 500)
-			グローバル
-	|:messages| 履歴に記憶される項目数を決定する。最大値は 10000 である。
-	ゼロに設定すると、メッセージ履歴がクリアされる。
-
 
 						    *'mzquantum'* *'mzq'*
 'mzquantum' 'mzq'	数値	(既定では 100)

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.1.  Last change: 2024 Dec 03
+*options.txt*	For Vim version 9.1.  Last change: 2024 Dec 07
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -4439,7 +4439,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 			global
 	A history of ":" commands, and a history of previous search patterns
 	is remembered.  This option decides how many entries may be stored in
-	each of these histories (see |cmdline-editing| and 'msghistory' for
+	each of these histories (see |cmdline-editing| and 'messagesopt' for
 	the number of messages to remember).
 	The maximum value is 10000.
 	NOTE: This option is set to the Vi default value when 'compatible' is
@@ -5634,6 +5634,29 @@ A jump table for the options with a short description can be found at |Q_op|.
 	generated from a list of items, e.g., the Buffers menu.  Changing this
 	option has no direct effect, the menu must be refreshed first.
 
+						*'messagesopt'* *'mopt'*
+'messagesopt' 'mopt'	string	(default "hit-enter,history:500")
+			global
+
+	Option settings for outputting messages.  It can consist of the
+	following items.  Items must be separated by a comma.
+
+	hit-enter	Use a |hit-enter| prompt when the message is longer than
+			'cmdheight' size.
+
+	wait:{n}	Instead of using a |hit-enter| prompt, simply wait for
+			{n} milliseconds so that the user has a chance to read
+			the message.  The maximum value of {n} is 10000.  Use
+			0 to disable the wait (but then the user may miss an
+			important message).
+			This item is ignored when "hit-enter" is present, but
+			required when "hit-enter" is not present.
+
+	history:{n}	Determines how many entries are remembered in the
+			|:messages| history.  The maximum value is 10000.
+			Setting it to zero clears the message history.
+			This item must always be present.
+
 						*'mkspellmem'* *'msm'*
 'mkspellmem' 'msm'	string	(default "460000,2000,500")
 			global
@@ -5917,13 +5940,6 @@ A jump table for the options with a short description can be found at |Q_op|.
 	time in msec between two mouse clicks for the second click to be
 	recognized as a multi click.
 
-						*'msghistory'* *'mhi'*
-'msghistory' 'mhi'	number	(default 500)
-			global
-	Determines how many entries are remembered in the |:messages| history.
-	The maximum value is 10000.
-	Setting it to zero clears the message history.
-
 
 						    *'mzquantum'* *'mzq'*
 'mzquantum' 'mzq'	number	(default 100)