Merge pull request #2571 from h-east/update-options

Update options.{txt,jax}

Author: h-east

doc/options.jax

@@ -1,4 +1,4 @@
-*options.txt*	For Vim バージョン 9.2.  Last change: 2026 Apr 06
+*options.txt*  For Vim バージョン 9.2.  Last change: 2026 Apr 09
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -6924,6 +6924,7 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 			グローバル
 	補完時のポップアップメニューのボーダーとオプションの装飾を定義する。値
 	はコンマ区切りのキーワードリストである。
+	統合された代わりの手段については、'pumopt' を参照。
 
 	ボーダーのスタイル (最大 1 つ):
 	"single"	細い罫線文字を使用する
@@ -6956,8 +6957,8 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 'pumheight' 'ph'	数値	(既定では 0)
 			グローバル
 	挿入モード補完のポップアップメニューに表示される項目数の最大値。
-	0 のときはスペースの許す限り多く表示される。
-	|ins-completion-menu|
+	0 のときはスペースの許す限り多く表示される。|ins-completion-menu|
+	統合された代わりの手段については、'pumopt' を参照。
 
 						*'pummaxwidth'* *'pmw'*
 'pummaxwidth' 'pmw'	数値	(既定では 0)
@@ -6969,12 +6970,67 @@ Note 1番目の形式では、行全体がオプション指定に使われる
 
 	このオプションは 'pumwidth' よりも優先される。
 	|ins-completion-menu|。
+	統合された代わりの手段については、'pumopt' を参照。
+
+						*'pumopt'*
+'pumopt'		文字列	(既定では "")
+			グローバル
+	挿入モードの補完時に表示されるポップアップメニューを設定する。
+	値は、キーと値のペアおよびフラグをコンマで区切ったリストです。
+	値は、コンマ区切りの "key:value" ペアおよびフラグのリストである。
+
+	キーと値:
+	  border:{style}	ボーダースタイルを設定する (最大 1 つ)
+				"single"  細い罫線文字
+				"double"  2 重の罫線文字
+				"round"   丸い角
+				"ascii"   ASCII 文字 (-, |, +)
+				"custom:X;X;X;X;X;X;X;X"
+					  セミコロンで区切られた以下の順序の 8
+					  文字:
+					  上、右、下、左、左上、右上、右下、左下
+	  height:{n}		表示する項目の最大数 (デフォルトは 0 で、スペー
+				スの許す限り多く表示する)
+	  width:{n}		最小幅 (デフォルト 15)
+	  maxwidth:{n}		最大幅 (デフォルトは 0 で制限なし)。
+				これは width よりも優先される。テキストの切り
+				詰めは、'fillchars' オプションの "trunc" 値で
+				示される。
+	  opacity:{n}		不透明度のパーセント 0-100 (デフォルト 100)。
+				100 未満の場合、ポップアップメニュー越しに背後
+				のコンテンツが透けて見える。
+
+	フラグ (値なし):
+	  margin		左右のボーダーの内側に 1 セル分のスペースを追
+				加する。ボーダースタイルが必要。
+	  shadow		右端と下端に影を描く。
+
+	罫線文字 ("single", "double", "round") を使用したボーダースタイルは、
+	'encoding' が "utf-8" かつ 'ambiwidth' が "single" の場合にのみ使用で
+	きる。
+
+	ハイライトグループ:
+	|hl-PmenuBorder|	ボーダー文字に使用される
+	|hl-PmenuShadow|	影に使用される
+
+	Note: 'pumopt' が設定されている場合、まずすべての値がデフォルト値にリ
+	セットされ、その後指定されたキーが適用される。指定されていないキーには
+	デフォルト値が適用される。
+
+	例: >
+		:set pumopt=border:single
+		:set pumopt=border:double,margin,shadow
+		:set pumopt=height:10,width:20,opacity:80
+		:set pumopt=border:custom:─;│;─;│;┌;┐;┘;└,shadow
+<
+	以下も参照: |ins-completion-menu|。
 
 						*'pumwidth'* *'pw'*
 'pumwidth' 'pw'		数値	(既定では 15)
 			グローバル
 	挿入モード補完のポップアップメニューに使用する幅の最小値。
 	|ins-completion-menu|.
+	統合された代わりの手段については、'pumopt' を参照。
 
 						*'pythondll'*
 'pythondll'		文字列	(既定値はビルドに依存)

en/options.txt

@@ -1,4 +1,4 @@
-*options.txt*	For Vim version 9.2.  Last change: 2026 Apr 06
+*options.txt*	For Vim version 9.2.  Last change: 2026 Apr 09
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -6886,6 +6886,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 			global
 	Defines a border and optional decorations for the popup menu in
 	completion.  The value is a comma-separated list of keywords.
+	See 'pumopt' for a consolidated alternative.
 
 	Border styles (at most one):
 	"single"	use thin box-drawing characters
@@ -6921,6 +6922,7 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Determines the maximum number of items to show in the popup menu for
 	Insert mode completion.  When zero as much space as available is used.
 	|ins-completion-menu|.
+	See 'pumopt' for a consolidated alternative.
 
 						*'pummaxwidth'* *'pmw'*
 'pummaxwidth' 'pmw'	number	(default 0)
@@ -6932,12 +6934,67 @@ A jump table for the options with a short description can be found at |Q_op|.
 
 	This option takes precedence over 'pumwidth'.
 	|ins-completion-menu|.
+	See 'pumopt' for a consolidated alternative.
+
+						*'pumopt'*
+'pumopt'		string	(default "")
+			global
+	Configures the popup menu used for Insert mode completion.
+	The value is a comma-separated list of "key:value" pairs and flags.
+
+	Keys with values:
+	  border:{style}	set a border style (at most one):
+				"single"  thin box-drawing characters
+				"double"  double-line box-drawing characters
+				"round"   rounded corners
+				"ascii"   ASCII characters (-, |, +)
+				"custom:X;X;X;X;X;X;X;X"
+					  eight characters separated by
+					  semicolons, in the order: top, right,
+					  bottom, left, topleft, topright,
+					  botright, botleft
+	  height:{n}		maximum number of items to show (default 0,
+				meaning as much space as available)
+	  width:{n}		minimum width (default 15)
+	  maxwidth:{n}		maximum width (default 0, meaning no limit).
+				This takes precedence over width.
+				Truncated text is indicated by "trunc" value
+				of 'fillchars' option.
+	  opacity:{n}		opacity percentage 0-100 (default 100).
+				When less than 100, background content shows
+				through the popup menu.
+
+	Flags (no value):
+	  margin		adds one-cell spacing inside the left and
+				right border.  Requires a border style.
+	  shadow		draws a shadow at the right and bottom edges.
+
+	Border styles using box-drawing characters ("single", "double",
+	"round") are only available when 'encoding' is "utf-8" and 'ambiwidth'
+	is "single".
+
+	Highlight groups:
+	|hl-PmenuBorder|	used for the border characters
+	|hl-PmenuShadow|	used for the shadow
+
+	Note: When 'pumopt' is set, all values are reset to their defaults
+	first, then the specified keys are applied.  Unspecified keys get
+	their default values.
+
+	Examples: >
+		:set pumopt=border:single
+		:set pumopt=border:double,margin,shadow
+		:set pumopt=height:10,width:20,opacity:80
+		:set pumopt=border:custom:─;│;─;│;┌;┐;┘;└,shadow
+<
+	See also: |ins-completion-menu|.
 
 						*'pumwidth'* *'pw'*
 'pumwidth' 'pw'		number	(default 15)
 			global
 	Determines the minimum width to use for the popup menu for Insert mode
 	completion.  |ins-completion-menu|.
+	See 'pumopt' for a consolidated alternative.
 
 						*'pythondll'*
 'pythondll'		string	(default depends on the build)