Merge pull request #1316 from vim-jp/hh-update-motion

Update motion.{txt,jax}

Author: h-east

doc/motion.jax

@@ -1,4 +1,4 @@
-*motion.txt*    For Vim バージョン 9.0.  Last change: 2022 Sep 26
+*motion.txt*    For Vim バージョン 9.0.  Last change: 2023 Sep 28
 
 
 		  VIMリファレンスマニュアル	  by Bram Moolenaar
@@ -237,8 +237,8 @@ gM			"g0" と似ていますが行のテキストの真ん中に移動します
 			"10gM" はテキストの始まり近くにあり、"90gM" はテキスト
 			の終わり近くにあります。
 
-							*g$* *g<End>*
-g$ or g<End>		行が折り返されている場合('wrap' オン): スクリーン行の
+							*g$*
+g$			行が折り返されている場合('wrap' オン): スクリーン行の
 			最後の文字に、そして [count - 1] スクリーン行下に移動
 			します|inclusive|。行がスクリーンより広い場合に "$" と
 			違う動作になります。
@@ -250,6 +250,10 @@ g$ or g<End>		行が折り返されている場合('wrap' オン): スクリー
 			'virtualedit' が有効である場合、スクリーン行の末尾に移
 			動します。
 
+							*g<End>* *g<kEnd>*
+g<End>			|g$| に似ていますが、最後の文字ではなく最後の非空白文
+			字までです。
+
 							*bar*
 |			現在の行の [count] スクリーン桁位置に移動します。
 			|exclusive|。Ceci n'est pas une pipe.
@@ -583,41 +587,52 @@ a]						*v_a]* *v_a[* *a]* *a[*
 a[			"a [] block"、[count] '[' ']' block を選択します。この
 			コマンドは後方に [count] 番目に現れる '[' を探し、それ
 			から対応する ']' を探します。そしてその2つに囲まれたテ
-			キストを '[' と ']' も含めて選択します。
+			キストを '[' と ']' も含めて選択します。|cpo-M| オプ
+			ションフラグは、エスケープされた括弧を処理するために使
+			用されます。
 			ビジュアルモードで使われたときは、文字単位になります。
 
 i]						*v_i]* *v_i[* *i]* *i[*
 i[			"inner [] block"、[count] '[' ']' block の内部を選択
 			します。このコマンドは後方に [count] 番目に現れる '['
 			を探し、それから対応する ']' を探します。そしてその2つ
 			に囲まれたテキストを '[' と ']' を除いて選択します。
+			|cpo-M| オプションフラグは、エスケープされた括弧を処理
+			するために使用されます。
 			ビジュアルモードで使われたときは、文字単位になります。
 
 a)							*v_a)* *a)* *a(*
 a(							*vab* *v_ab* *v_a(* *ab*
 ab			"a block"、[count] block 選択します。"[count] [(" から
 			それに対応する ')' までで、'(' と ')' を含みます(参照
-			|[(|)。括弧の外側の空白は含みません。
+			|[(|)。括弧の外側の空白は含みません。|cpo-M| オプショ
+			ンフラグは、エスケープされた小括弧を処理するために使用
+			されます。
 			ビジュアルモードで使われたときは、文字単位になります。
 
 i)							*v_i)* *i)* *i(*
 i(							*vib* *v_ib* *v_i(* *ib*
 ib			"inner block"、[count] block の内部を選択します。
 			"[count] [(" からそれに対応する ')' までで、'(' と ')'
 			を除きます(参照 |[(|)。カーソルが () ブロック内でない
-			場合、次の "(" を探します。
+			場合、次の "(" を探します。|cpo-M| オプションフラグは、
+			エスケープされた小括弧を処理するために使用されます。
 			ビジュアルモードで使われたときは、文字単位になります。
 
 a>						*v_a>* *v_a<* *a>* *a<*
 a<			"a <> block"、[count] <> block 選択します。[count] 番
 			目に現れる '<' を検索し、それに対応する '>' までを '<'
-			と '>' を含めて選択します。
+			と '>' を含めて選択します。|cpo-M| オプションフラグは、
+			エスケープされた '<' および '>' を処理するために使用さ
+			れます。
 			ビジュアルモードで使われたときは、文字単位になります。
 
 i>						*v_i>* *v_i<* *i>* *i<*
 i<			"inner <> block"、[count] <> block の内部を選択します。
 			[count] 番目に現れる '<' を検索し、それに対応する '>'
-			までを '<' と '>' を除いて選択します。
+			までを '<' と '>' を除いて選択します。|cpo-M| オプショ
+			ンフラグは、エスケープされた '<' および '>' を処理する
+			ために使用されます。
 			ビジュアルモードで使われたときは、文字単位になります。
 
 						*v_at* *at*
@@ -639,14 +654,16 @@ a}							*v_a}* *a}* *a{*
 a{							*v_aB* *v_a{* *aB*
 aB			"a Block"、[count] Block 選択します。"[count] [{" から
 			それに対応する '}' までで '{' と '}' を含みます(参照
-			|[{|)。
+			|[{|)。|cpo-M| オプションフラグは、エスケープされた中
+			括弧を処理するために使用されます。
 			ビジュアルモードで使われたときは、文字単位になります。
 
 i}							*v_i}* *i}* *i{*
 i{							*v_iB* *v_i{* *iB*
 iB			"inner Block"、[count] Block 選択します。"[count] [{"
 			からそれに対応する '}' までで '{' と '}' を除きます(参
-			照|[{|)。
+			照 |[{|)。|cpo-M| オプションフラグは、エスケープされた
+			中括弧を処理するために使用されます。
 			ビジュアルモードで使われたときは、文字単位になります。
 
 a"							*v_aquote* *aquote*
@@ -674,6 +691,7 @@ i`							*v_i`* *i`*
 			ます。ただし a"/a'/a` とは違い、前後の空白文字は含まれ
 			ません。
 
+							*o_object-select*
 オペレータコマンドの後に使われた場合:
 ブロック以外のオブジェクト:
 	"a" コマンド: オペレータコマンドはオブジェクトとオブジェクトの後に続く
@@ -689,6 +707,7 @@ i`							*v_i`* *i`*
 	マンドは囲んでいる括弧以外に対して施され、"a" コマンドの場合は括弧も含
 	められます。
 
+							*v_object-select*
 ビジュアルモードで使われた場合:
 ビジュアル範囲の初めと終わりが同一の場合(単に "v" と打っただけの場合):
 	オペレータコマンドを使う場合と同様1つのオブジェクトが選択されます。
@@ -1051,14 +1070,14 @@ CTRL-I			ジャンプリストの中の [count] だけ新しいカーソル位
 ストの中を上下に移動することができます。ジャンプリストはそれぞれのウィンドウで
 分かれており、エントリの最大の数は50に固定されています。
 
-例えば、3回ジャンプを行った後ではジャンプリストは次のようになっています:
-
-    jump line  col file/text ~
-      3	  1    0 some text ~
-      2	 70    0 another line ~
-      1  1154   23 end. ~
-   > ~
+例えば、3回ジャンプを行った後ではジャンプリストは次のようになっています: >
 
+    jump line  col file/text
+      3     1    0 some text
+      2    70    0 another line
+      1  1154   23 end.
+   >
+<
 "file/text" 欄はファイル名か現在のファイルであればジャンプするテキストを表示し
 ています(インデントは取り除かれ、そして長い行はウィンドウに合うように短くカッ
 トされます)。
@@ -1067,14 +1086,14 @@ CTRL-I			ジャンプリストの中の [count] だけ新しいカーソル位
 |:jumps| コマンドをフィルタリングした時は表示されないことがある。
 
 現在1167行目にいるとして、CTRL-O コマンドを使うとカーソルは1154行目に移動しま
-す。結果として次のようになります:
-
-    jump line  col file/text ~
-      2	  1    0 some text ~
-      1	 70    0 another line ~
-   >  0  1154   23 end. ~
-      1  1167    0 foo bar ~
+す。結果として次のようになります: >
 
+    jump line  col file/text
+      2     1    0 some text
+      1    70    0 another line
+   >  0  1154   23 end.
+      1  1167    0 foo bar
+<
 ポインターは最後に使われたジャンプ位置にセットされます。次の CTRL-O コマンドは
 エントリの上に、次の CTRL-I コマンドはエントリの下に移動するのに使います。ポイ
 ンターが最後のエントリの下に位置している場合、このことは前に CTRL-I もしくは
@@ -1097,15 +1116,15 @@ CTRL-O を使っていないことを意味します。この場合 CTRL-O コ
 を呼んでもこれはしません。
 
 CTRL-O コマンドを行って1154行目に移動した後、他のジャンプコマンド(例えば: "G")
-を実行したとするとジャンプリストは次のようになります:
-
-    jump line  col file/text ~
-      4	  1    0 some text ~
-      3	 70    0 another line ~
-      2  1167    0 foo bar ~
-      1  1154   23 end. ~
-   > ~
-
+を実行したとするとジャンプリストは次のようになります: >
+
+    jump line  col file/text
+      4     1    0 some text
+      3    70    0 another line
+      2  1167    0 foo bar
+      1  1154   23 end.
+   >
+<
 行が削除されたり挿入された場合は行番号も調整されますが、保存しないで(":n!" コ
 マンドなどを使って)編集を中断した場合は失敗します。
 
@@ -1114,7 +1133,42 @@ CTRL-O コマンドを行って1154行目に移動した後、他のジャンプ
 'viminfo' オプションに項目 ' を含めていると、viminfo ファイルにジャンプリスト
 が保存され、Vim を起動したときに復元されます。
 
+							*jumplist-stack*
+'jumpoptions' オプションに "stack" が含まれている場合、ジャンプリストはタグス
+タックのように動作します。ジャンプリストの途中から新しい場所にジャンプすると
+き、現在の位置より後の場所は捨てられます。このオプションを設定すると、ジャンプ
+位置のツリーを移動することができます。ある枝を上って別の枝を下るときも、CTRL-O
+でツリーをさらに上へ進むことができます。
+
+次のようなジャンプリストがあり、CTRL-O を 3 回使って X の位置に戻ったとする: >
+
+     jump line  col file/text
+       2  1260    8 mark.c		<-- location X-2
+       1   685    0 eval.c		<-- location X-1
+    >  0   462   36 eval.c		<-- location X
+       1   479   39 eval.c
+       2   213    2 mark.c
+       3   181    0 mark.c
+<
+(新しい) 場所 Y にジャンプすると、現在の場所より後の場所が削除される: >
 
+     jump line  col file/text
+       3  1260    8 mark.c		<-- location X-2
+       2   685    0 eval.c		<-- location X-1
+       1   462   36 eval.c		<-- location X
+    >
+<
+そして、さらに別の場所 Z にジャンプすると、新しい場所 Y は、ジャンプリストの場
+所 X の直後に現れ、場所 X は、X から Y への最初のジャンプの前にあった場所
+(X-1、X-2、...) に対して同じ位置にとどまる: >
+
+     jump line  col file/text
+       4  1260    8 mark.c		<-- location X-2
+       3   685    0 eval.c		<-- location X-1
+       2   462   36 eval.c		<-- location X
+       1   100    0 buffer.c		<-- location Y
+    >
+<
 ☆変更リストへのジャンプ		*changelist* *change-list-jumps* *E664*
 
 変更がなされたとき、カーソル位置が記憶されます。アンドゥできる全ての変更に対