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
Message-Id: E1MnwP5-0005hz-VJ@stork.gentoo.org
1 nightmorph 09/09/16 15:26:43
2
3 Modified: java.xml
4 Log:
5 new stuff about build-only VMs added, bug 285181
6
7 Revision Changes Path
8 1.43 xml/htdocs/doc/en/java.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.43&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.43&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.42&r2=1.43
13
14 Index: java.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
17 retrieving revision 1.42
18 retrieving revision 1.43
19 diff -u -r1.42 -r1.43
20 --- java.xml 28 Sep 2008 20:29:25 -0000 1.42
21 +++ java.xml 16 Sep 2009 15:26:43 -0000 1.43
22 @@ -1,5 +1,5 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.42 2008/09/28 20:29:25 nightmorph Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.43 2009/09/16 15:26:43 nightmorph Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/java.xml">
29 @@ -24,8 +24,8 @@
30 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31 <license/>
32
33 -<version>0.17</version>
34 -<date>2008-09-28</date>
35 +<version>0.18</version>
36 +<date>2009-09-16</date>
37
38 <chapter>
39 <title>What is Java?</title>
40 @@ -217,14 +217,20 @@
41 <pre caption="Listing available VMs">
42 # <i>java-config --list-available-vms</i>
43 The following VMs are available for generation-2:
44 -1) Blackdown JDK 1.4.2.03 [blackdown-jdk-1.4.2]
45 -2) Blackdown JRE 1.4.2.03 [blackdown-jre-1.4.2]
46 -3) Blackdown 32bit JRE 1.4.2.03 [emul-linux-x86-java-1.4.2]
47 -4) Sun 32bit JRE 1.5.0.08 [emul-linux-x86-java-1.5]
48 -5) Kaffe 1.1.7 [kaffe]
49 -*) Sun JDK 1.5.0.08 [sun-jdk-1.5]
50 +1) Blackdown JDK 1.4.2.03 [blackdown-jdk-1.4.2] <comment>(Build Only)</comment>
51 +2) Blackdown JRE 1.4.2.03 [blackdown-jre-1.4.2] <comment>(Build Only)</comment>
52 +3) IcedTea6-bin 1.4.1 [icedtea6-bin]
53 +4) Sun JDK 1.5.0.20 [sun-jdk-1.5] <comment>(Build Only)</comment>
54 +*) Sun JDK 1.6.0.16 [sun-jdk-1.6]
55 </pre>
56
57 +<note>
58 +VMs marked as Build Only may contain security vulnerabilities and/or be EOL.
59 +Gentoo recommends not setting these VMs as either your system or user VM.
60 +Please see <uri link="java.xml#build-only">Build Only VM</uri> for more
61 +information.
62 +</note>
63 +
64 <p>
65 The <e>*</e> indicates this is the current active vm (system-vm or user-vm when
66 set). The name in the brackets (<e>[]</e>) is the handle or ID for that
67 @@ -236,9 +242,10 @@
68 <comment>(By handle (preferred))</comment>
69 # <i>java-config --set-system-vm blackdown-jdk-1.4</i>
70 Now using blackdown-jdk-1.4 as your generation-2 system JVM
71 +WARNING: blackdown-jdk-1.4 is marked as a build-only JVM. Using this vm is not recommended.
72 <comment>(By number)</comment>
73 -# <i>java-config --set-system-vm 6</i>
74 -Now using sun-jdk-1.5 as your generation-2 system JVM
75 +# <i>java-config --set-system-vm 5</i>
76 +Now using sun-jdk-1.6 as your generation-2 system JVM
77 </pre>
78
79 <p>
80 @@ -252,6 +259,24 @@
81
82 </body>
83 </section>
84 +<section id="build-only">
85 +<title>Build Only VM</title>
86 +<body>
87 +
88 +<p>
89 +Some virtual machines are flagged as build-only due to being EOL and/or
90 +containing security vulnerabilities. These virtual machines will not
91 +automatically be used by Gentoo for the running of applications using Gentoo
92 +launchers but will still be available for use by Gentoo's build environment as
93 +some packages may require them for building. The setting of these virtual
94 +machines as either your system or user VM is strongly discouraged as these VMs
95 +will then be used when running the <path>/usr/bin/{java,javac,..}</path>
96 +executables and will also be used by any packages not using Gentoo's launcher
97 +scripts.
98 +</p>
99 +
100 +</body>
101 +</section>
102 <section id="preferred-vm">
103 <title>Preferred VM</title>
104 <body>