Merge pull request #1815 from h-east/update-usr_10

Update usr_10.{txt,jax}
vim-jp · Nov 14, 2024 · 3b20a05 · 3b20a05
2 parents 02d30ff + 6b555a7
commit 3b20a05
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 2 deletions.
diff --git a/doc/usr_10.jax b/doc/usr_10.jax
@@ -1,4 +1,4 @@
-*usr_10.txt*	For Vim バージョン 9.1.  Last change: 2019 Nov 22
+*usr_10.txt*	For Vim バージョン 9.1.  Last change: 2024 Nov 12
 
 		     VIM USER MANUAL - by Bram Moolenaar
 
@@ -699,6 +699,10 @@ sort コマンドはファイルの中身をソート (並べ替え) するコ
 在の日時を出力できるので、"!!date<Enter>" で現在行を "date" の出力で置き換える
 ことができます。これはファイルに日付を挿入するのに便利です。
 
+Note: "!cmd" (例: ファイル範囲なしで使用する) と "{range}!cmd" には違いがあり
+ます。前者は単に外部コマンドを実行し、Vim は出力を表示しますが、後者はフィル
+ターを通して {range} 行をフィルターし、その範囲をフィルターコマンドの結果で置
+き換えます。詳細については、|:!| および |:range!| を参照してください。
 
 ☆うまく動作しない場合
 

diff --git a/en/usr_10.txt b/en/usr_10.txt
@@ -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
 
@@ -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
 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