1
- *options.txt* For Vim version 9.1. Last change: 2025 Mar 14
1
+ *options.txt* For Vim version 9.1. Last change: 2025 Apr 08
2
2
3
3
4
4
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1717,6 +1717,19 @@ A jump table for the options with a short description can be found at |Q_op|.
1717
1717
This option cannot be set from a | modeline | or in the | sandbox | , for
1718
1718
security reasons.
1719
1719
1720
+ *'chistory'* *'chi'*
1721
+ 'chistory' 'chi' number (default: 10)
1722
+ global
1723
+ {only available when compiled with the | +quickfix |
1724
+ feature}
1725
+ Number of quickfix lists that should be remembered for the quickfix
1726
+ stack. Must be between 1 and 100. If the option is set to a value
1727
+ that is lower than the amount of entries in the quickfix list stack,
1728
+ entries will be removed starting from the oldest one. If the current
1729
+ quickfix list was removed, then the quickfix list at top of the stack
1730
+ (the most recently created) will be used in its place. For additional
1731
+ info, see | quickfix-stack | .
1732
+
1720
1733
*'cindent'* *'cin'* *'nocindent'* *'nocin'*
1721
1734
'cindent' 'cin' boolean (default off)
1722
1735
local to buffer
@@ -2655,7 +2668,7 @@ A jump table for the options with a short description can be found at |Q_op|.
2655
2668
*E1193* *E1194* *E1195* *E1196* *E1230*
2656
2669
*E1197* *E1198* *E1199* *E1200* *E1201*
2657
2670
xchacha20 XChaCha20 Cipher with Poly1305 Message Authentication
2658
- Code. Medium strong till strong encryption.
2671
+ Code. Medium strong to strong encryption.
2659
2672
Encryption is provided by the libsodium library, it
2660
2673
requires Vim to be built with | +sodium | .
2661
2674
It adds a seed and a message authentication code (MAC)
@@ -2910,7 +2923,8 @@ A jump table for the options with a short description can be found at |Q_op|.
2910
2923
security reasons.
2911
2924
2912
2925
*'dip'* *'diffopt'*
2913
- 'diffopt' 'dip' string (default "internal,filler,closeoff")
2926
+ 'diffopt' 'dip' string (default
2927
+ "internal,filler,closeoff,inline:simple")
2914
2928
global
2915
2929
{not available when compiled without the | +diff |
2916
2930
feature}
@@ -2975,6 +2989,24 @@ A jump table for the options with a short description can be found at |Q_op|.
2975
2989
Use the indent heuristic for the internal
2976
2990
diff library.
2977
2991
2992
+ inline:{text} Highlight inline differences within a change.
2993
+ See | view-diffs | . Supported values are:
2994
+
2995
+ none Do not perform inline highlighting.
2996
+ simple Highlight from first different
2997
+ character to the last one in each
2998
+ line. This is the default if no
2999
+ `inline:` value is set.
3000
+ char Use internal diff to perform a
3001
+ character-wise diff and highlight the
3002
+ difference.
3003
+ word Use internal diff to perform a
3004
+ | word | -wise diff and highlight the
3005
+ difference. Non-alphanumeric
3006
+ multi-byte characters such as emoji
3007
+ and CJK characters are considered
3008
+ individual words.
3009
+
2978
3010
internal Use the internal diff library. This is
2979
3011
ignored when 'diffexpr' is set. *E960*
2980
3012
When running out of memory when writing a
@@ -3571,8 +3603,8 @@ A jump table for the options with a short description can be found at |Q_op|.
3571
3603
*'fillchars'* *'fcs'*
3572
3604
'fillchars' 'fcs' string (default "vert:|,fold:-,eob:~,lastline:@")
3573
3605
global or local to window | global-local |
3574
- Characters to fill the statuslines, vertical separators and special
3575
- lines in the window.
3606
+ Characters to fill the statuslines, vertical separators, special
3607
+ lines in the window and truncated text in the | ins-completion-menu | .
3576
3608
It is a comma-separated list of items. Each item has a name, a colon
3577
3609
and the value of that item: | E1511 |
3578
3610
@@ -3587,6 +3619,8 @@ A jump table for the options with a short description can be found at |Q_op|.
3587
3619
diff '-' deleted lines of the 'diff' option
3588
3620
eob '~' empty lines below the end of a buffer
3589
3621
lastline '@' 'display' contains lastline/truncate
3622
+ trunc '>' truncated text in the
3623
+ | ins-completion-menu | .
3590
3624
3591
3625
Any one that is omitted will fall back to the default.
3592
3626
@@ -3603,9 +3637,14 @@ A jump table for the options with a short description can be found at |Q_op|.
3603
3637
stlnc StatusLineNC | hl-StatusLineNC |
3604
3638
vert VertSplit | hl-VertSplit |
3605
3639
fold Folded | hl-Folded |
3640
+ foldopen FoldColumn | hl-FoldColumn |
3641
+ foldclose FoldColumn | hl-FoldColumn |
3642
+ foldsep FoldColumn | hl-FoldColumn |
3606
3643
diff DiffDelete | hl-DiffDelete |
3607
3644
eob EndOfBuffer | hl-EndOfBuffer |
3608
3645
lastline NonText | hl-NonText |
3646
+ trunc one of the many Popup menu highlighting groups like
3647
+ | hl-PmenuSel |
3609
3648
3610
3649
*'findfunc'* *'ffu'* *E1514*
3611
3650
'findfunc' 'ffu' string (default empty)
@@ -4392,10 +4431,10 @@ A jump table for the options with a short description can be found at |Q_op|.
4392
4431
v:Visual,V:VisualNOS,w:WarningMsg,
4393
4432
W:WildMenu,f:Folded,F:FoldColumn,
4394
4433
A:DiffAdd,C:DiffChange,D:DiffDelete,
4395
- T:DiffText,>:SignColumn,-:Conceal ,
4396
- B:SpellBad,P:SpellCap,R:SpellRare ,
4397
- L:SpellLocal,+:Pmenu,=:PmenuSel ,
4398
- k:PmenuMatch,<:PmenuMatchSel,
4434
+ T:DiffText,E:DiffTextAdd,>:SignColumn ,
4435
+ -:Conceal, B:SpellBad,P:SpellCap,
4436
+ R:SpellRare, L:SpellLocal,+:Pmenu,
4437
+ =:PmenuSel, k:PmenuMatch,<:PmenuMatchSel,
4399
4438
[:PmenuKind,]:PmenuKindSel,
4400
4439
{:PmenuExtra,} :PmenuExtraSel,
4401
4440
x:PmenuSbar,X:PmenuThumb,*:TabLine,
@@ -4447,7 +4486,8 @@ A jump table for the options with a short description can be found at |Q_op|.
4447
4486
| hl-DiffAdd | A added line in diff mode
4448
4487
| hl-DiffChange | C changed line in diff mode
4449
4488
| hl-DiffDelete | D deleted line in diff mode
4450
- | hl-DiffText | T inserted text in diff mode
4489
+ | hl-DiffText | T changed text in diff mode
4490
+ | hl-DiffTextAdd | E inserted text in diff mode
4451
4491
| hl-SignColumn | > column used for | signs |
4452
4492
| hl-Conceal | - the placeholders used for concealed characters
4453
4493
(see 'conceallevel' )
@@ -5296,6 +5336,18 @@ A jump table for the options with a short description can be found at |Q_op|.
5296
5336
temporarily when performing an operation where redrawing may cause
5297
5337
flickering or cause a slowdown.
5298
5338
5339
+ *'lhistory'* *'lhi'*
5340
+ 'lhistory' 'lhi' number (default: 10)
5341
+ local to window
5342
+ {only available when compiled with the | +quickfix |
5343
+ feature}
5344
+ Like 'chistory' , but for the location list stack associated with a
5345
+ window. If the option is changed in either the location list window
5346
+ itself or the window that is associated with the location list stack,
5347
+ the new value will also be applied to the other one. This means this
5348
+ value will always be the same for a given location list window and its
5349
+ corresponding window. See | quickfix-stack | for additional info.
5350
+
5299
5351
*'linebreak'* *'lbr'* *'nolinebreak'* *'nolbr'*
5300
5352
'linebreak' 'lbr' boolean (default off)
5301
5353
local to window
@@ -6459,6 +6511,17 @@ A jump table for the options with a short description can be found at |Q_op|.
6459
6511
global
6460
6512
Determines the maximum number of items to show in the popup menu for
6461
6513
Insert mode completion. When zero as much space as available is used.
6514
+ | ins-completion-menu | .
6515
+
6516
+ *'pummaxwidth'* *'pmw'*
6517
+ 'pummaxwidth' 'pmw' number (default 0)
6518
+ global
6519
+ Determines the maximum width to use for the popup menu for completion.
6520
+ When zero, there is no maximum width limit, otherwise the popup menu
6521
+ will never be wider than this value. Truncated text will be indicated
6522
+ by "trunc" value of 'fillchars' option.
6523
+
6524
+ This option takes precedence over 'pumwidth' .
6462
6525
| ins-completion-menu | .
6463
6526
6464
6527
*'pumwidth'* *'pw'*
0 commit comments