/[gentoo]/xml/htdocs/doc/en/java.xml
Gentoo

Diff of /xml/htdocs/doc/en/java.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.45 Revision 1.48
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.45 2009/10/07 18:25:46 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.48 2010/03/31 23:38:40 nightmorph Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/java.xml"> 5<guide>
6<title>Gentoo Java Guide</title> 6<title>Gentoo Java Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="nichoj@gentoo.org">Joshua Nichols</mail> 9 <mail link="nichoj@gentoo.org">Joshua Nichols</mail>
10</author> 10</author>
22 22
23<!-- The content of this document is licensed under the CC-BY-SA license --> 23<!-- The content of this document is licensed under the CC-BY-SA license -->
24<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 24<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25<license/> 25<license/>
26 26
27<version>0.20</version> 27<version>0.22</version>
28<date>2009-10-07</date> 28<date>2009-12-23</date>
29 29
30<chapter> 30<chapter>
31<title>What is Java?</title> 31<title>What is Java?</title>
32<section> 32<section>
33<title>Overview</title> 33<title>Overview</title>
98 <th>Vendor</th> 98 <th>Vendor</th>
99 <th>JDK</th> 99 <th>JDK</th>
100 <th>JRE</th> 100 <th>JRE</th>
101</tr> 101</tr>
102<tr> 102<tr>
103 <ti>The Blackdown Java Kit</ti>
104 <ti>dev-java/blackdown-jdk</ti>
105 <ti>dev-java/blackdown-jre</ti>
106</tr>
107<tr>
108 <ti>Sun's Java Kit</ti> 103 <ti>Sun's Java Kit</ti>
109 <ti>dev-java/sun-jdk</ti> 104 <ti>dev-java/sun-jdk</ti>
110 <ti>dev-java/sun-jre-bin</ti> 105 <ti>dev-java/sun-jre-bin</ti>
111</tr> 106</tr>
112<tr> 107<tr>
136Or to install your profile's default JRE, you can <c>emerge virtual/jre</c>. 131Or to install your profile's default JRE, you can <c>emerge virtual/jre</c>.
137</p> 132</p>
138 133
139<p> 134<p>
140In recent events, Sun has relicensed their JDK and JRE under a more Linux 135In recent events, Sun has relicensed their JDK and JRE under a more Linux
141distro friendly license. As a result, Sun releases Java 1.5 and onwards are 136distro friendly license. As a result, Sun Java 1.5 and onwards are
142freely downloadable, without any further hassle. 137freely downloadable, without any further hassle.
143</p> 138</p>
144 139
145<note> 140<note>
146A JDK also includes a JRE, so if you install a JDK you shouldn't have to also 141A JDK also includes a JRE, so if you install a JDK you shouldn't have to also
204</p> 199</p>
205 200
206<pre caption="Listing available VMs"> 201<pre caption="Listing available VMs">
207# <i>java-config --list-available-vms</i> 202# <i>java-config --list-available-vms</i>
208The following VMs are available for generation-2: 203The following VMs are available for generation-2:
2091) Blackdown JDK 1.4.2.03 [blackdown-jdk-1.4.2] <comment>(Build Only)</comment>
2102) Blackdown JRE 1.4.2.03 [blackdown-jre-1.4.2] <comment>(Build Only)</comment>
2113) IcedTea6-bin 1.4.1 [icedtea6-bin] 2041) IcedTea6-bin 1.4.1 [icedtea6-bin]
2124) Sun JDK 1.5.0.20 [sun-jdk-1.5] <comment>(Build Only)</comment> 2052) Sun JDK 1.5.0.20 [sun-jdk-1.5] <comment>(Build Only)</comment>
213*) Sun JDK 1.6.0.16 [sun-jdk-1.6] 206*) Sun JDK 1.6.0.16 [sun-jdk-1.6]
214</pre> 207</pre>
215 208
216<note> 209<note>
217VMs marked as Build Only may contain security vulnerabilities and/or be EOL. 210VMs marked as Build Only may contain security vulnerabilities and/or be EOL.
227--set-system-vm</c>. Here is an example of how to set the system VM. 220--set-system-vm</c>. Here is an example of how to set the system VM.
228</p> 221</p>
229 222
230<pre caption="Setting the System VM"> 223<pre caption="Setting the System VM">
231<comment>(By handle (preferred))</comment> 224<comment>(By handle (preferred))</comment>
232# <i>java-config --set-system-vm blackdown-jdk-1.4</i> 225# <i>java-config --set-system-vm sun-jdk-1.6</i>
233Now using blackdown-jdk-1.4 as your generation-2 system JVM 226Now using sun-jdk-1.6 as your generation-2 system JVM
234WARNING: blackdown-jdk-1.4 is marked as a build-only JVM. Using this vm is not recommended.
235<comment>(By number)</comment> 227<comment>(By number)</comment>
236# <i>java-config --set-system-vm 5</i> 228# <i>java-config --set-system-vm 3</i>
237Now using sun-jdk-1.6 as your generation-2 system JVM 229Now using sun-jdk-1.6 as your generation-2 system JVM
238</pre> 230</pre>
239 231
240<p> 232<p>
241As a regular user, you can use <c>java-config --set-user-vm</c>. 233As a regular user, you can use <c>java-config --set-user-vm</c>.
306*=sun-jdk-1.5 298*=sun-jdk-1.5
307</pre> 299</pre>
308 300
309<pre caption="Example /etc/java-config-2/build/jdk.conf"> 301<pre caption="Example /etc/java-config-2/build/jdk.conf">
310<comment># For 1.3 I prefer sun-jdk 1.4 but when it is not available, use ibm-jdk-bin, 302<comment># For 1.3 I prefer sun-jdk 1.4 but when it is not available, use ibm-jdk-bin,
311# For 1.4, use blackdown-jdk, and for 1.5, use sun-jdk </comment> 303# For 1.5, use sun-jdk </comment>
3121.3=sun-jdk-1.4 ibm-jdk-bin 3041.3=sun-jdk-1.4 ibm-jdk-bin
3131.4=blackdown-jdk
3141.5=sun-jdk 3051.5=sun-jdk
315</pre> 306</pre>
316 307
317<warn> 308<warn>
318You do not have to edit this file. If you change these options to use a 309You do not <e>have</e> to edit this file. If you change these options to use a
319unsupported VM, things could possibly break. Bugs reported with a unsupported 310unsupported VM, things could possibly break. Bugs reported with a unsupported VM
320VM won't be prioritized as much as bugs present within supported VMs. 311won't be prioritized as much as bugs present within supported VMs.
321</warn> 312</warn>
322 313
323</body> 314</body>
324</section> 315</section>
325</chapter> 316</chapter>
340<pre caption="/etc/java-config-2/build/compilers.conf"> 331<pre caption="/etc/java-config-2/build/compilers.conf">
341# If the ebuild supports it 332# If the ebuild supports it
342# it will check the COMPILERS var front to back and 333# it will check the COMPILERS var front to back and
343# use the first compiler that is installed 334# use the first compiler that is installed
344 335
345COMPILERS="ecj-3.1 jikes javac" 336COMPILERS="ecj-X.Y jikes javac"
346</pre> 337</pre>
347 338
348<p> 339<p>
349Some compilers don't support all possible -target and -source arguments. 340Some compilers don't support all possible -target and -source arguments.
350Therefore, each compiler in the list is checked to see if it can support the 341Therefore, each compiler in the list is checked to see if it can support the
382 1.5 syntax yet. 373 1.5 syntax yet.
383 </ti> 374 </ti>
384</tr> 375</tr>
385<tr> 376<tr>
386 <ti>Eclipse Compiler for Java</ti> 377 <ti>Eclipse Compiler for Java</ti>
387 <ti>ecj-3.1</ti> 378 <ti>ecj</ti>
388 <ti>=dev-java/eclipse-ecj-3.1*</ti> 379 <ti>dev-java/eclipse-ecj</ti>
389 <ti> 380 <ti>
390 ECJ is the compiler used by the Eclipse software development kit. It is 381 ECJ is the compiler used by the Eclipse software development kit. It is
391 very full featured, and is pretty fast. It does support Java 1.5 syntax. 382 very full featured, and is pretty fast. It does support Java 1.5 syntax.
392 </ti> 383 </ti>
393</tr> 384</tr>

Legend:
Removed from v.1.45  
changed lines
  Added in v.1.48

  ViewVC Help
Powered by ViewVC 1.1.20