nightmorph 09/10/07 18:14:31 Modified: java.xml Log: Updated Java guide for 64-bit plugins (bug 287675). Also removed some old cruft related to blackdown and old Sun versions.
Revision Changes Path 1.44 xml/htdocs/doc/en/java.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.44&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.44&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.43&r2=1.44 Index: java.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v retrieving revision 1.43 retrieving revision 1.44 diff -u -r1.43 -r1.44 --- java.xml 16 Sep 2009 15:26:43 -0000 1.43 +++ java.xml 7 Oct 2009 18:14:31 -0000 1.44 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.43 2009/09/16 15:26:43 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.44 2009/10/07 18:14:31 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.18</version> -<date>2009-09-16</date> +<version>0.19</version> +<date>2009-10-07</date> <chapter> <title>What is Java?</title> @@ -126,14 +126,7 @@ kaffe/sablevm/gcj/jamvm --> <p> -The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely -("free as in beer") available without any registration fuss. -</p> - -<p> -JREs and JDKs from Sun, IBM, and BEA are generally faster, but getting them -is a bit more work, as you are required to read and accept their license before -downloading (IBM additionally requires you to register). +The default for Java 1.6 is the Sun JRE/JDK pair. </p> </body> @@ -165,9 +158,9 @@ <body> <p> -As already mentioned, some of the JDKs and JREs require you to jump through a -few hoops before installing. Simply emerge the packages as you normally would. -The ebuilds will then instruct you where to go and what to download. +Some of the JDKs and JREs require you to jump through a few hoops before +installing. Simply emerge the packages as you normally would. The ebuilds will +then instruct you where to go and what to download. </p> <p> @@ -512,8 +505,8 @@ <pre caption="Viewing available plugins"> # <i>eselect java-nsplugin list</i> - [1] sun-jre-bin-1.5 - [2] blackdown-jre-1.4.2 + [1] sun-jre-bin-1.6 + [2] icedtea6-bin </pre> <p> @@ -521,7 +514,7 @@ </p> <pre caption="Selecting a plugin"> -# <i>eselect java-nsplugin set sun-jre-bin-1.5</i> +# <i>eselect java-nsplugin set sun-jre-bin-1.6</i> </pre> <p> @@ -530,8 +523,8 @@ <pre caption="Verifying the correct plugin"> # <i>eselect java-nsplugin list</i> - [1] sun-jre-bin-1.5 current - [2] blackdown-jre-1.4.2 + [1] sun-jre-bin-1.6 current + [2] icedtea6-bin </pre> <p> @@ -549,12 +542,25 @@ <p> If you are running a mixed 64-bit and 32-bit multilib system (for example, on -AMD64), you can only use 32-bit Java plugins. +AMD64), you can use 64-bit and 32-bit Java plugins. Unless you have a pressing +need to run 32-bit Java applications, we recommend using native 64-bit plugins +on 64-bit web browsers. </p> <p> -To use a 32-bit plugin, you will need to emerge <c>emul-linux-x86-java</c> with -the <c>nsplugin</c> USE flag enabled. +There are several native 64-bit browser plugins available. The default JDK/JRE +pair, <c>sun-jdk</c> and <c>sun-jre-bin</c>, both include browser plugins. Just +emerge one of them with the <c>nsplugin</c> USE flag enabled. +</p> + +<pre caption="Installing a 64-bit plugin"> +# <i>echo "dev-java/sun-jre-bin nsplugin" >> /etc/portage/package.use</i> +# <i>emerge sun-jre-bin</i> +</pre> + +<p> +To use a 32-bit plugin on a 32-bit browser, you will need to emerge +<c>emul-linux-x86-java</c> with the <c>nsplugin</c> USE flag enabled. </p> <pre caption="Installing a 32-bit plugin"> @@ -569,23 +575,21 @@ <pre caption="Viewing available plugins"> # <i>eselect java-nsplugin list</i> Available 32-bit Java browser plugins - [1] emul-linux-x86-java-1.4.2 - [2] emul-linux-x86-java-1.5 + [1] emul-linux-x86-java-1.5 + [2] emul-linux-x86-java-1.6 +Available 64-bit Java browser plugins + [1] icedtea6-bin + [2] sun-jre-bin-1.6 </pre> <p> -Although you must select a 32-bit browser (such as <c>mozilla-firefox-bin</c>) -to use with your 32-bit plugin, the 64-bit version of <c>konqueror</c> uses your -Java VM directly, so it's possible to use the 64-bit version of <c>blackdown</c> -with this browser; no further configuration is necessary. -</p> - -<p> -Now select the right plugin for your 32-bit browser: +Now select the right plugin for your browsers: </p> <pre caption="Selecting plugins"> -# <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.5</i> +<comment>(Choose the plugins for 32-bit and 64-bit browsers)</comment> +# <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.6</i> +# <i>eselect java-nsplugin set 64bit sun-jre-bin-1.6</i> </pre> <p> @@ -595,8 +599,11 @@ <pre caption="Verifying the correct plugin"> # <i>eselect java-nsplugin list</i> Available 32-bit Java browser plugins - [1] emul-linux-x86-java-1.4.2 - [2] emul-linux-x86-java-1.5 current + [1] emul-linux-x86-java-1.5 + [2] emul-linux-x86-java-1.6 current +Available 64-bit Java browser plugins + [1] icedtea6-bin + [2] sun-jre-bin-1.6 current </pre> </body>
