Commit: runtime(doc): make window option description a bit less vague

0 views
Skip to first unread message

Christian Brabandt

unread,
Apr 17, 2026, 11:00:16 AM (23 hours ago) Apr 17
to vim...@googlegroups.com
runtime(doc): make window option description a bit less vague

Commit: https://github.com/vim/vim/commit/e666597622a4f75e36375a7a8ff500799d4b5fa9
Author: zeertzjq <zeer...@outlook.com>
Date: Fri Apr 17 14:51:53 2026 +0000

runtime(doc): make window option description a bit less vague

Say explicitly that ":setlocal" sets the local value, while ":set" also
sets the global value.

related: #19993

Signed-off-by: zeertzjq <zeer...@outlook.com>
Signed-off-by: Christian Brabandt <c...@256bit.org>

diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 62d7ef8df..2670535fb 100644
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -1,4 +1,4 @@
-*options.txt* For Vim version 9.2. Last change: 2026 Apr 16
+*options.txt* For Vim version 9.2. Last change: 2026 Apr 17


VIM REFERENCE MANUAL by Bram Moolenaar
@@ -324,12 +324,12 @@ that was last closed are used again. If this buffer has been edited in this
window, the values from back then are used. Otherwise the values from the
last closed window where the buffer was edited last are used.

-It's possible to set a local window option specifically for a type of buffer.
-When you edit another buffer in the same window, you don't want to keep
-using these local window options. Therefore Vim keeps a global value of the
-local window options, which is used when editing another buffer. Each window
-has its own copy of these values. Thus these are local to the window, but
-global to all buffers in the window. With this you can do: >
+":setlocal" can be used to set a local window option specifically for a type
+of buffer. When you edit another buffer in the same window, you don't want to
+keep using these local window options. Meanwhile ":set" also sets a global
+value of a local window option, which is used when editing another buffer.
+Each window has its own copy of these global values, making them local to the
+window, but global to all buffers in the window. With this you can do: >
:e one
:set list
:e two
Reply all
Reply to author
Forward
0 new messages