aboutsummaryrefslogtreecommitdiff
path: root/pthreads/tests/README
diff options
context:
space:
mode:
Diffstat (limited to 'pthreads/tests/README')
-rw-r--r--pthreads/tests/README44
1 files changed, 44 insertions, 0 deletions
diff --git a/pthreads/tests/README b/pthreads/tests/README
new file mode 100644
index 000000000..a1b5646b9
--- /dev/null
+++ b/pthreads/tests/README
@@ -0,0 +1,44 @@
+Running test cases in this directory
+------------------------------------
+
+These make scripts expect to be able to copy the dll, library
+and header files from this directory's parent directory,
+which should be the pthreads-win32 source directory.
+
+MS VC nmake
+-------------
+
+Run the target corresponding to the DLL version being tested:
+
+nmake clean VC
+
+or:
+
+nmake clean VS
+
+
+GNU GCC make
+------------
+
+Run "make clean" and then "make". See the "Known bugs" section
+in ..\README.
+
+
+Writing Test Cases
+------------------
+
+Tests written in this test suite should behave in the following manner:
+
+ * If a test fails, leave main() with a result of 1.
+
+ * If a test succeeds, leave main() with a result of 0.
+
+ * No diagnostic output should appear when the test is succeeding.
+ Diagnostic output may be emitted if something in the test
+ fails, to help determine the cause of the test failure.
+
+Notes:
+------
+
+Many test cases use knowledge of implementation internals which are supposed
+to be opaque to portable applications.