jdk-sandbox: README-builds.html@a4e6aa1f45ad (annotated)

0 fd16c54261b3 Initial load duke parents: diff changeset	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
fd16c54261b3 Initial load duke parents: diff changeset	2	<html>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	3	<head>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	4	<title>OpenJDK Build README</title>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	5	</head>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	6	<body style="background-color:lightcyan">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	7	<!-- ====================================================== -->
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	8	<table width="100%">
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	9	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	10	<td align="center">
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	11	<img alt="OpenJDK"
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	12	src="http://openjdk.java.net/images/openjdk.png"
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	13	width=256 />
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	14	</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	15	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	16	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	17	<td align=center>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	18	<h1>OpenJDK Build README</h1>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	19	</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	20	</tr>
0 fd16c54261b3 Initial load duke parents: diff changeset	21	</table>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	22	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	23	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	24	<h2><a name="introduction">Introduction</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	25	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	26	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	27	This README file contains build instructions for the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	28	<a href="http://openjdk.java.net" target="_blank">OpenJDK</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	29	Building the source code for the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	30	OpenJDK
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	31	requires
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	32	a certain degree of technical expertise.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	33	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	34	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	35	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	36	<h2><a name="contents">Contents</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	37	<blockquote>
0 fd16c54261b3 Initial load duke parents: diff changeset	38	<ul>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	39	<li><a href="#introduction">Introduction</a></li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	40	<li><a href="#MBE">Minimum Build Environments</a></li>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	41	<li><a href="#SDBE">Specific Developer Build Environments</a>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	42	<ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	43	<li><a href="#fedora">Fedora Linux</a> </li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	44	<li><a href="#centos">CentOS Linux</a> </li>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	45	<li><a href="#debian">Debian GNU/Linux</a></li>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	46	<li><a href="#ubuntu">Ubuntu Linux</a> </li>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	47	<li><a href="#opensuse">OpenSUSE</a></li>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	48	<li><a href="#mandriva">Mandriva</a></li>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	49	<li><a href="#opensolaris">OpenSolaris</a></li>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	50	</ul>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	51	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	52	<li><a href="#directories">Source Directory Structure</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	53	<li><a href="#building">Build Information</a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	54	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	55	<li><a href="#gmake">GNU Make (<tt><i>gmake</i></tt>)</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	56	<li><a href="#linux">Basic Linux System Setup</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	57	<li><a href="#solaris">Basic Solaris System Setup</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	58	<li><a href="#windows">Basic Windows System Setup</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	59	<li><a href="#dependencies">Build Dependencies</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	60	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	61	<li><a href="#bootjdk">Bootstrap JDK</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	62	<li><a href="#binaryplugs">Binary Plugs</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	63	<li><a href="#importjdk">Optional Import JDK</a> </li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	64	<li><a href="#ant">Ant</a> </li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	65	<li><a href="#cacerts">Certificate Authority File (cacert)</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	66	<li><a href="#compilers">Compilers</a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	67	<ul>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	68	<li><a href="#msvc32">Microsoft Visual Studio Professional/Express for 32 bit</a> </li>
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	69	<li><a href="#msvc64">Microsoft Visual Studio Professional for 64 bit</a> </li>
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	70	<li><a href="#mssdk64">Microsoft Windows SDK for 64 bit</a> </li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	71	<li><a href="#gcc">Linux gcc/binutils</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	72	<li><a href="#studio">Sun Studio</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	73	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	74	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	75	<li><a href="#zip">Zip and Unzip</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	76	<li><a href="#freetype">FreeType2 Fonts</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	77	<li>Linux and Solaris:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	78	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	79	<li><a href="#cups">CUPS Include files</a> </li>
2908 6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	80	<li><a href="#xrender">XRender Include files</a></li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	81	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	82	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	83	<li>Linux only:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	84	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	85	<li><a href="#alsa">ALSA files</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	86	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	87	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	88	<li>Windows only:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	89	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	90	<li>Unix Command Tools (<a href="#cygwin">CYGWIN</a>)</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	91	<li><a href="#dxsdk">DirectX 9.0 SDK</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	92	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	93	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	94	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	95	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	96	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	97	<li><a href="#creating">Creating the Build</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	98	<li><a href="#testing">Testing the Build</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	99	<li><a href="#variables">Environment/Make Variables</a></li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	100	<li><a href="#troubleshooting">Troubleshooting</a></li>
0 fd16c54261b3 Initial load duke parents: diff changeset	101	</ul>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	102	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	103	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	104	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	105	<h2><a name="MBE">Minimum Build Environments</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	106	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	107	This file often describes specific requirements for what we call the
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	108	"minimum build environments" (MBE) for this
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	109	specific release of the JDK,
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	110	Building with the MBE will generate the most compatible
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	111	bits that install on, and run correctly on, the most variations
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	112	of the same base OS and hardware architecture.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	113	These usually represent what is often called the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	114	least common denominator platforms.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	115	It is understood that most developers will NOT be using these
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	116	specific platforms, and in fact creating these specific platforms
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	117	may be difficult due to the age of some of this software.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	118	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	119	The minimum OS and C/C++ compiler versions needed for building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	120	OpenJDK:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	121	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	122	<table border="1">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	123	<thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	124	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	125	<th>Base OS and Architecture</th>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	126	<th>OS</th>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	127	<th>C/C++ Compiler</th>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	128	<th>BOOT JDK</th>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	129	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	130	</thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	131	<tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	132	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	133	<td>Linux X86 (32-bit)</td>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	134	<td>Fedora 9</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	135	<td>gcc 4 </td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	136	<td>JDK 6u14 FCS </td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	137	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	138	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	139	<td>Linux X64 (64-bit)</td>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	140	<td>Fedora 9</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	141	<td>gcc 4 </td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	142	<td>JDK 6u14 FCS </td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	143	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	144	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	145	<td>Solaris SPARC (32-bit)</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	146	<td>Solaris 10u2 + patches
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	147	<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	148	See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	149	SunSolve</a> for patch downloads.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	150	</td>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	151	<td>Sun Studio 12 Update 1 + patches</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	152	<td>JDK 6u14 FCS </td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	153	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	154	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	155	<td>Solaris SPARCV9 (64-bit)</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	156	<td>Solaris 10u2 + patches
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	157	<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	158	See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	159	SunSolve</a> for patch downloads.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	160	</td>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	161	<td>Sun Studio 12 Update 1 + patches</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	162	<td>JDK 6u14 FCS </td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	163	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	164	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	165	<td>Solaris X86 (32-bit)</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	166	<td>Solaris 10u2 + patches
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	167	<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	168	See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	169	SunSolve</a> for patch downloads.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	170	</td>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	171	<td>Sun Studio 12 Update 1 + patches</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	172	<td>JDK 6u14 FCS </td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	173	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	174	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	175	<td>Solaris X64 (64-bit)</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	176	<td>Solaris 10u2 + patches
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	177	<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	178	See <a href="http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/JavaSE" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	179	SunSolve</a> for patch downloads.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	180	</td>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	181	<td>Sun Studio 12 Update 1 + patches</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	182	<td>JDK 6u14 FCS </td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	183	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	184	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	185	<td>Windows X86 (32-bit)</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	186	<td>Windows XP</td>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	187	<td>Microsoft Visual Studio C++ 2010 Professional Edition</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	188	<td>JDK 6u14 FCS </td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	189	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	190	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	191	<td>Windows X64 (64-bit)</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	192	<td>Windows Server 2003 - Enterprise x64 Edition</td>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	193	<td>Microsoft Visual Studio C++ 2010 Professional Edition</td>
3165 0fa59fd2b694 6853596: Update Build README-build.html with new info regarding update for Solaris 10u2 and BOOTDIR update xdono parents: 2557 diff changeset	194	<td>JDK 6u14 FCS </td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	195	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	196	</tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	197	</table>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	198	<p>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	199	These same sources do indeed build on many more systems than the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	200	above older generation systems, again the above is just a minimum.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	201	<p>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	202	Compilation problems with newer or different C/C++ compilers is a
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	203	common problem.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	204	Similarly, compilation problems related to changes to the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	205	<tt>/usr/include</tt> or system header files is also a
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	206	common problem with newer or unreleased OS versions.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	207	Please report these types of problems as bugs so that they
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	208	can be dealt with accordingly.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	209	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	210	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	211	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	212	<h2><a name="SDBE">Specific Developer Build Environments</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	213	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	214	We won't be listing all the possible environments, but
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	215	we will try to provide what information we have available to us.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	216	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	217	<!-- ------------------------------------------------------ -->
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	218	<h3><a name="fedora">Fedora</a></h3>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	219	<blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	220	<h4>Fedora 9</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	221	<p>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	222	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	223	After installing <a href="http://fedoraproject.org">Fedora</a> 9
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	224	you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	225	way to do it is to execute the following commands as user
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	226	<tt>root</tt>:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	227	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	228	<code>yum-builddep java-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	229	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	230	<code>yum install gcc gcc-c++</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	231	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	232	In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	233
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	234	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	235	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-openjdk</code>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	236	</blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	237	<h4>Fedora 10</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	238	<p>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	239	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	240	After installing <a href="http://fedoraproject.org">Fedora</a> 10
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	241	you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	242	way to do it is to execute the following commands as user
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	243	<tt>root</tt>:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	244	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	245	<code>yum-builddep java-1.6.0-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	246	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	247	<code>yum install gcc gcc-c++</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	248	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	249	In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	250
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	251	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	252	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	253	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	254	<h4>Fedora 11</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	255	<p>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	256	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	257	After installing <a href="http://fedoraproject.org">Fedora</a> 11
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	258	you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	259	way to do it is to execute the following commands as user
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	260	<tt>root</tt>:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	261	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	262	<code>yum-builddep java-1.6.0-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	263	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	264	<code>yum install gcc gcc-c++</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	265	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	266	In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	267
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	268	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	269	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	270	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	271	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	272	<!-- ------------------------------------------------------ -->
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	273	<h3><a name="centos">CentOS 5.2</a></h3>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	274	<blockquote>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	275	After installing
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	276	<a href="http://www.centos.org/">CentOS 5.2</a>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	277	you need to make sure you have
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	278	the following Development bundles installed:
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	279	<blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	280	<ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	281	<li>Development Libraries</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	282	<li>Development Tools</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	283	<li>Java Development</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	284	<li>X Software Development</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	285	</ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	286	</blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	287	<p>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	288	Plus the following packages:
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	289	<blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	290	<ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	291	<li>cups devel: Cups Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	292	<li>alsa devel: Alsa Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	293	<li>ant: Ant Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	294	<li>Xi devel: libXi.so Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	295	</ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	296	</blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	297	<p>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	298	The freetype 2.3 packages don't seem to be available,
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	299	but the freetype 2.3 sources can be downloaded, built,
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	300	and installed easily enough from
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	301	<a href="http://downloads.sourceforge.net/freetype">
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	302	the freetype site</a>.
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	303	Build and install with something like:
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	304	<blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	305	<tt>./configure && make && sudo -u root make install</tt>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	306	</blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	307	<p>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	308	Mercurial packages could not be found easily, but a Google
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	309	search should find ones, and they usually include Python if
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	310	it's needed.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	311	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	312	<!-- ------------------------------------------------------ -->
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	313	<h3><a name="debian">Debian</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	314	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	315	<h4>Debian 5.0 (Lenny)</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	316	<p>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	317	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	318	After installing <a href="http://debian.org">Debian</a> 5
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	319	you need to install several build dependencies.
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	320	The simplest way to install the build dependencies is to
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	321	execute the following commands as user <tt>root</tt>:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	322	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	323	<code>aptitude build-dep openjdk-6</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	324	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	325	<code>aptitude install openjdk-6-jdk libmotif-dev</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	326	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	327	In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	328	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	329	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	330	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	331	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	332	<!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	333	<h3><a name="ubuntu">Ubuntu</a></h3>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	334	<blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	335	<h4>Ubuntu 8.04</h4>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	336	<p>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	337	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	338	After installing <a href="http://ubuntu.org">Ubuntu</a> 8.04
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	339	you need to install several build dependencies.
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	340	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	341	First, you need to enable the universe repository in the
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	342	Software Sources application and reload the repository
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	343	information. The Software Sources application is available
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	344	under the System/Administration menu.
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	345	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	346	The simplest way to install the build dependencies is to
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	347	execute the following commands:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	348	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	349	<code>sudo aptitude build-dep openjdk-6</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	350	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	351	<code>sudo aptitude install openjdk-6-jdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	352	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	353	In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	354	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	355	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	356	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	357	<h4>Ubuntu 8.10</h4>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	358	<p>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	359	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	360	After installing <a href="http://ubuntu.org">Ubuntu</a> 8.10
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	361	you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	362	way to do it is to execute the following commands:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	363	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	364	<code>sudo aptitude build-dep openjdk-6</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	365	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	366	<code>sudo aptitude install openjdk-6-jdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	367	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	368	In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	369	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	370	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	371	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	372	<h4>Ubuntu 9.04</h4>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	373	<p>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	374	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	375	After installing <a href="http://ubuntu.org">Ubuntu</a> 9.04
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	376	you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	377	way to do it is to execute the following commands:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	378	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	379	<code>sudo aptitude build-dep openjdk-6</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	380	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	381	<code>sudo aptitude install openjdk-6-jdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	382	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	383	In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	384	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	385	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	386	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	387	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	388	<!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	389	<h3><a name="opensuse">OpenSUSE</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	390	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	391	<h4>OpenSUSE 11.1</h4>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	392	<p>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	393	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	394	After installing <a href="http://opensuse.org">OpenSUSE</a> 11.1
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	395	you need to install several build dependencies.
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	396	The simplest way to install the build dependencies is to
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	397	execute the following commands:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	398	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	399	<code>sudo zypper source-install -d java-1_6_0-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	400	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	401	<code>sudo zypper install make</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	402	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	403	In addition, it is necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	404	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	405	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-1.6.0-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	406	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	407	Finally, you need to unset the <code>JAVA_HOME</code> environment variable:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	408	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	409	<code>export -n JAVA_HOME</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	410	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	411	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	412	<!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	413	<h3><a name="mandriva">Mandriva</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	414	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	415	<h4>Mandriva Linux One 2009 Spring</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	416	<p>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	417	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	418	After installing <a href="http://mandriva.org">Mandriva</a> Linux One 2009 Spring
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	419	you need to install several build dependencies.
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	420	The simplest way to install the build dependencies is to
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	421	execute the following commands as user <tt>root</tt>:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	422	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	423	<code>urpmi java-1.6.0-openjdk-devel ant make gcc gcc-c++ freetype-devel zip unzip libcups2-devel libxrender1-devel libalsa2-devel libstc++-static-devel libxtst6-devel libxi-devel</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	424	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	425	In addition, it is necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	426	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	427	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-1.6.0-openjdk</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	428	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	429	</blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	430	<!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	431	<h3><a name="opensolaris">OpenSolaris</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	432	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	433	<h4>OpenSolaris 2009.06</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	434	<p>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	435	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	436	After installing <a href="http://opensolaris.org">OpenSolaris</a> 2009.06
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	437	you need to install several build dependencies.
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	438	The simplest way to install the build dependencies is to
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	439	execute the following commands:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	440	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	441	<code>pfexec pkg install SUNWgmake SUNWj6dev SUNWant sunstudioexpress SUNWcups SUNWzip SUNWunzip SUNWxwhl SUNWxorg-headers SUNWaudh SUNWfreetype2</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	442	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	443	In addition, it is necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	444	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	445	<code>export LANG=C ALT_COMPILER_PATH=/opt/SunStudioExpress/bin/ ALT_CUPS_HEADERS_PATH=/usr/include/</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	446	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	447	Finally, you need to make sure that the build process can find the Sun Studio compilers:
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	448	<p/>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	449	<code>export PATH=$PATH:/opt/SunStudioExpress/bin/</code>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	450	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	451	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	452	<!-- ------------------------------------------------------ -->
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	453	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	454	<h2><a name="directories">Source Directory Structure</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	455	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	456	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	457	The source code for the OpenJDK is delivered in a set of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	458	directories:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	459	<tt>hotspot</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	460	<tt>langtools</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	461	<tt>corba</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	462	<tt>jaxws</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	463	<tt>jaxp</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	464	and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	465	<tt>jdk</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	466	The <tt>hotspot</tt> directory contains the source code and make
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	467	files for building the OpenJDK Hotspot Virtual Machine.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	468	The <tt>langtools</tt> directory contains the source code and make
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	469	files for building the OpenJDK javac and language tools.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	470	The <tt>corba</tt> directory contains the source code and make
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	471	files for building the OpenJDK Corba files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	472	The <tt>jaxws</tt> directory contains the source code and make
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	473	files for building the OpenJDK JAXWS files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	474	The <tt>jaxp</tt> directory contains the source code and make
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	475	files for building the OpenJDK JAXP files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	476	The <tt>jdk</tt> directory contains the source code and make files for
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	477	building the OpenJDK runtime libraries and misc files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	478	The top level <tt>Makefile</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	479	is used to build the entire OpenJDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	480	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	481	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	482	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	483	<h2><a name="building">Build Information</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	484	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	485	Building the OpenJDK
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	486	is done with a <tt><i>gmake</i></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	487	command line and various
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	488	environment or make variable settings that direct the make rules
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	489	to where various components have been installed.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	490	Where possible the makefiles will attempt to located the various
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	491	components in the default locations or any component specific
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	492	variable settings.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	493	When the normal defaults fail or components cannot be found,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	494	the various
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	495	<tt>ALT_*</tt> variables (alternates)
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	496	can be used to help the makefiles locate components.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	497	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	498	Refer to the bash/sh/ksh setup file
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	499	<tt>jdk/make/jdk_generic_profile.sh</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	500	if you need help in setting up your environment variables.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	501	A build could be as simple as:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	502	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	503	<pre><tt>
0 fd16c54261b3 Initial load duke parents: diff changeset	504	bash
fd16c54261b3 Initial load duke parents: diff changeset	505	. jdk/make/jdk_generic_profile.sh
fd16c54261b3 Initial load duke parents: diff changeset	506	<i>gmake</i> sanity && <i>gmake</i>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	507	</tt></pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	508	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	509	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	510	Of course ksh or sh would work too.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	511	But some customization will probably be necessary.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	512	The <tt>sanity</tt> rule will make some basic checks on build
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	513	dependencies and generate appropriate warning messages
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	514	regarding missing, out of date, or newer than expected components
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	515	found on your system.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	516	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	517	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	518	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	519	<h3><a name="gmake">GNU make (<tt><i>gmake</i></tt>)</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	520	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	521	The Makefiles in the OpenJDK are only valid when used with the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	522	GNU version of the utility command <tt>make</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	523	(<tt><i>gmake</i></tt>).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	524	A few notes about using GNU make:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	525	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	526	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	527	In general, you need GNU make version 3.78.1 or newer.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	528	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	529	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	530	Place the location of the GNU make binary in the <tt>PATH</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	531	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	532	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	533	<strong>Linux:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	534	The <tt>/usr/bin/make</tt> command should work fine for you.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	535	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	536	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	537	<strong>Solaris:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	538	Do NOT use <tt>/usr/bin/make</tt> on Solaris.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	539	If your Solaris system has the software
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	540	from the Solaris Companion CD installed,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	541	you should use <tt>gmake</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	542	which will be located in either the <tt>/opt/sfw/bin</tt> or
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	543	<tt>/usr/sfw/bin</tt> directory.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	544	In more recent versions of Solaris GNU make can be found
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	545	at <tt>/usr/bin/gmake</tt>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	546	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	547	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	548	<strong>Windows:</strong>
4084 ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin ohair parents: 3793 diff changeset	549	Make sure you start your build inside a bash/sh/ksh shell
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin ohair parents: 3793 diff changeset	550	and are using a <tt>make.exe</tt> utility built for that
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin ohair parents: 3793 diff changeset	551	environment (a cygwin <tt>make.exe</tt> is not the same
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin ohair parents: 3793 diff changeset	552	as a <tt>make.exe</tt> built for something like
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin ohair parents: 3793 diff changeset	553	<a href="http://www.mkssoftware.com/">MKS</a>).
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	554	<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	555	<b>WARNING:</b> Watch out for make version 3.81, it may
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	556	not work due to a lack of support for MS-DOS drive letter paths
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	557	like <tt>C:/</tt> or <tt>C:\</tt>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	558	Use a 3.80 version, or find a newer
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	559	version that has this problem fixed.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	560	The older 3.80 version of make.exe can be downloaded with this
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	561	<a href="http://cygwin.paracoda.com/release/make/make-3.80-1.tar.bz2" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	562	link</a>.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	563	Use of this older 3.80 make.exe may require that you install the
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	564	libintl2.dll library or libintl2 cygwin package which is
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	565	no longer installed by default by the cygwin installer.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	566	<br>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	567	Also see the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	568	<a href="http://developer.mozilla.org/en/docs/Windows_build_prerequisites_using_cygwin#make" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	569	mozilla developer center</a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	570	on this topic.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	571	<br>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	572	It's hoped that when make 3.82 starts shipping in a future cygwin
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	573	release that this MS-DOS path issue will be fixed.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	574	In addition to the above 3.80 make.exe you can download
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	575	this
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	576	<a href="http://www.cmake.org/files/cygwin/make.exe">
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	577	www.cmake.org make.exe</a> which will not have a libintl2.dll
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	578	dependency.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	579	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	580	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	581	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	582	Information on GNU make, and access to ftp download sites, are
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	583	available on the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	584	<a href="http://www.gnu.org/software/make/make.html" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	585	GNU make web site
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	586	</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	587	The latest source to GNU make is available at
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	588	<a href="http://ftp.gnu.org/pub/gnu/make/" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	589	ftp.gnu.org/pub/gnu/make/</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	590	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	591	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	592	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	593	<h3><a name="linux">Basic Linux System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	594	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	595	<strong>i586 only:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	596	The minimum recommended hardware for building the Linux version
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	597	is a Pentium class processor or better, at least 256 MB of RAM, and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	598	approximately 1.5 GB of free disk space.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	599	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	600	<strong>X64 only:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	601	The minimum recommended hardware for building the Linux
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	602	version is an AMD Opteron class processor, at least 512 MB of RAM, and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	603	approximately 4 GB of free disk space.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	604	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	605	The build will use the tools contained in
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	606	<tt>/bin</tt> and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	607	<tt>/usr/bin</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	608	of a standard installation of the Linux operating environment.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	609	You should ensure that these directories are in your
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	610	<tt>PATH</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	611	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	612	Note that some Linux systems have a habit of pre-populating
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	613	your environment variables for you, for example <tt>JAVA_HOME</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	614	might get pre-defined for you to refer to the JDK installed on
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	615	your Linux system.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	616	You will need to unset <tt>JAVA_HOME</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	617	It's a good idea to run <tt>env</tt> and verify the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	618	environment variables you are getting from the default system
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	619	settings make sense for building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	620	OpenJDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	621	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	622	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	623	<h4><a name="linux_checklist">Basic Linux Check List</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	624	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	625	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	626	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	627	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	628	<a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	629	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	630	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	631	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	632	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	633	<a href="#binaryplugs">Binary Plugs</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	634	<tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	635	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	636	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	637	<a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	638	<tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	639	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	640	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	641	Install or upgrade the <a href="#freetype">FreeType development
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	642	package</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	643	</li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	644	<li>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	645	Install
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	646	<a href="#ant">Ant</a>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	647	make sure it is in your PATH.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	648	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	649	</ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	650	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	651	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	652	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	653	<h3><a name="solaris">Basic Solaris System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	654	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	655	The minimum recommended hardware for building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	656	Solaris SPARC version is an UltraSPARC with 512 MB of RAM.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	657	For building
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	658	the Solaris x86 version, a Pentium class processor or better and at
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	659	least 512 MB of RAM are recommended.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	660	Approximately 1.4 GB of free disk
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	661	space is needed for a 32-bit build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	662	<p>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	663	If you are building the 64-bit version, you should
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	664	run the command "isainfo -v" to verify that you have a
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	665	64-bit installation, it should say <tt>sparcv9</tt> or
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	666	<tt>amd64</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	667	An additional 7 GB of free disk space is needed
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	668	for a 64-bit build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	669	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	670	The build uses the tools contained in <tt>/usr/ccs/bin</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	671	and <tt>/usr/bin</tt> of a standard developer or full installation of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	672	the Solaris operating environment.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	673	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	674	Solaris patches specific to the JDK can be downloaded from the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	675	<a href="http://sunsolve.sun.com/show.do?target=patches/JavaSE" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	676	SunSolve JDK Solaris patches download page</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	677	You should ensure that the latest patch cluster for
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	678	your version of the Solaris operating environment has also
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	679	been installed.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	680	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	681	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	682	<h4><a name="solaris_checklist">Basic Solaris Check List</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	683	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	684	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	685	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	686	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	687	<a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	688	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	689	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	690	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	691	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	692	<a href="#binaryplugs">Binary Plugs</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	693	<tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	694	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	695	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	696	<a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	697	<tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	698	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	699	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	700	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	701	<a href="#studio">Sun Studio Compilers</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	702	<a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	703	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	704	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	705	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	706	<a href="#cups">CUPS Include files</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	707	<tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	708	</li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	709	<li>
2908 6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	710	Install the <a href="#xrender">XRender Include files</a>.
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	711	</li>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	712	<li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	713	Install
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	714	<a href="#ant">Ant</a>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	715	make sure it is in your PATH.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	716	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	717	</ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	718	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	719	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	720	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	721	<h3><a name="windows">Basic Windows System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	722	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	723	<strong>i586 only:</strong>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	724	The minimum recommended hardware for building the 32-bit or X86
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	725	Windows version is an Pentium class processor or better, at least
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	726	512 MB of RAM, and approximately 600 MB of free disk space.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	727	<strong>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	728	NOTE: The Windows build machines need to use the
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	729	file system NTFS.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	730	Build machines formatted to FAT32 will not work
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	731	because FAT32 doesn't support case-sensitivity in file names.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	732	</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	733	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	734	<strong>X64 only:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	735	The minimum recommended hardware for building
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	736	the Windows X64 version is an AMD Opteron class processor, at least 1
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	737	GB of RAM, and approximately 10 GB of free disk space.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	738	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	739	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	740	<h4><a name="paths">Windows Paths</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	741	<blockquote>
0 fd16c54261b3 Initial load duke parents: diff changeset	742	<strong>Windows:</strong>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	743	Note that GNU make is a historic utility and is based very
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	744	heavily on shell scripting, so it does not tolerate the Windows habit
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	745	of having spaces in pathnames or the use of the <tt>\</tt>characters in pathnames.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	746	Luckily on most Windows systems, you can use <tt>/</tt>instead of \, and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	747	there is always a 'short' pathname without spaces for any path that
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	748	contains spaces.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	749	Unfortunately, this short pathname can be somewhat dynamic and the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	750	formula is difficult to explain.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	751	You can use <tt>cygpath</tt> utility to map pathnames with spaces
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	752	or the <tt>\</tt>character into the <tt>C:/</tt> style of pathname
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	753	(called 'mixed'), e.g.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	754	<tt>cygpath -s -m "<i>path</i>"</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	755	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	756	The makefiles will try to translate any pathnames supplied
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	757	to it into the <tt>C:/</tt> style automatically.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	758	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	759	Note that use of CYGWIN creates a unique problem with regards to
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	760	setting <a href="#path"><tt>PATH</tt></a>. Normally on Windows
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	761	the <tt>PATH</tt> variable contains directories
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	762	separated with the ";" character (Solaris and Linux uses ":").
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	763	With CYGWIN, it uses ":", but that means that paths like "C:/path"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	764	cannot be placed in the CYGWIN version of <tt>PATH</tt> and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	765	instead CYGWIN uses something like <tt>/cygdrive/c/path</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	766	which CYGWIN understands, but only CYGWIN understands.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	767	So be careful with paths on Windows.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	768	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	769	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	770	<h4><a name="windows_checklist">Basic Windows Check List</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	771	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	772	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	773	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	774	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	775	<a href="#cygwin">CYGWIN product</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	776	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	777	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	778	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	779	<a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	780	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	781	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	782	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	783	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	784	<a href="#binaryplugs">Binary Plugs</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	785	<tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>..
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	786	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	787	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	788	<a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	789	<tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	790	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	791	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	792	Install the
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	793	<a href="#msvc32">Microsoft Visual Studio Compilers</a>).
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	794	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	795	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	796	Setup all environment variables for compilers
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	797	(see <a href="#msvc32">compilers</a>).
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	798	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	799	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	800	Install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	801	<a href="#dxsdk">Microsoft DirectX SDK</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	802	</li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	803	<li>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	804	Install
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	805	<a href="#ant">Ant</a>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	806	make sure it is in your PATH and set
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	807	<tt><a href="#ANT_HOME">ANT_HOME</a></tt>.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	808	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	809	</ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	810	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	811	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	812	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	813	<h3><a name="dependencies">Build Dependencies</a></h3>
0 fd16c54261b3 Initial load duke parents: diff changeset	814	<blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	815	Depending on the platform, the OpenJDK build process has some basic
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	816	dependencies on components not part of the OpenJDK sources.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	817	Some of these are specific to a platform, some even specific to
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	818	an architecture.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	819	Each dependency will have a set of ALT variables that can be set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	820	to tell the makefiles where to locate the component.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	821	In most cases setting these ALT variables may not be necessary
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	822	and the makefiles will find defaults on the system in standard
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	823	install locations or through component specific variables.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	824	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	825	<h4><a name="bootjdk">Bootstrap JDK</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	826	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	827	All OpenJDK builds require access to the previously released
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	828	JDK 6, this is often called a bootstrap JDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	829	The JDK 6 binaries can be downloaded from Sun's
4084 ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin ohair parents: 3793 diff changeset	830	<a href="http://java.sun.com/javase/downloads/index.jsp"
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin ohair parents: 3793 diff changeset	831	target="_blank">JDK 6 download site</a>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	832	For build performance reasons
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	833	is very important that this bootstrap JDK be made available on the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	834	local disk of the machine doing the build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	835	You should always set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	836	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	837	to point to the location of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	838	the bootstrap JDK installation, this is the directory pathname
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	839	that contains a <tt>bin, lib, and include</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	840	It's also a good idea to also place its <tt>bin</tt> directory
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	841	in the <tt>PATH</tt> environment variable, although it's
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	842	not required.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	843	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	844	<strong>Solaris:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	845	Some pre-installed JDK images may be available to you in the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	846	directory <tt>/usr/jdk/instances</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	847	If you don't set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	848	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	849	the makefiles will look in that location for a JDK it can use.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	850	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	851	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	852	<h4><a name="binaryplugs">Binary Plugs</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	853	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	854	Not all of the source code that makes up the JDK is available
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	855	under an open-source license.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	856	This is a temporary situation and these binary plugs will be
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	857	replaced with fully open source replacements as soon as possible.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	858	So currently, in order to build a complete OpenJDK image,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	859	you must first download and install the appropriate
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	860	binary plug bundles for the OpenJDK, go to the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	861	<a href="http://openjdk.java.net" target="_blank">OpenJDK</a> site and select
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	862	the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	863	"<b>Bundles(7)</b>"
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	864	link and download the binaryplugs for
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	865	your particular platform.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	866	The file downloaded is a jar file that must be extracted by running
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	867	the jar file with:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	868	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	869	<pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	870	<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>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	871	</pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	872	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	873	A prompt will be issued for acceptance of these binary plug files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	874	During the OpenJDK build process these "binary plugs"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	875	for the encumbered components will be copied into your
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	876	resulting OpenJDK binary build image.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	877	These binary plug files are only for the purpose of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	878	building an OpenJDK binary.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	879	Make sure you set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	880	<tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	881	to the root of this installation.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	882	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	883	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	884	<h4><a name="importjdk">Optional Import JDK</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	885	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	886	The <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	887	setting is only needed if you are not building the entire
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	888	JDK. For example, if you have built the entire JDK once, and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	889	wanted to avoid repeatedly building the Hotspot VM, you could
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	890	set this to the location of the previous JDK install image
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	891	and the build will copy the needed files from this import area.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	892	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	893	<!-- ------------------------------------------------------ -->
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	894	<h4><a name="ant">Ant</a></h4>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	895	<blockquote>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	896	All OpenJDK builds require access to least Ant 1.6.5.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	897	The Ant tool is available from the
1597 2e17859349d7 6781784: Fix ant link in build readme ohair parents: 1544 diff changeset	898	<a href="http://ant.apache.org" target="_blank">
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	899	Ant download site</a>.
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	900	You should always make sure <tt>ant</tt> is in your PATH, and
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	901	on Windows you may also need to set
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	902	<tt><a href="#ANT_HOME">ANT_HOME</a></tt>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	903	to point to the location of
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	904	the Ant installation, this is the directory pathname
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	905	that contains a <tt>bin and lib</tt>.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	906	</blockquote>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	907	<!-- ------------------------------------------------------ -->
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	908	<h4><a name="cacerts">Certificate Authority File (cacert)</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	909	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	910	See <a href="http://en.wikipedia.org/wiki/Certificate_Authority" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	911	http://en.wikipedia.org/wiki/Certificate_Authority</a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	912	for a better understanding of the Certificate Authority (CA).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	913	A certificates file named "cacerts"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	914	represents a system-wide keystore with CA certificates.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	915	In JDK and JRE
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	916	binary bundles, the "cacerts" file contains root CA certificates from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	917	several public CAs (e.g., VeriSign, Thawte, and Baltimore).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	918	The source contain a cacerts file
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	919	without CA root certificates.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	920	Formal JDK builders will need to secure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	921	permission from each public CA and include the certificates into their
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	922	own custom cacerts file.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	923	Failure to provide a populated cacerts file
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	924	will result in verification errors of a certificate chain during runtime.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	925	The variable
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	926	<tt><a href="#ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	927	can be used to override the default location of the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	928	cacerts file that will get placed in your build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	929	By default an empty cacerts file is provided and that should be
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	930	fine for most JDK developers.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	931	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	932	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	933	<h4><a name="compilers">Compilers</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	934	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	935	<strong><a name="gcc">Linux gcc/binutils</a></strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	936	<blockquote>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	937	The GNU gcc compiler version should be 4 or newer.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	938	The compiler used should be the default compiler installed
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	939	in <tt>/usr/bin</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	940	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	941	<strong><a name="studio">Solaris: Sun Studio</a></strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	942	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	943	At a minimum, the
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	944	<a href="http://www.oracle.com/technetwork/server-storage/solarisstudio/downloads/index.htm" target="_blank">
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	945	Sun Studio 12 Update 1 Compilers</a>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	946	(containing version 5.10 of the C and C++ compilers) is required,
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	947	including specific patches.
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	948	<p>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	949	The Solaris SPARC patch list is:
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	950	<ul>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	951	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	952	118683-05: SunOS 5.10: Patch for profiling libraries and assembler
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	953	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	954	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	955	119963-21: SunOS 5.10: Shared library patch for C++
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	956	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	957	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	958	120753-08: SunOS 5.10: Microtasking libraries (libmtsk) patch
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	959	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	960	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	961	128228-09: Sun Studio 12 Update 1: Patch for Sun C++ Compiler
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	962	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	963	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	964	141860-03: Sun Studio 12 Update 1: Patch for Compiler Common patch for Sun C C++ F77 F95
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	965	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	966	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	967	141861-05: Sun Studio 12 Update 1: Patch for Sun C Compiler
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	968	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	969	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	970	142371-01: Sun Studio 12.1 Update 1: Patch for dbx
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	971	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	972	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	973	143384-02: Sun Studio 12 Update 1: Patch for debuginfo handling
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	974	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	975	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	976	143385-02: Sun Studio 12 Update 1: Patch for Compiler Common patch for Sun C C++ F77 F95
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	977	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	978	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	979	142369-01: Sun Studio 12.1: Patch for Performance Analyzer Tools
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	980	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	981	</ul>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	982	<p>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	983	The Solaris X86 patch list is:
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	984	<ul>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	985	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	986	119961-07: SunOS 5.10_x86, x64, Patch for profiling libraries and assembler
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	987	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	988	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	989	119964-21: SunOS 5.10_x86: Shared library patch for C++_x86
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	990	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	991	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	992	120754-08: SunOS 5.10_x86: Microtasking libraries (libmtsk) patch
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	993	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	994	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	995	141858-06: Sun Studio 12 Update 1_x86: Sun Compiler Common patch for x86 backend
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	996	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	997	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	998	128229-09: Sun Studio 12 Update 1_x86: Patch for C++ Compiler
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	999	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1000	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1001	142363-05: Sun Studio 12 Update 1_x86: Patch for C Compiler
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1002	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1003	<li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1004	142368-01: Sun Studio 12.1_x86: Patch for Performance Analyzer Tools
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1005	</li>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1006	</ul>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1007	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1008	Set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1009	<a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1010	to point to the location of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1011	the compiler binaries, and place this location in the <tt>PATH</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1012	<p>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1013	The Oracle Solaris Studio Express compilers at:
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1014	<a href="http://developers.sun.com/sunstudio/downloads/express.jsp" target="_blank">
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1015	Oracle Solaris Studio Express Download site</a>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1016	are also an option, although these compilers have not
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1017	been extensively used yet.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1018	</blockquote>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1019	<strong><a name="msvc32">Windows i586: Microsoft Visual Studio 2010 Compilers</a></strong>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1020	<blockquote>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1021	<p>
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1022	<b>BEGIN WARNING</b>: At this time (Spring/Summer 2010) JDK 7 is starting a transition to
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1023	use the newest VS2010 Microsoft compilers. These build instructions are updated
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1024	to show where we are going. We have a QA process to go through before
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1025	official builds actually use VS2010. So for now, official builds are
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1026	still using VS2003. No other compilers are known to build the entire JDK,
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1027	including non-open portions.
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1028	So for now you should be able to build with either VS2003 or VS2010.
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1029	We do not guarantee that VS2008 will work, although there is sufficient
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1030	makefile support to make at least basic JDK builds plausible.
5397 66dfbaa7d18f 6903970: VS2008/VS2010 build fails in make/sun/jkernel because of "afxres.h" missing prr parents: 5374 diff changeset	1031	Visual Studio 2010 Express compilers are now able to build all the
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1032	open source repositories, but this is 32 bit only. To build 64 bit
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1033	Windows binaries use the the 7.1 Windows SDK.<b>END WARNING.</b>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1034	<p>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1035	The 32-bit OpenJDK Windows build
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1036	requires
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1037	Microsoft Visual Studio C++ 2010 (VS2010) Professional
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1038	Edition or Express compiler.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1039	The compiler and other tools are expected to reside
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1040	in the location defined by the variable
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1041	<tt>VS100COMNTOOLS</tt> which
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1042	is set by the Microsoft Visual Studio installer.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1043	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1044	Once the compiler is installed,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1045	it is recommended that you run <tt>VCVARS32.BAT</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1046	to set the compiler environment variables
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1047	<tt>INCLUDE</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1048	<tt>LIB</tt>, and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1049	<tt>PATH</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1050	prior to building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1051	OpenJDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1052	The above environment variables <b>MUST</b> be set.
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1053	This compiler also contains the Windows SDK v 7.0a,
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1054	which is an update to the Windows 7 SDK.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1055	<p>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1056	<b>WARNING:</b> Make sure you check out the
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1057	<a href="#cygwin">CYGWIN link.exe WARNING</a>.
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1058	The path <tt>/usr/bin</tt> must be after the path to the
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1059	Visual Studio product.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1060	</blockquote>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1061	<strong><a name="msvc64">Windows x64: Microsoft Visual Studio 2010 Professional Compiler</a></strong>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1062	<blockquote>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1063	For <b>X64</b>, builds, when using the VS2010 Professional
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1064	compiler, the 64 bit build set up is much the same as 32 bit
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1065	except that you run <tt>amd64\VCVARS64.BAT</tt>
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1066	to set the compiler environment variables.
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1067	Previously 64 bit builds had used the 64 bit compiler in
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1068	an unbundled Windows SDK but this is no longer necessary if
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1069	you have VS2010 Professional.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1070	</blockquote>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1071	<strong><a name="mssdk64">Windows x64: Microsoft Windows 7.1 SDK 64 bit compilers.</a></strong>
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1072	For a free alternative for 64 bit builds, use the 7.1 SDK.
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1073	Microsoft say that to set up your paths for this run
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1074	<pre>
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1075	c:\Program Files\Microsoft SDKs\Windows\v7.1\bin\setenv.cmd /x64.
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1076	</pre>
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1077	What was tested is just directly setting up LIB, INCLUDE,
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1078	PATH and based on the installation directories using the
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1079	DOS short name appropriate for the system, (you will
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1080	need to set them for yours, not just blindly copy this) eg :
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1081	<pre>
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1082	set VSINSTALLDIR=c:\PROGRA~2\MICROS~1.0
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1083	set WindowsSdkDir=c:\PROGRA~1\MICROS~1\Windows\v7.1
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1084	set PATH=%VSINSTALLDIR%\vc\bin\amd64;%VSINSTALLDIR%\Common7\IDE;%WindowsSdkDir%\bin;%PATH%
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1085	set INCLUDE=%VSINSTALLDIR%\vc\include;%WindowsSdkDir%\include
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1086	set LIB=%VSINSTALLDIR%\vc\lib\amd64;%WindowsSdkDir%\lib\x64
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1087	</pre>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1088	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1089	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1090	<h4><a name="zip">Zip and Unzip</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1091	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1092	Version 2.2 (November 3rd 1997) or newer of the zip utility
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1093	and version 5.12 or newer of the unzip utility is needed
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1094	to build the JDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1095	With Solaris, Linux, and Windows CYGWIN, the zip and unzip
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1096	utilities installed on the system should be fine.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1097	Information and the source code for
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1098	ZIP.EXE and UNZIP.EXE is available on the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1099	<a href="http://www.info-zip.org"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1100	target="_blank">info-zip web site</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1101	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1102	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1103	<h4><a name="cups">Common UNIX Printing System (CUPS) Headers (Solaris & Linux)</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1104	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1105	<strong>Solaris:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1106	CUPS header files are required for building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1107	OpenJDK on Solaris.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1108	The Solaris header files can be obtained by installing
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1109	the package <strong>SFWcups</strong> from the Solaris Software
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1110	Companion CD/DVD, these often will be installed into
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1111	<tt>/opt/sfw/cups</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1112	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1113	<strong>Linux:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1114	CUPS header files are required for building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1115	OpenJDK on Linux.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1116	The Linux header files are usually available from a "cups"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1117	development package, it's recommended that you try and use
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1118	the package provided by the particular version of Linux that
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1119	you are using.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1120	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1121	The CUPS header files can always be downloaded from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1122	<a href="http://www.cups.org" target="_blank">www.cups.org</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1123	The variable
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1124	<tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1125	can be used to override the default location of the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1126	CUPS Header files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1127	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1128	<!-- ------------------------------------------------------ -->
2908 6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1129	<h4><a name="xrender">XRender Extension Headers (Solaris & Linux)</a></h4>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1130	<blockquote>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1131	<p>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1132	<strong>Solaris:</strong>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1133	XRender header files are required for building the
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1134	OpenJDK on Solaris.
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1135	The XRender header file is included with the other X11 header files
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1136	in the package <strong>SFWxwinc</strong> on new enough versions of
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1137	Solaris and will be installed in
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1138	<tt>/usr/X11/include/X11/extensions/Xrender.h</tt>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1139	</p><p>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1140	<strong>Linux:</strong>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1141	XRender header files are required for building the
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1142	OpenJDK on Linux.
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1143	The Linux header files are usually available from a "Xrender"
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1144	development package, it's recommended that you try and use
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1145	the package provided by the particular distribution of Linux that
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1146	you are using.
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1147	</p>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1148	</blockquote>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1149	<!-- ------------------------------------------------------ -->
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1150	<h4><a name="freetype">FreeType 2</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1151	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1152	Version 2.3 or newer of FreeType is required for building the OpenJDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1153	On Unix systems required files can be available as part of your
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1154	distribution (while you still may need to upgrade them).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1155	Note that you need development version of package that
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1156	includes both FreeType library and header files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1157	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1158	You can always download latest FreeType version from the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1159	<a href="http://www.freetype.org" target="_blank">FreeType website</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1160	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1161	Makefiles will try to pick FreeType from /usr/lib and /usr/include.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1162	In case it is installed elsewhere you will need to set environment
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1163	variables
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1164	<tt><a href="#ALT_FREETYPE_LIB_PATH">ALT_FREETYPE_LIB_PATH</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1165	and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1166	<tt><a href="#ALT_FREETYPE_HEADERS_PATH">ALT_FREETYPE_HEADERS_PATH</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1167	to refer to place where library and header files are installed.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1168	<p>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1169	Building the freetype 2 libraries from scratch is also possible,
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1170	however on Windows refer to the
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1171	<a href="http://freetype.freedesktop.org/wiki/FreeType_DLL">
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1172	Windows FreeType DLL build instructions</a>.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1173	<p>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1174	Note that by default FreeType is built with byte code hinting
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1175	support disabled due to licensing restrictions.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1176	In this case, text appearance and metrics are expected to
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1177	differ from Sun's official JDK build.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1178	See
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1179	<a href="http://freetype.sourceforge.net/freetype2/index.html">
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1180	the SourceForge FreeType2 Home Page
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1181	</a>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1182	for more information.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1183	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1184	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1185	<h4><a name="alsa">Advanced Linux Sound Architecture (ALSA) (Linux only)</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1186	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1187	<strong>Linux only:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1188	Version 0.9.1 or newer of the ALSA files are
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1189	required for building the OpenJDK on Linux.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1190	These Linux files are usually available from an "alsa"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1191	of "libasound"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1192	development package, it's highly recommended that you try and use
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1193	the package provided by the particular version of Linux that
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1194	you are using.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1195	The makefiles will check this emit a sanity error if it is
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1196	missing or the wrong version.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1197	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1198	In particular, older Linux systems will likely not have the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1199	right version of ALSA installed, for example
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1200	Redhat AS 2.1 U2 and SuSE 8.1 do not include a sufficiently
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1201	recent ALSA distribution.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1202	On rpm-based systems, you can see if ALSA is installed by
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1203	running this command:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1204	<pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1205	<tt>rpm -qa \| grep alsa</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1206	</pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1207	Both <tt>alsa</tt> and <tt>alsa-devel</tt> packages are needed.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1208	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1209	If your distribution does not come with ALSA, and you can't
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1210	find ALSA packages built for your particular system,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1211	you can try to install the pre-built ALSA rpm packages from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1212	<a href="http://www.freshrpms.net/" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1213	<tt>www.freshrpms.net</tt></a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1214	Note that installing a newer ALSA could
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1215	break sound output if an older version of ALSA was previously
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1216	installed on the system, but it will enable JDK compilation.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1217	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1218	Installation: execute as root<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1219	[i586]: <code>rpm -Uv --force alsa-lib-devel-0.9.1-rh61.i386.rpm</code><br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1220	[x64]: <code>rpm -Uv --force alsa-lib-devel-0.9.8-amd64.x86_64.rpm</code><br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1221	Uninstallation:<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1222	[i586]: <code>rpm -ev alsa-lib-devel-0.9.1-rh61</code><br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1223	[x64]:<code>rpm -ev alsa-lib-devel-0.9.8-amd64</code><br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1224	Make sure that you do not link to the static library
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1225	(<tt>libasound.a</tt>),
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1226	by verifying that the dynamic library (<tt>libasound.so</tt>) is
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1227	correctly installed in <tt>/usr/lib</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1228	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1229	As a last resort you can go to the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1230	<a href="http://www.alsa-project.org" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1231	Advanced Linux Sound Architecture Site</a> and build it from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1232	source.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1233	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1234	Download driver and library
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1235	source tarballs from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1236	<a href="http://www.alsa-project.org" target="_blank">ALSA's homepage</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1237	As root, execute the following
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1238	commands (you may need to adapt the version number):
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1239	<pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1240	<tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1241	$ tar xjf alsa-driver-0.9.1.tar.bz2
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1242	$ cd alsa-driver-0.9.1
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1243	$ ./configure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1244	$ make install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1245	$ cd ..
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1246	$ tar xjf alsa-lib-0.9.1.tar.bz2
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1247	$ cd alsa-lib-0.9.1
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1248	$ ./configure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1249	$ make install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1250	</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1251	</pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1252	Should one of the above steps fail, refer to the documentation on
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1253	ALSA's home page.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1254	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1255	Note that this is a minimum install that enables
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1256	building the JDK platform. To actually use ALSA sound drivers, more
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1257	steps are necessary as outlined in the documentation on ALSA's homepage.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1258	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1259	ALSA can be uninstalled by executing <tt>make uninstall</tt> first in
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1260	the <tt>alsa-lib-0.9.1</tt> directory and then in
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1261	<tt>alsa-driver-0.9.1</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1262	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1263	There are no ALT* variables to change the assumed locations of ALSA,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1264	the makefiles will expect to find the ALSA include files and library at:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1265	<tt>/usr/include/alsa</tt> and <tt>/usr/lib/libasound.so</tt>.
0 fd16c54261b3 Initial load duke parents: diff changeset	1266	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1267	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1268	<h4>Windows Specific Dependencies</h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1269	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1270	<strong>Unix Command Tools (<a name="cygwin">CYGWIN</a>)</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1271	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1272	The OpenJDK requires access to a set of unix command tools
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1273	on Windows which can be supplied by
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1274	<a href="http://www.cygwin.com" target="_blank">CYGWIN</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1275	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1276	The OpenJDK build requires CYGWIN version 1.5.12 or newer.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1277	Information about CYGWIN can
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1278	be obtained from the CYGWIN website at
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1279	<a href="http://www.cygwin.com" target="_blank">www.cygwin.com</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1280	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1281	By default CYGWIN doesn't install all the tools required for building
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1282	the OpenJDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1283	Along with the default installation, you need to install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1284	the following tools.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1285	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1286	<table border="1">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1287	<thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1288	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1289	<td>Binary Name</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1290	<td>Category</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1291	<td>Package</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1292	<td>Description</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1293	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1294	</thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1295	<tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1296	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1297	<td>ar.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1298	<td>Devel</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1299	<td>binutils</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1300	<td>The GNU assembler, linker and binary
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1301	utilities</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1302	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1303	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1304	<td>make.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1305	<td>Devel</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1306	<td>make</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1307	<td>The GNU version of the 'make' utility built for CYGWIN.<br>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1308	<b>NOTE</b>: See <a href="#gmake">the GNU make section</a></td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1309	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1310	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1311	<td>m4.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1312	<td>Interpreters</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1313	<td>m4</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1314	<td>GNU implementation of the traditional Unix macro
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1315	processor</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1316	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1317	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1318	<td>cpio.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1319	<td>Utils</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1320	<td>cpio</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1321	<td>A program to manage archives of files</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1322	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1323	<tr>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1324	<td>gawk.exe</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1325	<td>Utils</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1326	<td>awk</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1327	<td>Pattern-directed scanning and processing language</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1328	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1329	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1330	<td>file.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1331	<td>Utils</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1332	<td>file</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1333	<td>Determines file type using 'magic' numbers</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1334	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1335	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1336	<td>zip.exe</td>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1337	<td>Archive</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1338	<td>zip</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1339	<td>Package and compress (archive) files</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1340	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1341	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1342	<td>unzip.exe</td>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1343	<td>Archive</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1344	<td>unzip</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1345	<td>Extract compressed files in a ZIP archive</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1346	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1347	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1348	<td>free.exe</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1349	<td>System</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1350	<td>procps</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1351	<td>Display amount of free and used memory in the system</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1352	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1353	</tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1354	</table>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1355	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1356	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1357	Note that the CYGWIN software can conflict with other non-CYGWIN
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1358	software on your Windows system.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1359	CYGWIN provides a
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1360	<a href="http://cygwin.com/faq/faq.using.html" target="_blank">FAQ</a> for
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1361	known issues and problems, of particular interest is the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1362	section on
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1363	<a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1364	BLODA (applications that interfere with CYGWIN)</a>.
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1365	<p>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1366	<b>WARNING:</b>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1367	Be very careful with <b><tt>link.exe</tt></b>, it will conflict
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1368	with the Visual Studio version. You need the Visual Studio
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1369	version of <tt>link.exe</tt>, not the CYGWIN one.
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1370	So it's important that the Visual Studio paths in PATH preceed
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1371	the CYGWIN path <tt>/usr/bin</tt>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1372	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1373	<strong><a name="dxsdk">Microsoft DirectX 9.0 SDK header files and libraries</a></strong>
0 fd16c54261b3 Initial load duke parents: diff changeset	1374	<blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1375	Microsoft DirectX 9.0 SDK (Summer 2004)
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1376	headers are required for building
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1377	OpenJDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1378	This SDK can be downloaded from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1379	<a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=FD044A42-9912-42A3-9A9E-D857199F888E&displaylang=en" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1380	Microsoft DirectX 9.0 SDK (Summer 2004)</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1381	If the link above becomes obsolete, the SDK can be found from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1382	<a href="http://download.microsoft.com" target="_blank">the Microsoft Download Site</a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1383	(search with "DirectX 9.0 SDK Update Summer 2004").
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1384	The location of this SDK can be set with
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1385	<tt><a href="#ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1386	but it's normally found via the DirectX environment variable
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1387	<tt>DXSDK_DIR</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1388	</blockquote>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1389	<strong><a name="msvcrt"><tt>MSVCR100.DLL</tt></a></strong>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1390	<blockquote>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1391	The OpenJDK build requires access to a redistributable
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1392	<tt>MSVCR100.DLL</tt>.
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1393	This is usually picked up automatically from the redist
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1394	directories of Visual Studio 2010.
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1395	If this cannot be found set the
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1396	<a href="#ALT_MSVCRT_DLL_PATH"><tt>ALT_MSVCRT_DLL_PATH</tt></a>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1397	variable to the location of this file.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1398	<p>
0 fd16c54261b3 Initial load duke parents: diff changeset	1399	</blockquote>
fd16c54261b3 Initial load duke parents: diff changeset	1400	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1401	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1402	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1403	<h2><a name="creating">Creating the Build</a></h2>
0 fd16c54261b3 Initial load duke parents: diff changeset	1404	<blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1405	Once a machine is setup to build the OpenJDK,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1406	the steps to create the build are fairly simple.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1407	The various ALT settings can either be made into variables
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1408	or can be supplied on the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1409	<a href="#gmake"><tt><i>gmake</i></tt></a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1410	command.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1411	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1412	<li>Use the sanity rule to double check all the ALT settings:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1413	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1414	<tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1415	<i>gmake</i>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1416	sanity
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1417	[ARCH_DATA_MODEL=<i>32 or 64</i>]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1418	[other "ALT_" overrides]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1419	</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1420	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1421	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1422	<li>Start the build with the command:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1423	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1424	<tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1425	<i>gmake</i>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1426	[ARCH_DATA_MODEL=<i>32 or 64</i>]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1427	[ALT_OUTPUTDIR=<i>output_directory</i>]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1428	[other "ALT_" overrides]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1429	</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1430	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1431	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1432	</ol>
0 fd16c54261b3 Initial load duke parents: diff changeset	1433	<p>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1434	<strong>Solaris:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1435	Note that ARCH_DATA_MODEL is really only needed on Solaris to
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1436	indicate you want to built the 64-bit version.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1437	And before the Solaris 64-bit binaries can be used, they
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1438	must be merged with the binaries from a separate 32-bit build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1439	The merged binaries may then be used in either 32-bit or 64-bit mode, with
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1440	the selection occurring at runtime
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1441	with the <tt>-d32</tt> or <tt>-d64</tt> options.
0 fd16c54261b3 Initial load duke parents: diff changeset	1442	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1443	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1444	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1445	<h2><a name="testing">Testing the Build</a></h2>
0 fd16c54261b3 Initial load duke parents: diff changeset	1446	<blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1447	When the build is completed, you should see the generated
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1448	binaries and associated files in the <tt>j2sdk-image</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1449	directory in the output directory.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1450	The default output directory is
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1451	<tt>build/<i>platform</i></tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1452	where <tt><i>platform</i></tt> is one of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1453	<tt><ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1454	<li>solaris-sparc</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1455	<li>solaris-sparcv9</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1456	<li>solaris-i586</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1457	<li>solaris-amd64</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1458	<li>linux-i586</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1459	<li>linux-amd64</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1460	<li>windows-i586</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1461	<li>windows-amd64</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1462	</ul></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1463	In particular, the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1464	<tt>build/<i>platform</i>/j2sdk-image/bin</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1465	directory should contain executables for the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1466	OpenJDK tools and utilities.
0 fd16c54261b3 Initial load duke parents: diff changeset	1467	<p>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1468	You can test that the build completed properly by using the build
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1469	to run the various demos that you will find in the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1470	<tt>build/<i>platform</i>/j2sdk-image/demo</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1471	directory.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1472	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1473	The provided regression tests can be run with the <tt>jtreg</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1474	utility from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1475	<a href="http://openjdk.java.net/jtreg/" target="_blank">the jtreg site</a>.
0 fd16c54261b3 Initial load duke parents: diff changeset	1476	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1477	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1478	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1479	<h2><a name="variables">Environment/Make Variables</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1480	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1481	Some of the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1482	environment or make variables (just called <b>variables</b> in this
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1483	document) that can impact the build are:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1484	<blockquote>
0 fd16c54261b3 Initial load duke parents: diff changeset	1485	<dl>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1486	<dt><a name="path"><tt>PATH</tt></a> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1487	<dd>Typically you want to set the <tt>PATH</tt> to include:
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1488	<ul>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1489	<li>The location of the GNU make binary</li>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1490	<li>The location of the Bootstrap JDK <tt>java</tt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1491	(see <a href="#bootjdk">Bootstrap JDK</a>)</li>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1492	<li>The location of the C/C++ compilers
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1493	(see <a href="#compilers"><tt>compilers</tt></a>)</li>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1494	<li>The location or locations for the Unix command utilities
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1495	(e.g. <tt>/usr/bin</tt>)</li>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1496	</ul>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1497	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1498	<dt><tt>MILESTONE</tt> </dt>
0 fd16c54261b3 Initial load duke parents: diff changeset	1499	<dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1500	The milestone name for the build (<i>e.g.</i>"beta").
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1501	The default value is "internal".
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1502	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1503	<dt><tt>BUILD_NUMBER</tt> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1504	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1505	The build number for the build (<i>e.g.</i> "b27").
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1506	The default value is "b00".
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1507	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1508	<dt><a name="arch_data_model"><tt>ARCH_DATA_MODEL</tt></a></dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1509	<dd>The <tt>ARCH_DATA_MODEL</tt> variable
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1510	is used to specify whether the build is to generate 32-bit or 64-bit
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1511	binaries.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1512	The Solaris build supports either 32-bit or 64-bit builds, but
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1513	Windows and Linux will support only one, depending on the specific
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1514	OS being used.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1515	Normally, setting this variable is only necessary on Solaris.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1516	Set <tt>ARCH_DATA_MODEL</tt> to <tt>32</tt> for generating 32-bit binaries,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1517	or to <tt>64</tt> for generating 64-bit binaries.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1518	</dd>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1519	<dt><a name="ALT_BOOTDIR"><tt>ALT_BOOTDIR</tt></a></dt>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1520	<dd>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1521	The location of the bootstrap JDK installation.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1522	See <a href="#bootjdk">Bootstrap JDK</a> for more information.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1523	You should always install your own local Bootstrap JDK and
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1524	always set <tt>ALT_BOOTDIR</tt> explicitly.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1525	</dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1526	<dt><a name="ALT_BINARY_PLUGS_PATH"><tt>ALT_BINARY_PLUGS_PATH</tt></a></dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1527	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1528	The location of the binary plugs installation.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1529	See <a href="#binaryplugs">Binary Plugs</a> for more information.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1530	You should always have a local copy of a
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1531	recent Binary Plugs install image
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1532	and set this variable to that location.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1533	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1534	<dt><a name="ALT_JDK_IMPORT_PATH"><tt>ALT_JDK_IMPORT_PATH</tt></a></dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1535	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1536	The location of a previously built JDK installation.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1537	See <a href="#importjdk">Optional Import JDK</a> for more information.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1538	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1539	<dt><a name="ALT_OUTPUTDIR"><tt>ALT_OUTPUTDIR</tt></a> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1540	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1541	An override for specifying the (absolute) path of where the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1542	build output is to go.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1543	The default output directory will be build/<i>platform</i>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1544	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1545	<dt><a name="ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1546	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1547	The location of the C/C++ compiler.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1548	The default varies depending on the platform.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1549	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1550	<dt><tt><a name="ALT_CACERTS_FILE">ALT_CACERTS_FILE</a></tt></dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1551	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1552	The location of the <a href="#cacerts">cacerts</a> file.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1553	The default will refer to
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1554	<tt>jdk/src/share/lib/security/cacerts</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1555	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1556	<dt><a name="ALT_CUPS_HEADERS_PATH"><tt>ALT_CUPS_HEADERS_PATH</tt></a> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1557	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1558	The location of the CUPS header files.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1559	See <a href="#cups">CUPS information</a> for more information.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1560	If this path does not exist the fallback path is
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1561	<tt>/usr/include</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1562	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1563	<dt><a name="ALT_FREETYPE_LIB_PATH"><tt>ALT_FREETYPE_LIB_PATH</tt></a></dt>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1564	<dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1565	The location of the FreeType shared library.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1566	See <a href="#freetype">FreeType information</a> for details.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1567	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1568	<dt><a name="ALT_FREETYPE_HEADERS_PATH"><tt>ALT_FREETYPE_HEADERS_PATH</tt></a></dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1569	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1570	The location of the FreeType header files.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1571	See <a href="#freetype">FreeType information</a> for details.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1572	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1573	<dt><a name="ALT_JDK_DEVTOOLS_PATH"><tt>ALT_JDK_DEVTOOLS_PATH</tt></a></dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1574	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1575	The default root location of the devtools.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1576	The default value is
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1577	<tt>$(ALT_SLASH_JAVA)/devtools</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1578	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1579	<dt><tt><a name="ALT_DEVTOOLS_PATH">ALT_DEVTOOLS_PATH</a></tt> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1580	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1581	The location of tools like the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1582	<a href="#zip"><tt>zip</tt> and <tt>unzip</tt></a>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1583	binaries, but might also contain the GNU make utility
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1584	(<tt><i>gmake</i></tt>).
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1585	So this area is a bit of a grab bag, especially on Windows.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1586	The default value depends on the platform and
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1587	Unix Commands being used.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1588	On Linux the default will be
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1589	<tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1590	on Solaris
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1591	<tt>$(ALT_JDK_DEVTOOLS_PATH)/<i>{sparc,i386}</i>/bin</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1592	and on Windows with CYGWIN
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1593	<tt>/usr/bin</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1594	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1595	<dt><a name="ALT_UNIXCCS_PATH"><tt>ALT_UNIXCCS_PATH</tt></a></dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1596	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1597	<strong>Solaris only:</strong>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1598	An override for specifying where the Unix CCS
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1599	command set are located.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1600	The default location is <tt>/usr/ccs/bin</tt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1601	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1602	<dt><a name="ALT_SLASH_JAVA"><tt>ALT_SLASH_JAVA</tt></a></dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1603	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1604	The default root location for many of the ALT path locations
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1605	of the following ALT variables.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1606	The default value is
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1607	<tt>"/java"</tt> on Solaris and Linux,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1608	<tt>"J:"</tt> on Windows.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1609	</dd>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1610	<dt><a name="ALT_BUILD_JDK_IMPORT_PATH"><tt>ALT_BUILD_JDK_IMPORT_PATH</tt></a></dt>
0 fd16c54261b3 Initial load duke parents: diff changeset	1611	<dd>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1612	These are useful in managing builds on multiple platforms.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1613	The default network location for all of the import JDK images
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1614	for all platforms.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1615	If <tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1616	is not set, this directory will be used and should contain
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1617	the following directories:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1618	<tt>solaris-sparc</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1619	<tt>solaris-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1620	<tt>solaris-sparcv9</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1621	<tt>solaris-amd64</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1622	<tt>linux-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1623	<tt>linux-amd64</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1624	<tt>windows-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1625	and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1626	<tt>windows-amd64</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1627	Where each of these directories contain the import JDK image
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1628	for that platform.
0 fd16c54261b3 Initial load duke parents: diff changeset	1629	</dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1630	<dt><a name="ALT_BUILD_BINARY_PLUGS_PATH"><tt>ALT_BUILD_BINARY_PLUGS_PATH</tt></a></dt>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1631	<dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1632	These are useful in managing builds on multiple platforms.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1633	The default network location for all of the binary plug images
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1634	for all platforms.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1635	If <tt><a href="#ALT_BINARY_PLUGS_PATH">ALT_BINARY_PLUGS_PATH</a></tt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1636	is not set, this directory will be used and should contain
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1637	the following directories:
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1638	<tt>solaris-sparc</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1639	<tt>solaris-i586</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1640	<tt>solaris-sparcv9</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1641	<tt>solaris-amd64</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1642	<tt>linux-i586</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1643	<tt>linux-amd64</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1644	<tt>windows-i586</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1645	and
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1646	<tt>windows-amd64</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1647	Where each of these directories contain the binary plugs image
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1648	for that platform.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1649	</dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1650	<dt><strong>Windows specific:</strong></dt>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1651	<dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1652	<dl>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1653	<dt><a name="ALT_MSDEVTOOLS_PATH"><tt>ALT_MSDEVTOOLS_PATH</tt></a> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1654	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1655	The location of the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1656	Microsoft Visual Studio
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1657	tools 'bin' directory.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1658	The default is usually derived from
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1659	<a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1660	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1661	<dt><tt><a name="ALT_DXSDK_PATH">ALT_DXSDK_PATH</a></tt> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1662	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1663	The location of the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1664	<a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1665	The default will be to try and use the DirectX environment
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1666	variable <tt>DXSDK_DIR</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1667	failing that, look in <tt>C:/DXSDK</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1668	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1669	<dt><tt><a name="ALT_MSVCRT_DLL_PATH">ALT_MSVCRT_DLL_PATH</a></tt> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1670	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1671	The location of the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1672	<a href="#msvcrt"><tt>MSVCRT.DLL</tt></a>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1673	</dd>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1674	<dt><tt><a name="ALT_MSVCRNN_DLL_PATH">ALT_MSVCRNN_DLL_PATH</a></tt> </dt>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1675	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1676	The location of the
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1677	<a href="#msvcrt"><tt>MSVCR100.DLL</tt></a>.
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1678	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1679	</dl>
0 fd16c54261b3 Initial load duke parents: diff changeset	1680	</dd>
fd16c54261b3 Initial load duke parents: diff changeset	1681	</dl>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1682	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1683	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1684	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1685	<h2><a name="troubleshooting">Troubleshooting</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1686	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1687	A build can fail for any number of reasons.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1688	Most failures
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1689	are a result of trying to build in an environment in which all the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1690	pre-build requirements have not been met.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1691	The first step in
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1692	troubleshooting a build failure is to recheck that you have satisfied
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1693	all the pre-build requirements for your platform.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1694	Look for the check list of the platform you are building on in the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1695	<a href="#contents">Table of Contents</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1696	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1697	You can validate your build environment by using the <tt>sanity</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1698	target.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1699	Any errors listed
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1700	will stop the build from starting, and any warnings may result in
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1701	a flawed product build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1702	We strongly encourage you to evaluate every
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1703	sanity check warning and fix it if required, before you proceed
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1704	further with your build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1705	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1706	Some of the more common problems with builds are briefly described
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1707	below, with suggestions for remedies.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1708	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1709	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1710	<b>Slow Builds:</b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1711	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1712	If your build machine seems to be overloaded from too many
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1713	simultaneous C++ compiles, try setting the <tt>HOTSPOT_BUILD_JOBS</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1714	variable to <tt>1</tt> (if you're using a multiple CPU
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1715	machine, setting it to more than the the number of CPUs is probably
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1716	not a good idea).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1717	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1718	Creating the javadocs can be very slow, if you are running
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1719	javadoc, consider skipping that step.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1720	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1721	Faster hardware and more RAM always helps too.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1722	The VM build tends to be CPU intensive (many C++ compiles),
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1723	and the rest of the JDK will often be disk intensive.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1724	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1725	Faster compiles are possible using a tool called
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1726	<a href="http://ccache.samba.org/" target="_blank">ccache</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1727	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1728	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1729	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1730	<b>File time issues:</b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1731	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1732	If you see warnings that refer to file time stamps, e.g.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1733	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1734	<i>Warning message:</i><tt> File `xxx' has modification time in
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1735	the future.</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1736	<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1737	<i>Warning message:</i> <tt> Clock skew detected. Your build may
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1738	be incomplete.</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1739	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1740	These warnings can occur when the clock on the build machine is out of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1741	sync with the timestamps on the source files. Other errors, apparently
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1742	unrelated but in fact caused by the clock skew, can occur along with
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1743	the clock skew warnings. These secondary errors may tend to obscure the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1744	fact that the true root cause of the problem is an out-of-sync clock.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1745	For example, an out-of-sync clock has been known to cause an old
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1746	version of javac to be used to compile some files, resulting in errors
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1747	when the pre-1.4 compiler ran across the new <tt>assert</tt> keyword
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1748	in the 1.4 source code.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1749	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1750	If you see these warnings, reset the clock on the build
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1751	machine, run "<tt><i>gmake</i> clobber</tt>" or delete the directory
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1752	containing the build output, and restart the build from the beginning.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1753	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1754	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1755	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1756	<b>Error message: <tt>Trouble writing out table to disk</tt></b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1757	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1758	Increase the amount of swap space on your build machine.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1759	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1760	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1761	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1762	<b>Error Message: <tt>libstdc++ not found:</tt></b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1763	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1764	This is caused by a missing libstdc++.a library.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1765	This is installed as part of a specific package
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1766	(e.g. libstdc++.so.devel.386).
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1767	By default some 64-bit Linux versions (e.g. Fedora)
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1768	only install the 64-bit version of the libstdc++ package.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1769	Various parts of the JDK build require a static
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1770	link of the C++ runtime libraries to allow for maximum
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1771	portability of the built images.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1772	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1773	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1774	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1775	<b>Error Message: <tt>cannot restore segment prot after reloc</tt></b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1776	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1777	This is probably an issue with SELinux (See
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1778	<a href="http://en.wikipedia.org/wiki/SELinux" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1779	http://en.wikipedia.org/wiki/SELinux</a>).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1780	Parts of the VM is built without the <tt>-fPIC</tt> for
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1781	performance reasons.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1782	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1783	To completely disable SELinux:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1784	<tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1785	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1786	<li>$ su root</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1787	<li># system-config-securitylevel</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1788	<li>In the window that appears, select the SELinux tab</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1789	<li>Disable SELinux</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1790	</ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1791	</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1792	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1793	Alternatively, instead of completely disabling it you could
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1794	disable just this one check.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1795	<tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1796	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1797	<li>Select System->Administration->SELinux Management</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1798	<li>In the SELinux Management Tool which appears,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1799	select "Boolean" from the menu on the left</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1800	<li>Expand the "Memory Protection" group</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1801	<li>Check the first item, labeled
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1802	"Allow all unconfined executables to use libraries requiring text relocation ..."</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1803	</ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1804	</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1805	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1806	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1807	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1808	<b>Windows Error Message: <tt>*** fatal error - couldn't allocate heap, ... </tt></b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1809	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1810	The CYGWIN software can conflict with other non-CYGWIN
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1811	software. See the CYGWIN FAQ section on
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1812	<a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1813	BLODA (applications that interfere with CYGWIN)</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1814	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1815	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1816	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1817	<b>Windows Error Message: <tt>*** multiple target patterns. Stop.</tt></b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1818	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1819	The CYGWIN make version 3.81 may not like the Windows <tt>C:/</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1820	style paths, it may not like the ':' character in the path
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1821	when used in a makefile target definition.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1822	See the <a href="#gmake"><tt><i>gmake</i></tt></a> section.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1823	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1824	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1825	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1826	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1827	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1828	</body>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1829	</html>

author	duke
	Wed, 05 Jul 2017 17:25:43 +0200
changeset 6938	a4e6aa1f45ad
parent 6366	f2ef5ff052aa
child 7360	39aa1820e934
permissions	-rw-r--r--