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, 07 Oct 2009 18:14:34
Message-Id: E1Mvb1z-00010R-Db@stork.gentoo.org
1 nightmorph 09/10/07 18:14:31
2
3 Modified: java.xml
4 Log:
5 Updated Java guide for 64-bit plugins (bug 287675). Also removed some old cruft related to blackdown and old Sun versions.
6
7 Revision Changes Path
8 1.44 xml/htdocs/doc/en/java.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.44&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.44&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.43&r2=1.44
13
14 Index: java.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
17 retrieving revision 1.43
18 retrieving revision 1.44
19 diff -u -r1.43 -r1.44
20 --- java.xml 16 Sep 2009 15:26:43 -0000 1.43
21 +++ java.xml 7 Oct 2009 18:14:31 -0000 1.44
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.43 2009/09/16 15:26:43 nightmorph Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.44 2009/10/07 18:14:31 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.18</version>
34 -<date>2009-09-16</date>
35 +<version>0.19</version>
36 +<date>2009-10-07</date>
37
38 <chapter>
39 <title>What is Java?</title>
40 @@ -126,14 +126,7 @@
41 kaffe/sablevm/gcj/jamvm
42 -->
43 <p>
44 -The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely
45 -("free as in beer") available without any registration fuss.
46 -</p>
47 -
48 -<p>
49 -JREs and JDKs from Sun, IBM, and BEA are generally faster, but getting them
50 -is a bit more work, as you are required to read and accept their license before
51 -downloading (IBM additionally requires you to register).
52 +The default for Java 1.6 is the Sun JRE/JDK pair.
53 </p>
54
55 </body>
56 @@ -165,9 +158,9 @@
57 <body>
58
59 <p>
60 -As already mentioned, some of the JDKs and JREs require you to jump through a
61 -few hoops before installing. Simply emerge the packages as you normally would.
62 -The ebuilds will then instruct you where to go and what to download.
63 +Some of the JDKs and JREs require you to jump through a few hoops before
64 +installing. Simply emerge the packages as you normally would. The ebuilds will
65 +then instruct you where to go and what to download.
66 </p>
67
68 <p>
69 @@ -512,8 +505,8 @@
70
71 <pre caption="Viewing available plugins">
72 # <i>eselect java-nsplugin list</i>
73 - [1] sun-jre-bin-1.5
74 - [2] blackdown-jre-1.4.2
75 + [1] sun-jre-bin-1.6
76 + [2] icedtea6-bin
77 </pre>
78
79 <p>
80 @@ -521,7 +514,7 @@
81 </p>
82
83 <pre caption="Selecting a plugin">
84 -# <i>eselect java-nsplugin set sun-jre-bin-1.5</i>
85 +# <i>eselect java-nsplugin set sun-jre-bin-1.6</i>
86 </pre>
87
88 <p>
89 @@ -530,8 +523,8 @@
90
91 <pre caption="Verifying the correct plugin">
92 # <i>eselect java-nsplugin list</i>
93 - [1] sun-jre-bin-1.5 current
94 - [2] blackdown-jre-1.4.2
95 + [1] sun-jre-bin-1.6 current
96 + [2] icedtea6-bin
97 </pre>
98
99 <p>
100 @@ -549,12 +542,25 @@
101
102 <p>
103 If you are running a mixed 64-bit and 32-bit multilib system (for example, on
104 -AMD64), you can only use 32-bit Java plugins.
105 +AMD64), you can use 64-bit and 32-bit Java plugins. Unless you have a pressing
106 +need to run 32-bit Java applications, we recommend using native 64-bit plugins
107 +on 64-bit web browsers.
108 </p>
109
110 <p>
111 -To use a 32-bit plugin, you will need to emerge <c>emul-linux-x86-java</c> with
112 -the <c>nsplugin</c> USE flag enabled.
113 +There are several native 64-bit browser plugins available. The default JDK/JRE
114 +pair, <c>sun-jdk</c> and <c>sun-jre-bin</c>, both include browser plugins. Just
115 +emerge one of them with the <c>nsplugin</c> USE flag enabled.
116 +</p>
117 +
118 +<pre caption="Installing a 64-bit plugin">
119 +# <i>echo "dev-java/sun-jre-bin nsplugin" >> /etc/portage/package.use</i>
120 +# <i>emerge sun-jre-bin</i>
121 +</pre>
122 +
123 +<p>
124 +To use a 32-bit plugin on a 32-bit browser, you will need to emerge
125 +<c>emul-linux-x86-java</c> with the <c>nsplugin</c> USE flag enabled.
126 </p>
127
128 <pre caption="Installing a 32-bit plugin">
129 @@ -569,23 +575,21 @@
130 <pre caption="Viewing available plugins">
131 # <i>eselect java-nsplugin list</i>
132 Available 32-bit Java browser plugins
133 - [1] emul-linux-x86-java-1.4.2
134 - [2] emul-linux-x86-java-1.5
135 + [1] emul-linux-x86-java-1.5
136 + [2] emul-linux-x86-java-1.6
137 +Available 64-bit Java browser plugins
138 + [1] icedtea6-bin
139 + [2] sun-jre-bin-1.6
140 </pre>
141
142 <p>
143 -Although you must select a 32-bit browser (such as <c>mozilla-firefox-bin</c>)
144 -to use with your 32-bit plugin, the 64-bit version of <c>konqueror</c> uses your
145 -Java VM directly, so it's possible to use the 64-bit version of <c>blackdown</c>
146 -with this browser; no further configuration is necessary.
147 -</p>
148 -
149 -<p>
150 -Now select the right plugin for your 32-bit browser:
151 +Now select the right plugin for your browsers:
152 </p>
153
154 <pre caption="Selecting plugins">
155 -# <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.5</i>
156 +<comment>(Choose the plugins for 32-bit and 64-bit browsers)</comment>
157 +# <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.6</i>
158 +# <i>eselect java-nsplugin set 64bit sun-jre-bin-1.6</i>
159 </pre>
160
161 <p>
162 @@ -595,8 +599,11 @@
163 <pre caption="Verifying the correct plugin">
164 # <i>eselect java-nsplugin list</i>
165 Available 32-bit Java browser plugins
166 - [1] emul-linux-x86-java-1.4.2
167 - [2] emul-linux-x86-java-1.5 current
168 + [1] emul-linux-x86-java-1.5
169 + [2] emul-linux-x86-java-1.6 current
170 +Available 64-bit Java browser plugins
171 + [1] icedtea6-bin
172 + [2] sun-jre-bin-1.6 current
173 </pre>
174
175 </body>