Merge pull request #1878 from h-east/update-pi_tutor

Update pi_tutor.{txt,jax}

Author: h-east

doc/pi_tutor.jax

@@ -1,4 +1,4 @@
-*pi_tutor.txt*    For Vim バージョン 9.1.  Last change: 2024 Nov 09
+*pi_tutor.txt*    For Vim バージョン 9.1.  Last change: 2024 Dec 17
 
 ☆Vim の対話的なチュートリアル			 *vim-tutor-mode*
 
@@ -18,20 +18,28 @@ vim-tutor-mode チュートリアルはハイパーテキストドキュメン
 1.1 コマンド
 ------------
 								      *:Tutor*
-:Tutor {tutorial}	チュートリアルを開く。{tutorial} のコマンドライン補完
-			が提供されており、候補は 'runtimepath' の 'tutor/' フォ
-			ルダにある '.tutor' ファイルのリストである。'vim-' で
-			始まるチュートリアルは常に最初に表示される。
-
-			{tutorial} が指定されていない場合、コマンドは Vim の
-			`vimtutor` に相当する 'vim-01-beginner' チュートリアル
-			を開始する。
-
+:Tutor [tutorial]	チュートリアルを開く。[tutorial] のコマンドライン補完
+			が提供されており、候補は 'runtimepath' の
+			"tutor/<lang>" フォルダにある ".tutor" ファイルのリス
+			トである。"vim-" で始まるチュートリアルは常に最初に表
+			示される。
+
+			[tutorial] が指定されていない場合、コマンドは Vim の
+			`vimtutor` チャプター 1 に相当する "vim-01-beginner"
+			チュートリアルを開始する。
+
+			可能であれば、現在のメッセージ言語に翻訳されたチュート
+			リアルを使用する (|v:lang|)。例えば、イタリア語のチュー
+			トリアルの第 1 章を開くには、以下のようにする: >
+
+			:lang it_IT.UTF-8
+			:Tutor
+<
 =============================================================================
 2. チュートリアルの作成                                      *vim-tutor-create*
 
 vim-tutor-mode チュートリアルの作成は簡単である。使用される形式の概要について
-は、'tutor.tutor' ファイルを参照: >
+は、"tutor.tutor" ファイルを参照: >
 
     :Tutor tutor
 <

en/pi_tutor.txt

@@ -1,4 +1,4 @@
-*pi_tutor.txt*    For Vim version 9.1.  Last change: 2024 Nov 09
+*pi_tutor.txt*    For Vim version 9.1.  Last change: 2024 Dec 17
 
 INTERACTIVE TUTORIALS FOR VIM			 *vim-tutor-mode*
 
@@ -16,21 +16,28 @@ by double-clicking them.
 1.1 Commands
 ------------
 								      *:Tutor*
-:Tutor {tutorial}	Opens a tutorial.  Command-line completion for
-			{tutorial} is provided, the candidates are a list of
-			'.tutor' files found in the 'tutor/'  folder in
-			the 'runtimepath'.  Tutorials prefixed with 'vim-'
+:Tutor [tutorial]	Opens a tutorial.  Command-line completion for
+			[tutorial] is provided, the candidates are a list of
+			".tutor" files found in the "tutor/<lang>/"  folder in
+			the 'runtimepath'.  Tutorials prefixed with "vim-"
 			will always be shown first.
 
-			If no {tutorial} is provided, the command starts the
-			'vim-01-beginner' tutorial, which is equivalent to
-			Vim's `vimtutor`.
+			If no [tutorial] is provided, the command starts the
+			"vim-01-beginner" tutorial, which is equivalent to
+			Vim's `vimtutor`, chapter 1.
 
+			Uses the translated tutorial for the current message
+			language if possible (|v:lang|), e.g. to open the
+			chapter 1 of the Italian tutor, use: >
+
+			:lang it_IT.UTF-8
+			:Tutor
+<
 =============================================================================
 2. Creating tutorials                                        *vim-tutor-create*
 
 Writing vim-tutor-mode tutorials is easy.  For an overview of the format used,
-please consult the 'tutor.tutor' file: >
+please consult the "tutor.tutor" file: >
 
     :Tutor tutor
 <