aniani/vim
0
0
Fork 1
mirror of https://github.com/vim/vim.git synced 2025-07-26 11:04:33 -04:00
Code

runtime(doc): clarify the use of filters and external commands

Browse Source 
related: #16044

Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Christian Brabandt 2024-11-12 21:38:22 +01:00
parent e798446362
commit f18987caa5
No known key found for this signature in database
GPG Key ID: F3F92DA383FDDE09
3 changed files with 12 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
runtime/doc/change.txt
View File

@ -1,4 +1,4 @@
*change.txt* For Vim version 9.1. Last change: 2024 Oct 07 *change.txt* For Vim version 9.1. Last change: 2024 Nov 12
VIM REFERENCE MANUAL by Bram Moolenaar VIM REFERENCE MANUAL by Bram Moolenaar
@ -586,6 +586,8 @@ comment (starting with '"') after the `:!` command.
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].

7
runtime/doc/usr_10.txt
View File

@ -1,4 +1,4 @@
*usr_10.txt* For Vim version 9.1. Last change: 2019 Nov 22 *usr_10.txt* For Vim version 9.1. Last change: 2024 Nov 12
VIM USER MANUAL - by Bram Moolenaar VIM USER MANUAL - by Bram Moolenaar
@ -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

5
runtime/doc/various.txt
View File

@ -1,4 +1,4 @@
*various.txt* For Vim version 9.1. Last change: 2024 Oct 05 *various.txt* For Vim version 9.1. Last change: 2024 Nov 12
VIM REFERENCE MANUAL by Bram Moolenaar VIM REFERENCE MANUAL by Bram Moolenaar
@ -254,7 +254,8 @@ g8 Print the hex values of the bytes used in the
*:!cmd* *:!* *:!cmd* *:!*
:!{cmd} Execute {cmd} with the shell. See also the 'shell' :!{cmd} Execute {cmd} with the shell. See also the 'shell'
and 'shelltype' option. and 'shelltype' option. For the filter command, see
|:range!|.
*E34* *E34*
Any '!' in {cmd} is replaced with the previous Any '!' in {cmd} is replaced with the previous
external command (see also 'cpoptions'). But not when external command (see also 'cpoptions'). But not when