aniani/elinks
1
0
Fork 0
mirror of https://github.com/rkd77/elinks.git synced 2024-12-04 14:46:47 -05:00
Code

Realign the test docs with reality

Browse Source
This commit is contained in:
Jonas Fonseca 2006-01-06 18:32:22 +01:00 committed by Jonas Fonseca
parent b1514c7a35
commit 5f5c78a87f
1 changed files with 17 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
src/dom/test/README
View File

@ -1,7 +1,7 @@
Core GIT Tests ELinks testing infrastructure
============== =============================
This directory holdstest scripts for the DOM implementation. The first part of This directory holds test scripts for the DOM implementation. The first part of
this short document describes how to run the tests and read their output. this short document describes how to run the tests and read their output.
When fixing the tools or adding enhancements, you are strongly encouraged to When fixing the tools or adding enhancements, you are strongly encouraged to
@ -27,7 +27,7 @@ The easiest way to run tests is to say "make test". This runs all the tests.
Or you can run each test individually from command line, like this: Or you can run each test individually from command line, like this:
$ sh ./test-sgml-parser-basic $ TEST_LIB=${path_to_top_srcdir}/test/libtest.sh sh ./test-sgml-parser-basic
* ok 1: parse a small document. * ok 1: parse a small document.
... ...
* ok 23: parse a CDATA section. * ok 23: parse a CDATA section.
@ -49,6 +49,10 @@ command line argument to the test.
This causes the test to immediately exit upon the first This causes the test to immediately exit upon the first
failed test. failed test.
Note, these options can be passed indirectly to all tests when running test using
make by setting TEST_OPTS, like this:
make test TEST_OPTS=--immediate
Naming Tests Naming Tests
------------ ------------
@ -91,20 +95,23 @@ The test script is written as a shell script. It should start with the standard
Source 'libtest' Source 'libtest'
-------------------- ----------------
After assigning test_description, the test script should source test-lib.sh After assigning test_description, the test script should source the shell test
like this: library like this:
. ./libtest . "$TEST_LIB"
This assumes that the TEST_LIB environment variable has been set and is needed
for test to run from out of tree builds.
This test harness library does the following things: This test harness library does the following things:
- If the script is invoked with command line argument --help (or -h), it shows - If the script is invoked with command line argument --help (or -h), it shows
the test_description and exits. the test_description and exits.
- Creates an empty test directory. This directory is 'test/trash' if you must - Creates an empty test directory. This directory is 'trash' if you must know,
know, but I do not think you care. but I do not think you care.
- Defines standard test helper functions for your scripts to use. These - Defines standard test helper functions for your scripts to use. These
functions are designed to make all scripts behave consistently when command functions are designed to make all scripts behave consistently when command