Home | History | Annotate | Download | only in src
      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
     31