Merge pull request #174 from uakms/catch-up-intro

原文の変更に追随 (intro)

Author: koron

doc/intro.jax

@@ -1,4 +1,4 @@
-*intro.txt*     For Vim バージョン 8.0.  Last change: 2016 Sep 24
+*intro.txt*     For Vim バージョン 8.0.  Last change: 2017 Aug 24
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -91,8 +91,8 @@ Vim のページには Vim についての最新情報が載っています。
 のリンクもあります。FAQ はよく尋ねられる質問に対する回答集です。問題があったら
 まずこれを読むとよいでしょう。
 
-	VIMホームページ:	http://www.vim.org/
-	VIM FAQ:		http://vimdoc.sf.net/
+	Vimホームページ:	http://www.vim.org/
+	Vim FAQ:		http://vimdoc.sf.net/
 	ダウンロード:		ftp://ftp.vim.org/pub/vim/MIRRORS
 
 
@@ -147,10 +147,17 @@ http://www.vim.org/maillist.php
    文章は vim-dev メーリングリストにも転送されます。
 
 メッセージは簡潔にお願いします。メールに回答する時間は、Vim を改良する時間から
-消費されています! 常に再現可能な例をつけてください。できれば、どこの設定が (あ
-るいは機能が) バグの発生に影響しているかを探してください。可能なら、違うマシン
-でも試してみて下さい。そして、もし修正できた場合はパッチを私に送って下さい。
-(本家へのレポートは英語でお願いします)
+消費されています! 常に再現可能な例をつけてください。そして、バグを引き起こす設
+定やその他のものを探してください。
+
+なるべくなら Vim を次のように起動してください: >
+
+	vim --clean -u reproduce.vim
+
+ここで、reproduce.vim は問題を再現するスクリプトです。関連があるならば(もしか
+したら MS-Windows 固有のバグかも？)、違うマシンでも試してみて下さい。
+
+可能ならばパッチを私に送って下さい。(本家へのレポートは英語でお願いします)
 
 Vim のバージョンや設定情報を含めてくれると助かります。次のコマンドで情報を得る
 ことができます: >
@@ -517,7 +524,7 @@ CTRL-H を "<Home>" の 6 文字にマップする例: >
 ==============================================================================
 5. モードの紹介					*vim-modes-intro* *vim-modes*
 
-Vim には 6 つの基本モードがあります。
+Vim には 7 つの基本モードがあります。
 
 					*Normal* *Normal-mode* *command-mode*
 ノーマルモード		ノーマルモードでは普通の編集コマンドを全て入力でき
@@ -552,7 +559,12 @@ Ex モード		コマンドラインモードに似てますが、コマンド入
 			モードに留まります。コマンドライン編集は、かなり制限さ
 			れます。|Ex-mode|を参照。
 
-加えて、6 つのモードがあります。これらは基本モードの変種です。
+Terminal-Job モード	ターミナルウィンドウの中でジョブと相互作用します。入力
+			されたキーはジョブに渡され、ジョブの出力はターミナル
+			ウィンドウに表示されます。他のモードへの移行の仕方は
+			|terminal| を参照。
+
+加えて、7 つのモードがあります。これらは基本モードの変種です。
 
 				*Operator-pending* *Operator-pending-mode*
 オペレータ待機モード	ノーマルモードに似てますが、オペレータコマンドが実行さ
@@ -577,6 +589,10 @@ Ex モード		コマンドラインモードに似てますが、コマンド入
 			オプション 'showmode' がオンなら、"-- (insert) --" が
 			ウィンドウの最下部に表示されます。
 
+Terminal-Normal モード	ターミナルウィンドウでノーマルモードを使います。変更は
+			できないようになっています。ターミナルジョブモードに戻
+			るには、"a" や "i" のような挿入コマンドを使います。
+
 挿入ビジュアルモード	挿入モードでビジュアル選択を開始すると、このモードに入
 			ります。例えば、CTRL-O を使い, その後 "v"、"V"、CTRL-V
 			を使ったときです。
@@ -652,6 +668,8 @@ CTRL-\ CTRL-N と <C-\><C-N> を使って、どのモードからでもノーマ
 のときのようにビープ音はなりません。ただし、Ex モードでは機能しません。|f|や
 |m|のように引数をとるコマンドの後で使われたときは、'ttimeoutlen' で設定された
 タイムアウトが適用されます。
+フォーカスがターミナルウィンドウにあるとき、CTRL-\ CTRL-N はたった 1 つのコマ
+ンドでノーマルモードに移行します。|t_CTRL-\_CTRL-N| を参照。
 
 	*CTRL-\_CTRL-G* *i_CTRL-\_CTRL-G* *c_CTRL-\_CTRL-G* *v_CTRL-\_CTRL-G*
 'insertmode' がオンのときは、CTRL-\ CTRL-G や <C-\><C-G> で挿入モードに移行で
@@ -811,9 +829,11 @@ Amiga 上では、Vim は CLI ウィンドウで実行されます。Vim の名
 ==============================================================================
 8. 用語の定義						*definitions*
 
+  バッファ		テキスト行が入っている。一般にファイルから読み込む。
   スクリーン		Vim が使う領域全体。端末ウィンドウを指す場合もある。
 			"Vimウィンドウ" とも呼ばれる。
-  ウィンドウ		バッファが表示される場所。
+  ウィンドウ		バッファが表示される場所。1 つのバッファが複数のウィ
+			ンドウを持つことが可能。
 
 一つのスクリーンは一つ以上のウィンドウを内包し、それらはステータスラインで区切
 られ、最下行にはコマンドラインが表示されます。

en/intro.txt

@@ -1,4 +1,4 @@
-*intro.txt*     For Vim version 8.0.  Last change: 2016 Sep 24
+*intro.txt*     For Vim version 8.0.  Last change: 2017 Aug 24
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -84,8 +84,8 @@ The Vim pages contain the most recent information about Vim.  They also
 contain links to the most recent version of Vim.  The FAQ is a list of
 Frequently Asked Questions.  Read this if you have problems.
 
-	VIM home page:	  http://www.vim.org/
-	VIM FAQ:	  http://vimdoc.sf.net/
+	Vim home page:	  http://www.vim.org/
+	Vim FAQ:	  http://vimdoc.sf.net/
 	Downloading:	  ftp://ftp.vim.org/pub/vim/MIRRORS
 
 
@@ -143,9 +143,14 @@ There are two ways to report bugs, both work:
 
 Please be brief; all the time that is spent on answering mail is subtracted
 from the time that is spent on improving Vim!  Always give a reproducible
-example and try to find out which settings or other things influence the
-appearance of the bug.  Try different machines, if possible.  Send me patches
-if you can!
+example and try to find out which settings or other things trigger the bug.
+
+Preferably start Vim with: >
+	vim --clean -u reproduce.vim
+Where reproduce.vim is a script that reproduces the problem.  Try different
+machines, if relevant (is this an MS-Windows specific bug perhaps?).
+
+Send me patches if you can!
 
 It will help to include information about the version of Vim you are using and
 your setup.  You can get the information with this command: >
@@ -525,7 +530,7 @@ examples and use them directly.  Or type them literally, including the '<' and
 ==============================================================================
 5. Modes, introduction				*vim-modes-intro* *vim-modes*
 
-Vim has six BASIC modes:
+Vim has seven BASIC modes:
 
 					*Normal* *Normal-mode* *command-mode*
 Normal mode		In Normal mode you can enter all the normal editor
@@ -561,7 +566,12 @@ Ex mode			Like Command-line mode, but after entering a command
 			you remain in Ex mode.  Very limited editing of the
 			command line.  |Ex-mode|
 
-There are six ADDITIONAL modes.  These are variants of the BASIC modes:
+Terminal-Job mode	Interacting with a job in a terminal window.  Typed
+			keys go to the job and the job output is displayed in
+			the terminal window.  See |terminal| about how to
+			switch to other modes.
+
+There are seven ADDITIONAL modes.  These are variants of the BASIC modes:
 
 				*Operator-pending* *Operator-pending-mode*
 Operator-pending mode	This is like Normal mode, but after an operator
@@ -587,6 +597,10 @@ Insert Normal mode	Entered when CTRL-O given in Insert mode.  This is
 			If the 'showmode' option is on "-- (insert) --" is
 			shown at the bottom of the window.
 
+Terminal-Normal mode	Using Normal mode in a terminal window.  Making
+			changes is impossible.  Use an insert command, such as
+			"a" or "i", to return to Terminal-Job mode.
+
 Insert Visual mode	Entered when starting a Visual selection from Insert
 			mode, e.g., by using CTRL-O and then "v", "V" or
 			CTRL-V.  When the Visual selection ends, Vim returns
@@ -661,6 +675,8 @@ Normal mode from any other mode.  This can be used to make sure Vim is in
 Normal mode, without causing a beep like <Esc> would.  However, this does not
 work in Ex mode.  When used after a command that takes an argument, such as
 |f| or |m|, the timeout set with 'ttimeoutlen' applies.
+When focus is in a terminal window, CTRL-\ CTRL-N goes to Normal mode for only
+one command, see |t_CTRL-\_CTRL-N|.
 
 	*CTRL-\_CTRL-G* *i_CTRL-\_CTRL-G* *c_CTRL-\_CTRL-G* *v_CTRL-\_CTRL-G*
 The command CTRL-\ CTRL-G or <C-\><C-G> can be used to go to Insert mode when
@@ -823,10 +839,12 @@ by Vim.  {Vi: not ok}
 ==============================================================================
 8. Definitions						*definitions*
 
+  buffer		Contains lines of text, usually read from a file.
   screen		The whole area that Vim uses to work in.  This can be
 			a terminal emulator window.  Also called "the Vim
 			window".
-  window		A view on a buffer.
+  window		A view on a buffer.  There can be multiple windows for
+			one buffer.
 
 A screen contains one or more windows, separated by status lines and with the
 command line at the bottom.