Merge pull request #1716 from vim-jp/hh-update-pi_getscript

Update pi_getscript.{txt,jax}

Author: h-east

doc/pi_getscript.jax

@@ -1,8 +1,8 @@
-*pi_getscript.txt*  For Vim バージョン 9.1.  Last change: 2024 Sep 08
+*pi_getscript.txt*  For Vim バージョン 9.1.  Last change: 2024 Oct 05
 >
 		GETSCRIPT REFERENCE MANUAL  by Charles E. Campbell
 <
-Author:  Charles E. Campbell  <[email protected]>
+Original Author:  Charles E. Campbell  <[email protected]>
 	 (メールアドレスから NOSPAM を削除してください)
 						*GetLatestVimScripts-copyright*
 Copyright: (c) 2004-2012 by Charles E. Campbell	*glvs-copyright*
@@ -267,19 +267,19 @@ GetLatestVimScripts には自動インストール機能があります。スク
 
 	let g:GetLatestVimScripts_allowautoinstall= 0
 <
-:AutoInstall: が有効になっている場合 (初期設定)、次のような拡張子のファイルが
-自動インストール可能です:
+:AutoInstall: が有効になっている場合 (デフォルト)、次のような拡張子のファイル
+が自動インストール可能です:
 
 	---.tar.bz2  : 伸長して .vim/ ディレクトリに展開
 	---.vba.bz2  : 伸長して .vim/ ディレクトリにコピー、vimball で処理
-	---.vmb.bz2  : 伸長して .vim/ ディレクトリにコピー、vimball で処理
+	---.vmb.bz2  : 同上
 	---.vim.bz2  : 伸長して .vim/plugin ディレクトリにコピー
 	---.tar.gz   : 伸長して .vim/ 展開
 	---.vba.gz   : 伸長して .vim/ ディレクトリにコピー、vimball で処理
-	---.vmb.gz   : 伸長して .vim/ ディレクトリにコピー、vimball で処理
+	---.vmb.gz   : 同上
 	---.vim.gz   : 伸長して .vim/plugin ディレクトリにコピー
 	---.vba      : .vim/ ディレクトリにコピー、vimball で処理
-	---.vmb      : .vim/ ディレクトリにコピー、vimball で処理
+	---.vmb      : 同上
 	---.vim      : .vim/plugin ディレクトリにコピー
 	---.zip      : .vim/ ディレクトリに展開
 
@@ -314,39 +314,63 @@ after/syntax/c/ ディレクトリを使えるようにしています:
 7. GetLatestVimScripts オプション				*glvs-options*
 >
 	g:GetLatestVimScripts_wget
-<	初期設定: "wget"
+<	デフォルト= "wget"
 		スクリプトをダウンロードするのに使われるプログラム。
 >
 	g:GetLatestVimScripts_options
-<	初期設定: "-q -O"
+<	デフォルト= "-q -O"
 		g:GetLatestVimScripts_wget に設定されたプログラムの起動引数。
 >
 	g:GetLatestVimScripts_allowautoinstall
-<	初期設定: 1
+<	デフォルト= 1
 		スクリプトの自動インストールを許可するかどうかの設定。自動イン
 		ストールはプラグインの作者によってそのプラグインが自動インス
 		トール可能であることが明示されている必要があります (それには
 		:AutoInstall: キーワードを GetLatestVimScripts コメント行に指
 		定します)。
 >
 	g:GetLatestVimScripts_autoinstalldir
-<	初期設定= $HOME/.vim     (linux)
-	初期設定= $HOME/vimfiles (windows)
+<	デフォルト= $HOME/.vim     (linux)
+	デフォルト= $HOME/vimfiles (windows)
 		自動インストールスクリプト (:AutoInstall:) のインストール先を
 		変更できます。
 		vimball のインストールには適用されません。
 >
 	g:GetLatestVimScripts_scriptaddr
-<        初期設定='https://www.vim.org/scripts/script.php?script_id='
+<        デフォルト='https://www.vim.org/scripts/script.php?script_id='
 		あなたのシステムで設定が必要な場合に上書きしてください。
 	  ...  ='http://vim.sourceforge.net/script.php?script_id='
 >
 	g:GetLatestVimScripts_downloadaddr
-<        初期設定='https://www.vim.org/scripts/download_script.php?src_id='
+<        デフォルト='https://www.vim.org/scripts/download_script.php?src_id='
 		あなたのシステムで設定が必要な場合に上書きしてください。
 	  ...  ='http://vim.sourceforge.net/scripts/download_script.php?src_id='
 >
-
+	g:GetLatestVimScripts_bunzip2
+<        デフォルト= bunzip2
+		この変数は .bz2 ファイルを解凍するコマンド名を保持します。
+>
+	g:GetLatestVimScripts_gunzip
+<        デフォルト= gunzip
+		この変数は .bz ファイルを解凍するコマンド名を保持します。
+>
+	g:GetLatestVimScripts_unxz
+<        デフォルト= unxz
+		この変数は .xz ファイルを解凍するコマンド名を保持します。
+>
+	g:GetLatestVimScripts_unzip
+<        デフォルト= unzip
+		この変数は .zip ファイルを解凍するコマンド名を保持します。
+
+Note: 解凍コマンドに関連付けられた変数は、クロスプラットフォームの問題を回避す
+るのに役立ちます。例えば、Windows では、以下のようにしてこの呼び出しを `wsl`
+に委任できます: >
+
+	let g:GetLatestVimScripts_bunzip2= "wsl -e bunzip2"
+	let g:GetLatestVimScripts_gunzip= "wsl -e gunzip"
+	let g:GetLatestVimScripts_unxz= "wsl -e unxz"
+	let g:GetLatestVimScripts_unzip= "wsl -e unzip"
+<
 ==============================================================================
 8. GetLatestVimScripts アルゴリズム		*glvs-algorithm* *glvs-alg*
 
@@ -382,6 +406,11 @@ scriptname を更新します。
 ==============================================================================
 9. GetLatestVimScripts 開発履歴		*getscript-history* *glvs-hist* {{{1
 
+v37 Sep 23, 2024 : * Support for the new vimball's .vmb extension (old .vba
+		     extension conflicted with visual basic).
+		   * Support for |glvs-autoinstall| in ftplugins and packages.
+		   * Allow platform driven customization of decompressing
+		     commands.
 v36 Apr 22, 2013 : * (glts) suggested use of plugin/**/*.vim instead of
 		     plugin/*.vim in globpath() call.
 		   * (Andy Wokula) got warning message when setting

en/pi_getscript.txt

@@ -1,8 +1,8 @@
-*pi_getscript.txt*  For Vim version 9.1.  Last change: 2024 Sep 08
+*pi_getscript.txt*  For Vim version 9.1.  Last change: 2024 Oct 05
 >
 		GETSCRIPT REFERENCE MANUAL  by Charles E. Campbell
 <
-Author:  Charles E. Campbell  <[email protected]>
+Original Author:  Charles E. Campbell  <[email protected]>
 	 (remove NOSPAM from the email address)
 						*GetLatestVimScripts-copyright*
 Copyright: (c) 2004-2012 by Charles E. Campbell	*glvs-copyright*
@@ -281,14 +281,14 @@ With :AutoInstall: enabled, as it is by default, files which end with
 
 	---.tar.bz2  : decompressed & untarred in .vim/ directory
 	---.vba.bz2  : decompressed in .vim/ directory, then vimball handles it
-	---.vmb.bz2  : decompressed in .vim/ directory, then vimball handles it
+	---.vmb.bz2  : idem
 	---.vim.bz2  : decompressed & moved into .vim/plugin directory
 	---.tar.gz   : decompressed & untarred in .vim/ directory
 	---.vba.gz   : decompressed in .vim/ directory, then vimball handles it
-	---.vmb.gz   : decompressed in .vim/ directory, then vimball handles it
+	---.vmb.gz   : idem
 	---.vim.gz   : decompressed & moved into .vim/plugin directory
 	---.vba      : moved to .vim/ directory, then vimball handles it
-	---.vmb      : moved to .vim/ directory, then vimball handles it
+	---.vmb      : idem
 	---.vim      : moved to .vim/plugin directory
 	---.zip      : unzipped in .vim/ directory
 
@@ -357,6 +357,35 @@ after/syntax/c.vim contained in it to overwrite a user's c.vim.
 		Override this if your system needs
 	  ...  ='http://vim.sourceforge.net/scripts/download_script.php?src_id='
 >
+	g:GetLatestVimScripts_bunzip2
+<        default= bunzip2
+		This variable holds the name of the command to decompress .bz2
+		files
+>
+	g:GetLatestVimScripts_gunzip
+<        default= gunzip
+		This variable holds the name of the command to decompress .gz
+		files
+>
+	g:GetLatestVimScripts_unxz
+<        default= unxz
+		This variable holds the name of the command to decompress .xz
+		files
+>
+	g:GetLatestVimScripts_unzip
+<        default= unzip
+		This variable holds the name of the command to decompress .zip
+		files
+
+Note: The variables associated with decompression commands help workaround
+      crossplatform issues. For example, on Windows is possible to delegate this
+      calls into `wsl` by doing: >
+
+	let g:GetLatestVimScripts_bunzip2= "wsl -e bunzip2"
+	let g:GetLatestVimScripts_gunzip= "wsl -e gunzip"
+	let g:GetLatestVimScripts_unxz= "wsl -e unxz"
+	let g:GetLatestVimScripts_unzip= "wsl -e unzip"
+<
 ==============================================================================
 8. GetLatestVimScripts Algorithm		*glvs-algorithm* *glvs-alg*
 
@@ -393,6 +422,11 @@ The AutoInstall process will:
 ==============================================================================
 9. GetLatestVimScripts History		*getscript-history* *glvs-hist* {{{1
 
+v37 Sep 23, 2024 : * Support for the new vimball's .vmb extension (old .vba
+		     extension conflicted with visual basic).
+		   * Support for |glvs-autoinstall| in ftplugins and packages.
+		   * Allow platform driven customization of decompressing
+		     commands.
 v36 Apr 22, 2013 : * (glts) suggested use of plugin/**/*.vim instead of
 		     plugin/*.vim in globpath() call.
 		   * (Andy Wokula) got warning message when setting