Merge pull request #1175 from tsuyoshicho/update/20221016/testing

Update testing.{txt,jax}

Author: h-east

doc/testing.jax

@@ -92,6 +92,7 @@ test_gui_event({event}, {args})
 		    "findrepl"	テキストの検索と置換。
 		    "mouse"	マウスのボタンクリックイベント。
 		    "scrollbar"	スクロールバーの移動もしくはドラッグ。
+		    "sendevent" 低レベル GUI イベントを送出する。
 		    "tabline"	マウスクリックによるタブページ行の選択。
 		    "tabmenu"	タブページ行のメニューエントリの選択。
 
@@ -173,6 +174,16 @@ test_gui_event({event}, {args})
 		    dragging:	1はスクロールバーをドラッグし、0はスクロール
 				バーをクリックする。
 
+		"sendevent":
+		  低レベルの GUI のイベント(例、キーUpやキーDown)を送出する。
+		  現在は MS-Windows のみサポートしている。
+		  {args} でサポートする項目は:
+		    event:	サポートする文字列値は:
+				    keyup   キーUpイベントを生成する
+				    keydown キーDownイベントを生成する
+		    keycode:    キーのUp/Downイベントで使用するキーコード
+								*E1291*
+
 		"tabline":
 		  タブページ行のマウスクリックイベントの注入によるタブページの
 		  選択。{args} でサポートする項目は:
@@ -266,6 +277,9 @@ test_override({name}, {val})				*test_override()*
 		現在、{name} に使える値は:
 
 		{name}	     {val} が非 0 のときの効果 ~
+		alloc_lines  確保したメモリ内に各バッファの行のコピーを作り、
+			     それによりメモリアクセスのエラーが valgrind で検
+			     出できる
 		autoload    `import autoload` でスクリプトを正しい手順でロード
 			     し、項目が使用されるまで延期はしない
 		char_avail   char_avail() 関数を無効化する
@@ -284,7 +298,8 @@ test_override({name}, {val})				*test_override()*
 		uptime 	     sysinfo.uptime を上書きする
 		vterm_title  端末ウィンドウ内でジョブが走っている場合にウィン
 			     ドウタイトルを設定する
-		ALL	     すべての置き換えをクリアする ({val} は使われない)
+		ALL	     alloc_lines 以外のすべての置き換えをクリアする
+			     ({val} は使われない)
 
 		"starting" は、起動が完了したようにテストが振る舞うべきときに
 		使われる。テストはスクリプトを読み込むことによって開始されるの

en/testing.txt

@@ -94,6 +94,7 @@ test_gui_event({event}, {args})
 		    "findrepl"  search and replace text.
 		    "mouse"	mouse button click event.
 		    "scrollbar" move or drag the scrollbar.
+		    "sendevent" send a low-level GUI event.
 		    "tabline"	select a tab page by mouse click.
 		    "tabmenu"	select a tabline menu entry.
 
@@ -177,6 +178,16 @@ test_gui_event({event}, {args})
 		    dragging:	1 to drag the scrollbar and 0 to click in the
 				scrollbar.
 
+		"sendevent":
+		  Send a low-level GUI event (e.g. key-up or down).
+		  Currently only supported on MS-Windows.
+		  The supported items in {args} are:
+		    event:	The supported string values are:
+				    keyup   generate a keyup event
+				    keydown generate a keydown event
+		    keycode:    Keycode to use for a keyup or a keydown event.
+								*E1291*
+
 		"tabline":
 		  Inject a mouse click event on the tabline to select a
 		  tabpage. The supported items in {args} are:
@@ -268,6 +279,9 @@ test_override({name}, {val})				*test_override()*
 		Current supported values for {name} are:
 
 		{name}	     effect when {val} is non-zero ~
+		alloc_lines  make a copy of every buffer line into allocated
+			     memory, so that memory access errors can be found
+			     by valgrind
 		autoload     `import autoload` will load the script right
 			     away, not postponed until an item is used
 		char_avail   disable the char_avail() function
@@ -287,7 +301,8 @@ test_override({name}, {val})				*test_override()*
 		uptime 	     overrules sysinfo.uptime
 		vterm_title  setting the window title by a job running in a
 			     terminal window
-		ALL	     clear all overrides ({val} is not used)
+		ALL	     clear all overrides, except alloc_lines ({val} is
+			     not used)
 
 		"starting" is to be used when a test should behave like
 		startup was done.  Since the tests are run by sourcing a