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