/[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.16 Revision 1.17
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.16 2005/09/29 18:22:22 rane Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.17 2005/09/29 18:27:31 rane 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 link="/doc/en/java.xml">
6<title>Gentoo Java Guide</title> 6<title>Gentoo Java Guide</title>
7 7
8<author title="Author and Editor"> 8<author title="Author and Editor">
9 <mail link="karltk@gentoo.org">Karl Trygve Kalleberg</mail> 9 <mail link="karltk@gentoo.org">Karl Trygve Kalleberg</mail>
10</author> 10</author>
11<author title="Editor"> 11<author title="Editor">
12 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 12 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
13</author> 13</author>
14<author title="Editor"> 14<author title="Editor">
15 <mail link="vanquirius@gentoo.org">Marcelo Góes</mail> 15 <mail link="vanquirius@gentoo.org">Marcelo Góes</mail>
16</author> 16</author>
17 17
52</body> 52</body>
53</section> 53</section>
54</chapter> 54</chapter>
55 55
56<chapter> 56<chapter>
57<title>Installing a JRE/JDK</title> 57<title>Installing a JRE/JDK</title>
58<section> 58<section>
59<title>The choices</title> 59<title>The choices</title>
60<body> 60<body>
61 61
62<p> 62<p>
63Gentoo provides numerous JREs and JDKs. Among the current alternatives, we have: 63Gentoo provides numerous JREs and JDKs. Among the current alternatives, we have:
64</p> 64</p>
65 65
66<ul> 66<ul>
67<li>blackdown-jre and blackdown-jdk, the Blackdown Java Kit</li> 67 <li>blackdown-jre and blackdown-jdk, the Blackdown Java Kit</li>
68<li>sun-jre-bin and sun-jdk, Sun's Java Kit </li> 68 <li>sun-jre-bin and sun-jdk, Sun's Java Kit </li>
69<li>ibm-jre-bin and ibm-jdk-bin, the IBM Java Kit</li> 69 <li>ibm-jre-bin and ibm-jdk-bin, the IBM Java Kit</li>
70<li>compaq-jre and compaq-jdk, the Compaq Java Kit for Alpha/Linux/GNU</li> 70 <li>compaq-jre and compaq-jdk, the Compaq Java Kit for Alpha/Linux/GNU</li>
71<li>jrockit-jdk-bin, BEA WebLogic's J2SE Development Kit</li> 71 <li>jrockit-jdk-bin, BEA WebLogic's J2SE Development Kit</li>
72</ul> 72</ul>
73 73
74<p> 74<p>
75The default is the Blackdown JRE/JDK 75The default is the Blackdown JRE/JDK
76pair, as it is freely ("free as in beer") available without any registration 76pair, as it is freely ("free as in beer") available without any registration
77fuss. 77fuss.
78</p> 78</p>
79 79
80<p> 80<p>
81Both the Sun JRE/JDK and the IBM JRE/JDK are generally faster, but getting them 81Both the Sun JRE/JDK and the IBM JRE/JDK are generally faster, but getting them
82is a bit more work, as you are required to read and accept their license before 82is a bit more work, as you are required to read and accept their license before
83downloading (IBM additionally requires you to register). 83downloading (IBM additionally requires you to register).
84</p> 84</p>
85 85
86<p> 86<p>
87Our ebuilds for the Sun and IBM JRE/JDKs will notify you of where to go to 87Our ebuilds for the Sun and IBM JRE/JDKs will notify you of where to go to
88download them. 88download them.
89</p> 89</p>
90 90
91</body> 91</body>
92</section> 92</section>
93
94<section> 93<section>
95<title>Installing the Sun/IBM JRE/JDKs</title> 94<title>Installing the Sun/IBM JRE/JDKs</title>
96<body> 95<body>
97 96
98<p> 97<p>
99If you run <c>emerge =sun-jdk-1.4.2.06</c> or <c>=ibm-jdk-bin-1.4.2</c>, you will 98If you run <c>emerge =sun-jdk-1.4.2.06</c> or <c>=ibm-jdk-bin-1.4.2</c>, you will
100be notified that you are required to download the actual tarballs yourself. This 99be notified that you are required to download the actual tarballs yourself. This
101has to do with license restrictions for the Sun JRE/JDK (online click-wrap 100has to do with license restrictions for the Sun JRE/JDK (online click-wrap
102license) and registration issues with the IBM JRE/JDK. 101license) and registration issues with the IBM JRE/JDK.
103</p> 102</p>
104 103
105<note> 104<note>
106ibm-jdk-bin is currently masked, you may have to unmask it to use it. 105ibm-jdk-bin is currently masked, you may have to unmask it to use it.
107</note> 106</note>
108 107
159The name in the brackets <path>"[]"</path> is the handle or ID for that 158The name in the brackets <path>"[]"</path> is the handle or ID for that
160particular VM. You use pass that ID to <c>java-config --set-system-vm</c>. Here is 159particular VM. You use pass that ID to <c>java-config --set-system-vm</c>. Here is
161an example of how to set the system VM. 160an example of how to set the system VM.
162</p> 161</p>
163 162
164<pre caption="Setting the System VM"> 163<pre caption="Setting the System VM">
165# <i>java-config --set-system-vm=ibm-jdk-1.3.1</i> 164# <i>java-config --set-system-vm=ibm-jdk-1.3.1</i>
166Now using IBM JDK 1.3.1 (/etc/env.d/java/20ibm-jdk-1.3.1) 165Now using IBM JDK 1.3.1 (/etc/env.d/java/20ibm-jdk-1.3.1)
167</pre> 166</pre>
168 167
169<note> 168<note>
170You will have to be root to run --set-system-vm. 169You will have to be root to run --set-system-vm.
171</note> 170</note>
172 171
173<p> 172<p>
174Once you have issued <c>java-config --set-system-vm</c> with a particular VM ID, 173Once you have issued <c>java-config --set-system-vm</c> with a particular VM
175you will need to regenerate your /etc/profile.env. You can do it like this: 174ID, you will need to regenerate your <path>/etc/profile.env</path>. You can do
175it like this:
176</p> 176</p>
177 177
178<pre caption="Regenerating /etc/profile.env" > 178<pre caption="Regenerating /etc/profile.env" >
179# <i>env-update</i> 179# <i>env-update</i>
180</pre> 180</pre>
181 181
182<p> 182<p>
183After this, you will either want to relogin, or resource 183After this, you will either want to relogin, or resource
184<path>/etc/profile</path> into your environment. 184<path>/etc/profile</path> into your environment.
185</p> 185</p>
186 186
187<p> 187<p>
188As a regular user, you can use <c>java-config --set-user-vm</c>, which will 188As a regular user, you can use <c>java-config --set-user-vm</c>, which will
189create <path>~/.gentoo/java-env</path> with all required env vars. You would 189create <path>~/.gentoo/java-env</path> with all required env vars. You would
190normally source this from your shell's startup script 190normally source this from your shell's startup script (generally
191(generally <path>~/.bashrc</path>). 191<path>~/.bashrc</path>).
192</p> 192</p>
193 193
194</body> 194</body>
195</section> 195</section>
196</chapter> 196</chapter>
197 197
198<chapter> 198<chapter>
199<title>USE flags for use with Java</title> 199<title>USE flags for use with Java</title>
200<section> 200<section>
201<title>Setting USE flags</title> 201<title>Setting USE flags</title>
202<body> 202<body>
203 203
204<p> 204<p>
205For more information regarding USE flags, refer to the 205For more information regarding USE flags, refer to the <uri
206<uri link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE flags</uri> 206link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE flags</uri>
207chapter from the Gentoo Handbook. 207chapter from the Gentoo Handbook.
208</p> 208</p>
209 209
210</body> 210</body>
211</section> 211</section>
212<section> 212<section>
213<title>The flags</title> 213<title>The flags</title>
214<body> 214<body>
215 215
216<ul> 216<ul>
217<li>The <b>java</b> flag adds support for Java in a variety of programs.</li> 217 <li>The <b>java</b> flag adds support for Java in a variety of programs.</li>
218 <li>
218<li>The <b>browserplugin</b> flag adds support for Mozilla-like browsers (including Firefox) 219 The <b>browserplugin</b> flag adds support for Mozilla-like browsers
219if you are using blackdown's Java kit. You will need this for viewing Java applets 220 (including Firefox) if you are using blackdown's Java kit. You will need
220in your Mozilla-like browser.</li> 221 this for viewing Java applets in your Mozilla-like browser.
222 </li>
221</ul> 223</ul>
222 224
223</body> 225</body>
224</section> 226</section>
225</chapter> 227</chapter>
226 228
227<chapter> 229<chapter>
228<title>Additional resources</title> 230<title>Additional resources</title>
229<section> 231<section>
230<title>Off-line resources</title> 232<title>Off-line resources</title>
231<body> 233<body>
232 234
233<ul> 235<ul>
234<li>java-config man page</li> 236 <li>java-config man page</li>
235<li><c>java-config --help</c></li> 237 <li><c>java-config --help</c></li>
236<li>The <path>/usr/bin/java-config</path> script itself</li> 238 <li>The <path>/usr/bin/java-config</path> script itself</li>
237</ul> 239</ul>
238 240
239</body> 241</body>
240</section> 242</section>
241
242<section> 243<section>
243<title>Online resources</title> 244<title>Online resources</title>
244<body> 245<body>
246
245<ul> 247<ul>
248 <li>
249 The <uri
250 link="http://news.gmane.org/gmane.linux.gentoo.devel">gentoo-dev</uri>,
246<li>The <uri link="http://news.gmane.org/gmane.linux.gentoo.devel" 251 <uri link="http://news.gmane.org/gmane.linux.gentoo.user">gentoo-user
247>gentoo-dev</uri>, <uri link="http://news.gmane.org/gmane.linux.gentoo.user" 252 </uri> and <uri
248>gentoo-user </uri> and <uri link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri> mailing list archives</li> 253 link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri>
249<li>#gentoo and #gentoo-java on irc.freenode.net</li> 254 mailing list archives</li> <li>#gentoo and #gentoo-java on
255 irc.freenode.net
256 </li>
257 <li>
258 <uri
250<li><uri link="http://en.wikipedia.org/wiki/Java_programming_language">Wikipedia's entry for Java</uri></li> 259 link="http://en.wikipedia.org/wiki/Java_programming_language">Wikipedia's
260 entry for Java</uri>
261 </li>
251</ul> 262</ul>
252 263
253</body> 264</body>
254</section> 265</section>
255</chapter> 266</chapter>
256</guide> 267</guide>

Legend:
Removed from v.1.16  
changed lines
  Added in v.1.17

  ViewVC Help
Powered by ViewVC 1.1.20