README
author johnc
Wed, 12 Dec 2012 12:07:32 -0800
changeset 14839 cda9ce5806b7
parent 10208 9bc94e291a10
child 15787 496cd89abcc5
permissions -rw-r--r--
8001028: Improve GC option handling Summary: If there are not enough native resources to create the ReferenceHandler or Finalizer Java threads, the VM will attempt to throw an OOME before the java.lang.Class class has been initialized. This can result in assertion failures and other crashes. Move the initialization of the java.lang.Class class to just before the initialization of the java.lang.ref.Finalizer class. Reviewed-by: jwilhelm, dholmes, coleenp
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.