* [gentoo-doc-cvs] cvs commit: java.xml
@ 2005-09-29 18:22 Lukasz Damentko
0 siblings, 0 replies; 26+ messages in thread
From: Lukasz Damentko @ 2005-09-29 18:22 UTC (permalink / raw
To: gentoo-doc-cvs
rane 05/09/29 18:22:22
Modified: xml/htdocs/doc/en java.xml
Log:
#107293: switching deprecated mozilla USE flag to browserplugin, removing CLASSPATH setting (not supported anymore) and adding info about gentoo-java mailing list
Revision Changes Path
1.16 +5 -65 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.16&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.16&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.15&r2=1.16&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- java.xml 23 Mar 2005 13:40:23 -0000 1.15
+++ java.xml 29 Sep 2005 18:22:22 -0000 1.16
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.15 2005/03/23 13:40:23 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.16 2005/09/29 18:22:22 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -22,8 +22,8 @@
<license/>
-<version>0.1.6</version>
-<date>2005-03-06</date>
+<version>0.1.7</version>
+<date>2005-09-29</date>
<chapter>
<title>What is Java?</title>
@@ -193,66 +193,6 @@
</body>
</section>
-
-<section>
-<title>Setting a default CLASSPATH</title>
-<body>
-
-<p>
-<c>java-config</c> can also be used to set a system-wide default CLASSPATH, and
-of course a user-specific default CLASSPATH.
-</p>
-
-<p>
-First you want to list available java libraries that might be interesting to put
-in your CLASSPATH. Here is an example of output:
-</p>
-
-<pre caption="Listing classes">
-# <i>java-config --list-available-packages</i>
-[bsh] BeanShell is a small, free, embeddable, Java
-source interpreter with object scripting language
-features. (/usr/share/bsh/package.env)
-[oro] A set of text-processing Java classes that
-provide Perl5 compatible regular expressions, AWK-like
-regular expressions, glob expressions, and utility
-classes for performing substitutions, splits, filtering
-filenames, etc. (/usr/share/oro/package.env)
-[bcel] The Byte Code Engineering Library: analyze, create,
-manipulate Java class files (/usr/share/bcel/package.env)
-[jsch] JSch is a pure Java implementation of SSH2.
-(/usr/share/jsch/package.env)
-...
-</pre>
-
-<p>
-Again, the name in brackets <path>"[]"</path> are the IDs that you have to pass
-to <c>java-config --set-system-classpath</c>. Here is an example:
-</p>
-
-<pre caption="Setting classpaths">
-# <i>java-config --set-system-classpath=log4j,java-gtk,java-gnome</i>
-</pre>
-
-<note>
-The current directory (.) will not be part of the system classpath, as that
-should be added in root's login profile.
-</note>
-
-<p>
-Again, you will want to run <c>env-update</c> to update your system's
-environment, and you might also want to relogin or resource the
-<path>/etc/profile</path>.
-</p>
-
-<p>
-For users, <c>java-config --set-user-classpath</c> will create
-<path>~/.gentoo/java-env-classpath</path>, which is automatically included
-by <path>~/.gentoo/java-env</path>.
-</p>
-
-</body>
-</section>
</chapter>
<chapter>
@@ -275,7 +215,7 @@
<ul>
<li>The <b>java</b> flag adds support for Java in a variety of programs.</li>
-<li>The <b>mozilla</b> flag adds support for Mozilla-like browsers (including Firefox)
+<li>The <b>browserplugin</b> flag adds support for Mozilla-like browsers (including Firefox)
if you are using blackdown's Java kit. You will need this for viewing Java applets
in your Mozilla-like browser.</li>
</ul>
@@ -305,7 +245,7 @@
<ul>
<li>The <uri link="http://news.gmane.org/gmane.linux.gentoo.devel"
>gentoo-dev</uri>, <uri link="http://news.gmane.org/gmane.linux.gentoo.user"
->gentoo-user </uri> mailing list archives</li>
+>gentoo-user </uri> and <uri link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri> mailing list archives</li>
<li>#gentoo and #gentoo-java on irc.freenode.net</li>
<li><uri link="http://en.wikipedia.org/wiki/Java_programming_language">Wikipedia's entry for Java</uri></li>
</ul>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2005-09-29 18:27 Lukasz Damentko
0 siblings, 0 replies; 26+ messages in thread
From: Lukasz Damentko @ 2005-09-29 18:27 UTC (permalink / raw
To: gentoo-doc-cvs
rane 05/09/29 18:27:32
Modified: xml/htdocs/doc/en java.xml
Log:
fixed coding style, no content change
Revision Changes Path
1.17 +37 -26 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.17&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.17&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.16&r2=1.17&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- java.xml 29 Sep 2005 18:22:22 -0000 1.16
+++ java.xml 29 Sep 2005 18:27:31 -0000 1.17
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.16 2005/09/29 18:22:22 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.17 2005/09/29 18:27:31 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -64,11 +64,11 @@
</p>
<ul>
-<li>blackdown-jre and blackdown-jdk, the Blackdown Java Kit</li>
-<li>sun-jre-bin and sun-jdk, Sun's Java Kit </li>
-<li>ibm-jre-bin and ibm-jdk-bin, the IBM Java Kit</li>
-<li>compaq-jre and compaq-jdk, the Compaq Java Kit for Alpha/Linux/GNU</li>
-<li>jrockit-jdk-bin, BEA WebLogic's J2SE Development Kit</li>
+ <li>blackdown-jre and blackdown-jdk, the Blackdown Java Kit</li>
+ <li>sun-jre-bin and sun-jdk, Sun's Java Kit </li>
+ <li>ibm-jre-bin and ibm-jdk-bin, the IBM Java Kit</li>
+ <li>compaq-jre and compaq-jdk, the Compaq Java Kit for Alpha/Linux/GNU</li>
+ <li>jrockit-jdk-bin, BEA WebLogic's J2SE Development Kit</li>
</ul>
<p>
@@ -90,7 +90,6 @@
</body>
</section>
-
<section>
<title>Installing the Sun/IBM JRE/JDKs</title>
<body>
@@ -171,8 +170,9 @@
</note>
<p>
-Once you have issued <c>java-config --set-system-vm</c> with a particular VM ID,
-you will need to regenerate your /etc/profile.env. You can do it like this:
+Once you have issued <c>java-config --set-system-vm</c> with a particular VM
+ID, you will need to regenerate your <path>/etc/profile.env</path>. You can do
+it like this:
</p>
<pre caption="Regenerating /etc/profile.env" >
@@ -187,8 +187,8 @@
<p>
As a regular user, you can use <c>java-config --set-user-vm</c>, which will
create <path>~/.gentoo/java-env</path> with all required env vars. You would
-normally source this from your shell's startup script
-(generally <path>~/.bashrc</path>).
+normally source this from your shell's startup script (generally
+<path>~/.bashrc</path>).
</p>
</body>
@@ -202,8 +202,8 @@
<body>
<p>
-For more information regarding USE flags, refer to the
-<uri link="/doc/en/handbook/handbook-x86.xml?part=2&chap=2">USE flags</uri>
+For more information regarding USE flags, refer to the <uri
+link="/doc/en/handbook/handbook-x86.xml?part=2&chap=2">USE flags</uri>
chapter from the Gentoo Handbook.
</p>
@@ -214,10 +214,12 @@
<body>
<ul>
-<li>The <b>java</b> flag adds support for Java in a variety of programs.</li>
-<li>The <b>browserplugin</b> flag adds support for Mozilla-like browsers (including Firefox)
-if you are using blackdown's Java kit. You will need this for viewing Java applets
-in your Mozilla-like browser.</li>
+ <li>The <b>java</b> flag adds support for Java in a variety of programs.</li>
+ <li>
+ The <b>browserplugin</b> flag adds support for Mozilla-like browsers
+ (including Firefox) if you are using blackdown's Java kit. You will need
+ this for viewing Java applets in your Mozilla-like browser.
+ </li>
</ul>
</body>
@@ -231,23 +233,32 @@
<body>
<ul>
-<li>java-config man page</li>
-<li><c>java-config --help</c></li>
-<li>The <path>/usr/bin/java-config</path> script itself</li>
+ <li>java-config man page</li>
+ <li><c>java-config --help</c></li>
+ <li>The <path>/usr/bin/java-config</path> script itself</li>
</ul>
</body>
</section>
-
<section>
<title>Online resources</title>
<body>
+
<ul>
-<li>The <uri link="http://news.gmane.org/gmane.linux.gentoo.devel"
->gentoo-dev</uri>, <uri link="http://news.gmane.org/gmane.linux.gentoo.user"
->gentoo-user </uri> and <uri link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri> mailing list archives</li>
-<li>#gentoo and #gentoo-java on irc.freenode.net</li>
-<li><uri link="http://en.wikipedia.org/wiki/Java_programming_language">Wikipedia's entry for Java</uri></li>
+ <li>
+ The <uri
+ link="http://news.gmane.org/gmane.linux.gentoo.devel">gentoo-dev</uri>,
+ <uri link="http://news.gmane.org/gmane.linux.gentoo.user">gentoo-user
+ </uri> and <uri
+ link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri>
+ mailing list archives</li> <li>#gentoo and #gentoo-java on
+ irc.freenode.net
+ </li>
+ <li>
+ <uri
+ link="http://en.wikipedia.org/wiki/Java_programming_language">Wikipedia's
+ entry for Java</uri>
+ </li>
</ul>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2005-09-30 6:08 Alin Dobre
0 siblings, 0 replies; 26+ messages in thread
From: Alin Dobre @ 2005-09-30 6:08 UTC (permalink / raw
To: gentoo-doc-cvs
alin 05/09/30 06:08:03
Modified: xml/htdocs/doc/en java.xml
Log:
fixed coding style. no content change
Revision Changes Path
1.18 +3 -3 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.18&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.18&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.17&r2=1.18&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- java.xml 29 Sep 2005 18:27:31 -0000 1.17
+++ java.xml 30 Sep 2005 06:08:03 -0000 1.18
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.17 2005/09/29 18:27:31 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.18 2005/09/30 06:08:03 alin Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -251,9 +251,9 @@
<uri link="http://news.gmane.org/gmane.linux.gentoo.user">gentoo-user
</uri> and <uri
link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri>
- mailing list archives</li> <li>#gentoo and #gentoo-java on
- irc.freenode.net
+ mailing list archives
</li>
+ <li>#gentoo and #gentoo-java on irc.freenode.net</li>
<li>
<uri
link="http://en.wikipedia.org/wiki/Java_programming_language">Wikipedia's
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2005-11-12 23:19 Stefano Rossi
0 siblings, 0 replies; 26+ messages in thread
From: Stefano Rossi @ 2005-11-12 23:19 UTC (permalink / raw
To: gentoo-doc-cvs
so 05/11/12 23:19:00
Modified: xml/htdocs/doc/en java.xml
Log:
#110476 update for nsplugin
Revision Changes Path
1.19 +7 -6 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.19&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.19&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.18&r2=1.19&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- java.xml 30 Sep 2005 06:08:03 -0000 1.18
+++ java.xml 12 Nov 2005 23:18:59 -0000 1.19
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.18 2005/09/30 06:08:03 alin Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.19 2005/11/12 23:18:59 so Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -22,8 +22,8 @@
<license/>
-<version>0.1.7</version>
-<date>2005-09-29</date>
+<version>0.1.8</version>
+<date>2005-11-13</date>
<chapter>
<title>What is Java?</title>
@@ -216,9 +216,10 @@
<ul>
<li>The <b>java</b> flag adds support for Java in a variety of programs.</li>
<li>
- The <b>browserplugin</b> flag adds support for Mozilla-like browsers
- (including Firefox) if you are using blackdown's Java kit. You will need
- this for viewing Java applets in your Mozilla-like browser.
+ The <b>nsplugin</b> flag adds a symlink to the javaplugin for
+ Mozilla-like browsers (including Firefox) if you are using, for example,
+ Blackdown's Java kit, IBM Java Kit or Sun's Java Kit. You will need this
+ for viewing Java applets in your Mozilla-like browser.
</li>
</ul>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2005-11-13 12:17 Alin Dobre
0 siblings, 0 replies; 26+ messages in thread
From: Alin Dobre @ 2005-11-13 12:17 UTC (permalink / raw
To: gentoo-doc-cvs
alin 05/11/13 12:17:36
Modified: xml/htdocs/doc/en java.xml
Log:
replaced tabs with spaces; no content change
Revision Changes Path
1.20 +5 -5 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.20&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.20&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.19&r2=1.20&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- java.xml 12 Nov 2005 23:18:59 -0000 1.19
+++ java.xml 13 Nov 2005 12:17:36 -0000 1.20
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.19 2005/11/12 23:18:59 so Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.20 2005/11/13 12:17:36 alin Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -216,10 +216,10 @@
<ul>
<li>The <b>java</b> flag adds support for Java in a variety of programs.</li>
<li>
- The <b>nsplugin</b> flag adds a symlink to the javaplugin for
- Mozilla-like browsers (including Firefox) if you are using, for example,
- Blackdown's Java kit, IBM Java Kit or Sun's Java Kit. You will need this
- for viewing Java applets in your Mozilla-like browser.
+ The <b>nsplugin</b> flag adds a symlink to the javaplugin for
+ Mozilla-like browsers (including Firefox) if you are using, for example,
+ Blackdown's Java kit, IBM Java Kit or Sun's Java Kit. You will need this
+ for viewing Java applets in your Mozilla-like browser.
</li>
</ul>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2005-12-12 12:00 Xavier Neys
0 siblings, 0 replies; 26+ messages in thread
From: Xavier Neys @ 2005-12-12 12:00 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 05/12/12 12:00:43
Modified: xml/htdocs/doc/en java.xml
Log:
#115240 Add link to /proj/en/java/
Revision Changes Path
1.21 +4 -3 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.21&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.21&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.20&r2=1.21&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- java.xml 13 Nov 2005 12:17:36 -0000 1.20
+++ java.xml 12 Dec 2005 12:00:43 -0000 1.21
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.20 2005/11/13 12:17:36 alin Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.21 2005/12/12 12:00:43 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -22,8 +22,8 @@
<license/>
-<version>0.1.8</version>
-<date>2005-11-13</date>
+<version>0.2</version>
+<date>2005-12-12</date>
<chapter>
<title>What is Java?</title>
@@ -246,6 +246,7 @@
<body>
<ul>
+ <li>The <uri link="/proj/en/java/">Gentoo Java Project Page</uri></li>
<li>
The <uri
link="http://news.gmane.org/gmane.linux.gentoo.devel">gentoo-dev</uri>,
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-03-06 17:46 Xavier Neys
0 siblings, 0 replies; 26+ messages in thread
From: Xavier Neys @ 2006-03-06 17:46 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 06/03/06 17:46:45
Modified: java.xml
Log:
#125259 Fixed typo in code sample
Revision Changes Path
1.22 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.22&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.22&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.21&r2=1.22&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- java.xml 12 Dec 2005 12:00:43 -0000 1.21
+++ java.xml 6 Mar 2006 17:46:45 -0000 1.22
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.21 2005/12/12 12:00:43 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.22 2006/03/06 17:46:45 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -22,7 +22,7 @@
<license/>
-<version>0.2</version>
+<version>0.3</version>
<date>2005-12-12</date>
<chapter>
@@ -161,7 +161,7 @@
</p>
<pre caption="Setting the System VM">
-# <i>java-config --set-system-vm=ibm-jdk-1.3.1</i>
+# <i>java-config --set-system-vm ibm-jdk-1.3.1</i>
Now using IBM JDK 1.3.1 (/etc/env.d/java/20ibm-jdk-1.3.1)
</pre>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-06-24 18:28 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2006-06-24 18:28 UTC (permalink / raw
To: gentoo-doc-cvs
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 20966 bytes --]
nightmorph 06/06/24 18:28:06
Modified: java.xml
Log:
Overhauled, updated java guide for bug 137760. thanks to nichoj for putting in all the time and energy on the update.
Revision Changes Path
1.23 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.23&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.23&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.22&r2=1.23&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- java.xml 6 Mar 2006 17:46:45 -0000 1.22
+++ java.xml 24 Jun 2006 18:28:06 -0000 1.23
@@ -1,29 +1,31 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.22 2006/03/06 17:46:45 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.23 2006/06/24 18:28:06 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
<title>Gentoo Java Guide</title>
-<author title="Author and Editor">
+<author title="Author">
<mail link="karltk@gentoo.org">Karl Trygve Kalleberg</mail>
</author>
-<author title="Editor">
- <mail link="swift@gentoo.org">Sven Vermeulen</mail>
+<author title="Author">
+ <mail link="nichoj@gentoo.org">Joshua Nichols</mail>
</author>
<author title="Editor">
- <mail link="vanquirius@gentoo.org">Marcelo Góes</mail>
+ <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
</author>
<abstract>
-This guide will introduce users and developers to Java and explain how to use
-Java with Gentoo Linux.
+This guide will introduce you to Java and explain how to use Java with Gentoo
+Linux.
</abstract>
+<!-- The content of this document is licensed under the CC-BY-SA license -->
+<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.3</version>
-<date>2005-12-12</date>
+<version>0.4</version>
+<date>2006-06-24</date>
<chapter>
<title>What is Java?</title>
@@ -32,21 +34,22 @@
<body>
<p>
-Java is a programming language developed by engineers of Sun Microsystems.
-The language is object-oriented and designed to run on multiple platforms
-without the need of recompiling code for each platform. Although Java can
-be compiled as a native program, much of Java's popularity can be attributed
-to its portability, along with other features such as garbage collection.
-The ability to compile once and run in various platforms is achieved through
-the use of just-in-time compilers (JIT), which compile Java bytecodes into
-native code when a given program is run.
+Java is a programming language developed by engineers of Sun Microsystems. The
+language is object-oriented and designed to run on multiple platforms without
+the need of recompiling code for each platform. Although Java can be compiled
+as a native program, much of Java's popularity can be attributed to its
+portability, along with other features such as garbage collection. To make
+platform independence possible the Java compiler compiles the Java code to an
+intermediate representation called "Java bytecode" that runs on a JRE (Java
+Runtime Environment) and not directly on the operating system.
</p>
<p>
-In order to run Java bytecodes, one needs to have a JRE (Java Runtime Environment)
-installed. A JRE provides core libraries, a platform dependent Java Virtual Machine,
-plug-ins for browsers, among other things. A JDK (Java Development Kit) adds
-programming tools, such as a bytecode compiler and a debugger.
+In order to run Java bytecode, one needs to have a JRE (Java Runtime
+Environment) installed. A JRE provides core libraries, a platform dependent
+Java Virtual Machine, plug-ins for browsers, among other things. A JDK (Java
+Development Kit) adds programming tools, such as a bytecode compiler and a
+debugger.
</p>
</body>
@@ -60,55 +63,98 @@
<body>
<p>
-Gentoo provides numerous JREs and JDKs. Among the current alternatives, we have:
+Gentoo provides numerous JREs and JDKs. Among the current alternatives, we
+have:
</p>
-<ul>
- <li>blackdown-jre and blackdown-jdk, the Blackdown Java Kit</li>
- <li>sun-jre-bin and sun-jdk, Sun's Java Kit </li>
- <li>ibm-jre-bin and ibm-jdk-bin, the IBM Java Kit</li>
- <li>compaq-jre and compaq-jdk, the Compaq Java Kit for Alpha/Linux/GNU</li>
- <li>jrockit-jdk-bin, BEA WebLogic's J2SE Development Kit</li>
-</ul>
-
-<p>
-The default is the Blackdown JRE/JDK
-pair, as it is freely ("free as in beer") available without any registration
-fuss.
+<table>
+<tr>
+ <th>Vendor</th>
+ <th>JDK</th>
+ <th>JRE</th>
+</tr>
+<tr>
+ <ti>The Blackdown Java Kit</ti>
+ <ti>dev-java/backdown-jdk</ti>
+ <ti>dev-java/blackdown-jre</ti>
+</tr>
+<tr>
+ <ti>Sun's Java Kit</ti>
+ <ti>dev-java/sun-jdk</ti>
+ <ti>dev-java/sun-jre-bin</ti>
+</tr>
+<tr>
+ <ti>The IBM Java Kit</ti>
+ <ti>dev-java/ibm-jdk-bin</ti>
+ <ti>dev-java/ibm-jre-bin</ti>
+</tr>
+<tr>
+ <ti>The Compaq Java Kit for Alpha/Linux/GNU</ti>
+ <ti>dev-java/compaq-jdk</ti>
+ <ti>dev-java/compaq-jre</ti>
+</tr>
+<tr>
+ <ti>BEA WebLogic's J2SE Development Kit</ti>
+ <ti>dev-java/jrockit-jdk-bin</ti>
+</tr>
+</table>
+
+<!--
+TODO: list free implmentations?
+note about not drop-in replacemenets
+kaffe/sablevm/gcj/jamvm
+-->
+
+<p>
+The default is Blackdown for both the JRE and the JDK, as it is freely ("free
+as in beer") available without any registration fuss.
</p>
<p>
-Both the Sun JRE/JDK and the IBM JRE/JDK are generally faster, but getting them
-is a bit more work, as you are required to read and accept their license before
-downloading (IBM additionally requires you to register).
+Both the Sun and the IBM are generally faster, but getting them is a bit more
+hassle, as you are required to read and accept their license before downloading
+(IBM additionally requires you to register).
</p>
<p>
-Our ebuilds for the Sun and IBM JRE/JDKs will notify you of where to go to
-download them.
+Our ebuilds for the Sun and IBM JRE/JDKs will inform you how to download the
+appropriate files.
</p>
</body>
</section>
<section>
-<title>Installing the Sun/IBM JRE/JDKs</title>
+<title>Installing a JRE/JDKs</title>
<body>
<p>
-If you run <c>emerge =sun-jdk-1.4.2.06</c> or <c>=ibm-jdk-bin-1.4.2</c>, you will
-be notified that you are required to download the actual tarballs yourself. This
-has to do with license restrictions for the Sun JRE/JDK (online click-wrap
-license) and registration issues with the IBM JRE/JDK.
+To install your profile's default JDK, you can run <c>emerge virtual/jdk</c>.
+Or to install your profile's default JRE, you can <c>emerge virtual/jre</c>.
</p>
<note>
-ibm-jdk-bin is currently masked, you may have to unmask it to use it.
+A JDK also includes a JRE, so if you install a JDK you shouldn't have to also
+have to install a JRE.
</note>
+</body>
+</section>
+<section>
+<title>Installing the Sun/IBM JRE/JDKs</title>
+<body>
+
+<p>
+If you run <c>emerge dev-java/sun-jdk</c> or <c>emerge
+dev-java/ibm-jdk-bin</c>, you will be notified that you are required to
+download the actual files yourself. This has to do with license restrictions
+for the Sun JRE/JDK (online click-wrap license) and registration issues with
+the IBM JRE/JDK.
+</p>
+
<p>
You should download the indicated file(s) into
-<path>/usr/portage/distfiles</path>. Once that is done, you can rerun the emerge
-command, then the JRE/JDK will be installed properly into <path>/opt</path>.
+<path>/usr/portage/distfiles</path>. Once there, you can rerun the emerge
+command, at which point the JRE/JDK will be begin to install.
</p>
</body>
@@ -122,75 +168,280 @@
<body>
<p>
-Gentoo has the ability to have multiple JDKs and JREs installed without them
-conflicting.
+Gentoo has the ability to have multiple JDKs and JREs installed without causing
+conflicts.
</p>
<p>
-Using the <c>java-config</c> tool, you can set the system-wide default if you
-have root access. Users can also use <c>java-config</c> to set up their own
-personal default, that is different from the system-wide default.
+Using the <c>java-config</c> tool, you can set the system-wide default
+(provided you have root access). Users can also use <c>java-config</c> to set
+up their own personal default.
</p>
+<note>
+You can also use <e>eselect</e> to change the system and user vm. See
+<c>eselect java help</c>.
+</note>
+
</body>
</section>
-
<section>
<title>Setting a default JRE/JDK</title>
<body>
<p>
-Running the command <c>java-config --list-available-vms</c> will give you a list
-of all available JREs and JDKs on your system. Here is an example of output:
+Running the command <c>java-config --list-available-vms</c> will give you a
+list of all JREs and JDKs installed on your system. Here is an example of
+output:
</p>
<pre caption="Listing available VMs">
# <i>java-config --list-available-vms</i>
-[blackdown-jdk-1.3.1] Blackdown JDK 1.3.1 (/etc/env.d/java/20blackdown-jdk-1.3.1)
-[blackdown-jre-1.3.1] Blackdown JRE 1.3.1 (/etc/env.d/java/20blackdown-jre-1.3.1)
-[ibm-jdk-1.3.0] IBM JDK 1.3.0 (/etc/env.d/java/20ibm-jdk-1.3.0)
-[ibm-jdk-1.3.1] IBM JDK 1.3.1 (/etc/env.d/java/20ibm-jdk-1.3.1)
-[ibm-jre-1.3.1] IBM JRE 1.3.1 (/etc/env.d/java/20ibm-jre-1.3.1)
-[sun-jdk-1.4.0] Sun JDK 1.4.0 (/etc/env.d/java/20sun-jdk-1.4.0)
+1) Blackdown JDK 1.3.1 [blackdown-jdk-1.3] (/etc/env.d/java/20blackdown-jdk-1.3)
+2) Blackdown JDK 1.4.2.02 [blackdown-jdk-1.4] (/etc/env.d/java/20blackdown-jdk-1.4)
+3) Blackdown JRE 1.4.2.02 [blackdown-jre-1.4] (/etc/env.d/java/20blackdown-jre-1.4)
+4) IBM JDK 1.4.2 [ibm-jdk-bin-1.4] (/etc/env.d/java/20ibm-jdk-bin-1.4)
+5) IBM JRE 1.4.2 [ibm-jre-bin-1.4] (/etc/env.d/java/20ibm-jre-bin-1.4)
+6) WebLogic JRockit 1.4.2.05 [jrockit-jdk-bin-1.4] (/etc/env.d/java/20jrockit-jdk-bin-1.4)
+7) WebLogic JRockit 1.5.0.03 [jrockit-jdk-bin-1.5] (/etc/env.d/java/20jrockit-jdk-bin-1.5)
+8) Sun JDK 1.3.1.13 [sun-jdk-1.3] (/etc/env.d/java/20sun-jdk-1.3)
+9) Sun JDK 1.4.2.09 [sun-jdk-1.4] (/etc/env.d/java/20sun-jdk-1.4)
+*) Sun JDK 1.5.0.04 [sun-jdk-1.5] (/etc/env.d/java/20sun-jdk-1.5)
+11) Sun JRE 1.4.2.09 [sun-jre-bin-1.4] (/etc/env.d/java/20sun-jre-bin-1.4)
+12) Sun JRE 1.5.0.04 [sun-jre-bin-1.5] (/etc/env.d/java/20sun-jre-bin-1.5)
</pre>
<p>
-The name in the brackets <path>"[]"</path> is the handle or ID for that
-particular VM. You use pass that ID to <c>java-config --set-system-vm</c>. Here is
-an example of how to set the system VM.
+The <e>*</e> indicates this is the current active vm (system-vm or user-vm when
+set). The name in the brackets (<e>[]</e>) is the handle or ID for that
+particular VM. You use the handle or the number to <c>java-config
+--set-system-vm</c>. Here is an example of how to set the system VM.
</p>
<pre caption="Setting the System VM">
-# <i>java-config --set-system-vm ibm-jdk-1.3.1</i>
-Now using IBM JDK 1.3.1 (/etc/env.d/java/20ibm-jdk-1.3.1)
+<comment>(By handle (preferred))</comment>
+# <i>java-config --set-system-vm blackdown-jdk-1.4</i>
+<comment>(By number)</comment>
+# <i>java-config --set-system-vm 2</i>
</pre>
+<p>
+As a regular user, you can use <c>java-config --set-user-vm</c>.
+</p>
+
<note>
-You will have to be root to run --set-system-vm.
+You no longer have to <c>source</c> the profile for updates to the user/system
+VM take place.
</note>
+</body>
+</section>
+<section id="preferred-vm">
+<title>Preferred VM</title>
+<body>
+
+<p>
+While merging Java packages, the VM can and will be switched as necessary.
+</p>
+
+<p>
+Because of the wide variety of available VMs, we do not have the resources to
+test and verify every package works on all of them. So to ensure that every
+packages merges smoothly, we have defined a list of <e>default/supported
+VMs</e> per arch. You can find them in
+<path>/usr/share/java-config/config/jdk-defaults.conf</path>. When you are
+merging a Java package, and it detects one of the VM in that file is installed,
+it will automatically use that VM, instead of the system-vm.
+</p>
+
<p>
-Once you have issued <c>java-config --set-system-vm</c> with a particular VM
-ID, you will need to regenerate your <path>/etc/profile.env</path>. You can do
-it like this:
+The merge time VM switching is also needed when, for example, your system-vm is
+set a 1.4 VM and the package you are merging requires a 1.5 VM. While merging
+it will use the preferred 1.5 VM, leaving your system-vm choice intact.
</p>
-<pre caption="Regenerating /etc/profile.env" >
-# <i>env-update</i>
+<p>
+Of course, Gentoo is all about choice, so you can override these defaults in
+<path>/etc/java-config-2/build/jdk.conf</path> and have complete control over
+which VM will get used. Some examples:
+</p>
+
+<pre caption="Example /etc/java-config-2/build/jdk.conf">
+<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>
+*=sun-jdk
</pre>
+<pre caption="Example /etc/java-config-2/build/jdk.conf">
+<comment>(Always use sun-jdk-1.5 wherever possible, except for when a 1.4 or 1.3 VM is explicitly required)</comment>
+*=sun-jdk-1.5
+</pre>
+
+<pre caption="Example /etc/java-config-2/build/jdk.conf">
+<comment># For 1.3 I prefer sun-jdk 1.4 but when it is not available, use ibm-jdk-bin,
+# For 1.4, use blackdown-jdk, and for 1.5, use sun-jdk </comment>
+1.3=sun-jdk-1.4 ibm-jdk-bin
+1.4=blackdown-jdk
+1.5=sun-jdk
+</pre>
+
+<warn>
+You do not have to edit this file. If you change these options to use a
+unsupported VM, things could possibly break. Bugs reported with a unsupported
+VM will a lower priority if they aren't present with supported VMs.
+</warn>
+
+</body>
+</section>
+</chapter>
+
+<chapter>
+<title>Compilers</title>
+<section>
+<body>
+
<p>
-After this, you will either want to relogin, or resource
-<path>/etc/profile</path> into your environment.
+The standard Java compiler used for building is javac, which comes with each
+JDK. In addition to configuring the VM used at build time, it is also possible
+configure which compiler is used. Essentially, you define a list your
+preference for which compiler to use in
+<path>/etc/java-config-2/build/compilers.conf</path>.
</p>
+<pre caption="/etc/java-config-2/build/compilers.conf">
+# If the ebuild supports it
+# it will check the COMPILERS var front to back and
+# use the first compiler that is installed
+
+COMPILERS="ecj-3.1 jikes javac"
+</pre>
+
<p>
-As a regular user, you can use <c>java-config --set-user-vm</c>, which will
-create <path>~/.gentoo/java-env</path> with all required env vars. You would
-normally source this from your shell's startup script (generally
-<path>~/.bashrc</path>).
+Some compilers don't support all possible -target and -source arguments.
+Therefore, each compiler in the list is checked to see if it can support the
+desired -source/-target. javac will work in all cases, so if no other suitable
+compiler is found, it will be used instead.
</p>
+<p>
+More details about each compiler are provided below:
+</p>
+
+<table>
+<tr>
+ <th>Name</th>
+ <th>Handle</th>
+ <th>Package</th>
+ <th>Description</th>
+</tr>
+<tr>
+ <ti>javac</ti>
+ <ti>javac</ti>
+ <ti>N/A</ti>
+ <ti>
+ This is the default compiler that will be used, and comes with each JDK.
+ </ti>
+</tr>
+<tr>
+ <ti>jikes</ti>
+ <ti>jikes</ti>
+ <ti>dev-java/jikes</ti>
+ <ti>
+ Jikes was originally developed by IBM. Anecdotally, it is generally quicker
+ than javac. Note however, that it is more pedantic, and will fail under a
+ few circumstances where javac has no issue. It also does not support Java
+ 1.5 syntax yet.
+ </ti>
+</tr>
+<tr>
+ <ti>Eclipse Compiler for Java</ti>
+ <ti>ecj-3.1</ti>
+ <ti>=dev-java/eclipse-ecj-3.1*</ti>
+ <ti>
+ ECJ is the compiler used by the Eclipse software development kit. It is
+ very full featured, and is pretty fast. It does support Java 1.5 syntax.
+ </ti>
+</tr>
+</table>
+
+</body>
+</section>
+</chapter>
+
+<chapter>
+<title>Setting a default CLASSPATH</title>
+<section>
+<body>
+
+<warn>
+The options explained in this section should be considered deprecated and will
+be most likely be removed in the future. We strongly recommend against using
+these, because your Java projects or application should ideally manage their
+own classpaths. If you choose to specify a default CLASSPATH, some applications
+may behave unexpectedly, because classes they weren't expecting would be on the
+classpath.
+</warn>
+
+<p>
+<c>java-config</c> can also be used to set a system-wide default CLASSPATH, as
+well a user-specific default CLASSPATH.
+</p>
+
+<p>
+First, you will want to list available Java libraries installed on your system
+that might want to be put in your CLASSPATH. Here is an example of output:
+</p>
+
+<pre caption="Listing classes">
+# <i>java-config --list-available-packages</i>
+[xerces-2] The next generation of high performance, fully compliant XML parsers in the Apache Xerces family (/usr/share/xerces-2/package.env)
+[junit] Simple framework to write repeatable tests (/usr/share/junit/package.env)
+[bsh] BeanShell: A small embeddable Java source interpreter (/usr/share/bsh/package.env)
+[bcel] The Byte Code Engineering Library: analyze, create, manipulate Java class files (/usr/share/bcel/package.env)
+[log4j] A low-overhead robust logging package for Java (/usr/share/log4j/package.env)
+...
+</pre>
+
+<p>
+Again, the names in brackets (<e>[]</e>) are the IDs that you have to pass to
+<c>java-config --set-system-classpath</c>. Here is an example:
+</p>
+
+<pre caption="Setting classpaths">
+# <i>java-config --set-system-classpath log4j,xerces-2</i>
+</pre>
+
+<note>
+The current directory (<path>.</path>) will not be part of the system
+classpath, as that should be added in your system's login profile.
+</note>
+
+<p>
+You will have to update your environment by relogging in or sourcing
+<path>/etc/profile</path>.
+</p>
+
+<p>
+For users, <c>java-config --set-user-classpath</c> will create
+<path>~/.gentoo/java-env-classpath</path>, which you should then source from
+your shell's profile.
+</p>
+
+<pre caption="Sourcing user specific classpath">
+<i>if [[ -f "${HOME}/.gentoo/java-env-classpath" ]]; then
+ source ${HOME}/.gentoo/java-env-classpath
+fi</i>
+</pre>
+
+<p>
+If you really want a system wide or user default classpath you can add
+something like like the following to your shell's profile. But we would advise
+against it.
+</p>
+
+<pre caption="Setting classpath">
+# <i>export CLASSPATH="${CLASSPATH}:$(java-config --classpath log4j,xerces-2)"</i>
+</pre>
+
</body>
</section>
</chapter>
@@ -214,12 +465,20 @@
<body>
<ul>
- <li>The <b>java</b> flag adds support for Java in a variety of programs.</li>
+ <li>The <b>java</b> flag adds support for Java in a variety of programs</li>
+ <li>
+ The <b>nsplugin</b> flag adds support for Mozilla-like browsers (including
+ Firefox).You will need this for viewing Java applets in your Mozilla-like
+ browser.
+ </li>
<li>
- The <b>nsplugin</b> flag adds a symlink to the javaplugin for
- Mozilla-like browsers (including Firefox) if you are using, for example,
- Blackdown's Java kit, IBM Java Kit or Sun's Java Kit. You will need this
- for viewing Java applets in your Mozilla-like browser.
+ The <b>doc</b> flag will typically install API documentation, as generated
+ by javadoc.
+ </li>
+ <li>
+ The <b>source</b> flag will install a zip of the package's source code.
+ This is typically used to provide your IDE with the source code for the
+ package.
</li>
</ul>
@@ -236,7 +495,6 @@
<ul>
<li>java-config man page</li>
<li><c>java-config --help</c></li>
- <li>The <path>/usr/bin/java-config</path> script itself</li>
</ul>
</body>
@@ -246,13 +504,17 @@
<body>
<ul>
- <li>The <uri link="/proj/en/java/">Gentoo Java Project Page</uri></li>
+ <li>
+ The <uri link="http://www.gentoo.org/proj/en/java/">Java Project
+ Page</uri>
+ </li>
<li>
The <uri
- link="http://news.gmane.org/gmane.linux.gentoo.devel">gentoo-dev</uri>,
- <uri link="http://news.gmane.org/gmane.linux.gentoo.user">gentoo-user
- </uri> and <uri
- link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri>
+ link="http://news.gmane.org/gmane.linux.gentoo.java">gentoo-java</uri>,
+ <uri
+ link="http://news.gmane.org/gmane.linux.gentoo.user">gentoo-user</uri>, and
+ <uri
+ link="http://news.gmane.org/gmane.linux.gentoo.devel">gentoo-dev</uri>
mailing list archives
</li>
<li>#gentoo and #gentoo-java on irc.freenode.net</li>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-06-24 19:06 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2006-06-24 19:06 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/06/24 19:06:34
Modified: java.xml
Log:
typo fix (should have been java-vm not java)
Revision Changes Path
1.24 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.24&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.24&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.23&r2=1.24&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- java.xml 24 Jun 2006 18:28:06 -0000 1.23
+++ java.xml 24 Jun 2006 19:06:34 -0000 1.24
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.23 2006/06/24 18:28:06 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.24 2006/06/24 19:06:34 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -180,7 +180,7 @@
<note>
You can also use <e>eselect</e> to change the system and user vm. See
-<c>eselect java help</c>.
+<c>eselect java-vm help</c>.
</note>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-07-13 6:29 Lukasz Damentko
0 siblings, 0 replies; 26+ messages in thread
From: Lukasz Damentko @ 2006-07-13 6:29 UTC (permalink / raw
To: gentoo-doc-cvs
rane 06/07/13 06:29:21
Modified: java.xml
Log:
removing a doubled word, no content change
Revision Changes Path
1.25 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.25&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.25&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.24&r2=1.25&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- java.xml 24 Jun 2006 19:06:34 -0000 1.24
+++ java.xml 13 Jul 2006 06:29:21 -0000 1.25
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.24 2006/06/24 19:06:34 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.25 2006/07/13 06:29:21 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -434,7 +434,7 @@
<p>
If you really want a system wide or user default classpath you can add
-something like like the following to your shell's profile. But we would advise
+something like the following to your shell's profile. But we would advise
against it.
</p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-07-20 23:55 Lukasz Damentko
0 siblings, 0 replies; 26+ messages in thread
From: Lukasz Damentko @ 2006-07-20 23:55 UTC (permalink / raw
To: gentoo-doc-cvs
rane 06/07/20 23:55:32
Modified: java.xml
Log:
#92351, fixed some typos, no content change
Revision Changes Path
1.26 xml/htdocs/doc/en/java.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.26&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml?rev=1.26&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/java.xml.diff?r1=1.25&r2=1.26&cvsroot=gentoo
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- java.xml 13 Jul 2006 06:29:21 -0000 1.25
+++ java.xml 20 Jul 2006 23:55:32 -0000 1.26
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.25 2006/07/13 06:29:21 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.26 2006/07/20 23:55:32 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -100,8 +100,8 @@
</table>
<!--
-TODO: list free implmentations?
-note about not drop-in replacemenets
+TODO: list free implementations?
+note about not drop-in replacements
kaffe/sablevm/gcj/jamvm
-->
@@ -287,7 +287,7 @@
<warn>
You do not have to edit this file. If you change these options to use a
unsupported VM, things could possibly break. Bugs reported with a unsupported
-VM will a lower priority if they aren't present with supported VMs.
+VM won't be prioritized as much as bugs present within supported VMs.
</warn>
</body>
@@ -374,7 +374,7 @@
<warn>
The options explained in this section should be considered deprecated and will
-be most likely be removed in the future. We strongly recommend against using
+most likely be removed in the future. We strongly recommend against using
these, because your Java projects or application should ideally manage their
own classpaths. If you choose to specify a default CLASSPATH, some applications
may behave unexpectedly, because classes they weren't expecting would be on the
@@ -416,8 +416,8 @@
</note>
<p>
-You will have to update your environment by relogging in or sourcing
-<path>/etc/profile</path>.
+You will have to update your environment by logging out, then in again or
+sourcing <path>/etc/profile</path>.
</p>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-07-25 8:13 Lukasz Damentko
0 siblings, 0 replies; 26+ messages in thread
From: Lukasz Damentko @ 2006-07-25 8:13 UTC (permalink / raw
To: gentoo-doc-cvs
rane 06/07/25 08:13:47
Modified: java.xml
Log:
#141655, a typo, backdown-jdk -> blackdown-jdk, fix your translations
Revision Changes Path
1.27 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.27&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.27&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.26&r2=1.27
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- java.xml 20 Jul 2006 23:55:32 -0000 1.26
+++ java.xml 25 Jul 2006 08:13:47 -0000 1.27
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.26 2006/07/20 23:55:32 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.27 2006/07/25 08:13:47 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.4</version>
-<date>2006-06-24</date>
+<version>0.5</version>
+<date>2006-07-24</date>
<chapter>
<title>What is Java?</title>
@@ -75,7 +75,7 @@
</tr>
<tr>
<ti>The Blackdown Java Kit</ti>
- <ti>dev-java/backdown-jdk</ti>
+ <ti>dev-java/blackdown-jdk</ti>
<ti>dev-java/blackdown-jre</ti>
</tr>
<tr>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-08-08 9:51 Lukasz Damentko
0 siblings, 0 replies; 26+ messages in thread
From: Lukasz Damentko @ 2006-08-08 9:51 UTC (permalink / raw
To: gentoo-doc-cvs
rane 06/08/08 09:51:12
Modified: java.xml
Log:
#143152, updated by java team
Revision Changes Path
1.28 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.28&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.28&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.27&r2=1.28
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- java.xml 25 Jul 2006 08:13:47 -0000 1.27
+++ java.xml 8 Aug 2006 09:51:12 -0000 1.28
@@ -1,15 +1,15 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.27 2006/07/25 08:13:47 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.28 2006/08/08 09:51:12 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
<title>Gentoo Java Guide</title>
<author title="Author">
- <mail link="karltk@gentoo.org">Karl Trygve Kalleberg</mail>
+ <mail link="nichoj@gentoo.org">Joshua Nichols</mail>
</author>
<author title="Author">
- <mail link="nichoj@gentoo.org">Joshua Nichols</mail>
+ <mail link="karltk@gentoo.org">Karl Trygve Kalleberg</mail>
</author>
<author title="Editor">
<mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.5</version>
-<date>2006-07-24</date>
+<version>0.6</version>
+<date>2006-08-07</date>
<chapter>
<title>What is Java?</title>
@@ -57,14 +57,113 @@
</chapter>
<chapter>
-<title>Installing a JRE/JDK</title>
+<title>New Java System</title>
+<section>
+<body>
+
+<p>
+The way Java is handled on Gentoo has recently seen many changes and
+improvements. This has only happened very recently, and as a result, all the
+packages related to it are marked with testing keywords, ie ~x86. This
+document assumes you are using the new system.
+</p>
+
+</body>
+</section>
+<section>
+<title>Keywords</title>
+<body>
+
+<p>
+If you are using the stable tree, i.e. x86, ppc, or amd64 as opposed to ~x86,
+~ppc, or ~amd64, you will need to add some entries to your
+<path>/etc/portage/package.keywords</path>:
+</p>
+
+<pre caption="package.keywords">
+# Core Gentoo/Java Packages
+dev-java/ant-core
+dev-java/ant-tasks
+dev-java/ant
+dev-java/java-config
+dev-java/java-config-wrapper
+dev-java/javatoolkit
+# JDKs
+=dev-java/sun-jdk-1.4*
+=dev-java/sun-jdk-1.5*
+=dev-java/ibm-jdk-bin-1.4*
+=dev-java/ibm-jdk-bin-1.5*
+=dev-java/jrockit-jdk-bin-1.4*
+=dev-java/jrockit-jdk-bin-1.5*
+=dev-java/blackdown-jdk-1.4*
+dev-java/kaffe
+# JREs
+=dev-java/sun-jre-bin-1.4*
+=dev-java/sun-jre-bin-1.5*
+=dev-java/ibm-jre-bin-1.4*
+=dev-java/blackdown-jre-1.4*
+# Virtuals
+virtual/jdk
+virtual/jre
+# Compilers
+dev-java/eclipse-ecj
+dev-java/jikes
+# Documentation
+dev-java/java-sdk-docs
+# Misc packages that have been updated to generation-2,
+# where the generation-1 won't build and/or run properly
+dev-java/lucene
+# These have optional Java support, but need ~arch to function properly
+# with generation-2
+dev-util/subversion
+sys-libs/db
+</pre>
+
+<impo>
+It is crucial that you keyword ALL packages related to the new Java system,
+otherwise you will have problems in the later steps of this guide.
+</impo>
+
+<impo>
+It can't be emphasized enough that you have to have ALL the packages related
+to the new Java system keyworded for it to function properly.
+</impo>
+
+</body>
+</section>
+<section>
+<title>Existing installs</title>
+<body>
+
+<p>
+For existing installs, regardless of if you have installed anything Java
+before, make sure you have followed the <uri
+link="/proj/en/java/java-upgrade.xml">Java Upgrade Guide</uri>.
+</p>
+
+</body>
+</section>
+<section>
+<title>New installs</title>
+<body>
+
+<p>
+New installs should require no further preparation.
+</p>
+
+</body>
+</section>
+</chapter>
+
+<chapter>
+<title>Installing a Virtual Machine</title>
<section>
<title>The choices</title>
<body>
<p>
-Gentoo provides numerous JREs and JDKs. Among the current alternatives, we
-have:
+Gentoo provides numerous Runtime Environments (JREs) and Development Kits
+(JDKs). Among the current choices, we have:
</p>
<table>
@@ -111,14 +210,14 @@
</p>
<p>
-Both the Sun and the IBM are generally faster, but getting them is a bit more
-hassle, as you are required to read and accept their license before downloading
-(IBM additionally requires you to register).
+The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely
+("free as in beer") available without any registration fuss.
</p>
<p>
-Our ebuilds for the Sun and IBM JRE/JDKs will inform you how to download the
-appropriate files.
+JREs and JDKs from Sun, IBM, and BEA are generally faster, but getting them
+is a bit more work, as you are required to read and accept their license before
+downloading (IBM additionally requires you to register).
</p>
</body>
@@ -132,6 +231,12 @@
Or to install your profile's default JRE, you can <c>emerge virtual/jre</c>.
</p>
+<p>
+In recent events, Sun has relicensed their JDK and JRE under a more Linux
+distro friendly license. As a result, Sun releases Java 1.5 and onwards are
+freely downloadable, without any further hassle.
+</p>
+
<note>
A JDK also includes a JRE, so if you install a JDK you shouldn't have to also
have to install a JRE.
@@ -140,15 +245,13 @@
</body>
</section>
<section>
-<title>Installing the Sun/IBM JRE/JDKs</title>
+<title>Installing fetch-restricted virtual machines</title>
<body>
<p>
-If you run <c>emerge dev-java/sun-jdk</c> or <c>emerge
-dev-java/ibm-jdk-bin</c>, you will be notified that you are required to
-download the actual files yourself. This has to do with license restrictions
-for the Sun JRE/JDK (online click-wrap license) and registration issues with
-the IBM JRE/JDK.
+As already mentioned, some of the JDKs and JREs require you to jump through a
+few hoops before installing. Simply emerge the packages as you normally would.
+The ebuilds will then instruct you where to go and what to download.
</p>
<p>
@@ -162,7 +265,7 @@
</chapter>
<chapter>
-<title>Configuring your JRE/JDK</title>
+<title>Configuring your virtual machine</title>
<section>
<title>Overview</title>
<body>
@@ -186,7 +289,7 @@
</body>
</section>
<section>
-<title>Setting a default JRE/JDK</title>
+<title>Setting a default virtual machine</title>
<body>
<p>
@@ -480,6 +583,15 @@
This is typically used to provide your IDE with the source code for the
package.
</li>
+ <li>
+ The <b>source</b> flag installs a zip of the source code of a package.
+ This is traditionally used for for IDEs to 'attach' source to the libraries
+ you are using.
+ </li>
+ <li>
+ For Java packages, the <b>doc</b> flag will build API documentation using
+ javadoc.
+ </li>
</ul>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-08-09 20:44 Lukasz Damentko
0 siblings, 0 replies; 26+ messages in thread
From: Lukasz Damentko @ 2006-08-09 20:44 UTC (permalink / raw
To: gentoo-doc-cvs
rane 06/08/09 20:44:33
Modified: java.xml
Log:
#143379, adding sun-jce-bin to the list of packages that need unmasking
Revision Changes Path
1.29 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.29&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.29&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.28&r2=1.29
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- java.xml 8 Aug 2006 09:51:12 -0000 1.28
+++ java.xml 9 Aug 2006 20:44:33 -0000 1.29
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.28 2006/08/08 09:51:12 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.29 2006/08/09 20:44:33 rane Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.6</version>
-<date>2006-08-07</date>
+<version>0.7</version>
+<date>2006-08-08</date>
<chapter>
<title>What is Java?</title>
@@ -88,6 +88,7 @@
dev-java/java-config
dev-java/java-config-wrapper
dev-java/javatoolkit
+dev-java/sun-jce-bin
# JDKs
=dev-java/sun-jdk-1.4*
=dev-java/sun-jdk-1.5*
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-08-31 1:19 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2006-08-31 1:19 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/08/31 01:19:43
Modified: java.xml
Log:
clarified p.keywords per nichoj's request on irc
Revision Changes Path
1.30 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.30&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.30&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.29&r2=1.30
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- java.xml 9 Aug 2006 20:44:33 -0000 1.29
+++ java.xml 31 Aug 2006 01:19:43 -0000 1.30
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.29 2006/08/09 20:44:33 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.30 2006/08/31 01:19:43 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.7</version>
-<date>2006-08-08</date>
+<version>0.8</version>
+<date>2006-08-30</date>
<chapter>
<title>What is Java?</title>
@@ -75,9 +75,8 @@
<body>
<p>
-If you are using the stable tree, i.e. x86, ppc, or amd64 as opposed to ~x86,
-~ppc, or ~amd64, you will need to add some entries to your
-<path>/etc/portage/package.keywords</path>:
+If you are using the stable tree opposed to ~arch, you will need to add some
+entries to your <path>/etc/portage/package.keywords</path>:
</p>
<pre caption="package.keywords">
@@ -120,15 +119,12 @@
sys-libs/db
</pre>
-<impo>
-It is crucial that you keyword ALL packages related to the new Java system,
-otherwise you will have problems in the later steps of this guide.
-</impo>
-
-<impo>
-It can't be emphasized enough that you have to have ALL the packages related
-to the new Java system keyworded for it to function properly.
-</impo>
+<warn>
+It is crucial that you list ALL these packages in
+<path>/etc/portage/package.keywords</path>, otherwise you will have problems in
+the later steps of this guide. Your new Java system will not function correctly
+without this list.
+</warn>
</body>
</section>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-09-08 10:49 Shyam Mani
0 siblings, 0 replies; 26+ messages in thread
From: Shyam Mani @ 2006-09-08 10:49 UTC (permalink / raw
To: gentoo-doc-cvs
fox2mike 06/09/08 10:49:38
Modified: java.xml
Log:
Removing duplicate source USE flag explanation. Thanks to honzig on IRC for reporting
Revision Changes Path
1.31 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.31&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.31&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.30&r2=1.31
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- java.xml 31 Aug 2006 01:19:43 -0000 1.30
+++ java.xml 8 Sep 2006 10:49:38 -0000 1.31
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.30 2006/08/31 01:19:43 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.31 2006/09/08 10:49:38 fox2mike Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -25,7 +25,7 @@
<license/>
<version>0.8</version>
-<date>2006-08-30</date>
+<date>2006-09-08</date>
<chapter>
<title>What is Java?</title>
@@ -576,11 +576,6 @@
by javadoc.
</li>
<li>
- The <b>source</b> flag will install a zip of the package's source code.
- This is typically used to provide your IDE with the source code for the
- package.
- </li>
- <li>
The <b>source</b> flag installs a zip of the source code of a package.
This is traditionally used for for IDEs to 'attach' source to the libraries
you are using.
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-09-10 21:30 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2006-09-10 21:30 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/09/10 21:30:58
Modified: java.xml
Log:
Fixed duplicate paragraph, thanks to honzig on irc for reporting
Revision Changes Path
1.32 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.32&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.32&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.31&r2=1.32
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- java.xml 8 Sep 2006 10:49:38 -0000 1.31
+++ java.xml 10 Sep 2006 21:30:58 -0000 1.32
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.31 2006/09/08 10:49:38 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.32 2006/09/10 21:30:58 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.8</version>
-<date>2006-09-08</date>
+<version>0.9</version>
+<date>2006-09-10</date>
<chapter>
<title>What is Java?</title>
@@ -200,12 +200,6 @@
note about not drop-in replacements
kaffe/sablevm/gcj/jamvm
-->
-
-<p>
-The default is Blackdown for both the JRE and the JDK, as it is freely ("free
-as in beer") available without any registration fuss.
-</p>
-
<p>
The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely
("free as in beer") available without any registration fuss.
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-09-10 22:27 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2006-09-10 22:27 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/09/10 22:27:26
Modified: java.xml
Log:
more typo fixes, thanks again to honzig for reporting on IRC
Revision Changes Path
1.33 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.33&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.33&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.32&r2=1.33
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- java.xml 10 Sep 2006 21:30:58 -0000 1.32
+++ java.xml 10 Sep 2006 22:27:26 -0000 1.33
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.32 2006/09/10 21:30:58 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.33 2006/09/10 22:27:26 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -562,17 +562,13 @@
<li>The <b>java</b> flag adds support for Java in a variety of programs</li>
<li>
The <b>nsplugin</b> flag adds support for Mozilla-like browsers (including
- Firefox).You will need this for viewing Java applets in your Mozilla-like
+ Firefox). You will need this for viewing Java applets in your Mozilla-like
browser.
</li>
<li>
- The <b>doc</b> flag will typically install API documentation, as generated
- by javadoc.
- </li>
- <li>
The <b>source</b> flag installs a zip of the source code of a package.
- This is traditionally used for for IDEs to 'attach' source to the libraries
- you are using.
+ This is traditionally used for IDEs to 'attach' source to the libraries you
+ are using.
</li>
<li>
For Java packages, the <b>doc</b> flag will build API documentation using
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-10-08 22:52 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2006-10-08 22:52 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/10/08 22:52:16
Modified: java.xml
Log:
Updated java.xml for bug 148699. includes new java browser plug-in chapter, as well as updated code listings. thanks to nichoj for the help
Revision Changes Path
1.34 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.34&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.34&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.33&r2=1.34
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- java.xml 10 Sep 2006 22:27:26 -0000 1.33
+++ java.xml 8 Oct 2006 22:52:16 -0000 1.34
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.33 2006/09/10 22:27:26 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.34 2006/10/08 22:52:16 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.9</version>
-<date>2006-09-10</date>
+<version>0.10</version>
+<date>2006-10-08</date>
<chapter>
<title>What is Java?</title>
@@ -291,18 +291,13 @@
<pre caption="Listing available VMs">
# <i>java-config --list-available-vms</i>
-1) Blackdown JDK 1.3.1 [blackdown-jdk-1.3] (/etc/env.d/java/20blackdown-jdk-1.3)
-2) Blackdown JDK 1.4.2.02 [blackdown-jdk-1.4] (/etc/env.d/java/20blackdown-jdk-1.4)
-3) Blackdown JRE 1.4.2.02 [blackdown-jre-1.4] (/etc/env.d/java/20blackdown-jre-1.4)
-4) IBM JDK 1.4.2 [ibm-jdk-bin-1.4] (/etc/env.d/java/20ibm-jdk-bin-1.4)
-5) IBM JRE 1.4.2 [ibm-jre-bin-1.4] (/etc/env.d/java/20ibm-jre-bin-1.4)
-6) WebLogic JRockit 1.4.2.05 [jrockit-jdk-bin-1.4] (/etc/env.d/java/20jrockit-jdk-bin-1.4)
-7) WebLogic JRockit 1.5.0.03 [jrockit-jdk-bin-1.5] (/etc/env.d/java/20jrockit-jdk-bin-1.5)
-8) Sun JDK 1.3.1.13 [sun-jdk-1.3] (/etc/env.d/java/20sun-jdk-1.3)
-9) Sun JDK 1.4.2.09 [sun-jdk-1.4] (/etc/env.d/java/20sun-jdk-1.4)
-*) Sun JDK 1.5.0.04 [sun-jdk-1.5] (/etc/env.d/java/20sun-jdk-1.5)
-11) Sun JRE 1.4.2.09 [sun-jre-bin-1.4] (/etc/env.d/java/20sun-jre-bin-1.4)
-12) Sun JRE 1.5.0.04 [sun-jre-bin-1.5] (/etc/env.d/java/20sun-jre-bin-1.5)
+The following VMs are available for generation-2:
+1) Blackdown JDK 1.4.2.03 [blackdown-jdk-1.4.2]
+2) Blackdown JRE 1.4.2.03 [blackdown-jre-1.4.2]
+3) Blackdown 32bit JRE 1.4.2.03 [emul-linux-x86-java-1.4.2]
+4) Sun 32bit JRE 1.5.0.08 [emul-linux-x86-java-1.5]
+5) Kaffe 1.1.7 [kaffe]
+*) Sun JDK 1.5.0.08 [sun-jdk-1.5]
</pre>
<p>
@@ -315,8 +310,10 @@
<pre caption="Setting the System VM">
<comment>(By handle (preferred))</comment>
# <i>java-config --set-system-vm blackdown-jdk-1.4</i>
+Now using blackdown-jdk-1.4 as your generation-2 system JVM
<comment>(By number)</comment>
-# <i>java-config --set-system-vm 2</i>
+# <i>java-config --set-system-vm 6</i>
+Now using sun-jdk-1.5 as your generation-2 system JVM
</pre>
<p>
@@ -541,6 +538,114 @@
</chapter>
<chapter>
+<title>Java Browser Plug-ins</title>
+<section>
+<title>Installing a plug-in</title>
+<body>
+
+<p>
+You can install a Java plug-in for your web browser by emerging a Java VM with
+the <c>nsplugin</c> USE flag set.
+</p>
+
+<note>
+<c>nsplugin</c> is not available for all architectures. Check for available
+plug-ins on your arch before trying to install a VM by running <c>emerge -pv
+<java-vm></c>.
+</note>
+
+<p>
+Portage will allow you to install multiple versions of Java plug-ins, though
+only one will be used by your browser. You can check the list of available
+plug-ins by running:
+</p>
+
+<pre caption="Viewing available plug-ins">
+# <i>eselect java-nsplugin list</i>
+ [1] sun-jre-bin-1.5
+ [2] blackdown-jre-1.4.2
+</pre>
+
+<p>
+In this example, <c>sun-jre-bin</c> is selected for the browser plug-in.
+</p>
+
+<pre caption="Selecting a plug-in">
+# <i>eselect java-nsplugin sun-jre-bin-1.5</i>
+</pre>
+
+<p>
+Verify that the correct plug-in was selected:
+</p>
+
+<pre caption="Verifying the correct plug-in">
+# <i>eselect java-nsplugin list</i>
+ [1] sun-jre-bin-1.5 current
+ [2] blackdown-jre-1.4.2
+</pre>
+
+<p>
+Java.com also provides a link to <uri
+link="http://java.com/en/download/installed.jsp">verify your installed
+plug-in</uri>. Additionally, if you are using a Mozilla-based browser, you can
+verify your Java plug-in by typing <c>about:plugins</c> into the address bar.
+</p>
+
+</body>
+</section>
+<section>
+<title>Plug-ins on multilib systems</title>
+<body>
+
+<p>
+If you are running a mixed 64-bit and 32-bit multilib system (for example, on AMD64),
+you can have both 64-bit and a 32-bit Java plug-ins installed.
+</p>
+
+<p>
+First, check which plug-ins are available:
+</p>
+
+<pre caption="Viewing available plug-ins">
+# <i>eselect java-nsplugin list</i>
+Available 32-bit Java browser plugins
+ [1] emul-linux-x86-java-1.4.2
+ [2] emul-linux-x86-java-1.5
+Available 64-bit Java browser plugins
+ [1] blackdown-jdk-1.4.2
+ [2] blackdown-jre-1.4.2
+</pre>
+
+<p>
+You can select a 32-bit plug-in for a 32-bit browser (for example,
+<c>firefox-bin</c>), and you can select a 64-bit plug-in for your 64-bit
+browser (for example, <c>konqueror</c>).
+</p>
+
+<pre caption="Selecting plug-ins">
+# <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.4.2</i>
+# <i>eselect java-nsplugin set 64bit blackdown-jdk-1.4.2</i>
+</pre>
+
+<p>
+Verify the correct plug-ins were selected:
+</p>
+
+<pre caption="Verifying the correct plug-ins">
+# <i>eselect java-nsplugin list</i>
+Available 32-bit Java browser plugins
+ [1] emul-linux-x86-java-1.4.2 current
+ [2] emul-linux-x86-java-1.5
+Available 64-bit Java browser plugins
+ [1] blackdown-jdk-1.4.2 current
+ [2] blackdown-jre-1.4.2
+</pre>
+
+</body>
+</section>
+</chapter>
+
+<chapter>
<title>USE flags for use with Java</title>
<section>
<title>Setting USE flags</title>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-10-15 22:03 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2006-10-15 22:03 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/10/15 22:03:17
Modified: java.xml
Log:
Removed java keywords section now that it's all stable, per nichoj's request on IRC
Revision Changes Path
1.35 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.35&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.35&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.34&r2=1.35
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- java.xml 8 Oct 2006 22:52:16 -0000 1.34
+++ java.xml 15 Oct 2006 22:03:16 -0000 1.35
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.34 2006/10/08 22:52:16 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.35 2006/10/15 22:03:16 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.10</version>
-<date>2006-10-08</date>
+<version>0.11</version>
+<date>2006-10-15</date>
<chapter>
<title>What is Java?</title>
@@ -57,77 +57,7 @@
</chapter>
<chapter>
-<title>New Java System</title>
-<section>
-<body>
-
-<p>
-The way Java is handled on Gentoo has recently seen many changes and
-improvements. This has only happened very recently, and as a result, all the
-packages related to it are marked with testing keywords, ie ~x86. This
-document assumes you are using the new system.
-</p>
-
-</body>
-</section>
-<section>
-<title>Keywords</title>
-<body>
-
-<p>
-If you are using the stable tree opposed to ~arch, you will need to add some
-entries to your <path>/etc/portage/package.keywords</path>:
-</p>
-
-<pre caption="package.keywords">
-# Core Gentoo/Java Packages
-dev-java/ant-core
-dev-java/ant-tasks
-dev-java/ant
-dev-java/java-config
-dev-java/java-config-wrapper
-dev-java/javatoolkit
-dev-java/sun-jce-bin
-# JDKs
-=dev-java/sun-jdk-1.4*
-=dev-java/sun-jdk-1.5*
-=dev-java/ibm-jdk-bin-1.4*
-=dev-java/ibm-jdk-bin-1.5*
-=dev-java/jrockit-jdk-bin-1.4*
-=dev-java/jrockit-jdk-bin-1.5*
-=dev-java/blackdown-jdk-1.4*
-dev-java/kaffe
-# JREs
-=dev-java/sun-jre-bin-1.4*
-=dev-java/sun-jre-bin-1.5*
-=dev-java/ibm-jre-bin-1.4*
-=dev-java/blackdown-jre-1.4*
-# Virtuals
-virtual/jdk
-virtual/jre
-# Compilers
-dev-java/eclipse-ecj
-dev-java/jikes
-# Documentation
-dev-java/java-sdk-docs
-# Misc packages that have been updated to generation-2,
-# where the generation-1 won't build and/or run properly
-dev-java/lucene
-# These have optional Java support, but need ~arch to function properly
-# with generation-2
-dev-util/subversion
-sys-libs/db
-</pre>
-
-<warn>
-It is crucial that you list ALL these packages in
-<path>/etc/portage/package.keywords</path>, otherwise you will have problems in
-the later steps of this guide. Your new Java system will not function correctly
-without this list.
-</warn>
-
-</body>
-</section>
+<title>Before You Begin</title>
<section>
<title>Existing installs</title>
<body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2006-10-16 12:18 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2006-10-16 12:18 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 06/10/16 12:18:16
Modified: java.xml
Log:
Fixed eselect code listing for bug 151537
Revision Changes Path
1.36 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.36&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.36&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.35&r2=1.36
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- java.xml 15 Oct 2006 22:03:16 -0000 1.35
+++ java.xml 16 Oct 2006 12:18:15 -0000 1.36
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.35 2006/10/15 22:03:16 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.36 2006/10/16 12:18:15 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.11</version>
-<date>2006-10-15</date>
+<version>0.12</version>
+<date>2006-10-16</date>
<chapter>
<title>What is Java?</title>
@@ -501,7 +501,7 @@
</p>
<pre caption="Selecting a plug-in">
-# <i>eselect java-nsplugin sun-jre-bin-1.5</i>
+# <i>eselect java-nsplugin set sun-jre-bin-1.5</i>
</pre>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2007-01-11 20:52 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2007-01-11 20:52 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 07/01/11 20:52:46
Modified: java.xml
Log:
fix java config file location, thanks to nichoj for confirming
Revision Changes Path
1.37 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.37&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.37&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.36&r2=1.37
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- java.xml 16 Oct 2006 12:18:15 -0000 1.36
+++ java.xml 11 Jan 2007 20:52:46 -0000 1.37
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.36 2006/10/16 12:18:15 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.37 2007/01/11 20:52:46 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.12</version>
-<date>2006-10-16</date>
+<version>0.13</version>
+<date>2007-01-11</date>
<chapter>
<title>What is Java?</title>
@@ -270,7 +270,7 @@
test and verify every package works on all of them. So to ensure that every
packages merges smoothly, we have defined a list of <e>default/supported
VMs</e> per arch. You can find them in
-<path>/usr/share/java-config/config/jdk-defaults.conf</path>. When you are
+<path>/usr/share/java-config-2/config/jdk-defaults.conf</path>. When you are
merging a Java package, and it detects one of the VM in that file is installed,
it will automatically use that VM, instead of the system-vm.
</p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2007-01-23 19:35 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2007-01-23 19:35 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 07/01/23 19:35:12
Modified: java.xml
Log:
added some stuff to properly install a 32-bit java plugin, per a conversation with nichoj on IRC
Revision Changes Path
1.38 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.38&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.38&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.37&r2=1.38
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- java.xml 11 Jan 2007 20:52:46 -0000 1.37
+++ java.xml 23 Jan 2007 19:35:12 -0000 1.38
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.37 2007/01/11 20:52:46 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.38 2007/01/23 19:35:12 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.13</version>
-<date>2007-01-11</date>
+<version>0.14</version>
+<date>2007-01-23</date>
<chapter>
<title>What is Java?</title>
@@ -533,7 +533,17 @@
</p>
<p>
-First, check which plug-ins are available:
+To use a 32-bit plug-in, you will need to emerge <c>emul-linux-x86-java</c> with
+the <c>nsplugin</c> USE flag enabled.
+</p>
+
+<pre caption="Installing a 32-bit plug-in">
+# <i>echo "app-emulation/emul-linux-x86-java nsplugin" >> /etc/portage/package.use</i>
+# <i>emerge emul-linux-x86-java</i>
+</pre>
+
+<p>
+Next, check which plug-ins are available:
</p>
<pre caption="Viewing available plug-ins">
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2007-04-29 2:36 Josh Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Josh Saddler @ 2007-04-29 2:36 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 07/04/29 02:36:16
Modified: java.xml
Log:
updated java guide to reflect the nsplugin USE flag masking on blackdown for amd64, bug 161835
Revision Changes Path
1.39 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.39&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.39&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.38&r2=1.39
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- java.xml 23 Jan 2007 19:35:12 -0000 1.38
+++ java.xml 29 Apr 2007 02:36:16 -0000 1.39
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.38 2007/01/23 19:35:12 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.39 2007/04/29 02:36:16 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.14</version>
-<date>2007-01-23</date>
+<version>0.15</version>
+<date>2007-04-28</date>
<chapter>
<title>What is Java?</title>
@@ -47,7 +47,7 @@
<p>
In order to run Java bytecode, one needs to have a JRE (Java Runtime
Environment) installed. A JRE provides core libraries, a platform dependent
-Java Virtual Machine, plug-ins for browsers, among other things. A JDK (Java
+Java Virtual Machine, plugins for browsers, among other things. A JDK (Java
Development Kit) adds programming tools, such as a bytecode compiler and a
debugger.
</p>
@@ -468,47 +468,47 @@
</chapter>
<chapter>
-<title>Java Browser Plug-ins</title>
+<title>Java Browser Plugins</title>
<section>
-<title>Installing a plug-in</title>
+<title>Installing a plugin</title>
<body>
<p>
-You can install a Java plug-in for your web browser by emerging a Java VM with
+You can install a Java plugin for your web browser by emerging a Java VM with
the <c>nsplugin</c> USE flag set.
</p>
<note>
<c>nsplugin</c> is not available for all architectures. Check for available
-plug-ins on your arch before trying to install a VM by running <c>emerge -pv
+plugins on your arch before trying to install a VM by running <c>emerge -pv
<java-vm></c>.
</note>
<p>
-Portage will allow you to install multiple versions of Java plug-ins, though
+Portage will allow you to install multiple versions of Java plugins, though
only one will be used by your browser. You can check the list of available
-plug-ins by running:
+plugins by running:
</p>
-<pre caption="Viewing available plug-ins">
+<pre caption="Viewing available plugins">
# <i>eselect java-nsplugin list</i>
[1] sun-jre-bin-1.5
[2] blackdown-jre-1.4.2
</pre>
<p>
-In this example, <c>sun-jre-bin</c> is selected for the browser plug-in.
+In this example, <c>sun-jre-bin</c> is selected for the browser plugin.
</p>
-<pre caption="Selecting a plug-in">
+<pre caption="Selecting a plugin">
# <i>eselect java-nsplugin set sun-jre-bin-1.5</i>
</pre>
<p>
-Verify that the correct plug-in was selected:
+Verify that the correct plugin was selected:
</p>
-<pre caption="Verifying the correct plug-in">
+<pre caption="Verifying the correct plugin">
# <i>eselect java-nsplugin list</i>
[1] sun-jre-bin-1.5 current
[2] blackdown-jre-1.4.2
@@ -517,68 +517,66 @@
<p>
Java.com also provides a link to <uri
link="http://java.com/en/download/installed.jsp">verify your installed
-plug-in</uri>. Additionally, if you are using a Mozilla-based browser, you can
-verify your Java plug-in by typing <c>about:plugins</c> into the address bar.
+plugin</uri>. Additionally, if you are using a Mozilla-based browser, you can
+verify your Java plugin by typing <c>about:plugins</c> into the address bar.
</p>
</body>
</section>
<section>
-<title>Plug-ins on multilib systems</title>
+<title>Plugins on multilib systems</title>
<body>
<p>
If you are running a mixed 64-bit and 32-bit multilib system (for example, on AMD64),
-you can have both 64-bit and a 32-bit Java plug-ins installed.
+you can only use 32-bit Java plugins.
</p>
<p>
-To use a 32-bit plug-in, you will need to emerge <c>emul-linux-x86-java</c> with
+To use a 32-bit plugin, you will need to emerge <c>emul-linux-x86-java</c> with
the <c>nsplugin</c> USE flag enabled.
</p>
-<pre caption="Installing a 32-bit plug-in">
+<pre caption="Installing a 32-bit plugin">
# <i>echo "app-emulation/emul-linux-x86-java nsplugin" >> /etc/portage/package.use</i>
# <i>emerge emul-linux-x86-java</i>
</pre>
<p>
-Next, check which plug-ins are available:
+Next, check which plugins are available:
</p>
-<pre caption="Viewing available plug-ins">
+<pre caption="Viewing available plugins">
# <i>eselect java-nsplugin list</i>
Available 32-bit Java browser plugins
[1] emul-linux-x86-java-1.4.2
[2] emul-linux-x86-java-1.5
-Available 64-bit Java browser plugins
- [1] blackdown-jdk-1.4.2
- [2] blackdown-jre-1.4.2
</pre>
<p>
-You can select a 32-bit plug-in for a 32-bit browser (for example,
-<c>firefox-bin</c>), and you can select a 64-bit plug-in for your 64-bit
-browser (for example, <c>konqueror</c>).
+Although you must select a 32-bit browser (such as <c>mozilla-firefox-bin</c>)
+to use with your 32-bit plugin, the 64-bit version of <c>konqueror</c> uses your
+Java VM directly, so it's possible to use the 64-bit version of <c>blackdown</c>
+with this browser; no further configuration is necessary.
</p>
-<pre caption="Selecting plug-ins">
-# <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.4.2</i>
-# <i>eselect java-nsplugin set 64bit blackdown-jdk-1.4.2</i>
+<p>
+Now select the right plugin for your 32-bit browser:
+</p>
+
+<pre caption="Selecting plugins">
+# <i>eselect java-nsplugin set 32bit emul-linux-x86-java-1.5</i>
</pre>
<p>
-Verify the correct plug-ins were selected:
+Verify the correct plugin was selected:
</p>
-<pre caption="Verifying the correct plug-ins">
+<pre caption="Verifying the correct plugin">
# <i>eselect java-nsplugin list</i>
Available 32-bit Java browser plugins
- [1] emul-linux-x86-java-1.4.2 current
- [2] emul-linux-x86-java-1.5
-Available 64-bit Java browser plugins
- [1] blackdown-jdk-1.4.2 current
- [2] blackdown-jre-1.4.2
+ [1] emul-linux-x86-java-1.4.2
+ [2] emul-linux-x86-java-1.5 current
</pre>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2008-01-02 1:41 Joshua Saddler
0 siblings, 0 replies; 26+ messages in thread
From: Joshua Saddler @ 2008-01-02 1:41 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 08/01/02 01:41:02
Modified: java.xml
Log:
updated java guide per an email exchange with a user and nichoj
Revision Changes Path
1.40 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.40&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.40&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.39&r2=1.40
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -r1.39 -r1.40
--- java.xml 29 Apr 2007 02:36:16 -0000 1.39
+++ java.xml 2 Jan 2008 01:41:02 -0000 1.40
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.39 2007/04/29 02:36:16 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.40 2008/01/02 01:41:02 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -24,8 +24,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>0.15</version>
-<date>2007-04-28</date>
+<version>0.16</version>
+<date>2008-01-01</date>
<chapter>
<title>What is Java?</title>
@@ -115,11 +115,6 @@
<ti>dev-java/ibm-jre-bin</ti>
</tr>
<tr>
- <ti>The Compaq Java Kit for Alpha/Linux/GNU</ti>
- <ti>dev-java/compaq-jdk</ti>
- <ti>dev-java/compaq-jre</ti>
-</tr>
-<tr>
<ti>BEA WebLogic's J2SE Development Kit</ti>
<ti>dev-java/jrockit-jdk-bin</ti>
</tr>
@@ -613,6 +608,7 @@
This is traditionally used for IDEs to 'attach' source to the libraries you
are using.
</li>
+ <li>The <b>jce</b> flag adds support for the Java Cryptography Engine</li>
<li>
For Java packages, the <b>doc</b> flag will build API documentation using
javadoc.
@@ -660,6 +656,10 @@
link="http://en.wikipedia.org/wiki/Java_programming_language">Wikipedia's
entry for Java</uri>
</li>
+ <li>
+ If you have suggestions or questions regarding this document, please email
+ the Gentoo Java team: <mail>java@gentoo.org</mail>
+ </li>
</ul>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
* [gentoo-doc-cvs] cvs commit: java.xml
@ 2008-05-23 20:07 Sven Vermeulen
0 siblings, 0 replies; 26+ messages in thread
From: Sven Vermeulen @ 2008-05-23 20:07 UTC (permalink / raw
To: gentoo-doc-cvs
swift 08/05/23 20:07:51
Modified: java.xml
Log:
Coding style
Revision Changes Path
1.41 xml/htdocs/doc/en/java.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.41&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?rev=1.41&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/java.xml?r1=1.40&r2=1.41
Index: java.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- java.xml 2 Jan 2008 01:41:02 -0000 1.40
+++ java.xml 23 May 2008 20:07:51 -0000 1.41
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.40 2008/01/02 01:41:02 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/java.xml,v 1.41 2008/05/23 20:07:51 swift Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/java.xml">
@@ -121,12 +121,12 @@
</table>
<!--
-TODO: list free implementations?
+TODO: list free implementations?
note about not drop-in replacements
-kaffe/sablevm/gcj/jamvm
+kaffe/sablevm/gcj/jamvm
-->
<p>
-The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely
+The default for Java 1.4 is the Blackdown JRE/JDK pair, as it is freely
("free as in beer") available without any registration fuss.
</p>
@@ -439,7 +439,7 @@
<p>
For users, <c>java-config --set-user-classpath</c> will create
<path>~/.gentoo/java-env-classpath</path>, which you should then source from
-your shell's profile.
+your shell's profile.
</p>
<pre caption="Sourcing user specific classpath">
@@ -455,7 +455,7 @@
</p>
<pre caption="Setting classpath">
-# <i>export CLASSPATH="${CLASSPATH}:$(java-config --classpath log4j,xerces-2)"</i>
+# <i>export CLASSPATH="${CLASSPATH}:$(java-config --classpath log4j,xerces-2)"</i>
</pre>
</body>
@@ -523,8 +523,8 @@
<body>
<p>
-If you are running a mixed 64-bit and 32-bit multilib system (for example, on AMD64),
-you can only use 32-bit Java plugins.
+If you are running a mixed 64-bit and 32-bit multilib system (for example, on
+AMD64), you can only use 32-bit Java plugins.
</p>
<p>
--
gentoo-doc-cvs@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] 26+ messages in thread
end of thread, other threads:[~2008-05-23 20:07 UTC | newest]
Thread overview: 26+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-09-08 10:49 [gentoo-doc-cvs] cvs commit: java.xml Shyam Mani
-- strict thread matches above, loose matches on Subject: below --
2008-05-23 20:07 Sven Vermeulen
2008-01-02 1:41 Joshua Saddler
2007-04-29 2:36 Josh Saddler
2007-01-23 19:35 Josh Saddler
2007-01-11 20:52 Josh Saddler
2006-10-16 12:18 Josh Saddler
2006-10-15 22:03 Josh Saddler
2006-10-08 22:52 Josh Saddler
2006-09-10 22:27 Josh Saddler
2006-09-10 21:30 Josh Saddler
2006-08-31 1:19 Josh Saddler
2006-08-09 20:44 Lukasz Damentko
2006-08-08 9:51 Lukasz Damentko
2006-07-25 8:13 Lukasz Damentko
2006-07-20 23:55 Lukasz Damentko
2006-07-13 6:29 Lukasz Damentko
2006-06-24 19:06 Josh Saddler
2006-06-24 18:28 Josh Saddler
2006-03-06 17:46 Xavier Neys
2005-12-12 12:00 Xavier Neys
2005-11-13 12:17 Alin Dobre
2005-11-12 23:19 Stefano Rossi
2005-09-30 6:08 Alin Dobre
2005-09-29 18:27 Lukasz Damentko
2005-09-29 18:22 Lukasz Damentko
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox