398
+ − 1 This directory contains XEmacs' automated test suite. The usual way
+ − 2 of running all the tests is running `make check' from the top-level
+ − 3 source directory.
+ − 4
+ − 5 The test suite is unfinished and it's still lacking some essential
+ − 6 features. It is nevertheless recommended that you run the tests to
+ − 7 confirm that XEmacs behaves correctly.
+ − 8
+ − 9 If you want to run a specific test case, you can do it from the
+ − 10 command-line like this:
+ − 11
+ − 12 $ xemacs -batch -l test-harness.elc -f batch-test-emacs TEST-FILE
+ − 13
+ − 14 If something goes wrong, you can run the test suite interactively by
+ − 15 loading `test-harness.el' into a running XEmacs and typing
+ − 16 `M-x test-emacs-test-file RET <filename> RET'. You will see a log of
+ − 17 passed and failed tests, which should allow you to investigate the
+ − 18 source of the error and ultimately fix the bug.
+ − 19
+ − 20 Adding a new test file is trivial: just create a new file here and it
+ − 21 will be run. There is no need to byte-compile any of the files in
+ − 22 this directory -- the test-harness will take care of any necessary
+ − 23 byte-compilation.
+ − 24
+ − 25 Look at the existing test cases for the examples of coding test cases.
+ − 26 It all boils down to your imagination and judicious use of the macros
+ − 27 `Assert', `Check-Error', `Check-Error-Message', and `Check-Message'.
