1- *options.txt* For Vim version 9.2. Last change: 2026 Apr 06
1+ *options.txt* For Vim version 9.2. Last change: 2026 Apr 07
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -7022,6 +7022,7 @@ A jump table for the options with a short description can be found at |Q_op|.
70227022 global
70237023 Defines a border and optional decorations for the popup menu in
70247024 completion. The value is a comma-separated list of keywords.
7025+ See | 'pumopt' | for a consolidated alternative.
70257026
70267027 Border styles (at most one):
70277028 "single" use thin box-drawing characters
@@ -7057,6 +7058,7 @@ A jump table for the options with a short description can be found at |Q_op|.
70577058 Determines the maximum number of items to show in the popup menu for
70587059 Insert mode completion. When zero as much space as available is used.
70597060 | ins-completion-menu | .
7061+ See | 'pumopt' | for a consolidated alternative.
70607062
70617063 *'pummaxwidth'* *'pmw'*
70627064'pummaxwidth' 'pmw' number (default 0)
@@ -7068,12 +7070,67 @@ A jump table for the options with a short description can be found at |Q_op|.
70687070
70697071 This option takes precedence over 'pumwidth' .
70707072 | ins-completion-menu | .
7073+ See | 'pumopt' | for a consolidated alternative.
7074+
7075+ *'pumopt'*
7076+ 'pumopt' string (default "")
7077+ global
7078+ Configures the popup menu used for Insert mode completion.
7079+ The value is a comma-separated list of key:value pairs and flags.
7080+
7081+ Keys with values:
7082+ border:{style} set a border style (at most one):
7083+ "single" thin box-drawing characters
7084+ "double" double-line box-drawing characters
7085+ "round" rounded corners
7086+ "ascii" ASCII characters (-, |, +)
7087+ "custom:X;X;X;X;X;X;X;X"
7088+ eight characters separated by
7089+ semicolons, in the order: top, right,
7090+ bottom, left, topleft, topright,
7091+ botright, botleft
7092+ height:{n} maximum number of items to show (default 0,
7093+ meaning as much space as available)
7094+ width:{n} minimum width (default 15)
7095+ maxwidth:{n} maximum width (default 0, meaning no limit).
7096+ This takes precedence over width.
7097+ Truncated text is indicated by "trunc" value
7098+ of 'fillchars' option.
7099+ opacity:{n} opacity percentage 0-100 (default 100).
7100+ When less than 100, background content shows
7101+ through the popup menu.
7102+
7103+ Flags (no value):
7104+ margin adds one-cell spacing inside the left and
7105+ right border. Requires a border style.
7106+ shadow draws a shadow at the right and bottom edges.
7107+
7108+ Border styles using box-drawing characters ("single", "double",
7109+ "round") are only available when 'encoding' is "utf-8" and
7110+ 'ambiwidth' is "single".
7111+
7112+ Highlight groups:
7113+ | hl-PmenuBorder | used for the border characters
7114+ | hl-PmenuShadow | used for the shadow
7115+
7116+ Note: When 'pumopt' is set, all values are reset to their defaults
7117+ first, then the specified keys are applied. Unspecified keys get
7118+ their default values.
7119+
7120+ Examples: >
7121+ :set pumopt=border:single
7122+ :set pumopt=border:double,margin,shadow
7123+ :set pumopt=height:10,width:20,opacity:80
7124+ :set pumopt=border:custom:─;│;─;│;┌;┐;┘;└,shadow
7125+ <
7126+ See also: | ins-completion-menu | .
70717127
70727128 *'pumwidth'* *'pw'*
70737129'pumwidth' 'pw' number (default 15)
70747130 global
70757131 Determines the minimum width to use for the popup menu for Insert mode
70767132 completion. | ins-completion-menu | .
7133+ See | 'pumopt' | for a consolidated alternative.
70777134
70787135 *'pythondll'*
70797136'pythondll' string (default depends on the build)
0 commit comments