rane 06/08/08 09:51:12 Modified: java.xml Log: #143152, updated by java team
Revision Changes Path 1.28 xml/htdocs/doc/en/java.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.28&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.28&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.27&r2=1.28 Index: java.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v retrieving revision 1.27 retrieving revision 1.28 diff -u -r1.27 -r1.28 --- java.xml 25 Jul 2006 08:13:47 -0000 1.27 +++ java.xml 8 Aug 2006 09:51:12 -0000 1.28 @@ -1,15 +1,15 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.27 2006/07/25 08:13:47 rane Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.28 2006/08/08 09:51:12 rane Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/java.xml"> <title>Gentoo Java Guide</title> <author title="Author"> - <mail link="[EMAIL PROTECTED]">Karl Trygve Kalleberg</mail> + <mail link="[EMAIL PROTECTED]">Joshua Nichols</mail> </author> <author title="Author"> - <mail link="[EMAIL PROTECTED]">Joshua Nichols</mail> + <mail link="[EMAIL PROTECTED]">Karl Trygve Kalleberg</mail> </author> <author title="Editor"> <mail link="[EMAIL PROTECTED]">Joshua Saddler</mail> @@ -24,8 +24,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>0.5</version> -<date>2006-07-24</date> +<version>0.6</version> +<date>2006-08-07</date> <chapter> <title>What is Java?</title> @@ -57,14 +57,113 @@ </chapter> <chapter> -<title>Installing a JRE/JDK</title> +<title>New Java System</title> +<section> +<body> + +<p> +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. +</p> + +</body> +</section> +<section> +<title>Keywords</title> +<body> + +<p> +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 +<path>/etc/portage/package.keywords</path>: +</p> + +<pre caption="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 +</pre> + +<impo> +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. +</impo> + +<impo> +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. +</impo> + +</body> +</section> +<section> +<title>Existing installs</title> +<body> + +<p> +For existing installs, regardless of if you have installed anything Java +before, make sure you have followed the <uri +link="/proj/en/java/java-upgrade.xml">Java Upgrade Guide</uri>. +</p> + +</body> +</section> +<section> +<title>New installs</title> +<body> + +<p> +New installs should require no further preparation. +</p> + +</body> +</section> +</chapter> + +<chapter> +<title>Installing a Virtual Machine</title> <section> <title>The choices</title> <body> <p> -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: </p> <table> @@ -111,14 +210,14 @@ </p> <p> -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. </p> <p> -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). </p> </body> @@ -132,6 +231,12 @@ Or to install your profile's default JRE, you can <c>emerge virtual/jre</c>. </p> +<p> +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. +</p> + <note> 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 @@ </body> </section> <section> -<title>Installing the Sun/IBM JRE/JDKs</title> +<title>Installing fetch-restricted virtual machines</title> <body> <p> -If you run <c>emerge dev-java/sun-jdk</c> or <c>emerge -dev-java/ibm-jdk-bin</c>, 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. </p> <p> @@ -162,7 +265,7 @@ </chapter> <chapter> -<title>Configuring your JRE/JDK</title> +<title>Configuring your virtual machine</title> <section> <title>Overview</title> <body> @@ -186,7 +289,7 @@ </body> </section> <section> -<title>Setting a default JRE/JDK</title> +<title>Setting a default virtual machine</title> <body> <p> @@ -480,6 +583,15 @@ This is typically used to provide your IDE with the source code for the package. </li> + <li> + The <b>source</b> 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. + </li> + <li> + For Java packages, the <b>doc</b> flag will build API documentation using + javadoc. + </li> </ul> </body> -- [email protected] mailing list
