1 |
rane 06/08/08 09:51:12 |
2 |
|
3 |
Modified: java.xml |
4 |
Log: |
5 |
#143152, updated by java team |
6 |
|
7 |
Revision Changes Path |
8 |
1.28 xml/htdocs/doc/en/java.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.28&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.28&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.27&r2=1.28 |
13 |
|
14 |
Index: java.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v |
17 |
retrieving revision 1.27 |
18 |
retrieving revision 1.28 |
19 |
diff -u -r1.27 -r1.28 |
20 |
--- java.xml 25 Jul 2006 08:13:47 -0000 1.27 |
21 |
+++ java.xml 8 Aug 2006 09:51:12 -0000 1.28 |
22 |
@@ -1,15 +1,15 @@ |
23 |
<?xml version="1.0" encoding="UTF-8"?> |
24 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.27 2006/07/25 08:13:47 rane Exp $ --> |
25 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.28 2006/08/08 09:51:12 rane Exp $ --> |
26 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
27 |
|
28 |
<guide link="/doc/en/java.xml"> |
29 |
<title>Gentoo Java Guide</title> |
30 |
|
31 |
<author title="Author"> |
32 |
- <mail link="karltk@g.o">Karl Trygve Kalleberg</mail> |
33 |
+ <mail link="nichoj@g.o">Joshua Nichols</mail> |
34 |
</author> |
35 |
<author title="Author"> |
36 |
- <mail link="nichoj@g.o">Joshua Nichols</mail> |
37 |
+ <mail link="karltk@g.o">Karl Trygve Kalleberg</mail> |
38 |
</author> |
39 |
<author title="Editor"> |
40 |
<mail link="nightmorph@g.o">Joshua Saddler</mail> |
41 |
@@ -24,8 +24,8 @@ |
42 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
43 |
<license/> |
44 |
|
45 |
-<version>0.5</version> |
46 |
-<date>2006-07-24</date> |
47 |
+<version>0.6</version> |
48 |
+<date>2006-08-07</date> |
49 |
|
50 |
<chapter> |
51 |
<title>What is Java?</title> |
52 |
@@ -57,14 +57,113 @@ |
53 |
</chapter> |
54 |
|
55 |
<chapter> |
56 |
-<title>Installing a JRE/JDK</title> |
57 |
+<title>New Java System</title> |
58 |
+<section> |
59 |
+<body> |
60 |
+ |
61 |
+<p> |
62 |
+The way Java is handled on Gentoo has recently seen many changes and |
63 |
+improvements. This has only happened very recently, and as a result, all the |
64 |
+packages related to it are marked with testing keywords, ie ~x86. This |
65 |
+document assumes you are using the new system. |
66 |
+</p> |
67 |
+ |
68 |
+</body> |
69 |
+</section> |
70 |
+<section> |
71 |
+<title>Keywords</title> |
72 |
+<body> |
73 |
+ |
74 |
+<p> |
75 |
+If you are using the stable tree, i.e. x86, ppc, or amd64 as opposed to ~x86, |
76 |
+~ppc, or ~amd64, you will need to add some entries to your |
77 |
+<path>/etc/portage/package.keywords</path>: |
78 |
+</p> |
79 |
+ |
80 |
+<pre caption="package.keywords"> |
81 |
+# Core Gentoo/Java Packages |
82 |
+dev-java/ant-core |
83 |
+dev-java/ant-tasks |
84 |
+dev-java/ant |
85 |
+dev-java/java-config |
86 |
+dev-java/java-config-wrapper |
87 |
+dev-java/javatoolkit |
88 |
+# JDKs |
89 |
+=dev-java/sun-jdk-1.4* |
90 |
+=dev-java/sun-jdk-1.5* |
91 |
+=dev-java/ibm-jdk-bin-1.4* |
92 |
+=dev-java/ibm-jdk-bin-1.5* |
93 |
+=dev-java/jrockit-jdk-bin-1.4* |
94 |
+=dev-java/jrockit-jdk-bin-1.5* |
95 |
+=dev-java/blackdown-jdk-1.4* |
96 |
+dev-java/kaffe |
97 |
+# JREs |
98 |
+=dev-java/sun-jre-bin-1.4* |
99 |
+=dev-java/sun-jre-bin-1.5* |
100 |
+=dev-java/ibm-jre-bin-1.4* |
101 |
+=dev-java/blackdown-jre-1.4* |
102 |
+# Virtuals |
103 |
+virtual/jdk |
104 |
+virtual/jre |
105 |
+# Compilers |
106 |
+dev-java/eclipse-ecj |
107 |
+dev-java/jikes |
108 |
+# Documentation |
109 |
+dev-java/java-sdk-docs |
110 |
+# Misc packages that have been updated to generation-2, |
111 |
+# where the generation-1 won't build and/or run properly |
112 |
+dev-java/lucene |
113 |
+# These have optional Java support, but need ~arch to function properly |
114 |
+# with generation-2 |
115 |
+dev-util/subversion |
116 |
+sys-libs/db |
117 |
+</pre> |
118 |
+ |
119 |
+<impo> |
120 |
+It is crucial that you keyword ALL packages related to the new Java system, |
121 |
+otherwise you will have problems in the later steps of this guide. |
122 |
+</impo> |
123 |
+ |
124 |
+<impo> |
125 |
+It can't be emphasized enough that you have to have ALL the packages related |
126 |
+to the new Java system keyworded for it to function properly. |
127 |
+</impo> |
128 |
+ |
129 |
+</body> |
130 |
+</section> |
131 |
+<section> |
132 |
+<title>Existing installs</title> |
133 |
+<body> |
134 |
+ |
135 |
+<p> |
136 |
+For existing installs, regardless of if you have installed anything Java |
137 |
+before, make sure you have followed the <uri |
138 |
+link="/proj/en/java/java-upgrade.xml">Java Upgrade Guide</uri>. |
139 |
+</p> |
140 |
+ |
141 |
+</body> |
142 |
+</section> |
143 |
+<section> |
144 |
+<title>New installs</title> |
145 |
+<body> |
146 |
+ |
147 |
+<p> |
148 |
+New installs should require no further preparation. |
149 |
+</p> |
150 |
+ |
151 |
+</body> |
152 |
+</section> |
153 |
+</chapter> |
154 |
+ |
155 |
+<chapter> |
156 |
+<title>Installing a Virtual Machine</title> |
157 |
<section> |
158 |
<title>The choices</title> |
159 |
<body> |
160 |
|
161 |
<p> |
162 |
-Gentoo provides numerous JREs and JDKs. Among the current alternatives, we |
163 |
-have: |
164 |
+Gentoo provides numerous Runtime Environments (JREs) and Development Kits |
165 |
+(JDKs). Among the current choices, we have: |
166 |
</p> |
167 |
|
168 |
<table> |
169 |
@@ -111,14 +210,14 @@ |
170 |
</p> |
171 |
|
172 |
<p> |
173 |
-Both the Sun and the IBM are generally faster, but getting them is a bit more |
174 |
-hassle, as you are required to read and accept their license before downloading |
175 |
-(IBM additionally requires you to register). |
176 |
+The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely |
177 |
+("free as in beer") available without any registration fuss. |
178 |
</p> |
179 |
|
180 |
<p> |
181 |
-Our ebuilds for the Sun and IBM JRE/JDKs will inform you how to download the |
182 |
-appropriate files. |
183 |
+JREs and JDKs from Sun, IBM, and BEA are generally faster, but getting them |
184 |
+is a bit more work, as you are required to read and accept their license before |
185 |
+downloading (IBM additionally requires you to register). |
186 |
</p> |
187 |
|
188 |
</body> |
189 |
@@ -132,6 +231,12 @@ |
190 |
Or to install your profile's default JRE, you can <c>emerge virtual/jre</c>. |
191 |
</p> |
192 |
|
193 |
+<p> |
194 |
+In recent events, Sun has relicensed their JDK and JRE under a more Linux |
195 |
+distro friendly license. As a result, Sun releases Java 1.5 and onwards are |
196 |
+freely downloadable, without any further hassle. |
197 |
+</p> |
198 |
+ |
199 |
<note> |
200 |
A JDK also includes a JRE, so if you install a JDK you shouldn't have to also |
201 |
have to install a JRE. |
202 |
@@ -140,15 +245,13 @@ |
203 |
</body> |
204 |
</section> |
205 |
<section> |
206 |
-<title>Installing the Sun/IBM JRE/JDKs</title> |
207 |
+<title>Installing fetch-restricted virtual machines</title> |
208 |
<body> |
209 |
|
210 |
<p> |
211 |
-If you run <c>emerge dev-java/sun-jdk</c> or <c>emerge |
212 |
-dev-java/ibm-jdk-bin</c>, you will be notified that you are required to |
213 |
-download the actual files yourself. This has to do with license restrictions |
214 |
-for the Sun JRE/JDK (online click-wrap license) and registration issues with |
215 |
-the IBM JRE/JDK. |
216 |
+As already mentioned, some of the JDKs and JREs require you to jump through a |
217 |
+few hoops before installing. Simply emerge the packages as you normally would. |
218 |
+The ebuilds will then instruct you where to go and what to download. |
219 |
</p> |
220 |
|
221 |
<p> |
222 |
@@ -162,7 +265,7 @@ |
223 |
</chapter> |
224 |
|
225 |
<chapter> |
226 |
-<title>Configuring your JRE/JDK</title> |
227 |
+<title>Configuring your virtual machine</title> |
228 |
<section> |
229 |
<title>Overview</title> |
230 |
<body> |
231 |
@@ -186,7 +289,7 @@ |
232 |
</body> |
233 |
</section> |
234 |
<section> |
235 |
-<title>Setting a default JRE/JDK</title> |
236 |
+<title>Setting a default virtual machine</title> |
237 |
<body> |
238 |
|
239 |
<p> |
240 |
@@ -480,6 +583,15 @@ |
241 |
This is typically used to provide your IDE with the source code for the |
242 |
package. |
243 |
</li> |
244 |
+ <li> |
245 |
+ The <b>source</b> flag installs a zip of the source code of a package. |
246 |
+ This is traditionally used for for IDEs to 'attach' source to the libraries |
247 |
+ you are using. |
248 |
+ </li> |
249 |
+ <li> |
250 |
+ For Java packages, the <b>doc</b> flag will build API documentation using |
251 |
+ javadoc. |
252 |
+ </li> |
253 |
</ul> |
254 |
|
255 |
</body> |
256 |
|
257 |
|
258 |
|
259 |
-- |
260 |
gentoo-doc-cvs@g.o mailing list |