README
author jjg
Mon, 21 Jan 2013 10:00:46 -0800
changeset 15370 c1c9a9e11b26
parent 10208 9bc94e291a10
child 15787 496cd89abcc5
permissions -rw-r--r--
8006263: Supplementary test cases needed for doclint Reviewed-by: mcimadamore Contributed-by: peter.jensen@oracle.com
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:
10208
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    12
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    13
    hg clone http://hg.openjdk.java.net/jdk8/jdk8 openjdk8
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    14
  
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    15
  To make sure you have all the nested repositories, you can run the
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    16
  get_source.sh script located in the same respository as this file:
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    17
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    18
    cd openjdk8 && sh ./get_source.sh
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    19
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    20
  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
    21
  the Mercurial book: http://hgbook.red-bean.com/read/
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    22
fd16c54261b3 Initial load
duke
parents:
diff changeset
    23
  See http://openjdk.java.net/ for more information about the OpenJDK.
fd16c54261b3 Initial load
duke
parents:
diff changeset
    24
fd16c54261b3 Initial load
duke
parents:
diff changeset
    25
Simple Build Instructions:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    26
  
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    27
  0. Get the necessary system software/packages installed on your system, see
10208
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    28
     http://hg.openjdk.java.net/jdk8/build/raw-file/tip/README-builds.html
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    29
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    30
  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
    31
     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
    32
     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
    33
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    34
  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
    35
       make sanity
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    36
     See README-builds.html if you run into problems.
fd16c54261b3 Initial load
duke
parents:
diff changeset
    37
  
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    38
  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
    39
       make all
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    40
     The resulting JDK image should be found in build/*/j2sdk-image
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
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
    43
is 3.81 or newer.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    44
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 7650
diff changeset
    45
Complete details are available in README-builds.html.