annotate readme.txt @ 630:ecb96b2bf5cb

fixed module declaration
author thomask
date Sun, 14 Aug 2005 08:38:17 +0000
parents 79242ce0cf34
children 463c60e26040
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
3269e4627918 init dstress
svnowner
parents:
diff changeset
1 Project:
3269e4627918 init dstress
svnowner
parents:
diff changeset
2 DStress
3269e4627918 init dstress
svnowner
parents:
diff changeset
3
239
c2a96b326f61 repos & copyright maintenance
thomask
parents: 199
diff changeset
4 Copyright:
c2a96b326f61 repos & copyright maintenance
thomask
parents: 199
diff changeset
5 (c) 2004, 2005 Thomas Kühne; GNU General Public License
c2a96b326f61 repos & copyright maintenance
thomask
parents: 199
diff changeset
6
0
3269e4627918 init dstress
svnowner
parents:
diff changeset
7 URL:
239
c2a96b326f61 repos & copyright maintenance
thomask
parents: 199
diff changeset
8 http://dstress.kuehne.cn/www/dstress.html
c2a96b326f61 repos & copyright maintenance
thomask
parents: 199
diff changeset
9 http://dstress.kuehne.cn/ (svn access)
12
815d4615b4fa added dstress email address
unknown
parents: 0
diff changeset
10 mailto:dstress@kuehne.cn
0
3269e4627918 init dstress
svnowner
parents:
diff changeset
11
3269e4627918 init dstress
svnowner
parents:
diff changeset
12 Description:
3269e4627918 init dstress
svnowner
parents:
diff changeset
13 stress tests and bug checks for D-language compilers
3269e4627918 init dstress
svnowner
parents:
diff changeset
14
112
f0f9ea1653e4 added GnuMake version notice
thomask
parents: 110
diff changeset
15 Requirements:
f0f9ea1653e4 added GnuMake version notice
thomask
parents: 110
diff changeset
16 1) a D compiler
f0f9ea1653e4 added GnuMake version notice
thomask
parents: 110
diff changeset
17 2) GnuMake, at least 3.80(2002-10-03)
f0f9ea1653e4 added GnuMake version notice
thomask
parents: 110
diff changeset
18 3.79(2000-04-11) does NOT support the eval function
f0f9ea1653e4 added GnuMake version notice
thomask
parents: 110
diff changeset
19
0
3269e4627918 init dstress
svnowner
parents:
diff changeset
20 Condition Passed:
3269e4627918 init dstress
svnowner
parents:
diff changeset
21 1) no assertion is thrown
3269e4627918 init dstress
svnowner
parents:
diff changeset
22 and 2) return value of main is 0 (zero)
3269e4627918 init dstress
svnowner
parents:
diff changeset
23
3269e4627918 init dstress
svnowner
parents:
diff changeset
24 Condition Failed:
3269e4627918 init dstress
svnowner
parents:
diff changeset
25 1) compiler error
3269e4627918 init dstress
svnowner
parents:
diff changeset
26 2) linker error
3269e4627918 init dstress
svnowner
parents:
diff changeset
27 3) wrong assertion
3269e4627918 init dstress
svnowner
parents:
diff changeset
28 4) return value of main isn't 0 (zero)
3269e4627918 init dstress
svnowner
parents:
diff changeset
29
72
b0e95b878322 added segfault detection support
thomask
parents: 70
diff changeset
30 Output Synopsis: (DejaGnu / POSIX 1003.3)
500
ccdef53efcee updated result pages
thomask
parents: 341
diff changeset
31 PASS: - test case was expected to pass, and it did
ccdef53efcee updated result pages
thomask
parents: 341
diff changeset
32 XPASS: - test case was expected to fail, but passed
ccdef53efcee updated result pages
thomask
parents: 341
diff changeset
33 FAIL: - test case was expected to pass, but failed
ccdef53efcee updated result pages
thomask
parents: 341
diff changeset
34 XFAIL: - test case was expected to fail, and it did
ccdef53efcee updated result pages
thomask
parents: 341
diff changeset
35 ERROR: - compiler, linker or test case segfaulted;
517
79242ce0cf34 [recover dummy]
thomask
parents: 500
diff changeset
36 - resource limit (480 seconds per test case / 500MB)
500
ccdef53efcee updated result pages
thomask
parents: 341
diff changeset
37 - inapropiate error messages
70
5f98d4a33d49 1) review of all test cases with unexpected results (except encoding and html/xml)
thomask
parents: 12
diff changeset
38
253
4cf5a45bf77d added testing hints to readme.txt
thomask
parents: 239
diff changeset
39 Testing:
4cf5a45bf77d added testing hints to readme.txt
thomask
parents: 239
diff changeset
40 1) the environment variable $DMD / %DMD% is used to detect the compiler executeable
341
b541f2516cd4 documented __DSTRESS_ELINE__ and __DSTRESS_EFILE__
thomask
parents: 253
diff changeset
41 2) the environment variable $DFLAGS / %DFLAGS% is used for additional compiler arguments
253
4cf5a45bf77d added testing hints to readme.txt
thomask
parents: 239
diff changeset
42 3) run as "make distclean all"
4cf5a45bf77d added testing hints to readme.txt
thomask
parents: 239
diff changeset
43 4) for manual tests used the "dstress.c" source, e.g.
4cf5a45bf77d added testing hints to readme.txt
thomask
parents: 239
diff changeset
44 ./dstress nocompile ./the_source_file.d
4cf5a45bf77d added testing hints to readme.txt
thomask
parents: 239
diff changeset
45 ./dstress run ./some_dir/source.html
4cf5a45bf77d added testing hints to readme.txt
thomask
parents: 239
diff changeset
46
70
5f98d4a33d49 1) review of all test cases with unexpected results (except encoding and html/xml)
thomask
parents: 12
diff changeset
47 Source code comments:
85
659bb018c489 1) changed "?DSTRESS_FLAGS?" to "__DSTRESS_DFLAGS__" in order to cope with botched shells
thomask
parents: 82
diff changeset
48 @author@ reporter / author
659bb018c489 1) changed "?DSTRESS_FLAGS?" to "__DSTRESS_DFLAGS__" in order to cope with botched shells
thomask
parents: 82
diff changeset
49 @date@ year-month-day
659bb018c489 1) changed "?DSTRESS_FLAGS?" to "__DSTRESS_DFLAGS__" in order to cope with botched shells
thomask
parents: 82
diff changeset
50 @uri@ message id
659bb018c489 1) changed "?DSTRESS_FLAGS?" to "__DSTRESS_DFLAGS__" in order to cope with botched shells
thomask
parents: 82
diff changeset
51 @url@ message xRef
659bb018c489 1) changed "?DSTRESS_FLAGS?" to "__DSTRESS_DFLAGS__" in order to cope with botched shells
thomask
parents: 82
diff changeset
52 @WARNING@ external dependencies (e.g. Phobos)
114
8c93469d5ac4 1) added @bugwatch@ tag
thomask
parents: 112
diff changeset
53 @bugwatch@ marks glitches used to hide bugs in external dependencies
239
c2a96b326f61 repos & copyright maintenance
thomask
parents: 199
diff changeset
54 __DSTRESS_DFLAGS__ everything following in the same line will be interpreted
c2a96b326f61 repos & copyright maintenance
thomask
parents: 199
diff changeset
55 as _additional_ compiler flags
341
b541f2516cd4 documented __DSTRESS_ELINE__ and __DSTRESS_EFILE__
thomask
parents: 253
diff changeset
56 __DSTRESS_ELINE__ offending source line (error line)
b541f2516cd4 documented __DSTRESS_ELINE__ and __DSTRESS_EFILE__
thomask
parents: 253
diff changeset
57 __DSTRESS_EFILE__ offending source file (error file)