mirrors/neovim
1
0
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2025-09-06 03:18:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

vim-patch:f18987c: runtime(doc): clarify the use of filters and external commands (#31185)

Browse Source 
related: vim/vim#16044

f18987caa5

Co-authored-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
zeertzjq
2024-11-13 07:38:59 +08:00
committed by GitHub
parent 1643c49514
commit 1128d75550
3 changed files with 8 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
runtime/doc/change.txt
View File

@@ -561,6 +561,8 @@ with ".". Vim does not recognize a comment (starting with '"') after the
program {filter} (for {Visual} see |Visual-mode|). program {filter} (for {Visual} see |Visual-mode|).
:{range}![!]{filter} [!][arg] *:range!* :{range}![!]{filter} [!][arg] *:range!*
For executing external commands see |:!|
Filter {range} lines through the external program Filter {range} lines through the external program
{filter}. Vim replaces the optional bangs with the {filter}. Vim replaces the optional bangs with the
latest given command and appends the optional [arg]. latest given command and appends the optional [arg].

5
runtime/doc/usr_10.txt
View File

@@ -736,6 +736,11 @@ The "!!" command filters the current line through a filter. In Unix the "date"
command prints the current time and date. "!!date<Enter>" replaces the current command prints the current time and date. "!!date<Enter>" replaces the current
line with the output of "date". This is useful to add a timestamp to a file. line with the output of "date". This is useful to add a timestamp to a file.
Note: There is a difference between "!cmd" (e.g. using it without any file
range) and "{range}!cmd". While the former will simply execute the external
command and Vim will show the output, the latter will filter {range}lines
through the filter and replace that range by the result of the filter command.
See |:!| and |:range!| for details.
WHEN IT DOESN'T WORK WHEN IT DOESN'T WORK

1
runtime/doc/various.txt
View File

@@ -267,6 +267,7 @@ gx Opens the current filepath or URL (decided by
< <
*:!cmd* *:!* *:!cmd* *:!*
:!{cmd} Execute {cmd} with 'shell'. See also |:terminal|. :!{cmd} Execute {cmd} with 'shell'. See also |:terminal|.
For the filter command, see |:range!|.
The command runs in a non-interactive shell connected The command runs in a non-interactive shell connected
to a pipe (not a terminal). Use |:terminal| to run an to a pipe (not a terminal). Use |:terminal| to run an