release-notes/devel/en_US Java.xml,1.16,1.17
Paul W. Frields (pfrields)
fedora-docs-commits at redhat.com
Wed Sep 19 23:08:44 UTC 2007
Author: pfrields
Update of /cvs/docs/release-notes/devel/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv28738
Modified Files:
Java.xml
Log Message:
Update with latest changes from wiki
Index: Java.xml
===================================================================
RCS file: /cvs/docs/release-notes/devel/en_US/Java.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- Java.xml 18 May 2007 00:40:19 -0000 1.16
+++ Java.xml 19 Sep 2007 23:08:42 -0000 1.17
@@ -2,8 +2,8 @@
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.docbook.org/xml/4.4/docbookx.dtd">
<section id="sn-Java">
- <title>Java and java-gcj-compat</title>
-
+ <title><application>IcedTea</application> and
+ <package>java-gcj-compat</package></title>
<tip>
<title>Latest Release Notes on the Web</title>
<para>
@@ -11,50 +11,90 @@
url='http://docs.fedoraproject.org/release-notes/'>http://docs.fedoraproject.org/release-notes/</ulink>
to view the latest release notes for Fedora.</para>
</tip>
+ <section>
+ <title>IcedTea</title>
+ <para>This release of Fedora includes the
+ <application>IcedTea</application> environment.
+ <application>IcedTea</application> is a build harness for Sun's
+ OpenJDK code that replaces encumbered parts of OpenJDK with Free
+ Software replacements. <application>IcedTea</application> provides
+ a more complete, compatible environment than GCJ, including
+ support for building and running bytecode up to the 1.6 level.
+ Users of <application>IcedTea</application> should be aware of a
+ few caveats:</para>
+ <itemizedlist>
+ <listitem>
+ <para>There is no <systemitem>ppc</systemitem> or
+ <systemitem>ppc64</systemitem> support. Users of ppc and ppc64
+ systems should continue to use GCJ.</para>
+ </listitem>
+ <listitem>
+ <para>There is no support for the Java sound APIs.</para>
+ </listitem>
+ <listitem>
+ <para>There are a few missing cryptographic algorithms.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>Handling Java Applets</title>
+ <para>The Fedora <application>IcedTea</application> packages also
+ include an adaptation of <package>gcjwebplugin</package> that runs
+ untrusted applets safely in a web browser. The plugin is packaged
+ as <package>java-1.7.0-icedtea-plugin</package>.</para>
+ <itemizedlist>
+ <listitem>
+ <para>The <package>gcjwebplugin</package> adaptation has no
+ support for the bytecode-to-Javascript bridge, so applets that
+ rely on this bridge will not work.</para>
+ </listitem>
+ <listitem>
+ <para>The <package>gcjwebplugin</package> security policy may be
+ overly restrictive. To enable restricted applets, run
+ <command>firefox -g</command> in a terminal window to see what
+ is being restricted, then grant the restricted permission in
+ <filename>/usr/lib/jvm/java-1.7.0-icedtea-1.7.0.0/jre/lib/security/java.policy</filename>.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title><package>java-gcj-compat</package></title>
+ <para>This release of Fedora includes
+ <package>java-gcj-compat</package>. The
+ <package>java-gcj-compat</package> collection includes a tool
+ suite and execution environment that is capable of building and
+ running many useful programs that are written in the Java
+ programming language.</para>
+ <para>
+ The java-gcj infrastructure has three key components: a GNU Java
+ runtime (<package>libgcj</package>), the
+ <application>Eclipse</application> Java compiler
+ (<command>ecj</command>), and a set of wrappers and links
+ (<package>java-gcj-compat</package>) that present the runtime and
+ compiler to the user in a manner similar to other Java
+ environments.
+ </para>
- <para>
- This release of Fedora includes a free and open source Java
- environment called <package>java-gcj-compat</package>. The
- <package>java-gcj-compat</package> collection includes a tool suite and
- execution environment that is capable of building and running many
- useful programs that are written in the Java programming language.
- </para>
- <note>
- <title>Fedora Does Not Include Java</title>
- <para>
- Java is a trademark of Sun Microsystems.
- <package>java-gcj-compat</package> is an entirely free software stack that
- is <emphasis role='strong'>not</emphasis> Java, but may run Java
- software.
- </para>
- </note>
- <para>
- The java-gcj infrastructure has three key components: a GNU Java runtime
- (<package>libgcj</package>), the <application>Eclipse</application> Java
- compiler (<command>ecj</command>), and a set of wrappers and links
- (<package>java-gcj-compat</package>) that present the runtime and compiler
- to the user in a manner similar to other Java environments.
- </para>
-
- <para>
- The Java software packages in this Fedora release use the
- <package>java-gcj-compat</package> environment. These packages
- include <application>OpenOffice.org Base</application>,
- <application>Eclipse</application>, and <application>Apache
- Tomcat</application>. Refer to the Java FAQ at <ulink
- url='http://www.fedoraproject.org/wiki/JavaFAQ'>http://www.fedoraproject.org/wiki/JavaFAQ</ulink>
- for more information on the <package>java-gcj-compat</package> free
- Java environment in Fedora.
- </para>
- <important>
- <title>Include Location and Version Information in Bug Reports</title>
- <para>
- When making a bug report, be sure to include the
- output from these commands:
- </para>
-<screen><![CDATA[which java && java -version && which javac && javac -version
-]]></screen>
- </important>
+ <para>
+ The Java software packages in this Fedora release use the
+ <package>java-gcj-compat</package> environment. These packages
+ include <application>OpenOffice.org Base</application>,
+ <application>Eclipse</application>, and <application>Apache
+ Tomcat</application>. Refer to the Java FAQ at <ulink
+ url='http://www.fedoraproject.org/wiki/JavaFAQ'>http://www.fedoraproject.org/wiki/JavaFAQ</ulink>
+ for more information on the <package>java-gcj-compat</package>
+ free Java environment in Fedora.
+ </para>
+ <important>
+ <title>Include Location and Version Information in Bug
+ Reports</title>
+ <para>
+ When making a bug report, be sure to include the output from
+ these commands:
+ </para>
+ <screen><![CDATA[which java && java -version && which javac && javac -version ]]></screen>
+ </important>
+ </section>
<section id="sn-Handling-Java-and-Java-like-Packages">
<title>Handling Java and Java-like Packages</title>
@@ -71,27 +111,10 @@
<command>javac</command> implementations using the
<command>alternatives</command> command:
</para>
-<screen><![CDATA[alternatives --config java
-alternatives --config javac
-]]></screen>
- </section>
-
- <section id="sn-Handling-Java-Applets">
- <title>Handling Java Applets</title>
- <para>
- This release of Fedora includes a preview release of
- <package>gcjwebplugin</package>, a Firefox plugin for Java applets.
- <package>gcjwebplugin</package> is not enabled by default because although
- the security implementation in GNU Classpath is being actively developed,
- it is not mature enough to run untrusted applets safely. That said, the
- AWT and Swing implementations in GNU Classpath are now sufficiently mature
- that they can run many applets deployed on the web. Adventurous users who
- want to try <package>gcjwebplugin</package> can read
- <filename>/usr/share/doc/libgcj-4.1.2/README.libgcjwebplugin.so</filename>,
- as installed by the <package>libgcj</package> package. The
- <filename>README</filename> explains how to enable the plugin and the
- risks associated with doing so.
- </para>
+ <screen><![CDATA[alternatives --config java alternatives --config javac ]]></screen>
+ <para>A simpler way to switch Java alternatives is using the
+ <command>sytsem-switch-java</command> tool included in
+ Fedora.</para>
</section>
<section id="sn-Fedora-and-the-JPackage-Java-Packages">
@@ -103,22 +126,21 @@
to make use of GCJ's ahead-of-time compilation feature. Use the
Fedora repositories to update these packages, or use the JPackage
repository for packages not provided by Fedora. Refer to the
- JPackage website at
- <ulink url='http://jpackage.org'>http://jpackage.org</ulink> for
- more information on the project and the software it provides.
+ JPackage website at <ulink
+ url='http://jpackage.org'>http://jpackage.org</ulink> for more
+ information on the project and the software it provides.
</para>
<warning>
<title>Mixing Packages from Fedora and JPackage</title>
<para>
- Research package compatibility before you install software from both the
- Fedora and JPackage repositories on the same system. Incompatible
- packages may cause complex issues.
+ Research package compatibility before you install software from
+ both the Fedora and JPackage repositories on the same system.
+ Incompatible packages may cause complex issues.
</para>
</warning>
<para>
- Refer to the latest release notes pertaining to Eclipse at
- <ulink
- url='http://fedoraproject.org/wiki/Docs/Beats/Devel/Tools/Eclipse'>http://fedoraproject.org/wiki/Docs/Beats/Devel/Tools/Eclipse</ulink>.
+ Refer to the latest release notes pertaining to Eclipse at <ulink
+ url='http://fedoraproject.org/wiki/Docs/Beats/Devel/Tools/Eclipse'>http://fedoraproject.org/wiki/Docs/Beats/Devel/Tools/Eclipse</ulink>.
</para>
</section>
@@ -127,22 +149,24 @@
<para>
This release of Fedora includes <package>maven2</package>, a Java
project management and project comprehension tool. Maven can be
- invoked by the <command>mvn</command> and <command>mvn-jpp</command> commands.
- The former makes Maven behave just like upstream Maven, while the
- latter calls <command>mvn</command> with additional properties that make
+ invoked by the <command>mvn</command> and
+ <command>mvn-jpp</command> commands. The former makes Maven behave
+ just like upstream Maven, while the latter calls
+ <command>mvn</command> with additional properties that make
off-line building easier.
</para>
<para>
- The <package>maven2</package> package in Fedora is modified to work in a
- fully off-line mode. With no additional properties defined (the
- <command>mvn</command> command), <command>maven2</command> works exactly like
- upstream Maven. Users may define additional properties to
- facilitate off-line builds, or call <command>mvn-jpp</command>, a
- wrapper that defines the most commonly used properties for
- off-line building. The properties and their usage details are
- described in the
- <filename>/usr/share/doc/maven2-2.0.4/maven2-jpp-readme.html</filename>
- file, which comes from the <package>maven2-manual</package> package.
+ The <package>maven2</package> package in Fedora is modified to
+ work in a fully off-line mode. With no additional properties
+ defined (the <command>mvn</command> command),
+ <command>maven2</command> works exactly like upstream Maven. Users
+ may define additional properties to facilitate off-line builds, or
+ call <command>mvn-jpp</command>, a wrapper that defines the most
+ commonly used properties for off-line building. The properties and
+ their usage details are described in the
+ <filename>/usr/share/doc/maven2-2.0.4/maven2-jpp-readme.html</filename>
+ file, which comes from the <package>maven2-manual</package>
+ package.
</para>
</section>
</section>
More information about the Fedora-docs-commits
mailing list