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
22
33
44 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|.
17851785 for X-windows, "" otherwise)
17861786 global
17871787 {only in GUI versions or when the | +xterm_clipboard |
1788- feature is included}
1788+ or | +wayland_clipboard | features are included}
17891789 This option is a list of comma-separated names.
17901790 Note: if one of the items is "exclude:", then you can't add an item
17911791 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|.
18101810 register '*' for all yank, delete, change and put
18111811 operations which would normally go to the unnamed
18121812 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')
18191821<
18201822 *clipboard-autoselect*
18211823 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|.
18521854 exclude:{pattern}
18531855 Defines a pattern that is matched against the name of
18541856 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:
18571859 - 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: >
18631867 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.
18651870 Note that when there is no connection to the X server
18661871 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.
18681874 The value of 'magic' is ignored, {pattern} is
18691875 interpreted as if 'magic' was on.
18701876 The rest of the option value will be used for
18711877 {pattern} , this must be the last entry.
18721878
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+
18731905 *'cmdheight'* *'ch'*
18741906'cmdheight' 'ch' number (default 1)
18751907 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|.
45864618 | hl-Title | t Titles for output from ":set all", ":autocmd" etc.
45874619 | hl-VertSplit | c column used to separate vertically split windows
45884620 | 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 |
45924624 | hl-WarningMsg | w warning messages
45934625 | hl-WildMenu | W wildcard matches displayed for 'wildmenu'
45944626 | 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|.
97209752 :set wc=X
97219753 :set wc=^I
97229754 :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
97249759 set and to the Vim default value when 'compatible' is reset.
97259760
97269761 *'wildcharm'* *'wcm'*
@@ -10043,6 +10078,40 @@ A jump table for the options with a short description can be found at |Q_op|.
1004310078 'winwidth' applies to the current window. Use 'winminwidth' to set
1004410079 the minimal width for other windows.
1004510080
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+
1004610115 *'wrap'* *'nowrap'*
1004710116'wrap' boolean (default on)
1004810117 local to window
0 commit comments