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

[Tanya Lattner]

On Mar 30, 2009, at 9:49 AM, Dan Gohman wrote:

>
> 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?
>

This is NOT true. I test this every single time I do a release  
(srcdir=objdir). Please undo this change to the documentation.

-Tanya




> 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
>
> _______________________________________________
> llvm-commits mailing list
> llvm-commits at cs.uiuc.edu
> http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20090330/f2612597/attachment.html>