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