Merge pull request #2110 from h-east/update-autocmd

Update autocmd.{txt,jax}

Author: h-east

doc/autocmd.jax

@@ -1,4 +1,4 @@
-*autocmd.txt*   For Vim バージョン 9.1.  Last change: 2025 Apr 21
+*autocmd.txt*   For Vim バージョン 9.1.  Last change: 2025 Jun 19
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -127,6 +127,10 @@ Note ":autocmd" の引数の中の特別な文字 (例えば "%" や "<cword>" 
 	:au BufNewFile,BufRead *.html so <sfile>:h/html.vim
 
 ここで <sfile> は、この行を含むファイルの名前に展開される。
+ただし、<sfile> は関数内では異なる動作をするため、同じ目的を達成するには
+<script> とともに `:execute` を使用する方が適切である: >
+>
+	:exe $'au BufNewFile,BufRead *.html so {expand("<script>:h")}/html.vim'
 
 `:autocmd` は、すでに存在しているかどうかにかかわらず、自動コマンドのリストに
 追加する。.vimrc ファイルが2回読み込まれると、自動コマンドが2回表示される。こ

en/autocmd.txt

@@ -1,4 +1,4 @@
-*autocmd.txt*   For Vim version 9.1.  Last change: 2025 Apr 21
+*autocmd.txt*   For Vim version 9.1.  Last change: 2025 Jun 19
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -130,6 +130,10 @@ exception is that "<sfile>" is expanded when the autocmd is defined.  Example:
 	:au BufNewFile,BufRead *.html so <sfile>:h/html.vim
 
 Here Vim expands <sfile> to the name of the file containing this line.
+However, <sfile> works differently in a function, in which case it's better to
+use `:execute` with <script> to achieve the same purpose:
+>
+	:exe $'au BufNewFile,BufRead *.html so {expand("<script>:h")}/html.vim'
 
 `:autocmd` adds to the list of autocommands regardless of whether they are
 already present.  When your .vimrc file is sourced twice, the autocommands