Merge pull request #165 from vim-jp/update-for-9.1.0831

Update for 9.1.0831

Author: k-takata

Makefile

@@ -23,7 +23,8 @@ import-en-files:
 		"$(VIM_SRC_DIR)"/runtime/doc/vimtutor.1 \
 		"$(VIM_SRC_DIR)"/runtime/doc/xxd.1 \
 		runtime/doc/
-	cp "$(VIM_SRC_DIR)"/runtime/tutor/tutor runtime/tutor/
+	cp "$(VIM_SRC_DIR)"/runtime/tutor/tutor1 runtime/tutor/
+	cp "$(VIM_SRC_DIR)"/runtime/tutor/tutor2 runtime/tutor/
 	cp "$(VIM_SRC_DIR)"/nsis/lang/english.nsi nsis/lang/
 
 # Update Vim source directory.
@@ -69,7 +70,7 @@ install: test
 	cp src/po/ja.sjis.mo $(INSTALL_DIR)/lang/ja.sjis/LC_MESSAGES/vim.mo
 	cp runtime/lang/menu_ja*.vim $(INSTALL_DIR)/lang
 	cp runtime/doc/*.UTF-8.1 $(INSTALL_DIR)/doc
-	cp runtime/tutor/tutor.ja.* $(INSTALL_DIR)/tutor
+	cp runtime/tutor/tutor*.ja.* $(INSTALL_DIR)/tutor
 
 clean:
 	rm -rf $(ARCHIVE_DIR) $(ARCHIVE_FILE)
@@ -102,7 +103,7 @@ $(ARCHIVE_DIR):
 	cp src/po/*.po $@/src/po
 	cp runtime/lang/menu_ja*.vim $@/runtime/lang
 	cp runtime/doc/*.UTF-8.1 $@/runtime/doc
-	cp runtime/tutor/tutor.ja.* $@/runtime/tutor
+	cp runtime/tutor/tutor*.ja.* $@/runtime/tutor
 	cp nsis/lang/japanese.nsi $@/nsis/lang
 
 $(ARCHIVE).tar.gz: $(ARCHIVE_DIR)

runtime/doc/vim-ja.UTF-8.1

@@ -229,16 +229,16 @@ Note: それらのオプションを設定すれば変更できるようにな
 ":set uc=0" と設定しても同じです。
 戻すには ":set uc=200" と設定してください。
 .TP
-\-nb
-NetBeans と接続し、エディタサーバーになります。
-詳しくはヘルプを参照してください。
-.TP
 \-N
 非互換モード。'compatible' オプションがオフになります。
  .vimrc ファイルの有無に関わらず、
 .B Vim
 の改良された機能が有効になります。Vi との互換性が少し失われます。
 .TP
+\-nb
+NetBeans と接続し、エディタサーバーになります。
+詳しくはヘルプを参照してください。
+.TP
 \-o[N]
 N 個のウィンドウを水平分割で開きます。
 N を省略した場合は、引数のファイルを個別のウィンドウで開きます。
@@ -374,7 +374,7 @@ X サーバーと通信しません。端末での起動時間を短くできま
 \-\-echo\-wid
 GTK GUI のみ: Window ID を標準出力に出力します。
 .TP
-\-\-gui-dialog-file {name}
+\-\-gui-\dialog\-file {name}
 GUI の使用時、ダイアログを表示する代わりとして、ファイル {name} へダイアログのタイトルとメッセージを書き込みます。
 ファイルは作成されるか追記されます。
 テストにみ有用で、見ることができないダイアログによってテストが中断されるのを防ぎます。
@@ -396,12 +396,14 @@ Unix のように、シェルがワイルドカードを展開する場合は機
 を呼び出すのと同様な動作です。
 .TP
 \-\-nofork
-フォアグラウンド。GUI バージョンで、プロセスをフォークしなくなります。
+フォアグラウンド。GUI バージョンで、
+.B Vim
+はプロセスをフォークしなくなり、開始したシェルからデタッチされます。
 .TP
 \-\-noplugin
 プラグインをロードしません。\-u NONE はこの動作を含んでいます。
 .TP
-\-\-not-a-term
+\-\-not\-a\-term
 入力と出力(もしくはどちらか一方)が端末に接続されていないことを、ユーザーが把握しているということを
 .B Vim
 に伝えます。

runtime/doc/vimtutor-ja.UTF-8.1

@@ -1,48 +1,99 @@
-.TH VIMTUTOR 1 "2024 August 12"
+.TH VIMTUTOR 1 "2024 December 03"
 .SH 名前
 vimtutor \- Vim チュートリアル
 .SH 書式
 .br
-.B vimtutor [\-g] [language]
+.B vimtutor [\-l | \-\-language ISO639] [\-c | \-\-chapter NUMBER] [\-g | \-\-gui] [ISO639]
+.br
+.B vimtutor [\-h | \-\-help]
+.br
+.B vimtutor [\-\-list]
 .SH 説明
 .B Vim
 のチュートリアルを起動します。
-演習ファイルのコピーを使って実施するので、オリジナルの演習ファイルを壊してしまう心配はありません。
 .PP
 .B Vim
 を初めて学ぶ人向けのチュートリアルです。
+省略可能な [ISO639] 引数は "ja" や "es" のような 2 または 3 文字の言語名です。
 .PP
-引数に \-g を指定すると GUI 版の Vim が利用可能であれば vim ではなく gvim
-を使って vimtutor が開始します。gvim が見つからないときは vim が使用されます。
-.PP
-[language] 引数は "ja" や "es" などの二文字の言語名です。
-[language] 引数を省略した場合はロケールの言語が使われます。
-翻訳された演習ファイルがある場合は、そのファイルが使われます。
-ない場合は英語のファイルが使われます。
+.B vimtutor
+は演習ファイルの一時的なコピーを開くので、オリジナルの演習ファイルを上書きしてしまう心配はありません。
 .PP
 .B Vim
-は Vi 互換モードで起動されます。
+は常に
+.B Vi
+互換モードで起動されます。
+.SH オプション
+.TP
+.BR \-l ", " \-\-language\ \fIISO639\fR
+2 または 3 文字の言語コードを設定します。
+例: 'ja', 'es', 'bar'
+ロケールの言語が使用可能であればそれが使われ、なければ英語がデフォルトとして使われます。
+.TP
+.BR \-c ", " \-\-chapter\ \fINUMBER\fR
+章番号を設定します。
+デフォルトは第 1 章です。
+.TP
+.BR \-g ", " \-\-gui
+使用可能であれば
+.B vimtutor
+を GUI 版の vim を使って開始します。そうでなければコンソール版の vim を使用します。
+.TP
+.BR \-h ", " \-\-help
+使い方を表示します。
+.TP
+.BR \-\-list
+章と言語の一覧を表示します。
+.SH 例
+.B vimtutor
+をドイツ語の第 1 章で開始するには:
+.PP
+.nf
+.RS
+vimtutor de
+.RE
+.fi
+.PP
+英語の第 2 章の場合は:
+.PP
+.nf
+.RS
+vimtutor -c2
+.RE
+.fi
+.PP
+GUI でバイエルン語の第 1 章を開始する際の長い形式のコマンドは:
+.PP
+.nf
+.RS
+vimtutor --language bar --chapter 1 --gui
+.RE
+.fi
 .SH ファイル
 .TP 15
-/usr/local/share/vim/vim??/tutor/tutor[.language]
+/usr/local/share/vim/vim??/tutor/tutor1[.language]
 .B Vimtutor
-の演習ファイル。
-.I vim??
-は短いバージョン番号で
-.B Vim 9.1
-では vim91 です。
+の第 1 章の演習ファイル。
+.TP 15
+/usr/local/share/vim/vim??/tutor/tutor2[.language]
+.B Vimtutor
+の第 2 章の演習ファイル。
 .TP 15
 /usr/local/share/vim/vim??/tutor/tutor.vim
-演習ファイルをコピーするための Vim スクリプト。
-.SH 著者
 .B Vimtutor
-は、Colorado State University の Charles Smith のアイデアを基に、
+の演習ファイルをコピーするための
+.B Vim
+スクリプト。
+.SH 著者
+.B The Vi Tutorial
+は、元々 Colorado State University の Charles Smith のアイデアを基に、
 Colorado School of Mines の Michael C. Pierce と Robert K. Ware
-の両名によって Vi 向けに作成されたものを基にしています。
-E-mail: [email protected] (現在は無効).
-.br
+の両名によって Vi 向けに作成されました。
+.B E-mail: [email protected] (現在は無効).
+.PP
 .B Vim
 に合わせて Bram Moolenaar が変更を加えました。
+.PP
 翻訳者の名前は演習ファイルを参照してください。
 .SH 関連項目
 vim(1)

runtime/doc/vimtutor.1

@@ -1,61 +1,108 @@
-.TH VIMTUTOR 1 "2024 August 12"
+.TH VIMTUTOR 1 "2024 December 03"
 .SH NAME
 vimtutor \- the Vim tutor
 .SH SYNOPSIS
 .br
-.B vimtutor [\-g] [language]
+.B vimtutor [\-l | \-\-language ISO639] [\-c | \-\-chapter NUMBER] [\-g | \-\-gui] [ISO639]
+.br
+.B vimtutor [\-h | \-\-help]
+.br
+.B vimtutor [\-\-list]
 .SH DESCRIPTION
 .B Vimtutor
 starts the
 .B Vim
 tutor.
-It copies the tutor file first, so that it can be modified without changing
-the original file.
 .PP
 The
 .B Vimtutor
 is useful for people that want to learn their first
 .B Vim
 commands.
+The optional [ISO639] argument is the two or three letter name of a language,
+like "it" or "es".
 .PP
-The optional argument \-g starts vimtutor with gvim rather than vim, if the
-GUI version of Vim is available, or falls back to vim if gvim is not found.
-.PP
-The optional [language] argument is the two-letter name of a language, like
-"it" or "es".
-If the [language] argument is missing, the language of the current locale will
-be used.
-If a tutor in this language is available, it will be used.
-Otherwise the English version will be used.
+.B Vimtutor
+only opens temporary copies of the original tutor files, there is no danger
+of overwriting the lessons.
 .PP
 .B Vim
-is always started in Vi compatible mode.
+is always started in
+.B Vi
+compatible mode.
+.SH OPTIONS
+.TP
+.BR \-l ", " \-\-language\ \fIISO639\fR
+Set the two or three letter language code. E.g. 'it', 'es', 'bar'.
+Defaults to language of locale if available, else to English.
+.TP
+.BR \-c ", " \-\-chapter\ \fINUMBER\fR
+Set the chapter number. Defaults to chapter one.
+.TP
+.BR \-g ", " \-\-gui
+Start
+.B vimtutor
+in the GUI version of vim if available, otherwise fallback to console vim.
+.TP
+.BR \-h ", " \-\-help
+Display usage information.
+.TP
+.BR \-\-list
+Display chapters and languages.
+.SH EXAMPLES
+To start
+.B vimtutor
+in German on chapter one:
+.PP
+.nf
+.RS
+vimtutor de
+.RE
+.fi
+.PP
+In English on chapter two:
+.PP
+.nf
+.RS
+vimtutor -c2
+.RE
+.fi
+.PP
+Longform command for Bavarian in the GUI on chapter one:
+.PP
+.nf
+.RS
+vimtutor --language bar --chapter 1 --gui
+.RE
+.fi
 .SH FILES
 .TP 15
-/usr/local/share/vim/vim??/tutor/tutor[.language]
+/usr/local/share/vim/vim??/tutor/tutor1[.language]
 The
 .B Vimtutor
-text file(s).
-.br
-.I vim??
-is short version number, like vim91 for
-.B Vim 9.1
+chapter one text file(s).
+.TP 15
+/usr/local/share/vim/vim??/tutor/tutor2[.language]
+The
+.B Vimtutor
+chapter two text file(s).
 .TP 15
 /usr/local/share/vim/vim??/tutor/tutor.vim
-The Vim script used to copy the
+The
+.B Vim
+script used to copy the
 .B Vimtutor
 text file.
 .SH AUTHOR
-The
-.B Vimtutor
-was originally written for Vi by Michael C. Pierce and Robert K. Ware,
-Colorado School of Mines using ideas supplied by Charles Smith,
-Colorado State University.
-E-mail: [email protected] (now invalid).
-.br
-It was modified for
+.B The Vi Tutorial
+was originally written for Vi by Michael C. Pierce and Robert K. Ware, Colorado
+School of Mines using ideas supplied by Charles Smith, Colorado State University.
+.B E-mail: [email protected] (now invalid).
+.PP
+Modified for
 .B Vim
 by Bram Moolenaar.
-For the names of the translators see the tutor files.
+.PP
+Translation contributors are listed in the tutor files.
 .SH SEE ALSO
 vim(1)

runtime/doc/xxd-ja.UTF-8.1

@@ -58,7 +58,8 @@
 1 オクテットが "1" と "0" の 8 文字で出力されます。
 各行の行頭には 16 進数の行番号が表示されます。
 行末には ASCII (または EBCDIC) で表した場合の文字が表示されます。
-このモードでは \-p、\-i は機能しません。
+このモードでは \-p は機能しません。
+\-i と組み合わせることができます。
 .TP
 .IR \-e
 リトルエンディアンの 16 進ダンプに切り替える。
@@ -106,6 +107,7 @@
 C インクルードファイル形式で出力する。
 入力ファイルの名前が付けられた静的配列の定義が出力されます。
 標準入力の場合は定義の中身だけ出力されます。
+\-b と組み合わせることができます。
 .TP
 .IR "\-l len " | " \-len len"
 .RI  < len >

runtime/doc/xxd.1

@@ -63,8 +63,8 @@ Toggle autoskip: A single '*' replaces NUL-lines.  Default off.
 Switch to bits (binary digits) dump, rather than hex dump.
 This option writes octets as eight digits "1"s and "0"s instead of a normal
 hexadecimal dump. Each line is preceded by a line number in hexadecimal and
-followed by an ASCII (or EBCDIC) representation. The command line switches
-\-p, \-i do not work with this mode.
+followed by an ASCII (or EBCDIC) representation. The command line switch
+\-p does not work with this mode. Can be combined with \-i.
 .TP
 .IR "\-c cols " | " \-cols cols"
 Format
@@ -109,7 +109,8 @@ Print a summary of available commands and exit.  No hex dumping is performed.
 .TP
 .IR \-i " | " \-include
 Output in C include file style. A complete static array definition is written
-(named after the input file), unless xxd reads from stdin.
+(named after the input file), unless xxd reads from stdin. Can be combined
+with \-b.
 .TP
 .IR "\-l len " | " \-len len"
 Stop after writing

runtime/tutor/.gitignore

@@ -1,2 +1,2 @@
-/tutor.ja.sjis
-/tutor.ja.euc
+/tutor?.ja.sjis
+/tutor?.ja.euc