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