README.tests

   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