diff --git a/docs/TestingGuide.html b/docs/TestingGuide.html index 3be9279673d..b865ff554f0 100644 --- a/docs/TestingGuide.html +++ b/docs/TestingGuide.html @@ -108,9 +108,10 @@ regression tests are in the main "llvm" module under the directory programs in C and C++ is in the llvm-test module. This module should be checked out to the llvm/projects directory. When you configure the llvm module, the llvm-test module -will be automatically configured. Alternatively, you can configure the llvm-test module manually.

-

To run all of the simple tests in LLVM using DejaGNU, use the master Makefile in the -llvm/test directory:

+will be automatically configured. Alternatively, you can configure the + llvm-test module manually.

+

To run all of the simple tests in LLVM using DejaGNU, use the master Makefile + in the llvm/test directory:

 % gmake -C llvm/test
 
@@ -323,11 +324,13 @@ platforms support grep -C. that you might find useful when writing RUN lines.

Lastly, you can easily mark a test that is expected to fail on a -specific platform or with a specific version of llvmgcc by using the XFAIL keyword. Xfail lines are +specific platform or with a specific version of llvmgcc by using the + XFAIL keyword. Xfail lines are specified in the comments of the test program using XFAIL, followed by a colon, and one or more regular expressions (separated by a comma) that will match against the target triplet or llvmgcc version for the -machine. You can use * to match all targets. You can specify the major or full version (i.e. 3.4) for llvmgcc. Here is an example of an +machine. You can use * to match all targets. You can specify the major or full + version (i.e. 3.4) for llvmgcc. Here is an example of an XFAIL line:

 ; XFAIL: darwin,sun,llvmgcc4
@@ -402,8 +405,8 @@ specify the following configuration options:

are not executed inside of the LLVM source tree. This is because the test suite creates temporary files during execution.

-

The master Makefile in llvm/test is capable of running only the DejaGNU driven -tests. By default, it will run all of these tests.

+

The master Makefile in llvm/test is capable of running only the DejaGNU +driven tests. By default, it will run all of these tests.

To run only the DejaGNU driven tests, run gmake at the command line in llvm/test. To run a specific directory of tests, use @@ -432,7 +435,8 @@ directory to run them.

properly configured.
  • Use the configure script found in the llvm-test source directory:
    - $LLVM_SRC_ROOT/projects/llvm-test/configure --with-llvmsrc=$LLVM_SRC_ROOT --with-llvmobj=$LLVM_OBJ_ROOT + $LLVM_SRC_ROOT/projects/llvm-test/configure + --with-llvmsrc=$LLVM_SRC_ROOT --with-llvmobj=$LLVM_OBJ_ROOT
  • gmake
  • @@ -483,11 +487,12 @@ programs don't break as well as keep track of LLVM's progress over time.

    If you'd like to set up an instance of the nightly tester to run on your machine, take a look at the comments at the top of the utils/NightlyTester.pl file. We usually run it from a crontab entry -that looks ilke this:

    +that looks like this:

    -5 3 * * *  $HOME/llvm/utils/NightlyTest.pl -parallel $CVSROOT $HOME/buildtest-X86 $HOME/cvs/testresults-X86
    +5 3 * * *  $HOME/llvm/utils/NightlyTest.pl -parallel $CVSROOT \
    +           $HOME/buildtest $HOME/cvs/testresults
     
    @@ -506,8 +511,10 @@ export PATH=/proj/install/bin:$LLVMGCCDIR/bin:$PATH export LD_LIBRARY_PATH=/proj/install/lib cd $BASE cp /proj/work/llvm/llvm/utils/NightlyTest.pl . -nice ./NightlyTest.pl -nice -release -verbose -parallel -enable-linscan -noexternals 2>&1 > output.log -mail -s 'X86 nightly tester results' llvm-testresults@cs.uiuc.edu < output.log +nice ./NightlyTest.pl -nice -release -verbose -parallel -enable-linscan \ + -noexternals 2>&1 > output.log +mail -s 'X86 nightly tester results' llvm-testresults@cs.uiuc.edu < output.log