summaryrefslogtreecommitdiffstats
path: root/testing/README.txt
diff options
context:
space:
mode:
authorDimitri van Heesch <dimitri@stack.nl>2018-04-22 09:59:38 (GMT)
committerGitHub <noreply@github.com>2018-04-22 09:59:38 (GMT)
commit18dc9836c248ae89276a8e5f110abca12a56b06e (patch)
tree8efd17ae84a8e3bb397f0f8e6df329e49276fcea /testing/README.txt
parent375eb0646db09d6a3b359814141ba1696f5d8b19 (diff)
parent95a6451107f8964b1c2290e2f4e9761a64be124b (diff)
downloadDoxygen-18dc9836c248ae89276a8e5f110abca12a56b06e.zip
Doxygen-18dc9836c248ae89276a8e5f110abca12a56b06e.tar.gz
Doxygen-18dc9836c248ae89276a8e5f110abca12a56b06e.tar.bz2
Merge pull request #693 from albert-github/feature/bug_tests_xhtml_pdf
Create test possibilities for xhtml and pdf output
Diffstat (limited to 'testing/README.txt')
-rw-r--r--testing/README.txt30
1 files changed, 21 insertions, 9 deletions
diff --git a/testing/README.txt b/testing/README.txt
index 9452896..a5a0ad9 100644
--- a/testing/README.txt
+++ b/testing/README.txt
@@ -7,17 +7,27 @@ has the same 3 digit number. The directory contains one or more reference
files that are compared against the XML output produced by doxygen. If the
result is the same, there is no regression and the test passes. If there is a
difference the test fails and the difference (in diff -u format) will be shown.
+It is also possible to see whether or not the test can be build to a xhtml set
+of files (and tested against a DTD), it is also possible to create a pdf file
+for each test to see if the LaTeX / pdf generation is possible.
The runtest.py script responsible for running the tests takes a number of
optional parameters:
--id n: run test with number n only (the option may be specified
- multiple times) default is to run all tests.
--updateref: update the reference files. Should be used in combination
- with -id to update the reference file(s) for the given test.
--all: can be used in combination with -updateref to update the
- reference files for all tests.
--doxygen exe: run the specified doxygen executable.
--xmllint exe: run the specified xmllint executable.
+ --updateref update the reference data for a test
+ --doxygen [DOXYGEN] path/name of the doxygen executable
+ --xmllint [XMLLINT] path/name of the xmllint executable
+ --id IDS [IDS ...] id of the test to perform
+ --all perform all tests
+ --inputdir [INPUTDIR]
+ input directory containing the tests
+ --outputdir [OUTPUTDIR]
+ output directory to write the doxygen output to
+ --noredir disable redirection of doxygen warnings
+ --xml create xml output and check
+ --xhtml create xhtml output and check with xmllint
+ --pdf create LaTeX output and create pdf from it
+ --keep keep result directories
+In case neither --xml, --pdf or --xhtml is used the default is set to --xml.
The runtest.pl has the following dependencies on 3rd party tools:
- python to run the script
@@ -44,5 +54,7 @@ Example to update the reference files for a test
python runtest.py -updateref -id 10
There is also a CMakeLists.txt, which can be used from the build directory
-to run all tests by simply invoking 'make tests'.
+to run all tests by simply invoking 'make tests', to use the specific options use
+the flag TEST_FLAGS with make
+ e.g. make tests TEST_FLAGS="--id=5 --id=10 --pdf --xhtml"