testapi: Improve documentation for "wait_screen_change" (os-autoinst#943

) Motivated by os-autoinst/os-autoinst-distri-opensuse#4823 (comment)
Mno-hime · Aug 23, 2018 · 59a9af1 · 59a9af1
1 parent 625f17e
commit 59a9af1
Showing 1 changed file with 5 additions and 3 deletions.
diff --git a/testapi.pm b/testapi.pm
@@ -459,9 +459,11 @@ sub assert_and_dclick {
 
   wait_screen_change(CODEREF [,$timeout [, similarity_level => 50]]);
 
-Wrapper around code that is supposed to change the screen.
-This is the opposite to C<wait_still_screen>. Make sure to put the commands to change the screen
-within the block to avoid races between the action and the screen change.
+Wrapper around code that is supposed to change the screen. This is the
+opposite to C<wait_still_screen>. Make sure to put the commands to change the
+screen within the block to avoid races between the action and the screen
+change. C<wait_screen_change> waits for a screen change after C<CODEREF> was
+executed.
 
 Example: