Merge pull request #1332 from vim-jp/hh-update-usr_05

Update usr_05.{txt,jax}

Author: h-east

doc/usr_05.jax

@@ -1,4 +1,4 @@
-*usr_05.txt*	For Vim バージョン 9.0.  Last change: 2019 May 23
+*usr_05.txt*	For Vim バージョン 9.0.  Last change: 2023 Sep 12
 
 		     VIM USER MANUAL - by Bram Moolenaar
 
@@ -315,17 +315,27 @@ CTRL-U でアンドゥすることができます。":iunmap <C-U>" で元に戻
 
 
 				*restore-cursor* *last-position-jump*  >
-    autocmd BufReadPost *
-      \ if line("'\"") >= 1 && line("'\"") <= line("$") && &ft !~# 'commit'
-      \ |   exe "normal! g`\""
-      \ | endif
+    augroup RestoreCursor
+      autocmd!
+      autocmd BufReadPost *
+        \ let line = line("'\"")
+        \ | if line >= 1 && line <= line("$") && &filetype !~# 'commit'
+        \      && index(['xxd', 'gitrebase'], &filetype) == -1
+        \ |   execute "normal! g`\""
+        \ | endif
+    augroup END
 
 自動コマンドをもう一つ。ファイルを読み込んだ直後に実行される自動コマンドを定義
 しています。後ろのごちゃごちゃした部分は「'" マークが定義されているかどうかを
-チェックし、定義があればそこにジャンプする」という意味です。コマンドを複数行に
-分けて書くために、行頭に "\" を書いています。行がやたらと長くなるのを防ぐため
-です。|line-continuation|参照。"\" は Vim script 内でのみ使えます。コマンドラ
-インで入力するときは使えません。
+チェックし、定義があればそこにジャンプする」という意味です。コミットやリベース
+メッセージの場合は、前回とは違うメッセージになる可能性が高く、また、xxd(1) を
+使ってバイナリファイルをフィルタリングして編集を行う場合は、入力ファイルを行っ
+たり来たり変換して、いわば二面性を持っているため、このようなことは行いません。
+|using-xxd| も参照してください。
+
+コマンドを複数行に分けて書くために、行頭に "\" を書いています。行がやたらと長
+くなるのを防ぐためです。|line-continuation| 参照。"\" は Vim script 内でのみ使
+えます。コマンドラインで入力するときは使えません。
 
 >
 	command DiffOrig vert new | set bt=nofile | r ++edit # | 0d_ | diffthis
@@ -429,6 +439,16 @@ matchit プラグインを使い始めるには、以下の行をあなたの vi
 	   ここの "fancytext" はパッケージ名なので、実際には別の名前になるで
 	   しょう。
 
+editorconfig パッケージの追加				*editorconfig-install*
+
+matchit パッケージと同様に、Vim の起動時に配布されている editorconfig プラグイ
+ンを読み込むには、vimrc ファイルに以下の行を追加します: >
+	packadd! editorconfig
+
+Vim を再起動するとプラグインがアクティブになり、以下でプラグインについて読むこ
+とができます: >
+	:h editorconfig.txt
+
 パッケージについてのより詳しい情報は次の項目を参照してください: |packages|
 
 ==============================================================================
@@ -448,13 +468,18 @@ matchit プラグインを使い始めるには、以下の行をあなたの vi
 |add-filetype-plugin|をします。
 
 
-☆グローバルプラグイン					*standard-plugin*
+☆グローバルプラグイン			*standard-plugin* *distributed-plugins*
 
 Vim を起動すると、自動的にいくつものグローバルプラグインがロードされます。特に
 何もしなくて大丈夫です。グローバルプラグインは、ほとんどの人が欲しいと思うだろ
 う機能を提供しています。それらの機能は Vim の中にコンパイルして組み込まれてい
 るのではなく、Vim script として実装されています。ヘルプの目次にプラグインの一
-覧があります|standard-plugin-list|。|load-plugins|も参照してください。
+覧があります |standard-plugin-list|。
+
+ローカルにインストールされたプラグインとパッケージ (別個のヘルプファイルが付属)
+については、同様のリストがヘルプセクション |local-additions| にあります。
+
+|load-plugins|も参照してください。
 
                                                         *add-global-plugin*
 グローバルプラグインを追加すると、いつでもその機能を使えるようになります。

en/usr_05.txt

@@ -1,4 +1,4 @@
-*usr_05.txt*	For Vim version 9.0.  Last change: 2019 May 23
+*usr_05.txt*	For Vim version 9.0.  Last change: 2023 Sep 12
 
 		     VIM USER MANUAL - by Bram Moolenaar
 
@@ -308,17 +308,27 @@ This switches on three very clever mechanisms:
 
 
 				*restore-cursor* *last-position-jump*  >
-    autocmd BufReadPost *
-      \ if line("'\"") >= 1 && line("'\"") <= line("$") && &ft !~# 'commit'
-      \ |   exe "normal! g`\""
-      \ | endif
+    augroup RestoreCursor
+      autocmd!
+      autocmd BufReadPost *
+        \ let line = line("'\"")
+        \ | if line >= 1 && line <= line("$") && &filetype !~# 'commit'
+        \      && index(['xxd', 'gitrebase'], &filetype) == -1
+        \ |   execute "normal! g`\""
+        \ | endif
+    augroup END
 
 Another autocommand.  This time it is used after reading any file.  The
 complicated stuff after it checks if the '" mark is defined, and jumps to it
-if so.  The backslash at the start of a line is used to continue the command
-from the previous line.  That avoids a line getting very long.
-See |line-continuation|.  This only works in a Vim script file, not when
-typing commands at the command-line.
+if so.  It doesn't do that for a commit or rebase message, which are likely
+a different one than last time, and when using xxd(1) to filter and edit
+binary files, which transforms input files back and forth, causing them to
+have dual nature, so to speak.  See also |using-xxd|.
+
+The backslash at the start of a line is used to continue the command from the
+previous line.  That avoids a line getting very long.  See |line-continuation|.
+This only works in a Vim script file, not when typing commands at the
+command line.
 
 >
 	command DiffOrig vert new | set bt=nofile | r ++edit # | 0d_ | diffthis
@@ -417,6 +427,15 @@ an archive or as a repository.  For an archive you can follow these steps:
 	   Here "fancytext" is the name of the package, it can be anything
 	   else.
 
+Adding the editorconfig package				*editorconfig-install*
+
+Similar to the matchit package, to load the distributed editorconfig plugin
+when Vim starts, add the following line to your vimrc file: >
+	packadd! editorconfig
+
+After restarting your Vim, the plugin is active and you can read about it at: >
+	:h editorconfig.txt
+
 More information about packages can be found here: |packages|.
 
 ==============================================================================
@@ -436,13 +455,18 @@ The global plugins will be discussed first, then the filetype ones
 |add-filetype-plugin|.
 
 
-GLOBAL PLUGINS						*standard-plugin*
+GLOBAL PLUGINS				*standard-plugin* *distributed-plugins*
 
 When you start Vim, it will automatically load a number of global plugins.
 You don't have to do anything for this.  They add functionality that most
 people will want to use, but which was implemented as a Vim script instead of
 being compiled into Vim.  You can find them listed in the help index
-|standard-plugin-list|.  Also see |load-plugins|.
+|standard-plugin-list|.
+
+For locally installed plugins and packages (which come with a separated help
+file) a similar list can be found in the help section |local-additions|.
+
+Also see |load-plugins|.
 
 							*add-global-plugin*
 You can add a global plugin to add functionality that will always be present