README
author jjg
Tue, 10 May 2011 19:53:49 -0700
changeset 9719 29adbf9e4cae
parent 8646 f07e5ed381a8
child 10208 9bc94e291a10
permissions -rw-r--r--
7043694: printStackTrace call should be removed Reviewed-by: darcy
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
     1
README:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     2
  This file should be located at the top of the OpenJDK Mercurial root
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     3
  repository. This root repository will include a "make" directory,
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     4
  and a Makefile for building the entire OpenJDK.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     5
  A full OpenJDK repository set (forest) should also include the following
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     6
  6 nested repositories:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     7
    "jdk", "hotspot", "langtools", "corba", "jaxws"  and "jaxp".
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     8
  There are also several source downloads for the jax* repositories that
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     9
  will be needed.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    10
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    11
  This one root repository can be obtained with something like:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    12
    hg clone http://hg.openjdk.java.net/jdk7/jdk7 openjdk7
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    13
  To make sure you have all the nested repositories, you can run:
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    14
    cd openjdk7 && sh ./get_source.sh
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    15
  (This is identical to using the Mercurial Forest Extension command 
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    16
   'hg fclone http://hg.openjdk.java.net/jdk7/jdk7 openjdk7').
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    17
  People unfamiliar with Mercurial should read the first few chapters of
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    18
  the Mercurial book: http://hgbook.red-bean.com/read/
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    19
fd16c54261b3 Initial load
duke
parents:
diff changeset
    20
  See http://openjdk.java.net/ for more information about the OpenJDK.
fd16c54261b3 Initial load
duke
parents:
diff changeset
    21
fd16c54261b3 Initial load
duke
parents:
diff changeset
    22
Simple Build Instructions:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    23
  
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    24
  0. Get the necessary system software/packages installed on your system, see
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    25
     http://hg.openjdk.java.net/jdk7/build/raw-file/tip/README-builds.html
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    26
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    27
  1. If you don't have a jdk6 installed, download and install a JDK 6 from
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    28
     http://java.sun.com/javase/downloads/index.jsp
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    29
     Set the environment variable ALT_BOOTDIR to the location of JDK 6.
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    30
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    31
  2. Check the sanity of doing a build with your current system:
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 7650
diff changeset
    32
       make sanity
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    33
     See README-builds.html if you run into problems.
fd16c54261b3 Initial load
duke
parents:
diff changeset
    34
  
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    35
  3. Do a complete build of the OpenJDK:
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 7650
diff changeset
    36
       make all
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    37
     The resulting JDK image should be found in build/*/j2sdk-image
fd16c54261b3 Initial load
duke
parents:
diff changeset
    38
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 7650
diff changeset
    39
where make is GNU make 3.81 or newer, /usr/bin/make on Linux usually
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 7650
diff changeset
    40
is 3.81 or newer.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    41
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 7650
diff changeset
    42
Complete details are available in README-builds.html.