1
- *options.txt* For Vim version 9.1. Last change: 2025 Jun 18
1
+ *options.txt* For Vim version 9.1. Last change: 2025 Jun 28
2
2
3
3
4
4
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1785,7 +1785,7 @@ A jump table for the options with a short description can be found at |Q_op|.
1785
1785
for X-windows, "" otherwise)
1786
1786
global
1787
1787
{only in GUI versions or when the | +xterm_clipboard |
1788
- feature is included}
1788
+ or | +wayland_clipboard | features are included}
1789
1789
This option is a list of comma-separated names.
1790
1790
Note: if one of the items is "exclude:", then you can't add an item
1791
1791
after that. Therefore do not append an item with += but use ^= to
@@ -1810,12 +1810,14 @@ A jump table for the options with a short description can be found at |Q_op|.
1810
1810
register '*' for all yank, delete, change and put
1811
1811
operations which would normally go to the unnamed
1812
1812
register. When "unnamed" is also included to the
1813
- option, yank operations (but not delete, change or
1814
- put) will additionally copy the text into register
1815
- '*'.
1816
- Only available with the | +X11 | feature.
1817
- Availability can be checked with: >
1818
- if has('unnamedplus')
1813
+ option, yank operations (but not delete, change or put)
1814
+ will additionally copy the text into register '*'. If
1815
+ wayland is being used and the compositor does not
1816
+ support the primary-selection-unstable-v1 protocol,
1817
+ then the regular selection is used in its place. Only
1818
+ available with the | +X11 | or | +wayland_clipboard |
1819
+ feature. Availability can be checked with: >
1820
+ if has('unnamedplus')
1819
1821
<
1820
1822
*clipboard-autoselect*
1821
1823
autoselect Works like the 'a' flag in 'guioptions' : If present,
@@ -1852,24 +1854,54 @@ A jump table for the options with a short description can be found at |Q_op|.
1852
1854
exclude:{pattern}
1853
1855
Defines a pattern that is matched against the name of
1854
1856
the terminal 'term' . If there is a match, no
1855
- connection will be made to the X server. This is
1856
- useful in this situation:
1857
+ connection will be made to the X server or wayland
1858
+ compositor. This is useful in this situation:
1857
1859
- Running Vim in a console.
1858
- - $DISPLAY is set to start applications on another
1859
- display.
1860
- - You do not want to connect to the X server in the
1861
- console, but do want this in a terminal emulator.
1862
- To never connect to the X server use: >
1860
+ - $DISPLAY/$WAYLAND_DISPLAY is set to start
1861
+ applications on another display.
1862
+ - You do not want to connect to the X server/Wayland
1863
+ compositor in the console, but do want this in a
1864
+ terminal emulator.
1865
+ To never connect to the X server/Wayland compositor
1866
+ use: >
1863
1867
exclude:.*
1864
- < This has the same effect as using the | -X | argument.
1868
+ < This has the same effect as using the | -X | or | -Y |
1869
+ argument.
1865
1870
Note that when there is no connection to the X server
1866
1871
the window title won't be restored and the clipboard
1867
- cannot be accessed.
1872
+ cannot be accessed. This is the same for Wayland,
1873
+ except there is no title restoring.
1868
1874
The value of 'magic' is ignored, {pattern} is
1869
1875
interpreted as if 'magic' was on.
1870
1876
The rest of the option value will be used for
1871
1877
{pattern} , this must be the last entry.
1872
1878
1879
+ *'clipmethod'* *'cpm'*
1880
+ 'clipmethod' 'cpm' string (default for Unix: "wayland,x11",
1881
+ for VMS: "x11",
1882
+ otherwise: "")
1883
+ global
1884
+ {only when the | +xterm_clipboard | or
1885
+ | +wayland_clipboard | features are included}
1886
+ Specifies which method of accessing the system clipboard is used,
1887
+ depending on which method works first or is available. Supported
1888
+ methods are:
1889
+ wayland Wayland selections
1890
+ x11 X11 selections
1891
+
1892
+ Note: This option is ignored when either the GUI is running or if Vim
1893
+ is run on a system without wayland or X11 support, such as Windows or
1894
+ macOS. The GUI or system way of accessing the clipboard is always
1895
+ used instead.
1896
+
1897
+ The option value is a list of comma separated items. The list is
1898
+ parsed left to right in order, and the first method that Vim
1899
+ determines is available or is working is used as the actual method for
1900
+ accessing the clipboard.
1901
+
1902
+ The current method that is being used can be found in the | v:clipmethod |
1903
+ variable.
1904
+
1873
1905
*'cmdheight'* *'ch'*
1874
1906
'cmdheight' 'ch' number (default 1)
1875
1907
global or local to tab page
@@ -4586,9 +4618,9 @@ A jump table for the options with a short description can be found at |Q_op|.
4586
4618
| hl-Title | t Titles for output from ":set all", ":autocmd" etc.
4587
4619
| hl-VertSplit | c column used to separate vertically split windows
4588
4620
| hl-Visual | v Visual mode
4589
- | hl-VisualNOS | V Visual mode when Vim does is "Not Owning the
4590
- Selection" Only X11 Gui's | gui-x11 | and
4591
- | xterm-clipboard | .
4621
+ | hl-VisualNOS | V Visual mode when Vim is "Not Owning the
4622
+ Selection" Only X11 Gui's | gui-x11 | ,
4623
+ | xterm-clipboard | and | wayland-selections |
4592
4624
| hl-WarningMsg | w warning messages
4593
4625
| hl-WildMenu | W wildcard matches displayed for 'wildmenu'
4594
4626
| hl-Folded | f line used for closed folds
@@ -9720,7 +9752,10 @@ A jump table for the options with a short description can be found at |Q_op|.
9720
9752
:set wc=X
9721
9753
:set wc=^I
9722
9754
:set wc=<Tab>
9723
- < NOTE: This option is set to the Vi default value when 'compatible' is
9755
+ < 'wildchar' also enables completion in search pattern contexts such as
9756
+ | / | , | ? | , | :s | , | :g | , | :v | , and | :vim | . To insert a literal <Tab>
9757
+ instead of triggering completion, type <C-V><Tab> or "\t".
9758
+ NOTE: This option is set to the Vi default value when 'compatible' is
9724
9759
set and to the Vim default value when 'compatible' is reset.
9725
9760
9726
9761
*'wildcharm'* *'wcm'*
@@ -10043,6 +10078,40 @@ A jump table for the options with a short description can be found at |Q_op|.
10043
10078
'winwidth' applies to the current window. Use 'winminwidth' to set
10044
10079
the minimal width for other windows.
10045
10080
10081
+ *'wlseat'* *'wse'*
10082
+ 'wlseat' 'wse' string (default "")
10083
+ global
10084
+ {only when the | +wayland | feature is included}
10085
+ Specifies the Wayland seat to use for Wayland functionality,
10086
+ specifically the clipboard. If the seat does not exist, then the
10087
+ option will still be set to the new value, with the Wayland clipboard
10088
+ being unavailable as a result. If an empty value is passed then Vim
10089
+ will attempt to use the value of $XDG_SEAT if it exists, if not then
10090
+ it resorts to using the first seat found available. Updating this
10091
+ option will also update | v:clipmethod | .
10092
+
10093
+ *'wlsteal'* *'wst'* *'nowlsteal'* *'nowst'*
10094
+ 'wlsteal' 'wst' boolean (default off)
10095
+ global
10096
+ {only when the | +wayland_clipboard | feature is included}
10097
+ When enabled, then allow Vim to steal focus by creating a temporary
10098
+ surface, in order to access the clipboard. For more information see
10099
+ | wayland-focus-steal | .
10100
+
10101
+ *'wltimeoutlen'* *'wtm'*
10102
+ 'wltimeoutlen' 'wtm' number (default 500)
10103
+ global
10104
+ {only when the | +wayland | feature is included}
10105
+ The timeout in milliseconds before Vim gives up on waiting for the
10106
+ Wayland compositor. While Vim waits on the compositor, it is
10107
+ unresponsive to input and does not update the screen. Therefore
10108
+ setting this to a lower value may make Vim feel more responsive in
10109
+ some cases. On the other hand, it may also mean you receive errors
10110
+ when the compositor takes more time to respond than usual.
10111
+
10112
+ Additionally, this option is also used as the maximum timeout when
10113
+ waiting for a surface to gain focus, see | wayland-focus-steal | .
10114
+
10046
10115
*'wrap'* *'nowrap'*
10047
10116
'wrap' boolean (default on)
10048
10117
local to window
0 commit comments