Home | History | Annotate | Download | only in libxml2
      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 
     40