1.1 --- a/README-builds.html Thu Nov 20 11:39:33 2008 -0800 1.2 +++ b/README-builds.html Mon Dec 01 15:28:36 2008 -0800 1.3 @@ -98,7 +98,8 @@ 1.4 <h2><a name="MBE">Minimum Build Environments</a></h2> 1.5 <blockquote> 1.6 This file often describes specific requirements for what we call the 1.7 - "minimum build environments" (MBE) for the JDK. 1.8 + "minimum build environments" (MBE) for this 1.9 + specific release of the JDK, 1.10 Building with the MBE will generate the most compatible 1.11 bits that install on, and run correctly on, the most variations 1.12 of the same base OS and hardware architecture. 1.13 @@ -116,22 +117,22 @@ 1.14 <tr> 1.15 <th>Base OS and Architecture</th> 1.16 <th>OS</th> 1.17 - <th>Compiler</th> 1.18 + <th>C/C++ Compiler</th> 1.19 </tr> 1.20 </thead> 1.21 <tbody> 1.22 <tr> 1.23 - <td>Linux X86 (32bit)</td> 1.24 - <td>Red Hat Enterprise Linux 4 </td> 1.25 + <td>Linux X86 (32-bit)</td> 1.26 + <td>Fedora 9</td> 1.27 <td>gcc 4 </td> 1.28 </tr> 1.29 <tr> 1.30 - <td>Linux X64 (64bit)</td> 1.31 - <td>Red Hat Enterprise Linux 4 </td> 1.32 + <td>Linux X64 (64-bit)</td> 1.33 + <td>Fedora 9</td> 1.34 <td>gcc 4 </td> 1.35 </tr> 1.36 <tr> 1.37 - <td>Solaris SPARC (32bit)</td> 1.38 + <td>Solaris SPARC (32-bit)</td> 1.39 <td>Solaris 10 + patches 1.40 <br> 1.41 See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank"> 1.42 @@ -140,7 +141,7 @@ 1.43 <td>Sun Studio 12</td> 1.44 </tr> 1.45 <tr> 1.46 - <td>Solaris SPARCV9 (64bit)</td> 1.47 + <td>Solaris SPARCV9 (64-bit)</td> 1.48 <td>Solaris 10 + patches 1.49 <br> 1.50 See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank"> 1.51 @@ -149,7 +150,7 @@ 1.52 <td>Sun Studio 12</td> 1.53 </tr> 1.54 <tr> 1.55 - <td>Solaris X86 (32bit)</td> 1.56 + <td>Solaris X86 (32-bit)</td> 1.57 <td>Solaris 10 + patches 1.58 <br> 1.59 See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank"> 1.60 @@ -158,7 +159,7 @@ 1.61 <td>Sun Studio 12</td> 1.62 </tr> 1.63 <tr> 1.64 - <td>Solaris X64 (64bit)</td> 1.65 + <td>Solaris X64 (64-bit)</td> 1.66 <td>Solaris 10 + patches 1.67 <br> 1.68 See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank"> 1.69 @@ -167,17 +168,28 @@ 1.70 <td>Sun Studio 12</td> 1.71 </tr> 1.72 <tr> 1.73 - <td>Windows X86 (32bit)</td> 1.74 + <td>Windows X86 (32-bit)</td> 1.75 <td>Windows XP</td> 1.76 - <td>Microsoft Visual Studio .NET 2003 Professional</td> 1.77 + <td>Microsoft Visual Studio C++ 2008 Standard Edition</td> 1.78 </tr> 1.79 <tr> 1.80 - <td>Windows X64 (64bit)</td> 1.81 + <td>Windows X64 (64-bit)</td> 1.82 <td>Windows Server 2003 - Enterprise x64 Edition</td> 1.83 <td>Microsoft Platform SDK - April 2005</td> 1.84 </tr> 1.85 </tbody> 1.86 </table> 1.87 + <p> 1.88 + These same sources do indeed build on many more systems than the 1.89 + above older generation systems, again the above is just a minimum. 1.90 + <p> 1.91 + Compilation problems with newer or different C/C++ compilers is a 1.92 + common problem. 1.93 + Similarly, compilation problems related to changes to the 1.94 + <tt>/usr/include</tt> or system header files is also a 1.95 + common problem with newer or unreleased OS versions. 1.96 + Please report these types of problems as bugs so that they 1.97 + can be dealt with accordingly. 1.98 </blockquote> 1.99 <!-- ------------------------------------------------------ --> 1.100 <hr> 1.101 @@ -488,7 +500,7 @@ 1.102 not work due to a lack of support for MS-DOS drive letter paths 1.103 like <tt>C:/</tt> or <tt>C:\</tt>. 1.104 Use a 3.80 version, or find a newer 1.105 - version that has this problem fixed, like 3.82. 1.106 + version that has this problem fixed. 1.107 The older 3.80 version of make.exe can be downloaded with this 1.108 <a href="http://cygwin.paracoda.com/release/make/make-3.80-1.tar.bz2" target="_blank"> 1.109 link</a>. 1.110 @@ -575,8 +587,8 @@ 1.111 </li> 1.112 <li> 1.113 Install 1.114 - <a href="#ant">Ant</a>, set 1.115 - <tt><a href="#ANT_HOME">ANT_HOME</a></tt>. 1.116 + <a href="#ant">Ant</a>, 1.117 + make sure it is in your PATH. 1.118 </li> 1.119 </ol> 1.120 </blockquote> 1.121 @@ -592,7 +604,7 @@ 1.122 Approximately 1.4 GB of free disk 1.123 space is needed for a 32-bit build. 1.124 <p> 1.125 - If you are building the 64bit version, you should 1.126 + If you are building the 64-bit version, you should 1.127 run the command "isainfo -v" to verify that you have a 1.128 64-bit installation, it should say <tt>sparcv9</tt> or 1.129 <tt>amd64</tt>. 1.130 @@ -640,8 +652,8 @@ 1.131 </li> 1.132 <li> 1.133 Install 1.134 - <a href="#ant">Ant</a>, set 1.135 - <tt><a href="#ANT_HOME">ANT_HOME</a></tt>. 1.136 + <a href="#ant">Ant</a>, 1.137 + make sure it is in your PATH. 1.138 </li> 1.139 </ol> 1.140 </blockquote> 1.141 @@ -650,11 +662,11 @@ 1.142 <h3><a name="windows">Basic Windows System Setup</a></h3> 1.143 <blockquote> 1.144 <strong>i586 only:</strong> 1.145 - The minimum recommended hardware for building the 32bit or X86 1.146 + The minimum recommended hardware for building the 32-bit or X86 1.147 Windows version is an Pentium class processor or better, at least 1.148 512 MB of RAM, and approximately 600 MB of free disk space. 1.149 <strong> 1.150 - NOTE: The Windows 2000 build machines need to use the 1.151 + NOTE: The Windows build machines need to use the 1.152 file system NTFS. 1.153 Build machines formatted to FAT32 will not work 1.154 because FAT32 doesn't support case-sensitivity in file names. 1.155 @@ -719,8 +731,11 @@ 1.156 </li> 1.157 <li> 1.158 Install the 1.159 - <a href="#msvc">Microsoft Visual Studio .NET 2003 Professional</a> (32bit) or the 1.160 - <a href="#mssdk">Microsoft Platform SDK</a> (64bit). 1.161 + <a href="#msvc">Microsoft Visual Studio Compilers</a> (32-bit). 1.162 + </li> 1.163 + <li> 1.164 + Install the 1.165 + <a href="#mssdk">Microsoft Platform SDK</a>. 1.166 </li> 1.167 <li> 1.168 Setup all environment variables for compilers 1.169 @@ -732,7 +747,8 @@ 1.170 </li> 1.171 <li> 1.172 Install 1.173 - <a href="#ant">Ant</a>, set 1.174 + <a href="#ant">Ant</a>, 1.175 + make sure it is in your PATH and set 1.176 <tt><a href="#ANT_HOME">ANT_HOME</a></tt>. 1.177 </li> 1.178 </ol> 1.179 @@ -787,7 +803,9 @@ 1.180 you must first download and install the appropriate 1.181 binary plug bundles for the OpenJDK, go to the 1.182 <a href="http://openjdk.java.net" target="_blank">OpenJDK</a> site and select 1.183 - the "<b>Bundles(7)</b>" link and download the binaryplugs for 1.184 + the 1.185 + "<b>Bundles(7)</b>" 1.186 + link and download the binaryplugs for 1.187 your particular platform. 1.188 The file downloaded is a jar file that must be extracted by running 1.189 the jar file with: 1.190 @@ -823,14 +841,12 @@ 1.191 The Ant tool is available from the 1.192 <a href="http://ant.apache.org/antlibs/bindownload.cgi" target="_blank"> 1.193 Ant download site</a>. 1.194 - You should always set 1.195 + You should always make sure <tt>ant</tt> is in your PATH, and 1.196 + on Windows you may also need to set 1.197 <tt><a href="#ANT_HOME">ANT_HOME</a></tt> 1.198 to point to the location of 1.199 the Ant installation, this is the directory pathname 1.200 that contains a <tt>bin and lib</tt>. 1.201 - It's also a good idea to also place its <tt>bin</tt> directory 1.202 - in the <tt>PATH</tt> environment variable, although it's 1.203 - not absolutely required. 1.204 </blockquote> 1.205 <!-- ------------------------------------------------------ --> 1.206 <h4><a name="cacerts">Certificate Authority File (cacert)</a></h4> 1.207 @@ -862,25 +878,9 @@ 1.208 <blockquote> 1.209 <strong><a name="gcc">Linux gcc/binutils</a></strong> 1.210 <blockquote> 1.211 - The GNU gcc compiler version should be 3.2.2 or newer. 1.212 - The binutils package should be 2.11.93.0.2-11 or newer. 1.213 + The GNU gcc compiler version should be 4 or newer. 1.214 The compiler used should be the default compiler installed 1.215 in <tt>/usr/bin</tt>. 1.216 - <p> 1.217 - Older Linux systems may require a gcc and bunutils update. 1.218 - The Redhat Enterprise Advanced Server 2.1 update 2 system 1.219 - is one of these systems. 1.220 - RedHat Linux users can obtain this binutils package from 1.221 - <a href="http://www.redhat.com" 1.222 - target="_blank">Redhat web site</a>. 1.223 - You will need to remove the default compiler and binutils 1.224 - packages and install the required packages 1.225 - into the default location on the system. 1.226 - However if you have a new video card driver, like 1.227 - Geforce 4 it is best to use 1.228 - the same compiler as the kernel was built with to 1.229 - build the new video card driver module. 1.230 - So you should build the modules before making this change. 1.231 </blockquote> 1.232 <strong><a name="studio">Solaris: Sun Studio</a></strong> 1.233 <blockquote> 1.234 @@ -903,19 +903,20 @@ 1.235 are also an option, although these compilers have not 1.236 been extensively used yet. 1.237 </blockquote> 1.238 - <strong><a name="msvc">Windows i586: Microsoft Visual Studio .NET 2003 Professional</a></strong> 1.239 + <strong><a name="msvc">Windows i586: Microsoft Visual Studio Compilers</a></strong> 1.240 <blockquote> 1.241 The 32-bit OpenJDK Windows build 1.242 - requires Microsoft Visual Studio .NET 2003 (VS2003) Professional 1.243 + requires 1.244 + Microsoft Visual Studio C++ 2008 (VS2008) Standard 1.245 Edition compiler. 1.246 The compiler and other tools are expected to reside 1.247 - in the location defined by the variable <tt>VS71COMNTOOLS</tt> which 1.248 - is set by the Microsoft Visual Studio .NET installer. 1.249 + in the location defined by the variable 1.250 + <tt>VS90COMNTOOLS</tt> which 1.251 + is set by the Microsoft Visual Studio installer. 1.252 <p> 1.253 Once the compiler is installed, 1.254 it is recommended that you run <tt>VCVARS32.BAT</tt> 1.255 to set the compiler environment variables 1.256 - <tt>MSVCDIR</tt>, 1.257 <tt>INCLUDE</tt>, 1.258 <tt>LIB</tt>, and 1.259 <tt>PATH</tt> 1.260 @@ -923,16 +924,12 @@ 1.261 OpenJDK. 1.262 The above environment variables <b>MUST</b> be set. 1.263 <p> 1.264 - The Microsoft Visual Studio .NET 2005 (VS2005) compiler 1.265 - will not work at this time due to the new runtime dll 1.266 - and the manifest requirements. 1.267 - <p> 1.268 <b>WARNING:</b> Make sure you check out the 1.269 <a href="#cygwin">CYGWIN link.exe WARNING</a>. 1.270 The path <tt>/usr/bin</tt> must be after the path to the 1.271 Visual Studio product. 1.272 </blockquote> 1.273 - <strong><a name="mssdk">Windows X64: Microsoft Platform SDK April 2005</a></strong> 1.274 + <strong><a name="mssdk">Windows: Microsoft Platform SDK</a></strong> 1.275 <blockquote> 1.276 On <b>X64</b>, the Microsoft Platform Software 1.277 Development Kit (SDK), April 2005 Edition compiler, 1.278 @@ -953,10 +950,9 @@ 1.279 OpenJDK. 1.280 The above environment variables <b>MUST</b> be set. 1.281 <p> 1.282 - Note that this compiler may say it's version is a 1.283 - Microsoft Visual Studio .NET 2005 (VS2005), but be careful, 1.284 - it will not match the official VS2005 product. 1.285 - This Platform SDK compiler is only used on X64 builds. 1.286 + This Platform SDK compiler is only used on X64 builds 1.287 + but other parts of the Platform SDK may be used 1.288 + for the X86 builds. 1.289 </blockquote> 1.290 </blockquote> 1.291 <!-- ------------------------------------------------------ --> 1.292 @@ -1241,37 +1237,37 @@ 1.293 <strong><a name="msvcrt"><tt>MSVCRT.DLL</tt></a></strong> 1.294 <blockquote> 1.295 <strong>i586 only:</strong> 1.296 - The OpenJDK 32bit build requires access to 1.297 - <tt>MSVCRT.DLL</tt> version 6.00.8337.0 or newer. 1.298 + The OpenJDK 32-bit build requires access to a redistributable 1.299 + <tt>MSVCRT.DLL</tt>. 1.300 If the <tt>MSVCRT.DLL</tt> is not installed in 1.301 the system32 directory set the 1.302 <a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a> 1.303 - variable to the location. 1.304 + variable to the location of this file. 1.305 <p> 1.306 <strong>X64 only:</strong> 1.307 - The OpenJDK 64bit build requires access to 1.308 - <tt>MSVCRT.DLL</tt> version 7.0.3790.0 or newer, which is 1.309 + The OpenJDK 64-bit build requires access to a redistributable 1.310 + <tt>MSVCRT.DLL</tt>, which is 1.311 usually supplied by the 1.312 <a href="#mssdk">Platform SDK</a>. 1.313 If it is not available from the Platform SDK, 1.314 set the 1.315 <a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a> 1.316 - variable to the location. 1.317 + variable to the location of this file. 1.318 </blockquote> 1.319 - <strong><tt><a name="msvcr71">MSVCR71.DLL</a></tt></strong> 1.320 + <strong><tt><a name="msvcr90">MSVCR90.DLL</a></tt></strong> 1.321 <blockquote> 1.322 <strong>i586 only:</strong> 1.323 The 1.324 OpenJDK 1.325 - build requires access to 1.326 - MSVCR71.DLL version 7.10.3052.4 or newer which should be 1.327 + build requires access to a redistributable 1.328 + <tt>MSVCR90.DLL</tt> which should be 1.329 supplied by the 1.330 - <a href="#msvc">Visual Studio product</a> 1.331 - If the <tt>MSVCR71.DLL</tt> is not available from the 1.332 + <a href="#msvc">Visual Studio product</a>. 1.333 + If the <tt>MSVCR90.DLL</tt> is not available from the 1.334 Visual Studio product 1.335 set the 1.336 - <a href="#ALT_MSVCR71_DLL_PATH"><tt>ALT_MSVCR71_DLL_PATH</tt></a> 1.337 - variable to the location. 1.338 + <a href="#ALT_MSVCR90_DLL_PATH"><tt>ALT_MSVCR90_DLL_PATH</tt></a> 1.339 + variable to the location of this file. 1.340 </blockquote> 1.341 </blockquote> 1.342 <!-- ------------------------------------------------------ --> 1.343 @@ -1359,6 +1355,46 @@ 1.344 document) that can impact the build are: 1.345 <blockquote> 1.346 <dl> 1.347 + <dt><a name="path"><tt>PATH</tt></a> </dt> 1.348 + <dd>Typically you want to set the <tt>PATH</tt> to include: 1.349 + <ul> 1.350 + <li>The location of the GNU make binary</li> 1.351 + <li>The location of the Bootstrap JDK <tt>java</tt> 1.352 + (see <a href="#bootjdk">Bootstrap JDK</a>)</li> 1.353 + <li>The location of the C/C++ compilers 1.354 + (see <a href="#compilers"><tt>compilers</tt></a>)</li> 1.355 + <li>The location or locations for the Unix command utilities 1.356 + (e.g. <tt>/usr/bin</tt>)</li> 1.357 + </ul> 1.358 + </dd> 1.359 + <dt><tt>MILESTONE</tt> </dt> 1.360 + <dd> 1.361 + The milestone name for the build (<i>e.g.</i>"beta"). 1.362 + The default value is "internal". 1.363 + </dd> 1.364 + <dt><tt>BUILD_NUMBER</tt> </dt> 1.365 + <dd> 1.366 + The build number for the build (<i>e.g.</i> "b27"). 1.367 + The default value is "b00". 1.368 + </dd> 1.369 + <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt> 1.370 + <dd>The <tt>ARCH_DATA_MODEL</tt> variable 1.371 + is used to specify whether the build is to generate 32-bit or 64-bit 1.372 + binaries. 1.373 + The Solaris build supports either 32-bit or 64-bit builds, but 1.374 + Windows and Linux will support only one, depending on the specific 1.375 + OS being used. 1.376 + Normally, setting this variable is only necessary on Solaris. 1.377 + Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries, 1.378 + or to <tt>64</tt> for generating 64-bit binaries. 1.379 + </dd> 1.380 + <dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt> 1.381 + <dd> 1.382 + The location of the bootstrap JDK installation. 1.383 + See <a href="#bootjdk">Bootstrap JDK</a> for more information. 1.384 + You should always install your own local Bootstrap JDK and 1.385 + always set <tt>ALT_BOOTDIR</tt> explicitly. 1.386 + </dd> 1.387 <dt><a name="ALT_BINARY_PLUGS_PATH"><tt>ALT_BINARY_PLUGS_PATH</tt></a></dt> 1.388 <dd> 1.389 The location of the binary plugs installation. 1.390 @@ -1367,12 +1403,101 @@ 1.391 recent Binary Plugs install image 1.392 and set this variable to that location. 1.393 </dd> 1.394 - <dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt> 1.395 + <dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt> 1.396 <dd> 1.397 - The location of the bootstrap JDK installation. 1.398 - See <a href="#bootjdk">Bootstrap JDK</a> for more information. 1.399 - You should always install your own local Bootstrap JDK and 1.400 - always set <tt>ALT_BOOTDIR</tt> explicitly. 1.401 + The location of a previously built JDK installation. 1.402 + See <a href="#importjdk">Optional Import JDK</a> for more information. 1.403 + </dd> 1.404 + <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt> 1.405 + <dd> 1.406 + An override for specifying the (absolute) path of where the 1.407 + build output is to go. 1.408 + The default output directory will be build/<i>platform</i>. 1.409 + </dd> 1.410 + <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt> 1.411 + <dd> 1.412 + The location of the C/C++ compiler. 1.413 + The default varies depending on the platform. 1.414 + </dd> 1.415 + <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt> 1.416 + <dd> 1.417 + The location of the <a href="#cacerts">cacerts</a> file. 1.418 + The default will refer to 1.419 + <tt>jdk/src/share/lib/security/cacerts</tt>. 1.420 + </dd> 1.421 + <dt><a name="ALT_CUPS_HEADERS_PATH"><tt>ALT_CUPS_HEADERS_PATH</tt></a> </dt> 1.422 + <dd> 1.423 + The location of the CUPS header files. 1.424 + See <a href="#cups">CUPS information</a> for more information. 1.425 + If this path does not exist the fallback path is 1.426 + <tt>/usr/include</tt>. 1.427 + </dd> 1.428 + <dt><a name="ALT_FREETYPE_LIB_PATH"><tt>ALT_FREETYPE_LIB_PATH</tt></a></dt> 1.429 + <dd> 1.430 + The location of the FreeType shared library. 1.431 + See <a href="#freetype">FreeType information</a> for details. 1.432 + </dd> 1.433 + <dt><a name="ALT_FREETYPE_HEADERS_PATH"><tt>ALT_FREETYPE_HEADERS_PATH</tt></a></dt> 1.434 + <dd> 1.435 + The location of the FreeType header files. 1.436 + See <a href="#freetype">FreeType information</a> for details. 1.437 + </dd> 1.438 + <dt><a name="ALT_JDK_DEVTOOLS_PATH"><tt>ALT_JDK_DEVTOOLS_PATH</tt></a></dt> 1.439 + <dd> 1.440 + The default root location of the devtools. 1.441 + The default value is 1.442 + <tt>$(ALT_SLASH_JAVA)/devtools</tt>. 1.443 + </dd> 1.444 + <dt><tt><a name="ALT_DEVTOOLS_PATH">ALT_DEVTOOLS_PATH</a></tt> </dt> 1.445 + <dd> 1.446 + The location of tools like the 1.447 + <a href="#zip"><tt>zip</tt> and <tt>unzip</tt></a> 1.448 + binaries, but might also contain the GNU make utility 1.449 + (<tt><i>gmake</i></tt>). 1.450 + So this area is a bit of a grab bag, especially on Windows. 1.451 + The default value depends on the platform and 1.452 + Unix Commands being used. 1.453 + On Linux the default will be 1.454 + <tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>, 1.455 + on Solaris 1.456 + <tt>$(ALT_JDK_DEVTOOLS_PATH)/<i>{sparc,i386}</i>/bin</tt>, 1.457 + and on Windows with CYGWIN 1.458 + <tt>/usr/bin</tt>. 1.459 + </dd> 1.460 + <dt><a name="ALT_UNIXCCS_PATH"><tt>ALT_UNIXCCS_PATH</tt></a></dt> 1.461 + <dd> 1.462 + <strong>Solaris only:</strong> 1.463 + An override for specifying where the Unix CCS 1.464 + command set are located. 1.465 + The default location is <tt>/usr/ccs/bin</tt> 1.466 + </dd> 1.467 + <dt><a name="ALT_SLASH_JAVA"><tt>ALT_SLASH_JAVA</tt></a></dt> 1.468 + <dd> 1.469 + The default root location for many of the ALT path locations 1.470 + of the following ALT variables. 1.471 + The default value is 1.472 + <tt>"/java"</tt> on Solaris and Linux, 1.473 + <tt>"J:"</tt> on Windows. 1.474 + </dd> 1.475 + <dt><a name="ALT_BUILD_JDK_IMPORT_PATH"><tt>ALT_BUILD_JDK_IMPORT_PATH</tt></a></dt> 1.476 + <dd> 1.477 + These are useful in managing builds on multiple platforms. 1.478 + The default network location for all of the import JDK images 1.479 + for all platforms. 1.480 + If <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt> 1.481 + is not set, this directory will be used and should contain 1.482 + the following directories: 1.483 + <tt>solaris-sparc</tt>, 1.484 + <tt>solaris-i586</tt>, 1.485 + <tt>solaris-sparcv9</tt>, 1.486 + <tt>solaris-amd64</tt>, 1.487 + <tt>linux-i586</tt>, 1.488 + <tt>linux-amd64</tt>, 1.489 + <tt>windows-i586</tt>, 1.490 + and 1.491 + <tt>windows-amd64</tt>. 1.492 + Where each of these directories contain the import JDK image 1.493 + for that platform. 1.494 </dd> 1.495 <dt><a name="ALT_BUILD_BINARY_PLUGS_PATH"><tt>ALT_BUILD_BINARY_PLUGS_PATH</tt></a></dt> 1.496 <dd> 1.497 @@ -1394,186 +1519,37 @@ 1.498 Where each of these directories contain the binary plugs image 1.499 for that platform. 1.500 </dd> 1.501 - <dt><a name="ALT_BUILD_JDK_IMPORT_PATH"><tt>ALT_BUILD_JDK_IMPORT_PATH</tt></a></dt> 1.502 + <dt><strong>Windows specific:</strong></dt> 1.503 <dd> 1.504 - These are useful in managing builds on multiple platforms. 1.505 - The default network location for all of the import JDK images 1.506 - for all platforms. 1.507 - If <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt> 1.508 - is not set, this directory will be used and should contain 1.509 - the following directories: 1.510 - <tt>solaris-sparc</tt>, 1.511 - <tt>solaris-i586</tt>, 1.512 - <tt>solaris-sparcv9</tt>, 1.513 - <tt>solaris-amd64</tt>, 1.514 - <tt>linux-i586</tt>, 1.515 - <tt>linux-amd64</tt>, 1.516 - <tt>windows-i586</tt>, 1.517 - and 1.518 - <tt>windows-amd64</tt>. 1.519 - Where each of these directories contain the import JDK image 1.520 - for that platform. 1.521 - </dd> 1.522 - <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt> 1.523 - <dd> 1.524 - The location of the <a href="#cacerts">cacerts</a> file. 1.525 - The default will refer to 1.526 - <tt>jdk/src/share/lib/security/cacerts</tt>. 1.527 - </dd> 1.528 - <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt> 1.529 - <dd> 1.530 - The location of the C/C++ compiler. 1.531 - The default varies depending on the platform. 1.532 - </dd> 1.533 - <dt><a name="ALT_CUPS_HEADERS_PATH"><tt>ALT_CUPS_HEADERS_PATH</tt></a> </dt> 1.534 - <dd> 1.535 - The location of the CUPS header files. 1.536 - See <a href="#cups">CUPS information</a> for more information. 1.537 - If this path does not exist the fallback path is 1.538 - <tt>/usr/include</tt>. 1.539 - </dd> 1.540 - <dt><tt><a name="ALT_DEVTOOLS_PATH">ALT_DEVTOOLS_PATH</a></tt> </dt> 1.541 - <dd> 1.542 - The location of tools like the 1.543 - <a href="#zip"><tt>zip</tt> and <tt>unzip</tt></a> 1.544 - binaries, but might also contain the GNU make utility 1.545 - (<tt><i>gmake</i></tt>). 1.546 - So this area is a bit of a grab bag, especially on Windows. 1.547 - The default value depends on the platform and 1.548 - Unix Commands being used. 1.549 - On Linux the default will be 1.550 - <tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>, 1.551 - on Solaris 1.552 - <tt>$(ALT_JDK_DEVTOOLS_PATH)/<i>{sparc,i386}</i>/bin</tt>, 1.553 - on Windows with MKS 1.554 - <tt>%SYSTEMDRIVE%/UTILS</tt>, 1.555 - and on Windows with CYGWIN 1.556 - <tt>/usr/bin</tt>. 1.557 - </dd> 1.558 - <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt> 1.559 - <dd> 1.560 - <strong>Windows Only:</strong> 1.561 - The location of the 1.562 - <a href="#dxsdk">Microsoft DirectX 9 SDK</a>. 1.563 - The default will be to try and use the DirectX environment 1.564 - variable <tt>DXSDK_DIR</tt>, 1.565 - failing that, look in <tt>C:/DXSDK</tt>. 1.566 - </dd> 1.567 - <dt><a name="ALT_FREETYPE_HEADERS_PATH"><tt>ALT_FREETYPE_HEADERS_PATH</tt></a></dt> 1.568 - <dd> 1.569 - The location of the FreeType header files. 1.570 - See <a href="#freetype">FreeType information</a> for details. 1.571 - </dd> 1.572 - <dt><a name="ALT_FREETYPE_LIB_PATH"><tt>ALT_FREETYPE_LIB_PATH</tt></a></dt> 1.573 - <dd> 1.574 - The location of the FreeType shared library. 1.575 - See <a href="#freetype">FreeType information</a> for details. 1.576 - </dd> 1.577 - <dt><a name="ALT_JDK_DEVTOOLS_PATH"><tt>ALT_JDK_DEVTOOLS_PATH</tt></a></dt> 1.578 - <dd> 1.579 - The default root location of the devtools. 1.580 - The default value is 1.581 - <tt>$(ALT_SLASH_JAVA)/devtools</tt>. 1.582 - </dd> 1.583 - <dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt> 1.584 - <dd> 1.585 - The location of a previously built JDK installation. 1.586 - See <a href="#importjdk">Optional Import JDK</a> for more information. 1.587 - </dd> 1.588 - <dt><a name="ALT_MSDEVTOOLS_PATH"><tt>ALT_MSDEVTOOLS_PATH</tt></a> </dt> 1.589 - <dd> 1.590 - <strong>Windows Only:</strong> 1.591 - The location of the Microsoft Visual Studio .NET 2003 1.592 - tools 'bin' directory. 1.593 - The default is usually derived from 1.594 - <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>. 1.595 - </dd> 1.596 - <dt><tt><a name="ALT_MSVCR71_DLL_PATH">ALT_MSVCR71_DLL_PATH</a></tt> </dt> 1.597 - <dd> 1.598 - <strong>Windows i586 only:</strong> 1.599 - The location of the 1.600 - <a href="#msvcr71"><tt>MSVCR71.DLL</tt></a>. 1.601 - </dd> 1.602 - <dt><tt><a name="ALT_MSVCRT_DLL_PATH">ALT_MSVCRT_DLL_PATH</a></tt> </dt> 1.603 - <dd> 1.604 - <strong>Windows Only:</strong> 1.605 - The location of the 1.606 - <a href="#msvcrt"><tt>MSVCRT.DLL</tt></a>. 1.607 - </dd> 1.608 - <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt> 1.609 - <dd> 1.610 - An override for specifying the (absolute) path of where the 1.611 - build output is to go. 1.612 - The default output directory will be build/<i>platform</i>. 1.613 - </dd> 1.614 - <dt><a name="ALT_SLASH_JAVA"><tt>ALT_SLASH_JAVA</tt></a></dt> 1.615 - <dd> 1.616 - The default root location for many of the ALT path locations 1.617 - of the following ALT variables. 1.618 - The default value is 1.619 - <tt>"/java"</tt> on Solaris and Linux, 1.620 - <tt>"J:"</tt> on Windows. 1.621 - </dd> 1.622 - <dt><a name="ALT_UNIXCCS_PATH"><tt>ALT_UNIXCCS_PATH</tt></a></dt> 1.623 - <dd> 1.624 - <strong>Solaris only:</strong> 1.625 - An override for specifying where the Unix CCS 1.626 - command set are located. 1.627 - The default location is <tt>/usr/ccs/bin</tt> 1.628 - </dd> 1.629 - <dt><a name="ALT_UNIXCOMMAND_PATH"><tt>ALT_UNIXCOMMAND_PATH</tt></a> </dt> 1.630 - <dd> 1.631 - An override for specifying where the 1.632 - Unix command set are located. 1.633 - The default location varies depending on the platform, 1.634 - <tt>"%SYSTEMDRIVE%/MKSNT"</tt> or 1.635 - <tt>$(ROOTDIR)</tt> on Windows with MKS, otherwise it's 1.636 - <tt>"/bin"</tt> or <tt>/usr/bin</tt>. 1.637 - </dd> 1.638 - <dt><a name="ALT_USRBIN_PATH"><tt>ALT_USRBIN_PATH</tt></a></dt> 1.639 - <dd> 1.640 - An override for specifying where the 1.641 - Unix <tt>/usr/bin</tt> commands are located. You usually do not need 1.642 - to set this variable: the default location is <tt>/usr/bin</tt>) 1.643 - </dd> 1.644 - <dt><a name="ANT_HOME"><tt>ANT_HOME</tt></a></dt> 1.645 - <dd> 1.646 - The location of the Ant installation. 1.647 - See <a href="#ant">Ant</a> for more information. 1.648 - You should always set <tt>ANT_HOME</tt> explicitly. 1.649 - </dd> 1.650 - <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt> 1.651 - <dd>The <tt>ARCH_DATA_MODEL</tt> variable 1.652 - is used to specify whether the build is to generate 32-bit or 64-bit 1.653 - binaries. 1.654 - The Solaris build supports either 32-bit or 64-bit builds, but 1.655 - Windows and Linux will support only one, depending on the specific 1.656 - OS being used. 1.657 - Normally, setting this variable is only necessary on Solaris. 1.658 - Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries, 1.659 - or to <tt>64</tt> for generating 64-bit binaries. 1.660 - </dd> 1.661 - <dt><tt>BUILD_NUMBER</tt> </dt> 1.662 - <dd> 1.663 - The build number for the build (<i>e.g.</i> "b27"). 1.664 - The default value is "b00". 1.665 - </dd> 1.666 - <dt><tt>MILESTONE</tt> </dt> 1.667 - <dd> 1.668 - The milestone name for the build (<i>e.g.</i>"beta"). 1.669 - The default value is "internal". 1.670 - </dd> 1.671 - <dt><a name="path"><tt>PATH</tt></a> </dt> 1.672 - <dd>Typically you want to set the <tt>PATH</tt> to include: 1.673 - <ul> 1.674 - <li>The location of the GNU make binary</li> 1.675 - <li>The location of the Bootstrap JDK <tt>java</tt> 1.676 - (see <a href="#bootjdk">Bootstrap JDK</a>)</li> 1.677 - <li>The location of the C/C++ compilers 1.678 - (see <a href="#compilers"><tt>compilers</tt></a>)</li> 1.679 - <li>The location or locations for the Unix command utilities 1.680 - (e.g. <tt>/usr/bin</tt>)</li> 1.681 - </ul> 1.682 + <dl> 1.683 + <dt><a name="ALT_MSDEVTOOLS_PATH"><tt>ALT_MSDEVTOOLS_PATH</tt></a> </dt> 1.684 + <dd> 1.685 + The location of the 1.686 + Microsoft Visual Studio 1.687 + tools 'bin' directory. 1.688 + The default is usually derived from 1.689 + <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>. 1.690 + </dd> 1.691 + <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt> 1.692 + <dd> 1.693 + The location of the 1.694 + <a href="#dxsdk">Microsoft DirectX 9 SDK</a>. 1.695 + The default will be to try and use the DirectX environment 1.696 + variable <tt>DXSDK_DIR</tt>, 1.697 + failing that, look in <tt>C:/DXSDK</tt>. 1.698 + </dd> 1.699 + <dt><tt><a name="ALT_MSVCRT_DLL_PATH">ALT_MSVCRT_DLL_PATH</a></tt> </dt> 1.700 + <dd> 1.701 + The location of the 1.702 + <a href="#msvcrt"><tt>MSVCRT.DLL</tt></a>. 1.703 + </dd> 1.704 + <dt><tt><a name="ALT_MSVCR90_DLL_PATH">ALT_MSVCR90_DLL_PATH</a></tt> </dt> 1.705 + <dd> 1.706 + <strong>i586 only:</strong> 1.707 + The location of the 1.708 + <a href="#msvcr90"><tt>MSVCR90.DLL</tt></a>. 1.709 + </dd> 1.710 + </dl> 1.711 </dd> 1.712 </dl> 1.713 </blockquote> 1.714 @@ -1661,8 +1637,8 @@ 1.715 This is caused by a missing libstdc++.a library. 1.716 This is installed as part of a specific package 1.717 (e.g. libstdc++.so.devel.386). 1.718 - By default some 64bit Linux versions (e.g. Fedora) 1.719 - only install the 64bit version of the libstdc++ package. 1.720 + By default some 64-bit Linux versions (e.g. Fedora) 1.721 + only install the 64-bit version of the libstdc++ package. 1.722 Various parts of the JDK build require a static 1.723 link of the C++ runtime libraries to allow for maximum 1.724 portability of the built images.