README
author coleenp
Wed, 13 Mar 2013 17:34:29 -0400
changeset 15935 50da9e5eb858
parent 15787 496cd89abcc5
child 24418 a6318a06a0e5
permissions -rw-r--r--
8003419: NPG: Clean up metadata created during class loading if failure Summary: Store metadata on ClassFileParser instance to be cleaned up by destructor. This enabled some refactoring of the enormous parseClassFile function. Reviewed-by: jmasa, acorn
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
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
     3
  repository. A full OpenJDK repository set (forest) should also include
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
     4
  the following 6 nested repositories:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     5
    "jdk", "hotspot", "langtools", "corba", "jaxws"  and "jaxp".
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
     6
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
     7
  The 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
     8
    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
     9
  
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    10
  You can run the get_source.sh script located in the root repository to get
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    11
  the other needed repositories:
10208
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    12
    cd openjdk8 && sh ./get_source.sh
9bc94e291a10 7071275: Fix jdk7 references in README files, remove Forest Extension mentions
neugens
parents: 8646
diff changeset
    13
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    14
  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
    15
  the Mercurial book: http://hgbook.red-bean.com/read/
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    16
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    17
  See http://openjdk.java.net/ for more information about OpenJDK.
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    18
fd16c54261b3 Initial load
duke
parents:
diff changeset
    19
Simple Build Instructions:
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    20
  
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    21
  0. Get the necessary system software/packages installed on your system, see
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    22
     http://hg.openjdk.java.net/jdk8/jdk8/raw-file/tip/README-builds.html
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    23
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    24
  1. If you don't have a jdk7u7 or newer jdk, download and install it from
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    25
     http://java.sun.com/javase/downloads/index.jsp
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    26
     Add the /bin directory of this installation to your PATH environment
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    27
     variable.
7650
6a3a53d8eacc 7003845: README-builds document proper location of forest extension, provide alternatives
ohair
parents: 7360
diff changeset
    28
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    29
  2. Configure the build:
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    30
       bash ./configure
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    31
  
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    32
  3. Build the OpenJDK:
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 7650
diff changeset
    33
       make all
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    34
     The resulting JDK image should be found in build/*/images/j2sdk-image
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    35
8646
f07e5ed381a8 6896934: README: Document how the drop source bundles work for jaxp/jaxws
ohair
parents: 7650
diff changeset
    36
where make is GNU make 3.81 or newer, /usr/bin/make on Linux usually
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    37
is 3.81 or newer. Note that on Solaris, GNU make is called "gmake".
0
fd16c54261b3 Initial load
duke
parents:
diff changeset
    38
15787
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    39
Complete details are available in the file:
496cd89abcc5 8004712: build-infra: Move user guide from web pages to repository
ohair
parents: 10208
diff changeset
    40
     http://hg.openjdk.java.net/jdk8/jdk8/raw-file/tip/README-builds.html