Merge pull request #1546 from vim-jp/hh-update-if_pyth

Update if_pyth.{txt,jax}

Author: h-east

doc/if_pyth.jax

@@ -1,4 +1,4 @@
-*if_pyth.txt*   For Vim バージョン 9.1.  Last change: 2023 Oct 25
+*if_pyth.txt*   For Vim バージョン 9.1.  Last change: 2024 May 16
 
 
 		  VIMリファレンスマニュアル    by Paul Moore
@@ -334,7 +334,8 @@ Python では、'runtimepath' のパスのリストを使う代わりに、vim.V
 という特別なディレクトリが使われます。このディレクトリが sys.path 内で使われる
 とき、そして vim.path_hooks が sys.path_hooks 内で使われるとき、'runtimepath'
 の各パス {rtp} に対して {rtp}/python2 (or python3) と {rtp}/pythonx (両バー
-ジョンで読み込まれる) のモジュールがロードされます。
+ジョンで読み込まれる) のモジュールがロードされます (Note: find_module() は、
+Python 3.12.0a7 辺りで imp モジュールから削除されました)。
 
 実装は以下のようになっています。ただし実際は C で書かれています: >
 
@@ -394,10 +395,13 @@ vim.VIM_SPECIAL_PATH					*python-VIM_SPECIAL_PATH*
 
 vim.find_module(...)					*python-find_module*
 vim.path_hook(path)					*python-path_hook*
+vim.find_spec(...)					*python-find_spec*
 	上述のパスフックの実装に使われるメソッドとオブジェクト。sys.meta_path
 	で vim.path_hook を使って何かをするようなことがなければ、これらを直接
-	使用することはないでしょう。これらのオブジェクトが Vim の将来のバー
-	ジョンでも存在するかどうかは保証されません。
+	使用することはないでしょう。vim.find_spec() は Python 3.7 以降で使用可
+	能です。
+	これらのオブジェクトが Vim の将来のバージョンでも存在するかどうかは保
+	証されません。
 
 vim._get_paths						*python-_get_paths*
 	パスフックで検索されるパスのリストを返すメソッド。将来のバージョンのこ

en/if_pyth.txt

@@ -1,4 +1,4 @@
-*if_pyth.txt*   For Vim version 9.1.  Last change: 2023 Oct 25
+*if_pyth.txt*   For Vim version 9.1.  Last change: 2024 May 16
 
 
 		  VIM REFERENCE MANUAL    by Paul Moore
@@ -343,7 +343,8 @@ In python vim.VIM_SPECIAL_PATH special directory is used as a replacement for
 the list of paths found in 'runtimepath': with this directory in sys.path and
 vim.path_hooks in sys.path_hooks python will try to load module from
 {rtp}/python2 (or python3) and {rtp}/pythonx (for both python versions) for
-each {rtp} found in 'runtimepath'.
+each {rtp} found in 'runtimepath' (Note: find_module() has been removed from
+imp module around Python 3.12.0a7).
 
 Implementation is similar to the following, but written in C: >
 
@@ -404,10 +405,12 @@ vim.VIM_SPECIAL_PATH					*python-VIM_SPECIAL_PATH*
 
 vim.find_module(...)					*python-find_module*
 vim.path_hook(path)					*python-path_hook*
+vim.find_spec(...)					*python-find_spec*
 	Methods or objects used to implement path loading as described above.
 	You should not be using any of these directly except for vim.path_hook
-	in case you need to do something with sys.meta_path. It is not
-	guaranteed that any of the objects will exist in the future vim
+	in case you need to do something with sys.meta_path, vim.find_spec()
+	is available starting with Python 3.7.
+	It is not guaranteed that any of the objects will exist in future vim
 	versions.
 
 vim._get_paths						*python-_get_paths*