[llvm-commits] [llvm] r68023 - /llvm/trunk/docs/TestingGuide.html

[Dan Gohman]

On Mar 29, 2009, at 9:37 PM, John Mosby wrote:

> Author: jdm
> Date: Sun Mar 29 23:37:51 2009
> New Revision: 68023
>
> URL: http://llvm.org/viewvc/llvm-project?rev=68023&view=rev
> Log:
> Clarify section on setting up and running test-suite
>
> Modified:
>    llvm/trunk/docs/TestingGuide.html
>
> Modified: llvm/trunk/docs/TestingGuide.html
> URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/TestingGuide.html?rev=68023&r1=68022&r2=68023&view=diff

Hi John,

>
>
> =
> =
> =
> =
> =
> =
> =
> =
> ======================================================================
> --- llvm/trunk/docs/TestingGuide.html (original)
> +++ llvm/trunk/docs/TestingGuide.html Sun Mar 29 23:37:51 2009
> @@ -695,12 +695,14 @@
>
> <p>First, all tests are executed within the LLVM object directory  
> tree.  They
> <i>are not</i> executed inside of the LLVM source tree. This is  
> because the
> -test suite creates temporary files during execution.</p>
> +test suite creates temporary files during execution. This means you  
> must create
> +a build tree separate from the LLVM source tree in which to run the  
> test suite.</p>

Is this true?  Is it not possible to run the test-suite in srdir ==  
objdir mode
when it is run from projects/test-suite?

In fact, there's a major problem with running the test-suite in  
srcdir != objdir
mode -- the objdir contains copies of the srcdir's Makefiles, and the  
copies
are not updated after an svn update.

>
>
> <p>To run the test suite, you need to use the following steps:</p>
>
> <ol>
> -  <li><tt>cd</tt> into the <tt>llvm/projects</tt> directory</li>
> +  <li><tt>cd</tt> into the <tt>llvm/projects</tt> directory in your  
> source tree.
> +  </li>
>
>   <li><p>Check out the <tt>test-suite</tt> module with:</p>
>
> @@ -709,24 +711,35 @@
> % svn co http://llvm.org/svn/llvm-project/test-suite/trunk test-suite
> </pre>
> </div>
> -
> -      <p>This will get the test suite into <tt>llvm/projects/llvm- 
> test</tt></p>
> -
> -  <li><p>Configure the test suite using llvm configure. This will  
> automatically
> -  configure test-suite.  You must do it from the top level  
> otherwise llvm-gcc
> -  will not be set which is required to run llvm-test:</p>
> +      <p>This will get the test suite into <tt>llvm/projects/test- 
> suite</tt>.
> +         <br>[The Makefiles expect the test suite directory to be  
> named either
> +         <tt>test-suite</tt> or <tt>llvm-test</tt>. To be safe, use
> +         <tt>test-suite</tt> as in the above svn command line.]</p>

The name "llvm-test" is a historical artifact. "test-suite" is the  
preferred
name currently.  It would be better to avoid mentioning "llvm-test"  
here,
to avoid confusion.

Dan