/[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.48 Revision 1.49
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.48 2010/03/31 23:38:40 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.49 2010/07/06 11:51:28 jkt Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide> 5<guide>
6<title>Gentoo Java Guide</title> 6<title>Gentoo Java Guide</title>
7 7
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.22</version> 27<version>0.23</version>
28<date>2009-12-23</date> 28<date>2010-07-06</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>
257</p> 257</p>
258 258
259</body> 259</body>
260</section> 260</section>
261<section id="preferred-vm"> 261<section id="preferred-vm">
262<title>Preferred VM</title> 262<title>Preferred Build VM</title>
263<body> 263<body>
264 264
265<p>
266While merging Java packages, the VM can and will be switched as necessary.
267</p> 265<p>
268 266While merging Java packages, the VM used for building can sometimes be different
267from the one currently set as the system VM.
269<p> 268</p>
270Because of the wide variety of available VMs, we do not have the resources to 269
271test and verify every package works on all of them. So to ensure that every 270<p>
272packages merges smoothly, we have defined a list of <e>default/supported 271This merge time VM switching is needed when, for example, your system-vm is
272set to a 1.6 VM and the package you are merging requires a 1.5 VM. While merging
273it will select and use a 1.5 VM, leaving your system-vm choice intact.
274</p>
275
276<p>
277To define which VM is selected when a switch is needed, we have created a list of <e>default/supported
273VMs</e> per arch. You can find them in 278VMs</e> per arch. You can find them in
274<path>/usr/share/java-config-2/config/jdk-defaults.conf</path>. When you are 279<path>/usr/share/java-config-2/config/jdk-defaults.conf</path>.
275merging a Java package, and it detects one of the VM in that file is installed,
276it will automatically use that VM, instead of the system-vm.
277</p>
278
279<p> 280</p>
280The merge time VM switching is also needed when, for example, your system-vm is 281
281set a 1.4 VM and the package you are merging requires a 1.5 VM. While merging
282it will use the preferred 1.5 VM, leaving your system-vm choice intact.
283</p> 282<p>
284
285<p>
286Of course, Gentoo is all about choice, so you can override these defaults in 283Of course, Gentoo is all about choice, so you can override these defaults (and even your
284selected system VM) in
287<path>/etc/java-config-2/build/jdk.conf</path> and have complete control over 285<path>/etc/java-config-2/build/jdk.conf</path> and have complete control over
288which VM will get used. Some examples: 286which VM will get used for merging. Some examples:
289</p> 287</p>
290 288
291<pre caption="Example /etc/java-config-2/build/jdk.conf"> 289<pre caption="Example /etc/java-config-2/build/jdk.conf">
292<comment>(I always want it to use a sun-jdk, ie sun-jdk-1.4 for 1.4, sun-jdk-1.5 for 1.5, etc)</comment> 290<comment>(I always want it to use a sun-jdk, ie sun-jdk-1.4 for 1.4, sun-jdk-1.5 for 1.5, etc)</comment>
293*=sun-jdk 291*=sun-jdk
3051.5=sun-jdk 3031.5=sun-jdk
306</pre> 304</pre>
307 305
308<warn> 306<warn>
309You do not <e>have</e> to edit this file. If you change these options to use a 307You do not <e>have</e> to edit this file. If you change these options to use a
310unsupported VM, things could possibly break. Bugs reported with a unsupported VM 308unsupported VM, things could possibly break. Because of the wide variety of available
311won't be prioritized as much as bugs present within supported VMs. 309VMs, we do not have the resources to test and verify every package works on all of them.
310Bugs reported with a unsupported VM won't be prioritized as much as bugs present within
311supported VMs.
312</warn> 312</warn>
313 313
314</body> 314</body>
315</section> 315</section>
316</chapter> 316</chapter>

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

  ViewVC Help
Powered by ViewVC 1.1.20