/[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.34 Revision 1.35
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.34 2006/10/08 22:52:16 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.35 2006/10/15 22:03:16 nightmorph 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"> 8<author title="Author">
9 <mail link="nichoj@gentoo.org">Joshua Nichols</mail> 9 <mail link="nichoj@gentoo.org">Joshua Nichols</mail>
10</author> 10</author>
11<author title="Author"> 11<author title="Author">
12 <mail link="karltk@gentoo.org">Karl Trygve Kalleberg</mail> 12 <mail link="karltk@gentoo.org">Karl Trygve Kalleberg</mail>
13</author> 13</author>
14<author title="Editor"> 14<author title="Editor">
15 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> 15 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
16</author> 16</author>
17 17
18<abstract> 18<abstract>
19This guide will introduce you to Java and explain how to use Java with Gentoo 19This guide will introduce you to Java and explain how to use Java with Gentoo
20Linux. 20Linux.
21</abstract> 21</abstract>
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.10</version> 27<version>0.11</version>
28<date>2006-10-08</date> 28<date>2006-10-15</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>
34<body> 34<body>
35 35
36<p> 36<p>
37Java is a programming language developed by engineers of Sun Microsystems. The 37Java is a programming language developed by engineers of Sun Microsystems. The
38language is object-oriented and designed to run on multiple platforms without 38language is object-oriented and designed to run on multiple platforms without
39the need of recompiling code for each platform. Although Java can be compiled 39the need of recompiling code for each platform. Although Java can be compiled
40as a native program, much of Java's popularity can be attributed to its 40as a native program, much of Java's popularity can be attributed to its
41portability, along with other features such as garbage collection. To make 41portability, along with other features such as garbage collection. To make
42platform independence possible the Java compiler compiles the Java code to an 42platform independence possible the Java compiler compiles the Java code to an
43intermediate representation called "Java bytecode" that runs on a JRE (Java 43intermediate representation called "Java bytecode" that runs on a JRE (Java
45</p> 45</p>
46 46
47<p> 47<p>
48In order to run Java bytecode, one needs to have a JRE (Java Runtime 48In order to run Java bytecode, one needs to have a JRE (Java Runtime
49Environment) installed. A JRE provides core libraries, a platform dependent 49Environment) installed. A JRE provides core libraries, a platform dependent
50Java Virtual Machine, plug-ins for browsers, among other things. A JDK (Java 50Java Virtual Machine, plug-ins for browsers, among other things. A JDK (Java
51Development Kit) adds programming tools, such as a bytecode compiler and a 51Development Kit) adds programming tools, such as a bytecode compiler and a
52debugger. 52debugger.
53</p> 53</p>
54 54
55</body> 55</body>
56</section> 56</section>
57</chapter> 57</chapter>
58 58
59<chapter> 59<chapter>
60<title>New Java System</title> 60<title>Before You Begin</title>
61<section>
62<body>
63
64<p>
65The way Java is handled on Gentoo has recently seen many changes and
66improvements. This has only happened very recently, and as a result, all the
67packages related to it are marked with testing keywords, ie ~x86. This
68document assumes you are using the new system.
69</p>
70
71</body>
72</section>
73<section>
74<title>Keywords</title>
75<body>
76
77<p>
78If you are using the stable tree opposed to ~arch, you will need to add some
79entries to your <path>/etc/portage/package.keywords</path>:
80</p>
81
82<pre caption="package.keywords">
83# Core Gentoo/Java Packages
84dev-java/ant-core
85dev-java/ant-tasks
86dev-java/ant
87dev-java/java-config
88dev-java/java-config-wrapper
89dev-java/javatoolkit
90dev-java/sun-jce-bin
91# JDKs
92=dev-java/sun-jdk-1.4*
93=dev-java/sun-jdk-1.5*
94=dev-java/ibm-jdk-bin-1.4*
95=dev-java/ibm-jdk-bin-1.5*
96=dev-java/jrockit-jdk-bin-1.4*
97=dev-java/jrockit-jdk-bin-1.5*
98=dev-java/blackdown-jdk-1.4*
99dev-java/kaffe
100# JREs
101=dev-java/sun-jre-bin-1.4*
102=dev-java/sun-jre-bin-1.5*
103=dev-java/ibm-jre-bin-1.4*
104=dev-java/blackdown-jre-1.4*
105# Virtuals
106virtual/jdk
107virtual/jre
108# Compilers
109dev-java/eclipse-ecj
110dev-java/jikes
111# Documentation
112dev-java/java-sdk-docs
113# Misc packages that have been updated to generation-2,
114# where the generation-1 won't build and/or run properly
115dev-java/lucene
116# These have optional Java support, but need ~arch to function properly
117# with generation-2
118dev-util/subversion
119sys-libs/db
120</pre>
121
122<warn>
123It is crucial that you list ALL these packages in
124<path>/etc/portage/package.keywords</path>, otherwise you will have problems in
125the later steps of this guide. Your new Java system will not function correctly
126without this list.
127</warn>
128
129</body>
130</section>
131<section> 61<section>
132<title>Existing installs</title> 62<title>Existing installs</title>
133<body> 63<body>
134 64
135<p> 65<p>
136For existing installs, regardless of if you have installed anything Java 66For existing installs, regardless of if you have installed anything Java
137before, make sure you have followed the <uri 67before, make sure you have followed the <uri
138link="/proj/en/java/java-upgrade.xml">Java Upgrade Guide</uri>. 68link="/proj/en/java/java-upgrade.xml">Java Upgrade Guide</uri>.
139</p> 69</p>
140 70
141</body> 71</body>
142</section> 72</section>
143<section> 73<section>
144<title>New installs</title> 74<title>New installs</title>
145<body> 75<body>

Legend:
Removed from v.1.34  
changed lines
  Added in v.1.35

  ViewVC Help
Powered by ViewVC 1.1.20