OLD | NEW |
1 README.tests | 1 README.tests |
2 | 2 |
3 Instructions for standalone test regressions of libxml2 | 3 Instructions for standalone test regressions of libxml2 |
4 | 4 |
5 libxml2-tests-$version.tar.gz contains 3 standalone C programs as well | 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 | 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 | 7 from W3C, NIST, Sun Microsystems, Microsoft and James Clark. Each C |
8 program has a different testing purpose: | 8 program has a different testing purpose: |
9 | 9 |
10 runtest.c : runs libxml2 basic internal regression tests | 10 runtest.c : runs libxml2 basic internal regression tests |
11 runsuite.c: runs libxml2 against external regression tests | 11 runsuite.c: runs libxml2 against external regression tests |
12 testapi.c : exercises the library public entry points | 12 testapi.c : exercises the library public entry points |
13 testchar.c: exercise the check of character ranges and UTF-8 validation | 13 testchar.c: exercise the check of character ranges and UTF-8 validation |
14 | 14 |
15 The command: | 15 The command: |
16 | 16 |
| 17 make check |
| 18 or |
17 make -f Makefile.tests check | 19 make -f Makefile.tests check |
18 | 20 |
19 should be sufficient on an Unix system to build and exercise the tests | 21 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 | 22 for the version of the library installed on the system. Note however |
21 that there isn't backward compatibility provided so if the installed | 23 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 | 24 version is older than 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 | 25 is likely. In any event this won't work with an installed libxml2 older |
24 than 2.6.20. | 26 than 2.6.20. |
25 Building on other platfroms should be a matter of compiling the C files | 27 |
| 28 Building on other platforms should be a matter of compiling the C files |
26 like any other program using libxml2, running the test should be done | 29 like any other program using libxml2, running the test should be done |
27 simply by launching the resulting executables. | 30 simply by launching the resulting executables. |
28 | 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 |
29 Daniel Veillard | 37 Daniel Veillard |
30 Thu Jul 24 2008 | 38 Mon May 7 2012 |
| 39 |
OLD | NEW |