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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.42 - (hide annotations) (download) (as text)
Sun Sep 28 20:29:25 2008 UTC (5 years, 11 months ago) by nightmorph
Branch: MAIN
Changes since 1.41: +7 -4 lines
File MIME type: application/xml
fixed irc references per council mandate

1 neysx 1.11 <?xml version="1.0" encoding="UTF-8"?>
2 nightmorph 1.42 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.41 2008/05/23 20:07:51 swift Exp $ -->
3 swift 1.8 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 zhen 1.4
5 neysx 1.11 <guide link="/doc/en/java.xml">
6     <title>Gentoo Java Guide</title>
7    
8 nightmorph 1.23 <author title="Author">
9 rane 1.28 <mail link="nichoj@gentoo.org">Joshua Nichols</mail>
10 neysx 1.11 </author>
11 nightmorph 1.23 <author title="Author">
12 rane 1.28 <mail link="karltk@gentoo.org">Karl Trygve Kalleberg</mail>
13 neysx 1.11 </author>
14 swift 1.13 <author title="Editor">
15 nightmorph 1.23 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
16 swift 1.13 </author>
17 neysx 1.11
18     <abstract>
19 nightmorph 1.23 This guide will introduce you to Java and explain how to use Java with Gentoo
20     Linux.
21 neysx 1.11 </abstract>
22    
23 nightmorph 1.23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24     <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25 neysx 1.11 <license/>
26    
27 nightmorph 1.42 <version>0.17</version>
28     <date>2008-09-28</date>
29 neysx 1.11
30     <chapter>
31 swift 1.13 <title>What is Java?</title>
32 neysx 1.11 <section>
33     <title>Overview</title>
34     <body>
35    
36     <p>
37 nightmorph 1.23 Java is a programming language developed by engineers of Sun Microsystems. The
38     language is object-oriented and designed to run on multiple platforms without
39     the need of recompiling code for each platform. Although Java can be compiled
40     as a native program, much of Java's popularity can be attributed to its
41     portability, along with other features such as garbage collection. To make
42     platform independence possible the Java compiler compiles the Java code to an
43     intermediate representation called "Java bytecode" that runs on a JRE (Java
44     Runtime Environment) and not directly on the operating system.
45 swift 1.13 </p>
46    
47     <p>
48 nightmorph 1.23 In order to run Java bytecode, one needs to have a JRE (Java Runtime
49     Environment) installed. A JRE provides core libraries, a platform dependent
50 nightmorph 1.39 Java Virtual Machine, plugins for browsers, among other things. A JDK (Java
51 nightmorph 1.23 Development Kit) adds programming tools, such as a bytecode compiler and a
52     debugger.
53 swift 1.13 </p>
54    
55     </body>
56     </section>
57     </chapter>
58    
59     <chapter>
60 nightmorph 1.35 <title>Before You Begin</title>
61 rane 1.28 <section>
62     <title>Existing installs</title>
63     <body>
64    
65     <p>
66     For existing installs, regardless of if you have installed anything Java
67     before, make sure you have followed the <uri
68     link="/proj/en/java/java-upgrade.xml">Java Upgrade Guide</uri>.
69     </p>
70    
71     </body>
72     </section>
73     <section>
74     <title>New installs</title>
75     <body>
76    
77     <p>
78     New installs should require no further preparation.
79     </p>
80    
81     </body>
82     </section>
83     </chapter>
84    
85     <chapter>
86     <title>Installing a Virtual Machine</title>
87 swift 1.13 <section>
88     <title>The choices</title>
89     <body>
90    
91     <p>
92 rane 1.28 Gentoo provides numerous Runtime Environments (JREs) and Development Kits
93     (JDKs). Among the current choices, we have:
94 swift 1.13 </p>
95    
96 nightmorph 1.23 <table>
97     <tr>
98     <th>Vendor</th>
99     <th>JDK</th>
100     <th>JRE</th>
101     </tr>
102     <tr>
103     <ti>The Blackdown Java Kit</ti>
104 rane 1.27 <ti>dev-java/blackdown-jdk</ti>
105 nightmorph 1.23 <ti>dev-java/blackdown-jre</ti>
106     </tr>
107     <tr>
108     <ti>Sun's Java Kit</ti>
109     <ti>dev-java/sun-jdk</ti>
110     <ti>dev-java/sun-jre-bin</ti>
111     </tr>
112     <tr>
113     <ti>The IBM Java Kit</ti>
114     <ti>dev-java/ibm-jdk-bin</ti>
115     <ti>dev-java/ibm-jre-bin</ti>
116     </tr>
117     <tr>
118     <ti>BEA WebLogic's J2SE Development Kit</ti>
119     <ti>dev-java/jrockit-jdk-bin</ti>
120     </tr>
121     </table>
122    
123     <!--
124 swift 1.41 TODO: list free implementations?
125 rane 1.26 note about not drop-in replacements
126 swift 1.41 kaffe/sablevm/gcj/jamvm
127 nightmorph 1.23 -->
128 swift 1.13 <p>
129 swift 1.41 The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely
130 rane 1.28 ("free as in beer") available without any registration fuss.
131 neysx 1.11 </p>
132    
133     <p>
134 rane 1.28 JREs and JDKs from Sun, IBM, and BEA are generally faster, but getting them
135     is a bit more work, as you are required to read and accept their license before
136     downloading (IBM additionally requires you to register).
137 neysx 1.11 </p>
138    
139 nightmorph 1.23 </body>
140     </section>
141     <section>
142     <title>Installing a JRE/JDKs</title>
143     <body>
144    
145 neysx 1.11 <p>
146 nightmorph 1.23 To install your profile's default JDK, you can run <c>emerge virtual/jdk</c>.
147     Or to install your profile's default JRE, you can <c>emerge virtual/jre</c>.
148 neysx 1.11 </p>
149    
150 rane 1.28 <p>
151     In recent events, Sun has relicensed their JDK and JRE under a more Linux
152     distro friendly license. As a result, Sun releases Java 1.5 and onwards are
153     freely downloadable, without any further hassle.
154     </p>
155    
156 nightmorph 1.23 <note>
157     A JDK also includes a JRE, so if you install a JDK you shouldn't have to also
158     have to install a JRE.
159     </note>
160    
161 neysx 1.11 </body>
162     </section>
163     <section>
164 rane 1.28 <title>Installing fetch-restricted virtual machines</title>
165 neysx 1.11 <body>
166    
167     <p>
168 rane 1.28 As already mentioned, some of the JDKs and JREs require you to jump through a
169     few hoops before installing. Simply emerge the packages as you normally would.
170     The ebuilds will then instruct you where to go and what to download.
171 neysx 1.11 </p>
172    
173     <p>
174     You should download the indicated file(s) into
175 nightmorph 1.23 <path>/usr/portage/distfiles</path>. Once there, you can rerun the emerge
176     command, at which point the JRE/JDK will be begin to install.
177 neysx 1.11 </p>
178    
179     </body>
180     </section>
181     </chapter>
182    
183     <chapter>
184 rane 1.28 <title>Configuring your virtual machine</title>
185 neysx 1.11 <section>
186     <title>Overview</title>
187     <body>
188    
189     <p>
190 nightmorph 1.23 Gentoo has the ability to have multiple JDKs and JREs installed without causing
191     conflicts.
192 neysx 1.11 </p>
193    
194     <p>
195 nightmorph 1.23 Using the <c>java-config</c> tool, you can set the system-wide default
196     (provided you have root access). Users can also use <c>java-config</c> to set
197     up their own personal default.
198 neysx 1.11 </p>
199    
200 nightmorph 1.23 <note>
201     You can also use <e>eselect</e> to change the system and user vm. See
202 nightmorph 1.24 <c>eselect java-vm help</c>.
203 nightmorph 1.23 </note>
204    
205 neysx 1.11 </body>
206     </section>
207     <section>
208 rane 1.28 <title>Setting a default virtual machine</title>
209 neysx 1.11 <body>
210    
211     <p>
212 nightmorph 1.23 Running the command <c>java-config --list-available-vms</c> will give you a
213     list of all JREs and JDKs installed on your system. Here is an example of
214     output:
215 neysx 1.11 </p>
216    
217     <pre caption="Listing available VMs">
218 neysx 1.12 # <i>java-config --list-available-vms</i>
219 nightmorph 1.34 The following VMs are available for generation-2:
220     1) Blackdown JDK 1.4.2.03 [blackdown-jdk-1.4.2]
221     2) Blackdown JRE 1.4.2.03 [blackdown-jre-1.4.2]
222     3) Blackdown 32bit JRE 1.4.2.03 [emul-linux-x86-java-1.4.2]
223     4) Sun 32bit JRE 1.5.0.08 [emul-linux-x86-java-1.5]
224     5) Kaffe 1.1.7 [kaffe]
225     *) Sun JDK 1.5.0.08 [sun-jdk-1.5]
226 neysx 1.11 </pre>
227    
228     <p>
229 nightmorph 1.23 The <e>*</e> indicates this is the current active vm (system-vm or user-vm when
230     set). The name in the brackets (<e>[]</e>) is the handle or ID for that
231     particular VM. You use the handle or the number to <c>java-config
232     --set-system-vm</c>. Here is an example of how to set the system VM.
233 neysx 1.11 </p>
234 zhen 1.4
235 neysx 1.11 <pre caption="Setting the System VM">
236 nightmorph 1.23 <comment>(By handle (preferred))</comment>
237     # <i>java-config --set-system-vm blackdown-jdk-1.4</i>
238 nightmorph 1.34 Now using blackdown-jdk-1.4 as your generation-2 system JVM
239 nightmorph 1.23 <comment>(By number)</comment>
240 nightmorph 1.34 # <i>java-config --set-system-vm 6</i>
241     Now using sun-jdk-1.5 as your generation-2 system JVM
242 neysx 1.11 </pre>
243 drobbins 1.1
244 nightmorph 1.23 <p>
245     As a regular user, you can use <c>java-config --set-user-vm</c>.
246     </p>
247    
248 neysx 1.11 <note>
249 nightmorph 1.23 You no longer have to <c>source</c> the profile for updates to the user/system
250     VM take place.
251 neysx 1.11 </note>
252    
253 nightmorph 1.23 </body>
254     </section>
255     <section id="preferred-vm">
256     <title>Preferred VM</title>
257     <body>
258    
259     <p>
260     While merging Java packages, the VM can and will be switched as necessary.
261     </p>
262    
263     <p>
264     Because of the wide variety of available VMs, we do not have the resources to
265     test and verify every package works on all of them. So to ensure that every
266     packages merges smoothly, we have defined a list of <e>default/supported
267     VMs</e> per arch. You can find them in
268 nightmorph 1.37 <path>/usr/share/java-config-2/config/jdk-defaults.conf</path>. When you are
269 nightmorph 1.23 merging a Java package, and it detects one of the VM in that file is installed,
270     it will automatically use that VM, instead of the system-vm.
271     </p>
272    
273 neysx 1.11 <p>
274 nightmorph 1.23 The merge time VM switching is also needed when, for example, your system-vm is
275     set a 1.4 VM and the package you are merging requires a 1.5 VM. While merging
276     it will use the preferred 1.5 VM, leaving your system-vm choice intact.
277 neysx 1.11 </p>
278 drobbins 1.1
279 nightmorph 1.23 <p>
280     Of course, Gentoo is all about choice, so you can override these defaults in
281     <path>/etc/java-config-2/build/jdk.conf</path> and have complete control over
282     which VM will get used. Some examples:
283     </p>
284    
285     <pre caption="Example /etc/java-config-2/build/jdk.conf">
286     <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>
287     *=sun-jdk
288 neysx 1.11 </pre>
289 drobbins 1.1
290 nightmorph 1.23 <pre caption="Example /etc/java-config-2/build/jdk.conf">
291     <comment>(Always use sun-jdk-1.5 wherever possible, except for when a 1.4 or 1.3 VM is explicitly required)</comment>
292     *=sun-jdk-1.5
293     </pre>
294    
295     <pre caption="Example /etc/java-config-2/build/jdk.conf">
296     <comment># For 1.3 I prefer sun-jdk 1.4 but when it is not available, use ibm-jdk-bin,
297     # For 1.4, use blackdown-jdk, and for 1.5, use sun-jdk </comment>
298     1.3=sun-jdk-1.4 ibm-jdk-bin
299     1.4=blackdown-jdk
300     1.5=sun-jdk
301     </pre>
302    
303     <warn>
304     You do not have to edit this file. If you change these options to use a
305     unsupported VM, things could possibly break. Bugs reported with a unsupported
306 rane 1.26 VM won't be prioritized as much as bugs present within supported VMs.
307 nightmorph 1.23 </warn>
308    
309     </body>
310     </section>
311     </chapter>
312    
313     <chapter>
314     <title>Compilers</title>
315     <section>
316     <body>
317    
318 neysx 1.11 <p>
319 nightmorph 1.23 The standard Java compiler used for building is javac, which comes with each
320     JDK. In addition to configuring the VM used at build time, it is also possible
321     configure which compiler is used. Essentially, you define a list your
322     preference for which compiler to use in
323     <path>/etc/java-config-2/build/compilers.conf</path>.
324 neysx 1.11 </p>
325    
326 nightmorph 1.23 <pre caption="/etc/java-config-2/build/compilers.conf">
327     # If the ebuild supports it
328     # it will check the COMPILERS var front to back and
329     # use the first compiler that is installed
330    
331     COMPILERS="ecj-3.1 jikes javac"
332     </pre>
333    
334 neysx 1.11 <p>
335 nightmorph 1.23 Some compilers don't support all possible -target and -source arguments.
336     Therefore, each compiler in the list is checked to see if it can support the
337     desired -source/-target. javac will work in all cases, so if no other suitable
338     compiler is found, it will be used instead.
339 neysx 1.11 </p>
340    
341 nightmorph 1.23 <p>
342     More details about each compiler are provided below:
343     </p>
344    
345     <table>
346     <tr>
347     <th>Name</th>
348     <th>Handle</th>
349     <th>Package</th>
350     <th>Description</th>
351     </tr>
352     <tr>
353     <ti>javac</ti>
354     <ti>javac</ti>
355     <ti>N/A</ti>
356     <ti>
357     This is the default compiler that will be used, and comes with each JDK.
358     </ti>
359     </tr>
360     <tr>
361     <ti>jikes</ti>
362     <ti>jikes</ti>
363     <ti>dev-java/jikes</ti>
364     <ti>
365     Jikes was originally developed by IBM. Anecdotally, it is generally quicker
366     than javac. Note however, that it is more pedantic, and will fail under a
367     few circumstances where javac has no issue. It also does not support Java
368     1.5 syntax yet.
369     </ti>
370     </tr>
371     <tr>
372     <ti>Eclipse Compiler for Java</ti>
373     <ti>ecj-3.1</ti>
374     <ti>=dev-java/eclipse-ecj-3.1*</ti>
375     <ti>
376     ECJ is the compiler used by the Eclipse software development kit. It is
377     very full featured, and is pretty fast. It does support Java 1.5 syntax.
378     </ti>
379     </tr>
380     </table>
381    
382     </body>
383     </section>
384     </chapter>
385    
386     <chapter>
387     <title>Setting a default CLASSPATH</title>
388     <section>
389     <body>
390    
391     <warn>
392     The options explained in this section should be considered deprecated and will
393 rane 1.26 most likely be removed in the future. We strongly recommend against using
394 nightmorph 1.23 these, because your Java projects or application should ideally manage their
395     own classpaths. If you choose to specify a default CLASSPATH, some applications
396     may behave unexpectedly, because classes they weren't expecting would be on the
397     classpath.
398     </warn>
399    
400     <p>
401     <c>java-config</c> can also be used to set a system-wide default CLASSPATH, as
402     well a user-specific default CLASSPATH.
403     </p>
404    
405     <p>
406     First, you will want to list available Java libraries installed on your system
407     that might want to be put in your CLASSPATH. Here is an example of output:
408     </p>
409    
410     <pre caption="Listing classes">
411     # <i>java-config --list-available-packages</i>
412     [xerces-2] The next generation of high performance, fully compliant XML parsers in the Apache Xerces family (/usr/share/xerces-2/package.env)
413     [junit] Simple framework to write repeatable tests (/usr/share/junit/package.env)
414     [bsh] BeanShell: A small embeddable Java source interpreter (/usr/share/bsh/package.env)
415     [bcel] The Byte Code Engineering Library: analyze, create, manipulate Java class files (/usr/share/bcel/package.env)
416     [log4j] A low-overhead robust logging package for Java (/usr/share/log4j/package.env)
417     ...
418     </pre>
419    
420     <p>
421     Again, the names in brackets (<e>[]</e>) are the IDs that you have to pass to
422     <c>java-config --set-system-classpath</c>. Here is an example:
423     </p>
424    
425     <pre caption="Setting classpaths">
426     # <i>java-config --set-system-classpath log4j,xerces-2</i>
427     </pre>
428    
429     <note>
430     The current directory (<path>.</path>) will not be part of the system
431     classpath, as that should be added in your system's login profile.
432     </note>
433    
434     <p>
435 rane 1.26 You will have to update your environment by logging out, then in again or
436     sourcing <path>/etc/profile</path>.
437 nightmorph 1.23 </p>
438    
439     <p>
440     For users, <c>java-config --set-user-classpath</c> will create
441     <path>~/.gentoo/java-env-classpath</path>, which you should then source from
442 swift 1.41 your shell's profile.
443 nightmorph 1.23 </p>
444    
445     <pre caption="Sourcing user specific classpath">
446     <i>if [[ -f "${HOME}/.gentoo/java-env-classpath" ]]; then
447     source ${HOME}/.gentoo/java-env-classpath
448     fi</i>
449     </pre>
450    
451     <p>
452     If you really want a system wide or user default classpath you can add
453 rane 1.25 something like the following to your shell's profile. But we would advise
454 nightmorph 1.23 against it.
455     </p>
456    
457     <pre caption="Setting classpath">
458 swift 1.41 # <i>export CLASSPATH="${CLASSPATH}:$(java-config --classpath log4j,xerces-2)"</i>
459 nightmorph 1.23 </pre>
460    
461 neysx 1.11 </body>
462     </section>
463 swift 1.13 </chapter>
464    
465     <chapter>
466 nightmorph 1.39 <title>Java Browser Plugins</title>
467 nightmorph 1.34 <section>
468 nightmorph 1.39 <title>Installing a plugin</title>
469 nightmorph 1.34 <body>
470    
471     <p>
472 nightmorph 1.39 You can install a Java plugin for your web browser by emerging a Java VM with
473 nightmorph 1.34 the <c>nsplugin</c> USE flag set.
474     </p>
475    
476     <note>
477     <c>nsplugin</c> is not available for all architectures. Check for available
478 nightmorph 1.39 plugins on your arch before trying to install a VM by running <c>emerge -pv
479 nightmorph 1.34 &lt;java-vm&gt;</c>.
480     </note>
481    
482     <p>
483 nightmorph 1.39 Portage will allow you to install multiple versions of Java plugins, though
484 nightmorph 1.34 only one will be used by your browser. You can check the list of available
485 nightmorph 1.39 plugins by running:
486 nightmorph 1.34 </p>
487    
488 nightmorph 1.39 <pre caption="Viewing available plugins">
489 nightmorph 1.34 # <i>eselect java-nsplugin list</i>
490     [1] sun-jre-bin-1.5
491     [2] blackdown-jre-1.4.2
492     </pre>
493    
494     <p>
495 nightmorph 1.39 In this example, <c>sun-jre-bin</c> is selected for the browser plugin.
496 nightmorph 1.34 </p>
497    
498 nightmorph 1.39 <pre caption="Selecting a plugin">
499 nightmorph 1.36 # <i>eselect java-nsplugin set sun-jre-bin-1.5</i>
500 nightmorph 1.34 </pre>
501    
502     <p>
503 nightmorph 1.39 Verify that the correct plugin was selected:
504 nightmorph 1.34 </p>
505    
506 nightmorph 1.39 <pre caption="Verifying the correct plugin">
507 nightmorph 1.34 # <i>eselect java-nsplugin list</i>
508     [1] sun-jre-bin-1.5 current
509     [2] blackdown-jre-1.4.2
510     </pre>
511    
512     <p>
513     Java.com also provides a link to <uri
514     link="http://java.com/en/download/installed.jsp">verify your installed
515 nightmorph 1.39 plugin</uri>. Additionally, if you are using a Mozilla-based browser, you can
516     verify your Java plugin by typing <c>about:plugins</c> into the address bar.
517 nightmorph 1.34 </p>
518    
519     </body>
520     </section>
521     <section>
522 nightmorph 1.39 <title>Plugins on multilib systems</title>
523 nightmorph 1.34 <body>
524    
525     <p>
526 swift 1.41 If you are running a mixed 64-bit and 32-bit multilib system (for example, on
527     AMD64), you can only use 32-bit Java plugins.
528 nightmorph 1.34 </p>
529    
530     <p>
531 nightmorph 1.39 To use a 32-bit plugin, you will need to emerge <c>emul-linux-x86-java</c> with
532 nightmorph 1.38 the <c>nsplugin</c> USE flag enabled.
533     </p>
534    
535 nightmorph 1.39 <pre caption="Installing a 32-bit plugin">
536 nightmorph 1.38 # <i>echo "app-emulation/emul-linux-x86-java nsplugin" >> /etc/portage/package.use</i>
537     # <i>emerge emul-linux-x86-java</i>
538     </pre>
539    
540     <p>
541 nightmorph 1.39 Next, check which plugins are available:
542 nightmorph 1.34 </p>
543    
544 nightmorph 1.39 <pre caption="Viewing available plugins">
545 nightmorph 1.34 # <i>eselect java-nsplugin list</i>
546     Available 32-bit Java browser plugins
547     [1] emul-linux-x86-java-1.4.2
548     [2] emul-linux-x86-java-1.5
549     </pre>
550    
551     <p>
552 nightmorph 1.39 Although you must select a 32-bit browser (such as <c>mozilla-firefox-bin</c>)
553     to use with your 32-bit plugin, the 64-bit version of <c>konqueror</c> uses your
554     Java VM directly, so it's possible to use the 64-bit version of <c>blackdown</c>
555     with this browser; no further configuration is necessary.
556 nightmorph 1.34 </p>
557    
558 nightmorph 1.39 <p>
559     Now select the right plugin for your 32-bit browser:
560     </p>
561    
562     <pre caption="Selecting plugins">
563     # <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.5</i>
564 nightmorph 1.34 </pre>
565    
566     <p>
567 nightmorph 1.39 Verify the correct plugin was selected:
568 nightmorph 1.34 </p>
569    
570 nightmorph 1.39 <pre caption="Verifying the correct plugin">
571 nightmorph 1.34 # <i>eselect java-nsplugin list</i>
572     Available 32-bit Java browser plugins
573 nightmorph 1.39 [1] emul-linux-x86-java-1.4.2
574     [2] emul-linux-x86-java-1.5 current
575 nightmorph 1.34 </pre>
576    
577     </body>
578     </section>
579     </chapter>
580    
581     <chapter>
582 swift 1.13 <title>USE flags for use with Java</title>
583     <section>
584     <title>Setting USE flags</title>
585     <body>
586    
587     <p>
588 rane 1.17 For more information regarding USE flags, refer to the <uri
589     link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=2">USE flags</uri>
590 swift 1.13 chapter from the Gentoo Handbook.
591 neysx 1.11 </p>
592    
593     </body>
594     </section>
595 swift 1.13 <section>
596     <title>The flags</title>
597     <body>
598    
599     <ul>
600 nightmorph 1.23 <li>The <b>java</b> flag adds support for Java in a variety of programs</li>
601     <li>
602     The <b>nsplugin</b> flag adds support for Mozilla-like browsers (including
603 nightmorph 1.33 Firefox). You will need this for viewing Java applets in your Mozilla-like
604 nightmorph 1.23 browser.
605     </li>
606 rane 1.17 <li>
607 rane 1.28 The <b>source</b> flag installs a zip of the source code of a package.
608 nightmorph 1.33 This is traditionally used for IDEs to 'attach' source to the libraries you
609     are using.
610 rane 1.28 </li>
611 nightmorph 1.40 <li>The <b>jce</b> flag adds support for the Java Cryptography Engine</li>
612 rane 1.28 <li>
613     For Java packages, the <b>doc</b> flag will build API documentation using
614     javadoc.
615     </li>
616 swift 1.13 </ul>
617    
618     </body>
619     </section>
620 neysx 1.11 </chapter>
621    
622     <chapter>
623     <title>Additional resources</title>
624     <section>
625     <title>Off-line resources</title>
626     <body>
627    
628     <ul>
629 rane 1.17 <li>java-config man page</li>
630     <li><c>java-config --help</c></li>
631 neysx 1.11 </ul>
632    
633     </body>
634     </section>
635     <section>
636     <title>Online resources</title>
637     <body>
638 rane 1.17
639 neysx 1.11 <ul>
640 nightmorph 1.23 <li>
641     The <uri link="http://www.gentoo.org/proj/en/java/">Java Project
642     Page</uri>
643     </li>
644 rane 1.17 <li>
645     The <uri
646 nightmorph 1.23 link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri>,
647     <uri
648     link="http://news.gmane.org/gmane.linux.gentoo.user">gentoo-user</uri>, and
649     <uri
650     link="http://news.gmane.org/gmane.linux.gentoo.devel">gentoo-dev</uri>
651 alin 1.18 mailing list archives
652 rane 1.17 </li>
653 nightmorph 1.42 <li>
654     <uri link="irc://irc.gentoo.org/gentoo">#gentoo</uri> and <uri
655     link="irc://irc.gentoo.org/gentoo-java">#gentoo-java</uri> on IRC
656     </li>
657 rane 1.17 <li>
658     <uri
659     link="http://en.wikipedia.org/wiki/Java_programming_language">Wikipedia's
660     entry for Java</uri>
661     </li>
662 nightmorph 1.40 <li>
663     If you have suggestions or questions regarding this document, please email
664     the Gentoo Java team: <mail>java@gentoo.org</mail>
665     </li>
666 neysx 1.11 </ul>
667    
668     </body>
669     </section>
670     </chapter>
671 neysx 1.12 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20