X-Git-Url: http://plrg.eecs.uci.edu/git/?a=blobdiff_plain;f=docs%2FTestingGuide.html;h=c39065a2824eb9279ef0043ff9a549880c6dd92e;hb=8d4bbbeffff518237765cf9c8493678e11f5248e;hp=8e1041ec2a0cbce65d14b96c9e075ef9376092a8;hpb=eec96958cd53ebb61bebfd3af416ace380df6f6c;p=oota-llvm.git diff --git a/docs/TestingGuide.html b/docs/TestingGuide.html index 8e1041ec2a0..c39065a2824 100644 --- a/docs/TestingGuide.html +++ b/docs/TestingGuide.html @@ -671,17 +671,17 @@ simple example:

 ; CHECK: test5:
-; CHECK:    notw	[[REG:%[a-z]+]]
-; CHECK:    andw	{{.*}}[[REG]]
+; CHECK:    notw	[[REGISTER:%[a-z]+]]
+; CHECK:    andw	{{.*}}[[REGISTER]]
 
-

The first check line matches a regex (%[a-z]+) and captures it into the -variables "REG". The second line verifies that whatever is in REG occurs later -in the file after an "andw". FileCheck variable references are always contained -in [[ ]] pairs, are named, and their names can be formed with the regex -"[a-zA-Z][a-zA-Z0-9]*". If a colon follows the name, then it is a definition of -the variable, if not, it is a use.

+

The first check line matches a regex (%[a-z]+) and captures it into +the variables "REGISTER". The second line verifies that whatever is in REGISTER +occurs later in the file after an "andw". FileCheck variable references are +always contained in [[ ]] pairs, are named, and their names can be +formed with the regex "[a-zA-Z][a-zA-Z0-9]*". If a colon follows the +name, then it is a definition of the variable, if not, it is a use.

FileCheck variables can be defined multiple times, and uses always get the latest value. Note that variables are all read at the start of a "CHECK" line @@ -693,8 +693,6 @@ that FileCheck is not actually line-oriented when it matches, this allows you to define two separate CHECK lines that match on the same line.

- - @@ -761,12 +759,6 @@ substitutions
The full path to the llvm-gxx executable as specified in the configured LLVM environment
-
llvmgcc_version (%llvmgcc_version)
-
The full version number of the llvm-gcc executable.
- -
llvmgccmajvers (%llvmgccmajvers)
-
The major version number of the llvm-gcc executable.
-
gccpath
The full path to the C compiler used to build LLVM. Note that this might not be gcc.
@@ -824,22 +816,20 @@ substitutions

Sometimes it is necessary to mark a test case as "expected fail" or XFAIL. - You can easily mark a test as XFAIL just by including XFAIL: on a + You can easily mark a test as XFAIL just by including XFAIL: on a line near the top of the file. This signals that the test case should succeed if the test fails. Such test cases are counted separately by DejaGnu. To specify an expected fail, use the XFAIL keyword in the comments of the test program followed by a colon and one or more regular expressions (separated by - a comma). The regular expressions allow you to XFAIL the test conditionally - by host platform. The regular expressions following the : are matched against - the target triplet or llvmgcc version number for the host machine. If there is - a match, the test is expected to fail. If not, the test is expected to - succeed. To XFAIL everywhere just specify XFAIL: *. When matching - the llvm-gcc version, you can specify the major (e.g. 3) or full version - (i.e. 3.4) number. Here is an example of an XFAIL line:

+ a comma). The regular expressions allow you to XFAIL the test conditionally by + host platform. The regular expressions following the : are matched against the + target triplet for the host machine. If there is a match, the test is expected + to fail. If not, the test is expected to succeed. To XFAIL everywhere just + specify XFAIL: *. Here is an example of an XFAIL line:

-; XFAIL: darwin,sun,llvmgcc4
+; XFAIL: darwin,sun
 
@@ -1145,7 +1135,6 @@ example reports that can do fancy stuff.

-
Running the nightly tester