summaryrefslogtreecommitdiff
path: root/Build/source/libs/gd/libgd-2.1.0/docs/README.TESTING
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/libs/gd/libgd-2.1.0/docs/README.TESTING')
-rw-r--r--Build/source/libs/gd/libgd-2.1.0/docs/README.TESTING62
1 files changed, 62 insertions, 0 deletions
diff --git a/Build/source/libs/gd/libgd-2.1.0/docs/README.TESTING b/Build/source/libs/gd/libgd-2.1.0/docs/README.TESTING
new file mode 100644
index 00000000000..a4c50efe3e6
--- /dev/null
+++ b/Build/source/libs/gd/libgd-2.1.0/docs/README.TESTING
@@ -0,0 +1,62 @@
+|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+
+To run the tests suite, all you need is (add the cmake options if you need any
+or if the default libs and include paths are not the default) :
+
+In a sub directory:
+$ mkdir bld
+$ cd bld
+$ cmake -DBUILD_TEST=1 ..
+$ ctest .
+
+Or if you like to build in the source tree:
+$ cmake -DBUILD_TEST=1 .
+$ ctest .
+
+Add "-DCMAKE_BUILD_TYPE=DEBUG" if you like to have a debug version.
+
+If you like to run the tests against a installed GD library, set the following
+environment variables:
+
+export CMAKE_INCLUDE_PATH=/path/to/the/gd/include
+export CMAKE_LIBRARY_PATH=/path/to/the/gd/lib
+
+then call cmake using:
+
+$ cmake -DUSE_EXT_GD=1 -DBUILD_TEST=1
+$ make
+and finally:
+
+$ ctest .
+
+I will certainly add a nice CMake option to give prefix later.
+
+What to do if tests fail on your platform and you use the last GD release?
+either from your favourite distributions or from http://www.libgd.org or git?
+
+If you use a packaged version of the GD Library (installed from RPM, deb or
+ports, gentoo packages or any other packages format or distribution), please try
+to run the tests using the source releases available at:
+
+http://www.libgd.org/Downloads
+
+If the tests fail using our source release, please report a bug here:
+
+http://bugs.libgd.org
+
+You can attach the two files available in:
+
+./Testing/Temporary
+
+Later versions will have an automatic post mode.
+
+If the tests run successfully, please report a bug to the maintainer of the
+packages (debian, bsd, ubuntu or whoever is responsible for the packages).
+
+Reasons of failures:
+Exception: SegFault: self explaining
+Failed test failed, check the log to know where
+timeout the default timeout is 5 seconds. Some test may
+ have infinite loops when compiled against old versions
+ of the GD library (esp. 2.0.33 or earlier)
+