6563616: Clarify instructions for unpacking openjdk binary "plug"
authorohair
Wed, 30 Apr 2008 19:35:26 -0700
changeset 333 d4540117530e
parent 330 5ae7db536e3f
child 334 fcdebcbc4177
6563616: Clarify instructions for unpacking openjdk binary "plug" 6611685: Incorrect link to CA certs info from build README 6682167: Add cygwin faq to README-builds.html Reviewed-by: xdono
README-builds.html
--- a/README-builds.html	Wed Jul 05 16:35:09 2017 +0200
+++ b/README-builds.html	Wed Apr 30 19:35:26 2008 -0700
@@ -1,1447 +1,1587 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
 <html>
-<head><title>OpenJDK Build README</title></head>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<center>
-    <h1>OpenJDK Build README</h1>
-</center>
-
-<!-- ------------------------------------------------------ --> 
-<hr noshade="noshade" size="3">
-
-<h2><a name="introduction">Introduction</a></h2>
-
-<blockquote>
-    <p>
-    This README file contains build instructions for the 
-    <a href="http://openjdk.java.net">OpenJDK</a>.
-    Building the source code for the 
-    OpenJDK
-    requires
-    a certain degree of technical expertise.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h2><a name="contents">Contents</a></h2>
-
-<blockquote>
-    <ul>
-        <li><a href="#introduction">Introduction</a></li>
-        <li><a href="#MBE">Minimum Build Environments</a></li>
-        <li><a href="#SDBE">Specific Developer Build Environments</a></li>
-        <li><a href="#directories">Source Directory Structure</a> </li>
-        <li><a href="#building">Build Information</a>
-            <ul type="disc">
-                <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li>
-                <li><a href="#linux">Basic Linux System Setup</a> </li>
-                <li><a href="#solaris">Basic Solaris System Setup</a> </li>
-                <li><a href="#windows">Basic Windows System Setup</a> </li>
-                <li><a href="#dependencies">Build Dependencies</a> </li>
-                <ul type="disc">
-                    <li><a href="#bootjdk">Bootstrap JDK</a> </li>
-                    <li><a href="#binaryplugs">Binary Plugs</a> </li>
-                    <li><a href="#cacerts">Certificate Authority File (cacert)</a> </li>
-                    <li><a href="#compilers">Compilers</a> 
-                        <ul>
-                            <li><a href="#msvc">Microsoft Visual Studio</a> </li>
-                            <li><a href="#mssdk">Microsoft Platform SDK</a> </li>
-                            <li><a href="#gcc">Linux gcc/binutils</a> </li>
-                            <li><a href="#studio">Sun Studio</a> </li>
-                        </ul>
-                    </li>
-                    <li>Linux and Solaris:
-                        <ul>
-                            <li><a href="#cups">CUPS Include files</a> </li>
-                        </ul>
-                    </li>
-                    <li>Windows only:
-                        <ul>
-                            <li>Unix Command Tools (<a href="#cygwin">CYGWIN</a>)</li>
-                            <li><a href="#dxsdk">DirectX 9.0 SDK</a> </li>
-                        </ul>
-                    </li>
-                </ul>
-            </ul>
-        </li>
-        <li><a href="#creating">Creating the Build</a> </li>
-        <li><a href="#testing">Testing the Build</a> </li>
-        <li><a href="#variables">Environment/Make Variables</a></li>
-        <li><a href="#troubleshooting">Troubleshooting</a></li>
-    </ul>
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h2><a name="MBE">Minimum Build Environments</a></h2>
-
-<blockquote>
-    <p>
-    This file often describes specific requirements for what we call the
-    "minimum build environments" (MBE) for the JDK.
-    Building with the MBE will generate the most compatible
-    bits that install on, and run correctly on, the most variations
-    of the same base OS and hardware architecture.
-    These usually represent what is often called the
-    least common denominator platforms.
-    It is understood that most developers will NOT be using these 
-    specific platforms, and in fact creating these specific platforms
-    may be difficult due to the age of some of this software.
-    <p>
-    
-    <p>
-    The minimum OS and C/C++ compiler versions needed for building the
-    OpenJDK:
-    <p>
-    <center>
-        <table border="1">
-            <thead>
-                <tr>
-                    <th>Base OS and Architecture</th>
-                    <th>OS</th>
-                    <th>Compiler</th>
-                </tr>
-            </thead>
-            <tbody>
-                <tr>
-                    <td>Linux X86 (32bit)</td>
-                    <td>Red Hat Enterprise Linux 4 </td>
-                    <td>gcc 4 </td>
-                </tr>
-                <tr>
-                    <td>Linux X64 (64bit)</td>
-                    <td>Red Hat Enterprise Linux 4 </td>
-                    <td>gcc 4 </td>
-                </tr>
-                <tr>
-                    <td>Solaris SPARC (32bit)</td>
-                    <td>Solaris 10 + patches 
-                        <br>
-                        See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE">SunSolve</a> for patch downloads.
-                    </td>
-                    <td>Sun Studio 11 </td>
-                </tr>
-                <tr>
-                    <td>Solaris SPARCV9 (64bit)</td>
-                    <td>Solaris 10 + patches
-                        <br>
-                        See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE">SunSolve</a> for patch downloads.
-                    </td>
-                    <td>Sun Studio 11</td>
-                </tr>
-                <tr>
-                    <td>Solaris X86 (32bit)</td>
-                    <td>Solaris 10 + patches
-                        <br>
-                        See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE">SunSolve</a> for patch downloads.
-                    </td>
-                    <td>Sun Studio 11</td>
-                </tr>
-                <tr>
-                    <td>Solaris X64 (64bit)</td>
-                    <td>Solaris 10 + patches
-                        <br>
-                        See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE">SunSolve</a> for patch downloads.
-                    </td>
-                    <td>Sun Studio 11</td>
-                </tr>
-                <tr>
-                    <td>Windows X86 (32bit)</td>
-                    <td>Windows XP</td>
-                    <td>Microsoft Visual Studio .NET 2003 Professional</td>
-                </tr>
-                <tr>
-                    <td>Windows X64 (64bit)</td>
-                    <td>Windows Server 2003 - Enterprise x64 Edition</td>
-                    <td>Microsoft Platform SDK - April 2005</td>
-                </tr>
-            </tbody>
+    <head>
+        <title>OpenJDK Build README</title>
+    </head>
+    <body style="background-color:lightcyan">
+        <!-- ====================================================== -->
+        <table width="100%" style="background-color:white">
+            <tr>
+                <td align="center">
+                    <a href="http://openjdk.java.net" border="0">    
+                        <img alt="OpenJDK" 
+                             src="http://openjdk.java.net/images/openjdk.png"
+                             width=256
+                             style="border-style: none"/>
+                    </a>
+                </td>
+            </tr>
+            <tr>
+                <td align=center>
+                    <h1>OpenJDK Build README</h1>
+                </td>
+            </tr>
         </table>
-    </center>
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h2><a name="SDBE">Specific Developer Build Environments</a></h2>
-
-<blockquote>
-    <p>
-    We won't be listing all the possible environments, but
-    we will try to provide what information we have available to us.
-</blockquote>
-
-<h3><a name="fedora">Fedora</a></h3>
-
-<blockquote>
-    TBD
-</blockquote>
-
-<h3><a name="debian">Debian</a></h3>
-
-<blockquote>
-    TBD
-</blockquote>
-
-<h3><a name="ubuntu">Ubuntu</a></h3>
-
-<blockquote>
-    <p>
-    In addition to needing the Bootstrap JDK and the Binary Plugs, 
-    when building on Ubuntu you will need to
-    make sure certain packages are installed.
-    In particular, certain X11 packages, make, m4, gawk, gcc 4, 
-    binutils, cups, freetype
-    and alsa.
-    
-    <h4>Ubuntu 6.06</h4>
-    
-    <p>
-    The following list of packages for Ubuntu 6.06 is a working set that
-    does appear to work. 
-    
-    <p>
-    <b>Note that it's quite possible that some of these
-        packages are not required, so anyone discovering that some of the
-        packages listed below are NOT required,
-        please let the
-        OpenJDK
-    team know.</b>
-    <p>
-    All the packages below can be installed with the
-    Synaptic Package manager provided with the base Ubuntu 6.06 release.
-    
-    <blockquote>
-        <ul>
-            <li>binutils (2.16.1cvs20060117-1ubuntu2.1)</li>
-            <li>cpp (4:4.0.3-1)</li>
-            <li>cpp-4.0 (4.0.3-1ubuntu5)</li>
-            <li>libfreetype6-dev</li>
-            <li>g++ (4:4.0.3-1)</li>
-            <li>g++-4.0 (4.0.3-1ubuntu5)</li>
-            <li>gawk (1:3.1.5-2build1)</li>
-            <li>gcc (4:4.0.3-1)</li>
-            <li>gcc-4.0 (4.0.3-1ubuntu5)</li>
-            <li>libasound2-dev (1.0.10-2ubuntu4)</li>
-            <li>libc6 (2.3.6-0ubuntu20) to 2.3.6-0ubuntu20.4</li>
-            <li>libc6-dev (2.3.6-0ubuntu20.4)</li>
-            <li>libc6-i686 (2.3.6-0ubuntu20) to 2.3.6-0ubuntu20.4</li>
-            <li>libcupsys2-dev (1.2.2-0ubuntu0.6.06)</li>
-            <li>libgcrypt11-dev (1.2.2-1)</li>
-            <li>libgnutls-dev (1.2.9-2ubuntu1.1)</li>
-            <li>libgnutls12 (1.2.9-2ubuntu1) to 1.2.9-2ubuntu1.1</li>
-            <li>libgpg-error-dev (1.1-4)</li>
-            <li>libice-dev (2:1.0.0-0ubuntu2)</li>
-            <li>liblockfile1 (1.06.1)</li>
-            <li>libopencdk8-dev (0.5.7-2)</li>
-            <li>libpopt-dev (1.7-5)</li>
-            <li>libsm-dev (2:1.0.0-0ubuntu2)</li>
-            <li>libstdc++6-4.0-dev (4.0.3-1ubuntu5)</li>
-            <li>libtasn1-2-dev (0.2.17-1ubuntu1)</li>
-            <li>libx11-dev (2:1.0.0-0ubuntu9)</li>
-            <li>libxau-dev (1:1.0.0-0ubuntu4)</li>
-            <li>libxaw-headers (2:1.0.1-0ubuntu3)</li>
-            <li>libxaw7-dev (2:1.0.1-0ubuntu3)</li>
-            <li>libxdmcp-dev (1:1.0.0-0ubuntu2)</li>
-            <li>libxext-dev (2:1.0.0-0ubuntu4)</li>
-            <li>libxi-dev (2:1.0.0-0ubuntu3) </li>
-            <li>libxmu-dev (2:1.0.0-0ubuntu3)</li>
-            <li>libxmu-headers (2:1.0.0-0ubuntu3)</li>
-            <li>libxmuu-dev (2:1.0.0-0ubuntu3)</li>
-            <li>libxp-dev (6.8.2-11ubuntu2)</li>
-            <li>libxpm-dev (1:3.5.4.2-0ubuntu3)</li>
-            <li>libxrandr-dev (1:1.1.0.2-0ubuntu4)</li>
-            <li>libxt-dev (1:1.0.0-0ubuntu3)</li>
-            <li>libxtrap-dev (2:1.0.0-0ubuntu2)</li>
-            <li>libxtst-dev (2:1.0.1-0ubuntu2)</li>
-            <li>libxv-dev (2:1.0.1-0ubuntu3)</li>
-            <li>linux-kernel-headers (2.6.11.2-0ubuntu18)</li>
-            <li>m4 (1.4.4-1)</li>
-            <li>make (3.80+3.81.b4-1)</li>
-            <li>ssl-cert (1.0.13)</li>
-            <li>x-dev (7.0.4-0ubuntu2)</li>
-            <li>x11proto-core-dev (7.0.4-0ubuntu2)</li>
-            <li>x11proto-input-dev (1.3.2-0ubuntu2)</li>
-            <li>x11proto-kb-dev (1.0.2-0ubuntu2)</li>
-            <li>x11proto-randr-dev (1.1.2-0ubuntu2)</li>
-            <li>x11proto-record-dev (1.13.2-0ubuntu2)</li>
-            <li>x11proto-trap-dev (3.4.3-0ubuntu2)</li>
-            <li>x11proto-video-dev (2.2.2-0ubuntu2)</li>
-            <li>x11proto-xext-dev (7.0.2-0ubuntu2)</li>
-            <li>xlibs-dev (7.0.0-0ubuntu45)</li>
-            <li>zlib1g-dev (1:1.2.3-6ubuntu4)</li>
-        </ul>
-    </blockquote>
-    
-    <h4>Ubuntu 7.04</h4>
-    
-    <p>
-    Using the Synaptic Package Manager, download the following
-    packages (double indented packages are automatically aquired
-    due to package dependencies):
-    
-    <blockquote>
-        <ul>
-            <li>build-essential</li>
+        <!-- ------------------------------------------------------ --> 
+        <hr>
+        <h2><a name="introduction">Introduction</a></h2>
+        <blockquote>
+            <p>
+            This README file contains build instructions for the 
+            <a href="http://openjdk.java.net"  target="_blank">OpenJDK</a>.
+            Building the source code for the 
+            OpenJDK
+            requires
+            a certain degree of technical expertise.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="contents">Contents</a></h2>
+        <blockquote>
             <ul>
-                <li>dpkg-dev</li>
-                <li>g++</li>
-                <li>g++-4.1</li>
-                <li>libc6-dev</li>
-                <li>libstdc++6.4.1-dev</li>
-                <li>linux-libc-dev</li>
-            </ul>
-            <li>gawk</li>
-            <li>m4</li>
-            <li>libasound2-dev</li>
-            <li>libcupsys2-dev</li>
-            <ul>
-                <li>libgcrypt11-dev</li>
-                <li>lgnutls-dev</li>
-                <li>libgpg-error-dev</li>
-                <li>liblzo-dev</li>
-                <li>libopencdk8-dev</li>
-                <li>libpopt-dev</li>
-                <li>libtasn1-3-dev</li>
-                <li>zlib1g-dev</li>
-            </ul>
-            <li>sun-java6-jdk</li>
-            <ul>
-                <li>java-common</li>
-                <li>libltdl3</li>
-                <li>odbcinst1debian1</li>
-                <li>sun-java6-bin</li>
-                <li>sun-java6-jre</li>
-                <li>unixodbc</li>
-            </ul>
-            <li>xlibs-dev</li>
-            <ul>
-                <li>(many)</li>
-            </ul>
-            <li>x11proto-print-dev</li>
-            <li>libxaw7-dev</li>
-            <ul>
-                <li>libxaw-headers</li>
+                <li><a href="#introduction">Introduction</a></li>
+                <li><a href="#MBE">Minimum Build Environments</a></li>
+                <li><a href="#SDBE">Specific Developer Build Environments</a></li>
+                <li><a href="#directories">Source Directory Structure</a> </li>
+                <li><a href="#building">Build Information</a>
+                    <ul>
+                        <li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li>
+                        <li><a href="#linux">Basic Linux System Setup</a> </li>
+                        <li><a href="#solaris">Basic Solaris System Setup</a> </li>
+                        <li><a href="#windows">Basic Windows System Setup</a> </li>
+                        <li><a href="#dependencies">Build Dependencies</a> </li>
+                        <ul>
+                            <li><a href="#bootjdk">Bootstrap JDK</a> </li>
+                            <li><a href="#binaryplugs">Binary Plugs</a> </li>
+                            <li><a href="#importjdk">Optional Import JDK</a> </li>
+                            <li><a href="#cacerts">Certificate Authority File (cacert)</a> </li>
+                            <li><a href="#compilers">Compilers</a> 
+                                <ul>
+                                    <li><a href="#msvc">Microsoft Visual Studio</a> </li>
+                                    <li><a href="#mssdk">Microsoft Platform SDK</a> </li>
+                                    <li><a href="#gcc">Linux gcc/binutils</a> </li>
+                                    <li><a href="#studio">Sun Studio</a> </li>
+                                </ul>
+                            </li>
+                            <li><a href="#zip">Zip and Unzip</a> </li>
+                            <li><a href="#freetype">FreeType2 Fonts</a> </li>
+                            <li>Linux and Solaris:
+                                <ul>
+                                    <li><a href="#cups">CUPS Include files</a> </li>
+                                </ul>
+                            </li>
+                            <li>Linux only:
+                                <ul>
+                                    <li><a href="#alsa">ALSA files</a> </li>
+                                </ul>
+                            </li>
+                            <li>Windows only:
+                                <ul>
+                                    <li>Unix Command Tools (<a href="#cygwin">CYGWIN</a>)</li>
+                                    <li><a href="#dxsdk">DirectX 9.0 SDK</a> </li>
+                                </ul>
+                            </li>
+                        </ul>
+                    </ul>
+                </li>
+                <li><a href="#creating">Creating the Build</a> </li>
+                <li><a href="#testing">Testing the Build</a> </li>
+                <li><a href="#variables">Environment/Make Variables</a></li>
+                <li><a href="#troubleshooting">Troubleshooting</a></li>
             </ul>
-            <li>libxp-dev</li>
-            <li>libfreetype6-dev</li>
-        </ul>
-    </blockquote>
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h2><a name="directories">Source Directory Structure</a></h2>
-
-<blockquote>
-    <p>
-    The source code for the OpenJDK is delivered in a set of
-    directories:
-    <tt>hotspot</tt>, 
-    <tt>langtools</tt>, 
-    <tt>corba</tt>, 
-    <tt>jaxws</tt>, 
-    <tt>jaxp</tt>, 
-    and
-    <tt>jdk</tt>.
-    The <tt>hotspot</tt> directory contains the source code and make
-    files for building the OpenJDK Hotspot Virtual Machine. 
-    The <tt>langtools</tt> directory contains the source code and make
-    files for building the OpenJDK javac and language tools.
-    The <tt>corba</tt> directory contains the source code and make
-    files for building the OpenJDK Corba files.
-    The <tt>jaxws</tt> directory contains the source code and make
-    files for building the OpenJDK JAXWS files.
-    The <tt>jaxp</tt> directory contains the source code and make
-    files for building the OpenJDK JAXP files.
-    The <tt>jdk</tt> directory contains the source code and make files for
-    building the OpenJDK runtime libraries and misc files.
-    The top level <tt>Makefile</tt>
-    is used to build the entire OpenJDK.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h2><a name="building">Build Information</a></h2>
-
-<blockquote>
-    <p>
-    Building the 
-    OpenJDK
-    is done with a <tt><i>gmake</i></tt>
-    command line and various
-    environment or make variable settings that direct the make rules
-    to where various components have been installed.
-    Where possible the makefiles will attempt to located the various
-    components in the default locations or any component specific 
-    variable settings.
-    When the normal defaults fail or components cannot be found,
-    the various
-    <tt>ALT_*</tt> variables (alternates)
-    can be used to help the makefiles locate components.
-    <p>
-    Refer to the bash/sh/ksh setup file
-    <tt>jdk/make/jdk_generic_profile.sh</tt>
-    if you need help in setting up your environment variables.
-    A build could be as simple as:
-    <blockquote>
-        <pre><tt>
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="MBE">Minimum Build Environments</a></h2>
+        <blockquote>
+            This file often describes specific requirements for what we call the
+            "minimum build environments" (MBE) for the JDK.
+            Building with the MBE will generate the most compatible
+            bits that install on, and run correctly on, the most variations
+            of the same base OS and hardware architecture.
+            These usually represent what is often called the
+            least common denominator platforms.
+            It is understood that most developers will NOT be using these 
+            specific platforms, and in fact creating these specific platforms
+            may be difficult due to the age of some of this software.
+            <p>
+            The minimum OS and C/C++ compiler versions needed for building the
+            OpenJDK:
+            <p>
+            <table border="1">
+                <thead>
+                    <tr>
+                        <th>Base OS and Architecture</th>
+                        <th>OS</th>
+                        <th>Compiler</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <tr>
+                        <td>Linux X86 (32bit)</td>
+                        <td>Red Hat Enterprise Linux 4 </td>
+                        <td>gcc 4 </td>
+                    </tr>
+                    <tr>
+                        <td>Linux X64 (64bit)</td>
+                        <td>Red Hat Enterprise Linux 4 </td>
+                        <td>gcc 4 </td>
+                    </tr>
+                    <tr>
+                        <td>Solaris SPARC (32bit)</td>
+                        <td>Solaris 10 + patches 
+                            <br>
+                            See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
+                            SunSolve</a> for patch downloads.
+                        </td>
+                        <td>Sun Studio 11 </td>
+                    </tr>
+                    <tr>
+                        <td>Solaris SPARCV9 (64bit)</td>
+                        <td>Solaris 10 + patches
+                            <br>
+                            See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
+                            SunSolve</a> for patch downloads.
+                        </td>
+                        <td>Sun Studio 11</td>
+                    </tr>
+                    <tr>
+                        <td>Solaris X86 (32bit)</td>
+                        <td>Solaris 10 + patches
+                            <br>
+                            See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
+                            SunSolve</a> for patch downloads.
+                        </td>
+                        <td>Sun Studio 11</td>
+                    </tr>
+                    <tr>
+                        <td>Solaris X64 (64bit)</td>
+                        <td>Solaris 10 + patches
+                            <br>
+                            See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
+                            SunSolve</a> for patch downloads.
+                        </td>
+                        <td>Sun Studio 11</td>
+                    </tr>
+                    <tr>
+                        <td>Windows X86 (32bit)</td>
+                        <td>Windows XP</td>
+                        <td>Microsoft Visual Studio .NET 2003 Professional</td>
+                    </tr>
+                    <tr>
+                        <td>Windows X64 (64bit)</td>
+                        <td>Windows Server 2003 - Enterprise x64 Edition</td>
+                        <td>Microsoft Platform SDK - April 2005</td>
+                    </tr>
+                </tbody>
+            </table>
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="SDBE">Specific Developer Build Environments</a></h2>
+        <blockquote>
+            We won't be listing all the possible environments, but
+            we will try to provide what information we have available to us.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <h3><a name="fedora">Fedora</a></h3>
+        <blockquote>
+            TBD
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <h3><a name="debian">Debian</a></h3>
+        <blockquote>
+            TBD
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <h3><a name="ubuntu">Ubuntu</a></h3>
+        <blockquote>
+            In addition to needing the Bootstrap JDK and the Binary Plugs, 
+            when building on Ubuntu you will need to
+            make sure certain packages are installed.
+            In particular, certain X11 packages, make, m4, gawk, gcc 4, 
+            binutils, cups, freetype
+            and alsa.
+            <!-- ------------------------------------------------------ -->
+            <h4>Ubuntu 6.06</h4>
+            <p>
+            The following list of packages for Ubuntu 6.06 is a working set that
+            does appear to work. 
+            <p>
+            <b>Note that it's quite possible that some of these
+                packages are not required, so anyone discovering that some of the
+                packages listed below are NOT required,
+                please let the
+                OpenJDK
+            team know.</b>
+            <p>
+            All the packages below can be installed with the
+            Synaptic Package manager provided with the base Ubuntu 6.06 release.
+            <blockquote>
+                <ul>
+                    <li>binutils (2.16.1cvs20060117-1ubuntu2.1)</li>
+                    <li>cpp (4:4.0.3-1)</li>
+                    <li>cpp-4.0 (4.0.3-1ubuntu5)</li>
+                    <li>libfreetype6-dev</li>
+                    <li>g++ (4:4.0.3-1)</li>
+                    <li>g++-4.0 (4.0.3-1ubuntu5)</li>
+                    <li>gawk (1:3.1.5-2build1)</li>
+                    <li>gcc (4:4.0.3-1)</li>
+                    <li>gcc-4.0 (4.0.3-1ubuntu5)</li>
+                    <li>libasound2-dev (1.0.10-2ubuntu4)</li>
+                    <li>libc6 (2.3.6-0ubuntu20) to 2.3.6-0ubuntu20.4</li>
+                    <li>libc6-dev (2.3.6-0ubuntu20.4)</li>
+                    <li>libc6-i686 (2.3.6-0ubuntu20) to 2.3.6-0ubuntu20.4</li>
+                    <li>libcupsys2-dev (1.2.2-0ubuntu0.6.06)</li>
+                    <li>libgcrypt11-dev (1.2.2-1)</li>
+                    <li>libgnutls-dev (1.2.9-2ubuntu1.1)</li>
+                    <li>libgnutls12 (1.2.9-2ubuntu1) to 1.2.9-2ubuntu1.1</li>
+                    <li>libgpg-error-dev (1.1-4)</li>
+                    <li>libice-dev (2:1.0.0-0ubuntu2)</li>
+                    <li>liblockfile1 (1.06.1)</li>
+                    <li>libopencdk8-dev (0.5.7-2)</li>
+                    <li>libpopt-dev (1.7-5)</li>
+                    <li>libsm-dev (2:1.0.0-0ubuntu2)</li>
+                    <li>libstdc++6-4.0-dev (4.0.3-1ubuntu5)</li>
+                    <li>libtasn1-2-dev (0.2.17-1ubuntu1)</li>
+                    <li>libx11-dev (2:1.0.0-0ubuntu9)</li>
+                    <li>libxau-dev (1:1.0.0-0ubuntu4)</li>
+                    <li>libxaw-headers (2:1.0.1-0ubuntu3)</li>
+                    <li>libxaw7-dev (2:1.0.1-0ubuntu3)</li>
+                    <li>libxdmcp-dev (1:1.0.0-0ubuntu2)</li>
+                    <li>libxext-dev (2:1.0.0-0ubuntu4)</li>
+                    <li>libxi-dev (2:1.0.0-0ubuntu3) </li>
+                    <li>libxmu-dev (2:1.0.0-0ubuntu3)</li>
+                    <li>libxmu-headers (2:1.0.0-0ubuntu3)</li>
+                    <li>libxmuu-dev (2:1.0.0-0ubuntu3)</li>
+                    <li>libxp-dev (6.8.2-11ubuntu2)</li>
+                    <li>libxpm-dev (1:3.5.4.2-0ubuntu3)</li>
+                    <li>libxrandr-dev (1:1.1.0.2-0ubuntu4)</li>
+                    <li>libxt-dev (1:1.0.0-0ubuntu3)</li>
+                    <li>libxtrap-dev (2:1.0.0-0ubuntu2)</li>
+                    <li>libxtst-dev (2:1.0.1-0ubuntu2)</li>
+                    <li>libxv-dev (2:1.0.1-0ubuntu3)</li>
+                    <li>linux-kernel-headers (2.6.11.2-0ubuntu18)</li>
+                    <li>m4 (1.4.4-1)</li>
+                    <li>make (3.80+3.81.b4-1)</li>
+                    <li>ssl-cert (1.0.13)</li>
+                    <li>x-dev (7.0.4-0ubuntu2)</li>
+                    <li>x11proto-core-dev (7.0.4-0ubuntu2)</li>
+                    <li>x11proto-input-dev (1.3.2-0ubuntu2)</li>
+                    <li>x11proto-kb-dev (1.0.2-0ubuntu2)</li>
+                    <li>x11proto-randr-dev (1.1.2-0ubuntu2)</li>
+                    <li>x11proto-record-dev (1.13.2-0ubuntu2)</li>
+                    <li>x11proto-trap-dev (3.4.3-0ubuntu2)</li>
+                    <li>x11proto-video-dev (2.2.2-0ubuntu2)</li>
+                    <li>x11proto-xext-dev (7.0.2-0ubuntu2)</li>
+                    <li>xlibs-dev (7.0.0-0ubuntu45)</li>
+                    <li>zlib1g-dev (1:1.2.3-6ubuntu4)</li>
+                </ul>
+            </blockquote>
+            <!-- ------------------------------------------------------ -->
+            <h4>Ubuntu 7.04</h4>
+            <p>
+            Using the Synaptic Package Manager, download the following
+            packages (double indented packages are automatically aquired
+            due to package dependencies):
+            <blockquote>
+                <ul>
+                    <li>build-essential</li>
+                    <ul>
+                        <li>dpkg-dev</li>
+                        <li>g++</li>
+                        <li>g++-4.1</li>
+                        <li>libc6-dev</li>
+                        <li>libstdc++6.4.1-dev</li>
+                        <li>linux-libc-dev</li>
+                    </ul>
+                    <li>gawk</li>
+                    <li>m4</li>
+                    <li>libasound2-dev</li>
+                    <li>libcupsys2-dev</li>
+                    <ul>
+                        <li>libgcrypt11-dev</li>
+                        <li>lgnutls-dev</li>
+                        <li>libgpg-error-dev</li>
+                        <li>liblzo-dev</li>
+                        <li>libopencdk8-dev</li>
+                        <li>libpopt-dev</li>
+                        <li>libtasn1-3-dev</li>
+                        <li>zlib1g-dev</li>
+                    </ul>
+                    <li>sun-java6-jdk</li>
+                    <ul>
+                        <li>java-common</li>
+                        <li>libltdl3</li>
+                        <li>odbcinst1debian1</li>
+                        <li>sun-java6-bin</li>
+                        <li>sun-java6-jre</li>
+                        <li>unixodbc</li>
+                    </ul>
+                    <li>xlibs-dev</li>
+                    <ul>
+                        <li>(many)</li>
+                    </ul>
+                    <li>x11proto-print-dev</li>
+                    <li>libxaw7-dev</li>
+                    <ul>
+                        <li>libxaw-headers</li>
+                    </ul>
+                    <li>libxp-dev</li>
+                    <li>libfreetype6-dev</li>
+                </ul>
+            </blockquote>
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="directories">Source Directory Structure</a></h2>
+        <blockquote>
+            <p>
+            The source code for the OpenJDK is delivered in a set of
+            directories:
+            <tt>hotspot</tt>, 
+            <tt>langtools</tt>, 
+            <tt>corba</tt>, 
+            <tt>jaxws</tt>, 
+            <tt>jaxp</tt>, 
+            and
+            <tt>jdk</tt>.
+            The <tt>hotspot</tt> directory contains the source code and make
+            files for building the OpenJDK Hotspot Virtual Machine. 
+            The <tt>langtools</tt> directory contains the source code and make
+            files for building the OpenJDK javac and language tools.
+            The <tt>corba</tt> directory contains the source code and make
+            files for building the OpenJDK Corba files.
+            The <tt>jaxws</tt> directory contains the source code and make
+            files for building the OpenJDK JAXWS files.
+            The <tt>jaxp</tt> directory contains the source code and make
+            files for building the OpenJDK JAXP files.
+            The <tt>jdk</tt> directory contains the source code and make files for
+            building the OpenJDK runtime libraries and misc files.
+            The top level <tt>Makefile</tt>
+            is used to build the entire OpenJDK.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="building">Build Information</a></h2>
+        <blockquote>
+            Building the OpenJDK
+            is done with a <tt><i>gmake</i></tt>
+            command line and various
+            environment or make variable settings that direct the make rules
+            to where various components have been installed.
+            Where possible the makefiles will attempt to located the various
+            components in the default locations or any component specific 
+            variable settings.
+            When the normal defaults fail or components cannot be found,
+            the various
+            <tt>ALT_*</tt> variables (alternates)
+            can be used to help the makefiles locate components.
+            <p>
+            Refer to the bash/sh/ksh setup file
+            <tt>jdk/make/jdk_generic_profile.sh</tt>
+            if you need help in setting up your environment variables.
+            A build could be as simple as:
+            <blockquote>
+                <pre><tt>
                 bash
                 . jdk/make/jdk_generic_profile.sh
                 <i>gmake</i> sanity &amp;&amp; <i>gmake</i>
-        </tt></pre>
-    </blockquote>
-    <p>
-    Of course ksh or sh would work too.
-    But some customization will probably be necessary.
-    The <tt>sanity</tt> rule will make some basic checks on build
-    dependencies and generate appropriate warning messages
-    regarding missing, out of date, or newer than expected components
-    found on your system.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h3><a name="gmake">GNU make (<tt><i>gmake</i></tt>)</a></h3>
-
-<blockquote>
-    <p>
-    The Makefiles in the 
-    OpenJDK 
-    are only valid when used with the 
-    GNU version of the utility command <tt>make</tt>
-    (<tt><i>gmake</i></tt>).
-    A few notes about using GNU make:
-    <ul>
-        <li>
-            In general, you need GNU make version 3.78.1 or newer.
-        </li>
-        <li>
-            Place the location of the GNU make binary in the <tt>PATH</tt>. 
-        </li>
-        <li>
-            <strong>Linux:</strong>
-            The <tt>/usr/bin/make</tt> command should work fine for you.
-        </li>
-        <li>
-            <strong>Solaris:</strong>
-            Do NOT use <tt>/usr/bin/make</tt> on Solaris.
-            If your Solaris system has the software
-            from the Solaris Companion CD installed, 
-            you should use <tt>gmake</tt>
-            which will be located in either the <tt>/opt/sfw/bin</tt> or 
-            <tt>/usr/sfw/bin</tt> directory.
-        </li>
-        <li>
+                </tt></pre>
+            </blockquote>
+            <p>
+            Of course ksh or sh would work too.
+            But some customization will probably be necessary.
+            The <tt>sanity</tt> rule will make some basic checks on build
+            dependencies and generate appropriate warning messages
+            regarding missing, out of date, or newer than expected components
+            found on your system.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h3><a name="gmake">GNU make (<tt><i>gmake</i></tt>)</a></h3>
+        <blockquote>
+            The Makefiles in the OpenJDK are only valid when used with the 
+            GNU version of the utility command <tt>make</tt>
+            (<tt><i>gmake</i></tt>).
+            A few notes about using GNU make:
+            <ul>
+                <li>
+                    In general, you need GNU make version 3.78.1 or newer.
+                </li>
+                <li>
+                    Place the location of the GNU make binary in the <tt>PATH</tt>. 
+                </li>
+                <li>
+                    <strong>Linux:</strong>
+                    The <tt>/usr/bin/make</tt> command should work fine for you.
+                </li>
+                <li>
+                    <strong>Solaris:</strong>
+                    Do NOT use <tt>/usr/bin/make</tt> on Solaris.
+                    If your Solaris system has the software
+                    from the Solaris Companion CD installed, 
+                    you should use <tt>gmake</tt>
+                    which will be located in either the <tt>/opt/sfw/bin</tt> or 
+                    <tt>/usr/sfw/bin</tt> directory.
+                </li>
+                <li>
+                    <strong>Windows:</strong>
+                    Make sure you start your build inside a bash/sh/ksh shell.
+                    <br>
+                    <b>WARNING:</b> Watch out for make version 3.81, it may
+                    not work due to a lack of support for drive letter paths
+                    like <tt>C:/</tt>. See
+                    <a href="#gmake">section on gmake</a>.
+                    Use a 3.80 version, or find a newer
+                    version that has this problem fixed.
+                    The older 3.80 version of make.exe can be downloaded with this
+                    <a href="http://cygwin.paracoda.com/release/make/make-3.80-1.tar.bz2" target="_blank">
+                    link</a>.
+                    Also see the
+                    <a href="http://developer.mozilla.org/en/docs/Windows_build_prerequisites_using_cygwin#make" target="_blank">
+                    mozilla developer center</a>
+                    on this topic.
+                </li>
+            </ul>
+            <p>
+            Information on GNU make, and access to ftp download sites, are
+            available on the
+            <a href="http://www.gnu.org/software/make/make.html" target="_blank">
+                GNU make web site
+            </a>.
+            The latest source to GNU make is available at
+            <a href="http://ftp.gnu.org/pub/gnu/make/" target="_blank">
+            ftp.gnu.org/pub/gnu/make/</a>.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h3><a name="linux">Basic Linux System Setup</a></h3>
+        <blockquote>
+            <strong>i586 only:</strong>
+            The minimum recommended hardware for building the Linux version
+            is a Pentium class processor or better, at least 256 MB of RAM, and
+            approximately 1.5 GB of free disk space.
+            <p> 
+            <strong>X64 only:</strong>
+            The minimum recommended hardware for building the Linux
+            version is an AMD Opteron class processor, at least 512 MB of RAM, and
+            approximately 4 GB of free disk space.
+            <p> 
+            The build will use the tools contained in 
+            <tt>/bin</tt> and 
+            <tt>/usr/bin</tt>
+            of a standard installation of the Linux operating environment. 
+            You should ensure that these directories are in your 
+            <tt>PATH</tt>.
+            <p>
+            Note that some Linux systems have a habit of pre-populating
+            your environment variables for you, for example <tt>JAVA_HOME</tt>
+            might get pre-defined for you to refer to the JDK installed on
+            your Linux system. 
+            You will need to unset <tt>JAVA_HOME</tt>.
+            It's a good idea to run <tt>env</tt> and verify the
+            environment variables you are getting from the default system
+            settings make sense for building the 
+            OpenJDK.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <h4><a name="linux_checklist">Basic Linux Check List</a></h4>
+        <blockquote>
+            <ol>
+                <li>
+                    Install the
+                    <a href="#bootjdk">Bootstrap JDK</a>, set
+                    <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
+                </li>
+                <li>
+                    Install the
+                    <a href="#binaryplugs">Binary Plugs</a>, set
+                    <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
+                </li>
+                <li>
+                    <a href="#importjdk">Optional Import JDK</a>, set
+                    <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
+                </li>
+                <li>
+                    Install or upgrade the <a href="#freetype">FreeType development
+                    package</a>.
+                </li>
+            </ol>
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h3><a name="solaris">Basic Solaris System Setup</a></h3>
+        <blockquote>
+            The minimum recommended hardware for building the
+            Solaris SPARC version is an UltraSPARC with 512 MB of RAM. 
+            For building
+            the Solaris x86 version, a Pentium class processor or better and at
+            least 512 MB of RAM are recommended. 
+            Approximately 1.4 GB of free disk
+            space is needed for a 32-bit build.
+            <p>
+            If you are building the 64bit version, you should
+            run the command "isainfo -v" to verify that you have a
+            64-bit installation, it should say <tt>sparcv9</tt> or
+            <tt>amd64</tt>.
+            An additional 7 GB of free disk space is needed
+            for a 64-bit build.
+            <p> 
+            The build uses the tools contained in <tt>/usr/ccs/bin</tt>
+            and <tt>/usr/bin</tt> of a standard developer or full installation of
+            the Solaris operating environment.
+            <p> 
+            Solaris patches specific to the JDK can be downloaded from the 
+            <a href="http://sunsolve.sun.com/show.do?target=patches/JavaSE" target="_blank">
+            SunSolve JDK Solaris patches download page</a>.
+            You should ensure that the latest patch cluster for
+            your version of the Solaris operating environment has also
+            been installed.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <h4><a name="solaris_checklist">Basic Solaris Check List</a></h4>
+        <blockquote>
+            <ol>
+                <li>
+                    Install the
+                    <a href="#bootjdk">Bootstrap JDK</a>, set
+                    <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
+                </li>
+                <li>
+                    Install the
+                    <a href="#binaryplugs">Binary Plugs</a>, set
+                    <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
+                </li>
+                <li>
+                    <a href="#importjdk">Optional Import JDK</a>, set
+                    <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
+                </li>
+                <li>
+                    Install the
+                    <a href="#studio">Sun Studio Compilers</a>, set
+                    <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
+                </li>
+                <li>
+                    Install the
+                    <a href="#cups">CUPS Include files</a>, set
+                    <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>.
+                </li>
+            </ol>
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h3><a name="windows">Basic Windows System Setup</a></h3>
+        <blockquote> 
+            <strong>i586 only:</strong>
+            The minimum recommended hardware for building the 32bit or X86
+            Windows version is an Pentium class processor or better, at least
+            512 MB of RAM, and approximately 600 MB of free disk space.
+            <strong>
+                NOTE: The Windows 2000 build machines need to use the
+                file system NTFS. 
+                Build machines formatted to FAT32 will not work 
+                because FAT32 doesn't support case-sensitivity in file names.
+            </strong>
+            <p> 
+            <strong>X64 only:</strong>
+            The minimum recommended hardware for building
+            the Windows X64 version is an AMD Opteron class processor, at least 1
+            GB of RAM, and approximately 10 GB of free disk space.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <h4><a name="paths">Windows Paths</a></h4>
+        <blockquote>
             <strong>Windows:</strong>
-            Make sure you start your build inside a bash/sh/ksh shell.
-            <br>
-            <b>WARNING:</b> Watch out for make version 3.81, it may
-            not work due to a lack of support for drive letter paths
-            like <tt>C:/</tt>. Use a 3.80 version, or find a newer
-            version that has this problem fixed.
-        </li>
-    </ul>
-    <p>
-    Information on GNU make, and access to ftp download sites, are
-    available on the
-    <a href="http://www.gnu.org/software/make/make.html">
-        GNU make web site
-    </a>.
-    The latest source to GNU make is available at
-    <a href="http://ftp.gnu.org/pub/gnu/make/">ftp.gnu.org/pub/gnu/make/</a>.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h3><a name="linux">Basic Linux System Setup</a></h3>
-
-<blockquote>
-    <p>
-    <strong>i586 only:</strong>
-    The minimum recommended hardware for building the Linux version
-    is a Pentium class processor or better, at least 256 MB of RAM, and
-    approximately 1.5 GB of free disk space.
-    <p> 
-    <strong>X64 only:</strong>
-    The minimum recommended hardware for building the Linux
-    version is an AMD Opteron class processor, at least 512 MB of RAM, and
-    approximately 4 GB of free disk space.
-    <p> 
-    The build will use the tools contained in 
-    <tt>/bin</tt> and 
-    <tt>/usr/bin</tt>
-    of a standard installation of the Linux operating environment. 
-    You should ensure that these directories are in your 
-    <tt>PATH</tt>.
-    <p>
-    Note that some Linux systems have a habit of pre-populating
-    your environment variables for you, for example <tt>JAVA_HOME</tt>
-    might get pre-defined for you to refer to the JDK installed on
-    your Linux system. 
-    You will need to unset <tt>JAVA_HOME</tt>.
-    It's a good idea to run <tt>env</tt> and verify the
-    environment variables you are getting from the default system
-    settings make sense for building the 
-    OpenJDK.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-
-<h4><a name="linux_checklist">Basic Linux Check List</a></h4>
-
-<blockquote>
-    <ol>
-        <li>
-            Install the
-            <a href="#bootjdk">Bootstrap JDK</a>, set
-            <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
-        </li>
-        <li>
-            Install the
-            <a href="#binaryplugs">Binary Plugs</a>, set
-            <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
-        </li>
-        <li>
-            Install or upgrade the <a href="#freetype">FreeType development
-            package</a>.
-        </li>
-    </ol>
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h3><a name="solaris">Basic Solaris System Setup</a></h3>
-
-<blockquote>
-    <p>
-    The minimum recommended hardware for building the
-    Solaris SPARC version is an UltraSPARC with 512 MB of RAM. 
-    For building
-    the Solaris x86 version, a Pentium class processor or better and at
-    least 128 MB of RAM are recommended. 
-    Approximately 1.4 GB of free disk
-    space is needed for a 32-bit build.
-    <p>
-    If you are building the 64bit version, you should
-    run the command "isainfo -v" to verify that you have a
-    64-bit installation. 
-    An additional 7 GB of free disk space is needed
-    for a 64-bit build.
-    <p> 
-    The build uses the tools contained in <tt>/usr/ccs/bin</tt>
-    and <tt>/usr/bin</tt> of a standard developer or full installation of
-    the Solaris operating environment.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-
-<h4><a name="solaris_checklist">Basic Solaris Check List</a></h4>
-
-<blockquote>
-    <ol>
-        <li>
-            Install the
-            <a href="#bootjdk">Bootstrap JDK</a>, set
-            <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
-        </li>
-        <li>
-            Install the
-            <a href="#binaryplugs">Binary Plugs</a>, set
-            <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
-        </li>
-        <li>
-            Install the
-            <a href="#studio">Sun Studio Compilers</a>, set
-            <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
-        </li>
-        <li>
-            Install the
-            <a href="#cups">CUPS Include files</a>, set
-            <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>.
-        </li>
-    </ol>
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h3><a name="windows">Basic Windows System Setup</a></h3>
-
-<blockquote> 
-    <p>
-    <strong>i586 only:</strong>
-    The minimum recommended hardware for building the 32bit or X86
-    Windows version is an Pentium class processor or better, at least
-    512 MB of RAM, and approximately 600 MB of free disk space.
-    <strong>
-        NOTE: The Windows 2000 build machines need to use the
-        file system NTFS. 
-        Build machines formatted to FAT32 will not work 
-        because FAT32 doesn't support case-sensitivity in file names.
-    </strong>
-    <p> 
-    <strong>X64 only:</strong>
-    The minimum recommended hardware for building
-    the Windows X64 version is an AMD Opteron class processor, at least 1
-    GB of RAM, and approximately 10 GB of free disk space.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-
-<h4><a name="paths">Windows Paths</a></h4>
-
-<blockquote>
-    <p>
-    <strong>Windows:</strong>
-    Note that GNU make is a historic utility and is based very
-    heavily on shell scripting, so it does not tolerate the Windows habit
-    of having spaces in pathnames or the use of the <tt>\</tt>characters in pathnames.
-    Luckily on most Windows systems, you can use <tt>/</tt>instead of \, and
-    there is always a 'short' pathname without spaces for any path that 
-    contains spaces.
-    Unfortunately, this short pathname can be somewhat dynamic and the
-    formula is difficult to explain.
-    You can use <tt>cygpath</tt> utility to map pathnames with spaces
-    or the <tt>\</tt>character into the <tt>C:/</tt> style of pathname
-    (called 'mixed'), e.g.
-    <tt>cygpath -s -m "<i>path</i>"</tt>.
-    <p>
-    The makefiles will try to translate any pathnames supplied
-    to it into the <tt>C:/</tt> style automatically.
-    <p>
-    Note that use of CYGWIN creates a unique problem with regards to
-    setting <a href="#path"><tt>PATH</tt></a>. Normally on Windows
-    the <tt>PATH</tt> variable contains directories
-    separated with the ";" character (Solaris and Linux uses ":").
-    With CYGWIN, it uses ":", but that means that paths like "C:/path"
-    cannot be placed in the CYGWIN version  of <tt>PATH</tt> and
-    instead CYGWIN uses something like <tt>/cygdrive/c/path</tt>
-    which CYGWIN understands, but only CYGWIN understands.
-    So be careful with paths on Windows.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-
-<h4><a name="windows_checklist">Basic Windows Check List</a></h4>
-
-<blockquote>
-    <ol>
-        <li>
-            Install the
-            <a href="#cygwin">CYGWIN product</a>. 
-        </li>
-        <li>
-            Install the 
-            <a href="#bootjdk">Bootstrap JDK</a>, set
-            <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
-        </li>
-        <li>
-            Install the
-            <a href="#binaryplugs">Binary Plugs</a>, set
-            <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>..
-        </li>
-        <li>
-            Install the
-            <a href="#msvc">Microsoft Visual Studio .NET 2003 Professional</a> or the 
-            <a href="#mssdk">Microsoft Platform SDK</a>.
-        </li>
-        <li>
-            Setup all environment variables for compilers 
-            (see <a href="#msvc">compilers</a>).
-        </li>
-        <li>
-            Install 
-            <a href="#dxsdk">Microsoft DirectX SDK</a>.
-        </li>
-    </ol>
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h3><a name="dependencies">Build Dependencies</a></h3>
-
-<blockquote>
-    <p>
-    Depending on the platform, the 
-    OpenJDK 
-    build process has some basic
-    dependencies on components not part of the 
-    OpenJDK 
-    sources.
-    Some of these are specific to a platform, some even specific to
-    an architecture.
-    Each dependency will have a set of ALT variables that can be set
-    to tell the makefiles where to locate the component.
-    In most cases setting these ALT variables may not be necessary
-    and the makefiles will find defaults on the system in standard
-    install locations or through component specific variables.
-    
-    <h4><a name="bootjdk">Bootstrap JDK</a></h4>
-    
-    <blockquote>
-        <p>
-        All 
-        OpenJDK 
-        builds require access to the previously released 
-        JDK 6, this is often called a bootstrap JDK.
-        The JDK 6 binaries can be downloaded from Sun's 
-        <a href="http://java.sun.com/javase/1.6.0/download.html">JDK 6 download site</a>.
-        For build performance reasons
-        is very important that this bootstrap JDK be made available on the
-        local disk of the machine doing the build.
-        You should always set 
-        <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
-        to point to the location of
-        the bootstrap JDK installation, this is the directory pathname
-        that contains a <tt>bin, lib, and include</tt>
-        It's also a good idea to also place its <tt>bin</tt> directory
-        in the <tt>PATH</tt> environment variable, although it's
-        not required.
-        <p>
-        <strong>Solaris:</strong>
-        Some pre-installed JDK images may be available to you in the
-        directory <tt>/usr/jdk/instances</tt>.
-        If you don't set
-        <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
-        the makefiles will look in that location for a JDK it can use.
-    </blockquote>
-    
-    <h4><a name="binaryplugs">Binary Plugs</a></h4>
-    
-    <blockquote>
-        <p>
-        Not all of the source code that makes up the JDK is available
-        under an open-source license.
-        In order to build an OpenJDK binary from source code,
-        you must first download and install the appropriate
-	binary plug bundles from the OpenJDK, go to the
-	<a href="http://openjdk.java.net">OpenJDK</a> site and select
-	the "<b>Bundles(7)</b>" link.
-        During the OpenJDK build process these "binary plugs"
-        for the encumbered components will be copied into your
-        resulting OpenJDK binary build image.
-        These binary plug files are only for the purpose of
-        building an OpenJDK binary.
-        Make sure you set
-        <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
-        to the root of this installation.
-    </blockquote>
-    
-    <h4><a name="cacerts">Certificate Authority File (cacert)</a></h4>
-    
-    <blockquote>
-        <p>
-        See <a href="http://en.wikipedia.org/wiki/CAcert">
-        www.wikipedia.org/wiki/CAcert</a>
-        for a better understanding of the Certificate Authority (CA).
-        A certificates file named "cacerts"
-        represents a system-wide keystore with CA certificates. 
-        In JDK and JRE
-        binary bundles, the "cacerts" file contains root CA certificates from
-        several public CAs (e.g., VeriSign, Thawte, and Baltimore).
-        The source contain a cacerts file
-        without CA root certificates. 
-        Formal JDK builders will need to secure
-        permission from each public CA and include the certificates into their
-        own custom cacerts file. 
-        Failure to provide a populated cacerts file
-        will result in verification errors of a certificate chain during runtime.
-        The variable 
-        <tt><a href="#ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt>
-        can be used to override the default location of the
-        cacerts file that will get placed in your build.
-        By default an empty cacerts file is provided and that should be
-        fine for most JDK developers.
-    </blockquote>
-    
-    <h4><a name="compilers">Compilers</a></h4>
-    
-    <blockquote>
-        
-        <a name="gcc">
-            <strong>Linux gcc/binutils</strong>
-        </a>
-        
+            Note that GNU make is a historic utility and is based very
+            heavily on shell scripting, so it does not tolerate the Windows habit
+            of having spaces in pathnames or the use of the <tt>\</tt>characters in pathnames.
+            Luckily on most Windows systems, you can use <tt>/</tt>instead of \, and
+            there is always a 'short' pathname without spaces for any path that 
+            contains spaces.
+            Unfortunately, this short pathname can be somewhat dynamic and the
+            formula is difficult to explain.
+            You can use <tt>cygpath</tt> utility to map pathnames with spaces
+            or the <tt>\</tt>character into the <tt>C:/</tt> style of pathname
+            (called 'mixed'), e.g.
+            <tt>cygpath -s -m "<i>path</i>"</tt>.
+            <p>
+            The makefiles will try to translate any pathnames supplied
+            to it into the <tt>C:/</tt> style automatically.
+            <p>
+            Note that use of CYGWIN creates a unique problem with regards to
+            setting <a href="#path"><tt>PATH</tt></a>. Normally on Windows
+            the <tt>PATH</tt> variable contains directories
+            separated with the ";" character (Solaris and Linux uses ":").
+            With CYGWIN, it uses ":", but that means that paths like "C:/path"
+            cannot be placed in the CYGWIN version  of <tt>PATH</tt> and
+            instead CYGWIN uses something like <tt>/cygdrive/c/path</tt>
+            which CYGWIN understands, but only CYGWIN understands.
+            So be careful with paths on Windows.
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <h4><a name="windows_checklist">Basic Windows Check List</a></h4>
+        <blockquote>
+            <ol>
+                <li>
+                    Install the
+                    <a href="#cygwin">CYGWIN product</a>. 
+                </li>
+                <li>
+                    Install the 
+                    <a href="#bootjdk">Bootstrap JDK</a>, set
+                    <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
+                </li>
+                <li>
+                    Install the
+                    <a href="#binaryplugs">Binary Plugs</a>, set
+                    <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>..
+                </li>
+                <li>
+                    <a href="#importjdk">Optional Import JDK</a>, set
+                    <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
+                </li>
+                <li>
+                    Install the
+                    <a href="#msvc">Microsoft Visual Studio .NET 2003 Professional</a> or the 
+                    <a href="#mssdk">Microsoft Platform SDK</a>.
+                </li>
+                <li>
+                    Setup all environment variables for compilers 
+                    (see <a href="#msvc">compilers</a>).
+                </li>
+                <li>
+                    Install 
+                    <a href="#dxsdk">Microsoft DirectX SDK</a>.
+                </li>
+            </ol>
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h3><a name="dependencies">Build Dependencies</a></h3>
         <blockquote>
-            <p>
-            The GNU gcc compiler version should be 3.2.2 or newer.
-            The binutils package should be 2.11.93.0.2-11 or newer.
-            The compiler used should be the default compiler installed
-            in <tt>/usr/bin</tt>.
-        </blockquote>
-        
-        <strong><a name="studio">Solaris: Sun Studio</a></strong>
-        
-        <blockquote>
-            <p>
-            At a minimum, the
-            <a href="http://developers.sun.com/sunstudio/index.jsp">
-            Sun Studio 11 Compilers</a>
-            (containing version 5.8 of the C and C++ compilers) is required,
-            with patches from the
-            <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access">
-            SunSolve web site</a>.
-            <p> 
-            Set 
-            <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>
-            to point to the location of
-            the compiler binaries, and place this location in the <tt>PATH</tt>.
-            <p>
-            The Sun Studio Express compilers at:
-            <a href="http://developers.sun.com/sunstudio/downloads/express.jsp">
-            Sun Studio Express Download site</a>
-            are also an option, although these compilers have not
-            been extensively used yet.
-        </blockquote>
-        
-        <a name="msvc">
-            <strong>Windows i586: Microsoft Visual Studio .NET 2003 Professional</strong>
-        </a>
-        
-        <blockquote>
-            <p>
-            The 32-bit 
-            OpenJDK
-            Windows build
-            requires Microsoft Visual Studio .NET 2003 (VS2003) Professional
-            Edition compiler. 
-            The compiler and other tools are expected to reside
-            in the location defined by the variable <tt>VS71COMNTOOLS</tt> which
-            is set by the Microsoft Visual Studio .NET installer.
-            <p> 
-            Once the compiler is installed, 
-            it is recommended that you run <tt>VCVARS32.BAT</tt> 
-            to set the compiler environment variables
-            <tt>MSVCDIR</tt>, 
-            <tt>INCLUDE</tt>,
-            <tt>LIB</tt>, and
-            <tt>PATH</tt> 
-            prior to building the 
-            OpenJDK.
-            The above environment variables <b>MUST</b> be set.
-            <p>
-            The Microsoft Visual Studio .NET 2005 (VS2005) compiler
-            will not work at this time due to the new runtime dll
-            and the manifest requirements.
-        </blockquote>
-        
-        <a name="mssdk">
-            <strong>Windows X64: Microsoft Platform SDK April 2005</strong>
-        </a>
-        
-        <blockquote>
-            <p>
-            On <b>X64</b>,
-            the Microsoft Platform Software
-            Development Kit (SDK), April 2005 Edition compiler, is required for
-            building the 
-            OpenJDK
-            because it contains the C/C++ compiler. 
-            You will need to minimally install the Core SDK and
-            the MDAC SDK features of this compiler.
-            <p>
-            Once the Platform SDK is installed,
-            it is recommended that you run <tt>SetEnv.Cmd /X64</tt> 
-            to set the compiler environment variables
-            <tt>MSSDK</tt>, 
-            <tt>MSTOOLS</tt>,
-            <tt>INCLUDE</tt>,
-            <tt>LIB</tt>, and
-            <tt>PATH</tt> 
-            prior to building the 
-            OpenJDK.
-            The above environment variables <b>MUST</b> be set.
-            <p>
-            Note that this compiler may say it's version is a
-            Microsoft Visual Studio .NET 2005 (VS2005), but be careful,
-            it will not match the official VS2005 product.
-            This Platform SDK compiler is only used on X64 builds.
+            Depending on the platform, the OpenJDK build process has some basic
+            dependencies on components not part of the OpenJDK sources.
+            Some of these are specific to a platform, some even specific to
+            an architecture.
+            Each dependency will have a set of ALT variables that can be set
+            to tell the makefiles where to locate the component.
+            In most cases setting these ALT variables may not be necessary
+            and the makefiles will find defaults on the system in standard
+            install locations or through component specific variables.
+            <!-- ------------------------------------------------------ -->
+            <h4><a name="bootjdk">Bootstrap JDK</a></h4>
+            <blockquote>
+                All OpenJDK builds require access to the previously released 
+                JDK 6, this is often called a bootstrap JDK.
+                The JDK 6 binaries can be downloaded from Sun's 
+                <a href="http://java.sun.com/javase/1.6.0/download.html" target="_blank">JDK 6 download site</a>.
+                For build performance reasons
+                is very important that this bootstrap JDK be made available on the
+                local disk of the machine doing the build.
+                You should always set 
+                <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
+                to point to the location of
+                the bootstrap JDK installation, this is the directory pathname
+                that contains a <tt>bin, lib, and include</tt>
+                It's also a good idea to also place its <tt>bin</tt> directory
+                in the <tt>PATH</tt> environment variable, although it's
+                not required.
+                <p>
+                <strong>Solaris:</strong>
+                Some pre-installed JDK images may be available to you in the
+                directory <tt>/usr/jdk/instances</tt>.
+                If you don't set
+                <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
+                the makefiles will look in that location for a JDK it can use.
+            </blockquote>
+            <!-- ------------------------------------------------------ -->
+            <h4><a name="binaryplugs">Binary Plugs</a></h4>
+            <blockquote>
+                Not all of the source code that makes up the JDK is available
+                under an open-source license.
+                This is a temporary situation and these binary plugs will be
+                replaced with fully open source replacements as soon as possible.
+                So currently, in order to build a complete OpenJDK image,
+                you must first download and install the appropriate
+                binary plug bundles for the OpenJDK, go to the
+                <a href="http://openjdk.java.net" target="_blank">OpenJDK</a> site and select
+                the "<b>Bundles(7)</b>" link and download the binaryplugs for
+                your particular platform.
+                The file downloaded is a jar file that must be extracted by running
+                the jar file with:
+                <blockquote>
+                    <pre>
+            <tt><b>java -jar jdk-7-ea-plug-b<i>nn</i>-<i>os</i>-<i>arch</i>-<i>dd</i>_<i>month</i>_<i>year</i>.jar</b></tt>
+                    </pre>
+                </blockquote>
+                A prompt will be issued for acceptance of these binary plug files.
+                During the OpenJDK build process these "binary plugs"
+                for the encumbered components will be copied into your
+                resulting OpenJDK binary build image.
+                These binary plug files are only for the purpose of
+                building an OpenJDK binary.
+                Make sure you set
+                <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
+                to the root of this installation.
+            </blockquote>
+            <!-- ------------------------------------------------------ -->
+            <h4><a name="importjdk">Optional Import JDK</a></h4>
+            <blockquote>
+                The <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
+                setting is only needed if you are not building the entire
+                JDK. For example, if you have built the entire JDK once, and
+                wanted to avoid repeatedly building the Hotspot VM, you could
+                set this to the location of the previous JDK install image
+                and the build will copy the needed files from this import area.
+            </blockquote>
+            <!-- ------------------------------------------------------ -->
+            <h4><a name="cacerts">Certificate Authority File (cacert)</a></h4>
+            <blockquote>
+                See <a href="http://en.wikipedia.org/wiki/Certificate_Authority" target="_blank">
+                http://en.wikipedia.org/wiki/Certificate_Authority</a>
+                for a better understanding of the Certificate Authority (CA).
+                A certificates file named "cacerts"
+                represents a system-wide keystore with CA certificates. 
+                In JDK and JRE
+                binary bundles, the "cacerts" file contains root CA certificates from
+                several public CAs (e.g., VeriSign, Thawte, and Baltimore).
+                The source contain a cacerts file
+                without CA root certificates. 
+                Formal JDK builders will need to secure
+                permission from each public CA and include the certificates into their
+                own custom cacerts file. 
+                Failure to provide a populated cacerts file
+                will result in verification errors of a certificate chain during runtime.
+                The variable 
+                <tt><a href="#ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt>
+                can be used to override the default location of the
+                cacerts file that will get placed in your build.
+                By default an empty cacerts file is provided and that should be
+                fine for most JDK developers.
+            </blockquote>
+            <!-- ------------------------------------------------------ -->
+            <h4><a name="compilers">Compilers</a></h4>
+            <blockquote>
+                <strong><a name="gcc">Linux gcc/binutils</a></strong>
+                <blockquote>
+                    The GNU gcc compiler version should be 3.2.2 or newer.
+                    The binutils package should be 2.11.93.0.2-11 or newer.
+                    The compiler used should be the default compiler installed
+                    in <tt>/usr/bin</tt>.
+                    <p>
+                    Older Linux systems may require a gcc and bunutils update.
+                    The Redhat Enterprise Advanced Server 2.1 update 2 system
+                    is one of these systems.
+                    RedHat Linux users can obtain this binutils package from 
+                    <a href="http://www.redhat.com" 
+                       target="_blank">Redhat web site</a>. 
+                    You will need to remove the default compiler and binutils
+                    packages and install the required packages
+                    into the default location on the system.
+                    However if you have a new video card driver, like 
+                    Geforce 4 it is best to use
+                    the same compiler as the kernel was built with to 
+                    build the new video card driver module.
+                    So you should build the modules before making this change.
+                </blockquote>
+                <strong><a name="studio">Solaris: Sun Studio</a></strong>
+                <blockquote>
+                    At a minimum, the
+                    <a href="http://developers.sun.com/sunstudio/index.jsp" target="_blank">
+                    Sun Studio 11 Compilers</a>
+                    (containing version 5.8 of the C and C++ compilers) is required,
+                    with patches from the
+                    <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access" target="_blank">
+                    SunSolve web site</a>.
+                    <p> 
+                    Set 
+                    <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>
+                    to point to the location of
+                    the compiler binaries, and place this location in the <tt>PATH</tt>.
+                    <p>
+                    The Sun Studio Express compilers at:
+                    <a href="http://developers.sun.com/sunstudio/downloads/express.jsp" target="_blank">
+                    Sun Studio Express Download site</a>
+                    are also an option, although these compilers have not
+                    been extensively used yet.
+                </blockquote>
+                <strong><a name="msvc">Windows i586: Microsoft Visual Studio .NET 2003 Professional</a></strong>
+                <blockquote>
+                    The 32-bit OpenJDK Windows build
+                    requires Microsoft Visual Studio .NET 2003 (VS2003) Professional
+                    Edition compiler. 
+                    The compiler and other tools are expected to reside
+                    in the location defined by the variable <tt>VS71COMNTOOLS</tt> which
+                    is set by the Microsoft Visual Studio .NET installer.
+                    <p> 
+                    Once the compiler is installed, 
+                    it is recommended that you run <tt>VCVARS32.BAT</tt> 
+                    to set the compiler environment variables
+                    <tt>MSVCDIR</tt>, 
+                    <tt>INCLUDE</tt>,
+                    <tt>LIB</tt>, and
+                    <tt>PATH</tt> 
+                    prior to building the 
+                    OpenJDK.
+                    The above environment variables <b>MUST</b> be set.
+                    <p>
+                    The Microsoft Visual Studio .NET 2005 (VS2005) compiler
+                    will not work at this time due to the new runtime dll
+                    and the manifest requirements.
+                </blockquote>
+                <strong><a name="mssdk">Windows X64: Microsoft Platform SDK April 2005</a></strong>
+                <blockquote>
+                    On <b>X64</b>, the Microsoft Platform Software
+                    Development Kit (SDK), April 2005 Edition compiler,
+                    is required for building the OpenJDK
+                    because it contains the C/C++ compiler. 
+                    You will need to minimally install the Core SDK and
+                    the MDAC SDK features of this compiler.
+                    <p>
+                    Once the Platform SDK is installed,
+                    it is recommended that you run <tt>SetEnv.Cmd /X64</tt> 
+                    to set the compiler environment variables
+                    <tt>MSSDK</tt>, 
+                    <tt>MSTOOLS</tt>,
+                    <tt>INCLUDE</tt>,
+                    <tt>LIB</tt>, and
+                    <tt>PATH</tt> 
+                    prior to building the 
+                    OpenJDK.
+                    The above environment variables <b>MUST</b> be set.
+                    <p>
+                    Note that this compiler may say it's version is a
+                    Microsoft Visual Studio .NET 2005 (VS2005), but be careful,
+                    it will not match the official VS2005 product.
+                    This Platform SDK compiler is only used on X64 builds.
+                </blockquote>
+            </blockquote>
+            <!-- ------------------------------------------------------ --> 
+            <h4><a name="zip">Zip and Unzip</a></h4>
+            <blockquote>
+                Version 2.2 (November 3rd 1997) or newer of the zip utility 
+                and version 5.12 or newer of the unzip utility is needed 
+                to build the JDK.
+                With Solaris, Linux, and Windows CYGWIN, the zip and unzip
+                utilities installed on the system should be fine.
+                Information and the source code for
+                ZIP.EXE and UNZIP.EXE is available on the
+                <a href="http://www.info-zip.org" 
+                   target="_blank">info-zip web site</a>.
+            </blockquote>
+            <!-- ------------------------------------------------------ -->
+            <h4><a name="cups">Common UNIX Printing System (CUPS) Headers (Solaris &amp; Linux)</a></h4>
+            <blockquote>
+                <strong>Solaris:</strong>
+                CUPS header files are required for building the 
+                OpenJDK on Solaris.
+                The Solaris header files can be obtained by installing 
+                the package <strong>SFWcups</strong> from the Solaris Software
+                Companion CD/DVD, these often will be installed into 
+                <tt>/opt/sfw/cups</tt>.
+                <p>
+                <strong>Linux:</strong>
+                CUPS header files are required for building the 
+                OpenJDK on Linux.
+                The Linux header files are usually available from a "cups"
+                development package, it's recommended that you try and use
+                the package provided by the particular version of Linux that
+                you are using.
+                <p>
+                The CUPS header files can always be downloaded from 
+                <a href="http://www.cups.org" target="_blank">www.cups.org</a>.
+                The variable 
+                <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>
+                can be used to override the default location of the
+                CUPS Header files.
+            </blockquote>
+            <!-- ------------------------------------------------------ -->
+            <h4><a name="freetype">FreeType 2</a></h4>
+            <blockquote>
+                Version 2.3 or newer of FreeType is required for building the OpenJDK.
+                On Unix systems required files can be available as part of your
+                distribution (while you still may need to upgrade them).
+                Note that you need development version of package that 
+                includes both FreeType library and header files.
+                <p>
+                You can always download latest FreeType version from the
+                <a href="http://www.freetype.org" target="_blank">FreeType website</a>.
+                <p>
+                Makefiles will try to pick FreeType from /usr/lib and /usr/include.
+                In case it is installed elsewhere you will need to set environment
+                variables 
+                <tt><a href="#ALT_FREETYPE_LIB_PATH">ALT_FREETYPE_LIB_PATH</a></tt>
+                and 
+                <tt><a href="#ALT_FREETYPE_HEADERS_PATH">ALT_FREETYPE_HEADERS_PATH</a></tt>
+                to refer to place where library and header files are installed.
+            </blockquote>    
+            <!-- ------------------------------------------------------ -->
+            <h4><a name="alsa">Advanced Linux Sound Architecture (ALSA) (Linux only)</a></h4>
+            <blockquote>
+                <strong>Linux only:</strong>
+                Version 0.9.1 or newer of the ALSA files are
+                required for building the OpenJDK on Linux.
+                These Linux files are usually available from an "alsa"
+                of "libasound"
+                development package, it's highly recommended that you try and use
+                the package provided by the particular version of Linux that
+                you are using.
+                The makefiles will check this emit a sanity error if it is
+                missing or the wrong version.
+                <p>
+                In particular, older Linux systems will likely not have the
+                right version of ALSA installed, for example
+                Redhat AS 2.1 U2 and SuSE 8.1 do not include a sufficiently 
+                recent ALSA distribution.
+                On rpm-based systems, you can see if ALSA is installed by 
+                running this command:
+                <pre>
+                    <tt>rpm -qa | grep alsa</tt>
+                </pre>
+                Both <tt>alsa</tt> and <tt>alsa-devel</tt> packages are needed.
+                <p> 
+                If your distribution does not come with ALSA, and you can't
+                find ALSA packages built for your particular system,
+                you can try to install the pre-built ALSA rpm packages from
+                <a href="http://www.freshrpms.net/" target="_blank">
+                <tt>www.freshrpms.net</tt></a>. 
+                Note that installing a newer ALSA could
+                break sound output if an older version of ALSA was previously
+                installed on the system, but it will enable JDK compilation.
+                <blockquote>
+                    Installation: execute as root<br>
+                    [i586]: <code>rpm -Uv --force alsa-lib-devel-0.9.1-rh61.i386.rpm</code><br>
+                    [x64]: <code>rpm -Uv --force alsa-lib-devel-0.9.8-amd64.x86_64.rpm</code><br>
+                    Uninstallation:<br>
+                    [i586]: <code>rpm -ev alsa-lib-devel-0.9.1-rh61</code><br>
+                    [x64]:<code>rpm -ev alsa-lib-devel-0.9.8-amd64</code><br>
+                    Make sure that you do not link to the static library
+                    (<tt>libasound.a</tt>),
+                    by verifying that the dynamic library (<tt>libasound.so</tt>) is
+                    correctly installed in <tt>/usr/lib</tt>.
+                </blockquote>
+                As a last resort you can go to the
+                <a href="http://www.alsa-project.org" target="_blank">
+                Advanced Linux Sound Architecture Site</a> and build it from
+                source.
+                <blockquote>
+                    Download driver and library
+                    source tarballs from 
+                    <a href="http://www.alsa-project.org" target="_blank">ALSA's homepage</a>. 
+                    As root, execute the following
+                    commands (you may need to adapt the version number):
+                    <pre>
+                        <tt>
+                            $ tar xjf alsa-driver-0.9.1.tar.bz2
+                            $ cd alsa-driver-0.9.1
+                            $ ./configure
+                            $ make install
+                            $ cd ..
+                            $ tar xjf alsa-lib-0.9.1.tar.bz2
+                            $ cd alsa-lib-0.9.1
+                            $ ./configure
+                            $ make install
+                        </tt>
+                    </pre>
+                    Should one of the above steps fail, refer to the documentation on
+                    ALSA's home page.
+                </blockquote>
+                Note that this is a minimum install that enables
+                building the JDK platform. To actually use ALSA sound drivers, more
+                steps are necessary as outlined in the documentation on ALSA's homepage.
+                <p>
+                ALSA can be uninstalled by executing <tt>make uninstall</tt> first in
+                the <tt>alsa-lib-0.9.1</tt> directory and then in 
+                <tt>alsa-driver-0.9.1</tt>.
+            </blockquote>
+            There are no ALT* variables to change the assumed locations of ALSA,
+            the makefiles will expect to find the ALSA include files and library at:
+            <tt>/usr/include/alsa</tt> and <tt>/usr/lib/libasound.so</tt>.
         </blockquote>
-        
-    </blockquote>
-    
-    <h4><a name="cups">Common UNIX Printing System (CUPS) Headers (Solaris &amp; Linux)</a></h4>
-    
-    <blockquote>
-        <p>
-        <strong>Solaris:</strong>
-        CUPS header files are required for building the 
-        OpenJDK on Solaris.
-        The Solaris header files can be obtained by installing 
-        the package <strong>SFWcups</strong> from the Solaris Software
-        Companion CD/DVD, these often will be installed into 
-        <tt>/opt/sfw/cups</tt>.
-        <p>
-        <strong>Linux:</strong>
-        CUPS header files are required for building the 
-        OpenJDK on Linux.
-        The Linux header files are usually available from a "cups"
-        development package, it's recommended that you try and use
-        the package provided by the particular version of Linux that
-        you are using.
-        <p>
-        The CUPS header files can always be downloaded from 
-        <a href="http://www.cups.org">www.cups.org</a>.
-        The variable 
-        <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>
-        can be used to override the default location of the
-        CUPS Header files.
-    </blockquote>
-    
-    <h4><a name="freetype">FreeType 2</a></h4>
-
-    <blockquote>
-        <p>
-        Version 2.3 or newer of FreeType is required for building the OpenJDK.
-        On Unix systems required files can be available as part of your
-        distribution (while you still may need to upgrade them).
-        Note that you need development version of package that 
-        includes both FreeType library and header files.
-        </p>
-        <p>
-        You can always download latest FreeType version from the
-        <a href="http://www.freetype.org">FreeType website</a>.
-        </p>
-        <p>
-        Makefiles will try to pick FreeType from /usr/lib and /usr/include.
-        In case it is installed elsewhere you will need to set environment
-        variables 
-        <tt><a href="#ALT_FREETYPE_LIB_PATH">ALT_FREETYPE_LIB_PATH</a></tt>
-        and 
-        <tt><a href="#ALT_FREETYPE_HEADERS_PATH">ALT_FREETYPE_HEADERS_PATH</a></tt>
-        to refer to place where library and header files are installed.
-        </p>
-    </blockquote>    
-
-    <h4><a name="alsa">Advanced Linux Sound Architecture (ALSA) (Linux only)</a></h4>
-    
-    <blockquote>
-        <p>
-        <strong>Linux only:</strong>
-        Version 0.9.1 or newer of the ALSA files are
-        required for building the 
-        OpenJDK on Linux.
-        These Linux files are usually available from an "alsa"
-        of "libasound"
-        development package, it's recommended that you try and use
-        the package provided by the particular version of Linux that
-        you are using.
-        The makefiles will check this emit a sanity error if it is
-        missing or the wrong version.
-        As a last resort you can go to the
-        <a href="http://www.alsa-project.org" target="_blank">
-        Advanced Linux Sound Architecture Site</a>.
-    </blockquote>
-    
-    <h4>Windows Specific Dependencies</h4>
-    
-    <blockquote>
-        
-        <strong>Unix Command Tools (<a name="cygwin">CYGWIN</a>)</strong>
-        
-        <blockquote> 
-            <p>
-            The 
-            OpenJDK
-            requires access to a set of unix command tools
-            on Windows which can be supplied by 
-            <a href="http://www.cygwin.com">CYGWIN</a>. 
-            <p>
-            The 
-            OpenJDK 
-            build
-            requires CYGWIN version 1.5.12 or newer. 
-            Information about CYGWIN can
-            be obtained from the CYGWIN website at 
-            <a href="http://www.cygwin.com">www.cygwin.com</a>. 
-            <p>
-            By default CYGWIN doesn't install all the tools required for building
-            the OpenJDK.
-            Along with the default installation, you need to install
-            the following tools.
+        <!-- ------------------------------------------------------ -->
+        <h4>Windows Specific Dependencies</h4>
+        <blockquote>
+            <strong>Unix Command Tools (<a name="cygwin">CYGWIN</a>)</strong>
+            <blockquote> 
+                The OpenJDK requires access to a set of unix command tools
+                on Windows which can be supplied by 
+                <a href="http://www.cygwin.com" target="_blank">CYGWIN</a>. 
+                <p>
+                The OpenJDK build requires CYGWIN version 1.5.12 or newer. 
+                Information about CYGWIN can
+                be obtained from the CYGWIN website at 
+                <a href="http://www.cygwin.com" target="_blank">www.cygwin.com</a>. 
+                <p>
+                By default CYGWIN doesn't install all the tools required for building
+                the OpenJDK.
+                Along with the default installation, you need to install
+                the following tools.
+                <blockquote>
+                    <table border="1">
+                        <thead>
+                            <tr>
+                                <td>Binary Name</td>
+                                <td>Package</td>
+                                <td>Description</td>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            <tr>
+                                <td>ar.exe</td>
+                                <td>Devel</td>
+                                <td>binutils: The GNU assembler, linker and binary
+                                utilities</td>
+                            </tr>
+                            <tr>
+                                <td>make.exe</td>
+                                <td>Devel</td>
+                                <td>make: The GNU version of the 'make' utility</td>
+                            </tr>
+                            <tr>
+                                <td>m4.exe</td>
+                                <td>Interpreters</td>
+                                <td>m4: GNU implementation of the traditional Unix macro
+                                processor</td>
+                            </tr>
+                            <tr>
+                                <td>cpio.exe</td>
+                                <td>Utils</td>
+                                <td>cpio: A program to manage archives of files</td>
+                            </tr>
+                            <tr>
+                                <td>awk.exe</td>
+                                <td>Utils</td>
+                                <td>awk: Pattern-directed scanning and processing language</td>
+                            </tr>
+                            <tr>
+                                <td>file.exe</td>
+                                <td>Utils</td>
+                                <td>file: Determines file type using 'magic' numbers</td>
+                            </tr>
+                            <tr>
+                                <td>zip.exe</td>
+                                <td>Utils</td>
+                                <td>zip: Package and compress (archive) files</td>
+                            </tr>
+                            <tr>
+                                <td>unzip.exe</td>
+                                <td>Utils</td>
+                                <td>unzip: Extract compressed files in a ZIP archive</td>
+                            </tr>
+                            <tr>
+                                <td>free.exe</td>
+                                <td>Utils</td>
+                                <td>free: Display amount of free and used memory in the system</td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </blockquote>
+                <p>
+                Note that the CYGWIN software can conflict with other non-CYGWIN
+                software on your Windows system.
+                CYGWIN provides a
+                <a href="http://cygwin.com/faq/faq.using.html" target="_blank">FAQ</a> for
+                known issues and problems, of particular interest is the
+                section on
+                <a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank">
+                BLODA (applications that interfere with CYGWIN)</a>.
+            </blockquote>
+            <strong><a name="dxsdk">Microsoft DirectX 9.0 SDK header files and libraries</a></strong>
             <blockquote>
-                <table border="1">
-                    <thead>
-                        <tr>
-                            <td>Binary Name</td>
-                            <td>Package</td>
-                            <td>Description</td>
-                        </tr>
-                    </thead>
-                    <tbody>
-                        <tr>
-                            <td>ar.exe</td>
-                            <td>Devel</td>
-                            <td>binutils: The GNU assembler, linker and binary
-                            utilities</td>
-                        </tr>
-                        <tr>
-                            <td>make.exe</td>
-                            <td>Devel</td>
-                            <td>make: The GNU version of the 'make' utility</td>
-                        </tr>
-                        <tr>
-                            <td>m4.exe</td>
-                            <td>Interpreters</td>
-                            <td>m4: GNU implementation of the traditional Unix macro
-                            processor</td>
-                        </tr>
-                        <tr>
-                            <td>cpio.exe</td>
-                            <td>Utils</td>
-                            <td>cpio: A program to manage archives of files</td>
-                        </tr>
-                        <tr>
-                            <td>file.exe</td>
-                            <td>Utils</td>
-                            <td>file: Determines file type using 'magic' numbers</td>
-                        </tr>
-                    </tbody>
-                </table>
+                Microsoft DirectX 9.0 SDK (Summer 2004)
+                headers are required for building
+                OpenJDK.
+                This SDK can be downloaded from 
+                <a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=FD044A42-9912-42A3-9A9E-D857199F888E&amp;displaylang=en" target="_blank">
+                Microsoft DirectX 9.0 SDK (Summer 2004)</a>.
+                If the link above becomes obsolete, the SDK can be found from 
+                <a href="http://download.microsoft.com" target="_blank">the Microsoft Download Site</a>
+                (search with "DirectX 9.0 SDK Update Summer 2004"). 
+                The location of this SDK can be set with 
+                <tt><a href="#ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt>
+                but it's normally found via the DirectX environment variable
+                <tt>DXSDK_DIR</tt>.
+            </blockquote>
+            <strong><a name="msvcrt"><tt>MSVCRT.DLL</tt></a></strong>
+            <blockquote> 
+                <strong>i586 only:</strong>
+                The OpenJDK 32bit build requires access to
+                <tt>MSVCRT.DLL</tt> version 6.00.8337.0 or newer.
+                If the <tt>MSVCRT.DLL</tt> is not installed in 
+                the system32 directory set the 
+                <a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a>
+                variable to the location.
+                <p> 
+                <strong>X64 only:</strong>
+                The OpenJDK 64bit build requires access to
+                <tt>MSVCRT.DLL</tt> version 7.0.3790.0 or newer, which is
+                usually supplied by the
+                <a href="#mssdk">Platform SDK</a>.
+                If it is not available from the Platform SDK,
+                set the 
+                <a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a>
+                variable to the location.
+            </blockquote>
+            <strong><tt><a name="msvcr71">MSVCR71.DLL</a></tt></strong>
+            <blockquote>
+                <strong>i586 only:</strong>
+                The 
+                OpenJDK
+                build requires access to 
+                MSVCR71.DLL version 7.10.3052.4 or newer which should be
+                supplied by the
+                <a href="#msvc">Visual Studio product</a>
+                If the <tt>MSVCR71.DLL</tt> is not available from the
+                Visual Studio product
+                set the 
+                <a href="#ALT_MSVCR71_DLL_PATH"><tt>ALT_MSVCR71_DLL_PATH</tt></a>
+                variable to the location.
             </blockquote>
         </blockquote>
-        
-        <a name="dxsdk">
-            <strong>Microsoft DirectX 9.0 SDK header files and libraries</strong>
-        </a>
-        
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="creating">Creating the Build</a></h2>
         <blockquote>
-            <p>
-            Microsoft DirectX 9.0 SDK (Summer 2004)
-            headers are required for building
-            OpenJDK.
-            This SDK can be downloaded from 
-            <a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=FD044A42-9912-42A3-9A9E-D857199F888E&amp;displaylang=en">
-            Microsoft DirectX 9.0 SDK (Summer 2004)</a>.
-            If the link above becomes obsolete, the SDK can be found from 
-            <a href="http://download.microsoft.com">the Microsoft Download Site</a>
-            (search with "DirectX 9.0 SDK Update Summer 2004"). 
-            The location of this SDK can be set with 
-            <tt><a href="#ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt>
-            but it's normally found via the DirectX environment variable
-            <tt>DXSDK_DIR</tt>.
-        </blockquote>
-        
-        <a name="msvcrt">
-            <strong><tt>MSVCRT.DLL</tt></strong>
-        </a>
-        
-        <blockquote> 
+            Once a machine is setup to build the OpenJDK,
+            the steps to create the build are fairly simple.
+            The various ALT settings can either be made into  variables
+            or can be supplied on the 
+            <a href="#gmake"><tt><i>gmake</i></tt></a> 
+            command.
+            <ol>
+                <li>Use the sanity rule to double check all the ALT settings:
+                    <blockquote>
+                        <tt>
+                            <i>gmake</i> 
+                            sanity
+                            [ARCH_DATA_MODEL=<i>32 or 64</i>]
+                            [other "ALT_" overrides]
+                        </tt>
+                    </blockquote>
+                </li>
+                <li>Start the build with the command:
+                    <blockquote>
+                        <tt>
+                            <i>gmake</i> 
+                            [ARCH_DATA_MODEL=<i>32 or 64</i>]
+                            [ALT_OUTPUTDIR=<i>output_directory</i>] 
+                            [other "ALT_" overrides] 
+                        </tt>
+                    </blockquote>
+                </li>
+            </ol>
             <p>
-            <strong>i586 only:</strong>
-            The 
-            OpenJDK
-            32bit build requires
-            access to <tt>MSVCRT.DLL</tt> 
-            version 6.00.8337.0 or newer.
-            If the <tt>MSVCRT.DLL</tt> is not installed in 
-            the system32 directory set the 
-            <a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a>
-            variable to the location.
-            <p> 
-            <strong>X64 only:</strong>
-            The OpenJDK 64bit build requires access to
-            <tt>MSVCRT.DLL</tt> version 7.0.3790.0 or newer, which is
-            usually supplied by the
-            <a href="#mssdk">Platform SDK</a>.
-            If it is not available from the Platform SDK,
-            set the 
-            <a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a>
-            variable to the location.
+            <strong>Solaris:</strong>
+            Note that ARCH_DATA_MODEL is really only needed on Solaris to
+            indicate you want to built the 64-bit version.
+            And before the Solaris 64-bit binaries can be used, they
+            must be merged with the binaries from a separate 32-bit build. 
+            The merged binaries may then be used in either 32-bit or 64-bit mode, with
+            the selection occurring at runtime 
+            with the <tt>-d32</tt> or <tt>-d64</tt> options. 
         </blockquote>
-        
-        <a name="msvcr71">
-            <strong><tt>MSVCR71.DLL</tt></strong>
-        </a>
-        
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="testing">Testing the Build</a></h2>
         <blockquote>
+            When the build is completed, you should see the generated
+            binaries and associated files in the <tt>j2sdk-image</tt> 
+            directory in the output directory. 
+            The default output directory is
+            <tt>build/<i>platform</i></tt>,
+            where <tt><i>platform</i></tt> is one of
+            <tt><ul>
+                    <li>solaris-sparc</li>
+                    <li>solaris-sparcv9</li>
+                    <li>solaris-i586</li>
+                    <li>solaris-amd64</li>
+                    <li>linux-i586</li>
+                    <li>linux-amd64</li>
+                    <li>windows-i586</li>
+                    <li>windows-amd64</li>
+            </ul></tt>
+            In particular, the 
+            <tt>build/<i>platform</i>/j2sdk-image/bin</tt>
+            directory should contain executables for the 
+            OpenJDK tools and utilities.
             <p>
-            <strong>i586 only:</strong>
-            The 
-            OpenJDK
-            build requires access to 
-            MSVCR71.DLL version 7.10.3052.4 or newer which should be
-            supplied by the
-            <a href="#msvc">Visual Studio product</a>
-            If the <tt>MSVCR71.DLL</tt> is not available from the
-            Visual Studio product
-            set the 
-            <a href="#ALT_MSVCR71_DLL_PATH"><tt>ALT_MSVCR71_DLL_PATH</tt></a>
-            variable to the location.
+            You can test that the build completed properly by using the build
+            to run the various demos that you will find in the 
+            <tt>build/<i>platform</i>/j2sdk-image/demo</tt>
+            directory.
+            <p>
+            The provided regression tests can be run with the <tt>jtreg</tt>
+            utility from 
+            <a href="http://openjdk.java.net/jtreg/" target="_blank">the jtreg site</a>.
         </blockquote>
-        
-    </blockquote>
-    
-    
-</blockquote>
-
-
-<hr noshade="noshade" size="3">
-
-<h2><a name="creating">Creating the Build</a></h2>
-
-<blockquote>
-    <p>
-    Once a machine is setup to build the 
-    OpenJDK,
-    the steps to create the
-    build are fairly simple.
-    The various ALT settings can either be made into  variables
-    or can be supplied on the 
-    <a href="#gmake"><tt><i>gmake</i></tt></a> 
-    command.
-    <p>
-    <ol>
-        <li>Use the sanity rule to double check all the ALT settings:
-            <blockquote>
-                <tt>
-                    <i>gmake</i> 
-                    sanity
-                    [ARCH_DATA_MODEL=<i>32 or 64</i>]
-                    [other "ALT_" overrides]
-                </tt>
-            </blockquote>
-        </li>
-        <li>Start the build with the command:
-            <blockquote>
-                <tt>
-                    <i>gmake</i> 
-                    [ARCH_DATA_MODEL=<i>32 or 64</i>]
-                    [ALT_OUTPUTDIR=<i>output_directory</i>] 
-                    [other "ALT_" overrides] 
-                </tt>
-            </blockquote>
-        </li>
-    </ol>
-    <p>
-    <strong>Solaris:</strong>
-    Note that ARCH_DATA_MODEL is really only needed on Solaris to
-    indicate you want to built the 64-bit version.
-    And before the Solaris 64-bit binaries can be used, they
-    must be merged with the binaries from a separate 32-bit build. 
-    The merged binaries may then be used in either 32-bit or 64-bit mode, with
-    the selection occurring at runtime 
-    with the <tt>-d32</tt> or <tt>-d64</tt> options. 
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h2><a name="testing">Testing the Build</a></h2>
-
-<blockquote>
-    <p>
-    When the build is completed, you should see the generated
-    binaries and associated files in the <tt>j2sdk-image</tt> 
-    directory in the output directory. 
-    The default output directory is
-    <tt>build/<i>platform</i></tt>,
-    where <tt><i>platform</i></tt> is one of
-    <tt><ul>
-            <li>solaris-sparc</li>
-            <li>solaris-sparcv9</li>
-            <li>solaris-i586</li>
-            <li>solaris-amd64</li>
-            <li>linux-i586</li>
-            <li>linux-amd64</li>
-            <li>windows-i586</li>
-            <li>windows-amd64</li>
-    </ul></tt>
-    In particular, the 
-    <tt>build/<i>platform</i>/j2sdk-image/bin</tt>
-    directory should contain executables for the 
-    OpenJDK
-    tools and utilities.
-    <p>
-    You can test that the build completed properly by using the build
-    to run the various demos that you will find in the 
-    <tt>build/<i>platform</i>/j2sdk-image/demo</tt>
-    directory.
-    <p>
-    The provided regression tests can be run with the <tt>jtreg</tt>
-    utility from 
-    <a href="http://openjdk.java.net/jtreg/">the jtreg site</a>.
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h2><a name="variables">Environment/Make Variables</a></h2>
-
-<p>
-Some of the
-environment or make variables (just called <b>variables</b> in this
-document) that can impact the build are:
-
-<blockquote>
-    
-    <dl>
-        
-        <dt><a name="path"><tt>PATH</tt></a> </dt>
-        <dd>Typically you want to set the <tt>PATH</tt> to include:
-            <ul>
-                <li>The location of the GNU make binary</li>
-                <li>The location of the JDK 6 <tt>java</tt> 
-                (see <a href="#bootjdk">Bootstrap JDK</a>)</li>
-                <li>The location of the C/C++ compilers 
-                (see <a href="#compilers"><tt>compilers</tt></a>)</li>
-                <li>The location or locations for the Unix command utilities
-                (e.g. <tt>/usr/bin</tt>)</li>
-            </ul>
-        </dd>
-        
-        <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt>
-        <dd>The <tt>ARCH_DATA_MODEL</tt> variable
-            is used to specify whether the build is to generate 32-bit or 64-bit
-            binaries. 
-            The Solaris build supports either 32-bit or 64-bit builds, but
-            Windows and Linux will support only one, depending on the specific
-            OS being used.
-            Normally, setting this variable is only necessary on Solaris.
-            Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries, 
-            or to <tt>64</tt> for generating 64-bit binaries.
-        </dd>
-        
-        <dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt>
-        <dd>
-            The location of the bootstrap JDK installation. 
-            See <a href="#bootjdk">Bootstrap JDK</a> for more information.
-            You should always install your own local Bootstrap JDK and
-            always set <tt>ALT_BOOTDIR</tt> explicitly.
-        </dd>
-        
-        <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt>
-        <dd>
-            An override for specifying the (absolute) path of where the
-            build output is to go.
-            The default output directory will be build/<i>platform</i>.
-        </dd>
-        
-        <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt>
-        <dd>
-            The location of the C/C++ compiler.
-            The default varies depending on the platform. 
-        </dd>
-        
-        <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt>
-        <dd>
-            The location of the <a href="#cacerts">cacerts</a> file.
-            The default will refer to 
-            <tt>jdk/src/share/lib/security/cacerts</tt>.
-        </dd>
-        
-        <dt><a name="ALT_BINARY_PLUGS_PATH"><tt>ALT_BINARY_PLUGS_PATH</tt></a></dt>
-        <dd>
-            The location of the binary plugs installation.
-            See <a href="#binaryplugs">Binary Plugs</a> for more information.
-            You should always have a local copy of a
-            recent Binary Plugs install image
-            and set this variable to that location.
-        </dd>
-        
-        <dt><a name="ALT_CUPS_HEADERS_PATH"><tt>ALT_CUPS_HEADERS_PATH</tt></a> </dt>
-        <dd>
-            The location of the CUPS header files.
-            See <a href="#cups">CUPS information</a> for more information.
-            If this path does not exist the fallback path is 
-            <tt>/usr/include</tt>.
-        </dd>
-        
-        
-        <dt><a name="ALT_FREETYPE_LIB_PATH"><tt>ALT_FREETYPE_LIB_PATH</tt></a></dt>
-        <dd>
-            The location of the FreeType shared library. 
-            See <a href="#freetype">FreeType information</a> for details. 
-        </dd>
-        
-        <dt><a name="ALT_FREETYPE_HEADERS_PATH"><tt>ALT_FREETYPE_HEADERS_PATH</tt></a></dt>
-        <dd>
-            The location of the FreeType header files.
-            See <a href="#freetype">FreeType information</a> for details. 
-        </dd>
-        
-        <dt><strong>Windows specific:</strong></dt>
-        <dd>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="variables">Environment/Make Variables</a></h2>
+        <p>
+        Some of the
+        environment or make variables (just called <b>variables</b> in this
+        document) that can impact the build are:
+        <blockquote>
             <dl>
-                <dt><a name="ALT_MSDEVTOOLS_PATH"><tt>ALT_MSDEVTOOLS_PATH</tt></a> </dt>
+                <dt><a name="path"><tt>PATH</tt></a> </dt>
+                <dd>Typically you want to set the <tt>PATH</tt> to include:
+                    <ul>
+                        <li>The location of the GNU make binary</li>
+                        <li>The location of the Bootstrap JDK <tt>java</tt> 
+                        (see <a href="#bootjdk">Bootstrap JDK</a>)</li>
+                        <li>The location of the C/C++ compilers 
+                        (see <a href="#compilers"><tt>compilers</tt></a>)</li>
+                        <li>The location or locations for the Unix command utilities
+                        (e.g. <tt>/usr/bin</tt>)</li>
+                    </ul>
+                </dd>
+                <dt><tt>MILESTONE</tt> </dt>
+                <dd>
+                    The milestone name for the build (<i>e.g.</i>"beta"). 
+                    The default value is "internal".
+                </dd>
+                <dt><tt>BUILD_NUMBER</tt> </dt>
+                <dd>
+                    The build number for the build (<i>e.g.</i> "b27"). 
+                    The default value is "b00".
+                </dd>
+                <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt>
+                <dd>The <tt>ARCH_DATA_MODEL</tt> variable
+                    is used to specify whether the build is to generate 32-bit or 64-bit
+                    binaries. 
+                    The Solaris build supports either 32-bit or 64-bit builds, but
+                    Windows and Linux will support only one, depending on the specific
+                    OS being used.
+                    Normally, setting this variable is only necessary on Solaris.
+                    Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries, 
+                    or to <tt>64</tt> for generating 64-bit binaries.
+                </dd>
+                <dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt>
+                <dd>
+                    The location of the bootstrap JDK installation. 
+                    See <a href="#bootjdk">Bootstrap JDK</a> for more information.
+                    You should always install your own local Bootstrap JDK and
+                    always set <tt>ALT_BOOTDIR</tt> explicitly.
+                </dd>
+                <dt><a name="ALT_BINARY_PLUGS_PATH"><tt>ALT_BINARY_PLUGS_PATH</tt></a></dt>
                 <dd>
-                    The location of the Microsoft Visual Studio .NET 2003
-                    tools 'bin' directory.
-                    The default is usually derived from
-                    <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
+                    The location of the binary plugs installation.
+                    See <a href="#binaryplugs">Binary Plugs</a> for more information.
+                    You should always have a local copy of a
+                    recent Binary Plugs install image
+                    and set this variable to that location.
+                </dd>
+                <dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt>
+                <dd>
+                    The location of a previously built JDK installation. 
+                    See <a href="#importjdk">Optional Import JDK</a> for more information.
+                </dd>
+                <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt>
+                <dd>
+                    An override for specifying the (absolute) path of where the
+                    build output is to go.
+                    The default output directory will be build/<i>platform</i>.
+                </dd>
+                <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt>
+                <dd>
+                    The location of the C/C++ compiler.
+                    The default varies depending on the platform. 
                 </dd>
-                
-                <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt>
+                <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt>
+                <dd>
+                    The location of the <a href="#cacerts">cacerts</a> file.
+                    The default will refer to 
+                    <tt>jdk/src/share/lib/security/cacerts</tt>.
+                </dd>
+                <dt><a name="ALT_CUPS_HEADERS_PATH"><tt>ALT_CUPS_HEADERS_PATH</tt></a> </dt>
+                <dd>
+                    The location of the CUPS header files.
+                    See <a href="#cups">CUPS information</a> for more information.
+                    If this path does not exist the fallback path is 
+                    <tt>/usr/include</tt>.
+                </dd>
+                <dt><a name="ALT_FREETYPE_LIB_PATH"><tt>ALT_FREETYPE_LIB_PATH</tt></a></dt>
+                <dd>
+                    The location of the FreeType shared library. 
+                    See <a href="#freetype">FreeType information</a> for details. 
+                </dd>
+                <dt><a name="ALT_FREETYPE_HEADERS_PATH"><tt>ALT_FREETYPE_HEADERS_PATH</tt></a></dt>
+                <dd>
+                    The location of the FreeType header files.
+                    See <a href="#freetype">FreeType information</a> for details. 
+                </dd>
+                <dt><a name="ALT_JDK_DEVTOOLS_PATH"><tt>ALT_JDK_DEVTOOLS_PATH</tt></a></dt>
+                <dd>
+                    The default root location of the devtools.
+                    The default value is 
+                    <tt>$(ALT_SLASH_JAVA)/devtools</tt>.
+                </dd>
+                <dt><tt><a name="ALT_DEVTOOLS_PATH">ALT_DEVTOOLS_PATH</a></tt> </dt>
                 <dd>
-                    The location of the 
-                    <a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
-                    The default will be to try and use the DirectX environment
-                    variable <tt>DXSDK_DIR</tt>,
-                    failing that, look in <tt>C:/DXSDK</tt>.
+                    The location of tools like the 
+                    <a href="#zip"><tt>zip</tt> and <tt>unzip</tt></a>
+                    binaries, but might also contain the GNU make utility
+                    (<tt><i>gmake</i></tt>).
+                    So this area is a bit of a grab bag, especially on Windows.
+                    The default value depends on the platform and
+                    Unix Commands being used.
+                    On Linux the default will be 
+                    <tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>, 
+                    on Solaris
+                    <tt>$(ALT_JDK_DEVTOOLS_PATH)/<i>{sparc,i386}</i>/bin</tt>, 
+                    on Windows with MKS
+                    <tt>%SYSTEMDRIVE%/UTILS</tt>, 
+                    and on Windows with CYGWIN
+                    <tt>/usr/bin</tt>.
                 </dd>
-                
-                <dt><tt><a name="ALT_MSVCRT_DLL_PATH">ALT_MSVCRT_DLL_PATH</a></tt> </dt>
+                <dt><a name="ALT_UNIXCOMMAND_PATH"><tt>ALT_UNIXCOMMAND_PATH</tt></a> </dt>
+                <dd>
+                    An override for specifying where the
+                    Unix command set are located. 
+                    The default location varies depending on the platform,
+                    <tt>"%SYSTEMDRIVE%/MKSNT"</tt> or
+                    <tt>$(ROOTDIR)</tt> on Windows with MKS, otherwise it's 
+                    <tt>"/bin"</tt> or <tt>/usr/bin</tt>.
+                </dd>
+                <dt><a name="ALT_UNIXCCS_PATH"><tt>ALT_UNIXCCS_PATH</tt></a></dt>
+                <dd>
+                    <strong>Solaris only:</strong>
+                    An override for specifying where the Unix CCS
+                    command set are located.
+                    The default location is <tt>/usr/ccs/bin</tt> 
+                </dd>
+                <dt><a name="ALT_USRBIN_PATH"><tt>ALT_USRBIN_PATH</tt></a></dt>
+                <dd>
+                    An override for specifying where the
+                    Unix <tt>/usr/bin</tt> commands are located. You usually do not need
+                    to set this variable: the default location is <tt>/usr/bin</tt>)
+                </dd>
+                <dt><a name="ALT_SLASHJAVA"><tt>ALT_SLASHJAVA</tt></a></dt>
+                <dd>
+                    The default root location for many of the ALT path locations
+                    of the following ALT variables.
+                    The default value is 
+                    <tt>"/java"</tt> on Solaris and Linux, 
+                    <tt>"J:"</tt> on Windows.
+                </dd>
+                <dt><a name="ALT_BUILD_JDK_IMPORT_PATH"><tt>ALT_BUILD_JDK_IMPORT_PATH</tt></a></dt>
                 <dd>
-                    The location of the 
-                    <a href="#msvcrt"><tt>MSVCRT.DLL</tt></a>. 
+                    These are useful in managing builds on multiple platforms.
+                    The default network location for all of the import JDK images
+                    for all platforms. 
+                    If <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
+                    is not set, this directory will be used and should contain 
+                    the following directories:
+                    <tt>solaris-sparc</tt>,
+                    <tt>solaris-i586</tt>,
+                    <tt>solaris-sparcv9</tt>,
+                    <tt>solaris-amd64</tt>,
+                    <tt>linux-i586</tt>,
+                    <tt>linux-amd64</tt>,
+                    <tt>windows-i586</tt>,
+                    and
+                    <tt>windows-amd64</tt>.
+                    Where each of these directories contain the import JDK image
+                    for that platform.
                 </dd>
-                
-                <dt><tt><a name="ALT_MSVCR71_DLL_PATH">ALT_MSVCR71_DLL_PATH</a></tt> </dt>
+                <dt><a name="ALT_BUILD_BINARY_PLUGS_PATH"><tt>ALT_BUILD_BINARY_PLUGS_PATH</tt></a></dt>
+                <dd>
+                    These are useful in managing builds on multiple platforms.
+                    The default network location for all of the binary plug images
+                    for all platforms. 
+                    If <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
+                    is not set, this directory will be used and should contain 
+                    the following directories:
+                    <tt>solaris-sparc</tt>,
+                    <tt>solaris-i586</tt>,
+                    <tt>solaris-sparcv9</tt>,
+                    <tt>solaris-amd64</tt>,
+                    <tt>linux-i586</tt>,
+                    <tt>linux-amd64</tt>,
+                    <tt>windows-i586</tt>,
+                    and
+                    <tt>windows-amd64</tt>.
+                    Where each of these directories contain the binary plugs image
+                    for that platform.
+                </dd>
+                <dt><strong>Windows specific:</strong></dt>
                 <dd>
-                    <strong>i586 only:</strong>
-                    The location of the 
-                    <a href="#msvcr71"><tt>MSVCR71.DLL</tt></a>. 
+                    <dl>
+                        <dt><a name="ALT_MSDEVTOOLS_PATH"><tt>ALT_MSDEVTOOLS_PATH</tt></a> </dt>
+                        <dd>
+                            The location of the Microsoft Visual Studio .NET 2003
+                            tools 'bin' directory.
+                            The default is usually derived from
+                            <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
+                        </dd>
+                        <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt>
+                        <dd>
+                            The location of the 
+                            <a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
+                            The default will be to try and use the DirectX environment
+                            variable <tt>DXSDK_DIR</tt>,
+                            failing that, look in <tt>C:/DXSDK</tt>.
+                        </dd>
+                        <dt><tt><a name="ALT_MSVCRT_DLL_PATH">ALT_MSVCRT_DLL_PATH</a></tt> </dt>
+                        <dd>
+                            The location of the 
+                            <a href="#msvcrt"><tt>MSVCRT.DLL</tt></a>. 
+                        </dd>
+                        <dt><tt><a name="ALT_MSVCR71_DLL_PATH">ALT_MSVCR71_DLL_PATH</a></tt> </dt>
+                        <dd>
+                            <strong>i586 only:</strong>
+                            The location of the 
+                            <a href="#msvcr71"><tt>MSVCR71.DLL</tt></a>. 
+                        </dd>
+                    </dl>
                 </dd>
             </dl>
-        </dd>
-        
-    </dl>
-</blockquote>
-
-<!-- ------------------------------------------------------ -->
-<hr noshade="noshade" size="3">
-
-<h2><a name="troubleshooting">Troubleshooting</a></h2>
-
-<blockquote>
-    <p>
-    A build can fail for any number of reasons. 
-    Most failures
-    are a result of trying to build in an environment in which all the
-    pre-build requirements have not been met. 
-    The first step in
-    troubleshooting a build failure is to recheck that you have satisfied
-    all the pre-build requirements for your platform.
-    Look for the check list of the platform you are building on in the
-    <a href="#contents">Table of Contents</a>.
-    
-    <p>
-    You can validate your build environment by using the <tt>sanity</tt>
-    target.
-    Any errors listed
-    will stop the build from starting, and any warnings may result in
-    a flawed product build.
-    We strongly encourage you to evaluate every
-    sanity check warning and fix it if required, before you proceed
-    further with your build.
-    
-    <p>
-    Some of the more common problems with builds are briefly described
-    below, with suggestions for remedies.
-    
-    <ul>
-        <li>
-            <b>Slow Builds:</b>
-            <blockquote>
-                <p>
-                If your build machine seems to be overloaded from too many
-                simultaneous C++ compiles, try setting the <tt>HOTSPOT_BUILD_JOBS</tt>
-                variable to <tt>1</tt> (if you're using a multiple CPU
-                machine, setting it to more than the the number of CPUs is probably
-                not a good idea).
-                <p>
-                Creating the javadocs can be very slow, if you are running
-                javadoc, consider skipping that step.
-                <p>
-                Faster hardware and more RAM always helps too.
-                The VM build tends to be CPU intensive (many C++ compiles),
-                and the rest of the JDK will often be disk intensive.
-                <p>
-                Faster compiles are possible using a tool called
-                <a href="http://ccache.samba.org/">ccache</a>.
-            </blockquote>
-        </li>
-        <li>
-            <b>File time issues:</b>
-            <blockquote>
-                <p>
-                If you see warnings that refer to file time stamps, e.g.
-                <blockquote>
-                    <i>Warning message:</i><tt> File `xxx' has modification time in
-                    the future.</tt>
-                    <br>
-                    <i>Warning message:</i> <tt> Clock skew detected. Your build may
-                    be incomplete.</tt> 
-                </blockquote>
-                <p>
-                These warnings can occur when the clock on the build machine is out of
-                sync with the timestamps on the source files. Other errors, apparently
-                unrelated but in fact caused by the clock skew, can occur along with
-                the clock skew warnings. These secondary errors may tend to obscure the
-                fact that the true root cause of the problem is an out-of-sync clock.
-                For example, an out-of-sync clock has been known to cause an old
-                version of javac to be used to compile some files, resulting in errors
-                when the pre-1.4 compiler ran across the new <tt>assert</tt> keyword
-                in the 1.4 source code.
-                <p>
-                If you see these warnings, reset the clock on the build
-                machine, run "<tt><i>gmake</i> clobber</tt>" or delete the directory
-                containing the build output, and restart the build from the beginning.
-            </blockquote>
-        </li>
-        <li>
-            <b>Error message: <tt>Trouble writing out table to disk</tt></b>
-            <blockquote>
-                <p>
-                Increase the amount of swap space on your build machine.
-            </blockquote>
-        </li>
-        <li>
-            <b>Error Message: <tt>libstdc++ not found:</tt></b>
-            <blockquote>
-                This is caused by a missing libstdc++.a library.
-                This is installed as part of a specific package
-                (e.g. libstdc++.so.devel.386).
-                By default some 64bit Linux versions (e.g. Fedora)
-                only install the 64bit version of the libstdc++ package.
-                Various parts of the JDK build require a static
-                link of the C++ runtime libraries to allow for maximum
-                portability of the built images.
-            </blockquote>
-        </li>
-        <li>
-            <b>Error Message: <tt>cannot restore segment prot after reloc</tt></b>
-            <blockquote>
-                This is probably an issue with SELinux (See
-                <a href="http://en.wikipedia.org/wiki/SELinux">http://en.wikipedia.org/wiki/SELinux</a>).
-                Parts of the VM is built without the <tt>-fPIC</tt> for
-                performance reasons.
-                <p>
-                To completely disable SELinux:
-                <ol><tt>
-                    
-                    <li>$ su root</li>
-                    <li># system-config-securitylevel</li>
-                    <li>In the window that appears, select the SELinux tab</li>
-                    <li>Disable SELinux</li>
-                </ol></tt>
-                <p>
-                Alternatively, instead of completely disabling it you could
-                disable just this one check.
-                <ol><tt>
-                    <li>Select System->Administration->SELinux Management</li>
-                    <li>In the SELinux Management Tool which appears, 
-                    select "Boolean" from the menu on the left</li>
-                    <li>Expand the "Memory Protection" group</li>
-                    <li>Check the first item, labeled
-                    "Allow all unconfined executables to use libraries requiring text relocation ..."</li>
-                </ol></tt>
-            </blockquote>
-        </li>
-    </ul>
-</blockquote>
-
-<hr noshade="noshade" size="3">
+        </blockquote>
+        <!-- ------------------------------------------------------ -->
+        <hr>
+        <h2><a name="troubleshooting">Troubleshooting</a></h2>
+        <blockquote>
+            A build can fail for any number of reasons. 
+            Most failures
+            are a result of trying to build in an environment in which all the
+            pre-build requirements have not been met. 
+            The first step in
+            troubleshooting a build failure is to recheck that you have satisfied
+            all the pre-build requirements for your platform.
+            Look for the check list of the platform you are building on in the
+            <a href="#contents">Table of Contents</a>.
+            <p>
+            You can validate your build environment by using the <tt>sanity</tt>
+            target.
+            Any errors listed
+            will stop the build from starting, and any warnings may result in
+            a flawed product build.
+            We strongly encourage you to evaluate every
+            sanity check warning and fix it if required, before you proceed
+            further with your build.
+            <p>
+            Some of the more common problems with builds are briefly described
+            below, with suggestions for remedies.
+            <ul>
+                <li>
+                    <b>Slow Builds:</b>
+                    <blockquote>
+                        If your build machine seems to be overloaded from too many
+                        simultaneous C++ compiles, try setting the <tt>HOTSPOT_BUILD_JOBS</tt>
+                        variable to <tt>1</tt> (if you're using a multiple CPU
+                        machine, setting it to more than the the number of CPUs is probably
+                        not a good idea).
+                        <p>
+                        Creating the javadocs can be very slow, if you are running
+                        javadoc, consider skipping that step.
+                        <p>
+                        Faster hardware and more RAM always helps too.
+                        The VM build tends to be CPU intensive (many C++ compiles),
+                        and the rest of the JDK will often be disk intensive.
+                        <p>
+                        Faster compiles are possible using a tool called
+                        <a href="http://ccache.samba.org/" target="_blank">ccache</a>.
+                    </blockquote>
+                </li>
+                <li>
+                    <b>File time issues:</b>
+                    <blockquote>
+                        If you see warnings that refer to file time stamps, e.g.
+                        <blockquote>
+                            <i>Warning message:</i><tt> File `xxx' has modification time in
+                            the future.</tt>
+                            <br>
+                            <i>Warning message:</i> <tt> Clock skew detected. Your build may
+                            be incomplete.</tt> 
+                        </blockquote>
+                        These warnings can occur when the clock on the build machine is out of
+                        sync with the timestamps on the source files. Other errors, apparently
+                        unrelated but in fact caused by the clock skew, can occur along with
+                        the clock skew warnings. These secondary errors may tend to obscure the
+                        fact that the true root cause of the problem is an out-of-sync clock.
+                        For example, an out-of-sync clock has been known to cause an old
+                        version of javac to be used to compile some files, resulting in errors
+                        when the pre-1.4 compiler ran across the new <tt>assert</tt> keyword
+                        in the 1.4 source code.
+                        <p>
+                        If you see these warnings, reset the clock on the build
+                        machine, run "<tt><i>gmake</i> clobber</tt>" or delete the directory
+                        containing the build output, and restart the build from the beginning.
+                    </blockquote>
+                </li>
+                <li>
+                    <b>Error message: <tt>Trouble writing out table to disk</tt></b>
+                    <blockquote>
+                        Increase the amount of swap space on your build machine.
+                    </blockquote>
+                </li>
+                <li>
+                    <b>Error Message: <tt>libstdc++ not found:</tt></b>
+                    <blockquote>
+                        This is caused by a missing libstdc++.a library.
+                        This is installed as part of a specific package
+                        (e.g. libstdc++.so.devel.386).
+                        By default some 64bit Linux versions (e.g. Fedora)
+                        only install the 64bit version of the libstdc++ package.
+                        Various parts of the JDK build require a static
+                        link of the C++ runtime libraries to allow for maximum
+                        portability of the built images.
+                    </blockquote>
+                </li>
+                <li>
+                    <b>Error Message: <tt>cannot restore segment prot after reloc</tt></b>
+                    <blockquote>
+                        This is probably an issue with SELinux (See
+                        <a href="http://en.wikipedia.org/wiki/SELinux" target="_blank">
+                        http://en.wikipedia.org/wiki/SELinux</a>).
+                        Parts of the VM is built without the <tt>-fPIC</tt> for
+                        performance reasons.
+                        <p>
+                        To completely disable SELinux:
+                        <tt>
+                            <ol>
+                                <li>$ su root</li>
+                                <li># system-config-securitylevel</li>
+                                <li>In the window that appears, select the SELinux tab</li>
+                                <li>Disable SELinux</li>
+                            </ol>
+                        </tt>
+                        <p>
+                        Alternatively, instead of completely disabling it you could
+                        disable just this one check.
+                        <tt>
+                            <ol>
+                                <li>Select System->Administration->SELinux Management</li>
+                                <li>In the SELinux Management Tool which appears, 
+                                select "Boolean" from the menu on the left</li>
+                                <li>Expand the "Memory Protection" group</li>
+                                <li>Check the first item, labeled
+                                "Allow all unconfined executables to use libraries requiring text relocation ..."</li>
+                            </ol>
+                        </tt>
+                    </blockquote>
+                </li>
+                <li>
+                    <b>Windows Error Message: <tt>*** fatal error - couldn't allocate heap, ... </tt></b>
+                    <blockquote>
+                        The CYGWIN software can conflict with other non-CYGWIN
+                        software. See the CYGWIN FAQ section on
+                        <a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank">
+                        BLODA (applications that interfere with CYGWIN)</a>.
+                    </blockquote>
+                </li>
+                <li>
+                    <b>Windows Error Message: <tt>*** multiple target patterns.  Stop.</tt></b>
+                    <blockquote>
+                        The CYGWIN make version 3.81 may not like the Windows <tt>C:/</tt>
+                        style paths, it may not like the ':' character in the path
+                        when used in a makefile target definition.
+                        See the <a href="#gmake"><tt><i>gmake</i></tt></a> section.
+                    </blockquote>
+                </li>
+            </ul>
+        </blockquote>
+        <hr>
+    </body>
+</html>