- <li>you really, really, really can't use the binaries we distribute</li>
- <li>you are an elite GCC hacker.</li>
- <li>you want to use the latest bits from CVS.</li>
-</ol>
-
-<p>We welcome patches to help make this process simpler.</p>
-</div>
-
-<!--=========================================================================-->
-<div class="doc_subsection">
- <a name="cygwin">Building under Cygwin</a>
-</div>
-<!--=========================================================================-->
-
-<div class="doc_text">
-<p>If you are building LLVM and the GCC front-end under Cygwin, please note that
-the LLVM and GCC makefiles do not correctly handle spaces in paths. To deal
-with this issue, make sure that your LLVM and GCC source and build trees are
-located in a top-level directory (like <tt>/cygdrive/c/llvm</tt> and
-<tt>/cygdrive/c/llvm-cfrontend</tt>), not in a directory that contains a space
-(which includes your "home directory", because it lives under the "Documents
-and Settings" directory). We welcome patches to fix this issue.
-</p>
-<p>It has been found that the GCC 3.3.3 compiler provided with recent Cygwin
-versions is incapable of compiling the LLVM CFE correctly. If your Cygwin
-installation includes GCC 3.3.3 we <i>strongly</i> recommend that you download
-GCC 3.4.3, build it separately, and use it for compiling LLVM CFE. This has been
-shown to work correctly.</p>
-<p>Some versions of Cygwin utilize an experimental version of GNU binutils that
-will cause the GNU <tt>ld</tt> linker to fail an assertion when linking
-components of the libstdc++. It is recommended that you replace the entire
-binutils package with version 2.15 such that "<tt>ld --version</tt>" responds
-with</p>
-<pre>GNU ld version 2.15</pre>
-not with:<br/>
-<pre>GNU ld version 2.15.91 20040725</pre>
-</div>
-
-<!--=========================================================================-->
-<div class="doc_subsection"><a name="aix">Building under AIX</a></div>
-<div class="doc_text">
-<p>If you are building LLVM and the GCC front-end under AIX, do NOT use GNU
-Binutils. They are not stable under AIX and may produce incorrect and/or
-invalid code. Instead, use the system assembler and linker.
-</p>
-</div>
-
-<!-- *********************************************************************** -->
-<div class="doc_section">
- <a name="instructions">Instructions</a>
-</div>
-<!-- *********************************************************************** -->
-
-<div class="doc_text">
-<p>
-<ol>
-<li><p>Configure and build the LLVM libraries and tools. There are two ways to
-do this: either with <i>objdir</i> == <i>srcdir</i> or not. It is recommended
-that <i>srcdir</i> not be the same as <i>objdir</i>:</p>
-<ul>
- <li>With <i>objdir</i> != <i>srcdir</i>:<pre>
- % cd <i>objdir</i>
- % <i>srcdir</i>/configure --prefix=/some/path/you/can/install/to [options...]
- % gmake tools-only
- </pre></li>
- <li>With <i>objdir</i> == <i>srcdir</i>:<pre>
- % cd llvm
- % ./configure --prefix=/some/path/you/can/install/to [options...]
- % gmake tools-only
- </pre></li>
-</ul>
-<p>This will build all of the LLVM tools and libraries. The <tt>--prefix</tt>
-option defaults to /usr/local (per configure standards) but unless you are a
-system administrator, you probably won't be able to install LLVM there because
-of permissions. Specify a path into which LLVM can be installed (e.g.
-<tt>--prefix=/home/user/llvm</tt>).</p>
-</li>
-
-<li><p>Add the directory containing the tools to your PATH.</p>
-<pre>
- % set path = ( `cd llvm/Debug/bin && pwd` $path )
-</pre></li>
-
-<li><p>Unpack the C/C++ front-end source into cfrontend/src, either by
- untar'ing an llvm-gcc.tar.gz file or checking out CVS into this
- directory.</p></li>
-
-<li><p>Make "build" and "install" directories as siblings of the "src" tree.</p>
-<pre>
- % pwd
- /usr/local/example/cfrontend/src
- % cd ..
- % mkdir build install
- % set CFEINSTALL = `pwd`/install
-</pre></li>
-
-
-<li><p>Configure, build, and install the GCC front-end:</p>
-
-<p>
-<b>Linux/x86:</b><br>
-<b>MacOS X/PowerPC</b> (requires dlcompat library):<br>
-<b>AIX/PowerPC:</b>
-</p>
-
-<pre>
- % cd build
- % ../src/configure --prefix=$CFEINSTALL --disable-threads --disable-nls \
- --disable-shared --enable-languages=c,c++ --program-prefix=llvm-
- % gmake all; gmake install
-</pre>