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 -f Makefile.tests check
18
19should be sufficient on an Unix system to build and exercise the tests
20for the version of the library installed on the system. Note however
21that there isn't backward compatibility provided so if the installed
22version is older to the testsuite one, failing to compile or run the tests
23is likely. In any event this won't work with an installed libxml2 older
24than 2.6.20.
25Building on other platfroms should be a matter of compiling the C files
26like any other program using libxml2, running the test should be done
27simply by launching the resulting executables.
28
29Daniel Veillard
30Thu Jul 24 2008
31