mirror of
https://github.com/c64scene-ar/llvm-6502.git
synced 2024-10-10 16:24:04 +00:00
Clarify how to configure llvm-gcc-4.2 for use with
test suite. Remove documentation for --with-f2c, which is no longer supported. Remove information about obtaining tcl/expect, which ship with Mac OS X by default since 10.4. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@74271 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
parent
5202312d2e
commit
1b6d3daa59
@ -78,27 +78,8 @@ required to build LLVM, plus the following:</p>
|
|||||||
<dd>Expect is required by DejaGNU.</dd>
|
<dd>Expect is required by DejaGNU.</dd>
|
||||||
<dt><a href="http://www.tcl.tk/software/tcltk/">tcl</a></dt>
|
<dt><a href="http://www.tcl.tk/software/tcltk/">tcl</a></dt>
|
||||||
<dd>Tcl is required by DejaGNU. </dd>
|
<dd>Tcl is required by DejaGNU. </dd>
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li><tt>./configure --with-f2c=$DIR</tt><br>
|
|
||||||
This will specify a new <tt>$DIR</tt> for the above-described search
|
|
||||||
process. This will only work if the binary, header, and library are in their
|
|
||||||
respective subdirectories of <tt>$DIR</tt>.</li>
|
|
||||||
|
|
||||||
<li><tt>./configure --with-f2c-bin=/binary/path --with-f2c-inc=/include/path
|
|
||||||
--with-f2c-lib=/lib/path</tt><br>
|
|
||||||
This allows you to specify the F2C components separately. Note: if you choose
|
|
||||||
this route, you MUST specify all three components, and you need to only specify
|
|
||||||
<em>directories</em> where the files are located; do NOT include the
|
|
||||||
filenames themselves on the <tt>configure</tt> line.</li>
|
|
||||||
</ul></dd>
|
|
||||||
</dl>
|
</dl>
|
||||||
|
|
||||||
<p>Darwin (Mac OS X) developers can simplify the installation of Expect and tcl
|
|
||||||
by using fink. <tt>fink install expect</tt> will install both. Alternatively,
|
|
||||||
Darwinports users can use <tt>sudo port install expect</tt> to install Expect
|
|
||||||
and tcl.</p>
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<!--=========================================================================-->
|
<!--=========================================================================-->
|
||||||
@ -122,14 +103,17 @@ tests" and are in the <tt>llvm</tt> module in subversion under the
|
|||||||
|
|
||||||
<div class="doc_text">
|
<div class="doc_text">
|
||||||
|
|
||||||
<p>Code fragments are small pieces of code that test a specific feature of LLVM
|
<p>Code fragments are small pieces of code that test a specific
|
||||||
or trigger a specific bug in LLVM. They are usually written in LLVM assembly
|
feature of LLVM or trigger a specific bug in LLVM. They are usually
|
||||||
language, but can be written in other languages if the test targets a particular
|
written in LLVM assembly language, but can be written in other
|
||||||
language front end. These tests are driven by the DejaGNU testing framework,
|
languages if the test targets a particular language front end (and the
|
||||||
which is hidden behind a few simple makefiles.</p>
|
appropriate <tt>--with-llvmgcc</tt> options were used
|
||||||
|
at <tt>configure</tt> time of the <tt>llvm</tt> module). These tests
|
||||||
|
are driven by the DejaGNU testing framework, which is hidden behind a
|
||||||
|
few simple makefiles.</p>
|
||||||
|
|
||||||
<p>These code fragments are not complete programs. The code generated from them is
|
<p>These code fragments are not complete programs. The code generated
|
||||||
never executed to determine correct behavior.</p>
|
from them is never executed to determine correct behavior.</p>
|
||||||
|
|
||||||
<p>These code fragment tests are located in the <tt>llvm/test</tt>
|
<p>These code fragment tests are located in the <tt>llvm/test</tt>
|
||||||
directory.</p>
|
directory.</p>
|
||||||
@ -251,10 +235,18 @@ programs), first checkout and setup the <tt>test-suite</tt> module:</p>
|
|||||||
% cd ..
|
% cd ..
|
||||||
% ./configure --with-llvmgccdir=$LLVM_GCC_DIR
|
% ./configure --with-llvmgccdir=$LLVM_GCC_DIR
|
||||||
</pre>
|
</pre>
|
||||||
<p>where <tt>$LLVM_GCC_DIR</tt> is the directory where you <em>installed</em>
|
|
||||||
llvm-gcc, not it's src or obj dir.</p>
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<p>where <tt>$LLVM_GCC_DIR</tt> is the directory where
|
||||||
|
you <em>installed</em> llvm-gcc, not it's src or obj
|
||||||
|
dir. The <tt>--with-llvmgccdir</tt> option assumes that
|
||||||
|
the <tt>llvm-gcc-4.2</tt> module was configured with
|
||||||
|
<tt>--program-prefix=llvm-</tt>, and therefore that the C and C++
|
||||||
|
compiler drivers are called <tt>llvm-gcc</tt> and <tt>llvm-g++</tt>
|
||||||
|
respectively. If this is not the case,
|
||||||
|
use <tt>--with-llvmgcc</tt>/<tt>--with-llvmgxx</tt> to specify each
|
||||||
|
executable's location.</p>
|
||||||
|
|
||||||
<p>Then, run the entire test suite by running make in the <tt>test-suite</tt>
|
<p>Then, run the entire test suite by running make in the <tt>test-suite</tt>
|
||||||
directory:</p>
|
directory:</p>
|
||||||
|
|
||||||
@ -448,6 +440,11 @@ that subdirectory.</p>
|
|||||||
</pre>
|
</pre>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<p>If your system includes GNU <tt>grep</tt>, make sure
|
||||||
|
that <tt>GREP_OPTIONS</tt> is not set in your environment. Otherwise,
|
||||||
|
you may get invalid results (both false positives and false
|
||||||
|
negatives).</p>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<!-- _______________________________________________________________________ -->
|
<!-- _______________________________________________________________________ -->
|
||||||
@ -746,6 +743,8 @@ test suite creates temporary files during execution.</p>
|
|||||||
have the suite checked out and configured, you don't need to do it again (unless
|
have the suite checked out and configured, you don't need to do it again (unless
|
||||||
the test code or configure script changes).</p>
|
the test code or configure script changes).</p>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
<!-- _______________________________________________________________________ -->
|
<!-- _______________________________________________________________________ -->
|
||||||
<div class="doc_subsection">
|
<div class="doc_subsection">
|
||||||
<a name="testsuiteexternal">Configuring External Tests</a></div>
|
<a name="testsuiteexternal">Configuring External Tests</a></div>
|
||||||
|
@ -22,6 +22,10 @@ include Makefile.tests
|
|||||||
# DejaGNU testing support
|
# DejaGNU testing support
|
||||||
#===------------------------------------------------------------------------===#
|
#===------------------------------------------------------------------------===#
|
||||||
|
|
||||||
|
ifneq ($(GREP_OPTIONS),)
|
||||||
|
$(warning GREP_OPTIONS environment variable may interfere with test results)
|
||||||
|
endif
|
||||||
|
|
||||||
ifdef VERBOSE
|
ifdef VERBOSE
|
||||||
RUNTESTFLAGS := $(VERBOSE)
|
RUNTESTFLAGS := $(VERBOSE)
|
||||||
endif
|
endif
|
||||||
|
Loading…
Reference in New Issue
Block a user