1 Automated tests based on the "MonKey Testing" keytest program.
2 ======================================================================
5 ----------------------------------------------------------------------
6 Running the tests in this folder may cause abrupt kill of existing
7 LyX instances on your system. In order to avoid any possible data
8 loss, quit any running instance of LyX in which you're carrying out
9 real work. Also, although precautions have been taken in order to not
10 allow the key presses to reach non-LyX windows, this may sometimes
11 happen anyway. Please, close any running application that is not
16 ----------------------------------------------------------------------
17 The following programs are needed by the testing framework:
18 - xvkbd: a modified copy of xvkbd is included in this folder, and should
19 be built before running the tests
25 ----------------------------------------------------------------------
26 In order to launch all the tests available in this folder, just run
30 and do not interact with your computer while the tests are running.
32 If you wish to launch one or more specific tests, then provide them
33 as argument to the run-tests.sh script, e.g.:
35 ./run-tests.sh <whatever>*-in.txt
37 For failed tests you get a folder with the logs that help you identify
40 Despite the efforts to avoid it, sometimes a test fails simply because
41 the key presses provided to the process are someway lost due to slow
42 hardware, slow window manager, too beautiful and animated desktop,...
43 When this happens, the tests should be run with a higher delay among
44 key presses. The default of 100 milliseconds can be changed by setting
45 the XVKBD_DELAY environment variable.
47 The standard xvkbd available on your system may be used to run the
48 tests. However, a custom xvkbd may optionally be used that forbids the
49 testing framework to type into non-LyX windows and may mitigate the
50 issue described right above. This option can be activated by defining
51 the XVKBD_HACKED environment variable to any value.
55 ----------------------------------------------------------------------
56 Each test-case script should be named as xxx-in.txt. The syntax of the
57 script is described in detail in the sample test-case script
62 ----------------------------------------------------------------------
63 Speed-up the execution of the tests as much as possible (i.e., get rid
64 of heuristic waits when present and replace them with exact check of
65 the condition we're waiting for).
67 Allow for tests with multiple LyX instances, e.g., for copy&paste
68 across LyX instances, or multiple applications, i.e., for testing
69 the interaction between LyX and other applications.