Merge pull request #1681 from vim-jp/hh-update-windows

Update windows.{txt,jax}

Author: h-east

doc/windows.jax

@@ -1,4 +1,4 @@
-*windows.txt*   For Vim バージョン 9.1.  Last change: 2024 Jul 09
+*windows.txt*   For Vim バージョン 9.1.  Last change: 2024 Sep 08
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -71,27 +71,27 @@
 隠れ(hidden)	  ×		 ○		  'h'
 非アクティブ	  ×		 ×		  ' '
 
-
-Note: ノーマルコマンドが利用できない、あるいは使い勝手が悪い状況のために、全て
-のCTRL-Wコマンドは|:wincmd|によっても実行できる。
+							*buffer-reuse*
+個々のバッファには一意な番号が割り振られており、Vim のセッション中は決して変わ
+らない。バッファ名とバッファ番号を相互に変換するのには、|bufnr()| と
+|bufname()| 関数を使える。例外が 1 つある。新しい空のバッファが作成され、それ
+が変更されていない場合、そのバッファに別のファイルを読み込む時にそのバッファが
+再利用される。これはバッファ番号が変更されないことも意味する。
 
 Vimではウィンドウを複数に分割することができる。タブページ|tab-page|というもの
 もあり、タブページは複数のウィンドウを保持することができる。
+
 					*window-ID* *winid* *windowid*
 個々のウィンドウにはウィンドウIDと呼ばれる一意な識別が与えられる。この識別子は
 Vimのセッション中は決して変わらない。|win_getid()| と |win_id2tabwin()| 関数
-は、ウィンドウ/タブ番号を識別子に変換するのに利用できる。似たようなものとして
+は、ウィンドウ/タブ番号を識別子に変換するのに使用できる。似たようなものとして
 ウィンドウ番号があるが、こちらはウィンドウを開いたり閉じたりするたびに変わる可
 能性がある。 |winnr()| を参照。
 ウィンドウ番号は1つの特定のタブでのみ有効である。ウィンドウIDは複数のタブで有
 効である。ウィンドウIDまたはウィンドウ番号を使用するほとんどの関数では、ウィン
 ドウ番号は現在のタブにのみ適用され、ウィンドウIDは任意のタブ内のウィンドウを参
 照できる。
 
-個々のバッファには一意な番号が割り振られており、Vimのセッション中は決して変わ
-らない。バッファ名とバッファ番号を相互に変換するのには、|bufnr()| と
-|bufname()| 関数を使える。
-
 
 ==============================================================================
 2. Vim の起動						*windows-starting*
@@ -490,12 +490,15 @@ CTRL-W P	プレビューウィンドウに移動。プレビューウィンド
 			:wincmd j
 <		下のウィンドウに移動する。
 		このコマンドは (|CursorHold| 自動コマンドイベントのため) ノー
-		マルモードが利用できないときやノーマルコマンドが不便なときに有
+		マルモードが使用できないときやノーマルコマンドが不便なときに有
 		効である。
 		count はウィンドウ番号であってもよい。例: >
 			:exe nr .. "wincmd w"
 <		これは "nr" 番のウィンドウへ移動する。
 
+Note: すべての CTRL-W コマンドは、ノーマルモードのコマンドが使用できない、また
+は不便な場所 (ブラウザーベースの端末等) のために、|:wincmd| でも実行できる。
+
 ==============================================================================
 5. ウィンドウの移動					*window-moving*
 

en/windows.txt

@@ -1,4 +1,4 @@
-*windows.txt*   For Vim version 9.1.  Last change: 2024 Jul 09
+*windows.txt*   For Vim version 9.1.  Last change: 2024 Sep 08
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -67,11 +67,17 @@ active		  yes		 yes		  'a'
 hidden		  no		 yes		  'h'
 inactive	  no		 no		  ' '
 
-Note: All CTRL-W commands can also be executed with |:wincmd|, for those
-places where a Normal mode command can't be used or is inconvenient.
+							*buffer-reuse*
+Each buffer has a unique number and the number will not change within a Vim
+session.  The |bufnr()| and |bufname()| functions can be used to convert
+between a buffer name and the buffer number.  There is one exception: if a new
+empty buffer is created and it is not modified, the buffer will be re-used
+when loading another file into that buffer. This also means the buffer number
+will not change.
 
 The main Vim window can hold several split windows.  There are also tab pages
 |tab-page|, each of which can hold multiple windows.
+
 					*window-ID* *winid* *windowid*
 Each window has a unique identifier called the window ID.  This identifier
 will not change within a Vim session. The |win_getid()| and |win_id2tabwin()|
@@ -83,9 +89,6 @@ across tabs.  For most functions that take a window ID or a window number, the
 window number only applies to the current tab, while the window ID can refer
 to a window in any tab.
 
-Each buffer has a unique number and the number will not change within a Vim
-session.  The |bufnr()| and |bufname()| functions can be used to convert
-between a buffer name and the buffer number.
 
 ==============================================================================
 2. Starting Vim						*windows-starting*
@@ -391,7 +394,7 @@ CTRL-W CTRL-C						*CTRL-W_CTRL-C*
 		to the buffer are not written and won't get lost, so this is a
 		"safe" command.
 
-:hid[e] {cmd}	Execute {cmd} with 'hidden' is set.  The previous value of
+:hid[e] {cmd}	Execute {cmd} with 'hidden' set.  The previous value of
 		'hidden' is restored after {cmd} has been executed.
 		Example: >
 		    :hide edit Makefile
@@ -485,6 +488,10 @@ These commands can also be executed with ":wincmd":
 			:exe nr .. "wincmd w"
 <		This goes to window "nr".
 
+Note: All CTRL-W commands can also be executed with |:wincmd|, for those
+places where a Normal mode command can't be used or is inconvenient (e.g.
+in a browser-based terminal).
+
 ==============================================================================
 5. Moving windows around				*window-moving*