vim-patch:6800da6: runtime(doc): Add missing optional tail command-name specs (#36140)

- Use the optional tail command-name specs at help entries for :keepalt,
  :lcd, :cfdo, :lfdo, :wundo, :rundo, :bdelete and :bunload.
- Add missing shortname tags.

closes: vim/vim#18547

6800da6ff1

Co-authored-by: Doug Kearns <dougkearns@gmail.com>
This commit is contained in:
zeertzjq
2025-10-12 07:41:13 +08:00
committed by GitHub
parent b261515775
commit bc2fe135d1
4 changed files with 24 additions and 19 deletions

View File

@@ -30,8 +30,8 @@ the |CTRL-^| command to toggle between the current and the alternate file.
However, the alternate file name is not changed when |:keepalt| is used. However, the alternate file name is not changed when |:keepalt| is used.
An alternate file name is remembered for each window. An alternate file name is remembered for each window.
*:keepalt* *:keepa* *:keepa* *:keepalt*
:keepalt {cmd} Execute {cmd} while keeping the current alternate file :keepa[lt] {cmd} Execute {cmd} while keeping the current alternate file
name. Note that commands invoked indirectly (e.g., name. Note that commands invoked indirectly (e.g.,
with a function) may still set the alternate file with a function) may still set the alternate file
name. name.

View File

@@ -540,8 +540,8 @@ EXECUTE A COMMAND IN ALL THE BUFFERS IN QUICKFIX OR LOCATION LIST:
Also see |:bufdo|, |:tabdo|, |:argdo|, |:windo|, Also see |:bufdo|, |:tabdo|, |:argdo|, |:windo|,
|:ldo|, |:cfdo| and |:lfdo|. |:ldo|, |:cfdo| and |:lfdo|.
*:cfdo* *:cfd* *:cfdo*
:cfdo[!] {cmd} Execute {cmd} in each file in the quickfix list. :cfd[o][!] {cmd} Execute {cmd} in each file in the quickfix list.
It works like doing this: > It works like doing this: >
:cfirst :cfirst
:{cmd} :{cmd}
@@ -550,7 +550,7 @@ EXECUTE A COMMAND IN ALL THE BUFFERS IN QUICKFIX OR LOCATION LIST:
etc. etc.
< Otherwise it works the same as `:cdo`. < Otherwise it works the same as `:cdo`.
*:ldo* *:ld* *:ldo*
:ld[o][!] {cmd} Execute {cmd} in each valid entry in the location list :ld[o][!] {cmd} Execute {cmd} in each valid entry in the location list
for the current window. for the current window.
It works like doing this: > It works like doing this: >
@@ -562,8 +562,8 @@ EXECUTE A COMMAND IN ALL THE BUFFERS IN QUICKFIX OR LOCATION LIST:
< Only valid entries in the location list are used. < Only valid entries in the location list are used.
Otherwise it works the same as `:cdo`. Otherwise it works the same as `:cdo`.
*:lfdo* *:lfd* *:lfdo*
:lfdo[!] {cmd} Execute {cmd} in each file in the location list for :lfd[o][!] {cmd} Execute {cmd} in each file in the location list for
the current window. the current window.
It works like doing this: > It works like doing this: >
:lfirst :lfirst

View File

@@ -270,8 +270,8 @@ they are saved to the dedicated directory in the application data folder.
You can also save and restore undo histories by using ":wundo" and ":rundo" You can also save and restore undo histories by using ":wundo" and ":rundo"
respectively: respectively:
*:wundo* *:rundo* *:wu* *:wundo*
:wundo[!] {file} :wu[ndo][!] {file}
Write undo history to {file}. Write undo history to {file}.
When {file} exists and it does not look like an undo file When {file} exists and it does not look like an undo file
(the magic number at the start of the file is wrong), then (the magic number at the start of the file is wrong), then
@@ -284,7 +284,8 @@ respectively:
name. So it is not possible to overwrite an existing undofile name. So it is not possible to overwrite an existing undofile
in a write-protected directory. in a write-protected directory.
:rundo {file} Read undo history from {file}. *:rund* *:rundo*
:rund[o] {file} Read undo history from {file}.
You can use these in autocommands to explicitly specify the name of the You can use these in autocommands to explicitly specify the name of the
history file. E.g.: > history file. E.g.: >

View File

@@ -1182,21 +1182,23 @@ list of buffers. |unlisted-buffer|
from the buffer list |unlisted-buffer| and option values, from the buffer list |unlisted-buffer| and option values,
variables and mappings/abbreviations for the buffer are variables and mappings/abbreviations for the buffer are
cleared. Examples: > cleared. Examples: >
:.,$-bdelete "delete buffers from the current one to :.,$-bdelete " delete buffers from the current one to
" last but one " last but one
:%bdelete " delete all buffers :%bdelete " delete all buffers
< <
:bdelete[!] {bufname} *E93* *E94*
:bd[elete][!] {bufname} *E93* *E94*
Like ":bdelete[!] [N]", but buffer given by name, see Like ":bdelete[!] [N]", but buffer given by name, see
|{bufname}|. |{bufname}|.
:bdelete[!] N1 N2 ... :bd[elete][!] N1 N2 ...
Do ":bdelete[!]" for buffer N1, N2, etc. The arguments can be Do ":bdelete[!]" for buffer N1, N2, etc. The arguments can be
buffer numbers or buffer names (but not buffer names that are buffer numbers or buffer names (but not buffer names that are
a number). Insert a backslash before a space in a buffer a number). Insert a backslash before a space in a buffer
name. name.
:N,Mbdelete[!] Do ":bdelete[!]" for all buffers in the range N to M :N,Mbd[elete][!]
Do ":bdelete[!]" for all buffers in the range N to M
|inclusive|. |inclusive|.
:[N]bw[ipeout][!] *:bw* *:bwipe* *:bwipeout* *E517* :[N]bw[ipeout][!] *:bw* *:bwipe* *:bwipeout* *E517*
@@ -1212,6 +1214,7 @@ list of buffers. |unlisted-buffer|
" one " one
:%bwipeout " wipe out all buffers :%bwipeout " wipe out all buffers
< <
:[N]bun[load][!] *:bun* *:bunload* *E515* :[N]bun[load][!] *:bun* *:bunload* *E515*
:bun[load][!] [N] :bun[load][!] [N]
Unload buffer [N] (default: current buffer). The memory Unload buffer [N] (default: current buffer). The memory
@@ -1224,14 +1227,15 @@ list of buffers. |unlisted-buffer|
This is the most recent entry in the jump list that points This is the most recent entry in the jump list that points
into a loaded buffer. into a loaded buffer.
:bunload[!] {bufname} :bun[load][!] {bufname}
Like ":bunload[!] [N]", but buffer given by name. Like ":bunload[!] [N]", but buffer given by name.
Also see |{bufname}|. Also see |{bufname}|.
:N,Mbunload[!] Do ":bunload[!]" for all buffers in the range N to M :N,Mbun[load][!]
Do ":bunload[!]" for all buffers in the range N to M
|inclusive|. |inclusive|.
:bunload[!] N1 N2 ... :bun[load][!] N1 N2 ...
Do ":bunload[!]" for buffer N1, N2, etc. The arguments can be Do ":bunload[!]" for buffer N1, N2, etc. The arguments can be
buffer numbers or buffer names (but not buffer names that are buffer numbers or buffer names (but not buffer names that are
a number). Insert a backslash before a space in a buffer a number). Insert a backslash before a space in a buffer