Gentoo Java Guide

-0.5 -2006-07-24 +0.6 +2006-08-07 What is Java? @@ -57,14 +57,113 @@ -Installing a JRE/JDK +New Java System +

+ + +

+The way Java is handled on Gentoo has recently seen many changes and +improvements. This has only happened very recently, and as a result, all the +packages related to it are marked with testing keywords, ie ~x86. This +document assumes you are using the new system. +

+ + +

+Keywords + + +

+If you are using the stable tree, i.e. x86, ppc, or amd64 as opposed to ~x86, +~ppc, or ~amd64, you will need to add some entries to your +/etc/portage/package.keywords: +

+ +

+# Core Gentoo/Java Packages
+dev-java/ant-core
+dev-java/ant-tasks
+dev-java/ant
+dev-java/java-config
+dev-java/java-config-wrapper
+dev-java/javatoolkit
+# JDKs
+=dev-java/sun-jdk-1.4*
+=dev-java/sun-jdk-1.5*
+=dev-java/ibm-jdk-bin-1.4*
+=dev-java/ibm-jdk-bin-1.5*
+=dev-java/jrockit-jdk-bin-1.4*
+=dev-java/jrockit-jdk-bin-1.5*
+=dev-java/blackdown-jdk-1.4*
+dev-java/kaffe
+# JREs
+=dev-java/sun-jre-bin-1.4*
+=dev-java/sun-jre-bin-1.5*
+=dev-java/ibm-jre-bin-1.4*
+=dev-java/blackdown-jre-1.4*
+# Virtuals
+virtual/jdk
+virtual/jre
+# Compilers
+dev-java/eclipse-ecj
+dev-java/jikes
+# Documentation
+dev-java/java-sdk-docs
+# Misc packages that have been updated to generation-2,
+# where the generation-1 won't build and/or run properly 
+dev-java/lucene
+# These have optional Java support, but need ~arch to function properly
+# with generation-2
+dev-util/subversion
+sys-libs/db
+

+ + +It is crucial that you keyword ALL packages related to the new Java system, +otherwise you will have problems in the later steps of this guide. + + + +It can't be emphasized enough that you have to have ALL the packages related +to the new Java system keyworded for it to function properly. + + + +

+Existing installs + + +

+For existing installs, regardless of if you have installed anything Java +before, make sure you have followed the Java Upgrade Guide. +

+ + +

+New installs + + +

+New installs should require no further preparation. +

+ + +

+ + + +Installing a Virtual Machine

The choices

-Gentoo provides numerous JREs and JDKs. Among the current alternatives, we -have: +Gentoo provides numerous Runtime Environments (JREs) and Development Kits +(JDKs). Among the current choices, we have:

@@ -111,14 +210,14 @@

-Both the Sun and the IBM are generally faster, but getting them is a bit more -hassle, as you are required to read and accept their license before downloading -(IBM additionally requires you to register). +The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely +("free as in beer") available without any registration fuss.

-Our ebuilds for the Sun and IBM JRE/JDKs will inform you how to download the -appropriate files. +JREs and JDKs from Sun, IBM, and BEA are generally faster, but getting them +is a bit more work, as you are required to read and accept their license before +downloading (IBM additionally requires you to register).

@@ -132,6 +231,12 @@ Or to install your profile's default JRE, you can emerge virtual/jre.

+In recent events, Sun has relicensed their JDK and JRE under a more Linux +distro friendly license. As a result, Sun releases Java 1.5 and onwards are +freely downloadable, without any further hassle. +

+ A JDK also includes a JRE, so if you install a JDK you shouldn't have to also have to install a JRE. @@ -140,15 +245,13 @@

-Installing the Sun/IBM JRE/JDKs +Installing fetch-restricted virtual machines

-If you run emerge dev-java/sun-jdk or emerge -dev-java/ibm-jdk-bin, you will be notified that you are required to -download the actual files yourself. This has to do with license restrictions -for the Sun JRE/JDK (online click-wrap license) and registration issues with -the IBM JRE/JDK. +As already mentioned, some of the JDKs and JREs require you to jump through a +few hoops before installing. Simply emerge the packages as you normally would. +The ebuilds will then instruct you where to go and what to download.

@@ -162,7 +265,7 @@ -Configuring your JRE/JDK +Configuring your virtual machine

Overview @@ -186,7 +289,7 @@

-Setting a default JRE/JDK +Setting a default virtual machine

@@ -480,6 +583,15 @@ This is typically used to provide your IDE with the source code for the package. +

+ The source flag installs a zip of the source code of a package. + This is traditionally used for for IDEs to 'attach' source to the libraries + you are using. +

+ For Java packages, the doc flag will build API documentation using + javadoc. +

-- gentoo-doc-cvs@gentoo.org mailing list