Wed, 09 Jul 2008 15:42:00 -0700
6704966: OpenJDK README needs additional info on how to build freetype
6704968: OpenJDK Build README is missing ant requirement
6704973: OpenJDK Build readme needs cygwin package list improvements
6590549: Cygwin build of OpenJDK has problems and not very well documented
6462815: cygwin's gnumake 3.81-1 does not support MS-DOS path names
6597857: JDK build instructions need to be updated (BUILD_JDK_IMPORT_PATH, BUILD_BINARY_PLUGS_PATH)
Reviewed-by: jjg, igor
README-builds.html | file | annotate | diff | comparison | revisions |
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>