Merge branch 'master' of https://github.com/vim-jp/vimdoc-ja-working into hh-updayte-version9

Author: h-east

doc/filetype.jax

@@ -1,4 +1,4 @@
-*filetype.txt*  For Vim バージョン 9.0.  Last change: 2023 Feb 15
+*filetype.txt*  For Vim バージョン 9.0.  Last change: 2023 Sep 11
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -144,33 +144,38 @@ NOTE: Vi互換とは全てのオプションがグローバルであることを
 できる:
 
 	ファイル名	変数 ~
-	*.asa		g:filetype_asa	|ft-aspvbs-syntax| |ft-aspperl-syntax|
-	*.asm		g:asmsyntax	|ft-asm-syntax|
-	*.asp		g:filetype_asp	|ft-aspvbs-syntax| |ft-aspperl-syntax|
-	*.bas		g:filetype_bas	|ft-basic-syntax|
+	*.asa		g:filetype_asa		|ft-aspperl-syntax|
+						|ft-aspvbs-syntax|
+	*.asm		g:asmsyntax		|ft-asm-syntax|
+	*.asp		g:filetype_asp		|ft-aspperl-syntax|
+						|ft-aspvbs-syntax|
+	*.bas		g:filetype_bas		|ft-basic-syntax|
 	*.cfg		g:filetype_cfg
 	*.cls		g:filetype_cls
-	*.csh		g:filetype_csh	|ft-csh-syntax|
+	*.csh		g:filetype_csh		|ft-csh-syntax|
 	*.dat		g:filetype_dat
-	*.frm		g:filetype_frm	|ft-form-syntax|
-	*.fs		g:filetype_fs	|ft-forth-syntax|
-	*.i		g:filetype_i	|ft-progress-syntax|
+	*.f		g:filetype_f		|ft-forth-syntax|
+	*.frm		g:filetype_frm		|ft-form-syntax|
+	*.fs		g:filetype_fs		|ft-forth-syntax|
+	*.h		g:c_syntax_for_h	|ft-c-syntax|
+	*.i		g:filetype_i		|ft-progress-syntax|
 	*.inc		g:filetype_inc
 	*.lsl		g:filetype_lsl
-	*.m		g:filetype_m	|ft-mathematica-syntax|
+	*.m		g:filetype_m		|ft-mathematica-syntax|
 	*.mod		g:filetype_mod
-	*.p		g:filetype_p	|ft-pascal-syntax|
+	*.p		g:filetype_p		|ft-pascal-syntax|
 	*.pl		g:filetype_pl
-	*.pp		g:filetype_pp	|ft-pascal-syntax|
+	*.pp		g:filetype_pp		|ft-pascal-syntax|
 	*.prg		g:filetype_prg
 	*.r		g:filetype_r
 	*.sig		g:filetype_sig
-	*.sql		g:filetype_sql	|ft-sql-syntax|
+	*.sql		g:filetype_sql		|ft-sql-syntax|
 	*.src		g:filetype_src
 	*.sys		g:filetype_sys
-	*.sh		g:bash_is_sh	|ft-sh-syntax|
-	*.tex		g:tex_flavor	|ft-tex-plugin|
-	*.w		g:filetype_w	|ft-cweb-syntax|
+	*.sh		g:bash_is_sh		|ft-sh-syntax|
+	*.tex		g:tex_flavor		|ft-tex-plugin|
+	*.typ		g:filetype_typ
+	*.w		g:filetype_w		|ft-cweb-syntax|
 
 いくつかのファイル形式のグローバル変数はファイル形式を検知できなかったときのみ
 使用される:
@@ -397,15 +402,15 @@ Note: プラグインマネージャーや |packages| を使っている場合
    新しいファイル形式プラグインを作り、'runtimepath' の始めのほうに置く。一例
    として、UNIXではこのファイルを利用できる: >
 	vim ~/.vim/ftplugin/fortran.vim
-<  追加したい設定やキーマップをこのファイルに記述する。グローバルプラグインは
+<   追加したい設定やキーマップをこのファイルに記述する。グローバルプラグインは
    これの後に読み込まれるので、ここで行った設定は上書される可能性がある。その
    ような場合には以下の2つの方法のどちらかを利用する。
 
 2. プラグインのコピーを作成し、そちらを変更する。
    'runtimepath' の始めのほうにそのプラグインのコピーを置く。一例として、UNIX
    ではこのように行う: >
 	cp $VIMRUNTIME/ftplugin/fortran.vim ~/.vim/ftplugin/fortran.vim
-<  そうすればコピーしたファイルを好きなように変更できる。これは変数
+<   そうすればコピーしたファイルを好きなように変更できる。これは変数
    b:did_ftpluginが設定されていれば、グローバルプラグインは読み込まれない仕組
    みになっていることによる。
    この方法には、配布されるプラグインが改良された際に、再びコピーし同じように
@@ -415,16 +420,29 @@ Note: プラグインマネージャーや |packages| を使っている場合
    'runtimepath' の最後に、新しいファイル形式プラグインを作成する。一例として、
    UNIXではこのファイルを利用できる: >
 	vim ~/.vim/after/ftplugin/fortran.vim
-<  このファイルの中では、変更したい設定だけを変更できる。
+<   このファイルの中では、変更したい設定だけを変更できる。
 
 ==============================================================================
 3.  標準で付属する形式別プラグインの解説		*ftplugin-docs*
 
 
+					*plugin_exec* *g:plugin_exec*
+外部コマンドの実行を有効にする。これは歴史的に、例えば perl filetype プラグイ
+ン (および他のいくつかのプラグイン) の検索パスを設定するために行われていた。セ
+キュリティ上の理由から、デフォルトでは無効になっている: >
+	:let g:plugin_exec = 1
+特定のファイルタイプに対してのみ有効にすることも可能である: >
+	:let g:<filetype>_exec = 1
+したがって、これを Ruby に対してのみ有効にするには、次の変数を設定する: >
+	:let g:ruby_exec = 1
+
+グローバル `plugin_exec` と `<filetype>_exec` 固有の変数の両方が設定されている
+場合は、ファイルタイプ固有の変数が優先される必要がある。
+
 AWK							*ft-awk-plugin*
 
 @include のような、GNU Awk 固有の機能のサポートは、以下の設定で有効にできる: >
-	let g:awk_is_gawk = 1
+	:let g:awk_is_gawk = 1
 
 
 CHANGELOG						*ft-changelog-plugin*

doc/if_pyth.jax

@@ -757,9 +757,21 @@ Unix ~
 
 'pythondll' と 'pythonthreedll' オプションを、コンパイル時に
 DYNAMIC_PYTHON_DLL と DYNAMIC_PYTHON3_DLL で指定されている Python の共有ライブ
-ラリのファイルの、代わりを指定するのに使えます。共有ライブラリのバージョンは
-Vim をコンパイルする時に用いた Python 2.x または Python 3 のバージョンと一致し
-ていなければなりません。
+ラリのファイルの、代わりを指定するのに使えます。共有ライブラリのバージョンは、
+|python3-stable-abi| を使用しない限り、Vim がコンパイルされた Python 2.x また
+は Python 3 のバージョン (|v:python3_version|) と一致しなければなりません。
+
+
+Stable ABI と Python バージョンの混在 ~
+			*python-stable* *python-stable-abi* *python3-stable-abi*
+Vim が Stable ABI (Python 3 でのみ使用可能) でコンパイルされていない場合、
+Python 共有ライブラリのバージョンは Vim がコンパイルされたバージョンと一致して
+いなければなりません。そうでないと、バージョンが混在して予期せぬクラッシュや失
+敗を引き起こす可能性があります。Stable ABI ではこの制限は緩和され、少なくとも
+|v:python3_version| のバージョンを持つ Python 3 ライブラリであれば動作します。
+Stable ABI がサポートされているかどうかを確認する方法については、|has-python|
+を参照するか、バージョン出力に |+python3/dyn-stable| が含まれているかどうかを
+確認してください。
 
 ==============================================================================
 10. Python 3						*python3*
@@ -872,6 +884,19 @@ Note: Python の 2 と 3 の両方が利用可能で、Python が動的ロード
 	  endif
 	endif
 
+ライブラリを動的にロードする場合、Vim は Python 3 Stable ABI
+(|python3-stable-abi|) をサポートするようにコンパイルすることができ、Vim がコ
+ンパイルしたものとは異なるバージョンの Python 3 ライブラリをロードすることがで
+きます。確認するには: >
+	if has('python3_dynamic')
+	  if has('python3_stable')
+	    echo 'support Python 3 Stable ABI.'
+	  else
+	    echo 'does not support Python 3 Stable ABI.'
+	    echo 'only use Python 3 version ' .. v:python3_version
+	  endif
+	endif
+
 実行時ライブラリが見つからなかった場合は Python の動的ローディングは失敗します
 が、このコードは正しくロードされたかどうかを表示することにもなります。
 

doc/indent.jax

@@ -1,4 +1,4 @@
-*indent.txt*    For Vim バージョン 9.0.  Last change: 2022 May 21
+*indent.txt*    For Vim バージョン 9.0.  Last change: 2022 Oct 10
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -964,25 +964,40 @@ PHP では 'case/default' ブロックの中で波カッコは不要なので、
 
 PYTHON							*ft-python-indent*
 
-以下の状況のためにインデントの量を設定することができる。この例は既定である。
-後で 'shiftwidth' の値を変更するために変数に式を設定しておく。
+インデントの量は `g:python_indent` |Dictionary| で設定できる。これは項目を追加
+する前に作成する必要がある: >
+	let g:python_indent = {}
+示されている例はデフォルトである。Note 辞書の値は式に設定されているので、これ
+らの値を更新しなくても後で 'shiftwidth' の値を変更できることに注意。
 
 開き括弧の後のインデント: >
-	let g:pyindent_open_paren = 'shiftwidth() * 2'
+	let g:python_indent.open_paren = 'shiftwidth() * 2'
 ネストした括弧の後のインデント: >
-	let g:pyindent_nested_paren = 'shiftwidth()'
+	let g:python_indent.nested_paren = 'shiftwidth()'
 継続行のインデント: >
-	let g:pyindent_continue = 'shiftwidth() * 2'
+	let g:python_indent.continue = 'shiftwidth() * 2'
+
+デフォルトでは、複数行構成の閉じ括弧は、前の行の最初の非空白文字の下に並ぶ。
+複数行構成を開始する行の最初の文字の下に並べたい場合は、このキーをリセットする:
+>
+	let g:python_indent.closed_paren_align_last_line = v:false
 
 このメソッドは、|searchpair()| を使用して閉じられていない括弧に戻る。これは時々
 遅くなる可能性があるため、150ミリ秒後にタイムアウトする。もし、インデントが正
 しくないことに気付いた時は、より大きなタイムアウトをミリ秒で設定できる: >
-	let g:pyindent_searchpair_timeout = 500
+	let g:python_indent.searchpair_timeout = 500
 
 閉じ括弧を遡って振り返るのがまだ遅すぎる場合、特にコピー&ペースト操作の間、あ
 るいは複数行の括弧の内側をインデントする必要がない場合は、この機能を完全に無効
 にすることができる: >
-	let g:pyindent_disable_parentheses_indenting = 1
+	let g:python_indent.disable_parentheses_indenting = 1
+
+後方互換性のため、これらの変数もサポートされている: >
+	g:pyindent_open_paren
+	g:pyindent_nested_paren
+	g:pyindent_continue
+	g:pyindent_searchpair_timeout
+	g:pyindent_disable_parentheses_indenting
 
 
 R								*ft-r-indent*
@@ -1190,13 +1205,30 @@ generic/port 文の桁揃えが自動的に行われる。これによって、
 
 
 VIM							*ft-vim-indent*
+							*g:vim_indent*
+Vim script のインデントは `g:vim_indent` 辞書変数で設定できる。
+`line_continuation`、`more_in_bracket_block`、`searchpair_timeout` の 3 つの
+キーをサポートしている。
+`line_continuation` はバックスラッシュで始まる継続行のインデントレベルに追加さ
+れる数値を期待し、デフォルトは `shiftwidth() * 3` である。また、文字列も受け取
+ることができ、これは実行時に評価される。
+`more_in_bracket_block` には真偽値を指定する。オンにすると、大括弧で囲まれたブ
+ロックの中にさらに `shiftwidth()` が追加される。デフォルトは `v:false` である。
+`searchpair_timeout` はタイムアウトとして `searchpair()` に渡される数値を指定
+する。この値を大きくすると、より正確な結果が得られるかもしれないが、インデント
+に時間がかかるようになる。デフォルトは100 (ミリ秒) である。
+
+構成例: >
+
+	let g:vim_indent = #{
+	    \ line_continuation: shiftwidth() * 3,
+	    \ more_in_bracket_block: v:false,
+	    \ searchpair_timeout: 100,
+	    \ }
+<
 							*g:vim_indent_cont*
-Vim script に対しては継続行(バックスラッシュで始まる行)のインデント量を指定
-する変数が1つある: >
-
-	:let g:vim_indent_cont = shiftwidth() * 3
-
-shiftwidth の 3 倍が既定値である。
+この変数は `g:vim_indent.line_continuation` と等価である。
+後方互換性のためにサポートされている。
 
 
  vim:tw=78:ts=8:noet:ft=help:norl:

doc/intro.jax

@@ -1,4 +1,4 @@
-*intro.txt*     For Vim バージョン 9.0.  Last change: 2022 Nov 20
+*intro.txt*     For Vim バージョン 9.0.  Last change: 2023 Aug 15
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -126,9 +126,10 @@ http://www.vim.org/maillist.php
    文章は vim-dev メーリングリストにも転送されます。
 3. バグレポートは Vim 開発陣 <[email protected]> に送ってください。
    これはメーリングリストです。最初にメンバーになる必要があります。たくさんの
-   人がそのメッセージを見ます。それが不都合な場合は (例えばセキュリティ関係)、
-   <[email protected]> に送ってください。そのメッセージは Vim のメンテナー (Bram)
-   だけに送信されます。
+   人がそのメッセージを見ます。もしセキュリティ上の問題などの理由でそれを望ま
+   ないのであれば、現在の Vim メンテナー https://github.com/orgs/vim/people
+   (ただし、Bram や vim-dev ML は除く) の誰かに連絡してください。将来的には、
+   セキュリティの問題を扱うための適切なプロセスが設定されるでしょう。
 
 メッセージは簡潔にお願いします。メールに回答する時間は、Vim を改良する時間から
 消費されています! 常に再現可能な例をつけてください。そして、バグを引き起こす設
@@ -180,9 +181,10 @@ Vim の strftime() 関数は strftime() システムコールを直接使いま
 Y2K 問題を招くかもしれませんが、Vim 自身の問題ではありません。
 
 ==============================================================================
-3. クレジット				*credits* *author* *Bram* *Moolenaar*
+3. クレジット						*credits* *author*
 
-Vim の大部分は Bram Moolenaar<[email protected]> によって作成されました。
+Vim の大部分は Bram Moolenaar <[email protected]> |Bram-Moolenaar| によって作成され
+ました。
 
 ドキュメントの一部は以下の方々によって書かれた Vi のマニュアルによります:
 	W.N. Joy
@@ -214,9 +216,10 @@ Vim エディタは Stevie をベースにしており、下記の方々のソ
 	Eric Fischer		Macへの移植、'cindent'、その他の改良
 	Benji Fisher		たくさんのユーザーの質問に答えてくれた
 	Bill Foster		Athena GUIへの移植 (後で削除)
-	Google			週に一日 Vim の仕事をさせてくれる
+	Google			Bram に週に一日 Vim の仕事をさせてくれる
 	Loic Grenie		xvim (マルチウィンドウバージョンのアイデア)
 	Sven Guckes		Vimのプロモーター、以前のWWWページ管理者
+				|Sven-Guckes|
 	Darren Hiebert		Exuberant ctags
 	Jason Hildebrand	GTK+ 2 への移植
 	Bruce Hunsaker		VMSへの移植版の改良

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*
 グローバルプラグインを追加すると、いつでもその機能を使えるようになります。