nightmorph 09/09/16 15:26:43 Modified: java.xml Log: new stuff about build-only VMs added, bug 285181
Revision Changes Path 1.43 xml/htdocs/doc/en/java.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.43&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.43&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.42&r2=1.43 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 http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>0.17</version> -<date>2008-09-28</date> +<version>0.18</version> +<date>2009-09-16</date> <chapter> <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 1.4.2.03 [blackdown-jdk-1.4.2] -2) Blackdown JRE 1.4.2.03 [blackdown-jre-1.4.2] -3) Blackdown 32bit JRE 1.4.2.03 [emul-linux-x86-java-1.4.2] -4) Sun 32bit JRE 1.5.0.08 [emul-linux-x86-java-1.5] -5) Kaffe 1.1.7 [kaffe] -*) Sun JDK 1.5.0.08 [sun-jdk-1.5] +1) Blackdown JDK 1.4.2.03 [blackdown-jdk-1.4.2] <comment>(Build Only)</comment> +2) Blackdown JRE 1.4.2.03 [blackdown-jre-1.4.2] <comment>(Build Only)</comment> +3) IcedTea6-bin 1.4.1 [icedtea6-bin] +4) Sun JDK 1.5.0.20 [sun-jdk-1.5] <comment>(Build Only)</comment> +*) Sun JDK 1.6.0.16 [sun-jdk-1.6] </pre> +<note> +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 +information. +</note> + <p> 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 </pre> <p> @@ -252,6 +259,24 @@ </body> </section> +<section id="build-only"> +<title>Build Only VM</title> +<body> + +<p> +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 +scripts. +</p> + +</body> +</section> <section id="preferred-vm"> <title>Preferred VM</title> <body>
