Merge pull request #1176 from tsuyoshicho/update/20221016/repeat

Update repeat.{txt,jax}

Author: h-east

doc/repeat.jax

@@ -1,4 +1,4 @@
-*repeat.txt*    For Vim バージョン 9.0.  Last change: 2022 Jun 18
+*repeat.txt*    For Vim バージョン 9.0.  Last change: 2022 Sep 22
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -87,7 +87,8 @@ globalコマンドの動作はまず第1に[range]の行をスキャンしマッ
 これは、はじめに "found" を含むすべての行を見つけるが、"notfound" にマッチしな
 いものがあるときにだけ {cmd} を実行する。
 
-非Exコマンドを実行するには `:normal` コマンドを使用すれば良い: >
+任意のExコマンドを使用できる、|ex-cmd-index| を参照。Normalモードコマンドを実
+行するには `:normal` コマンドを使用すれば良い: >
 	:g/pat/normal {commands}
 確実に {commands} が完全なコマンドとして終了するようにすること。そうでないと
 Vim は全部のマッチに 1 つ 1 つについて、コマンドの残りを期待して貴方の入力を待
@@ -196,7 +197,7 @@ Vim script の書き方はユーザーマニュアルの41章|usr_41.txt|を参
 							*:source-range*
 :[range]so[urce] [++clear]
 			カレントバッファの[range]行の範囲からExコマンドを読み
-			込む。
+			込む。[range] がない場合はすべての行を読み込む。
 
 			カレントバッファからコマンドを読み込む時、そのバッファ
 			が複数回読み込まれる場合は同じスクリプトのID(識別子)
@@ -408,6 +409,10 @@ Vim script の書き方はユーザーマニュアルの41章|usr_41.txt|を参
 			`import autoload` で使用されたスクリプトで、まだ実際に
 			は読み込まれていないものには、スクリプトIDの後ろに "A"
 			が表示される。
+			スクリプトがある名前で参照されたがシンボリックリンクの
+			解決後に別の名前で読み込まれたとき、その別のスクリプト
+			は "->" の後に表示される。例えば、"20->22" はスクリプ
+			ト20はスクリプト22として読み込まれたことを意味する。
 			{|+eval| 機能付きでコンパイルされたときのみ有効}
 
 :scr[iptnames][!] {scriptId}			*:script*
@@ -772,7 +777,7 @@ NOTE: デバッグモードは未完成である。デバッグはVimの動作
 の動作についてより詳細なメッセージを得られる。
 
 
-デバッグモードを開始する					*debug-mode*
+☆デバッグモードを開始する					*debug-mode*
 
 デバッグモードを開始するにはこれらの方法のうちどれかを使う:
 1. Vimを|-D|引数付きで起動する: >
@@ -799,8 +804,7 @@ NOTE: デバッグモードは未完成である。デバッグはVimの動作
 いた場合には分けて表示される。
 
 
-デバッグモード
---------------
+☆デバッグモード
 
 デバッグモードに入ると、通常のExコマンドが使える。例えば、変数の値を見るには: >
 	echo idx
@@ -883,6 +887,10 @@ NOTE: Vim9 script で、コマンドがスクリプトレベルで記述され
 行する場合、"step" はローカル変数を検査できるコンパイル済みコンテキストで1回、
 そしてコマンドを実行する直前に1回停止する。
 
+:def 関数ではまだ宣言されていない変数は検査することができない。宣言された変数
+は検査でき、また宣言されたブロックが終了しても検査できる。コマンドではこうする
+ことができず、したがって少々誤解を招くかもしれない(しかし便利に使える)。
+
 バックトレースは、関数呼び出しの階層を表示する。例えば:
 	>bt ~
 	  3 function One[3] ~
@@ -898,8 +906,7 @@ NOTE: Vim9 script で、コマンドがスクリプトレベルで記述され
 ムの、現在行の内容を表示する方法はまだない。
 
 
-ブレークポイントの定義
-----------------------
+☆ブレークポイントの定義
 							*:breaka* *:breakadd*
 :breaka[dd] func [lnum] {name}
 		関数にブレークポイントを設定する。例: >
@@ -961,8 +968,7 @@ Note 関数はまず読み込まれ、後で実行される。読み込まれた
 ポイントがチェックされ、実行されるときに "func" ブレークポイントがチェックされ
 る。
 
-ブレークポイントの削除
-----------------------
+☆ブレークポイントの削除
 						*:breakd* *:breakdel* *E161*
 :breakd[el] {nr}
 		ブレークポイント{nr}を削除する。|:breaklist|を使って番号を確認
@@ -986,15 +992,13 @@ Note 関数はまず読み込まれ、後で実行される。読み込まれた
 と "*explorer.vim"、"*explorer*" は違う。
 
 
-ブレークポイントを列挙する
---------------------------
+☆ブレークポイントを列挙する
 							*:breakl* *:breaklist*
 :breakl[ist]
 		全てのブレークポイントを列挙する。
 
 
-その他
-------
+☆その他
 
 						*:debugg* *:debuggreedy*
 :debugg[reedy]

en/repeat.txt

@@ -1,4 +1,4 @@
-*repeat.txt*    For Vim version 9.0.  Last change: 2022 Jun 18
+*repeat.txt*    For Vim version 9.0.  Last change: 2022 Sep 22
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -92,7 +92,8 @@ pattern and do not match another pattern: >
 This first finds all lines containing "found", but only executes {cmd} when
 there is no match for "notfound".
 
-To execute a non-Ex command, you can use the `:normal` command: >
+Any Ex command can be used, see |ex-cmd-index|.  To execute a Normal mode
+command, you can use the `:normal` command: >
 	:g/pat/normal {commands}
 Make sure that {commands} ends with a whole command, otherwise Vim will wait
 for you to type the rest of the command for each match.  The screen will not
@@ -200,7 +201,8 @@ For writing a Vim script, see chapter 41 of the user manual |usr_41.txt|.
 							*:source-range*
 :[range]so[urce] [++clear]
 			Read Ex commands from the [range] of lines in the
-			current buffer.
+			current buffer.  When [range] is omitted read all
+			lines.
 
 			When sourcing commands from the current buffer, the
 			same script-ID |<SID>| is used even if the buffer is
@@ -417,6 +419,10 @@ For writing a Vim script, see chapter 41 of the user manual |usr_41.txt|.
 			For a script that was used with `import autoload` but
 			was not actually sourced yet an "A" is shown after the
 			script ID.
+			For a script that was referred to by one name but
+			after resolving symbolic links got sourced with
+			another name the other script is after "->".  E.g.
+			"20->22" means script 20 was sourced as script 22.
 			{not available when compiled without the |+eval|
 			feature}
 
@@ -900,6 +906,11 @@ executed like a normal Ex command, "step" will stop once in the compiled
 context, where local variables can be inspected, and once just before
 executing the command.
 
+In a :def function variables that haven't been declared yet cannot be
+inspected.  Variables that have been declared can be inspected, also when the
+block they were declared in has finished.  In commands this would not be
+possible, thus is slightly misleading (but can be useful).
+
 The backtrace shows the hierarchy of function calls, e.g.:
 	>bt ~
 	  3 function One[3] ~