diff --git a/README-builds.html b/README-builds.html
index a2cf768e122f8ce218b0c181666aef92e65b1f64..37998f9c1f67b57d58eca7ffa8c87e5f70da9595 100644
--- a/README-builds.html
+++ b/README-builds.html
@@ -5,15 +5,12 @@
-
+ +
-
-
-
+
|
@@ -54,6 +51,7 @@
Bootstrap JDK
Binary Plugs
Optional Import JDK
+ Ant
Certificate Authority File (cacert)
Compilers
@@ -424,24 +422,37 @@
you should use gmake
which will be located in either the /opt/sfw/bin or
/usr/sfw/bin directory.
+ In more recent versions of Solaris GNU make can be found
+ at /usr/bin/gmake.
Windows:
Make sure you start your build inside a bash/sh/ksh shell.
WARNING: Watch out for make version 3.81, it may
- not work due to a lack of support for drive letter paths
- like C:/. See
- section on gmake.
+ not work due to a lack of support for MS-DOS drive letter paths
+ like C:/ or C:\.
Use a 3.80 version, or find a newer
- version that has this problem fixed.
+ version that has this problem fixed, like 3.82.
The older 3.80 version of make.exe can be downloaded with this
link.
+ Use of this older 3.80 make.exe may require that you install the
+ libintl2.dll library or libintl2 cygwin package which is
+ no longer installed by default by the cygwin installer.
+
Also see the
mozilla developer center
on this topic.
+
+ It's hoped that when make 3.82 starts shipping in a future cygwin
+ release that this MS-DOS path issue will be fixed.
+ In addition to the above 3.80 make.exe you can download
+ this
+
+ www.cmake.org make.exe which will not have a libintl2.dll
+ dependency.
@@ -507,6 +518,11 @@
Install or upgrade the FreeType development
package.
+
+ Install
+ Ant, set
+ ANT_HOME.
+
@@ -567,6 +583,11 @@
CUPS Include files, set
ALT_CUPS_HEADERS_PATH.
+
+ Install
+ Ant, set
+ ANT_HOME.
+
@@ -654,6 +675,11 @@
Install
Microsoft DirectX SDK.
+
+ Install
+ Ant, set
+ ANT_HOME.
+
@@ -736,6 +762,22 @@
and the build will copy the needed files from this import area.
+
+
+ All OpenJDK builds require access to least Ant 1.6.5.
+ The Ant tool is available from the
+
+ Ant download site.
+ You should always set
+ ANT_HOME
+ to point to the location of
+ the Ant installation, this is the directory pathname
+ that contains a bin and lib.
+ It's also a good idea to also place its bin directory
+ in the PATH environment variable, although it's
+ not absolutely required.
+
+
See
@@ -915,6 +957,21 @@
and
ALT_FREETYPE_HEADERS_PATH
to refer to place where library and header files are installed.
+
+ Building the freetype 2 libraries from scratch is also possible,
+ however on Windows refer to the
+
+ Windows FreeType DLL build instructions.
+
+ Note that by default FreeType is built with byte code hinting
+ support disabled due to licensing restrictions.
+ In this case, text appearance and metrics are expected to
+ differ from Sun's official JDK build.
+ See
+
+ the SourceForge FreeType2 Home Page
+
+ for more information.
@@ -1036,7 +1093,8 @@
make.exe |
Devel |
- make: The GNU version of the 'make' utility |
+ make: The GNU version of the 'make' utility
+ NOTE: See the GNU make section |
m4.exe |
@@ -1050,7 +1108,7 @@
cpio: A program to manage archives of files |
- awk.exe |
+ gawk.exe |
Utils |
awk: Pattern-directed scanning and processing language |
@@ -1061,17 +1119,17 @@
zip.exe |
- Utils |
+ Archive |
zip: Package and compress (archive) files |
unzip.exe |
- Utils |
+ Archive |
unzip: Extract compressed files in a ZIP archive |
free.exe |
- Utils |
+ Procps |
free: Display amount of free and used memory in the system |
@@ -1224,46 +1282,6 @@
document) that can impact the build are:
- - PATH
- - Typically you want to set the PATH to include:
-
- - The location of the GNU make binary
- - The location of the Bootstrap JDK java
- (see Bootstrap JDK)
- - The location of the C/C++ compilers
- (see compilers)
- - The location or locations for the Unix command utilities
- (e.g. /usr/bin)
-
-
- - MILESTONE
- -
- The milestone name for the build (e.g."beta").
- The default value is "internal".
-
- - BUILD_NUMBER
- -
- The build number for the build (e.g. "b27").
- The default value is "b00".
-
- - ARCH_DATA_MODEL
- - The ARCH_DATA_MODEL 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 ARCH_DATA_MODEL to 32 for generating 32-bit binaries,
- or to 64 for generating 64-bit binaries.
-
- - ALT_BOOTDIR
- -
- The location of the bootstrap JDK installation.
- See Bootstrap JDK for more information.
- You should always install your own local Bootstrap JDK and
- always set ALT_BOOTDIR explicitly.
-
- ALT_BINARY_PLUGS_PATH
-
The location of the binary plugs installation.
@@ -1272,21 +1290,52 @@
recent Binary Plugs install image
and set this variable to that location.
- - ALT_JDK_IMPORT_PATH
+ - ALT_BOOTDIR
-
- The location of a previously built JDK installation.
- See Optional Import JDK for more information.
+ The location of the bootstrap JDK installation.
+ See Bootstrap JDK for more information.
+ You should always install your own local Bootstrap JDK and
+ always set ALT_BOOTDIR explicitly.
- - ALT_OUTPUTDIR
+ - ALT_BUILD_BINARY_PLUGS_PATH
-
- An override for specifying the (absolute) path of where the
- build output is to go.
- The default output directory will be build/platform.
+ These are useful in managing builds on multiple platforms.
+ The default network location for all of the binary plug images
+ for all platforms.
+ If ALT_BINARY_PLUGS_PATH
+ is not set, this directory will be used and should contain
+ the following directories:
+ solaris-sparc,
+ solaris-i586,
+ solaris-sparcv9,
+ solaris-amd64,
+ linux-i586,
+ linux-amd64,
+ windows-i586,
+ and
+ windows-amd64.
+ Where each of these directories contain the binary plugs image
+ for that platform.
- - ALT_COMPILER_PATH
+ - ALT_BUILD_JDK_IMPORT_PATH
-
- The location of the C/C++ compiler.
- The default varies depending on the platform.
+ These are useful in managing builds on multiple platforms.
+ The default network location for all of the import JDK images
+ for all platforms.
+ If ALT_JDK_IMPORT_PATH
+ is not set, this directory will be used and should contain
+ the following directories:
+ solaris-sparc,
+ solaris-i586,
+ solaris-sparcv9,
+ solaris-amd64,
+ linux-i586,
+ linux-amd64,
+ windows-i586,
+ and
+ windows-amd64.
+ Where each of these directories contain the import JDK image
+ for that platform.
- ALT_CACERTS_FILE
-
@@ -1294,6 +1343,11 @@
The default will refer to
jdk/src/share/lib/security/cacerts.
+ - ALT_COMPILER_PATH
+ -
+ The location of the C/C++ compiler.
+ The default varies depending on the platform.
+
- ALT_CUPS_HEADERS_PATH
-
The location of the CUPS header files.
@@ -1301,22 +1355,6 @@
If this path does not exist the fallback path is
/usr/include.
- - ALT_FREETYPE_LIB_PATH
- -
- The location of the FreeType shared library.
- See FreeType information for details.
-
- - ALT_FREETYPE_HEADERS_PATH
- -
- The location of the FreeType header files.
- See FreeType information for details.
-
- - ALT_JDK_DEVTOOLS_PATH
- -
- The default root location of the devtools.
- The default value is
- $(ALT_SLASH_JAVA)/devtools.
-
- ALT_DEVTOOLS_PATH
-
The location of tools like the
@@ -1335,14 +1373,69 @@
and on Windows with CYGWIN
/usr/bin.
- - ALT_UNIXCOMMAND_PATH
+ - ALT_DXSDK_PATH
-
- An override for specifying where the
- Unix command set are located.
- The default location varies depending on the platform,
- "%SYSTEMDRIVE%/MKSNT" or
- $(ROOTDIR) on Windows with MKS, otherwise it's
- "/bin" or /usr/bin.
+ Windows Only:
+ The location of the
+ Microsoft DirectX 9 SDK.
+ The default will be to try and use the DirectX environment
+ variable DXSDK_DIR,
+ failing that, look in C:/DXSDK.
+
+ - ALT_FREETYPE_HEADERS_PATH
+ -
+ The location of the FreeType header files.
+ See FreeType information for details.
+
+ - ALT_FREETYPE_LIB_PATH
+ -
+ The location of the FreeType shared library.
+ See FreeType information for details.
+
+ - ALT_JDK_DEVTOOLS_PATH
+ -
+ The default root location of the devtools.
+ The default value is
+ $(ALT_SLASH_JAVA)/devtools.
+
+ - ALT_JDK_IMPORT_PATH
+ -
+ The location of a previously built JDK installation.
+ See Optional Import JDK for more information.
+
+ - ALT_MSDEVTOOLS_PATH
+ -
+ Windows Only:
+ The location of the Microsoft Visual Studio .NET 2003
+ tools 'bin' directory.
+ The default is usually derived from
+ ALT_COMPILER_PATH.
+
+ - ALT_MSVCR71_DLL_PATH
+ -
+ Windows i586 only:
+ The location of the
+ MSVCR71.DLL.
+
+ - ALT_MSVCRT_DLL_PATH
+ -
+ Windows Only:
+ The location of the
+ MSVCRT.DLL.
+
+ - ALT_OUTPUTDIR
+ -
+ An override for specifying the (absolute) path of where the
+ build output is to go.
+ The default output directory will be build/platform.
+
+ - ALT_SLASHJAVA
+ -
+ The default root location for many of the ALT path locations
+ of the following ALT variables.
+ The default value is
+ "/java" on Solaris and Linux,
+ "J:" on Windows.
- ALT_UNIXCCS_PATH
-
@@ -1351,90 +1444,59 @@
command set are located.
The default location is /usr/ccs/bin
+ - ALT_UNIXCOMMAND_PATH
+ -
+ An override for specifying where the
+ Unix command set are located.
+ The default location varies depending on the platform,
+ "%SYSTEMDRIVE%/MKSNT" or
+ $(ROOTDIR) on Windows with MKS, otherwise it's
+ "/bin" or /usr/bin.
+
- ALT_USRBIN_PATH
-
An override for specifying where the
Unix /usr/bin commands are located. You usually do not need
to set this variable: the default location is /usr/bin)
- - ALT_SLASHJAVA
+ - ANT_HOME
-
- The default root location for many of the ALT path locations
- of the following ALT variables.
- The default value is
- "/java" on Solaris and Linux,
- "J:" on Windows.
+ The location of the Ant installation.
+ See Ant for more information.
+ You should always set ANT_HOME explicitly.
- - ALT_BUILD_JDK_IMPORT_PATH
- -
- These are useful in managing builds on multiple platforms.
- The default network location for all of the import JDK images
- for all platforms.
- If ALT_JDK_IMPORT_PATH
- is not set, this directory will be used and should contain
- the following directories:
- solaris-sparc,
- solaris-i586,
- solaris-sparcv9,
- solaris-amd64,
- linux-i586,
- linux-amd64,
- windows-i586,
- and
- windows-amd64.
- Where each of these directories contain the import JDK image
- for that platform.
+
- ARCH_DATA_MODEL
+ - The ARCH_DATA_MODEL 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 ARCH_DATA_MODEL to 32 for generating 32-bit binaries,
+ or to 64 for generating 64-bit binaries.
- - ALT_BUILD_BINARY_PLUGS_PATH
+ - BUILD_NUMBER
-
- These are useful in managing builds on multiple platforms.
- The default network location for all of the binary plug images
- for all platforms.
- If ALT_BINARY_PLUGS_PATH
- is not set, this directory will be used and should contain
- the following directories:
- solaris-sparc,
- solaris-i586,
- solaris-sparcv9,
- solaris-amd64,
- linux-i586,
- linux-amd64,
- windows-i586,
- and
- windows-amd64.
- Where each of these directories contain the binary plugs image
- for that platform.
+ The build number for the build (e.g. "b27").
+ The default value is "b00".
- - Windows specific:
+ - MILESTONE
-
-
- - ALT_MSDEVTOOLS_PATH
- -
- The location of the Microsoft Visual Studio .NET 2003
- tools 'bin' directory.
- The default is usually derived from
- ALT_COMPILER_PATH.
-
- - ALT_DXSDK_PATH
- -
- The location of the
- Microsoft DirectX 9 SDK.
- The default will be to try and use the DirectX environment
- variable DXSDK_DIR,
- failing that, look in C:/DXSDK.
-
- - ALT_MSVCRT_DLL_PATH
- -
- The location of the
- MSVCRT.DLL.
-
- - ALT_MSVCR71_DLL_PATH
- -
- i586 only:
- The location of the
- MSVCR71.DLL.
-
-
+ The milestone name for the build (e.g."beta").
+ The default value is "internal".
+
+ - PATH
+ - Typically you want to set the PATH to include:
+
+ - The location of the GNU make binary
+ - The location of the Bootstrap JDK java
+ (see Bootstrap JDK)
+ - The location of the C/C++ compilers
+ (see compilers)
+ - The location or locations for the Unix command utilities
+ (e.g. /usr/bin)
+