README-builds.html
author erikj
Tue, 03 Jul 2012 11:45:34 -0700
changeset 13165 679567fae315
parent 12801 948f8ad66ee7
child 14069 2ca7a2522cb4
permissions -rw-r--r--
7181508: Remove GenerateNativeHeader on awt java file Reviewed-by: ohair
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    99
                                        <li>Unix Command Tools (<a href="#cygwin">CYGWIN</a>)</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   100
                                        <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
   101
                                    </ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   102
                                </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   103
                            </ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   104
                        </li>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   105
                    </ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   106
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   107
                <li><a href="#creating">Creating the Build</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   108
                <li><a href="#testing">Testing the Build</a> </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   109
                <li><a href="#variables">Environment/Make Variables</a></li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   110
                <li><a href="#troubleshooting">Troubleshooting</a></li>
12801
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
   111
                <li><a href="#newbuild">The New Build</a></li>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
   112
            </ul>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   113
        </blockquote>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   114
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
        <hr>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   117
        <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
   118
        <blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   119
            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
   120
            <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
   121
            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
   122
            <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
   123
            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
   124
            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
   125
            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
   126
            <br>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   127
            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
   128
            <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
   129
                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
   130
            section for more information.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   131
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
            <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
   134
            <blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   135
                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
   136
                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
   137
                <blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   138
                    <tt>
10208
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8720
diff changeset
   139
                        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
   140
                        <br>cd <i>YourOpenJDK</i>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   141
                        <br>sh ./get_source.sh
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   142
                    </tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   143
                </blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   144
                Once you have all the repositories, the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   145
                script <tt>make/scripts/hgforest.sh</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   146
                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
   147
                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
   148
                <blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   149
                    <tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   150
                        cd <i>YourOpenJDK</i>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   151
                        <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
   152
                    </tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   153
                </blockquote>
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
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   156
        </blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   157
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   158
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   159
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   160
        <h2><a name="MBE">Minimum Build Environments</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   161
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   162
            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
   163
            "minimum build environments" (MBE) for this 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   164
	    specific release of the JDK,
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   165
            Building with the MBE will generate the most compatible
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   166
            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
   167
            of the same base OS and hardware architecture.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   168
            These usually represent what is often called the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   169
            least common denominator platforms.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   170
            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
   171
            specific platforms, and in fact creating these specific platforms
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   172
            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
   173
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   174
                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
   175
                OpenJDK:
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   176
            <p>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   177
            <table border="1">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   178
                <thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   179
                    <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   180
                        <th>Base OS and Architecture</th>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   181
                        <th>OS</th>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   182
                        <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
   183
                        <th>BOOT JDK</th>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   184
                    </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   185
                </thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   186
                <tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   187
                    <tr>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   188
                        <td>Linux X86 (32-bit)</td>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   189
                        <td>Fedora 9</td>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   190
                        <td>gcc 4.3 </td>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   191
                        <td>JDK 6u18</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   192
                    </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   193
                    <tr>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   194
                        <td>Linux X64 (64-bit)</td>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   195
                        <td>Fedora 9</td>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   196
                        <td>gcc 4.3 </td>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   197
                        <td>JDK 6u18</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   198
                    </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   199
                    <tr>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   200
                        <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
   201
                        <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
   202
                        <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
   203
                        <td>JDK 6u18</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   204
                    </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   205
                    <tr>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   206
                        <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
   207
                        <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
   208
                        <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
   209
                        <td>JDK 6u18</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   210
                    </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   211
                    <tr>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   212
                        <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
   213
                        <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
   214
                        <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
   215
                        <td>JDK 6u18</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   216
                    </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   217
                    <tr>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   218
                        <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
   219
                        <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
   220
                        <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
   221
                        <td>JDK 6u18</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   222
                    </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   223
                    <tr>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   224
                        <td>Windows X86 (32-bit)</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   225
                        <td>Windows XP</td>
5374
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
   226
                        <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
   227
                        <td>JDK 6u18</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   228
                    </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   229
                    <tr>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   230
                        <td>Windows X64 (64-bit)</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   231
                        <td>Windows Server 2003 - Enterprise x64 Edition</td>
5374
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
   232
                        <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
   233
                        <td>JDK 6u18</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   234
                    </tr>
12494
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   235
                    <tr>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   236
                        <td>Mac OS X X64 (64-bit)</td>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   237
                        <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
   238
                        <td>XCode 4.1 or later</td>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   239
                        <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
   240
                    </tr>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   241
                </tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   242
            </table>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   243
            <p>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   244
	    These same sources do indeed build on many more systems than the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   245
	    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
   246
            <p>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   247
	    Compilation problems with newer or different C/C++ compilers is a
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   248
	    common problem.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   249
	    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
   250
                <tt>/usr/include</tt> or system header files is also a
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   251
	    common problem with newer or unreleased OS versions.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   252
	    Please report these types of problems as bugs so that they
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   253
	    can be dealt with accordingly.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   254
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   255
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   256
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   257
        <h2><a name="SDBE">Specific Developer Build Environments</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   258
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   259
            We won't be listing all the possible environments, but
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   260
            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
   261
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   262
        <!-- ------------------------------------------------------ -->
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   263
        <h3><a name="fedora">Fedora</a></h3>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   264
        <blockquote>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   265
            <h4>Fedora 9</h4>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   266
            <p>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   267
            <blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   268
                After installing <a href="http://fedoraproject.org">Fedora</a> 9
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   269
	      you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   270
	      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
   271
                <tt>root</tt>:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   272
                <p/>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   273
                <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
   274
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   275
                <code>yum install gcc gcc-c++</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   276
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   277
	      In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   278
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   279
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   280
                <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
   281
            </blockquote>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   282
            <h4>Fedora 10</h4>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   283
            <p>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   284
            <blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   285
                After installing <a href="http://fedoraproject.org">Fedora</a> 10
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   286
	      you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   287
	      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
   288
                <tt>root</tt>:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   289
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   290
                <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
   291
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   292
                <code>yum install gcc gcc-c++</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   293
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   294
	      In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   295
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   296
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   297
                <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
   298
            </blockquote>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   299
            <h4>Fedora 11</h4>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   300
            <p>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   301
            <blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   302
                After installing <a href="http://fedoraproject.org">Fedora</a> 11
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   303
	      you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   304
	      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
   305
                <tt>root</tt>:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   306
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   307
                <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
   308
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   309
                <code>yum install gcc gcc-c++</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   310
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   311
	      In addition, it's necessary to set a few environment variables for the build:
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   312
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   313
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   314
                <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
   315
            </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   316
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   317
        <!-- ------------------------------------------------------ -->
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   318
        <h3><a name="centos">CentOS 5.5</a></h3>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   319
        <blockquote>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   320
            After installing
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   321
            <a href="http://www.centos.org/">CentOS 5.5</a>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   322
            you need to make sure you have
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   323
            the following Development bundles installed:
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   324
            <blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   325
                <ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   326
                    <li>Development Libraries</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   327
                    <li>Development Tools</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   328
                    <li>Java Development</li>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   329
                    <li>X Software Development (Including XFree86-devel)</li>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   330
                </ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   331
            </blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   332
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   333
                Plus the following packages:
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   334
            <blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   335
                <ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   336
                    <li>cups devel: Cups Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   337
                    <li>alsa devel: Alsa Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   338
                    <li>ant: Ant Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   339
                    <li>Xi devel: libXi.so Development Package</li>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   340
                </ul>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   341
            </blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   342
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   343
                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
   344
                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
   345
                and installed easily enough from
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   346
                <a href="http://downloads.sourceforge.net/freetype">
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   347
                    the freetype site</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   348
                Build and install with something like:
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   349
            <blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   350
                <tt>./configure && make && sudo -u root make install</tt>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   351
            </blockquote>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
   352
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   353
                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
   354
                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
   355
                it's needed.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   356
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   357
        <!-- ------------------------------------------------------ -->
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   358
        <h3><a name="debian">Debian</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   359
        <blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   360
            <h4>Debian 5.0 (Lenny)</h4>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   361
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   362
            <blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   363
		After installing <a href="http://debian.org">Debian</a> 5 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   364
		you need to install several build dependencies. 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   365
		The simplest way to install the build dependencies is to 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   366
		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
   367
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   368
                <code>aptitude build-dep openjdk-6</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   369
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   370
                <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
   371
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   372
		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
   373
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   374
                <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
   375
            </blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   376
        </blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   377
        <!-- ====================================================== -->
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   378
        <h3><a name="ubuntu">Ubuntu</a></h3>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   379
        <blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   380
            <h4>Ubuntu 8.04</h4>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   381
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   382
            <blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   383
		After installing <a href="http://ubuntu.org">Ubuntu</a> 8.04 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   384
		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
   385
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   386
		First, you need to enable the universe repository in the 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   387
		Software Sources application and reload the repository 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   388
		information. The Software Sources application is available 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   389
		under the System/Administration menu. 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   390
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   391
		The simplest way to install the build dependencies is to 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   392
		execute the following commands:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   393
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   394
                <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
   395
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   396
                <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
   397
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   398
		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
   399
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   400
                <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
   401
            </blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   402
            <h4>Ubuntu 8.10</h4>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   403
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   404
            <blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   405
		After installing <a href="http://ubuntu.org">Ubuntu</a> 8.10 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   406
		you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   407
		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
   408
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   409
                <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
   410
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   411
                <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
   412
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   413
		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
   414
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   415
                <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
   416
            </blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   417
            <h4>Ubuntu 9.04</h4>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   418
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   419
            <blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   420
		After installing <a href="http://ubuntu.org">Ubuntu</a> 9.04 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   421
		you need to install several build dependencies. The simplest
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   422
		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
   423
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   424
                <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
   425
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   426
                <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
   427
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   428
		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
   429
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   430
                <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
   431
            </blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   432
        </blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   433
        <!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   434
        <h3><a name="opensuse">OpenSUSE</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   435
        <blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   436
            <h4>OpenSUSE 11.1</h4>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   437
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   438
            <blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   439
		After installing <a href="http://opensuse.org">OpenSUSE</a> 11.1 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   440
		you need to install several build dependencies. 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   441
		The simplest way to install the build dependencies is to 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   442
		execute the following commands:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   443
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   444
                <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
   445
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   446
                <code>sudo zypper install make</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   447
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   448
		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
   449
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   450
                <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
   451
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   452
		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
   453
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   454
                <code>export -n JAVA_HOME</code>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   455
            </blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   456
        </blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   457
        <!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   458
        <h3><a name="mandriva">Mandriva</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   459
        <blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   460
            <h4>Mandriva Linux One 2009 Spring</h4>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   461
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   462
            <blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   463
		After installing <a href="http://mandriva.org">Mandriva</a> Linux One 2009 Spring 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   464
		you need to install several build dependencies. 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   465
		The simplest way to install the build dependencies is to 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   466
		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
   467
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   468
                <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
   469
                <p/>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   470
		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
   471
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   472
                <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
   473
            </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   474
        </blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   475
        <!-- ====================================================== -->
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   476
        <h3><a name="opensolaris">OpenSolaris</a></h3>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   477
        <blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   478
            <h4>OpenSolaris 2009.06</h4>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   479
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   480
            <blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   481
		After installing <a href="http://opensolaris.org">OpenSolaris</a> 2009.06 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   482
		you need to install several build dependencies. 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   483
		The simplest way to install the build dependencies is to 
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   484
		execute the following commands:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   485
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   486
                <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
   487
                <p/>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   488
		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
   489
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   490
                <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
   491
                <p/>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   492
		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
   493
                <p/>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   494
                <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
   495
            </blockquote>
3793
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   496
        </blockquote>
9cc5500d129d 6872735: Further update build readme for new platforms
robilad
parents: 3668
diff changeset
   497
        <!-- ------------------------------------------------------ -->  
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   498
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   499
        <h2><a name="directories">Source Directory Structure</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   500
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   501
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   502
                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
   503
                directories:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   504
                <tt>hotspot</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   505
                <tt>langtools</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   506
                <tt>corba</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   507
                <tt>jaxws</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   508
                <tt>jaxp</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   509
                and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   510
                <tt>jdk</tt>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   511
                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
   512
                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
   513
                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
   514
                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
   515
                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
   516
                files for building the OpenJDK Corba files.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   517
                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
   518
                files for building the OpenJDK JAXWS files.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   519
                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
   520
                files for building the OpenJDK JAXP files.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   521
                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
   522
                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
   523
                The top level <tt>Makefile</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   524
                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
   525
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   526
            <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
   527
            <blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   528
                <p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   529
                    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
   530
                    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
   531
                    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
   532
                    <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
   533
                    <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
   534
                    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
   535
                    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
   536
                    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
   537
                    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
   538
                    website.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   539
                    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
   540
                    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
   541
                    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
   542
                    <br>
10208
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8720
diff changeset
   543
                    <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
   544
                        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
   545
                    JAX-WS sources.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   546
                </p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   547
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   548
                <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
   549
                <blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   550
                    <ol>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   551
                        <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   552
                            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
   553
                            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
   554
                            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
   555
                            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
   556
                            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
   557
                            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
   558
                            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
   559
                            OpenJDK instances of these classes.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   560
                        </li>
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
                            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
   563
                            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
   564
                            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
   565
                        </li>
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
                            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
   568
                            <tt>jaxp/jaxp.properties</tt> or
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   569
                            <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
   570
                            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
   571
                            of the zip bundle
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   572
                            (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
   573
                        </li>
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
                            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
   576
                            given CRs.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   577
                        </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   578
                    </ol>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   579
                </blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   580
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   581
                <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
   582
                <blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   583
                    <p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   584
                        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
   585
                        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
   586
                        in the environment variable
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   587
                        <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
   588
                        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
   589
                        improperly modified sources.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   590
                        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
   591
                        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
   592
                        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
   593
                        directory is explicitly deleted.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   594
                        <br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   595
                        <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
   596
                        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
   597
                        In general, doing downloads
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   598
                        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
   599
                        unpredictability in the build process.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   600
                        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
   601
                        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
   602
                        acceptable.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   603
                    </p>
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
                        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
   606
                        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
   607
                        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
   608
                        <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
   609
                        to that directory.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   610
                        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
   611
                        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
   612
                    </p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   613
                </blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   614
            </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   615
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   616
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   617
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   618
        <h2><a name="building">Build Information</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   619
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   620
            Building the OpenJDK
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   621
            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
   622
            and various
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   623
            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
   624
            to where various components have been installed.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   625
            Where possible the makefiles will attempt to located the various
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   626
            components in the default locations or any component specific 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   627
            variable settings.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   628
            When the normal defaults fail or components cannot be found,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   629
            the various
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   630
            <tt>ALT_*</tt> variables (alternates)
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   631
            can be used to help the makefiles locate components.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   632
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   633
                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
   634
                <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
   635
                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
   636
                A build could be as simple as:
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   637
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   638
                <pre><tt>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
   639
                bash
fd16c54261b3 Initial load
duke
parents:
diff changeset
   640
                . 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
   641
                <a href="#gmake"><tt>make</tt></a> sanity &amp;&amp; <a href="#gmake"><tt>make</tt></a>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   642
                </tt></pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   643
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   644
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   645
                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
   646
                But some customization will probably be necessary.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   647
                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
   648
                dependencies and generate appropriate warning messages
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   649
                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
   650
                found on your system.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   651
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   652
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   653
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   654
        <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
   655
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   656
            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
   657
            GNU version of the utility command <tt>make</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   658
            (<tt><i>gmake</i></tt>).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   659
            A few notes about using GNU make:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   660
            <ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   661
                <li>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   662
                    You need GNU make version 3.81 or newer.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   663
                </li>
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
                    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
   666
                </li>
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
                    <strong>Linux:</strong>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   669
                    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
   670
                    and should work fine for you.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   671
                    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
   672
                    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
   673
                </li>
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
                    <strong>Solaris:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   676
                    Do NOT use <tt>/usr/bin/make</tt> on Solaris.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   677
                    If your Solaris system has the software
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   678
                    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
   679
                    you should try and use <tt>gmake</tt>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   680
                    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
   681
                    <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
   682
                    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
   683
                    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
   684
                    <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
   685
                    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
   686
                    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
   687
                </li>
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
                    <strong>Windows:</strong>
4084
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin
ohair
parents: 3793
diff changeset
   690
                    Make sure you start your build inside a bash/sh/ksh shell
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin
ohair
parents: 3793
diff changeset
   691
                    and are using a <tt>make.exe</tt> utility built for that
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin
ohair
parents: 3793
diff changeset
   692
                    environment (a cygwin <tt>make.exe</tt> is not the same
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin
ohair
parents: 3793
diff changeset
   693
                    as a <tt>make.exe</tt> built for something like
ccac5c36a11c 6865492: /java/devtools/win32/bin/gnumake.exe doesn't work with cygwin
ohair
parents: 3793
diff changeset
   694
                    <a href="http://www.mkssoftware.com/">MKS</a>). 
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   695
                    <br>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   696
                    <b>WARNING:</b> Watch out on some make 3.81 versions, it may
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   697
                    not work due to a lack of support for MS-DOS drive letter paths
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   698
                    like <tt>C:/</tt> or <tt>C:\</tt>.
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   699
                    <br>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   700
                    You may be able to use the information at the
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   701
                    <a href="http://developer.mozilla.org/en/docs/Windows_build_prerequisites_using_cygwin#make" target="_blank">
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   702
                        mozilla developer center</a>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   703
                    on this topic.
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   704
                    <br>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   705
                    It's hoped that when make 3.82 starts shipping in a future cygwin
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   706
                    release that this MS-DOS path issue will be fixed.
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   707
                    <br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   708
                    It may be possible to download the version at
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   709
                    <a href="http://www.cmake.org/files/cygwin/make.exe">
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   710
                        www.cmake.org make.exe</a>.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   711
                    <br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   712
                    It might be necessary for you to build your own GNU make 3.81,
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   713
                    see the <a href="#buildgmake">"Building GNU make"</a> section
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   714
                    in that case.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   715
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   716
            </ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   717
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   718
                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
   719
                available on the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   720
                <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
   721
                    GNU make web site
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   722
                </a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   723
                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
   724
                <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
   725
                    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
   726
            </p>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   727
            <!-- ------------------------------------------------------ -->
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   728
            <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
   729
            <blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   730
                First step is to get the GNU make 3.81 source from
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   731
                <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
   732
                    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
   733
                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
   734
                on Windows:
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   735
                <ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   736
                    <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   737
                        <strong>Linux:</strong>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   738
                        <tt>./configure && make</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   739
                    </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   740
                    <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   741
                        <strong>Solaris:</strong>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   742
                        <tt>./configure && gmake CC=gcc</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   743
                    </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   744
                    <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   745
                        <strong>Windows for CYGWIN:</strong>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   746
                        <tt>./configure && make</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   747
                    </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   748
                    <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   749
                        <strong>Windows for MKS: (CYGWIN is recommended)</strong>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   750
                        <tt>./configure && make -f Makefile.win32</tt>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   751
                    </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   752
                </ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   753
            </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   754
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   755
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   756
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   757
        <h3><a name="linux">Basic Linux System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   758
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   759
            <strong>i586 only:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   760
            The minimum recommended hardware for building the Linux version
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   761
            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
   762
            approximately 1.5 GB of free disk space.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   763
            <p> 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   764
                <strong>X64 only:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   765
                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
   766
                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
   767
                approximately 4 GB of free disk space.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   768
            <p> 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   769
                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
   770
                <tt>/bin</tt> and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   771
                <tt>/usr/bin</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   772
                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
   773
                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
   774
                <tt>PATH</tt>.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   775
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   776
                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
   777
                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
   778
                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
   779
                your Linux system.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   780
                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
   781
                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
   782
                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
   783
                settings make sense for building the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   784
                OpenJDK.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   785
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   786
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   787
        <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
   788
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   789
            <ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   790
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   791
                    Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   792
                    <a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   793
                    <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   794
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   795
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   796
                    <a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   797
                    <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
   798
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   799
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   800
                    Install 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
   801
                        package</a>.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   802
                </li>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   803
                <li>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   804
                    Install
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   805
                    <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
   806
                    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
   807
                </li>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   808
            </ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   809
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   810
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   811
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   812
        <h3><a name="solaris">Basic Solaris System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   813
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   814
            The minimum recommended hardware for building the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   815
            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
   816
            For building
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   817
            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
   818
            least 512 MB of RAM are recommended. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   819
            Approximately 1.4 GB of free disk
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   820
            space is needed for a 32-bit build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   821
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   822
                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
   823
                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
   824
                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
   825
                <tt>amd64</tt>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   826
                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
   827
                for a 64-bit build.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   828
            <p> 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   829
                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
   830
                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
   831
                the Solaris operating environment.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   832
            <p> 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   833
                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
   834
                <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
   835
                    SunSolve JDK Solaris patches download page</a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   836
                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
   837
                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
   838
                been installed.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   839
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   840
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   841
        <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
   842
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   843
            <ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   844
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   845
                    Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   846
                    <a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   847
                    <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   848
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   849
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   850
                    <a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   851
                    <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
   852
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   853
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   854
                    Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   855
                    <a href="#studio">Sun Studio Compilers</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   856
                    <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
   857
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   858
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   859
                    Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   860
                    <a href="#cups">CUPS Include files</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   861
                    <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
   862
                </li>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   863
                <li>
2908
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header
andrew
parents: 2557
diff changeset
   864
                    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
   865
                </li>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header
andrew
parents: 2557
diff changeset
   866
                <li>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   867
                    Install
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   868
                    <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
   869
                    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
   870
                </li>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   871
            </ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   872
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   873
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   874
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   875
        <h3><a name="windows">Basic Windows System Setup</a></h3>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   876
        <blockquote> 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   877
            <strong>i586 only:</strong>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   878
            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
   879
            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
   880
            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
   881
            <strong>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
   882
                NOTE: The Windows build machines need to use the
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   883
                file system NTFS. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   884
                Build machines formatted to FAT32 will not work 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   885
                because FAT32 doesn't support case-sensitivity in file names.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   886
            </strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   887
            <p> 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   888
                <strong>X64 only:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   889
                The minimum recommended hardware for building
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   890
                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
   891
                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
   892
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   893
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   894
        <h4><a name="paths">Windows Paths</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   895
        <blockquote>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
   896
            <strong>Windows:</strong>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   897
            Note that GNU make is a historic utility and is based very
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   898
            heavily on shell scripting, so it does not tolerate the Windows habit
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   899
            of having spaces in pathnames or the use of the <tt>\</tt>characters in pathnames.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   900
            Luckily on most Windows systems, you can use <tt>/</tt>instead of \, and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   901
            there is always a 'short' pathname without spaces for any path that 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   902
            contains spaces.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   903
            Unfortunately, this short pathname can be somewhat dynamic and the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   904
            formula is difficult to explain.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   905
            You can use <tt>cygpath</tt> utility to map pathnames with spaces
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   906
            or the <tt>\</tt>character into the <tt>C:/</tt> style of pathname
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   907
            (called 'mixed'), e.g.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   908
            <tt>cygpath -s -m "<i>path</i>"</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   909
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   910
                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
   911
                to it into the <tt>C:/</tt> style automatically.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   912
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   913
                Note that use of CYGWIN creates a unique problem with regards to
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   914
                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
   915
                the <tt>PATH</tt> variable contains directories
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   916
                separated with the ";" character (Solaris and Linux uses ":").
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   917
                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
   918
                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
   919
                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
   920
                which CYGWIN understands, but only CYGWIN understands.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
   921
                So be careful with paths on Windows.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   922
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   923
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   924
        <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
   925
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   926
            <ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   927
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   928
                    Install the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   929
                    <a href="#cygwin">CYGWIN product</a>. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   930
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   931
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   932
                    Install the 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   933
                    <a href="#bootjdk">Bootstrap JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   934
                    <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   935
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   936
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   937
                    <a href="#importjdk">Optional Import JDK</a>, set
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   938
                    <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
   939
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   940
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   941
                    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
   942
                    <a href="#msvc32">Microsoft Visual Studio Compilers</a>).
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   943
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   944
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   945
                    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
   946
                    (see <a href="#msvc32">compilers</a>).
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   947
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   948
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   949
                    Install 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   950
                    <a href="#dxsdk">Microsoft DirectX SDK</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   951
                </li>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   952
                <li>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
   953
                    Install
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
   954
                    <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
   955
                    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
   956
                    <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
   957
                </li>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   958
            </ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   959
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   960
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   961
        <hr>
12494
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   962
        <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
   963
        <blockquote> 
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   964
            <strong>X64 only:</strong>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   965
            The minimum recommended hardware for building
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   966
            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
   967
            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
   968
            have OS X Lion 10.7.3 installed.
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   969
        </blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   970
        <!-- ------------------------------------------------------ -->
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   971
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   972
        <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
   973
        <blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   974
            <ol>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   975
                <li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   976
                    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
   977
		    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
   978
		    "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
   979
                </li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   980
                <li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   981
                    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
   982
                    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
   983
                </li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   984
                <li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   985
                    <a href="#importjdk">Optional Import JDK</a>, set
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   986
                    <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
   987
                </li>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   988
            </ol>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   989
        </blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   990
        <!-- ------------------------------------------------------ -->
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
   991
        <hr>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   992
        <h3><a name="dependencies">Build Dependencies</a></h3>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
   993
        <blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   994
            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
   995
            dependencies on components not part of the OpenJDK sources.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   996
            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
   997
            an architecture.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
   998
            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
   999
            to tell the makefiles where to locate the component.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1000
            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
  1001
            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
  1002
            install locations or through component specific variables.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1003
            <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1004
            <h4><a name="bootjdk">Bootstrap JDK</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1005
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1006
                All OpenJDK builds require access to the previously released 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1007
                JDK 6, this is often called a bootstrap JDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1008
                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
  1009
                <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
  1010
                   target="_blank">JDK 6 download site</a>.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1011
                For build performance reasons
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1012
                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
  1013
                local disk of the machine doing the build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1014
                You should always set 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1015
                <tt><a href="#ALT_BOOTDIR">ALT_BOOTDIR</a></tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1016
                to point to the location of
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1017
                the bootstrap JDK installation, this is the directory pathname
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1018
                that contains a <tt>bin, lib, and include</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1019
                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
  1020
                in the <tt>PATH</tt> environment variable, although it's
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1021
                not required.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1022
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1023
                    <strong>Solaris:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1024
                    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
  1025
                    directory <tt>/usr/jdk/instances</tt>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1026
                    If you don't set
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1027
                    <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
  1028
                    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
  1029
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1030
            <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1031
            <h4><a name="importjdk">Optional Import JDK</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1032
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1033
                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
  1034
                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
  1035
                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
  1036
                wanted to avoid repeatedly building the Hotspot VM, you could
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1037
                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
  1038
                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
  1039
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1040
            <!-- ------------------------------------------------------ -->
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1041
            <h4><a name="ant">Ant</a></h4>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1042
            <blockquote>
8057
b66ada7c8e10 7016976: Documentation for required ant version on JDK7 builds on Solaris 10 and Solaris 11
ohair
parents: 7876
diff changeset
  1043
                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
  1044
                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
  1045
                <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
  1046
                    Ant 1.7.1 archive download site</a>.
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1047
                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
  1048
                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
  1049
                <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
  1050
                to point to the location of
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1051
                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
  1052
                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
  1053
                <br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1054
                <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
  1055
                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
  1056
                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
  1057
                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
  1058
                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
  1059
            </blockquote>
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1060
            <!-- ------------------------------------------------------ -->
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1061
            <h4><a name="cacerts">Certificate Authority File (cacert)</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1062
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1063
                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
  1064
                    http://en.wikipedia.org/wiki/Certificate_Authority</a>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1065
                for a better understanding of the Certificate Authority (CA).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1066
                A certificates file named "cacerts"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1067
                represents a system-wide keystore with CA certificates. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1068
                In JDK and JRE
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1069
                binary bundles, the "cacerts" file contains root CA certificates from
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1070
                several public CAs (e.g., VeriSign, Thawte, and Baltimore).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1071
                The source contain a cacerts file
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1072
                without CA root certificates. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1073
                Formal JDK builders will need to secure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1074
                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
  1075
                own custom cacerts file. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1076
                Failure to provide a populated cacerts file
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1077
                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
  1078
                The variable 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1079
                <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
  1080
                can be used to override the default location of the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1081
                cacerts file that will get placed in your build.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1082
                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
  1083
                fine for most JDK developers.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1084
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1085
            <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1086
            <h4><a name="compilers">Compilers</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1087
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1088
                <strong><a name="gcc">Linux gcc/binutils</a></strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1089
                <blockquote>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1090
                    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
  1091
                    The compiler used should be the default compiler installed
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1092
                    in <tt>/usr/bin</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1093
                </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1094
                <strong><a name="studio">Solaris: Sun Studio</a></strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1095
                <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1096
                    At a minimum, the
6366
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches)
ohair
parents: 5660
diff changeset
  1097
                    <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
  1098
                        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
  1099
                    (containing version 5.10 of the C and C++ compilers) is required,
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches)
ohair
parents: 5660
diff changeset
  1100
		    including specific patches.
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1101
                    <p>
6366
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches)
ohair
parents: 5660
diff changeset
  1102
		    The Solaris SPARC patch list is:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1103
                    <ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1104
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1105
                            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
  1106
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1107
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1108
                            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
  1109
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1110
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1111
                            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
  1112
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1113
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1114
                            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
  1115
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1116
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1117
                            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
  1118
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1119
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1120
                            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
  1121
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1122
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1123
                            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
  1124
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1125
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1126
                            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
  1127
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1128
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1129
                            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
  1130
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1131
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1132
                            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
  1133
                        </li>
6366
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches)
ohair
parents: 5660
diff changeset
  1134
                    </ul>
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches)
ohair
parents: 5660
diff changeset
  1135
                    <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1136
                        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
  1137
                    <ul>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1138
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1139
                            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
  1140
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1141
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1142
                            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
  1143
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1144
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1145
                            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
  1146
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1147
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1148
                            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
  1149
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1150
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1151
                            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
  1152
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1153
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1154
                            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
  1155
                        </li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1156
                        <li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1157
                            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
  1158
                        </li>
6366
f2ef5ff052aa 6974017: Upgrade required Solaris Studio compilers to 5.10 (12 update 1 + patches)
ohair
parents: 5660
diff changeset
  1159
                    </ul>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1160
                    <p> 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1161
                        Set
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1162
                        <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
  1163
                        to point to the location of
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1164
                        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
  1165
                    <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1166
                        The Oracle Solaris Studio Express compilers at:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1167
                        <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
  1168
                            Oracle Solaris Studio Express Download site</a>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1169
                        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
  1170
                        been extensively used yet.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1171
                </blockquote>
5660
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers
prr
parents: 5397
diff changeset
  1172
                <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
  1173
                <blockquote>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1174
                    <p>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1175
                        <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
  1176
                        use the newest VS2010 Microsoft compilers.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1177
                        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
  1178
                        including non-open portions.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1179
                        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
  1180
                        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
  1181
                        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
  1182
                        <b>END WARNING.</b>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1183
                    <p>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1184
                        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
  1185
                        Microsoft Visual Studio C++ 2010 (VS2010) Professional
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1186
                        Edition or Express compiler.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1187
                        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
  1188
                        in the location defined by the variable
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1189
                        <tt>VS100COMNTOOLS</tt> which
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1190
                        is set by the Microsoft Visual Studio installer.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1191
                    <p> 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1192
                        Once the compiler is installed,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1193
                        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
  1194
                        to set the compiler environment variables
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1195
                        <tt>INCLUDE</tt>,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1196
                        <tt>LIB</tt>, and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1197
                        <tt>PATH</tt>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1198
                        prior to building the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1199
                        OpenJDK.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1200
                        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
  1201
                        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
  1202
                        which is an update to the Windows 7 SDK.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1203
                    <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1204
                        <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
  1205
                        <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
  1206
                        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
  1207
                        Visual Studio product.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1208
                </blockquote>
5660
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers
prr
parents: 5397
diff changeset
  1209
                <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
  1210
                <blockquote>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1211
                    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
  1212
                    except that you run <tt>amd64\VCVARS64.BAT</tt>
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
  1213
                    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
  1214
                    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
  1215
                    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
  1216
                    you have VS2010 Professional.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1217
                </blockquote>
5660
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers
prr
parents: 5397
diff changeset
  1218
                <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
  1219
                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
  1220
                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
  1221
                <pre>
5660
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers
prr
parents: 5397
diff changeset
  1222
    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
  1223
                </pre>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1224
                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
  1225
                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
  1226
                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
  1227
                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
  1228
                <pre>
5660
1cc5e6b39ea8 6961079: Build JDK7 for 64 bit Windows using free Windows 7.1 SDK 64 bit compilers
prr
parents: 5397
diff changeset
  1229
    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
  1230
    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
  1231
    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
  1232
    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
  1233
    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
  1234
                </pre>
12494
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
  1235
                <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
  1236
                <blockquote>
6cf597938c70 7154130: Add Mac OS X Instructions to README-builds.html
ewendeli
parents: 10208
diff changeset
  1237
                   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
  1238
                </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1239
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1240
            <!-- ------------------------------------------------------ --> 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1241
            <h4><a name="zip">Zip and Unzip</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1242
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1243
                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
  1244
                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
  1245
                to build the JDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1246
                With Solaris, Linux, and Windows CYGWIN, the zip and unzip
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1247
                utilities installed on the system should be fine.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1248
                Information and the source code for
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1249
                ZIP.EXE and UNZIP.EXE is available on the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1250
                <a href="http://www.info-zip.org" 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1251
                   target="_blank">info-zip web site</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1252
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1253
            <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1254
            <h4><a name="cups">Common UNIX Printing System (CUPS) Headers (Solaris &amp; Linux)</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1255
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1256
                <strong>Solaris:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1257
                CUPS header files are required for building the 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1258
                OpenJDK on Solaris.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1259
                The Solaris header files can be obtained by installing 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1260
                the package <strong>SFWcups</strong> from the Solaris Software
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1261
                Companion CD/DVD, these often will be installed into 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1262
                <tt>/opt/sfw/cups</tt>.
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
                    <strong>Linux:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1265
                    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
  1266
                    OpenJDK on Linux.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1267
                    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
  1268
                    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
  1269
                    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
  1270
                    you are using.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1271
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1272
                    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
  1273
                    <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
  1274
                    The variable
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1275
                    <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
  1276
                    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
  1277
                    CUPS Header files.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1278
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1279
            <!-- ------------------------------------------------------ -->
2908
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header
andrew
parents: 2557
diff changeset
  1280
            <h4><a name="xrender">XRender Extension Headers (Solaris &amp; Linux)</a></h4>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header
andrew
parents: 2557
diff changeset
  1281
            <blockquote>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header
andrew
parents: 2557
diff changeset
  1282
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1283
                    <strong>Solaris:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1284
                    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
  1285
                    OpenJDK on Solaris.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1286
                    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
  1287
                    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
  1288
                    Solaris and will be installed in
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1289
                    <tt>/usr/X11/include/X11/extensions/Xrender.h</tt>
2908
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header
andrew
parents: 2557
diff changeset
  1290
                </p><p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1291
                    <strong>Linux:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1292
                    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
  1293
                    OpenJDK on Linux.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1294
                    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
  1295
                    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
  1296
                    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
  1297
                    you are using.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1298
                </p>
2908
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header
andrew
parents: 2557
diff changeset
  1299
            </blockquote>
6c6ac9ff2f8c 6851515: awt_p.h incorporates a chunk of the XRender header
andrew
parents: 2557
diff changeset
  1300
            <!-- ------------------------------------------------------ -->
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1301
            <h4><a name="freetype">FreeType 2</a></h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1302
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1303
                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
  1304
                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
  1305
                distribution (while you still may need to upgrade them).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1306
                Note that you need development version of package that 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1307
                includes both FreeType library and header files.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1308
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1309
                    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
  1310
                    <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
  1311
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1312
                    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
  1313
                    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
  1314
                    variables
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1315
                    <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
  1316
                    and
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1317
                    <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
  1318
                    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
  1319
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1320
                    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
  1321
                    however on Windows refer to the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1322
                    <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
  1323
                        Windows FreeType DLL build instructions</a>.
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1324
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1325
                    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
  1326
                    support disabled due to licensing restrictions.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1327
                    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
  1328
                    differ from Sun's official JDK build.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1329
                    See
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1330
                    <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
  1331
                        the SourceForge FreeType2 Home Page
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1332
                    </a>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1333
                    for more information.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1334
            </blockquote>    
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1335
            <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1336
            <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
  1337
            <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1338
                <strong>Linux only:</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1339
                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
  1340
                required for building the OpenJDK on Linux.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1341
                These Linux files are usually available from an "alsa"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1342
                of "libasound"
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1343
                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
  1344
                the package provided by the particular version of Linux that
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1345
                you are using.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1346
                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
  1347
                missing or the wrong version.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1348
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1349
                    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
  1350
                    right version of ALSA installed, for example
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1351
                    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
  1352
                    recent ALSA distribution.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1353
                    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
  1354
                    running this command:
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1355
                <pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1356
                    <tt>rpm -qa | grep alsa</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1357
                </pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1358
                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
  1359
                <p> 
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1360
                    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
  1361
                    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
  1362
                    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
  1363
                    <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
  1364
                        <tt>www.freshrpms.net</tt></a>.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1365
                    Note that installing a newer ALSA could
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1366
                    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
  1367
                    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
  1368
                <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1369
                    Installation: execute as root<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1370
                    [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
  1371
                    [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
  1372
                    Uninstallation:<br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1373
                    [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
  1374
                    [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
  1375
                    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
  1376
                    (<tt>libasound.a</tt>),
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1377
                    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
  1378
                    correctly installed in <tt>/usr/lib</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1379
                </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1380
                As a last resort you can go to the
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1381
                <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
  1382
                    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
  1383
                source.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1384
                <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1385
                    Download driver and library
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1386
                    source tarballs from 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1387
                    <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
  1388
                    As root, execute the following
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1389
                    commands (you may need to adapt the version number):
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1390
                    <pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1391
                        <tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1392
                            $ tar xjf alsa-driver-0.9.1.tar.bz2
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1393
                            $ cd alsa-driver-0.9.1
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1394
                            $ ./configure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1395
                            $ make install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1396
                            $ cd ..
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1397
                            $ tar xjf alsa-lib-0.9.1.tar.bz2
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1398
                            $ cd alsa-lib-0.9.1
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1399
                            $ ./configure
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1400
                            $ make install
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1401
                        </tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1402
                    </pre>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1403
                    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
  1404
                    ALSA's home page.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1405
                </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1406
                Note that this is a minimum install that enables
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1407
                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
  1408
                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
  1409
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1410
                    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
  1411
                    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
  1412
                    <tt>alsa-driver-0.9.1</tt>.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1413
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1414
            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
  1415
            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
  1416
            <tt>/usr/include/alsa</tt> and <tt>/usr/lib/libasound.so</tt>.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1417
        </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1418
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1419
        <h4>Windows Specific Dependencies</h4>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1420
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1421
            <strong>Unix Command Tools (<a name="cygwin">CYGWIN</a>)</strong>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1422
            <blockquote> 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1423
                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
  1424
                on Windows which can be supplied by 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1425
                <a href="http://www.cygwin.com" target="_blank">CYGWIN</a>. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1426
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1427
                    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
  1428
                    Information about CYGWIN can
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1429
                    be obtained from the CYGWIN website at
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1430
                    <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
  1431
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1432
                    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
  1433
                    the OpenJDK.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1434
                    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
  1435
                    the following tools.
333
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
                    <table border="1">
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1438
                        <thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1439
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1440
                                <td>Binary Name</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1441
                                <td>Category</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1442
                                <td>Package</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1443
                                <td>Description</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1444
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1445
                        </thead>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1446
                        <tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1447
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1448
                                <td>ar.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1449
                                <td>Devel</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1450
                                <td>binutils</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1451
                                <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
  1452
                                    utilities</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1453
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1454
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1455
                                <td>make.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1456
                                <td>Devel</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1457
                                <td>make</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1458
                                <td>The GNU version of the 'make' utility built for CYGWIN.<br>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1459
                                    <b>NOTE</b>: See <a href="#gmake">the GNU make section</a></td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1460
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1461
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1462
                                <td>m4.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1463
                                <td>Interpreters</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1464
                                <td>m4</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1465
                                <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
  1466
                                    processor</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1467
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1468
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1469
                                <td>cpio.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1470
                                <td>Utils</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1471
                                <td>cpio</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1472
                                <td>A program to manage archives of files</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1473
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1474
                            <tr>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1475
                                <td>gawk.exe</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1476
                                <td>Utils</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1477
                                <td>awk</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1478
                                <td>Pattern-directed scanning and processing language</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1479
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1480
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1481
                                <td>file.exe</td>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1482
                                <td>Utils</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1483
                                <td>file</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1484
                                <td>Determines file type using 'magic' numbers</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1485
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1486
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1487
                                <td>zip.exe</td>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1488
                                <td>Archive</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1489
                                <td>zip</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1490
                                <td>Package and compress (archive) files</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1491
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1492
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1493
                                <td>unzip.exe</td>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1494
                                <td>Archive</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1495
                                <td>unzip</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1496
                                <td>Extract compressed files in a ZIP archive</td>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1497
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1498
                            <tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1499
                                <td>free.exe</td>
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1500
                                <td>System</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1501
                                <td>procps</td>
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1502
                                <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
  1503
                            </tr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1504
                        </tbody>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1505
                    </table>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1506
                </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1507
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1508
                    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
  1509
                    software on your Windows system.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1510
                    CYGWIN provides a
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1511
                    <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
  1512
                    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
  1513
                    section on
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1514
                    <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
  1515
                        BLODA (applications that interfere with CYGWIN)</a>.
1119
a39bfff7f8fb 6724787: OpenJDK README-builds.html suggested changes
ohair
parents: 876
diff changeset
  1516
                <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1517
                    <b>WARNING:</b>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1518
                    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
  1519
                    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
  1520
                    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
  1521
                    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
  1522
                    the CYGWIN path <tt>/usr/bin</tt>.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1523
            </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1524
            <strong><a name="dxsdk">Microsoft DirectX 9.0 SDK header files and libraries</a></strong>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1525
            <blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1526
                Microsoft DirectX 9.0 SDK (Summer 2004)
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1527
                headers are required for building
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1528
                OpenJDK.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1529
                This SDK can be downloaded from 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1530
                <a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=FD044A42-9912-42A3-9A9E-D857199F888E&amp;displaylang=en" target="_blank">
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1531
                    Microsoft DirectX 9.0 SDK (Summer 2004)</a>.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1532
                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
  1533
                <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
  1534
                (search with "DirectX 9.0 SDK Update Summer 2004"). 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1535
                The location of this SDK can be set with 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1536
                <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
  1537
                but it's normally found via the DirectX environment variable
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1538
                <tt>DXSDK_DIR</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1539
            </blockquote>
7876
c2a288bdcca1 6950375: Remove msvcrt.dll from the Windows JRE bundles
ohair
parents: 7652
diff changeset
  1540
            <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
  1541
            <blockquote> 
5374
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
  1542
                The OpenJDK build requires access to a redistributable
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
  1543
                <tt>MSVCR100.DLL</tt>.
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
  1544
                This is usually picked up automatically from the redist
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
  1545
                directories of Visual Studio 2010.
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
  1546
                If this cannot be found set the 
7876
c2a288bdcca1 6950375: Remove msvcrt.dll from the Windows JRE bundles
ohair
parents: 7652
diff changeset
  1547
                <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
  1548
                variable to the location of this file.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1549
                <p> 
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1550
            </blockquote>
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1551
        </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1552
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1553
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1554
        <h2><a name="creating">Creating the Build</a></h2>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1555
        <blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1556
            Once a machine is setup to build the OpenJDK,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1557
            the steps to create the build are fairly simple.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1558
            The various ALT settings can either be made into  variables
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1559
            or can be supplied on the 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1560
            <a href="#gmake"><tt><i>gmake</i></tt></a> 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1561
            command.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1562
            <ol>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1563
                <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
  1564
                    <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1565
                        <tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1566
                            <i>gmake</i> 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1567
                            sanity
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1568
                            [ARCH_DATA_MODEL=<i>32 or 64</i>]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1569
                            [other "ALT_" overrides]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1570
                        </tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1571
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1572
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1573
                <li>Start the build with the command:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1574
                    <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1575
                        <tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1576
                            <i>gmake</i> 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1577
                            [ARCH_DATA_MODEL=<i>32 or 64</i>]
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1578
                            [ALT_OUTPUTDIR=<i>output_directory</i>] 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1579
                            [other "ALT_" overrides] 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1580
                        </tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1581
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1582
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1583
            </ol>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1584
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1585
                <strong>Solaris:</strong>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1586
                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
  1587
                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
  1588
                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
  1589
                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
  1590
                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
  1591
                the selection occurring at runtime
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1592
                with the <tt>-d32</tt> or <tt>-d64</tt> options.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1593
        </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1594
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1595
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1596
        <h2><a name="testing">Testing the Build</a></h2>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1597
        <blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1598
            When the build is completed, you should see the generated
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1599
            binaries and associated files in the <tt>j2sdk-image</tt> 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1600
            directory in the output directory. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1601
            The default output directory is
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1602
            <tt>build/<i>platform</i></tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1603
            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
  1604
            <blockquote>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1605
                <ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1606
                    <li><tt>solaris-sparc</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1607
                    <li><tt>solaris-sparcv9</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1608
                    <li><tt>solaris-i586</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1609
                    <li><tt>solaris-amd64</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1610
                    <li><tt>linux-i586</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1611
                    <li><tt>linux-amd64</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1612
                    <li><tt>windows-i586</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1613
                    <li><tt>windows-amd64</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1614
                </ul>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1615
            </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1616
            In particular, the 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1617
            <tt>build/<i>platform</i>/j2sdk-image/bin</tt>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1618
            directory should contain executables for the 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1619
            OpenJDK tools and utilities.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1620
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1621
                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
  1622
                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
  1623
                <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
  1624
                directory.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1625
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1626
                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
  1627
                utility from
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1628
                <a href="http://openjdk.java.net/jtreg/" target="_blank">the jtreg site</a>.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1629
        </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1630
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1631
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1632
        <h2><a name="variables">Environment/Make Variables</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1633
        <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1634
            Some of the
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1635
            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
  1636
            document) that can impact the build are:
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1637
        <blockquote>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1638
            <dl>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1639
                <dt><a name="path"><tt>PATH</tt></a> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1640
                <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
  1641
                    <ul>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1642
                        <li>The location of the GNU make binary</li>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1643
                        <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
  1644
                            (see <a href="#bootjdk">Bootstrap JDK</a>)</li>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1645
                        <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
  1646
                            (see <a href="#compilers"><tt>compilers</tt></a>)</li>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1647
                        <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
  1648
                            (e.g. <tt>/usr/bin</tt>)</li>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1649
                    </ul>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1650
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1651
                <dt><tt>MILESTONE</tt> </dt>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1652
                <dd>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1653
                    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
  1654
                    The default value is "internal".
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1655
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1656
                <dt><tt>BUILD_NUMBER</tt> </dt>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1657
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1658
                    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
  1659
                    The default value is "b00".
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1660
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1661
                <dt><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
  1662
                <dd>The <tt>ARCH_DATA_MODEL</tt> variable
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1663
                    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
  1664
                    binaries. 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1665
                    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
  1666
                    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
  1667
                    OS being used.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1668
                    Normally, setting this variable is only necessary on Solaris.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1669
                    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
  1670
                    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
  1671
                </dd>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1672
                <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
  1673
                <dd>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1674
                    The location of the bootstrap JDK installation. 
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1675
                    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
  1676
                    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
  1677
                    always set <tt>ALT_BOOTDIR</tt> explicitly.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1678
                </dd>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1679
                <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
  1680
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1681
                    The location of a previously built JDK installation. 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1682
                    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
  1683
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1684
                <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
  1685
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1686
                    An override for specifying the (absolute) path of where the
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1687
                    build output is to go.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1688
                    The default output directory will be build/<i>platform</i>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1689
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1690
                <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
  1691
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1692
                    The location of the C/C++ compiler.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1693
                    The default varies depending on the platform. 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1694
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1695
                <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
  1696
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1697
                    The location of the <a href="#cacerts">cacerts</a> file.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1698
                    The default will refer to 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1699
                    <tt>jdk/src/share/lib/security/cacerts</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1700
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1701
                <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
  1702
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1703
                    The location of the CUPS header files.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1704
                    See <a href="#cups">CUPS information</a> for more information.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1705
                    If this path does not exist the fallback path is 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1706
                    <tt>/usr/include</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1707
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1708
                <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
  1709
                <dd>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1710
                    The location of the FreeType shared library. 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1711
                    See <a href="#freetype">FreeType information</a> for details. 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1712
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1713
                <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
  1714
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1715
                    The location of the FreeType header files.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1716
                    See <a href="#freetype">FreeType information</a> for details. 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1717
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1718
                <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
  1719
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1720
                    The default root location of the devtools.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1721
                    The default value is 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1722
                    <tt>$(ALT_SLASH_JAVA)/devtools</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1723
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1724
                <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
  1725
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1726
                    The location of tools like the 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1727
                    <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
  1728
                    binaries, but might also contain the GNU make utility
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1729
                    (<tt><i>gmake</i></tt>).
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1730
                    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
  1731
                    The default value depends on the platform and
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1732
                    Unix Commands being used.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1733
                    On Linux the default will be 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1734
                    <tt>$(ALT_JDK_DEVTOOLS_PATH)/linux/bin</tt>, 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1735
                    on Solaris
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1736
                    <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
  1737
                    and on Windows with CYGWIN
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1738
                    <tt>/usr/bin</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1739
                </dd>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1740
                <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
  1741
                <dd>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1742
                    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
  1743
                    (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
  1744
                    The default will be
10208
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8720
diff changeset
  1745
                    <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
  1746
                </dd>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1747
                <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
  1748
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1749
                    <strong>Solaris only:</strong>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1750
                    An override for specifying where the Unix CCS
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1751
                    command set are located.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1752
                    The default location is <tt>/usr/ccs/bin</tt> 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1753
                </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1754
                <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
  1755
                <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1756
                    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
  1757
                    of the following ALT variables.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1758
                    The default value is 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1759
                    <tt>"/java"</tt> on Solaris and Linux, 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1760
                    <tt>"J:"</tt> on Windows.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1761
                </dd>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1762
                <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
  1763
                <dd>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1764
                    These are useful in managing builds on multiple platforms.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1765
                    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
  1766
                    for all platforms. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1767
                    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
  1768
                    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
  1769
                    the following directories:
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1770
                    <tt>solaris-sparc</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1771
                    <tt>solaris-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1772
                    <tt>solaris-sparcv9</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1773
                    <tt>solaris-amd64</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1774
                    <tt>linux-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1775
                    <tt>linux-amd64</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1776
                    <tt>windows-i586</tt>,
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1777
                    and
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1778
                    <tt>windows-amd64</tt>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1779
                    Where each of these directories contain the import JDK image
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1780
                    for that platform.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1781
                </dd>
8720
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1782
                <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
  1783
                <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1784
		    The top-level directory of the libraries and include files for the platform's 
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1785
		    graphical programming environment. The default location is platform specific. 
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1786
		    For example, on Linux it defaults to <tt>/usr/X11R6/</tt>.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1787
		</dd>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1788
                <dt><strong>Windows specific:</strong></dt>
819
1196fff6b3f6 6704966: OpenJDK README needs additional info on how to build freetype
ohair
parents: 333
diff changeset
  1789
                <dd>
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1790
                    <dl>
7649
b63dcad65b80 6360517: ALT_MSDEVTOOLS_PATH and rc.exe location, and rebase location
ohair
parents: 7360
diff changeset
  1791
                        <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
  1792
                        <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1793
                            The location of the 
7649
b63dcad65b80 6360517: ALT_MSDEVTOOLS_PATH and rc.exe location, and rebase location
ohair
parents: 7360
diff changeset
  1794
                            Microsoft Windows SDK where some tools will be
b63dcad65b80 6360517: ALT_MSDEVTOOLS_PATH and rc.exe location, and rebase location
ohair
parents: 7360
diff changeset
  1795
			    located.
b63dcad65b80 6360517: ALT_MSDEVTOOLS_PATH and rc.exe location, and rebase location
ohair
parents: 7360
diff changeset
  1796
			    The default is whatever WINDOWSSDKDIR is set to
b63dcad65b80 6360517: ALT_MSDEVTOOLS_PATH and rc.exe location, and rebase location
ohair
parents: 7360
diff changeset
  1797
			    (or WindowsSdkDir) or the path
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1798
                            <br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1799
                            <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
  1800
                        </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1801
                        <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
  1802
                        <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1803
                            The location of the 
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1804
                            <a href="#dxsdk">Microsoft DirectX 9 SDK</a>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1805
                            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
  1806
                            variable <tt>DXSDK_DIR</tt>,
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1807
                            failing that, look in <tt>C:/DXSDK</tt>.
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1808
                        </dd>
5374
103a61b57f0e 6931180: Migration to recent versions of MS Platform SDK
prr
parents: 4084
diff changeset
  1809
                        <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
  1810
                        <dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1811
                            The location of the 
7876
c2a288bdcca1 6950375: Remove msvcrt.dll from the Windows JRE bundles
ohair
parents: 7652
diff changeset
  1812
                            <a href="#msvcrNN"><tt>MSVCR100.DLL</tt></a>. 
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1813
                        </dd>
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  1814
                    </dl>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1815
                </dd>
8720
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1816
                <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
  1817
                <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1818
                    <dl>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1819
                        <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
  1820
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1821
                            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
  1822
                            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
  1823
                            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
  1824
                            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
  1825
                            are passed using <a href="#EXTRA_CFLAGS"><tt>EXTRA_CFLAGS</tt></a>.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1826
			    The <a href="#ALT_OPENWIN_HOME"><tt>ALT_OPENWIN_HOME</tt></a> variable should 
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1827
			    also be set to point to the graphical header files (e.g. X11) provided with 
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1828
			    the cross-compiler.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1829
                            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
  1830
                            also skip binary-file verification.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1831
                        </dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1832
                        <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
  1833
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1834
			   Used to pass cross-compilation options to the cross-compiler.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1835
                           These are added to the <tt>CFLAGS</tt> and <tt>CXXFLAGS</tt> variables. 
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1836
			</dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1837
                        <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
  1838
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1839
                            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
  1840
                            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
  1841
                            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
  1842
                            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
  1843
                        </dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1844
                        <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
  1845
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1846
                            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
  1847
                            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
  1848
                            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
  1849
                            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
  1850
                            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
  1851
                            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
  1852
                            set explicitly.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1853
                        </dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1854
                    </dl>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1855
                <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
  1856
                <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1857
                  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
  1858
                  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
  1859
                    <dl>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1860
                        <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
  1861
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1862
                            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
  1863
                            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
  1864
                            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
  1865
                            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
  1866
                            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
  1867
                        </dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1868
                        <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
  1869
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1870
                            Used when the build environment has no graphical capabilities at all. This
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1871
			    excludes building anything that requires graphical libraries to be available.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1872
                        </dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1873
                        <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
  1874
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1875
			    Used to indicate this is a build of the Oracle Java SE Embedded product. 
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1876
			    This will enable the directives included in the SE-Embedded specific build 
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1877
			    files.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1878
                        </dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1879
                        <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
  1880
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1881
			    If set to false, disables the use of mmap by the zip utility. Otherwise,
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1882
	                    mmap will be used.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1883
                        </dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1884
                        <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
  1885
                        <dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1886
			  If set to true, causes certain jar files that would otherwise be built without
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1887
			  compression, to use compression.
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1888
                        </dd>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1889
                    </dl>
7f6088f46813 7030131: Update README-builds.html to cover changes introduced by SE-Embedded integration
dholmes
parents: 8646
diff changeset
  1890
                </dd>
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
  1891
            </dl>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1892
        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1893
        <!-- ------------------------------------------------------ -->
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1894
        <hr>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1895
        <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
  1896
        <blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1897
            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
  1898
            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
  1899
            helpful to some.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1900
            <ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1901
                <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1902
                    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
  1903
                    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
  1904
                    complaints are from it.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1905
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1906
                <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1907
                    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
  1908
                    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
  1909
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1910
                <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1911
                    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
  1912
                    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
  1913
                    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
  1914
                    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
  1915
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1916
                <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1917
                    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
  1918
                    or getting packages from other areas.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1919
                    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
  1920
                    available packages.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1921
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1922
                <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1923
                    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
  1924
                    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
  1925
                    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
  1926
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1927
                <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1928
                    Windows VS2010:
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1929
                    <ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1930
                        <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1931
                            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
  1932
                            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
  1933
                            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
  1934
                            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
  1935
                            set in your environment.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1936
                        </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1937
                        <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1938
                            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
  1939
                            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
  1940
                            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
  1941
                            <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
  1942
                            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
  1943
                            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
  1944
                        </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1945
                        <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1946
                            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
  1947
                            PATH, INCLUDE, LIB, LIBPATH, and WINDOWSSDKDIR
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1948
                            variables set in your shell environment.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1949
                            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
  1950
                            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
  1951
                            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
  1952
                            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
  1953
                            <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
  1954
                                eval `cat settings`</tt><br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1955
                            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
  1956
                        </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1957
                    </ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1958
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1959
                <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1960
                    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
  1961
                    <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
  1962
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1963
                <li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1964
                    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
  1965
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1966
            </ul>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1967
        </blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1968
        <!-- ------------------------------------------------------ -->
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1969
        <hr>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1970
        <h2><a name="troubleshooting">Troubleshooting</a></h2>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1971
        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1972
            A build can fail for any number of reasons. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1973
            Most failures
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1974
            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
  1975
            pre-build requirements have not been met. 
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1976
            The first step in
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1977
            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
  1978
            all the pre-build requirements for your platform.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1979
            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
  1980
            <a href="#contents">Table of Contents</a>.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1981
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1982
                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
  1983
                target.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1984
                Any errors listed
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1985
                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
  1986
                a flawed product build.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1987
                We strongly encourage you to evaluate every
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1988
                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
  1989
                further with your build.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1990
            <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  1991
                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
  1992
                below, with suggestions for remedies.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1993
            <ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  1994
                <li>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1995
                    <b>Corrupted Bundles on Windows:</b>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1996
                    <blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1997
                        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
  1998
                        downloading of zip bundles.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  1999
                        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
  2000
                        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
  2001
                        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
  2002
                        build process significantly.
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  2003
                        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
  2004
                        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
  2005
                    </blockquote>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  2006
                </li>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  2007
                <li>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2008
                    <b>Slow Builds:</b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2009
                    <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2010
                        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
  2011
                        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
  2012
                        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
  2013
                        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
  2014
                        not a good idea).
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2015
                        <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2016
                            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
  2017
                            javadoc, consider skipping that step.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2018
                        <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2019
                            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
  2020
                            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
  2021
                            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
  2022
                        <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2023
                            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
  2024
                            <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
  2025
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2026
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2027
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2028
                    <b>File time issues:</b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2029
                    <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2030
                        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
  2031
                        <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2032
                            <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
  2033
                                the future.</tt>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2034
                            <br>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2035
                            <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
  2036
                                be incomplete.</tt>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2037
                        </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2038
                        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
  2039
                        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
  2040
                        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
  2041
                        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
  2042
                        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
  2043
                        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
  2044
                        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
  2045
                        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
  2046
                        in the 1.4 source code.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2047
                        <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2048
                            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
  2049
                            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
  2050
                            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
  2051
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2052
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2053
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2054
                    <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
  2055
                    <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2056
                        Increase the amount of swap space on your build machine.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2057
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2058
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2059
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2060
                    <b>Error Message: <tt>libstdc++ not found:</tt></b>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2061
                    <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2062
                        This is caused by a missing libstdc++.a library.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2063
                        This is installed as part of a specific package
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2064
                        (e.g. libstdc++.so.devel.386).
1544
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  2065
                        By default some 64-bit Linux versions (e.g. Fedora)
9d3c7a336f93 6750229: Upgrade Recommended Linux and Windows Build OS
ohair
parents: 1120
diff changeset
  2066
                        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
  2067
                        Various parts of the JDK build require a static
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2068
                        link of the C++ runtime libraries to allow for maximum
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2069
                        portability of the built images.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2070
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2071
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2072
                <li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2073
                    <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
  2074
                    <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2075
                        This is probably an issue with SELinux (See
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2076
                        <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
  2077
                            http://en.wikipedia.org/wiki/SELinux</a>).
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2078
                        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
  2079
                        performance reasons.
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2080
                        <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2081
                            To completely disable SELinux:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2082
                        <ol>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2083
                            <li><tt>$ su root</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2084
                            <li><tt># system-config-securitylevel</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2085
                            <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
  2086
                            <li><tt>Disable SELinux</tt></li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2087
                        </ol>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2088
                        <p>
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2089
                            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
  2090
                            disable just this one check.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2091
                        <ol>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2092
                            <li>Select System->Administration->SELinux Management</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2093
                            <li>In the SELinux Management Tool which appears,
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2094
                                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
  2095
                            <li>Expand the "Memory Protection" group</li>
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
  2096
                            <li>Check the first item, labeled
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2097
                                "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
  2098
                        </ol>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2099
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2100
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2101
                <li>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  2102
                    <b>Windows Error Messages:</b><br>
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  2103
                    <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
  2104
                    <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
  2105
                    <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
  2106
                    <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
  2107
                    <blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2108
                        The CYGWIN software can conflict with other non-CYGWIN
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2109
                        software. See the CYGWIN FAQ section on
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2110
                        <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
  2111
                            BLODA (applications that interfere with CYGWIN)</a>.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2112
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2113
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2114
                <li>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  2115
                    <b>Windows Error Message: <tt>spawn failed</tt></b>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2116
                    <blockquote>
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 8057
diff changeset
  2117
                        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
  2118
                        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
  2119
                        Sometimes it comes with a "Permission Denied" message.
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2120
                    </blockquote>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2121
                </li>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2122
            </ul>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2123
        </blockquote>
12801
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2124
        <!-- ------------------------------------------------------ -->
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2125
        <hr>
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2126
        <h2><a name="newbuild">The New Build</a></h2>
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2127
        <blockquote>
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2128
            The <a href="http://openjdk.java.net/projects/build-infra/">
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2129
            Build Infrastructure project</a> is working on a new 
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2130
            build. For information on how to try it out, please see the
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2131
            <a href="http://openjdk.java.net/projects/build-infra/guide.html">
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2132
            Build Infra User Guide</a> 
948f8ad66ee7 7170079: Adjustments to build-infra makefiles
erikj
parents: 12494
diff changeset
  2133
        </blockquote>
333
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2134
        <hr>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2135
    </body>
d4540117530e 6563616: Clarify instructions for unpacking openjdk binary "plug"
ohair
parents: 15
diff changeset
  2136
</html>