[llvm-commits] CVS: llvm-www/releases/1.1/docs/AliasAnalysis.html CFEBuildInstrs.html CodingStandards.html CommandLine.html FAQ.html GettingStarted.html HowToSubmitABug.html LLVMVsTheWorld.html LangRef.html OpenProjects.html Projects.html ReleaseNotes.html Stacker.html TestingGuide.html
John Criswell
criswell at cs.uiuc.edu
Wed Dec 17 16:48:01 PST 2003
Changes in directory llvm-www/releases/1.1/docs:
AliasAnalysis.html updated: 1.1 -> 1.2
CFEBuildInstrs.html updated: 1.1 -> 1.2
CodingStandards.html updated: 1.1 -> 1.2
CommandLine.html updated: 1.1 -> 1.2
FAQ.html updated: 1.1 -> 1.2
GettingStarted.html updated: 1.1 -> 1.2
HowToSubmitABug.html updated: 1.1 -> 1.2
LLVMVsTheWorld.html updated: 1.1 -> 1.2
LangRef.html updated: 1.1 -> 1.2
OpenProjects.html updated: 1.1 -> 1.2
Projects.html updated: 1.1 -> 1.2
ReleaseNotes.html updated: 1.3 -> 1.4
Stacker.html updated: 1.1 -> 1.2
TestingGuide.html updated: 1.1 -> 1.2
---
Log message:
Updating to new docs in LLVM tarball.
---
Diffs of the changes: (+254 -165)
Index: llvm-www/releases/1.1/docs/AliasAnalysis.html
diff -u llvm-www/releases/1.1/docs/AliasAnalysis.html:1.1 llvm-www/releases/1.1/docs/AliasAnalysis.html:1.2
--- llvm-www/releases/1.1/docs/AliasAnalysis.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/AliasAnalysis.html Wed Dec 17 16:47:16 2003
@@ -486,7 +486,7 @@
<a href="mailto:sabre at nondot.org">Chris Lattner</a><br>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a><br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</address>
</body>
Index: llvm-www/releases/1.1/docs/CFEBuildInstrs.html
diff -u llvm-www/releases/1.1/docs/CFEBuildInstrs.html:1.1 llvm-www/releases/1.1/docs/CFEBuildInstrs.html:1.2
--- llvm-www/releases/1.1/docs/CFEBuildInstrs.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/CFEBuildInstrs.html Wed Dec 17 16:47:16 2003
@@ -262,7 +262,7 @@
<address>Brian Gaeke</address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
<br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</div>
</body>
Index: llvm-www/releases/1.1/docs/CodingStandards.html
diff -u llvm-www/releases/1.1/docs/CodingStandards.html:1.1 llvm-www/releases/1.1/docs/CodingStandards.html:1.2
--- llvm-www/releases/1.1/docs/CodingStandards.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/CodingStandards.html Wed Dec 17 16:47:16 2003
@@ -952,7 +952,7 @@
<address><a href="mailto:sabre at nondot.org">Chris Lattner</a></address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
<br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</div>
</body>
Index: llvm-www/releases/1.1/docs/CommandLine.html
diff -u llvm-www/releases/1.1/docs/CommandLine.html:1.1 llvm-www/releases/1.1/docs/CommandLine.html:1.2
--- llvm-www/releases/1.1/docs/CommandLine.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/CommandLine.html Wed Dec 17 16:47:16 2003
@@ -1692,7 +1692,7 @@
<address><a href="mailto:sabre at nondot.org">Chris Lattner</a></address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
<br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</div>
</body>
Index: llvm-www/releases/1.1/docs/FAQ.html
diff -u llvm-www/releases/1.1/docs/FAQ.html:1.1 llvm-www/releases/1.1/docs/FAQ.html:1.2
--- llvm-www/releases/1.1/docs/FAQ.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/FAQ.html Wed Dec 17 16:47:16 2003
@@ -438,7 +438,7 @@
<div class="doc_footer">
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
<br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</div>
</body>
Index: llvm-www/releases/1.1/docs/GettingStarted.html
diff -u llvm-www/releases/1.1/docs/GettingStarted.html:1.1 llvm-www/releases/1.1/docs/GettingStarted.html:1.2
--- llvm-www/releases/1.1/docs/GettingStarted.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/GettingStarted.html Wed Dec 17 16:47:16 2003
@@ -182,24 +182,55 @@
<li>Linux on x86 (Pentium and above)
<ul>
- <li>Approximately 760 MB of Free Disk Space
+ <li>Approximately 918 MB of Free Disk Space
<ul>
- <li>Source code: 30 MB</li>
- <li>Object code: 670 MB</li>
- <li>GCC front end: 60 MB</li>
+ <li>Source code: 28 MB</li>
+ <li>Object code: 850 MB</li>
+ <li>GCC front end: 40 MB</li>
</ul></li>
- </ul></li>
+ </ul>
+ </li>
+
+ <p></p>
<li>Solaris on SparcV9 (Ultrasparc)
<ul>
- <li>Approximately 1.24 GB of Free Disk Space
+ <li>Approximately 1.52 GB of Free Disk Space
+ <ul>
+ <li>Source code: 28 MB</li>
+ <li>Object code: 1470 MB</li>
+ <li>GCC front end: 50 MB</li>
+ </ul></li>
+ </ul>
+ </li>
+
+ <p></p>
+
+ <li>FreeBSD on x86 (Pentium and above)
+ <ul>
+ <li>Approximately 918 MB of Free Disk Space
+ <ul>
+ <li>Source code: 28 MB</li>
+ <li>Object code: 850 MB</li>
+ <li>GCC front end: 40 MB</li>
+ </ul></li>
+ </ul>
+ </li>
+
+ <p></p>
+
+ <li>MacOS X on PowerPC
+ <ul>
+ <li>No native code generation
+ <li>Approximately 1.20 GB of Free Disk Space
<ul>
- <li>Source code: 30 MB</li>
- <li>Object code: 1000 MB</li>
- <li>GCC front end: 210 MB</li>
+ <li>Source code: 28 MB</li>
+ <li>Object code: 1160 MB</li>
+ <li>GCC front end: 40 MB</li>
</ul></li>
- </ul></li>
+ </ul>
+ </li>
</ul>
<p>The LLVM suite <i>may</i> compile on other platforms, but it is not
@@ -253,7 +284,6 @@
</ul>
-
<p>The remainder of this guide is meant to get you up and running with
LLVM and to give you some basic information about the LLVM environment.
A <a href="#starting">complete guide to installation</a> is provided in the
@@ -348,22 +378,31 @@
<p>
If you have the LLVM distribution, you will need to unpack it before you
-can begin to compile it. LLVM is distributed as a set of three files. Each
+can begin to compile it. LLVM is distributed as a set of two files: the LLVM
+suite and the LLVM GCC front end compiled for your platform. Each
file is a TAR archive that is compressed with the gzip program.
</p>
-<p> The three files are as follows:
+<p> The files are as follows:
<dl compact>
- <dt>llvm.tar.gz
+ <dt>llvm-1.1.tar.gz
<dd>This is the source code to the LLVM suite.
<p>
- <dt>cfrontend.sparc.tar.gz
+ <dt>cfrontend-1.1.sparc-sun-solaris2.8.tar.gz
<dd>This is the binary release of the GCC front end for Solaris/Sparc.
<p>
- <dt>cfrontend.x86.tar.gz
+ <dt>cfrontend-1.1.i686-redhat-linux-gnu.tar.gz
<dd>This is the binary release of the GCC front end for Linux/x86.
+ <p>
+
+ <dt>cfrontend-1.1.i386-unknown-freebsd5.1.tar.gz
+ <dd>This is the binary release of the GCC front end for FreeBSD/x86.
+ <p>
+
+ <dt>cfrontend-1.1.powerpc-apple-darwin7.0.0.tar.gz
+ <dd>This is the binary release of the GCC front end for MacOS X/PPC.
</dl>
</div>
@@ -391,6 +430,20 @@
directory and fully populate it with the LLVM source code, Makefiles,
test directories, and local copies of documentation files.</p>
+<p>
+If you want to get a specific release (as opposed to the most recent revision),
+you can specify a label. The following releases have the following label:
+<ul>
+ <li>
+ Release 1.1: <b>RELEASE_11</b>
+ </li>
+
+ <li>
+ Release 1.0: <b>RELEASE_1</b>
+ </li>
+</ul>
+</p>
+
<p>Note that the GCC front end is not included in the CVS repository. You
should have downloaded the binary distribution for your platform.</p>
@@ -412,12 +465,12 @@
<ol>
<li><tt>cd <i>where-you-want-the-front-end-to-live</i></tt></li>
- <li><tt>gunzip --stdout cfrontend.<i>platform</i>.tar.gz | tar -xvf
+ <li><tt>gunzip --stdout cfrontend-<i>version</i>.<i>platform</i>.tar.gz | tar -xvf
-</tt></li>
</ol>
-<p>If you are on a Sparc/Solaris machine, you will need to fix the header
-files:</p>
+<p>If you are using Solaris/Sparc or MacOS X/PPC, you will need to fix the
+header files:</p>
<p><tt>cd cfrontend/sparc<br>
./fixheaders</tt></p>
@@ -443,7 +496,8 @@
<p>Once checked out from the CVS repository, the LLVM suite source code must be
configured via the <tt>configure</tt> script. This script sets variables in
<tt>llvm/Makefile.config</tt> and <tt>llvm/include/Config/config.h</tt>. It
-also populates <i>OBJ_ROOT</i> with the Makefiles needed to build LLVM.</p>
+also populates <i>OBJ_ROOT</i> with the Makefiles needed to begin building
+LLVM.</p>
<p>The following environment variables are used by the <tt>configure</tt>
script to configure the build system:</p>
@@ -477,7 +531,7 @@
<dt><i>--with-llvmgccdir=LLVMGCCDIR</i>
<dd>
Path to the location where the LLVM C front end binaries and
- associated libraries will be installed. This must be specified as an
+ associated libraries were installed. This must be specified as an
absolute pathname.
<p>
<dt><i>--enable-optimized</i>
@@ -488,7 +542,8 @@
<p>
<dt><i>--enable-jit</i>
<dd>
- Compile the Just In Time (JIT) functionality. This is not available
+ Compile the Just In Time (JIT) compiler functionality. This is not
+ available
on all platforms. The default is dependent on platform, so it is best
to explicitly enable it if you want it.
<p>
@@ -521,10 +576,10 @@
<tt>LLVM_LIB_SEARCH_PATH</tt> environment variable in your startup scripts.
This environment variable is used to locate "system" libraries like
"<tt>-lc</tt>" and "<tt>-lm</tt>" when linking. This variable should be set to
-the absolute path for the bytecode-libs subdirectory of the GCC front end
-install, or <i>LLVMGCCDIR</i>/bytecode-libs. For example, one might set
+the absolute path of the <tt>bytecode-libs</tt> subdirectory of the GCC front
+end, or <i>LLVMGCCDIR</i>/<tt>bytecode-libs</tt>. For example, one might set
<tt>LLVM_LIB_SEARCH_PATH</tt> to
-<tt>/home/vadve/lattner/local/x86/llvm-gcc/bytecode-libs</tt> for the X86
+<tt>/home/vadve/lattner/local/x86/llvm-gcc/bytecode-libs</tt> for the x86
version of the GCC front end on our research machines.</p>
</div>
@@ -1091,7 +1146,7 @@
<address>
<a href="mailto:sabre at nondot.org">Chris Lattner</a><br>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a><br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</address>
</body>
Index: llvm-www/releases/1.1/docs/HowToSubmitABug.html
diff -u llvm-www/releases/1.1/docs/HowToSubmitABug.html:1.1 llvm-www/releases/1.1/docs/HowToSubmitABug.html:1.2
--- llvm-www/releases/1.1/docs/HowToSubmitABug.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/HowToSubmitABug.html Wed Dec 17 16:47:16 2003
@@ -311,7 +311,7 @@
<address><a href="mailto:sabre at nondot.org">Chris Lattner</a></address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
<br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</div>
</body>
Index: llvm-www/releases/1.1/docs/LLVMVsTheWorld.html
diff -u llvm-www/releases/1.1/docs/LLVMVsTheWorld.html:1.1 llvm-www/releases/1.1/docs/LLVMVsTheWorld.html:1.2
--- llvm-www/releases/1.1/docs/LLVMVsTheWorld.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/LLVMVsTheWorld.html Wed Dec 17 16:47:16 2003
@@ -173,7 +173,7 @@
<address>Brian R. Gaeke</address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
<br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</div>
</body>
Index: llvm-www/releases/1.1/docs/LangRef.html
diff -u llvm-www/releases/1.1/docs/LangRef.html:1.1 llvm-www/releases/1.1/docs/LangRef.html:1.2
--- llvm-www/releases/1.1/docs/LangRef.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/LangRef.html Wed Dec 17 16:47:16 2003
@@ -1692,6 +1692,6 @@
<div class="doc_footer">
<address><a href="mailto:sabre at nondot.org">Chris Lattner</a></address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a> <br>
-Last modified: $Date: 2003/12/13 22:03:42 $ </div>
+Last modified: $Date: 2003/12/17 22:47:16 $ </div>
</body>
</html>
Index: llvm-www/releases/1.1/docs/OpenProjects.html
diff -u llvm-www/releases/1.1/docs/OpenProjects.html:1.1 llvm-www/releases/1.1/docs/OpenProjects.html:1.2
--- llvm-www/releases/1.1/docs/OpenProjects.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/OpenProjects.html Wed Dec 17 16:47:16 2003
@@ -313,7 +313,7 @@
<address><a href="mailto:sabre at nondot.org">Chris Lattner</a></address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
<br>
- Last modified: $Date: 2003/12/13 22:03:42 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</div>
</body>
Index: llvm-www/releases/1.1/docs/Projects.html
diff -u llvm-www/releases/1.1/docs/Projects.html:1.1 llvm-www/releases/1.1/docs/Projects.html:1.2
--- llvm-www/releases/1.1/docs/Projects.html:1.1 Sat Dec 13 16:03:42 2003
+++ llvm-www/releases/1.1/docs/Projects.html Wed Dec 17 16:47:16 2003
@@ -385,7 +385,7 @@
<hr>
<address><a href="mailto:criswell at uiuc.edu">John Criswell</a></address><br>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a><br>
-Last modified: $Date: 2003/12/13 22:03:42 $
+Last modified: $Date: 2003/12/17 22:47:16 $
</body>
</html>
Index: llvm-www/releases/1.1/docs/ReleaseNotes.html
diff -u llvm-www/releases/1.1/docs/ReleaseNotes.html:1.3 llvm-www/releases/1.1/docs/ReleaseNotes.html:1.4
--- llvm-www/releases/1.1/docs/ReleaseNotes.html:1.3 Sun Dec 14 16:36:45 2003
+++ llvm-www/releases/1.1/docs/ReleaseNotes.html Wed Dec 17 16:47:16 2003
@@ -7,9 +7,7 @@
</head>
<body>
-<div class="doc_title">
- LLVM 1.1 Release Notes
-</div>
+<div class="doc_title">LLVM 1.1 Release Notes</div>
<ol>
<li><a href="#intro">Introduction</a></li>
@@ -18,7 +16,6 @@
<li><a href="#install-instructions">Installation Instructions</a></li>
<li><a href="#knownproblems">Known Problems</a>
<ul>
-<!-- <li><a href="#portabilityprobs">Portability Problems</a> -->
<li><a href="#core">Known problems with the LLVM Core</a>
<li><a href="#c-fe">Known problems with the C Front-end</a>
<li><a href="#c++-fe">Known problems with the C++ Front-end</a>
@@ -30,7 +27,7 @@
</ol>
<div class="doc_text">
- <p><b>Written by <a href="mailto:sabre at nondot.org">Chris Lattner</a></b><p>
+ <p><b>Written by the <a href="http://llvm.cs.uiuc.edu">LLVM team</a></b><p>
</div>
<!-- *********************************************************************** -->
@@ -43,10 +40,10 @@
<p>This document contains the release notes for the LLVM compiler
infrastructure, release 1.1. Here we describe the status of LLVM, including any
-known problems, and bug fixes from the previous release. The most up-to-date
+known problems and bug fixes from the previous release. The most up-to-date
version of this document can be found on the <a
href="http://llvm.cs.uiuc.edu/releases/1.1/">LLVM 1.1 web site</a>. If you are
-not reading this on the LLVM web pages, you should probably go there, because
+not reading this on the LLVM web pages, you should probably go there because
this document may be updated after the release.</p>
<p>For more information about LLVM, including information about potentially more
@@ -72,10 +69,12 @@
<p>This is the second public release of the LLVM compiler infrastructure. This
release is primarily a bugfix release, dramatically improving the C/C++
-front-end, and improving support for C++ in the LLVM core. This release also
-includes a few new features, such as a simple profiler, support for Mac OS/X,
+front-end and improving support for C++ in the LLVM core. This release also
+includes a few new features, such as a simple profiler, support for Mac OS X,
better interoperability with external source bases, a new example language
-front-end, and improvements in a few optimizations.</p>
+front-end, and improvements in a few optimizations. The performance of several
+LLVM components has been improved, and several gratuitous type-safety issues in
+the C front-end have been fixed.</p>
<p>At this time, LLVM is known to correctly compile and run all non-unwinding C
& C++ SPEC CPU2000 benchmarks, the Olden benchmarks, and the Ptrdist
@@ -85,10 +84,10 @@
</p>
<p>
-The LLVM native code generators are very stable, but do not currently support
+The LLVM native code generators are very stable but do not currently support
unwinding (exception throwing or <tt>longjmp</tt>ing), which prevent them from
working with programs like the <tt>253.perlbmk</tt> in SPEC CPU2000. The C
-backend and the rest of LLVM does support these programs however, so you can
+backend and the rest of LLVM supports these programs, so you can
still use LLVM with them. Support for unwinding will be added in a future
release.
</p>
@@ -102,15 +101,15 @@
<ol>
<li><a
href="http://mail.cs.uiuc.edu/pipermail/llvmdev/2003-November/000528.html">A new
-LLVM profiler, similar to gprof</a> is available</li>
+LLVM profiler, similar to gprof,</a> is available.</li>
-<li>LLVM and the C/C++ front-end now compile on Mac OS/X! Mac OS/X users can
+<li>LLVM and the C/C++ front-end now compile on Mac OS X! Mac OS X users can
now explore the LLVM optimizer with the C backend and interpreter. Note that
-LLVM requires GCC 3.3 on Mac OS/X.</li>
+LLVM requires GCC 3.3 on Mac OS X.</li>
<li>LLVM has been <a
href="http://mail.cs.uiuc.edu/pipermail/llvmdev/2003-November/000554.html">moved
-into an 'llvm' C++ namespace</a>, for easier integration with third-party
+into an 'llvm' C++ namespace</a> for easier integration with third-party
code. Note that due to lack of namespace support in GDB 5.x, you will probably
want to upgrade to GDB 6 or better to debug LLVM code.</li>
@@ -120,7 +119,8 @@
<ol>
<li>
New directories can be added to the source tree, and the build will
- automatically pick them up (i.e. no need to re-run <tt>configure</tt>).
+ automatically pick them up (i.e. no need to edit <tt>configure.ac</tt> and
+ re-run <tt>configure</tt>).
</li>
<li>
@@ -132,7 +132,9 @@
<li>A front-end for "Stacker" (a simple Forth-like language) is now
<a href="http://llvm.cs.uiuc.edu/PR136">included in the main LLVM tree</a>.
- Additionally, Reid Spencer, the author, contributed a document <a href="Stacker.html">describing his experiences writing Stacker, and the language itself</a>. This document is invaluable for others writing front-ends targetting LLVM.</li>
+ Additionally, Reid Spencer, the author, contributed a document
+ <a href="Stacker.html">describing his experiences writing Stacker and the language itself</a>.
+ This document is invaluable for others writing front-ends targetting LLVM.</li>
<li>The <tt>configure</tt> script will now configure all projects placed in the
<tt>llvm/projects</tt> directory.</li>
@@ -143,12 +145,12 @@
<li>The <tt>-licm</tt> pass can now sink instructions out the bottom of loops
in addition to being able to hoist them out the top.</li>
-<li>The <tt>-basicaa</tt> pass (the default alias analysis) has been upgraded
-to be <a href="http://llvm.cs.uiuc.edu/PR86">significantly more
+<li>The <tt>-basicaa</tt> pass (the default alias analysis pass) has been
+upgraded to be <a href="http://llvm.cs.uiuc.edu/PR86">significantly more
precise</a>.</li>
<li>LLVM 1.1 implements a simple size optimization for LLVM bytecode files.
- This means that the 1.1 files are smaller than 1.0, but that 1.0 won't
+ This means that the 1.1 files are smaller than 1.0, but LLVM 1.0 won't
read 1.1 bytecode files.</li>
<li><a href="http://llvm.cs.uiuc.edu/PR140">The gccld program produces a runner script that includes command-line options to load the necessary shared objects.</a></li>
@@ -185,15 +187,15 @@
<li>The C++ front-end now compiles functions to
<a href="http://llvm.cs.uiuc.edu/PR29">use the linkonce linkage type</a>
- more, giving the optimizer more freedom.</a></li>
+ more, giving the optimizer more freedom.</li>
<li>The C front-end now <a href="http://llvm.cs.uiuc.edu/PR84">generates
- type-safe code</a> in several cases that it did not before, which prevented
- some important optimizations.</li>
+ type-safe code</a> in several cases that it did not before, allowing
+ optimization of code that could not be optimized previously.</li>
<li>The LLVM build system has been taught to catch some common configuration
problems that <a href="http://llvm.cs.uiuc.edu/PR96">caused it to get
- horribly confused</a> before.</li>
+ horribly confused</a>.</li>
<li>The LLVM header files are now
<a href="http://llvm.cs.uiuc.edu/PR114">-Wold-style-cast clean</a>.</li>
@@ -210,15 +212,11 @@
<a href="http://llvm.cs.uiuc.edu/PR11">generated N^2 amounts of duplicated cleanup code</a> in some cases.</li>
<li>The JIT used to <a href="http://llvm.cs.uiuc.edu/PR177">generate code for
- all functions pointed to by globals</a> immediately, before the program
- started execution, but now it waits until the first time they are called to
+ all functions pointed to by globals</a> before the program
+ started execution. Now, it waits until the first time the functions are
+ called to
compile them. This dramatically speeds up short runs of large C++ programs,
which often have large numbers of functions pointed to by vtables.</li>
-
-<li>The C front-end <a href="http://llvm.cs.uiuc.edu/PR181">had an inefficient
- implementation of the LLVM type-system</a>, which caused the C++ front-end
- to be very slow in some cases.</li>
-
</ol>
@@ -238,7 +236,7 @@
<li><a href="http://llvm.cs.uiuc.edu/PR71">llvm-as crashes when labels are used in phi nodes</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR72">[build problem] Callgraph.cpp not pulled in from libipa.a</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR77">Variables in scope of output setjmp
-calls should be volatile</a> (Note that this does not effect correctness on
+calls should be volatile</a> (Note that this does not affect correctness on
many platforms, such as X86).</li>
<li><a href="http://llvm.cs.uiuc.edu/PR83">[X86] Emission of global bool initializers broken</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR91">[gccld] The -r (relinking) option does not work correctly</a></li>
@@ -274,7 +272,7 @@
<li><a href="http://llvm.cs.uiuc.edu/PR81">CFrontend crashes when compiling C99 compound expressions</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR87">llvm-gcc infinite loops on "case MAXINT:"</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR89">[C++] Catch blocks make unparsable labels</a></li>
-<li><a href="http://llvm.cs.uiuc.edu/PR90">[C++] Initializing array with constructable objects fail</a></li>
+<li><a href="http://llvm.cs.uiuc.edu/PR90">[C++] Initializing array with constructible objects fail</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR94">llvm-gcc tries to add bools</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR104">[c++] C++ Frontend lays out superclasses like anonymous bitfields!</a></li>
<li><a href="http://llvm.cs.uiuc.edu/PR54">C front-end miscompiles unsigned enums whose LLVM types are signed</a></li>
@@ -307,13 +305,13 @@
<div class="doc_text">
<p>LLVM has been extensively tested on Intel and AMD machines running Red
-Hat Linux and FreeBSD. It has also been tested on Sun UltraSPARC workstations running Solaris 8.
+Hat Linux and has been tested on Sun UltraSPARC workstations running Solaris 8.
Additionally,
-LLVM works on Mac OS/X 10.3 and above, but only with the C backend or
+LLVM works on Mac OS X 10.3 and above, but only with the C backend or
interpreter (no native backend for the PowerPC is available yet).
The core LLVM infrastructure uses "autoconf" for portability, so hopefully we
work on more platforms than that. However, it is likely that we
-missed something, and that minor porting is required to get LLVM to work on
+missed something and that minor porting is required to get LLVM to work on
new platforms. We welcome portability patches and error messages.</p>
</div>
@@ -329,7 +327,7 @@
<p>This section contains all known problems with the LLVM system, listed by
component. As new problems are discovered, they will be added to these
sections. If you run into a problem, please check the <a
-href="http://llvm.cs.uiuc.edu/bugs/">LLVM bug database</a>, and submit a bug if
+href="http://llvm.cs.uiuc.edu/bugs/">LLVM bug database</a> and submit a bug if
there isn't already one.</p>
</div>
@@ -364,10 +362,18 @@
<li><a href="http://llvm.cs.uiuc.edu/PR82">LLVM cannot handle structures with
more than 256 elements</a>.</li>
-</ul><b>Bugs in 1.1 fixed in 1.2:</b><ul><p>
-
-<li><a href="http://llvm.cs.uiuc.edu/PR179">[licm] LICM promotes volatile memory locations to registers</a></li>
+<li>
+The gccld program
+<a href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=139">
+does not link objects/archives in the order specified on the command line.
+</a>
+</li>
+<li>
+<a href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=174">
+Tail duplication does not update SSA form correctly.
+</a>
+</li>
</ul>
</div>
@@ -383,9 +389,7 @@
</div>
<div class="doc_text">
-
<ul>
-
<li>C99 Variable sized arrays do not release stack memory when they go out of
scope. Thus, the following program may run out of stack space:
<pre>
@@ -395,8 +399,27 @@
}
</pre></li>
-</ul>
+<li>
+Initialization of global union variables can only be done
+<a href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=162">with the largest
+union member</a>.
+</li>
+<li>
+<a href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=182">
+Functions marked "extern inline" are not compiled into LLVM with linkonce
+linkage.
+</a>
+</li>
+
+
+<li>
+The memory management functions in the libc runtime
+<a href="http://llvm.cs.uiuc.edu/PR186">need weak linkage so that they can be
+overridden.
+</a>
+</li>
+</ul>
</div>
<!-- _______________________________________________________________________ -->
@@ -428,11 +451,11 @@
the following extensions are known to <b>not be</b> supported:
<ol>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Local-Labels.html#Local%20Labels">Local Labels</a>: Labels local to a block.</li>
- <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Labels-as-Values.html#Labels%20as%20Values">Labels as Values</a>: Getting pointers to labels, and computed gotos.</li>
+ <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Labels-as-Values.html#Labels%20as%20Values">Labels as Values</a>: Getting pointers to labels and computed gotos.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Nested-Functions.html#Nested%20Functions">Nested Functions</a>: As in Algol and Pascal, lexical scoping of functions.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Constructing-Calls.html#Constructing%20Calls">Constructing Calls</a>: Dispatching a call to another function.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Extended-Asm.html#Extended%20Asm">Extended Asm</a>: Assembler instructions with C expressions as operands.</li>
- <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Constraints.html#Constraints">Constraints</a>: Constraints for asm operands</li>
+ <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Constraints.html#Constraints">Constraints</a>: Constraints for asm operands.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Asm-Labels.html#Asm%20Labels">Asm Labels</a>: Specifying the assembler name to use for a C symbol.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Explicit-Reg-Vars.html#Explicit%20Reg%20Vars">Explicit Reg Vars</a>: Defining variables residing in specified registers.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Return-Address.html#Return%20Address">Return Address</a>: Getting the return or frame address of a function.</li>
@@ -445,7 +468,7 @@
<p>The following GCC extensions are <b>partially</b> supported. An ignored
attribute means that the LLVM compiler ignores the presence of the attribute,
but the code should still work. An unsupported attribute is one which is
- ignored by the LLVM compiler, which will cause a different interpretation of
+ ignored by the LLVM compiler and will cause a different interpretation of
the program.</p>
<ol>
@@ -455,7 +478,7 @@
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Function-Attributes.html#Function%20Attributes">Function Attributes</a>:
- Declaring that functions have no side effects, or that they can never
+ Declaring that functions have no side effects or that they can never
return.<br>
<b>Supported:</b> <tt>format</tt>, <tt>format_arg</tt>, <tt>non_null</tt>,
@@ -514,7 +537,8 @@
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Subscripting.html#Subscripting">Subscripting</a>: Any array can be subscripted, even if not an lvalue.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Pointer-Arith.html#Pointer%20Arith">Pointer Arith</a>: Arithmetic on <code>void</code>-pointers and function pointers.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Initializers.html#Initializers">Initializers</a>: Non-constant initializers.</li>
- <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Compound-Literals.html#Compound%20Literals">Compound Literals</a>: Compound literals give structures, unions or arrays as values.</li>
+ <li><a href="http://gcc.gnu.org/onlinedocs/gcc/Compound-Literals.html#Compound%20Literals">Compound Literals</a>: Compound literals give structures, unions,
+or arrays as values.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Designated-Inits.html#Designated%20Inits">Designated Inits</a>: Labeling elements of initializers.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Cast-to-Union.html#Cast%20to%20Union">Cast to Union</a>: Casting to union type from any member of the union.</li>
<li><a href="http://gcc.gnu.org/onlinedocs/gcc/Case-Ranges.html#Case%20Ranges">Case Ranges</a>: `case 1 ... 9' and such.</li>
@@ -546,7 +570,7 @@
<div class="doc_text">
-<p>For this release, the C++ front-end is considered to be fully functional, but
+<p>For this release, the C++ front-end is considered to be fully functional but
has not been tested as thoroughly as the C front-end. It has been tested and
works for a number of non-trivial programs, but there may be lurking bugs.
Please report any bugs or problems.</p>
@@ -562,9 +586,14 @@
<ul>
<li>The C++ front-end inherits all problems afflicting the <a href="#c-fe">C
- front-end</a></li>
-</ul>
+ front-end</a>.</li>
+<li>
+<a href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=137">
+Code is generated for empty classes.
+</a>
+</li>
+</ul>
</div>
<!-- _______________________________________________________________________ -->
@@ -584,7 +613,7 @@
<li>Destructors for local objects are not always run when a <tt>longjmp</tt> is
performed. In particular, destructors for objects in the <tt>longjmp</tt>ing
function and in the <tt>setjmp</tt> receiver function may not be run.
- Objects in intervening stack frames will be destroyed however (which is
+ Objects in intervening stack frames will be destroyed, however (which is
better than most compilers).</li>
<li>The LLVM C++ front-end follows the <a
@@ -634,6 +663,11 @@
support the <tt>unwind</tt> instruction</a>, so code that throws a C++ exception
or calls the C <tt>longjmp</tt> function will abort.</li>
+<li>
+<a href="http://llvm.cs.uiuc.edu/bugs/show_bug.cgi?id=167">
+The llc program can crash on legal code.
+</a>
+</li>
</ul>
</div>
@@ -673,7 +707,7 @@
<div class="doc_text">
<p>A wide variety of additional information is available on the LLVM web page,
-including mailing lists publications describing algorithms and components
+including mailing lists and publications describing algorithms and components
implemented in LLVM. The web page also contains versions of the API
documentation which is up-to-date with the CVS version of the source code. You
can access versions of these documents specific to this release by going into
@@ -695,7 +729,7 @@
src="http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01!" /></a>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a><br>
- Last modified: $Date: 2003/12/14 22:36:45 $
+ Last modified: $Date: 2003/12/17 22:47:16 $
</address>
</body>
Index: llvm-www/releases/1.1/docs/Stacker.html
diff -u llvm-www/releases/1.1/docs/Stacker.html:1.1 llvm-www/releases/1.1/docs/Stacker.html:1.2
--- llvm-www/releases/1.1/docs/Stacker.html:1.1 Sat Dec 13 16:03:43 2003
+++ llvm-www/releases/1.1/docs/Stacker.html Wed Dec 17 16:47:16 2003
@@ -61,7 +61,7 @@
about LLVM through the experience of creating a simple programming language
named Stacker. Stacker was invented specifically as a demonstration of
LLVM. The emphasis in this document is not on describing the
-intricacies of LLVM itself, but on how to use it to build your own
+intricacies of LLVM itself but on how to use it to build your own
compiler system.</p>
</div>
<!-- ======================================================================= -->
@@ -70,7 +70,7 @@
<p>Amongst other things, LLVM is a platform for compiler writers.
Because of its exceptionally clean and small IR (intermediate
representation), compiler writing with LLVM is much easier than with
-other system. As proof, the author of Stacker wrote the entire
+other systems. As proof, the author of Stacker wrote the entire
compiler (language definition, lexer, parser, code generator, etc.) in
about <em>four days</em>! That's important to know because it shows
how quickly you can get a new
@@ -78,11 +78,11 @@
language the author ever created using LLVM. The learning curve is
included in that four days.</p>
<p>The language described here, Stacker, is Forth-like. Programs
-are simple collections of word definitions and the only thing definitions
+are simple collections of word definitions, and the only thing definitions
can do is manipulate a stack or generate I/O. Stacker is not a "real"
-programming language; its very simple. Although it is computationally
+programming language; it's very simple. Although it is computationally
complete, you wouldn't use it for your next big project. However,
-the fact that it is complete, its simple, and it <em>doesn't</em> have
+the fact that it is complete, it's simple, and it <em>doesn't</em> have
a C-like syntax make it useful for demonstration purposes. It shows
that LLVM could be applied to a wide variety of languages.</p>
<p>The basic notions behind stacker is very simple. There's a stack of
@@ -96,11 +96,11 @@
: MAIN hello_world ;<br></code></p>
<p>This has two "definitions" (Stacker manipulates words, not
functions and words have definitions): <code>MAIN</code> and <code>
-hello_world</code>. The <code>MAIN</code> definition is standard, it
+hello_world</code>. The <code>MAIN</code> definition is standard; it
tells Stacker where to start. Here, <code>MAIN</code> is defined to
simply invoke the word <code>hello_world</code>. The
<code>hello_world</code> definition tells stacker to push the
-<code>"Hello, World!"</code> string onto the stack, print it out
+<code>"Hello, World!"</code> string on to the stack, print it out
(<code>>s</code>), pop it off the stack (<code>DROP</code>), and
finally print a carriage return (<code>CR</code>). Although
<code>hello_world</code> uses the stack, its net effect is null. Well
@@ -124,7 +124,7 @@
<p>Although I knew that LLVM uses a Single Static Assignment (SSA) format,
it wasn't obvious to me how prevalent this idea was in LLVM until I really
started using it. Reading the <a href="ProgrammersManual.html">
-Programmer's Manual</a> and <a href="LangRef.html">Language Reference</a>
+Programmer's Manual</a> and <a href="LangRef.html">Language Reference</a>,
I noted that most of the important LLVM IR (Intermediate Representation) C++
classes were derived from the Value class. The full power of that simple
design only became fully understood once I started constructing executable
@@ -200,7 +200,7 @@
<ol>
<li><em>Create your blocks early.</em> While writing your compiler, you
will encounter several situations where you know apriori that you will
- need several blocks. For example, if-then-else, switch, while and for
+ need several blocks. For example, if-then-else, switch, while, and for
statements in C/C++ all need multiple blocks for expression in LVVM.
The rule is, create them early.</li>
<li><em>Terminate your blocks early.</em> This just reduces the chances
@@ -261,15 +261,15 @@
the instructions for the "then" and "else" parts. They would use the third part
of the idiom almost exclusively (inserting new instructions before the
terminator). Furthermore, they could even recurse back to <code>handle_if</code>
-should they encounter another if/then/else statement and it will just work.</p>
+should they encounter another if/then/else statement, and it will just work.</p>
<p>Note how cleanly this all works out. In particular, the push_back methods on
the <code>BasicBlock</code>'s instruction list. These are lists of type
<code>Instruction</code> which also happen to be <code>Value</code>s. To create
-the "if" branch we merely instantiate a <code>BranchInst</code> that takes as
+the "if" branch, we merely instantiate a <code>BranchInst</code> that takes as
arguments the blocks to branch to and the condition to branch on. The blocks
act like branch labels! This new <code>BranchInst</code> terminates
the <code>BasicBlock</code> provided as an argument. To give the caller a way
-to keep inserting after calling <code>handle_if</code> we create an "exit" block
+to keep inserting after calling <code>handle_if</code>, we create an "exit" block
which is returned to the caller. Note that the "exit" block is used as the
terminator for both the "then" and the "else" blocks. This guarantees that no
matter what else "handle_if" or "fill_in" does, they end up at the "exit" block.
@@ -283,7 +283,7 @@
method on the various lists. This is so common that it is worth mentioning.
The "push_back" inserts a value into an STL list, vector, array, etc. at the
end. The method might have also been named "insert_tail" or "append".
-Althought I've used STL quite frequently, my use of push_back wasn't very
+Although I've used STL quite frequently, my use of push_back wasn't very
high in other programs. In LLVM, you'll use it all the time.
</p>
</div>
@@ -292,17 +292,17 @@
<div class="doc_text">
<p>
It took a little getting used to and several rounds of postings to the LLVM
-mail list to wrap my head around this instruction correctly. Even though I had
+mailing list to wrap my head around this instruction correctly. Even though I had
read the Language Reference and Programmer's Manual a couple times each, I still
missed a few <em>very</em> key points:
</p>
<ul>
- <li>GetElementPtrInst gives you back a Value for the last thing indexed</em>
+ <li>GetElementPtrInst gives you back a Value for the last thing indexed.</em>
<li>All global variables in LLVM are <em>pointers</em>.
<li>Pointers must also be dereferenced with the GetElementPtrInst instruction.
</ul>
<p>This means that when you look up an element in the global variable (assuming
-its a struct or array), you <em>must</em> deference the pointer first! For many
+it's a struct or array), you <em>must</em> deference the pointer first! For many
things, this leads to the idiom:
</p>
<pre><code>
@@ -319,13 +319,13 @@
variable and the address of its first element as the same. That tripped me up
for a while until I realized that they really do differ .. by <em>type</em>.
Remember that LLVM is a strongly typed language itself. Everything
-has a type. The "type" of the global variable is [24 x int]*. That is, its
+has a type. The "type" of the global variable is [24 x int]*. That is, it's
a pointer to an array of 24 ints. When you dereference that global variable with
a single (0) index, you now have a "[24 x int]" type. Although
the pointer value of the dereferenced global and the address of the zero'th element
in the array will be the same, they differ in their type. The zero'th element has
type "int" while the pointer value has type "[24 x int]".</p>
-<p>Get this one aspect of LLVM right in your head and you'll save yourself
+<p>Get this one aspect of LLVM right in your head, and you'll save yourself
a lot of compiler writing headaches down the road.</p>
</div>
<!-- ======================================================================= -->
@@ -334,7 +334,7 @@
<p>Linkage types in LLVM can be a little confusing, especially if your compiler
writing mind has affixed very hard concepts to particular words like "weak",
"external", "global", "linkonce", etc. LLVM does <em>not</em> use the precise
-definitions of say ELF or GCC even though they share common terms. To be fair,
+definitions of, say, ELF or GCC, even though they share common terms. To be fair,
the concepts are related and similar but not precisely the same. This can lead
you to think you know what a linkage type represents but in fact it is slightly
different. I recommend you read the
@@ -342,10 +342,10 @@
carefully. Then, read it again.<p>
<p>Here are some handy tips that I discovered along the way:</p>
<ul>
- <li>Unitialized means external. That is, the symbol is declared in the current
+ <li>Uninitialized means external. That is, the symbol is declared in the current
module and can be used by that module but it is not defined by that module.</li>
<li>Setting an initializer changes a global's linkage type from whatever it was
- to a normal, defind global (not external). You'll need to call the setLinkage()
+ to a normal, defined global (not external). You'll need to call the setLinkage()
method to reset it if you specify the initializer after the GlobalValue has been
constructed. This is important for LinkOnce and Weak linkage types.</li>
<li>Appending linkage can be used to keep track of compilation information at
@@ -362,7 +362,7 @@
functions in the LLVM IR that make things easier. Here's what I learned: </p>
<ul>
<li>Constants are Values like anything else and can be operands of instructions</li>
- <li>Integer constants, frequently needed can be created using the static "get"
+ <li>Integer constants, frequently needed, can be created using the static "get"
methods of the ConstantInt, ConstantSInt, and ConstantUInt classes. The nice thing
about these is that you can "get" any kind of integer quickly.</li>
<li>There's a special method on Constant class which allows you to get the null
@@ -379,14 +379,14 @@
proceeding, a few words about the stack are in order. The stack is simply
a global array of 32-bit integers or pointers. A global index keeps track
of the location of the top of the stack. All of this is hidden from the
-programmer but it needs to be noted because it is the foundation of the
+programmer, but it needs to be noted because it is the foundation of the
conceptual programming model for Stacker. When you write a definition,
you are, essentially, saying how you want that definition to manipulate
the global stack.</p>
<p>Manipulating the stack can be quite hazardous. There is no distinction
given and no checking for the various types of values that can be placed
on the stack. Automatic coercion between types is performed. In many
-cases this is useful. For example, a boolean value placed on the stack
+cases, this is useful. For example, a boolean value placed on the stack
can be interpreted as an integer with good results. However, using a
word that interprets that boolean value as a pointer to a string to
print out will almost always yield a crash. Stacker simply leaves it
@@ -406,9 +406,9 @@
<p>So, your typical definition will have the form:</p>
<pre><code>: name ... ;</code></pre>
<p>The <code>name</code> is up to you but it must start with a letter and contain
-only letters numbers and underscore. Names are case sensitive and must not be
+only letters, numbers, and underscore. Names are case sensitive and must not be
the same as the name of a built-in word. The <code>...</code> is replaced by
-the stack manipulting words that you wish define <code>name</code> as. <p>
+the stack manipulating words that you wish to define <code>name</code> as. <p>
</div>
<!-- ======================================================================= -->
<div class="doc_subsection"><a name="comments"></a>Comments</div>
@@ -429,12 +429,12 @@
<!-- ======================================================================= -->
<div class="doc_subsection"><a name="literals"></a>Literals</div>
<div class="doc_text">
- <p>There are three kinds of literal values in Stacker. Integer, Strings,
+ <p>There are three kinds of literal values in Stacker: Integers, Strings,
and Booleans. In each case, the stack operation is to simply push the
- value onto the stack. So, for example:<br/>
+ value on to the stack. So, for example:<br/>
<code> 42 " is the answer." TRUE </code><br/>
- will push three values onto the stack: the integer 42, the
- string " is the answer." and the boolean TRUE.</p>
+ will push three values on to the stack: the integer 42, the
+ string " is the answer.", and the boolean TRUE.</p>
</div>
<!-- ======================================================================= -->
<div class="doc_subsection"><a name="words"></a>Words</div>
@@ -464,20 +464,20 @@
<p>The built-in words of the Stacker language are put in several groups
depending on what they do. The groups are as follows:</p>
<ol>
- <li><em>Logical</em>These words provide the logical operations for
+ <li><em>Logical</em>: These words provide the logical operations for
comparing stack operands.<br/>The words are: < > <= >=
= <> true false.</li>
- <li><em>Bitwise</em>These words perform bitwise computations on
+ <li><em>Bitwise</em>: These words perform bitwise computations on
their operands. <br/> The words are: << >> XOR AND NOT</li>
- <li><em>Arithmetic</em>These words perform arithmetic computations on
+ <li><em>Arithmetic</em>: These words perform arithmetic computations on
their operands. <br/> The words are: ABS NEG + - * / MOD */ ++ -- MIN MAX</li>
- <li><em>Stack</em>These words manipulate the stack directly by moving
+ <li><em>Stack</em>: These words manipulate the stack directly by moving
its elements around.<br/> The words are: DROP DUP SWAP OVER ROT DUP2 DROP2 PICK TUCK</li>
- <li><em>Memory</em>These words allocate, free and manipulate memory
+ <li><em>Memory</em>: These words allocate, free, and manipulate memory
areas outside the stack.<br/>The words are: MALLOC FREE GET PUT</li>
- <li><em>Control</em>These words alter the normal left to right flow
+ <li><em>Control</em>: These words alter the normal left to right flow
of execution.<br/>The words are: IF ELSE ENDIF WHILE END RETURN EXIT RECURSE</li>
- <li><em>I/O</em> These words perform output on the standard output
+ <li><em>I/O</em>: These words perform output on the standard output
and input on the standard input. No other I/O is possible in Stacker.
<br/>The words are: SPACE TAB CR >s >d >c <s <d <c.</li>
</ol>
@@ -554,12 +554,12 @@
<tr><td>FALSE</td>
<td>FALSE</td>
<td> -- b</td>
- <td>The boolean value FALSE (0) is pushed onto the stack.</td>
+ <td>The boolean value FALSE (0) is pushed on to the stack.</td>
</tr>
<tr><td>TRUE</td>
<td>TRUE</td>
<td> -- b</td>
- <td>The boolean value TRUE (-1) is pushed onto the stack.</td>
+ <td>The boolean value TRUE (-1) is pushed on to the stack.</td>
</tr>
<tr><td colspan="4">BITWISE OPERATIONS</td></tr>
<tr><td>Word</td><td>Name</td><td>Operation</td><td>Description</td></tr>
@@ -604,75 +604,75 @@
<td>ABS</td>
<td>w -- |w|</td>
<td>One value s popped off the stack; its absolute value is computed
- and then pushed onto the stack. If w1 is -1 then w2 is 1. If w1 is
+ and then pushed on to the stack. If w1 is -1 then w2 is 1. If w1 is
1 then w2 is also 1.</td>
</tr>
<tr><td>NEG</td>
<td>NEG</td>
<td>w -- -w</td>
<td>One value is popped off the stack which is negated and then
- pushed back onto the stack. If w1 is -1 then w2 is 1. If w1 is
+ pushed back on to the stack. If w1 is -1 then w2 is 1. If w1 is
1 then w2 is -1.</td>
</tr>
<tr><td> + </td>
<td>ADD</td>
<td>w1 w2 -- w2+w1</td>
<td>Two values are popped off the stack. Their sum is pushed back
- onto the stack</td>
+ on to the stack</td>
</tr>
<tr><td> - </td>
<td>SUB</td>
<td>w1 w2 -- w2-w1</td>
<td>Two values are popped off the stack. Their difference is pushed back
- onto the stack</td>
+ on to the stack</td>
</tr>
<tr><td> * </td>
<td>MUL</td>
<td>w1 w2 -- w2*w1</td>
<td>Two values are popped off the stack. Their product is pushed back
- onto the stack</td>
+ on to the stack</td>
</tr>
<tr><td> / </td>
<td>DIV</td>
<td>w1 w2 -- w2/w1</td>
<td>Two values are popped off the stack. Their quotient is pushed back
- onto the stack</td>
+ on to the stack</td>
</tr>
<tr><td>MOD</td>
<td>MOD</td>
<td>w1 w2 -- w2%w1</td>
<td>Two values are popped off the stack. Their remainder after division
- of w1 by w2 is pushed back onto the stack</td>
+ of w1 by w2 is pushed back on to the stack</td>
</tr>
<tr><td> */ </td>
<td>STAR_SLAH</td>
<td>w1 w2 w3 -- (w3*w2)/w1</td>
<td>Three values are popped off the stack. The product of w1 and w2 is
- divided by w3. The result is pushed back onto the stack.</td>
+ divided by w3. The result is pushed back on to the stack.</td>
</tr>
<tr><td> ++ </td>
<td>INCR</td>
<td>w -- w+1</td>
<td>One value is popped off the stack. It is incremented by one and then
- pushed back onto the stack.</td>
+ pushed back on to the stack.</td>
</tr>
<tr><td> -- </td>
<td>DECR</td>
<td>w -- w-1</td>
<td>One value is popped off the stack. It is decremented by one and then
- pushed back onto the stack.</td>
+ pushed back on to the stack.</td>
</tr>
<tr><td>MIN</td>
<td>MIN</td>
<td>w1 w2 -- (w2<w1?w2:w1)</td>
<td>Two values are popped off the stack. The larger one is pushed back
- onto the stack.</td>
+ on to the stack.</td>
</tr>
<tr><td>MAX</td>
<td>MAX</td>
<td>w1 w2 -- (w2>w1?w2:w1)</td>
<td>Two values are popped off the stack. The larger value is pushed back
- onto the stack.</td>
+ on to the stack.</td>
</tr>
<tr><td colspan="4">STACK MANIPULATION OPERATIONS</td></tr>
<tr><td>Word</td><td>Name</td><td>Operation</td><td>Description</td></tr>
@@ -703,13 +703,13 @@
<tr><td>DUP</td>
<td>DUP</td>
<td>w1 -- w1 w1</td>
- <td>One value is popped off the stack. That value is then pushed onto
- the stack twice to duplicate the top stack vaue.</td>
+ <td>One value is popped off the stack. That value is then pushed on to
+ the stack twice to duplicate the top stack value.</td>
</tr>
<tr><td>DUP2</td>
<td>DUP2</td>
<td>w1 w2 -- w1 w2 w1 w2</td>
- <td>The top two values on the stack are duplicated. That is, two vaues
+ <td>The top two values on the stack are duplicated. That is, two values
are popped off the stack. They are alternately pushed back on the
stack twice each.</td>
</tr>
@@ -717,7 +717,7 @@
<td>SWAP</td>
<td>w1 w2 -- w2 w1</td>
<td>The top two stack items are reversed in their order. That is, two
- values are popped off the stack and pushed back onto the stack in
+ values are popped off the stack and pushed back on to the stack in
the opposite order they were popped.</td>
</tr>
<tr><td>SWAP2</td>
@@ -725,27 +725,27 @@
<td>w1 w2 w3 w4 -- w3 w4 w2 w1</td>
<td>The top four stack items are swapped in pairs. That is, two values
are popped and retained. Then, two more values are popped and retained.
- The values are pushed back onto the stack in the reverse order but
+ The values are pushed back on to the stack in the reverse order but
in pairs.</p>
</tr>
<tr><td>OVER</td>
<td>OVER</td>
<td>w1 w2-- w1 w2 w1</td>
<td>Two values are popped from the stack. They are pushed back
- onto the stack in the order w1 w2 w1. This seems to cause the
+ on to the stack in the order w1 w2 w1. This seems to cause the
top stack element to be duplicated "over" the next value.</td>
</tr>
<tr><td>OVER2</td>
<td>OVER2</td>
<td>w1 w2 w3 w4 -- w1 w2 w3 w4 w1 w2</td>
- <td>The third and fourth values on the stack are replicated onto the
+ <td>The third and fourth values on the stack are replicated on to the
top of the stack</td>
</tr>
<tr><td>ROT</td>
<td>ROT</td>
<td>w1 w2 w3 -- w2 w3 w1</td>
<td>The top three values are rotated. That is, three value are popped
- off the stack. They are pushed back onto the stack in the order
+ off the stack. They are pushed back on to the stack in the order
w1 w3 w2.</td>
</tr>
<tr><td>ROT2</td>
@@ -822,7 +822,7 @@
<td>One value is popped off the stack. The value is used as the size
of a memory block to allocate. The size is in bytes, not words.
The memory allocation is completed and the address of the memory
- block is pushed onto the stack.</td>
+ block is pushed on to the stack.</td>
</tr>
<tr><td>FREE</td>
<td>FREE</td>
@@ -911,7 +911,7 @@
<td>The boolean value on the top of the stack is examined. If it is non-zero then the
"words..." between WHILE and END are executed. Execution then begins again at the WHILE where another
boolean is popped off the stack. To prevent this operation from eating up the entire
- stack, you should push onto the stack (just before the END) a boolean value that indicates
+ stack, you should push on to the stack (just before the END) a boolean value that indicates
whether to terminate. Note that since booleans and integers can be coerced you can
use the following "for loop" idiom:<br/>
<code>(push count) WHILE (words...) -- END</code><br/>
@@ -960,19 +960,19 @@
<td>IN_STR</td>
<td> -- s </td>
<td>A string is read from the input via the scanf(3) format string " %as". The
- resulting string is pushed onto the stack.</td>
+ resulting string is pushed on to the stack.</td>
</tr>
<tr><td><d</td>
<td>IN_STR</td>
<td> -- w </td>
<td>An integer is read from the input via the scanf(3) format string " %d". The
- resulting value is pushed onto the stack</td>
+ resulting value is pushed on to the stack</td>
</tr>
<tr><td><c</td>
<td>IN_CHR</td>
<td> -- w </td>
<td>A single character is read from the input via the scanf(3) format string
- " %c". The value is converted to an integer and pushed onto the stack.</td>
+ " %c". The value is converted to an integer and pushed on to the stack.</td>
</tr>
<tr><td>DUMP</td>
<td>DUMP</td>
@@ -989,9 +989,9 @@
<p>The following fully documented program highlights many features of both
the Stacker language and what is possible with LLVM. The program has two modes
of operations. If you provide numeric arguments to the program, it checks to see
-if those arguments are prime numbers, prints out the results. Without any
-aruments, the program prints out any prime numbers it finds between 1 and one
-million (there's a log of them!). The source code comments below tell the
+if those arguments are prime numbers and prints out the results. Without any
+arguments, the program prints out any prime numbers it finds between 1 and one
+million (there's a lot of them!). The source code comments below tell the
remainder of the story.
</p>
</div>
@@ -1015,7 +1015,7 @@
: exit_loop FALSE;
################################################################################
-# This definition tryies an actual division of a candidate prime number. It
+# This definition tries an actual division of a candidate prime number. It
# determines whether the division loop on this candidate should continue or
# not.
# STACK<:
@@ -1075,7 +1075,7 @@
# STACK<:
# p - the prime number to check
# STACK>:
-# yn - boolean indiating if its a prime or not
+# yn - boolean indicating if its a prime or not
# p - the prime number checked
################################################################################
: try_harder
@@ -1248,7 +1248,7 @@
under the LLVM "projects" directory. You will need to obtain the LLVM sources
to find it (either via anonymous CVS or a tarball. See the
<a href="GettingStarted.html">Getting Started</a> document).</p>
-<p>Under the "projects" directory there is a directory named "stacker". That
+<p>Under the "projects" directory there is a directory named "Stacker". That
directory contains everything, as follows:</p>
<ul>
<li><em>lib</em> - contains most of the source code
@@ -1301,7 +1301,7 @@
definitions, the ROLL word is not implemented. This word was left out of
Stacker on purpose so that it can be an exercise for the student. The exercise
is to implement the ROLL functionality (in your own workspace) and build a test
-program for it. If you can implement ROLL you understand Stacker and probably
+program for it. If you can implement ROLL, you understand Stacker and probably
a fair amount about LLVM since this is one of the more complicated Stacker
operations. The work will almost be completely limited to the
<a href="#compiler">compiler</a>.
@@ -1326,7 +1326,7 @@
emitted currently is somewhat wasteful. It gets cleaned up a lot by existing
passes but more could be done.</li>
<li>Add -O -O1 -O2 and -O3 optimization switches to the compiler driver to
- allow LLVM optimization without using "opt"</li>
+ allow LLVM optimization without using "opt."</li>
<li>Make the compiler driver use the LLVM linking facilities (with IPO) before
depending on GCC to do the final link.</li>
<li>Clean up parsing. It doesn't handle errors very well.</li>
@@ -1346,6 +1346,6 @@
<div class="doc_footer">
<address><a href="mailto:rspencer at x10sys.com">Reid Spencer</a></address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
-<br>Last modified: $Date: 2003/12/13 22:03:43 $ </div>
+<br>Last modified: $Date: 2003/12/17 22:47:16 $ </div>
</body>
</html>
Index: llvm-www/releases/1.1/docs/TestingGuide.html
diff -u llvm-www/releases/1.1/docs/TestingGuide.html:1.1 llvm-www/releases/1.1/docs/TestingGuide.html:1.2
--- llvm-www/releases/1.1/docs/TestingGuide.html:1.1 Sat Dec 13 16:03:43 2003
+++ llvm-www/releases/1.1/docs/TestingGuide.html Wed Dec 17 16:47:16 2003
@@ -422,7 +422,7 @@
<address>John T. Criswell</address>
<a href="http://llvm.cs.uiuc.edu">The LLVM Compiler Infrastructure</a>
<br>
-Last modified: $Date: 2003/12/13 22:03:43 $
+Last modified: $Date: 2003/12/17 22:47:16 $
</font>
</body>
More information about the llvm-commits
mailing list