ctests: log a waste and a success

[lyx.git] / development / autotests / README

diff --git a/development/autotests/README b/development/autotests/README
index 62fa6c27a4688fbfe0248c9fb64ea9d65f0832a5..bd28751216f6657fb94e8b88cde1201fa362e63f 100644 (file)
--- a/development/autotests/README
+++ b/development/autotests/README
@@ -19,6 +19,7 @@ The following programs are needed by the testing framework:
          be built before running the tests
 - wmctrl
 - pcregrep
+- Tcl/Tk (wish8.5)
 
 
 USAGE
@@ -57,6 +58,19 @@ Each test-case script should be named as xxx-in.txt. The syntax of the
 script is described in detail in the sample test-case script
 hello-world-in.txt.
 
+Alternatively, a test-case can be an arbitrary executable script with
+name ending in "-in.sh", that is launched inside a dedicated folder,
+and to which the variables LYX_ROOT and LYX_EXE are exported, so that
+you can easily reference the root LyX sources folder and the program
+executable. The test script needs to complete with a no-error return
+value (zero), otherwise a failure is reported (see export-in.sh for
+an example).
+
+Whenever LyX is launched, in both cases, the LYX_USERDIR variable is
+set to autotests/out-home, in order to rely on clean preferences
+settings (use make clean or make without arguments in order to let
+that folder be created again).
+
 
 TODO
 ----------------------------------------------------------------------
@@ -67,3 +81,7 @@ the condition we're waiting for).
 Allow for tests with multiple LyX instances, e.g., for copy&paste
 across LyX instances, or multiple applications, i.e., for testing
 the interaction between LyX and other applications.
+
+The modified xvkbd forces the focus on the specified target window
+(for safety reasons).  Allow for a temporary disable of this within
+the scripts, whenever we need to interact with a pop-up dialog.