README
author ksrini
Tue, 18 Jan 2011 08:37:05 -0800
changeset 8042 d534dd80da9f
parent 7650 6a3a53d8eacc
child 8646 f07e5ed381a8
permissions -rw-r--r--
6982999: tools must support -target 7 bytecodes Reviewed-by: jjg, jrose
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:
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    32
       gnumake sanity
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:
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    36
       gnumake all
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
7360
39aa1820e934 6909026: Change GNU make version requirement to 3.81
ohair
parents: 0
diff changeset
    39
where gnumake is GNU make 3.81 or newer, /usr/bin/make on Linux and
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    40
/usr/sfw/bin/gmake or /opt/sfw/bin/gmake on Solaris.
fd16c54261b3 Initial load
duke
parents:
diff changeset
    41