Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: java.xml
Date: Wed, 16 Sep 2009 15:26:46
nightmorph    09/09/16 15:26:43

  Modified:             java.xml
  new stuff about build-only VMs added, bug 285181

Revision  Changes    Path
1.43                 xml/htdocs/doc/en/java.xml

file :
diff :

Index: java.xml
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -r1.42 -r1.43
--- java.xml	28 Sep 2008 20:29:25 -0000	1.42
+++ java.xml	16 Sep 2009 15:26:43 -0000	1.43
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.42 2008/09/28 20:29:25 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.43 2009/09/16 15:26:43 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 <guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
 <!-- See -->
 <title>What is Java?</title>
@@ -217,14 +217,20 @@
 <pre caption="Listing available VMs">
 # <i>java-config --list-available-vms</i>
 The following VMs are available for generation-2:
-1)      Blackdown JDK [blackdown-jdk-1.4.2]
-2)      Blackdown JRE [blackdown-jre-1.4.2]
-3)      Blackdown 32bit JRE [emul-linux-x86-java-1.4.2]
-4)      Sun 32bit JRE [emul-linux-x86-java-1.5]
-5)      Kaffe 1.1.7 [kaffe]
-*)      Sun JDK [sun-jdk-1.5]
+1)      Blackdown JDK [blackdown-jdk-1.4.2] <comment>(Build Only)</comment>
+2)      Blackdown JRE [blackdown-jre-1.4.2] <comment>(Build Only)</comment>
+3)      IcedTea6-bin 1.4.1 [icedtea6-bin]
+4)      Sun JDK [sun-jdk-1.5] <comment>(Build Only)</comment>
+*)      Sun JDK [sun-jdk-1.6]
+VMs marked as Build Only may contain security vulnerabilities and/or be EOL.
+Gentoo recommends not setting these VMs as either your system or user VM.
+Please see <uri link="java.xml#build-only">Build Only VM</uri> for more
 The <e>*</e> indicates this is the current active vm (system-vm or user-vm when
 set). The name in the brackets (<e>[]</e>) is the handle or ID for that
@@ -236,9 +242,10 @@
 <comment>(By handle (preferred))</comment>
 # <i>java-config --set-system-vm blackdown-jdk-1.4</i>
 Now using blackdown-jdk-1.4 as your generation-2 system JVM
+WARNING: blackdown-jdk-1.4 is marked as a build-only JVM. Using this vm is not recommended.
 <comment>(By number)</comment>
-# <i>java-config --set-system-vm 6</i>
-Now using sun-jdk-1.5 as your generation-2 system JVM
+# <i>java-config --set-system-vm 5</i>
+Now using sun-jdk-1.6 as your generation-2 system JVM
@@ -252,6 +259,24 @@
+<section id="build-only">
+<title>Build Only VM</title>
+Some virtual machines are flagged as build-only due to being EOL and/or
+containing security vulnerabilities. These virtual machines will not
+automatically be used by Gentoo for the running of applications using Gentoo
+launchers but will still be available for use by Gentoo's build environment as
+some packages may require them for building. The setting of these virtual
+machines as either your system or user VM is strongly discouraged as these VMs
+will then be used when running the <path>/usr/bin/{java,javac,..}</path>
+executables and will also be used by any packages not using Gentoo's launcher
 <section id="preferred-vm">
 <title>Preferred VM</title>