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:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>