Skip to content

Commit edbf055

Browse files
committed
missing .txt file
1 parent 6e1f726 commit edbf055

File tree

1 file changed

+90
-21
lines changed

1 file changed

+90
-21
lines changed

en/options.txt

Lines changed: 90 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
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

Comments
 (0)