summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/TODO.txt1
-rw-r--r--doc/testing.txt32
2 files changed, 32 insertions, 1 deletions
diff --git a/doc/TODO.txt b/doc/TODO.txt
index 2202792..26dd6c8 100644
--- a/doc/TODO.txt
+++ b/doc/TODO.txt
@@ -217,7 +217,6 @@ TESTING
o Caching and MDI looks suspicious when the code relies on external resources
which might be loaded from difference locations in different documents
-> we might get a false cache hit
-o Are contructs like "child(0)" cached? Could this give false cache hits?
o Collect "all" available OpenSCAD scripts from the internets and run the integration
tests on them all
o dumptest tests:
diff --git a/doc/testing.txt b/doc/testing.txt
index b64d5a4..c5fb243 100644
--- a/doc/testing.txt
+++ b/doc/testing.txt
@@ -10,6 +10,20 @@ cmake ..
make
make test
+Windows:
+
+First, get a normal build working by following instructions at
+http://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Building_on_Windows
+Then, from the QT command prompt:
+
+cd tests
+mkdir build
+cd build
+cmake .. -DCMAKE_BUILD_TYPE=Release
+sed -i s/\/MD/\/MT/ CMakeCache.txt
+cmake ..
+nmake -f Makefile
+nmake -f Makefile test
Adding a new regression test:
------------------------------
@@ -27,3 +41,21 @@ Adding a new regression test:
Note that test files which don't have an *-expected.<suffix> file will
be ignored for the test apps in question.
+
+Troubleshooting a failed test:
+------------------------------
+
+You can run a single test by passing the test name to ctest:
+ $ ctest -R throwntogethertest_sphere
+
+You can run a series of tests by passing part of a name to ctest:
+ $ ctest -R cgalpng # runs all cgalpng tests
+ $ ctest -R sphere # runs all sphere tests
+
+Logs of test runs are found in tests/build/Testing/Temporary
+Expected results are found in tests/regression/*
+Actual results are found in tests/build/testname-output/*
+
+You can also compile a single test program:
+
+ $ make cgalpngtest
contact: Jan Huwald // Impressum