diff options
author | Daniel Dunbar <daniel@zuster.org> | 2012-05-08 18:11:49 +0000 |
---|---|---|
committer | Daniel Dunbar <daniel@zuster.org> | 2012-05-08 18:11:49 +0000 |
commit | b3593a60ce6e7765fcda58b03338c91991f30dee (patch) | |
tree | db02d17a5f125b86892a8d7ff08fbc656d309aaa /docs | |
parent | 869d817aa7215680ceb2ff976ef4f6df9ff0426b (diff) |
[tests] Remove some remaining DejaGNU related cruft.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@156393 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs')
-rw-r--r-- | docs/TestingGuide.html | 32 |
1 files changed, 12 insertions, 20 deletions
diff --git a/docs/TestingGuide.html b/docs/TestingGuide.html index 1f9c915730..18c3550589 100644 --- a/docs/TestingGuide.html +++ b/docs/TestingGuide.html @@ -309,23 +309,22 @@ clang/test directory. </p> <a href="http://llvm.org/cmds/lit.html">Lit documentation</a> for more information. </p> - <p>The <tt>llvm-runtests</tt> function looks at each file that is passed to - it and gathers any lines together that match "RUN:". These are the "RUN" lines - that specify how the test is to be run. So, each test script must contain - RUN lines if it is to do anything. If there are no RUN lines, the - <tt>llvm-runtests</tt> function will issue an error and the test will - fail.</p> + <p>The <tt>lit</tt> test runner looks at each file that is passed to it and + gathers any lines together that match "RUN:". These are the "RUN" lines that + specify how the test is to be run. So, each test script must contain RUN lines + if it is to do anything. If there are no RUN lines, <tt>lit</tt> function will + issue an error and the test will fail.</p> <p>RUN lines are specified in the comments of the test program using the keyword <tt>RUN</tt> followed by a colon, and lastly the command (pipeline) to execute. Together, these lines form the "script" that - <tt>llvm-runtests</tt> executes to run the test case. The syntax of the - RUN lines is similar to a shell's syntax for pipelines including I/O - redirection and variable substitution. However, even though these lines - may <i>look</i> like a shell script, they are not. RUN lines are interpreted - directly by the Tcl <tt>exec</tt> command. They are never executed by a - shell. Consequently the syntax differs from normal shell script syntax in a - few ways. You can specify as many RUN lines as needed.</p> + <tt>lit</tt> executes to run the test case. The syntax of the RUN lines is + similar to a shell's syntax for pipelines including I/O redirection and + variable substitution. However, even though these lines may <i>look</i> like + a shell script, they are not. RUN lines are interpreted directly by the + Tcl <tt>exec</tt> command. They are never executed by a shell. Consequently + the syntax differs from normal shell script syntax in a few ways. You can + specify as many RUN lines as needed.</p> <p>lit performs substitution on each RUN line to replace LLVM tool names with the full paths to the executable built for each tool (in @@ -813,13 +812,6 @@ define two separate CHECK lines that match on the same line. </pre> </div> - <p>To make the output more useful, the <tt>llvm_runtest</tt> function wil - scan the lines of the test case for ones that contain a pattern that matches - PR[0-9]+. This is the syntax for specifying a PR (Problem Report) number that - is related to the test case. The number after "PR" specifies the LLVM bugzilla - number. When a PR number is specified, it will be used in the pass/fail - reporting. This is useful to quickly get some context when a test fails.</p> - <p>Finally, any line that contains "END." will cause the special interpretation of lines to terminate. This is generally done right after the last RUN: line. This has two side effects: (a) it prevents special |