diff options
| author | zeertzjq <zeertzjq@outlook.com> | 2024-09-08 05:41:44 +0800 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-09-08 05:41:44 +0800 |
| commit | b40ec083ae30eb64ddfec2b238c909116e936e99 (patch) | |
| tree | 0043b1f4c36bb212e43cec1d730ba17bc6ece6e5 | |
| parent | d338ec9cb299ca300e732da643616121361006cf (diff) | |
| download | rneovim-b40ec083ae30eb64ddfec2b238c909116e936e99.tar.gz rneovim-b40ec083ae30eb64ddfec2b238c909116e936e99.tar.bz2 rneovim-b40ec083ae30eb64ddfec2b238c909116e936e99.zip | |
vim-patch:b584117: runtime(doc): buffers can be re-used (#30300)
while at it, also move the note about :wincmd
directly to :h :wincmd, it doesn't seem to belong to the buffer section.
closes: vim/vim#15636
https://github.com/vim/vim/commit/b584117b05790cc95628af79e874fb58bbcc2cb7
Co-authored-by: Christian Brabandt <cb@256bit.org>
| -rw-r--r-- | runtime/doc/windows.txt | 17 |
1 files changed, 12 insertions, 5 deletions
diff --git a/runtime/doc/windows.txt b/runtime/doc/windows.txt index 840d8b51af..35e5506efa 100644 --- a/runtime/doc/windows.txt +++ b/runtime/doc/windows.txt @@ -53,11 +53,17 @@ active yes yes 'a' hidden no yes 'h' inactive no no ' ' -Note: All CTRL-W commands can also be executed with |:wincmd|, for those -places where a Normal mode command can't be used or is inconvenient. + *buffer-reuse* +Each buffer has a unique number and the number will not change within a Vim +session. The |bufnr()| and |bufname()| functions can be used to convert +between a buffer name and the buffer number. There is one exception: if a new +empty buffer is created and it is not modified, the buffer will be re-used +when loading another file into that buffer. This also means the buffer number +will not change. The main Vim window can hold several split windows. There are also tab pages |tab-page|, each of which can hold multiple windows. + *window-ID* *winid* *windowid* Each window has a unique identifier called the window ID. This identifier will not change within a Vim session. The |win_getid()| and |win_id2tabwin()| @@ -69,9 +75,6 @@ across tabs. For most functions that take a window ID or a window number, the window number only applies to the current tab, while the window ID can refer to a window in any tab. -Each buffer has a unique number and the number will not change within a Vim -session. The |bufnr()| and |bufname()| functions can be used to convert -between a buffer name and the buffer number. ============================================================================== 2. Starting Vim *windows-starting* @@ -468,6 +471,10 @@ These commands can also be executed with ":wincmd": :exe nr .. "wincmd w" < This goes to window "nr". +Note: All CTRL-W commands can also be executed with |:wincmd|, for those +places where a Normal mode command can't be used or is inconvenient (e.g. +in a browser-based terminal). + ============================================================================== 5. Moving windows around *window-moving* |