jdk-sandbox: README-builds.html@c3e8585c0ebd (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>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	27	This README file contains build instructions for the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	28	<a href="http://openjdk.java.net" target="_blank">OpenJDK</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	29	Building the source code for the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	30	OpenJDK
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	31	requires
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	32	a certain degree of technical expertise.
333 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>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	40	<li><a href="#hg">Use of Mercurial</a>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	41	<ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	42	<li><a href="#get_source">Getting the Source</a></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	43	</ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	44	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	45	<li><a href="#MBE">Minimum Build Environments</a></li>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	46	<li><a href="#SDBE">Specific Developer Build Environments</a>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	47	<ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	48	<li><a href="#fedora">Fedora Linux</a> </li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	49	<li><a href="#centos">CentOS Linux</a> </li>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	50	<li><a href="#debian">Debian GNU/Linux</a></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	51	<li><a href="#ubuntu">Ubuntu Linux</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	52	<li><a href="#opensuse">OpenSUSE</a></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	53	<li><a href="#mandriva">Mandriva</a></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	54	<li><a href="#opensolaris">OpenSolaris</a></li>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	55	</ul>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	56	</li>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	57	<li><a href="#directories">Source Directory Structure</a>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	58	<ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	59	<li><a href="#drops">Managing the Source Drops</a></li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	60	</ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	61	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	62	<li><a href="#building">Build Information</a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	63	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	64	<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	65	<li><a href="#linux">Basic Linux System Setup</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	66	<li><a href="#solaris">Basic Solaris System Setup</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	67	<li><a href="#windows">Basic Windows System Setup</a> </li>
12494 6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	68	<li><a href="#macosx">Basic Mac OS X System Setup</a></li>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	69	<li><a href="#dependencies">Build Dependencies</a>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	70	<ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	71	<li><a href="#bootjdk">Bootstrap JDK</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	72	<li><a href="#importjdk">Optional Import JDK</a> </li>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	73	<li><a href="#ant">Ant 1.7.1</a> </li>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	74	<li><a href="#cacerts">Certificate Authority File (cacert)</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	75	<li><a href="#compilers">Compilers</a>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	76	<ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	77	<li><a href="#msvc32">Microsoft Visual Studio Professional/Express for 32 bit</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	78	<li><a href="#msvc64">Microsoft Visual Studio Professional for 64 bit</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	79	<li><a href="#mssdk64">Microsoft Windows SDK for 64 bit</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	80	<li><a href="#gcc">Linux gcc/binutils</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	81	<li><a href="#studio">Sun Studio</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	82	</ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	83	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	84	<li><a href="#zip">Zip and Unzip</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	85	<li><a href="#freetype">FreeType2 Fonts</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	86	<li>Linux and Solaris:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	87	<ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	88	<li><a href="#cups">CUPS Include files</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	89	<li><a href="#xrender">XRender Include files</a></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	90	</ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	91	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	92	<li>Linux only:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	93	<ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	94	<li><a href="#alsa">ALSA files</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	95	</ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	96	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	97	<li>Windows only:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	98	<ul>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	99	<li>Unix Command Tools (<a href="#cygwin">CYGWIN</a>) <strong>or</strong></li>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	100	<li>Minimalist GNU for Windows (<a href="#msys">MinGW/MSYS</a>)</li>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	101	<li><a href="#dxsdk">DirectX 9.0 SDK</a> </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	102	</ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	103	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	104	</ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	105	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	106	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	107	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	108	<li><a href="#creating">Creating the Build</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	109	<li><a href="#testing">Testing the Build</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	110	<li><a href="#variables">Environment/Make Variables</a></li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	111	<li><a href="#troubleshooting">Troubleshooting</a></li>
12801 948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	112	<li><a href="#newbuild">The New Build</a></li>
0 fd16c54261b3 Initial load duke parents: diff changeset	113	</ul>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	114	</blockquote>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	115
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	116	<!-- ------------------------------------------------------ -->
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	117	<hr>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	118	<h2><a name="hg">Use of Mercurial</a></h2>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	119	<blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	120	The OpenJDK sources are maintained with the revision control system
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	121	<a href="http://mercurial.selenic.com/wiki/Mercurial">Mercurial</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	122	If you are new to Mercurial, please see the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	123	<a href="http://mercurial.selenic.com/wiki/BeginnersGuides">Beginner Guides</a>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	124	or refer to the <a href="http://hgbook.red-bean.com/">Mercurial Book</a>.
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	125	The first few chapters of the book provide an excellent overview of
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	126	Mercurial, what it is and how it works.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	127	<br>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	128	For using Mercurial with the OpenJDK refer to the
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	129	<a href="http://openjdk.java.net/guide/repositories.html#installConfig">
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	130	Developer Guide: Installing and Configuring Mercurial</a>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	131	section for more information.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	132
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	133	<!-- ------------------------------------------------------ -->
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	134	<h3><a name="get_source">Getting the Source</a></h3>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	135	<blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	136	To get the entire set of OpenJDK Mercurial repositories
10208 9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions neugens parents: 8720 diff changeset	137	use the script <code>get_source.sh</code> located in the root repository:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	138	<blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	139	<tt>
10208 9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions neugens parents: 8720 diff changeset	140	hg clone http://hg.openjdk.java.net/jdk8/jdk8 <i>YourOpenJDK</i>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	141	<br>cd <i>YourOpenJDK</i>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	142	<br>sh ./get_source.sh
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	143	</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	144	</blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	145	Once you have all the repositories, the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	146	script <tt>make/scripts/hgforest.sh</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	147	can be used to repeat the same <tt>hg</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	148	command on every repository in the forest, e.g.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	149	<blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	150	<tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	151	cd <i>YourOpenJDK</i>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	152	<br>sh ./make/scripts/hgforest.sh pull -u
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	153	</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	154	</blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	155	</blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	156
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	157	</blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	158
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	159	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	160	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	161	<h2><a name="MBE">Minimum Build Environments</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	162	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	163	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	164	"minimum build environments" (MBE) for this
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	165	specific release of the JDK,
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	166	Building with the MBE will generate the most compatible
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	167	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	168	of the same base OS and hardware architecture.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	169	These usually represent what is often called the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	170	least common denominator platforms.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	171	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	172	specific platforms, and in fact creating these specific platforms
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	173	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	174	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	175	The minimum OS and C/C++ compiler versions needed for building the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	176	OpenJDK:
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	177	<p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	178	<table border="1">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	179	<thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	180	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	181	<th>Base OS and Architecture</th>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	182	<th>OS</th>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	183	<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	184	<th>BOOT JDK</th>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	185	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	186	</thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	187	<tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	188	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	189	<td>Linux X86 (32-bit)</td>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	190	<td>Fedora 9</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	191	<td>gcc 4.3 </td>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	192	<td>JDK 6u18</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	193	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	194	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	195	<td>Linux X64 (64-bit)</td>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	196	<td>Fedora 9</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	197	<td>gcc 4.3 </td>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	198	<td>JDK 6u18</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	199	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	200	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	201	<td>Solaris SPARC (32-bit)</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	202	<td>Solaris 10 Update 6</td>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	203	<td>Sun Studio 12 Update 1 + patches</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	204	<td>JDK 6u18</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	205	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	206	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	207	<td>Solaris SPARCV9 (64-bit)</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	208	<td>Solaris 10 Update 6</td>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	209	<td>Sun Studio 12 Update 1 + patches</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	210	<td>JDK 6u18</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	211	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	212	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	213	<td>Solaris X86 (32-bit)</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	214	<td>Solaris 10 Update 6</td>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	215	<td>Sun Studio 12 Update 1 + patches</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	216	<td>JDK 6u18</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	217	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	218	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	219	<td>Solaris X64 (64-bit)</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	220	<td>Solaris 10 Update 6</td>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	221	<td>Sun Studio 12 Update 1 + patches</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	222	<td>JDK 6u18</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	223	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	224	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	225	<td>Windows X86 (32-bit)</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	226	<td>Windows XP</td>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	227	<td>Microsoft Visual Studio C++ 2010 Professional Edition</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	228	<td>JDK 6u18</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	229	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	230	<tr>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	231	<td>Windows X64 (64-bit)</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	232	<td>Windows Server 2003 - Enterprise x64 Edition</td>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	233	<td>Microsoft Visual Studio C++ 2010 Professional Edition</td>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	234	<td>JDK 6u18</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	235	</tr>
12494 6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	236	<tr>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	237	<td>Mac OS X X64 (64-bit)</td>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	238	<td>Mac OS X 10.7.3 "Lion"</td>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	239	<td>XCode 4.1 or later</td>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	240	<td>Java for OS X Lion Update 1</td>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	241	</tr>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	242	</tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	243	</table>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	244	<p>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	245	These same sources do indeed build on many more systems than the
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	246	above older generation systems, again the above is just a minimum.
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	247	<p>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	248	Compilation problems with newer or different C/C++ compilers is a
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	249	common problem.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	250	Similarly, compilation problems related to changes to the
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	251	<tt>/usr/include</tt> or system header files is also a
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	252	common problem with newer or unreleased OS versions.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	253	Please report these types of problems as bugs so that they
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	254	can be dealt with accordingly.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	255	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	256	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	257	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	258	<h2><a name="SDBE">Specific Developer Build Environments</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	259	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	260	We won't be listing all the possible environments, but
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	261	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	262	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	263	<!-- ------------------------------------------------------ -->
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	264	<h3><a name="fedora">Fedora</a></h3>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	265	<blockquote>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	266	<h4>Fedora 9</h4>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	267	<p>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	268	<blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	269	After installing <a href="http://fedoraproject.org">Fedora</a> 9
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	270	you need to install several build dependencies. The simplest
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	271	way to do it is to execute the following commands as user
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	272	<tt>root</tt>:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	273	<p/>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	274	<code>yum-builddep java-1.6.0-openjdk</code>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	275	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	276	<code>yum install gcc gcc-c++</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	277	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	278	In addition, it's necessary to set a few environment variables for the build:
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	279
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	280	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	281	<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	282	</blockquote>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	283	<h4>Fedora 10</h4>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	284	<p>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	285	<blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	286	After installing <a href="http://fedoraproject.org">Fedora</a> 10
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	287	you need to install several build dependencies. The simplest
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	288	way to do it is to execute the following commands as user
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	289	<tt>root</tt>:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	290	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	291	<code>yum-builddep java-1.6.0-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	292	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	293	<code>yum install gcc gcc-c++</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	294	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	295	In addition, it's necessary to set a few environment variables for the build:
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	296
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	297	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	298	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-openjdk</code>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	299	</blockquote>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	300	<h4>Fedora 11</h4>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	301	<p>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	302	<blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	303	After installing <a href="http://fedoraproject.org">Fedora</a> 11
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	304	you need to install several build dependencies. The simplest
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	305	way to do it is to execute the following commands as user
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	306	<tt>root</tt>:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	307	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	308	<code>yum-builddep java-1.6.0-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	309	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	310	<code>yum install gcc gcc-c++</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	311	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	312	In addition, it's necessary to set a few environment variables for the build:
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	313
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	314	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	315	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	316	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	317	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	318	<!-- ------------------------------------------------------ -->
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	319	<h3><a name="centos">CentOS 5.5</a></h3>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	320	<blockquote>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	321	After installing
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	322	<a href="http://www.centos.org/">CentOS 5.5</a>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	323	you need to make sure you have
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	324	the following Development bundles installed:
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	325	<blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	326	<ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	327	<li>Development Libraries</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	328	<li>Development Tools</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	329	<li>Java Development</li>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	330	<li>X Software Development (Including XFree86-devel)</li>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	331	</ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	332	</blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	333	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	334	Plus the following packages:
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	335	<blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	336	<ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	337	<li>cups devel: Cups Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	338	<li>alsa devel: Alsa Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	339	<li>ant: Ant Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	340	<li>Xi devel: libXi.so Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	341	</ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	342	</blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	343	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	344	The freetype 2.3 packages don't seem to be available,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	345	but the freetype 2.3 sources can be downloaded, built,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	346	and installed easily enough from
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	347	<a href="http://downloads.sourceforge.net/freetype">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	348	the freetype site</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	349	Build and install with something like:
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	350	<blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	351	<tt>./configure && make && sudo -u root make install</tt>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	352	</blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	353	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	354	Mercurial packages could not be found easily, but a Google
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	355	search should find ones, and they usually include Python if
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	356	it's needed.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	357	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	358	<!-- ------------------------------------------------------ -->
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	359	<h3><a name="debian">Debian</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	360	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	361	<h4>Debian 5.0 (Lenny)</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	362	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	363	<blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	364	After installing <a href="http://debian.org">Debian</a> 5
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	365	you need to install several build dependencies.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	366	The simplest way to install the build dependencies is to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	367	execute the following commands as user <tt>root</tt>:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	368	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	369	<code>aptitude build-dep openjdk-6</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	370	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	371	<code>aptitude install openjdk-6-jdk libmotif-dev</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	372	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	373	In addition, it's necessary to set a few environment variables for the build:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	374	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	375	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	376	</blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	377	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	378	<!-- ====================================================== -->
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	379	<h3><a name="ubuntu">Ubuntu</a></h3>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	380	<blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	381	<h4>Ubuntu 8.04</h4>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	382	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	383	<blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	384	After installing <a href="http://ubuntu.org">Ubuntu</a> 8.04
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	385	you need to install several build dependencies.
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	386	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	387	First, you need to enable the universe repository in the
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	388	Software Sources application and reload the repository
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	389	information. The Software Sources application is available
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	390	under the System/Administration menu.
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	391	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	392	The simplest way to install the build dependencies is to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	393	execute the following commands:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	394	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	395	<code>sudo aptitude build-dep openjdk-6</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	396	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	397	<code>sudo aptitude install openjdk-6-jdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	398	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	399	In addition, it's necessary to set a few environment variables for the build:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	400	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	401	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	402	</blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	403	<h4>Ubuntu 8.10</h4>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	404	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	405	<blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	406	After installing <a href="http://ubuntu.org">Ubuntu</a> 8.10
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	407	you need to install several build dependencies. The simplest
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	408	way to do it is to execute the following commands:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	409	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	410	<code>sudo aptitude build-dep openjdk-6</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	411	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	412	<code>sudo aptitude install openjdk-6-jdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	413	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	414	In addition, it's necessary to set a few environment variables for the build:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	415	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	416	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	417	</blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	418	<h4>Ubuntu 9.04</h4>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	419	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	420	<blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	421	After installing <a href="http://ubuntu.org">Ubuntu</a> 9.04
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	422	you need to install several build dependencies. The simplest
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	423	way to do it is to execute the following commands:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	424	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	425	<code>sudo aptitude build-dep openjdk-6</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	426	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	427	<code>sudo aptitude install openjdk-6-jdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	428	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	429	In addition, it's necessary to set a few environment variables for the build:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	430	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	431	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-6-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	432	</blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	433	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	434	<!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	435	<h3><a name="opensuse">OpenSUSE</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	436	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	437	<h4>OpenSUSE 11.1</h4>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	438	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	439	<blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	440	After installing <a href="http://opensuse.org">OpenSUSE</a> 11.1
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	441	you need to install several build dependencies.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	442	The simplest way to install the build dependencies is to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	443	execute the following commands:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	444	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	445	<code>sudo zypper source-install -d java-1_6_0-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	446	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	447	<code>sudo zypper install make</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	448	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	449	In addition, it is necessary to set a few environment variables for the build:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	450	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	451	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-1.6.0-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	452	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	453	Finally, you need to unset the <code>JAVA_HOME</code> environment variable:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	454	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	455	<code>export -n JAVA_HOME</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	456	</blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	457	</blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	458	<!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	459	<h3><a name="mandriva">Mandriva</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	460	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	461	<h4>Mandriva Linux One 2009 Spring</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	462	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	463	<blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	464	After installing <a href="http://mandriva.org">Mandriva</a> Linux One 2009 Spring
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	465	you need to install several build dependencies.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	466	The simplest way to install the build dependencies is to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	467	execute the following commands as user <tt>root</tt>:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	468	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	469	<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>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	470	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	471	In addition, it is necessary to set a few environment variables for the build:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	472	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	473	<code>export LANG=C ALT_BOOTDIR=/usr/lib/jvm/java-1.6.0-openjdk</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	474	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	475	</blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	476	<!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	477	<h3><a name="opensolaris">OpenSolaris</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	478	<blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	479	<h4>OpenSolaris 2009.06</h4>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	480	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	481	<blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	482	After installing <a href="http://opensolaris.org">OpenSolaris</a> 2009.06
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	483	you need to install several build dependencies.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	484	The simplest way to install the build dependencies is to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	485	execute the following commands:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	486	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	487	<code>pfexec pkg install SUNWgmake SUNWj6dev SUNWant sunstudioexpress SUNWcups SUNWzip SUNWunzip SUNWxwhl SUNWxorg-headers SUNWaudh SUNWfreetype2</code>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	488	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	489	In addition, it is necessary to set a few environment variables for the build:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	490	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	491	<code>export LANG=C ALT_COMPILER_PATH=/opt/SunStudioExpress/bin/ ALT_CUPS_HEADERS_PATH=/usr/include/</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	492	<p/>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	493	Finally, you need to make sure that the build process can find the Sun Studio compilers:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	494	<p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	495	<code>export PATH=$PATH:/opt/SunStudioExpress/bin/</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	496	</blockquote>
3793 9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	497	</blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms robilad parents: 3668 diff changeset	498	<!-- ------------------------------------------------------ -->
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	499	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	500	<h2><a name="directories">Source Directory Structure</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	501	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	502	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	503	The source code for the OpenJDK is delivered in a set of
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	504	directories:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	505	<tt>hotspot</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	506	<tt>langtools</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	507	<tt>corba</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	508	<tt>jaxws</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	509	<tt>jaxp</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	510	and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	511	<tt>jdk</tt>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	512	The <tt>hotspot</tt> directory contains the source code and make
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	513	files for building the OpenJDK Hotspot Virtual Machine.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	514	The <tt>langtools</tt> directory contains the source code and make
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	515	files for building the OpenJDK javac and language tools.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	516	The <tt>corba</tt> directory contains the source code and make
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	517	files for building the OpenJDK Corba files.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	518	The <tt>jaxws</tt> directory contains the source code and make
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	519	files for building the OpenJDK JAXWS files.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	520	The <tt>jaxp</tt> directory contains the source code and make
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	521	files for building the OpenJDK JAXP files.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	522	The <tt>jdk</tt> directory contains the source code and make files for
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	523	building the OpenJDK runtime libraries and misc files.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	524	The top level <tt>Makefile</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	525	is used to build the entire OpenJDK.
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	526
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	527	<h3><a name="drops">Managing the Source Drops</a></h3>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	528	<blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	529	<p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	530	The repositories <tt>jaxp</tt> and <tt>jaxws</tt> actually
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	531	do not contain the sources for JAXP or JAX-WS.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	532	These products have their own open source procedures at their
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	533	<a href="http://jaxp.java.net/">JAXP</a> and
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	534	<a href="http://jax-ws.java.net/">JAX-WS</a> home pages.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	535	The OpenJDK project does need access to these sources to build
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	536	a complete JDK image because JAXP and JAX-WS are part of the JDK.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	537	The current process for delivery of the JAXP and JAX-WS sources
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	538	involves so called "source drop bundles" downloaded from a public
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	539	website.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	540	There are many reasons for this current mechanism, and it is
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	541	understood that this is not ideal for the open source community.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	542	It is possible this process could change in the future.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	543	<br>
10208 9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions neugens parents: 8720 diff changeset	544	<b>NOTE:</b> The <a href="http://download.java.net/openjdk/jdk8/">
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	545	Complete OpenJDK Source Bundles</a> <u>will</u> contain the JAXP and
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	546	JAX-WS sources.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	547	</p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	548
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	549	<h4><a name="dropcreation">Creation of New Source Drop Bundles</a></h4>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	550	<blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	551	<ol>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	552	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	553	The JAXP or JAX-WS team prepares a new zip bundle,
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	554	places a copy in a public download area on java.net,
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	555	sends us a link and a list of CRs (Change Request Numbers).
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	556	The older download bundles should not be deleted.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	557	It is the responsibility of the JAXP and JAX-WS team to
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	558	place the proper GPL legal notices on the sources
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	559	and do any filtering or java re-packaging for the
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	560	OpenJDK instances of these classes.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	561	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	562	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	563	The OpenJDK team copies this new bundle into shared
10208 9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions neugens parents: 8720 diff changeset	564	area (e.g. <tt>/java/devtools/share/jdk8-drops</tt>).
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	565	Older bundles are never deleted so we retain the history.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	566	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	567	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	568	The OpenJDK team edits the ant property file
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	569	<tt>jaxp/jaxp.properties</tt> or
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	570	<tt>jaxws/jaxws.properties</tt> to update the
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	571	base URL, the zip bundle name, and the MD5 checksum
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	572	of the zip bundle
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	573	(on Solaris: <tt>sum -c md5 <i>bundlename</i></tt>)
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	574	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	575	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	576	OpenJDK team reviews and commits those changes with the
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	577	given CRs.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	578	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	579	</ol>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	580	</blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	581
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	582	<h4><a name="dropusage">Using Source Drop Bundles</a></h4>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	583	<blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	584	<p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	585	The ant scripts that build <tt>jaxp</tt> and <tt>jaxws</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	586	will attempt to locate these zip bundles from the directory
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	587	in the environment variable
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	588	<tt><a href="#ALT_DROPS_DIR">ALT_DROPS_DIR</a></tt>.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	589	The checksums protect from getting the wrong, corrupted, or
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	590	improperly modified sources.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	591	Once the sources are made available, the population will not
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	592	happen again unless a <tt>make clobber</tt> is requested
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	593	or the <tt>jaxp/drop/</tt> or <tt>jaxws/drop/</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	594	directory is explicitly deleted.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	595	<br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	596	<b>NOTE:</b> The default Makefile and ant script behavior
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	597	is to NOT download these bundles from the public http site.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	598	In general, doing downloads
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	599	during the build process is not advised, it creates too much
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	600	unpredictability in the build process.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	601	However, you can use <tt>make ALLOW_DOWNLOADS=true</tt> to
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	602	tell the ant script that the download of the zip bundle is
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	603	acceptable.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	604	</p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	605	<p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	606	The recommended procedure for keeping a cache of these
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	607	source bundles would be to download them once, place them
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	608	in a directory outside the repositories, and then set
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	609	<tt><a href="#ALT_DROPS_DIR">ALT_DROPS_DIR</a></tt> to refer
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	610	to that directory.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	611	These drop bundles do change occasionally, so the newer
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	612	bundles may need to be added to this area from time to time.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	613	</p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	614	</blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	615	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	616	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	617	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	618	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	619	<h2><a name="building">Build Information</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	620	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	621	Building the OpenJDK
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	622	is done with a <a href="#gmake">GNU <tt>make</tt></a> command line
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	623	and various
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	624	environment or make variable settings that direct the makefile rules
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	625	to where various components have been installed.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	626	Where possible the makefiles will attempt to located the various
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	627	components in the default locations or any component specific
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	628	variable settings.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	629	When the normal defaults fail or components cannot be found,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	630	the various
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	631	<tt>ALT_*</tt> variables (alternates)
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	632	can be used to help the makefiles locate components.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	633	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	634	Refer to the bash/sh/ksh setup file
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	635	<tt>jdk/make/jdk_generic_profile.sh</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	636	if you need help in setting up your environment variables.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	637	A build could be as simple as:
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	638	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	639	<pre><tt>
0 fd16c54261b3 Initial load duke parents: diff changeset	640	bash
fd16c54261b3 Initial load duke parents: diff changeset	641	. jdk/make/jdk_generic_profile.sh
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	642	<a href="#gmake"><tt>make</tt></a> sanity && <a href="#gmake"><tt>make</tt></a>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	643	</tt></pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	644	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	645	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	646	Of course ksh or sh would work too.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	647	But some customization will probably be necessary.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	648	The <tt>sanity</tt> rule will make some basic checks on build
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	649	dependencies and generate appropriate warning messages
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	650	regarding missing, out of date, or newer than expected components
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	651	found on your system.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	652	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	653	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	654	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	655	<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	656	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	657	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	658	GNU version of the utility command <tt>make</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	659	(<tt><i>gmake</i></tt>).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	660	A few notes about using GNU make:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	661	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	662	<li>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	663	You need GNU make version 3.81 or newer.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	664	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	665	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	666	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	667	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	668	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	669	<strong>Linux:</strong>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	670	The <tt>/usr/bin/make</tt> should be 3.81 or newer
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	671	and should work fine for you.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	672	If this version is not 3.81 or newer,
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	673	see the <a href="#buildgmake">"Building GNU make"</a> section.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	674	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	675	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	676	<strong>Solaris:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	677	Do NOT use <tt>/usr/bin/make</tt> on Solaris.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	678	If your Solaris system has the software
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	679	from the Solaris Companion CD installed,
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	680	you should try and use <tt>gmake</tt>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	681	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	682	<tt>/usr/sfw/bin</tt> directory.
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	683	In more recent versions of Solaris GNU make might be found
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	684	at <tt>/usr/bin/gmake</tt>.<br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	685	<b>NOTE:</b> It is very likely that this <tt>gmake</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	686	could be 3.80, you need 3.81, in which case,
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	687	see the <a href="#buildgmake">"Building GNU make"</a> section.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	688	</li>
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	<strong>Windows:</strong>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	691	Make sure you start your build inside a bash/sh/ksh shell and are
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	692	using a <tt>make.exe</tt> utility built for that environment.<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	693	<strong>MKS</strong> builds need a native Windows version of GNU make
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	694	(see <a href="#buildgmake">Building GNU make</a>).<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	695	<strong>Cygwin</strong> builds need
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	696	a make version which was specially compiled for the Cygwin environment
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	697	(see <a href="#buildgmake">Building GNU make</a>). <strong>WARNING:</strong>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	698	the OpenJDK build with the make utility provided by Cygwin will <strong>not</strong>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	699	work because it does not support drive letters in paths. Make sure that
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	700	your version of make will be found before the Cygwins default make by
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	701	setting an appropriate <tt>PATH</tt> environment variable or by removing
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	702	Cygwin's make after you built your own make version.<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	703	<strong>MinGW/MSYS</strong> builds can use the default make which
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	704	comes with the environment.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	705	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	706	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	707	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	708	Information on GNU make, and access to ftp download sites, are
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	709	available on the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	710	<a href="http://www.gnu.org/software/make/make.html" target="_blank">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	711	GNU make web site
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	712	</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	713	The latest source to GNU make is available at
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	714	<a href="http://ftp.gnu.org/pub/gnu/make/" target="_blank">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	715	ftp.gnu.org/pub/gnu/make/</a>.
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	716	</p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	717	<!-- ------------------------------------------------------ -->
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	718	<h4><a name="buildgmake">Building GNU make</a></h4>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	719	<blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	720	First step is to get the GNU make 3.81 (or newer) source from
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	721	<a href="http://ftp.gnu.org/pub/gnu/make/" target="_blank">
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	722	ftp.gnu.org/pub/gnu/make/</a>.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	723	Building is a little different depending on the OS and unix toolset
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	724	on Windows:
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	725	<ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	726	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	727	<strong>Linux:</strong>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	728	<tt>./configure && make</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	729	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	730	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	731	<strong>Solaris:</strong>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	732	<tt>./configure && gmake CC=gcc</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	733	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	734	<li>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	735	<strong>Windows for CYGWIN:</strong><br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	736	<tt>./configure</tt><br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	737	Add the line <tt>#define HAVE_CYGWIN_SHELL 1</tt> to the end of <tt>config.h</tt><br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	738	<tt>make</tt><br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	739	<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	740	This should produce <tt>make.exe</tt> in the current directory.
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	741	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	742	<li>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	743	<strong>Windows for MKS:</strong><br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	744	Edit <tt>config.h.W32</tt> and uncomment the line <tt>#define HAVE_MKS_SHELL 1</tt><br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	745	Set the environment for your native compiler (e.g. by calling:<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	746	<tt>"C:\Program Files\Microsoft SDKs\Windows\v7.1\Bin\SetEnv.cmd" /Release /xp /x64)</tt>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	747	<tt>nmake -f NMakefile.win32</tt>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	748	<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	749	This should produce <tt>WinDebug/make.exe</tt> and <tt>WinRel/make.exe</tt>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	750	<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	751	If you get the error: <tt>NMAKE : fatal error U1045: spawn failed : Permission denied</tt>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	752	you have to set the <tt>Read & execute</tt> permission for the file <tt>subproc.bat</tt>.
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	753	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	754	</ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	755	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	756	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	757	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	758	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	759	<h3><a name="linux">Basic Linux System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	760	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	761	<strong>i586 only:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	762	The minimum recommended hardware for building the Linux version
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	763	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	764	approximately 1.5 GB of free disk space.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	765	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	766	<strong>X64 only:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	767	The minimum recommended hardware for building the Linux
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	768	version is an AMD Opteron class processor, at least 512 MB of RAM, and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	769	approximately 4 GB of free disk space.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	770	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	771	The build will use the tools contained in
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	772	<tt>/bin</tt> and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	773	<tt>/usr/bin</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	774	of a standard installation of the Linux operating environment.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	775	You should ensure that these directories are in your
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	776	<tt>PATH</tt>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	777	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	778	Note that some Linux systems have a habit of pre-populating
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	779	your environment variables for you, for example <tt>JAVA_HOME</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	780	might get pre-defined for you to refer to the JDK installed on
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	781	your Linux system.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	782	You will need to unset <tt>JAVA_HOME</tt>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	783	It's a good idea to run <tt>env</tt> and verify the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	784	environment variables you are getting from the default system
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	785	settings make sense for building the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	786	OpenJDK.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	787	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	788	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	789	<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	790	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	791	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	792	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	793	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	794	<a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	795	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	796	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	797	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	798	<a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	799	<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	800	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	801	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	802	Install or upgrade the <a href="#freetype">FreeType development
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	803	package</a>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	804	</li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	805	<li>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	806	Install
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	807	<a href="#ant">Ant 1.7.1 or newer</a>,
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	808	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	809	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	810	</ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	811	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	812	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	813	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	814	<h3><a name="solaris">Basic Solaris System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	815	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	816	The minimum recommended hardware for building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	817	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	818	For building
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	819	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	820	least 512 MB of RAM are recommended.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	821	Approximately 1.4 GB of free disk
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	822	space is needed for a 32-bit build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	823	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	824	If you are building the 64-bit version, you should
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	825	run the command "isainfo -v" to verify that you have a
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	826	64-bit installation, it should say <tt>sparcv9</tt> or
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	827	<tt>amd64</tt>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	828	An additional 7 GB of free disk space is needed
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	829	for a 64-bit build.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	830	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	831	The build uses the tools contained in <tt>/usr/ccs/bin</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	832	and <tt>/usr/bin</tt> of a standard developer or full installation of
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	833	the Solaris operating environment.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	834	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	835	Solaris patches specific to the JDK can be downloaded from the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	836	<a href="http://sunsolve.sun.com/show.do?target=patches/JavaSE" target="_blank">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	837	SunSolve JDK Solaris patches download page</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	838	You should ensure that the latest patch cluster for
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	839	your version of the Solaris operating environment has also
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	840	been installed.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	841	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	842	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	843	<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	844	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	845	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	846	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	847	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	848	<a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	849	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	850	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	851	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	852	<a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	853	<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	854	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	855	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	856	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	857	<a href="#studio">Sun Studio Compilers</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	858	<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	859	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	860	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	861	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	862	<a href="#cups">CUPS Include files</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	863	<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	864	</li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	865	<li>
2908 6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	866	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	867	</li>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	868	<li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	869	Install
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	870	<a href="#ant">Ant 1.7.1 or newer</a>,
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	871	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	872	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	873	</ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	874	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	875	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	876	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	877	<h3><a name="windows">Basic Windows System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	878	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	879	<strong>i586 only:</strong>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	880	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	881	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	882	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	883	<strong>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	884	NOTE: The Windows build machines need to use the
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	885	file system NTFS.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	886	Build machines formatted to FAT32 will not work
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	887	because FAT32 doesn't support case-sensitivity in file names.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	888	</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	889	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	890	<strong>X64 only:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	891	The minimum recommended hardware for building
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	892	the Windows X64 version is an AMD Opteron class processor, at least 1
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	893	GB of RAM, and approximately 10 GB of free disk space.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	894	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	895	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	896	<h4><a name="paths">Windows Paths</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	897	<blockquote>
0 fd16c54261b3 Initial load duke parents: diff changeset	898	<strong>Windows:</strong>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	899	Note that GNU make, the shell and other Unix-tools required during the build
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	900	do not tolerate the Windows habit
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	901	of having spaces in pathnames or the use of the <tt>\</tt>characters in pathnames.
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	902	Luckily on most Windows systems, you can use <tt>/</tt>instead of <tt>\</tt>, and
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	903	there is always a short <a href="http://en.wikipedia.org/wiki/8.3_filename">
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	904	"8.3" pathname</a> without spaces for any path that contains spaces.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	905	Unfortunately, this short pathname is somewhat dynamic (i.e. dependant on the
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	906	other files and directories inside a given directory) and can not be
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	907	algorithmicly calculated by only looking at a specific path name.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	908	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	909	The makefiles will try to translate any pathnames supplied
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	910	to it into the <tt>C:/</tt> style automatically.
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	911	</p>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	912	<p>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	913	Special care has to be taken if native Windows applications
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	914	like <tt>nmake</tt> or <tt>cl</tt> are called with file arguments processed
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	915	by Unix-tools like <tt>make</tt> or <tt>sh</tt>!
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	916	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	917	</blockquote>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	918	<!-- ------------------------------------------------------ -->
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	919	<h4><a name="paths">Windows build environments</a></h4>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	920	<blockquote>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	921	Building on Windows requires a Unix-like environment, notably a Unix-like shell.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	922	There are several such environments available of which
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	923	<a href="http://www.mkssoftware.com/products/tk/ds_tkdev.asp">MKS</a>,
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	924	<a href="http://www.cygwin.com/">Cygwin</a> and
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	925	<a href="http://www.mingw.org/wiki/MSYS">MinGW/MSYS</a> are currently supported for
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	926	the OpenJDK build. One of the differences of these three systems is the way
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	927	they handle Windows path names, particularly path names which contain
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	928	spaces, backslashes as path separators and possibly drive letters. Depending
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	929	on the use case and the specifics of each environment these path problems can
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	930	be solved by a combination of quoting whole paths, translating backslashes to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	931	forward slashes, escaping backslashes with additional backslashes and
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	932	translating the path names to their <a href="http://en.wikipedia.org/wiki/8.3_filename">
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	933	"8.3" version</a>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	934	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	935	As of this writing (MKS ver. 9.4, Cygwin ver. 1.7.9, MinGW/MSYS 1.0.17),
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	936	MKS builds are known to be the fastest Windows builds while MingGW/MSYS
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	937	builds are slightly slower (about 10%) than MKS builds and Cygwin builds
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	938	require nearly twice the time (about 180%) of MKS builds (e.g. on a
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	939	DualCore i7 notebook with 8GB of RAM, HDD and 64-bit Windows 7 operating system
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	940	the complete OpenJDK 8 product build takes about 49min with MKS, 54min with
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	941	MinGW/MSYS and 88min with Cygwin).
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	942	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	943	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	944	Mixing tools from the different Unix emulation environments is not a good
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	945	idea and will probably not work!
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	946	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	947	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	948	<strong>MKS:</strong> is a commercial product which includes
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	949	all the Unix utilities which are required to build the OpenJDK except GNU
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	950	make. In pre-OpenJDK times it was the only supported build environment on
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	951	Windows. The MKS tools support Windows paths with drive letters and
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	952	forward slashes as path separator. Paths in environment variables like (for
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	953	example) <tt>PATH</tt> are separated by semicolon '<tt>;</tt>'.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	954	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	955	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	956	Recent versions of MKS provide the <tt>dosname</tt> utility to convert paths
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	957	with spaces to short (8.3) path names,e .g.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	958	<tt>dosname -s "<i>path</i>"</tt>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	959	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	960	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	961	If you are using the MKS environment, you need a native Windows version
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	962	of Gnu make <a href="#buildgmake">which you can easily build yourself</a>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	963	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	964	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	965	<strong>Cygwin:</strong>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	966	is an open source, Linux-like environment which tries to emulate
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	967	a complete POSIX layer on Windows. It tries to be smart about path names
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	968	and can usually handle all kinds of paths if they are correctly quoted
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	969	or escaped although internally it maps drive letters <tt><drive>:</tt>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	970	to a virtual directory <tt>/cygdrive/<drive></tt>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	971	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	972	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	973	You can always use the <tt>cygpath</tt> utility to map pathnames with spaces
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	974	or the backslash character into the <tt>C:/</tt> style of pathname
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	975	(called 'mixed'), e.g. <tt>cygpath -s -m "<i>path</i>"</tt>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	976	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	977	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	978	Note that the use of CYGWIN creates a unique problem with regards to
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	979	setting <a href="#path"><tt>PATH</tt></a>. Normally on Windows
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	980	the <tt>PATH</tt> variable contains directories
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	981	separated with the ";" character (Solaris and Linux use ":").
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	982	With CYGWIN, it uses ":", but that means that paths like "C:/path"
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	983	cannot be placed in the CYGWIN version of <tt>PATH</tt> and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	984	instead CYGWIN uses something like <tt>/cygdrive/c/path</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	985	which CYGWIN understands, but only CYGWIN understands.
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	986	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	987	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	988	If you are using the Cygwin environment, you need to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	989	<a href="#buildgmake">compile your own version</a>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	990	of GNU make because the default Cygwin make can not handle drive letters in paths.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	991	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	992	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	993	<strong>MinGW/MSYS:</strong>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	994	MinGW ("Minimalist GNU for Windows") is a collection of free Windows
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	995	specific header files and import libraries combined with GNU toolsets that
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	996	allow one to produce native Windows programs that do not rely on any
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	997	3rd-party C runtime DLLs. MSYS is a supplement to MinGW which allows building
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	998	applications and programs which rely on traditional UNIX tools to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	999	be present. Among others this includes tools like <tt>bash</tt> and <tt>make</tt>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1000	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1001	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1002	Like Cygwin, MinGW/MSYS can handle different types of path formats. They
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1003	are internally converted to paths with forward slashes and drive letters
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1004	<tt><drive>:</tt> replaced by a virtual
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1005	directory <tt>/<drive></tt>. Additionally, MSYS automatically
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1006	detects binaries compiled for the MSYS environment and feeds them with the
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1007	internal, Unix-style path names. If native Windows applications are called
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1008	from within MSYS programs their path arguments are automatically converted
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1009	back to Windows style path names with drive letters and backslashes as
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1010	path separators. This may cause problems for Windows applications which
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1011	use forward slashes as parameter separator (e.g. <tt>cl /nologo /I</tt>)
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1012	because MSYS may wrongly <a href="http://mingw.org/wiki/Posix_path_conversion">
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1013	replace such parameters by drive letters</a>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1014	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1015	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1016	If you are using the MinGW/MSYS system you can use the default make
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1017	version supplied by the environment.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1018	</p>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1019	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1020	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1021	<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	1022	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1023	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1024	<li>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1025	Install one of the
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1026	<a href="#cygwin">CYGWIN</a>, <a href="#msys">MinGW/MSYS</a> or
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1027	<a href="http://www.mkssoftware.com/products/tk/ds_tkdev.asp">MKS</a> environments.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1028	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1029	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1030	Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1031	<a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1032	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1033	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1034	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1035	<a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1036	<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	1037	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1038	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1039	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	1040	<a href="#msvc32">Microsoft Visual Studio Compilers</a>).
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1041	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1042	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1043	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	1044	(see <a href="#msvc32">compilers</a>).
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1045	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1046	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1047	Install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1048	<a href="#dxsdk">Microsoft DirectX SDK</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1049	</li>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1050	<li>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1051	Install
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1052	<a href="#ant">Ant 1.7.1 or newer</a>,
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1053	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	1054	<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	1055	</li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1056	</ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1057	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1058	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1059	<hr>
12494 6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1060	<h3><a name="macosx">Basic Mac OS X System Setup</a></h3>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1061	<blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1062	<strong>X64 only:</strong>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1063	The minimum recommended hardware for building
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1064	the Mac OS X version is any 64-bit capable Intel processor, at least 2
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1065	GB of RAM, and approximately 3 GB of free disk space. You should also
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1066	have OS X Lion 10.7.3 installed.
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1067	</blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1068	<!-- ------------------------------------------------------ -->
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1069
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1070	<h4><a name="macosx_checklist">Basic Mac OS X Check List</a></h4>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1071	<blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1072	<ol>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1073	<li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1074	Install <a href="https://developer.apple.com/xcode/">XCode 4.1</a> or newer.
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1075	If you install XCode 4.3 or newer, make sure you also install
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1076	"Command line tools" found under the preferences pane "Downloads".
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1077	</li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1078	<li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1079	Install <a href="http://support.apple.com/kb/dl1421" target="_blank">"Java for OS X Lion Update 1"</a>,
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1080	set <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a> to <code>`/usr/libexec/java_home -v 1.6`</code></tt>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1081	</li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1082	<li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1083	<a href="#importjdk">Optional Import JDK</a>, set
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1084	<tt><a href="#ALT_JDK_IMPORT_PATH">ALT_JDK_IMPORT_PATH</a></tt>.
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1085	</li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1086	</ol>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1087	</blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1088	<!-- ------------------------------------------------------ -->
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1089	<hr>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1090	<h3><a name="dependencies">Build Dependencies</a></h3>
0 fd16c54261b3 Initial load duke parents: diff changeset	1091	<blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1092	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	1093	dependencies on components not part of the OpenJDK sources.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1094	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	1095	an architecture.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1096	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	1097	to tell the makefiles where to locate the component.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1098	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	1099	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	1100	install locations or through component specific variables.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1101	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1102	<h4><a name="bootjdk">Bootstrap JDK</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1103	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1104	All OpenJDK builds require access to the previously released
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1105	JDK 6, this is often called a bootstrap JDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1106	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	1107	<a href="http://java.sun.com/javase/downloads/index.jsp"
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1108	target="_blank">JDK 6 download site</a>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1109	For build performance reasons
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1110	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	1111	local disk of the machine doing the build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1112	You should always set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1113	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1114	to point to the location of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1115	the bootstrap JDK installation, this is the directory pathname
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1116	that contains a <tt>bin, lib, and include</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1117	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	1118	in the <tt>PATH</tt> environment variable, although it's
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1119	not required.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1120	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1121	<strong>Solaris:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1122	Some pre-installed JDK images may be available to you in the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1123	directory <tt>/usr/jdk/instances</tt>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1124	If you don't set
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1125	<tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1126	the makefiles will look in that location for a JDK it can use.
333 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	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1129	<h4><a name="importjdk">Optional Import JDK</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1130	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1131	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	1132	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	1133	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	1134	wanted to avoid repeatedly building the Hotspot VM, you could
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1135	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	1136	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	1137	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1138	<!-- ------------------------------------------------------ -->
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1139	<h4><a name="ant">Ant</a></h4>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1140	<blockquote>
8057 b66ada7c8e10 7016976: Documentation for required ant version on JDK7 builds on Solaris 10 and Solaris 11 ohair parents: 7876 diff changeset	1141	All OpenJDK builds require access to least Ant 1.7.1.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1142	The Ant tool is available from the
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1143	<a href="http://archive.apache.org/dist/ant/binaries/apache-ant-1.7.1-bin.zip" target="_blank">
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1144	Ant 1.7.1 archive download site</a>.
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1145	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	1146	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	1147	<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	1148	to point to the location of
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1149	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	1150	that contains a <tt>bin and lib</tt>.
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1151	<br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1152	<b>WARNING:</b> Ant versions used from IDE tools like NetBeans
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1153	or installed via system packages may not operate the same
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1154	as the one obtained from the Ant download bundles.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1155	These system and IDE installers sometimes choose to change
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1156	the ant installation enough to cause differences.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1157	</blockquote>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1158	<!-- ------------------------------------------------------ -->
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1159	<h4><a name="cacerts">Certificate Authority File (cacert)</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1160	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1161	See <a href="http://en.wikipedia.org/wiki/Certificate_Authority" target="_blank">
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1162	http://en.wikipedia.org/wiki/Certificate_Authority</a>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1163	for a better understanding of the Certificate Authority (CA).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1164	A certificates file named "cacerts"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1165	represents a system-wide keystore with CA certificates.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1166	In JDK and JRE
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1167	binary bundles, the "cacerts" file contains root CA certificates from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1168	several public CAs (e.g., VeriSign, Thawte, and Baltimore).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1169	The source contain a cacerts file
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1170	without CA root certificates.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1171	Formal JDK builders will need to secure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1172	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	1173	own custom cacerts file.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1174	Failure to provide a populated cacerts file
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1175	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	1176	The variable
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1177	<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	1178	can be used to override the default location of the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1179	cacerts file that will get placed in your build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1180	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	1181	fine for most JDK developers.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1182	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1183	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1184	<h4><a name="compilers">Compilers</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1185	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1186	<strong><a name="gcc">Linux gcc/binutils</a></strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1187	<blockquote>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1188	The GNU gcc compiler version should be 4.3 or newer.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1189	The compiler used should be the default compiler installed
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1190	in <tt>/usr/bin</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1191	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1192	<strong><a name="studio">Solaris: Sun Studio</a></strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1193	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1194	At a minimum, the
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1195	<a href="http://www.oracle.com/technetwork/server-storage/solarisstudio/downloads/index.htm" target="_blank">
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1196	Sun Studio 12 Update 1 Compilers</a>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1197	(containing version 5.10 of the C and C++ compilers) is required,
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1198	including specific patches.
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1199	<p>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1200	The Solaris SPARC patch list is:
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1201	<ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1202	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1203	118683-05: SunOS 5.10: Patch for profiling libraries and assembler
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1204	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1205	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1206	119963-21: SunOS 5.10: Shared library patch for C++
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1207	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1208	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1209	120753-08: SunOS 5.10: Microtasking libraries (libmtsk) patch
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1210	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1211	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1212	128228-09: Sun Studio 12 Update 1: Patch for Sun C++ Compiler
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1213	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1214	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1215	141860-03: Sun Studio 12 Update 1: Patch for Compiler Common patch for Sun C C++ F77 F95
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1216	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1217	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1218	141861-05: Sun Studio 12 Update 1: Patch for Sun C Compiler
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1219	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1220	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1221	142371-01: Sun Studio 12.1 Update 1: Patch for dbx
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1222	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1223	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1224	143384-02: Sun Studio 12 Update 1: Patch for debuginfo handling
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1225	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1226	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1227	143385-02: Sun Studio 12 Update 1: Patch for Compiler Common patch for Sun C C++ F77 F95
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1228	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1229	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1230	142369-01: Sun Studio 12.1: Patch for Performance Analyzer Tools
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1231	</li>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1232	</ul>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1233	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1234	The Solaris X86 patch list is:
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1235	<ul>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1236	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1237	119961-07: SunOS 5.10_x86, x64, Patch for profiling libraries and assembler
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1238	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1239	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1240	119964-21: SunOS 5.10_x86: Shared library patch for C++_x86
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1241	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1242	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1243	120754-08: SunOS 5.10_x86: Microtasking libraries (libmtsk) patch
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1244	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1245	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1246	141858-06: Sun Studio 12 Update 1_x86: Sun Compiler Common patch for x86 backend
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1247	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1248	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1249	128229-09: Sun Studio 12 Update 1_x86: Patch for C++ Compiler
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1250	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1251	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1252	142363-05: Sun Studio 12 Update 1_x86: Patch for C Compiler
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1253	</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1254	<li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1255	142368-01: Sun Studio 12.1_x86: Patch for Performance Analyzer Tools
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1256	</li>
6366 f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches) ohair parents: 5660 diff changeset	1257	</ul>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1258	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1259	Set
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1260	<a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1261	to point to the location of
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1262	the compiler binaries, and place this location in the <tt>PATH</tt>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1263	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1264	The Oracle Solaris Studio Express compilers at:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1265	<a href="http://developers.sun.com/sunstudio/downloads/express.jsp" target="_blank">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1266	Oracle Solaris Studio Express Download site</a>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1267	are also an option, although these compilers have not
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1268	been extensively used yet.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1269	</blockquote>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1270	<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	1271	<blockquote>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1272	<p>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1273	<b>BEGIN WARNING</b>: JDK 7 has transitioned to
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1274	use the newest VS2010 Microsoft compilers.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1275	No other compilers are known to build the entire JDK,
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1276	including non-open portions.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1277	Visual Studio 2010 Express compilers are now able to build all the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1278	open source repositories, but this is 32 bit only. To build 64 bit
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1279	Windows binaries use the the 7.1 Windows SDK.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1280	<b>END WARNING.</b>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1281	<p>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1282	The 32-bit OpenJDK Windows build requires
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1283	Microsoft Visual Studio C++ 2010 (VS2010) Professional
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1284	Edition or Express compiler.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1285	The compiler and other tools are expected to reside
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1286	in the location defined by the variable
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1287	<tt>VS100COMNTOOLS</tt> which
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1288	is set by the Microsoft Visual Studio installer.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1289	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1290	Once the compiler is installed,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1291	it is recommended that you run <tt>VCVARS32.BAT</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1292	to set the compiler environment variables
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1293	<tt>INCLUDE</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1294	<tt>LIB</tt>, and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1295	<tt>PATH</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1296	prior to building the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1297	OpenJDK.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1298	The above environment variables <b>MUST</b> be set.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1299	This compiler also contains the Windows SDK v 7.0a,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1300	which is an update to the Windows 7 SDK.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1301	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1302	<b>WARNING:</b> Make sure you check out the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1303	<a href="#cygwin">CYGWIN link.exe WARNING</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1304	The path <tt>/usr/bin</tt> must be after the path to the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1305	Visual Studio product.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1306	</blockquote>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1307	<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	1308	<blockquote>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1309	For <b>X64</b>, the 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	1310	except that you run <tt>amd64\VCVARS64.BAT</tt>
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1311	to set the compiler environment variables.
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1312	Previously 64 bit builds had to use the 64 bit compiler in
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1313	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	1314	you have VS2010 Professional.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1315	</blockquote>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1316	<strong><a name="mssdk64">Windows x64: Microsoft Windows 7.1 SDK 64 bit compilers.</a></strong>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1317	For a free alternative for 64 bit builds, use the 7.1 SDK.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1318	Microsoft say that to set up your paths for this run
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1319	<pre>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1320	c:\Program Files\Microsoft SDKs\Windows\v7.1\bin\setenv.cmd /x64.
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1321	</pre>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1322	What was tested is just directly setting up LIB, INCLUDE,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1323	PATH and based on the installation directories using the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1324	DOS short name appropriate for the system, (you will
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1325	need to set them for yours, not just blindly copy this) eg :
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1326	<pre>
5660 1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers prr parents: 5397 diff changeset	1327	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	1328	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	1329	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	1330	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	1331	set LIB=%VSINSTALLDIR%\vc\lib\amd64;%WindowsSdkDir%\lib\x64
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1332	</pre>
12494 6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1333	<strong><a name="llvmgcc">OS X Lion 10.7.3: LLVM GCC</a></strong>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1334	<blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1335	LLVM GCC is bundled with XCode. The version should be at least 4.2.1.
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html ewendeli parents: 10208 diff changeset	1336	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1337	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1338	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1339	<h4><a name="zip">Zip and Unzip</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1340	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1341	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	1342	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	1343	to build the JDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1344	With Solaris, Linux, and Windows CYGWIN, the zip and unzip
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1345	utilities installed on the system should be fine.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1346	Information and the source code for
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1347	ZIP.EXE and UNZIP.EXE is available on the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1348	<a href="http://www.info-zip.org"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1349	target="_blank">info-zip web site</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1350	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1351	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1352	<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	1353	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1354	<strong>Solaris:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1355	CUPS header files are required for building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1356	OpenJDK on Solaris.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1357	The Solaris header files can be obtained by installing
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1358	the package <strong>SFWcups</strong> from the Solaris Software
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1359	Companion CD/DVD, these often will be installed into
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1360	<tt>/opt/sfw/cups</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1361	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1362	<strong>Linux:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1363	CUPS header files are required for building the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1364	OpenJDK on Linux.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1365	The Linux header files are usually available from a "cups"
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1366	development package, it's recommended that you try and use
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1367	the package provided by the particular version of Linux that
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1368	you are using.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1369	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1370	The CUPS header files can always be downloaded from
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1371	<a href="http://www.cups.org" target="_blank">www.cups.org</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1372	The variable
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1373	<tt><a href="#ALT_CUPS_HEADERS_PATH">ALT_CUPS_HEADERS_PATH</a></tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1374	can be used to override the default location of the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1375	CUPS Header files.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1376	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1377	<!-- ------------------------------------------------------ -->
2908 6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1378	<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	1379	<blockquote>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1380	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1381	<strong>Solaris:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1382	XRender header files are required for building the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1383	OpenJDK on Solaris.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1384	The XRender header file is included with the other X11 header files
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1385	in the package <strong>SFWxwinc</strong> on new enough versions of
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1386	Solaris and will be installed in
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1387	<tt>/usr/X11/include/X11/extensions/Xrender.h</tt> or
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1388	<tt>/usr/openwin/share/include/X11/extensions/Xrender.h</tt>
2908 6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1389	</p><p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1390	<strong>Linux:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1391	XRender header files are required for building the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1392	OpenJDK on Linux.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1393	The Linux header files are usually available from a "Xrender"
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1394	development package, it's recommended that you try and use
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1395	the package provided by the particular distribution of Linux that
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1396	you are using.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1397	</p>
2908 6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1398	</blockquote>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header andrew parents: 2557 diff changeset	1399	<!-- ------------------------------------------------------ -->
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1400	<h4><a name="freetype">FreeType 2</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1401	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1402	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	1403	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	1404	distribution (while you still may need to upgrade them).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1405	Note that you need development version of package that
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1406	includes both FreeType library and header files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1407	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1408	You can always download latest FreeType version from the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1409	<a href="http://www.freetype.org" target="_blank">FreeType website</a>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1410	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1411	Makefiles will try to pick FreeType from /usr/lib and /usr/include.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1412	In case it is installed elsewhere you will need to set environment
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1413	variables
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1414	<tt><a href="#ALT_FREETYPE_LIB_PATH">ALT_FREETYPE_LIB_PATH</a></tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1415	and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1416	<tt><a href="#ALT_FREETYPE_HEADERS_PATH">ALT_FREETYPE_HEADERS_PATH</a></tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1417	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	1418	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1419	Building the freetype 2 libraries from scratch is also possible,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1420	however on Windows refer to the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1421	<a href="http://freetype.freedesktop.org/wiki/FreeType_DLL">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1422	Windows FreeType DLL build instructions</a>.
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1423	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1424	Note that by default FreeType is built with byte code hinting
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1425	support disabled due to licensing restrictions.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1426	In this case, text appearance and metrics are expected to
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1427	differ from Sun's official JDK build.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1428	See
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1429	<a href="http://freetype.sourceforge.net/freetype2/index.html">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1430	the SourceForge FreeType2 Home Page
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1431	</a>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1432	for more information.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1433	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1434	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1435	<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	1436	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1437	<strong>Linux only:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1438	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	1439	required for building the OpenJDK on Linux.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1440	These Linux files are usually available from an "alsa"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1441	of "libasound"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1442	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	1443	the package provided by the particular version of Linux that
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1444	you are using.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1445	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	1446	missing or the wrong version.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1447	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1448	In particular, older Linux systems will likely not have the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1449	right version of ALSA installed, for example
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1450	Redhat AS 2.1 U2 and SuSE 8.1 do not include a sufficiently
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1451	recent ALSA distribution.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1452	On rpm-based systems, you can see if ALSA is installed by
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1453	running this command:
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1454	<pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1455	<tt>rpm -qa \| grep alsa</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1456	</pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1457	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	1458	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1459	If your distribution does not come with ALSA, and you can't
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1460	find ALSA packages built for your particular system,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1461	you can try to install the pre-built ALSA rpm packages from
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1462	<a href="http://www.freshrpms.net/" target="_blank">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1463	<tt>www.freshrpms.net</tt></a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1464	Note that installing a newer ALSA could
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1465	break sound output if an older version of ALSA was previously
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1466	installed on the system, but it will enable JDK compilation.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1467	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1468	Installation: execute as root<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1469	[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	1470	[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	1471	Uninstallation:<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1472	[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	1473	[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	1474	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	1475	(<tt>libasound.a</tt>),
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1476	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	1477	correctly installed in <tt>/usr/lib</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1478	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1479	As a last resort you can go to the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1480	<a href="http://www.alsa-project.org" target="_blank">
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1481	Advanced Linux Sound Architecture Site</a> and build it from
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1482	source.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1483	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1484	Download driver and library
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1485	source tarballs from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1486	<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	1487	As root, execute the following
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1488	commands (you may need to adapt the version number):
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1489	<pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1490	<tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1491	$ tar xjf alsa-driver-0.9.1.tar.bz2
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1492	$ cd alsa-driver-0.9.1
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1493	$ ./configure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1494	$ make install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1495	$ cd ..
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1496	$ tar xjf alsa-lib-0.9.1.tar.bz2
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1497	$ cd alsa-lib-0.9.1
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1498	$ ./configure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1499	$ make install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1500	</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1501	</pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1502	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	1503	ALSA's home page.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1504	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1505	Note that this is a minimum install that enables
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1506	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	1507	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	1508	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1509	ALSA can be uninstalled by executing <tt>make uninstall</tt> first in
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1510	the <tt>alsa-lib-0.9.1</tt> directory and then in
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1511	<tt>alsa-driver-0.9.1</tt>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1512	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1513	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	1514	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	1515	<tt>/usr/include/alsa</tt> and <tt>/usr/lib/libasound.so</tt>.
0 fd16c54261b3 Initial load duke parents: diff changeset	1516	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1517	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1518	<h4>Windows Specific Dependencies</h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1519	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1520	<strong>Unix Command Tools (<a name="cygwin">CYGWIN</a>)</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1521	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1522	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	1523	on Windows which can be supplied by
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1524	<a href="http://www.cygwin.com" target="_blank">CYGWIN</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1525	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1526	The OpenJDK build requires CYGWIN version 1.5.12 or newer.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1527	Information about CYGWIN can
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1528	be obtained from the CYGWIN website at
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1529	<a href="http://www.cygwin.com" target="_blank">www.cygwin.com</a>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1530	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1531	By default CYGWIN doesn't install all the tools required for building
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1532	the OpenJDK.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1533	Along with the default installation, you need to install
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1534	the following tools.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1535	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1536	<table border="1">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1537	<thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1538	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1539	<td>Binary Name</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1540	<td>Category</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1541	<td>Package</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1542	<td>Description</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1543	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1544	</thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1545	<tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1546	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1547	<td>ar.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1548	<td>Devel</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1549	<td>binutils</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1550	<td>The GNU assembler, linker and binary
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1551	utilities</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1552	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1553	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1554	<td>make.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1555	<td>Devel</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1556	<td>make</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1557	<td>The GNU version of the 'make' utility built for CYGWIN.<br>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1558	<b>NOTE</b>: the Cygwin make can not be used to build the
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1559	OpenJDK. You only need it to build your own version of make
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1560	(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	1561	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1562	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1563	<td>m4.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1564	<td>Interpreters</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1565	<td>m4</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1566	<td>GNU implementation of the traditional Unix macro
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1567	processor</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1568	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1569	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1570	<td>cpio.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1571	<td>Utils</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1572	<td>cpio</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1573	<td>A program to manage archives of files</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1574	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1575	<tr>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1576	<td>gawk.exe</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1577	<td>Utils</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1578	<td>awk</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1579	<td>Pattern-directed scanning and processing language</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1580	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1581	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1582	<td>file.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1583	<td>Utils</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1584	<td>file</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1585	<td>Determines file type using 'magic' numbers</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1586	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1587	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1588	<td>zip.exe</td>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1589	<td>Archive</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1590	<td>zip</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1591	<td>Package and compress (archive) files</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1592	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1593	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1594	<td>unzip.exe</td>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1595	<td>Archive</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1596	<td>unzip</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1597	<td>Extract compressed files in a ZIP archive</td>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1598	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1599	<tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1600	<td>free.exe</td>
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1601	<td>System</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1602	<td>procps</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1603	<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	1604	</tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1605	</tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1606	</table>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1607	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1608	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1609	Note that the CYGWIN software can conflict with other non-CYGWIN
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1610	software on your Windows system.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1611	CYGWIN provides a
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1612	<a href="http://cygwin.com/faq/faq.using.html" target="_blank">FAQ</a> for
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1613	known issues and problems, of particular interest is the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1614	section on
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1615	<a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1616	BLODA (applications that interfere with CYGWIN)</a>.
1119 a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes ohair parents: 876 diff changeset	1617	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1618	<b>WARNING:</b>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1619	Be very careful with <b><tt>link.exe</tt></b>, it will conflict
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1620	with the Visual Studio version. You need the Visual Studio
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1621	version of <tt>link.exe</tt>, not the CYGWIN one.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1622	So it's important that the Visual Studio paths in PATH preceed
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1623	the CYGWIN path <tt>/usr/bin</tt>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1624	</blockquote>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1625	<strong> Minimalist GNU for Windows (<a name="msys">MinGW/MSYS</a>)</strong>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1626	<blockquote>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1627	Alternatively, the set of unix command tools for the OpenJDK build on
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1628	Windows can be supplied by
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1629	<a href="http://www.mingw.org/wiki/MSYS" target="_blank">MinGW/MSYS</a>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1630	<p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1631	In addition to the tools which will be installed by default, you have
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1632	to manually install the <tt>msys-zip</tt> and <tt>msys-unzip</tt> packages.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1633	This can be easily done with the MinGW command line installer:<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1634	<tt><br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1635	mingw-get.exe install msys-zip<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1636	mingw-get.exe install msys-unzip<br/>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1637	</tt>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1638	</p>
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1639	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1640	<strong><a name="dxsdk">Microsoft DirectX 9.0 SDK header files and libraries</a></strong>
0 fd16c54261b3 Initial load duke parents: diff changeset	1641	<blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1642	Microsoft DirectX 9.0 SDK (Summer 2004)
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1643	headers are required for building
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1644	OpenJDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1645	This SDK can be downloaded from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1646	<a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=FD044A42-9912-42A3-9A9E-D857199F888E&displaylang=en" target="_blank">
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1647	Microsoft DirectX 9.0 SDK (Summer 2004)</a>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1648	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	1649	<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	1650	(search with "DirectX 9.0 SDK Update Summer 2004").
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1651	The location of this SDK can be set with
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1652	<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	1653	but it's normally found via the DirectX environment variable
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1654	<tt>DXSDK_DIR</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1655	</blockquote>
7876 c2a288bdcca1 6950375: Remove msvcrt.dll from the Windows JRE bundles ohair parents: 7652 diff changeset	1656	<strong><a name="msvcrNN"><tt>MSVCR100.DLL</tt></a></strong>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1657	<blockquote>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1658	The OpenJDK build requires access to a redistributable
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1659	<tt>MSVCR100.DLL</tt>.
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1660	This is usually picked up automatically from the redist
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1661	directories of Visual Studio 2010.
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1662	If this cannot be found set the
7876 c2a288bdcca1 6950375: Remove msvcrt.dll from the Windows JRE bundles ohair parents: 7652 diff changeset	1663	<a href="#ALT_MSVCRNN_DLL_PATH"><tt>ALT_MSVCRNN_DLL_PATH</tt></a>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1664	variable to the location of this file.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1665	<p>
0 fd16c54261b3 Initial load duke parents: diff changeset	1666	</blockquote>
fd16c54261b3 Initial load duke parents: diff changeset	1667	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1668	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1669	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1670	<h2><a name="creating">Creating the Build</a></h2>
0 fd16c54261b3 Initial load duke parents: diff changeset	1671	<blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1672	Once a machine is setup to build the OpenJDK,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1673	the steps to create the build are fairly simple.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1674	The various ALT settings can either be made into variables
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1675	or can be supplied on the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1676	<a href="#gmake"><tt><i>gmake</i></tt></a>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1677	command.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1678	<ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1679	<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	1680	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1681	<tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1682	<i>gmake</i>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1683	sanity
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1684	[ARCH_DATA_MODEL=<i>32 or 64</i>]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1685	[other "ALT_" overrides]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1686	</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1687	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1688	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1689	<li>Start the build with the command:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1690	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1691	<tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1692	<i>gmake</i>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1693	[ARCH_DATA_MODEL=<i>32 or 64</i>]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1694	[ALT_OUTPUTDIR=<i>output_directory</i>]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1695	[other "ALT_" overrides]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1696	</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1697	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1698	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1699	</ol>
0 fd16c54261b3 Initial load duke parents: diff changeset	1700	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1701	<strong>Solaris:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1702	Note that ARCH_DATA_MODEL is really only needed on Solaris to
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1703	indicate you want to built the 64-bit version.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1704	And before the Solaris 64-bit binaries can be used, they
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1705	must be merged with the binaries from a separate 32-bit build.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1706	The merged binaries may then be used in either 32-bit or 64-bit mode, with
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1707	the selection occurring at runtime
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1708	with the <tt>-d32</tt> or <tt>-d64</tt> options.
0 fd16c54261b3 Initial load duke parents: diff changeset	1709	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1710	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1711	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1712	<h2><a name="testing">Testing the Build</a></h2>
0 fd16c54261b3 Initial load duke parents: diff changeset	1713	<blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1714	When the build is completed, you should see the generated
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1715	binaries and associated files in the <tt>j2sdk-image</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1716	directory in the output directory.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1717	The default output directory is
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1718	<tt>build/<i>platform</i></tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1719	where <tt><i>platform</i></tt> is one of
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1720	<blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1721	<ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1722	<li><tt>solaris-sparc</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1723	<li><tt>solaris-sparcv9</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1724	<li><tt>solaris-i586</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1725	<li><tt>solaris-amd64</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1726	<li><tt>linux-i586</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1727	<li><tt>linux-amd64</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1728	<li><tt>windows-i586</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1729	<li><tt>windows-amd64</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1730	</ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1731	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1732	In particular, the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1733	<tt>build/<i>platform</i>/j2sdk-image/bin</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1734	directory should contain executables for the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1735	OpenJDK tools and utilities.
0 fd16c54261b3 Initial load duke parents: diff changeset	1736	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1737	You can test that the build completed properly by using the build
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1738	to run the various demos that you will find in the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1739	<tt>build/<i>platform</i>/j2sdk-image/demo</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1740	directory.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1741	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1742	The provided regression tests can be run with the <tt>jtreg</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1743	utility from
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1744	<a href="http://openjdk.java.net/jtreg/" target="_blank">the jtreg site</a>.
0 fd16c54261b3 Initial load duke parents: diff changeset	1745	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1746	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1747	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1748	<h2><a name="variables">Environment/Make Variables</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1749	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1750	Some of the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1751	environment or make variables (just called <b>variables</b> in this
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1752	document) that can impact the build are:
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1753	<blockquote>
0 fd16c54261b3 Initial load duke parents: diff changeset	1754	<dl>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1755	<dt><a name="path"><tt>PATH</tt></a> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1756	<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	1757	<ul>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1758	<li>The location of the GNU make binary</li>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1759	<li>The location of the Bootstrap JDK <tt>java</tt>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1760	(see <a href="#bootjdk">Bootstrap JDK</a>)</li>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1761	<li>The location of the C/C++ compilers
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1762	(see <a href="#compilers"><tt>compilers</tt></a>)</li>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1763	<li>The location or locations for the Unix command utilities
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	1764	(e.g. <tt>/usr/bin</tt>)</li>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1765	</ul>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1766	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1767	<dt><tt>MILESTONE</tt> </dt>
0 fd16c54261b3 Initial load duke parents: diff changeset	1768	<dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1769	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	1770	The default value is "internal".
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1771	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1772	<dt><tt>BUILD_NUMBER</tt> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1773	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1774	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	1775	The default value is "b00".
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1776	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1777	<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	1778	<dd>The <tt>ARCH_DATA_MODEL</tt> variable
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1779	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	1780	binaries.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1781	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	1782	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	1783	OS being used.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1784	Normally, setting this variable is only necessary on Solaris.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1785	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	1786	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	1787	</dd>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1788	<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	1789	<dd>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1790	The location of the bootstrap JDK installation.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1791	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	1792	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	1793	always set <tt>ALT_BOOTDIR</tt> explicitly.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1794	</dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1795	<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	1796	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1797	The location of a previously built JDK installation.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1798	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	1799	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1800	<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	1801	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1802	An override for specifying the (absolute) path of where the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1803	build output is to go.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1804	The default output directory will be build/<i>platform</i>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1805	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1806	<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	1807	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1808	The location of the C/C++ compiler.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1809	The default varies depending on the platform.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1810	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1811	<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	1812	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1813	The location of the <a href="#cacerts">cacerts</a> file.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1814	The default will refer to
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1815	<tt>jdk/src/share/lib/security/cacerts</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1816	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1817	<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	1818	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1819	The location of the CUPS header files.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1820	See <a href="#cups">CUPS information</a> for more information.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1821	If this path does not exist the fallback path is
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1822	<tt>/usr/include</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1823	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1824	<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	1825	<dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1826	The location of the FreeType shared library.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1827	See <a href="#freetype">FreeType information</a> for details.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1828	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1829	<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	1830	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1831	The location of the FreeType header files.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1832	See <a href="#freetype">FreeType information</a> for details.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1833	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1834	<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	1835	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1836	The default root location of the devtools.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1837	The default value is
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1838	<tt>$(ALT_SLASH_JAVA)/devtools</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1839	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1840	<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	1841	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1842	The location of tools like the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1843	<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	1844	binaries, but might also contain the GNU make utility
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1845	(<tt><i>gmake</i></tt>).
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1846	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	1847	The default value depends on the platform and
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1848	Unix Commands being used.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1849	On Linux the default will be
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1850	<tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1851	on Solaris
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1852	<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	1853	and on Windows with CYGWIN
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1854	<tt>/usr/bin</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1855	</dd>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1856	<dt><tt><a name="ALT_DROPS_DIR">ALT_DROPS_DIR</a></tt> </dt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1857	<dd>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1858	The location of any source drop bundles
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1859	(see <a href="#drops">Managing the Source Drops</a>).
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1860	The default will be
10208 9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions neugens parents: 8720 diff changeset	1861	<tt>$(ALT_JDK_DEVTOOLS_PATH)/share/jdk8-drops</tt>.
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1862	</dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1863	<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	1864	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1865	<strong>Solaris only:</strong>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1866	An override for specifying where the Unix CCS
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1867	command set are located.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1868	The default location is <tt>/usr/ccs/bin</tt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1869	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1870	<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	1871	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1872	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	1873	of the following ALT variables.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1874	The default value is
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1875	<tt>"/java"</tt> on Solaris and Linux,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1876	<tt>"J:"</tt> on Windows.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1877	</dd>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1878	<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	1879	<dd>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1880	These are useful in managing builds on multiple platforms.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1881	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	1882	for all platforms.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1883	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	1884	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	1885	the following directories:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1886	<tt>solaris-sparc</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1887	<tt>solaris-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1888	<tt>solaris-sparcv9</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1889	<tt>solaris-amd64</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1890	<tt>linux-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1891	<tt>linux-amd64</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1892	<tt>windows-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1893	and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1894	<tt>windows-amd64</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1895	Where each of these directories contain the import JDK image
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	1896	for that platform.
0 fd16c54261b3 Initial load duke parents: diff changeset	1897	</dd>
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1898	<dt><a name="ALT_OPENWIN_HOME"><tt>ALT_OPENWIN_HOME</tt></a></dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1899	<dd>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1900	The top-level directory of the libraries and include files for the platform's
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1901	graphical programming environment. The default location is platform specific.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1902	For example, on Linux it defaults to <tt>/usr/X11R6/</tt>.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1903	</dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1904	<dt><strong>Windows specific:</strong></dt>
819 1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype ohair parents: 333 diff changeset	1905	<dd>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1906	<dl>
7649 b63dcad65b80 6360517: ALT_MSDEVTOOLS_PATH and rc.exe location, and rebase location ohair parents: 7360 diff changeset	1907	<dt><a name="ALT_WINDOWSSDKDIR"><tt>ALT_WINDOWSSDKDIR</tt></a> </dt>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1908	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1909	The location of the
7649 b63dcad65b80 6360517: ALT_MSDEVTOOLS_PATH and rc.exe location, and rebase location ohair parents: 7360 diff changeset	1910	Microsoft Windows SDK where some tools will be
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1911	located.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1912	The default is whatever WINDOWSSDKDIR is set to
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1913	(or WindowsSdkDir) or the path
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1914	<br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	1915	<tt>c:\Program Files\Microsoft SDKs\Windows\v7.0a</tt>
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1916	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1917	<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	1918	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1919	The location of the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1920	<a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1921	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	1922	variable <tt>DXSDK_DIR</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1923	failing that, look in <tt>C:/DXSDK</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1924	</dd>
5374 103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK prr parents: 4084 diff changeset	1925	<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	1926	<dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1927	The location of the
7876 c2a288bdcca1 6950375: Remove msvcrt.dll from the Windows JRE bundles ohair parents: 7652 diff changeset	1928	<a href="#msvcrNN"><tt>MSVCR100.DLL</tt></a>.
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1929	</dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	1930	</dl>
0 fd16c54261b3 Initial load duke parents: diff changeset	1931	</dd>
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1932	<dt><strong>Cross-Compilation Support:</strong></dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1933	<dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1934	<dl>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1935	<dt><a name="CROSS_COMPILE_ARCH"><tt>CROSS_COMPILE_ARCH</tt></a> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1936	<dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1937	Set to the target architecture of a cross-compilation build. If set, this
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1938	variable is used to signify that we are cross-compiling. The expectation
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1939	is that <a href="#ALT_COMPILER_PATH"><tt>ALT_COMPILER_PATH</tt></a> is set
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1940	to point to the cross-compiler and that any cross-compilation specific flags
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1941	are passed using <a href="#EXTRA_CFLAGS"><tt>EXTRA_CFLAGS</tt></a>.
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1942	The <a href="#ALT_OPENWIN_HOME"><tt>ALT_OPENWIN_HOME</tt></a> variable should
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1943	also be set to point to the graphical header files (e.g. X11) provided with
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1944	the cross-compiler.
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1945	When cross-compiling we skip execution of any demos etc that may be built, and
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1946	also skip binary-file verification.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1947	</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1948	<dt><tt><a name="EXTRA_CFLAGS">EXTRA_CFLAGS</a></tt> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1949	<dd>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1950	Used to pass cross-compilation options to the cross-compiler.
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1951	These are added to the <tt>CFLAGS</tt> and <tt>CXXFLAGS</tt> variables.
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1952	</dd>
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1953	<dt><tt><a name="USE_ONLY_BOOTDIR_TOOLS">USE_ONLY_BOOTDIR_TOOLS</a></tt> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1954	<dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1955	Used primarily for cross-compilation builds (and always set in that case)
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1956	this variable indicates that tools from the boot JDK should be used during
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1957	the build process, not the tools (<tt>javac</tt>, <tt>javah</tt>, <tt>jar</tt>)
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1958	just built (which can't execute on the build host).
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1959	</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1960	<dt><tt><a name="HOST_CC">HOST_CC</a></tt> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1961	<dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1962	The location of the C compiler to generate programs to run on the build host.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1963	Some parts of the build generate programs that are then compiled and executed
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1964	to produce other parts of the build. Normally the primary C compiler is used
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1965	to do this, but when cross-compiling that would be the cross-compiler and the
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1966	resulting program could not be executed.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1967	On Linux this defaults to <tt>/usr/bin/gcc</tt>; on other platforms it must be
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1968	set explicitly.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1969	</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1970	</dl>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1971	<dt><strong>Specialized Build Options:</strong></dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1972	<dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1973	Some build variables exist to support specialized build environments and/or specialized
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1974	build products. Their use is only supported in those contexts:
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1975	<dl>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1976	<dt><tt><a name="BUILD_CLIENT_ONLY">BUILD_CLIENT_ONLY</a></tt> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1977	<dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1978	Indicates this build will only contain the Hotspot client VM. In addition to
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1979	controlling the Hotspot build target, it ensures that we don't try to copy
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1980	any server VM files/directories, and defines a default <tt>jvm.cfg</tt> file
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1981	suitable for a client-only environment. Using this in a 64-bit build will
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1982	generate a sanity warning as 64-bit client builds are not directly supported.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1983	</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1984	<dt><tt><a name="BUILD_HEADLESS_ONLY"></a>BUILD_HEADLESS_ONLY</tt> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1985	<dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1986	Used when the build environment has no graphical capabilities at all. This
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1987	excludes building anything that requires graphical libraries to be available.
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1988	</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1989	<dt><tt><a name="JAVASE_EMBEDDED"></a>JAVASE_EMBEDDED</tt> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1990	<dd>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1991	Used to indicate this is a build of the Oracle Java SE Embedded product.
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1992	This will enable the directives included in the SE-Embedded specific build
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1993	files.
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1994	</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1995	<dt><tt><a name="LIBZIP_CAN_USE_MMAP">LIBZIP_CAN_USE_MMAP</a></tt> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1996	<dd>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1997	If set to false, disables the use of mmap by the zip utility. Otherwise,
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	1998	mmap will be used.
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	1999	</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	2000	<dt><tt><a name="COMPRESS_JARS"></a>COMPRESS_JARS</tt> </dt>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	2001	<dd>
14069 2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	2002	If set to true, causes certain jar files that would otherwise be built without
2ca7a2522cb4 7152336: Enable builds on Windows with MinGW/MSYS tbell parents: 12801 diff changeset	2003	compression, to use compression.
8720 7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	2004	</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	2005	</dl>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration dholmes parents: 8646 diff changeset	2006	</dd>
0 fd16c54261b3 Initial load duke parents: diff changeset	2007	</dl>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2008	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2009	<!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2010	<hr>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2011	<h2><a name="hints">Hints and Tips</a></h2>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2012	<blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2013	You don't have to use all these hints and tips, and in fact people do actually
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2014	build with systems that contradict these, but they might prove to be
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2015	helpful to some.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2016	<ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2017	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2018	If <tt>make sanity</tt> does not work, find out why, fix that
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2019	before going any further. Or at least understand what the
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2020	complaints are from it.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2021	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2022	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2023	JDK: Keep in mind that you are building a JDK, but you need
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2024	a JDK (BOOTDIR JDK) to build this JDK.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2025	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2026	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2027	Ant: The ant utility is a java application and besides having
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2028	ant available to you, it's important that ant finds the right
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2029	java to run with. Make sure you can type <tt>ant -version</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2030	and get clean results with no error messages.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2031	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2032	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2033	Linux: Try and favor the system packages over building your own
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2034	or getting packages from other areas.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2035	Most Linux builds should be possible with the system's
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2036	available packages.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2037	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2038	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2039	Solaris: Typically you will need to get compilers on your systems
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2040	and occasionally GNU make 3.81 if a gmake binary is not available.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2041	The gmake binary might not be 3.81, be careful.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2042	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2043	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2044	Windows VS2010:
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2045	<ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2046	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2047	Only the C++ part of VS2010 is needed.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2048	Try to let the installation go to the default install directory.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2049	Always reboot your system after installing VS2010.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2050	The system environment variable VS100COMNTOOLS should be
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2051	set in your environment.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2052	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2053	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2054	Make sure that TMP and TEMP are also set in the environment
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2055	and refer to Windows paths that exist, like <tt>C:\temp</tt>,
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2056	not <tt>/tmp</tt>, not <tt>/cygdrive/c/temp</tt>, and not <tt>C:/temp</tt>.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2057	<tt>C:\temp</tt> is just an example, it is assumed that this area is
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2058	private to the user, so by default after installs you should
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2059	see a unique user path in these variables.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2060	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2061	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2062	You need to use vsvars32.bat or vsvars64.bat to get the
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2063	PATH, INCLUDE, LIB, LIBPATH, and WINDOWSSDKDIR
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2064	variables set in your shell environment.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2065	These bat files are not easy to use from a shell environment.
10208 9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions neugens parents: 8720 diff changeset	2066	However, there is a script placed in the root jdk8 repository called
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2067	vsvars.sh that can help, it should only be done once in a shell
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2068	that will be doing the build, e.g.<br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2069	<tt>sh ./make/scripts/vsvars.sh -v10 > settings<br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2070	eval `cat settings`</tt><br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2071	Or just <tt>eval `sh ./make/scripts/vsvars.sh -v10`</tt>.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2072	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2073	</ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2074	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2075	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2076	Windows: PATH order is critical, see the
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2077	<a href="#paths">paths</a> section for more information.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2078	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2079	<li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2080	Windows 64bit builds: Use ARCH_DATA_MODEL=64.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2081	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2082	</ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2083	</blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2084	<!-- ------------------------------------------------------ -->
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2085	<hr>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2086	<h2><a name="troubleshooting">Troubleshooting</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2087	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2088	A build can fail for any number of reasons.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2089	Most failures
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2090	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	2091	pre-build requirements have not been met.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2092	The first step in
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2093	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	2094	all the pre-build requirements for your platform.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2095	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	2096	<a href="#contents">Table of Contents</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2097	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2098	You can validate your build environment by using the <tt>sanity</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2099	target.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2100	Any errors listed
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2101	will stop the build from starting, and any warnings may result in
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2102	a flawed product build.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2103	We strongly encourage you to evaluate every
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2104	sanity check warning and fix it if required, before you proceed
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2105	further with your build.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2106	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2107	Some of the more common problems with builds are briefly described
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2108	below, with suggestions for remedies.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2109	<ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2110	<li>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2111	<b>Corrupted Bundles on Windows:</b>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2112	<blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2113	Some virus scanning software has been known to corrupt the
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2114	downloading of zip bundles.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2115	It may be necessary to disable the 'on access' or 'real time'
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2116	virus scanning features to prevent this corruption.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2117	This type of "real time" virus scanning can also slow down the
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2118	build process significantly.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2119	Temporarily disabling the feature, or excluding the build
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2120	output directory may be necessary to get correct and faster builds.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2121	</blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2122	</li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2123	<li>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2124	<b>Slow Builds:</b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2125	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2126	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	2127	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	2128	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	2129	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	2130	not a good idea).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2131	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2132	Creating the javadocs can be very slow, if you are running
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2133	javadoc, consider skipping that step.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2134	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2135	Faster hardware and more RAM always helps too.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2136	The VM build tends to be CPU intensive (many C++ compiles),
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2137	and the rest of the JDK will often be disk intensive.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2138	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2139	Faster compiles are possible using a tool called
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2140	<a href="http://ccache.samba.org/" target="_blank">ccache</a>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2141	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2142	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2143	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2144	<b>File time issues:</b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2145	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2146	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	2147	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2148	<i>Warning message:</i><tt> File `xxx' has modification time in
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2149	the future.</tt>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2150	<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2151	<i>Warning message:</i> <tt> Clock skew detected. Your build may
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2152	be incomplete.</tt>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2153	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2154	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	2155	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	2156	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	2157	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	2158	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	2159	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	2160	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	2161	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	2162	in the 1.4 source code.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2163	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2164	If you see these warnings, reset the clock on the build
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2165	machine, run "<tt><i>gmake</i> clobber</tt>" or delete the directory
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2166	containing the build output, and restart the build from the beginning.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2167	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2168	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2169	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2170	<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	2171	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2172	Increase the amount of swap space on your build machine.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2173	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2174	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2175	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2176	<b>Error Message: <tt>libstdc++ not found:</tt></b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2177	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2178	This is caused by a missing libstdc++.a library.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2179	This is installed as part of a specific package
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2180	(e.g. libstdc++.so.devel.386).
1544 9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	2181	By default some 64-bit Linux versions (e.g. Fedora)
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS ohair parents: 1120 diff changeset	2182	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	2183	Various parts of the JDK build require a static
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2184	link of the C++ runtime libraries to allow for maximum
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2185	portability of the built images.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2186	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2187	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2188	<li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2189	<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	2190	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2191	This is probably an issue with SELinux (See
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2192	<a href="http://en.wikipedia.org/wiki/SELinux" target="_blank">
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2193	http://en.wikipedia.org/wiki/SELinux</a>).
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2194	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	2195	performance reasons.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2196	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2197	To completely disable SELinux:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2198	<ol>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2199	<li><tt>$ su root</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2200	<li><tt># system-config-securitylevel</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2201	<li><tt>In the window that appears, select the SELinux tab</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2202	<li><tt>Disable SELinux</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2203	</ol>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2204	<p>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2205	Alternatively, instead of completely disabling it you could
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2206	disable just this one check.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2207	<ol>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2208	<li>Select System->Administration->SELinux Management</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2209	<li>In the SELinux Management Tool which appears,
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2210	select "Boolean" from the menu on the left</li>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2211	<li>Expand the "Memory Protection" group</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2212	<li>Check the first item, labeled
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2213	"Allow all unconfined executables to use libraries requiring text relocation ..."</li>
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2214	</ol>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2215	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2216	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2217	<li>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2218	<b>Windows Error Messages:</b><br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2219	<tt>*** fatal error - couldn't allocate heap, ... </tt><br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2220	<tt>rm fails with "Directory not empty"</tt><br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2221	<tt>unzip fails with "cannot create ... Permission denied"</tt><br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2222	<tt>unzip fails with "cannot create ... Error 50"</tt><br>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2223	<blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2224	The CYGWIN software can conflict with other non-CYGWIN
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2225	software. See the CYGWIN FAQ section on
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2226	<a href="http://cygwin.com/faq/faq.using.html#faq.using.bloda" target="_blank">
7650 6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives ohair parents: 7360 diff changeset	2227	BLODA (applications that interfere with CYGWIN)</a>.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2228	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2229	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2230	<li>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2231	<b>Windows Error Message: <tt>spawn failed</tt></b>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2232	<blockquote>
8646 f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2233	Try rebooting the system, or there could be some kind of
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2234	issue with the disk or disk partition being used.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws ohair parents: 8057 diff changeset	2235	Sometimes it comes with a "Permission Denied" message.
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2236	</blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2237	</li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2238	</ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2239	</blockquote>
12801 948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2240	<!-- ------------------------------------------------------ -->
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2241	<hr>
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2242	<h2><a name="newbuild">The New Build</a></h2>
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2243	<blockquote>
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2244	The <a href="http://openjdk.java.net/projects/build-infra/">
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2245	Build Infrastructure project</a> is working on a new
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2246	build. For information on how to try it out, please see the
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2247	<a href="http://openjdk.java.net/projects/build-infra/guide.html">
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2248	Build Infra User Guide</a>
948f8ad66ee7 7170079: Adjustments to build-infra makefiles erikj parents: 12494 diff changeset	2249	</blockquote>
333 d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2250	<hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2251	</body>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug" ohair parents: 15 diff changeset	2252	</html>

author	duke
	Wed, 05 Jul 2017 18:41:15 +0200
changeset 15700	c3e8585c0ebd
parent 14069	2ca7a2522cb4
child 15787	496cd89abcc5
permissions	-rw-r--r--