1.1 --- a/README-builds.html Wed Jul 09 10:03:55 2008 -0700
1.2 +++ b/README-builds.html Wed Jul 09 15:42:00 2008 -0700
1.3 @@ -5,15 +5,12 @@
1.4 </head>
1.5 <body style="background-color:lightcyan">
1.6 <!-- ====================================================== -->
1.7 - <table width="100%" style="background-color:white">
1.8 + + <table width="100%">
1.9 <tr>
1.10 <td align="center">
1.11 - <a href="http://openjdk.java.net" border="0">
1.12 - <img alt="OpenJDK"
1.13 - src="http://openjdk.java.net/images/openjdk.png"
1.14 - width=256
1.15 - style="border-style: none"/>
1.16 - </a>
1.17 + <img alt="OpenJDK"
1.18 + src="http://openjdk.java.net/images/openjdk.png"
1.19 + width=256 />
1.20 </td>
1.21 </tr>
1.22 <tr>
1.23 @@ -54,6 +51,7 @@
1.24 <li><a href="#bootjdk">Bootstrap JDK</a> </li>
1.25 <li><a href="#binaryplugs">Binary Plugs</a> </li>
1.26 <li><a href="#importjdk">Optional Import JDK</a> </li>
1.27 + <li><a href="#ant">Ant</a> </li>
1.28 <li><a href="#cacerts">Certificate Authority File (cacert)</a> </li>
1.29 <li><a href="#compilers">Compilers</a>
1.30 <ul>
1.31 @@ -424,24 +422,37 @@
1.32 you should use <tt>gmake</tt>
1.33 which will be located in either the <tt>/opt/sfw/bin</tt> or
1.34 <tt>/usr/sfw/bin</tt> directory.
1.35 + In more recent versions of Solaris GNU make can be found
1.36 + at <tt>/usr/bin/gmake</tt>.
1.37 </li>
1.38 <li>
1.39 <strong>Windows:</strong>
1.40 Make sure you start your build inside a bash/sh/ksh shell.
1.41 <br>
1.42 <b>WARNING:</b> Watch out for make version 3.81, it may
1.43 - not work due to a lack of support for drive letter paths
1.44 - like <tt>C:/</tt>. See
1.45 - <a href="#gmake">section on gmake</a>.
1.46 + not work due to a lack of support for MS-DOS drive letter paths
1.47 + like <tt>C:/</tt> or <tt>C:\</tt>.
1.48 Use a 3.80 version, or find a newer
1.49 - version that has this problem fixed.
1.50 + version that has this problem fixed, like 3.82.
1.51 The older 3.80 version of make.exe can be downloaded with this
1.52 <a href="http://cygwin.paracoda.com/release/make/make-3.80-1.tar.bz2" target="_blank">
1.53 link</a>.
1.54 + Use of this older 3.80 make.exe may require that you install the
1.55 + libintl2.dll library or libintl2 cygwin package which is
1.56 + no longer installed by default by the cygwin installer.
1.57 + <br>
1.58 Also see the
1.59 <a href="http://developer.mozilla.org/en/docs/Windows_build_prerequisites_using_cygwin#make" target="_blank">
1.60 mozilla developer center</a>
1.61 on this topic.
1.62 + <br>
1.63 + It's hoped that when make 3.82 starts shipping in a future cygwin
1.64 + release that this MS-DOS path issue will be fixed.
1.65 + In addition to the above 3.80 make.exe you can download
1.66 + this
1.67 + <a href="http://www.cmake.org/files/cygwin/make.exe">
1.68 + www.cmake.org make.exe</a> which will not have a libintl2.dll
1.69 + dependency.
1.70 </li>
1.71 </ul>
1.72 <p>
1.73 @@ -507,6 +518,11 @@
1.74 Install or upgrade the <a href="#freetype">FreeType development
1.75 package</a>.
1.76 </li>
1.77 + <li>
1.78 + Install
1.79 + <a href="#ant">Ant</a>, set
1.80 + <tt><a href="#ANT_HOME">ANT_HOME</a></tt>.
1.81 + </li>
1.82 </ol>
1.83 </blockquote>
1.84 <!-- ------------------------------------------------------ -->
1.85 @@ -567,6 +583,11 @@
1.86 <a href="#cups">CUPS Include files</a>, set
1.87 <tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>.
1.88 </li>
1.89 + <li>
1.90 + Install
1.91 + <a href="#ant">Ant</a>, set
1.92 + <tt><a href="#ANT_HOME">ANT_HOME</a></tt>.
1.93 + </li>
1.94 </ol>
1.95 </blockquote>
1.96 <!-- ------------------------------------------------------ -->
1.97 @@ -654,6 +675,11 @@
1.98 Install
1.99 <a href="#dxsdk">Microsoft DirectX SDK</a>.
1.100 </li>
1.101 + <li>
1.102 + Install
1.103 + <a href="#ant">Ant</a>, set
1.104 + <tt><a href="#ANT_HOME">ANT_HOME</a></tt>.
1.105 + </li>
1.106 </ol>
1.107 </blockquote>
1.108 <!-- ------------------------------------------------------ -->
1.109 @@ -736,6 +762,22 @@
1.110 and the build will copy the needed files from this import area.
1.111 </blockquote>
1.112 <!-- ------------------------------------------------------ -->
1.113 + <h4><a name="ant">Ant</a></h4>
1.114 + <blockquote>
1.115 + All OpenJDK builds require access to least Ant 1.6.5.
1.116 + The Ant tool is available from the
1.117 + <a href="http://ant.apache.org/antlibs/bindownload.cgi" target="_blank">
1.118 + Ant download site</a>.
1.119 + You should always set
1.120 + <tt><a href="#ANT_HOME">ANT_HOME</a></tt>
1.121 + to point to the location of
1.122 + the Ant installation, this is the directory pathname
1.123 + that contains a <tt>bin and lib</tt>.
1.124 + It's also a good idea to also place its <tt>bin</tt> directory
1.125 + in the <tt>PATH</tt> environment variable, although it's
1.126 + not absolutely required.
1.127 + </blockquote>
1.128 + <!-- ------------------------------------------------------ -->
1.129 <h4><a name="cacerts">Certificate Authority File (cacert)</a></h4>
1.130 <blockquote>
1.131 See <a href="http://en.wikipedia.org/wiki/Certificate_Authority" target="_blank">
1.132 @@ -915,6 +957,21 @@
1.133 and
1.134 <tt><a href="#ALT_FREETYPE_HEADERS_PATH">ALT_FREETYPE_HEADERS_PATH</a></tt>
1.135 to refer to place where library and header files are installed.
1.136 + <p>
1.137 + Building the freetype 2 libraries from scratch is also possible,
1.138 + however on Windows refer to the
1.139 + <a href="http://freetype.freedesktop.org/wiki/FreeType_DLL">
1.140 + Windows FreeType DLL build instructions</a>.
1.141 + <p>
1.142 + Note that by default FreeType is built with byte code hinting
1.143 + support disabled due to licensing restrictions.
1.144 + In this case, text appearance and metrics are expected to
1.145 + differ from Sun's official JDK build.
1.146 + See
1.147 + <a href="http://freetype.sourceforge.net/freetype2/index.html">
1.148 + the SourceForge FreeType2 Home Page
1.149 + </a>
1.150 + for more information.
1.151 </blockquote>
1.152 <!-- ------------------------------------------------------ -->
1.153 <h4><a name="alsa">Advanced Linux Sound Architecture (ALSA) (Linux only)</a></h4>
1.154 @@ -1036,7 +1093,8 @@
1.155 <tr>
1.156 <td>make.exe</td>
1.157 <td>Devel</td>
1.158 - <td>make: The GNU version of the 'make' utility</td>
1.159 + <td>make: The GNU version of the 'make' utility<br>
1.160 + <b>NOTE</b>: See <a href="#gmake">the GNU make section</a></td>
1.161 </tr>
1.162 <tr>
1.163 <td>m4.exe</td>
1.164 @@ -1050,7 +1108,7 @@
1.165 <td>cpio: A program to manage archives of files</td>
1.166 </tr>
1.167 <tr>
1.168 - <td>awk.exe</td>
1.169 + <td>gawk.exe</td>
1.170 <td>Utils</td>
1.171 <td>awk: Pattern-directed scanning and processing language</td>
1.172 </tr>
1.173 @@ -1061,17 +1119,17 @@
1.174 </tr>
1.175 <tr>
1.176 <td>zip.exe</td>
1.177 - <td>Utils</td>
1.178 + <td>Archive</td>
1.179 <td>zip: Package and compress (archive) files</td>
1.180 </tr>
1.181 <tr>
1.182 <td>unzip.exe</td>
1.183 - <td>Utils</td>
1.184 + <td>Archive</td>
1.185 <td>unzip: Extract compressed files in a ZIP archive</td>
1.186 </tr>
1.187 <tr>
1.188 <td>free.exe</td>
1.189 - <td>Utils</td>
1.190 + <td>Procps</td>
1.191 <td>free: Display amount of free and used memory in the system</td>
1.192 </tr>
1.193 </tbody>
1.194 @@ -1224,38 +1282,13 @@
1.195 document) that can impact the build are:
1.196 <blockquote>
1.197 <dl>
1.198 - <dt><a name="path"><tt>PATH</tt></a> </dt>
1.199 - <dd>Typically you want to set the <tt>PATH</tt> to include:
1.200 - <ul>
1.201 - <li>The location of the GNU make binary</li>
1.202 - <li>The location of the Bootstrap JDK <tt>java</tt>
1.203 - (see <a href="#bootjdk">Bootstrap JDK</a>)</li>
1.204 - <li>The location of the C/C++ compilers
1.205 - (see <a href="#compilers"><tt>compilers</tt></a>)</li>
1.206 - <li>The location or locations for the Unix command utilities
1.207 - (e.g. <tt>/usr/bin</tt>)</li>
1.208 - </ul>
1.209 - </dd>
1.210 - <dt><tt>MILESTONE</tt> </dt>
1.211 + <dt><a name="ALT_BINARY_PLUGS_PATH"><tt>ALT_BINARY_PLUGS_PATH</tt></a></dt>
1.212 <dd>
1.213 - The milestone name for the build (<i>e.g.</i>"beta").
1.214 - The default value is "internal".
1.215 - </dd>
1.216 - <dt><tt>BUILD_NUMBER</tt> </dt>
1.217 - <dd>
1.218 - The build number for the build (<i>e.g.</i> "b27").
1.219 - The default value is "b00".
1.220 - </dd>
1.221 - <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt>
1.222 - <dd>The <tt>ARCH_DATA_MODEL</tt> variable
1.223 - is used to specify whether the build is to generate 32-bit or 64-bit
1.224 - binaries.
1.225 - The Solaris build supports either 32-bit or 64-bit builds, but
1.226 - Windows and Linux will support only one, depending on the specific
1.227 - OS being used.
1.228 - Normally, setting this variable is only necessary on Solaris.
1.229 - Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries,
1.230 - or to <tt>64</tt> for generating 64-bit binaries.
1.231 + The location of the binary plugs installation.
1.232 + See <a href="#binaryplugs">Binary Plugs</a> for more information.
1.233 + You should always have a local copy of a
1.234 + recent Binary Plugs install image
1.235 + and set this variable to that location.
1.236 </dd>
1.237 <dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt>
1.238 <dd>
1.239 @@ -1264,106 +1297,25 @@
1.240 You should always install your own local Bootstrap JDK and
1.241 always set <tt>ALT_BOOTDIR</tt> explicitly.
1.242 </dd>
1.243 - <dt><a name="ALT_BINARY_PLUGS_PATH"><tt>ALT_BINARY_PLUGS_PATH</tt></a></dt>
1.244 + <dt><a name="ALT_BUILD_BINARY_PLUGS_PATH"><tt>ALT_BUILD_BINARY_PLUGS_PATH</tt></a></dt>
1.245 <dd>
1.246 - The location of the binary plugs installation.
1.247 - See <a href="#binaryplugs">Binary Plugs</a> for more information.
1.248 - You should always have a local copy of a
1.249 - recent Binary Plugs install image
1.250 - and set this variable to that location.
1.251 - </dd>
1.252 - <dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt>
1.253 - <dd>
1.254 - The location of a previously built JDK installation.
1.255 - See <a href="#importjdk">Optional Import JDK</a> for more information.
1.256 - </dd>
1.257 - <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt>
1.258 - <dd>
1.259 - An override for specifying the (absolute) path of where the
1.260 - build output is to go.
1.261 - The default output directory will be build/<i>platform</i>.
1.262 - </dd>
1.263 - <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt>
1.264 - <dd>
1.265 - The location of the C/C++ compiler.
1.266 - The default varies depending on the platform.
1.267 - </dd>
1.268 - <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt>
1.269 - <dd>
1.270 - The location of the <a href="#cacerts">cacerts</a> file.
1.271 - The default will refer to
1.272 - <tt>jdk/src/share/lib/security/cacerts</tt>.
1.273 - </dd>
1.274 - <dt><a name="ALT_CUPS_HEADERS_PATH"><tt>ALT_CUPS_HEADERS_PATH</tt></a> </dt>
1.275 - <dd>
1.276 - The location of the CUPS header files.
1.277 - See <a href="#cups">CUPS information</a> for more information.
1.278 - If this path does not exist the fallback path is
1.279 - <tt>/usr/include</tt>.
1.280 - </dd>
1.281 - <dt><a name="ALT_FREETYPE_LIB_PATH"><tt>ALT_FREETYPE_LIB_PATH</tt></a></dt>
1.282 - <dd>
1.283 - The location of the FreeType shared library.
1.284 - See <a href="#freetype">FreeType information</a> for details.
1.285 - </dd>
1.286 - <dt><a name="ALT_FREETYPE_HEADERS_PATH"><tt>ALT_FREETYPE_HEADERS_PATH</tt></a></dt>
1.287 - <dd>
1.288 - The location of the FreeType header files.
1.289 - See <a href="#freetype">FreeType information</a> for details.
1.290 - </dd>
1.291 - <dt><a name="ALT_JDK_DEVTOOLS_PATH"><tt>ALT_JDK_DEVTOOLS_PATH</tt></a></dt>
1.292 - <dd>
1.293 - The default root location of the devtools.
1.294 - The default value is
1.295 - <tt>$(ALT_SLASH_JAVA)/devtools</tt>.
1.296 - </dd>
1.297 - <dt><tt><a name="ALT_DEVTOOLS_PATH">ALT_DEVTOOLS_PATH</a></tt> </dt>
1.298 - <dd>
1.299 - The location of tools like the
1.300 - <a href="#zip"><tt>zip</tt> and <tt>unzip</tt></a>
1.301 - binaries, but might also contain the GNU make utility
1.302 - (<tt><i>gmake</i></tt>).
1.303 - So this area is a bit of a grab bag, especially on Windows.
1.304 - The default value depends on the platform and
1.305 - Unix Commands being used.
1.306 - On Linux the default will be
1.307 - <tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>,
1.308 - on Solaris
1.309 - <tt>$(ALT_JDK_DEVTOOLS_PATH)/<i>{sparc,i386}</i>/bin</tt>,
1.310 - on Windows with MKS
1.311 - <tt>%SYSTEMDRIVE%/UTILS</tt>,
1.312 - and on Windows with CYGWIN
1.313 - <tt>/usr/bin</tt>.
1.314 - </dd>
1.315 - <dt><a name="ALT_UNIXCOMMAND_PATH"><tt>ALT_UNIXCOMMAND_PATH</tt></a> </dt>
1.316 - <dd>
1.317 - An override for specifying where the
1.318 - Unix command set are located.
1.319 - The default location varies depending on the platform,
1.320 - <tt>"%SYSTEMDRIVE%/MKSNT"</tt> or
1.321 - <tt>$(ROOTDIR)</tt> on Windows with MKS, otherwise it's
1.322 - <tt>"/bin"</tt> or <tt>/usr/bin</tt>.
1.323 - </dd>
1.324 - <dt><a name="ALT_UNIXCCS_PATH"><tt>ALT_UNIXCCS_PATH</tt></a></dt>
1.325 - <dd>
1.326 - <strong>Solaris only:</strong>
1.327 - An override for specifying where the Unix CCS
1.328 - command set are located.
1.329 - The default location is <tt>/usr/ccs/bin</tt>
1.330 - </dd>
1.331 - <dt><a name="ALT_USRBIN_PATH"><tt>ALT_USRBIN_PATH</tt></a></dt>
1.332 - <dd>
1.333 - An override for specifying where the
1.334 - Unix <tt>/usr/bin</tt> commands are located. You usually do not need
1.335 - to set this variable: the default location is <tt>/usr/bin</tt>)
1.336 - </dd>
1.337 - <dt><a name="ALT_SLASHJAVA"><tt>ALT_SLASHJAVA</tt></a></dt>
1.338 - <dd>
1.339 - The default root location for many of the ALT path locations
1.340 - of the following ALT variables.
1.341 - The default value is
1.342 - <tt>"/java"</tt> on Solaris and Linux,
1.343 - <tt>"J:"</tt> on Windows.
1.344 + These are useful in managing builds on multiple platforms.
1.345 + The default network location for all of the binary plug images
1.346 + for all platforms.
1.347 + If <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
1.348 + is not set, this directory will be used and should contain
1.349 + the following directories:
1.350 + <tt>solaris-sparc</tt>,
1.351 + <tt>solaris-i586</tt>,
1.352 + <tt>solaris-sparcv9</tt>,
1.353 + <tt>solaris-amd64</tt>,
1.354 + <tt>linux-i586</tt>,
1.355 + <tt>linux-amd64</tt>,
1.356 + <tt>windows-i586</tt>,
1.357 + and
1.358 + <tt>windows-amd64</tt>.
1.359 + Where each of these directories contain the binary plugs image
1.360 + for that platform.
1.361 </dd>
1.362 <dt><a name="ALT_BUILD_JDK_IMPORT_PATH"><tt>ALT_BUILD_JDK_IMPORT_PATH</tt></a></dt>
1.363 <dd>
1.364 @@ -1385,56 +1337,166 @@
1.365 Where each of these directories contain the import JDK image
1.366 for that platform.
1.367 </dd>
1.368 - <dt><a name="ALT_BUILD_BINARY_PLUGS_PATH"><tt>ALT_BUILD_BINARY_PLUGS_PATH</tt></a></dt>
1.369 + <dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt>
1.370 <dd>
1.371 - These are useful in managing builds on multiple platforms.
1.372 - The default network location for all of the binary plug images
1.373 - for all platforms.
1.374 - If <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
1.375 - is not set, this directory will be used and should contain
1.376 - the following directories:
1.377 - <tt>solaris-sparc</tt>,
1.378 - <tt>solaris-i586</tt>,
1.379 - <tt>solaris-sparcv9</tt>,
1.380 - <tt>solaris-amd64</tt>,
1.381 - <tt>linux-i586</tt>,
1.382 - <tt>linux-amd64</tt>,
1.383 - <tt>windows-i586</tt>,
1.384 - and
1.385 - <tt>windows-amd64</tt>.
1.386 - Where each of these directories contain the binary plugs image
1.387 - for that platform.
1.388 + The location of the <a href="#cacerts">cacerts</a> file.
1.389 + The default will refer to
1.390 + <tt>jdk/src/share/lib/security/cacerts</tt>.
1.391 </dd>
1.392 - <dt><strong>Windows specific:</strong></dt>
1.393 + <dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt>
1.394 <dd>
1.395 - <dl>
1.396 - <dt><a name="ALT_MSDEVTOOLS_PATH"><tt>ALT_MSDEVTOOLS_PATH</tt></a> </dt>
1.397 - <dd>
1.398 - The location of the Microsoft Visual Studio .NET 2003
1.399 - tools 'bin' directory.
1.400 - The default is usually derived from
1.401 - <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
1.402 - </dd>
1.403 - <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt>
1.404 - <dd>
1.405 - The location of the
1.406 - <a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
1.407 - The default will be to try and use the DirectX environment
1.408 - variable <tt>DXSDK_DIR</tt>,
1.409 - failing that, look in <tt>C:/DXSDK</tt>.
1.410 - </dd>
1.411 - <dt><tt><a name="ALT_MSVCRT_DLL_PATH">ALT_MSVCRT_DLL_PATH</a></tt> </dt>
1.412 - <dd>
1.413 - The location of the
1.414 - <a href="#msvcrt"><tt>MSVCRT.DLL</tt></a>.
1.415 - </dd>
1.416 - <dt><tt><a name="ALT_MSVCR71_DLL_PATH">ALT_MSVCR71_DLL_PATH</a></tt> </dt>
1.417 - <dd>
1.418 - <strong>i586 only:</strong>
1.419 - The location of the
1.420 - <a href="#msvcr71"><tt>MSVCR71.DLL</tt></a>.
1.421 - </dd>
1.422 - </dl>
1.423 + The location of the C/C++ compiler.
1.424 + The default varies depending on the platform.
1.425 + </dd>
1.426 + <dt><a name="ALT_CUPS_HEADERS_PATH"><tt>ALT_CUPS_HEADERS_PATH</tt></a> </dt>
1.427 + <dd>
1.428 + The location of the CUPS header files.
1.429 + See <a href="#cups">CUPS information</a> for more information.
1.430 + If this path does not exist the fallback path is
1.431 + <tt>/usr/include</tt>.
1.432 + </dd>
1.433 + <dt><tt><a name="ALT_DEVTOOLS_PATH">ALT_DEVTOOLS_PATH</a></tt> </dt>
1.434 + <dd>
1.435 + The location of tools like the
1.436 + <a href="#zip"><tt>zip</tt> and <tt>unzip</tt></a>
1.437 + binaries, but might also contain the GNU make utility
1.438 + (<tt><i>gmake</i></tt>).
1.439 + So this area is a bit of a grab bag, especially on Windows.
1.440 + The default value depends on the platform and
1.441 + Unix Commands being used.
1.442 + On Linux the default will be
1.443 + <tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>,
1.444 + on Solaris
1.445 + <tt>$(ALT_JDK_DEVTOOLS_PATH)/<i>{sparc,i386}</i>/bin</tt>,
1.446 + on Windows with MKS
1.447 + <tt>%SYSTEMDRIVE%/UTILS</tt>,
1.448 + and on Windows with CYGWIN
1.449 + <tt>/usr/bin</tt>.
1.450 + </dd>
1.451 + <dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt>
1.452 + <dd>
1.453 + <strong>Windows Only:</strong>
1.454 + The location of the
1.455 + <a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
1.456 + The default will be to try and use the DirectX environment
1.457 + variable <tt>DXSDK_DIR</tt>,
1.458 + failing that, look in <tt>C:/DXSDK</tt>.
1.459 + </dd>
1.460 + <dt><a name="ALT_FREETYPE_HEADERS_PATH"><tt>ALT_FREETYPE_HEADERS_PATH</tt></a></dt>
1.461 + <dd>
1.462 + The location of the FreeType header files.
1.463 + See <a href="#freetype">FreeType information</a> for details.
1.464 + </dd>
1.465 + <dt><a name="ALT_FREETYPE_LIB_PATH"><tt>ALT_FREETYPE_LIB_PATH</tt></a></dt>
1.466 + <dd>
1.467 + The location of the FreeType shared library.
1.468 + See <a href="#freetype">FreeType information</a> for details.
1.469 + </dd>
1.470 + <dt><a name="ALT_JDK_DEVTOOLS_PATH"><tt>ALT_JDK_DEVTOOLS_PATH</tt></a></dt>
1.471 + <dd>
1.472 + The default root location of the devtools.
1.473 + The default value is
1.474 + <tt>$(ALT_SLASH_JAVA)/devtools</tt>.
1.475 + </dd>
1.476 + <dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt>
1.477 + <dd>
1.478 + The location of a previously built JDK installation.
1.479 + See <a href="#importjdk">Optional Import JDK</a> for more information.
1.480 + </dd>
1.481 + <dt><a name="ALT_MSDEVTOOLS_PATH"><tt>ALT_MSDEVTOOLS_PATH</tt></a> </dt>
1.482 + <dd>
1.483 + <strong>Windows Only:</strong>
1.484 + The location of the Microsoft Visual Studio .NET 2003
1.485 + tools 'bin' directory.
1.486 + The default is usually derived from
1.487 + <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
1.488 + </dd>
1.489 + <dt><tt><a name="ALT_MSVCR71_DLL_PATH">ALT_MSVCR71_DLL_PATH</a></tt> </dt>
1.490 + <dd>
1.491 + <strong>Windows i586 only:</strong>
1.492 + The location of the
1.493 + <a href="#msvcr71"><tt>MSVCR71.DLL</tt></a>.
1.494 + </dd>
1.495 + <dt><tt><a name="ALT_MSVCRT_DLL_PATH">ALT_MSVCRT_DLL_PATH</a></tt> </dt>
1.496 + <dd>
1.497 + <strong>Windows Only:</strong>
1.498 + The location of the
1.499 + <a href="#msvcrt"><tt>MSVCRT.DLL</tt></a>.
1.500 + </dd>
1.501 + <dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt>
1.502 + <dd>
1.503 + An override for specifying the (absolute) path of where the
1.504 + build output is to go.
1.505 + The default output directory will be build/<i>platform</i>.
1.506 + </dd>
1.507 + <dt><a name="ALT_SLASHJAVA"><tt>ALT_SLASHJAVA</tt></a></dt>
1.508 + <dd>
1.509 + The default root location for many of the ALT path locations
1.510 + of the following ALT variables.
1.511 + The default value is
1.512 + <tt>"/java"</tt> on Solaris and Linux,
1.513 + <tt>"J:"</tt> on Windows.
1.514 + </dd>
1.515 + <dt><a name="ALT_UNIXCCS_PATH"><tt>ALT_UNIXCCS_PATH</tt></a></dt>
1.516 + <dd>
1.517 + <strong>Solaris only:</strong>
1.518 + An override for specifying where the Unix CCS
1.519 + command set are located.
1.520 + The default location is <tt>/usr/ccs/bin</tt>
1.521 + </dd>
1.522 + <dt><a name="ALT_UNIXCOMMAND_PATH"><tt>ALT_UNIXCOMMAND_PATH</tt></a> </dt>
1.523 + <dd>
1.524 + An override for specifying where the
1.525 + Unix command set are located.
1.526 + The default location varies depending on the platform,
1.527 + <tt>"%SYSTEMDRIVE%/MKSNT"</tt> or
1.528 + <tt>$(ROOTDIR)</tt> on Windows with MKS, otherwise it's
1.529 + <tt>"/bin"</tt> or <tt>/usr/bin</tt>.
1.530 + </dd>
1.531 + <dt><a name="ALT_USRBIN_PATH"><tt>ALT_USRBIN_PATH</tt></a></dt>
1.532 + <dd>
1.533 + An override for specifying where the
1.534 + Unix <tt>/usr/bin</tt> commands are located. You usually do not need
1.535 + to set this variable: the default location is <tt>/usr/bin</tt>)
1.536 + </dd>
1.537 + <dt><a name="ANT_HOME"><tt>ANT_HOME</tt></a></dt>
1.538 + <dd>
1.539 + The location of the Ant installation.
1.540 + See <a href="#ant">Ant</a> for more information.
1.541 + You should always set <tt>ANT_HOME</tt> explicitly.
1.542 + </dd>
1.543 + <dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt>
1.544 + <dd>The <tt>ARCH_DATA_MODEL</tt> variable
1.545 + is used to specify whether the build is to generate 32-bit or 64-bit
1.546 + binaries.
1.547 + The Solaris build supports either 32-bit or 64-bit builds, but
1.548 + Windows and Linux will support only one, depending on the specific
1.549 + OS being used.
1.550 + Normally, setting this variable is only necessary on Solaris.
1.551 + Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries,
1.552 + or to <tt>64</tt> for generating 64-bit binaries.
1.553 + </dd>
1.554 + <dt><tt>BUILD_NUMBER</tt> </dt>
1.555 + <dd>
1.556 + The build number for the build (<i>e.g.</i> "b27").
1.557 + The default value is "b00".
1.558 + </dd>
1.559 + <dt><tt>MILESTONE</tt> </dt>
1.560 + <dd>
1.561 + The milestone name for the build (<i>e.g.</i>"beta").
1.562 + The default value is "internal".
1.563 + </dd>
1.564 + <dt><a name="path"><tt>PATH</tt></a> </dt>
1.565 + <dd>Typically you want to set the <tt>PATH</tt> to include:
1.566 + <ul>
1.567 + <li>The location of the GNU make binary</li>
1.568 + <li>The location of the Bootstrap JDK <tt>java</tt>
1.569 + (see <a href="#bootjdk">Bootstrap JDK</a>)</li>
1.570 + <li>The location of the C/C++ compilers
1.571 + (see <a href="#compilers"><tt>compilers</tt></a>)</li>
1.572 + <li>The location or locations for the Unix command utilities
1.573 + (e.g. <tt>/usr/bin</tt>)</li>
1.574 + </ul>
1.575 </dd>
1.576 </dl>
1.577 </blockquote>
