1                       README.tests
2
3   Instructions for standalone test regressions of libxml2
4
5libxml2-tests-$version.tar.gz contains 3 standalone C programs as well
6as a large amount of tests and results coming from libxml2 itself and
7from W3C, NIST, Sun Microsystems, Microsoft and James Clark. Each C
8program has a different testing purpose:
9
10  runtest.c : runs libxml2 basic internal regression tests
11  runsuite.c: runs libxml2 against external regression tests
12  testapi.c : exercises the library public entry points
13  testchar.c: exercise the check of character ranges and UTF-8 validation
14
15The command:
16
17  make check
18or
19  make -f Makefile.tests check
20
21should be sufficient on an Unix system to build and exercise the tests
22for the version of the library installed on the system. Note however
23that there isn't backward compatibility provided so if the installed
24version is older than the testsuite one, failing to compile or run the tests
25is likely. In any event this won't work with an installed libxml2 older
26than 2.6.20.
27
28Building on other platforms should be a matter of compiling the C files
29like any other program using libxml2, running the test should be done
30simply by launching the resulting executables.
31
32Also note the availability of a "make valgrind" target which will run the
33above tests under valgrind to check for memory errors (but this relies
34on the availability of the valgrind command and take far more time to
35complete).
36
37Daniel Veillard
38Mon May  7 2012
39
40