<!doctype debiandoc system>

<book>

<titlepag>
<title>Debian Java FAQ.</title>
<author>
<name>Javier Fernndez-Sanguino Pea </name>
<email>jfs@computer.org</email>
</author>
<version>1.0
<date>Thu,  7 Dec 2000 19:10:13 +0100

<abstract>
Answers to Frequently Asked Questions on Debian
and Java. Any changes to this FAQ are appreciated, please send them to the
current maintainer. 
</abstract>

</titlepag>


<toc>


<chapt>Introduction
<p>

<sect>Introduction to this FAQ
<P>This FAQ was started by Javier Fernndez-Sanguino who on
Feb 1st, 2000  was (bold?) enough to send a message to the debian-java
mailing list with the subject "How about a Debian-Java-FAQ?". Of
course, since "every idea is a responsibility" he had to do this himself
looking through the three month-long archive of the newborn mailing list.
<p>The purpose of this FAQ is to be a place to look for all kind of
question a developer or user might have regarding Java as far as Debian
is concerned, it includes license issues, development packages available,
and programs related to building a Free Software Java environment.
<p> Thanks go to all the (many) contributors from the debian-java mailing list,
who have made this document possible. Without their knowledge this 
FAQ would not be at all possible since I only have a vague knowledge
of what they're talking about when I browse the list.

<p>Special thanks go to Paul Reavis, which I found had written a
Debian-JDK informational page previously, which I used to add more
information, and made useful suggestions to this document. Also to
Peter Moulder who revised thoroughly the FAQ and provided many suggestions,
and to  Juergen Kreileder, maintainer of Blackdown's debian packages
who pointed out some mistakes.


<p>This document does not address issues with other Linux
distributions, or with non-Debian-specific problems. See the <url
id="http://www.blackdown.org" name="Blackdown pages"> for
information on these. More specifically you might want to check out
<url id="http://www.blackdown.org/java-linux/docs/support/faq-release/FAQ-java-linux-1.html" name="the Java Linux FAQ">.


<sect>What is java?
<p>
Java is a strongly-typed platform-independant object-oriented programming
language often associated with the World Wide Web. Java was developed by Sun
Microsystems for embedded applications, but has since grown to become a
general-purpose programming language. Java source code can either be
compiled to a machine-independant byte-code that can be run by Java virtual
machines, or it can be compiled directly to executable code for any number
of platforms, including Linux, Win32, and others.
 
A common API, shipped with all Java development environments,
provides socket support, a graphical user interface widget set, graphical
drawing tools, standard IO, events, math, database interfaces, and
multithreading, to name a few.
 
The multithreading support can happen either in kernel threads or userland
threads, depending on the implementation of the Java virtual machine used. 
<sect>Why would I be interested in Java?
<p>
TODO 

<sect>What is a JIT?  
<p>
Acronym for Just In Time, A VM plugin to speed up VM execution by
compiling bytecode to native machine code.

<sect>Where can I read more about Java?
<p>
Of course, <url id="http://java.sun.com"> would be the first place to
read information on Java, right from the company who started
it. However good places for Java and Linux could be:


<list>
<item>Enterprise in a Nutshell by  Gary Meyer, at <url id="
http://www.linuxdoc.org/HOWTO/Enterprise-Java-for-Linux-HOWTO.html">. Explains
how to set up an environment including JDK, web server, Java servlets,
JDBC access to a database and EJBs. If you are interested read also
Java Enterprise in a Nutshell at <url
id="http://www.oreilly.com/catalog/jentnut/">.


<item>The Linux Journal Magazine, the following articles might be
worth reading:
<list>
<item>Issue 66 <url
id="http://www.linuxjournal.com/lj-issues/issue66/3119.html"
name="Java servlets"> and <url
id="http://www.linuxjournal.com/lj-issues/issue66/3224.html"
name="Java 2 SDK">.

<item>Issue 45 <url
id="http://www.linuxdoc.org/LDP/LG/issue45/gibbs/Linux_java.html">
<item>Issue 33 <url id="http://www.linuxdoc.org/LDP/LG/issue33/burtch.html">
<item>Issue 32 <url id="http://www.linuxdoc.org/LDP/LG/issue32/rojansky.html">
<item>Issue 25 <url id="http://www.linuxdoc.org/LDP/LG/issue29/hamilton.html">
</list>


<item>Linux users worlwide includes information on how to use Java an
Linux <url id="http://linuxusers.webprovider.com">.

<item>Linux Java Tips and Hints at <url
id="http://www.parnasse.com/java.shtml">.



<item>The Java and Linux Page <url id="http://www.geocities.com/SiliconValley/Platform/8187/java/Linux_java.html">

<item>The Java-CGI HOWTO from David H. Silber. <url
id="http://www.linuxdoc.org/HOWTO/Java-CGI-HOWTO.html">. Explains how
to set up your server to run Java CGIs. Maybe it is worth looking at
servlets.

</list>

Other sites regarding Java would be:
<list>
<item>The Java Lobby <url id="http://www.javalobby.org">.


<item>Brewing Java: a tutorial at <url
id="http://metalab.unc.edu/javafaq/javatutorial.html">.

</list>

If you are browsing the web for free Java information try starting with <url
id="http://members.tripod.com/~mpTOOLS/ring.html" name="Open-Source Java">
, if you are looking for applets with source code look at <url
id="http://javaboutique.internet.com/javasource.html">. Check also
<ref id="free">


<sect>Status of Java in Debian
<P>

 The first thing you should understand about the design strategy of Debian
is that our goal is to produce a 100% Free software platform. In that
sense, some of these tools are not available in the standard Debian
distribution for licensing reasons as opposed to some technical
motivation.

<p>That said, basically all of the technologies you might ask about can
be or are available for Debian immediately. In order to usefully
answer your questions, however, here you have a status from an Open
Source availability perspective.

<p>If you are <em>really</em> interested, read the following:
<url id="http://www.debian.org/Lists-Archives/debian-java-9912/msg00015.html"> and
<url id="http://www.debian.org/Lists-Archives/debian-java-9910/msg00017.html">. This
section is a summary of the information therein.

<sect1>Java1 compiler (.java to .class)
<p>There is the Kopi Java Compiler written
in Java. And the super fast Jikes written in C++.
<p>Gcj can also compile .java to .class.  CVS version currently
does  handle inner classes, as well as any other jdk 1.1 constructs,
but might not be able to compile a complicated program like the
XSL processor xt.
  It is written in C, so is reasonably fast.  It generates reasonably 
good bytecode.  And
of course being able to use the same compiler for .java to .class and
.java to native has its advantages.


<sect1>Java1 JVM/JIT
<p>Kaffe 1.0.5 is largely feature complete and now includes support for
  RMI. It is not clear as to whether Kaffe's serialization is "binary compatible"
  with Sun's implementation in all cases so there may be
  interoperation issues in some casses. Kaffe comes with a big class library.
<p>Japhar is also available.
<p>libgcj (the run-time library for gcj) now includes an interpreter
and ClassLoader.
<p>tya, a JIT compiler, is also available.

<sect1>Java1 native compiler
<p>GCC, the Gnu Compiler Collection comes with GCJ, the Gnu Compiler for Java

<sect1>Java2 native compiler
<p>It is unclear whether native compiler refers to the adaptive JIT
  capabilities in Java2 or to a compiler that understands Java2
  semantics. In either case, Kaffe's JIT strategy is not adaptive but
  performs correctly, and improving, it is believed IBM's Jikes 
  compiler understands Java2 concepts such as weak references.

<sect1>Java2 foundation libraries

<p>Many of these components have been cloned under a Free Software
license. Kaffe provides many of these routines, including an
up-to-date RMI implementation. There are, however, definitely
shortcomings. Swing, as far as we know, has not been cloned.

<sect1>Debugger (jdb equivalent)
<p>Debian has no debugger currently.

<p>Gdb can debug native code produced by Gcj. Stuart Grossman (Cygnus) also
wrote support for Gdb to debug other VMs using JVMDI.  This has not
been released, because the Gdb internals were changed at the same
time, and no-one has had time to re-integrate the changes.  We can
probably get Cygnus to release the old code, if someone wants to look
into getting this stuff working with the current Gdb internals.  (A
non-trivial job.)  <p>See <url
id="http://sourceware.cygnus.com/java/gdb.html"> on how to debug
gcj-compiled Java programs.

<sect2>What free edit-interactive/graphical debugging tools are available on
Debian?
<p>jde, ddd, more?

<P>One of the some nice features of jde are autoindention and syntax
highlighting, but it also supports debugging and compilation.

<sect2>Known problems
<p>My version of <prgn>jdb</prgn> (jdb version 98/01/06) terminates after a program
finishes execution, and I have to reset every breakpoint if I want to run
through the program again. This makes using jdb extremely frustrating. Jdb
also can't (easily) print the values in an array which is more than three
elements long. Ddd lets me work around both of these annoyances.
 
<p><prgn>ddd</prgn> 3.1 and earlier would "hang" when receiving certain prompts with
wierd thread names from jdb. This made it very hard to use ddd with jdb.
This has been fixed in ddd 3.2. It doesn't look like ddd 3.2 has been
packaged yet. I suspect the current packaged version of ddd won't work
well with jdb.
                                             

<sect1>Appletviewer tool
<p>There are some alternatives for an appletviewer tool:

<list>
<item>Blackdown's appletviewer (in jdk1.1).
<item>Kaffe's appletviewer.
<item>Ibm's appletviewer (in ibm-jdk).
</list>

<sect1>Jar tool
<p><package>FastJar</package> which is indeed very fast.

<sect1>Javadoc tool
<p><package>doc++</package> can work with C++ and Java.

<sect1>Enterprise Java Beans (EJB)
<p>There is activity in this area, the most noteworthy being the Open
  Source EJB implementation from Bull in France called Jonas. I have
  done some work with this system and it provides a good start towards
  a full EJB feature set. In particular, it provides a transaction
  monitor and a container based persistance implementation. I have
  used this system on Linux with free databases such as Postgresql. I
  have not been able to get the system fully operational on Kaffe.
  Additionally, the system depends on many Sun APIs which have not
  been cloned (JTA, JNDI, and EJB itself).

<sect1>JAIN
<P>
  It seems to be  a system for
  controlling large scale, integrated communications infrastructures
  and modeling events with such networks via the JavaBeans API. The
  scale of this effort seems very large and encompasses the work of
  many organizations. The work is very new and seems to tie into Sun's
  SCSL strategy, which leads us me to believe that there is not
  much in the way of Open Source options in this area. However, some
  protocols such as H.323 are genuinely open and are even cloned so it
  is possible that chunks of the JAIN system may exist in a scattered
  manner. We have no knowledge of a serious Free Software 
  implementation of RTP or the H.323 infrastructures in Java.

<sect1>Jini
<p> Jini presents an especially pronounced Free Software problem. Jini is
  only available as source from Sun and that source is only available
  under the SCSL. The SCSL is not compatible in any sense with either
  the legal mechanics or the political spirit of Free Software. The
  SCSL also makes cloning the API of an SCSL implementation illegal
  which precludes even a clean room replication of Jini. If you are
  interested in tuple space type implementations there are Open
  Source options. 


<chapt>Java development
<p>
<sect>What full-fledged Java development platforms are available in Debian?
<p>
If you are looking for an integrated, java virtual machine, compiler and runtime environment Debian does provide them.  Of course that would depend on the Debian GNU/Linux version you are using, generally speaking they would be:
<list>
<item>Sun's jdk 1.1 (port made by Blackdown <url id="http://www.blackdown.org">)
<item><prgn>kaffe</prgn>.
<item>ibm's jdk (see <ref id="installer">)
</list>

<sect id="free">What free platforms are there and how can I contribute?
<p>
Please help one of the Free Java implementations if you want to use Java
in Debian. There are a lot of projects that you can choose from:
<list>

<item>kaffe: <url id="http://www.kaffe.org"> or <url id="http://www.transvirtual.com">.

<item>Japhar: <url id="http://www.japhar.org">. The Java virtual
machine of "Hungry Programmer". More info in <url id="http://www.hungry.com/products/japhar">.

<item>gcj and libgcj: <url id="http://sourceware.cygnus.com/java/">

<item>jikes: <url id="http://www.research.ibm.com/jikes/">. A fast
compiler written in C++ (check also <url
id="http://www10.software.ibm.com/developerworks/opensource/jikes/">).
(The new license seems to be finally really free)

<item>kopi: <url id="http://www.dms.at/kjc/">.Yet Another Free Java
Compiler, this time written in Java, and GPL. Included in Kaffe since
release 1.0.5.

<item>FastJar <url id="http://fastjar.sourceforge.net/">, as a jar
tool. (this link seems to be broken, anyone?)

<item>Classpath <url id="http://www.gnu.org/software/classpath/"> or
<url id="http://www.classpath.org">. Most of the Standard classes for
Java 1.2 (except Swing and RMI) are implemented by the ClassPath
project, it tries to build an alternative to jdk's 1.2 core classes.



<item>Most of the RMI classes are implemented by NinjaRMI
<url id="http://www.cs.berkeley.edu/~mdw/proj/ninja/ninjarmi.html">

<item>Autoconf macros <url
id="http://www.internatif.org/bortzmeyer/autoconf-Java/"> helps easy
recompilation of Java programs.  <item>Mauve <url
id="http://sourceware.cygnus.com/mauve/"> is a free suite to test if
these tools are 'compliant'.


</list>
<p>There is a list on free Java at <url id="http://www.lists.deus.net/mailman/listinfo/free-java">, also look <url id="http://www.gnu.org/software/java/"> for information about Free Java.

<sect>Questions on  platforms  and license concerns

<sect1>Java 2 SE (aka JDK1.2)
<p>
<sect2>Why is Sun's  Java 2 SE (aka jdk 1.2) not available?
<P>
Due to license problems. Clause 2 of the <url id="http://www.sun.com/software/communitysource/java2/license.html" name="license"> (check also the 
<url id="http://www.sun.com/software/communitysource/faq.html" name="FAQ">) that comes with is says:
<example>
Software is confidential and copyrighted. Title to Software and all
associated intellectual property rights is retained by Sun and/or its
licensors.  Except as specifically authorized in any Supplemental License
Terms, you may not make copies of Software, other than a single copy of
Software for archival purposes.
</example>

<sect2 id="scsl">What are the problems with Suns' new license?
<p>Sun has moved to a new license the <em>Sun
Community License</em>, like the GPL it is a viral license, but making
all it touches subject to Sun licensing fee. The SCSL even goes so far as to
define any implementation of a Sun specification as a "Modified Work".
Basically, this means that if you implement any part of the new 1.2 API
or Jini API, even from scratch, Sun will "own" your implementation and you
will have to pay them for the right to use it.
<example>
13.  "Modification(s)" means (i) any change to Covered Code;
     (ii) any new file or other representation of computer
     program statements that contains any portion of Covered
     Code; and/or (iii) any new Source Code implementing any
     portion of the Specifications.
</example>
<sect2> What is the SCSL?
<P>
  The SCSL is the "Sun Community Software License" that can be found
  <url id="http://java.sun.com/communitysource/">. It is not
  compatible with Free Software for several reasons, and agreeing to
  this license (e.g. by downloading source covered by the SCSL) will
  make it impossible for you to contribute to free software clean-room
  implementations. According to Sun, this includes using documentation
  and API specifications available only under SCSL.

<P> To quote one open source developer, the SCSL is "about as
  free as the former Soviet Union".

<sect2>Can I use jdk1.2 while working with the free Java implementations?
<p>
 Clause 1 of the Supplemental License Terms says:
<example>
 [You] may not create, or authorize your licensees to create
 additional classes, interfaces, or subpackages that are contained in
 the "java" or "sun" packages or similar as specified by Sun in any
 class file naming convention;
</example>
<p>Which seems to prevent one from making his own implementation of the
standard Java classes using the JDK. 
<P>However, it is unclear whether or not the word `additional' includes
reimplementations of existing classes, or whether it applies only
to classes with new names.


<sect2>Why is (some) free software not implementing Java2?
<P>
  Sun has made public statements in connection with their legal
  strategy in the Sun-Microsoft lawsuit that indicate that the
  company considers the published specifications of Java2 to be
  intellectual property that can not legally be used by persons
  involved in efforts to create Java2 clean-room implementations.
  For this reason, some open source projects have decided to not
  implement Java2 any time soon. One example is Kaffe. Some
  projects (like the Japhar/Classpath project) have decided to
  challenge Sun's legal position and are going ahead with Java2.


<sect1 id="ibm-jdk1.1">IBM's jdk1.1
<P>
<sect2>Can Debian distribute IBM's jdk1.1?
<p>
It seems not. It has the following license:
<example>
Program Code

Consists of the IBM Developer Kit for Linux(R), Java(TM) Technology Edition,
Version 1.1.8, in Binary Code form, as modified by IBM to run on the RedHat(R)
6.0 Linux or Caldera(R) OpenLinux 2.2 Operating systems. The Program Code
consists of the Java virtual machine, the Java platform core classes and
supporting files (also known as the Java Runtime Environment or JRE) Java Tool
Kit, Documentation and Java Samples. Program Code may include soft copy
documentation, readme files, program data and such like.


You may only use the Program Code if you are a current licensee of Redhat 6.0
Linux or Caldera OpenLinux 2.2 Operating systems and the Program Code may only
be used in conjunction with such products.
</example>
<p>See bug #54641 for an issue about IBM JDK. You can dowload it from
<url id="http://www.ibm.com/java/jdk/118/linux">.

<sect2>Is it possible to obtain a licence for Debian 2.1?
<p>It would still be non-free, because of item 8 in the DFSG "License Must Not Be 
Specific to Debian".

<sect1>JRE
<p>
<sect2>Can Debian distribute JRE?
<p>
(from <url id="http://www.debian.org/Lists-Archives/debian-java-9908/msg00021.html">) 
I don't think we can or want to distribute the JRE with Debian.
The supplemental license terms of the JRE has a few very nasty clauses:
<example>
 1. License to Distribute. You are granted a royalty-free right to
  reproduce and distribute the Software provided that you: (i)distribute
  the Software complete and unmodified, only as part of, and for the
  sole purpose of running, your Java applet or application ("Program")
  into which the Software is incorporated;
</example>
<p>We might get away with this one since we distribute it together with
Java applications bundled with Debian. But we also do want to allow people
to download only the jre package.
<example>
  (ii) do not distribute additional software intended to replace any
  component(s) of the Software;
</example>
<p>But we cannot agree to this one. We want to distribute Kaffe, Japhar,
Classpath, Gcj, Kopi, Fastjar, etc  which are intended to replace the JRE
with a Free version. Even if we don't consider non-free part of Debian
(the JRE would not go into main :) I think we should not encourage software
that tries to prevent Free replacements.
<example>
  [...] (v) may not create, or authorize your licensees to create additional
  classes, interfaces, or subpackages that are contained in the "java" or
  "sun" packages or similar as specified by Sun in any class file naming
  convention;
</example>
<p>My example why this is a bad clause was not so good since someone pointed
out that you do not want to create something that is non standard. I do
agree that we want a standard implementation of the core classes, but I
also think that you should have the freedom to create non-standard classes.
(Or fix bugs or stupid mistakes in the standard classes.)
<example>
  [...] and(vii) agree to indemnify, hold harmless, and defend Sun and its
  licensors from and against any claims or lawsuits, including attorneys'
  fees, that arise or result from the use or distribution of the Program.
</example>
<p>And I don't think that Debian (or SPI) can or wants to do that.

<p>So I am afraid that we also cannot distribute the Sun or Blackdown JRE.
This isn't that bad since it is non-free software, but it is annoying.
As I said before please help one of the (many) Free Java projects out there
if you want to see a Free JVM, Standard Classes, Compiler, etc. in Debian.
They are far from complete but they do work for most purposes

<sect1>GPL or LGPL?
<p>
  Java uses dynamic linking at runtime. Using the reflection
  API and class loading, the linking can be completely data
  driven, specifying classes and methods by name. This moves
  the legal issues of using GPL'ed Java code into the user's
  hands, as a violation of the GPL can not be proven from the
  executable itself. Unlike plugins, Java classes do not even
  have to have a specific structure to be used in such ways.
  By using native methods and selecting DLL's at runtime,
  this problem might also affect native code.
<P>
  Example: a GPL'ed Java dependency checker using the
  reflection API. Java's runtime linkage, in particular the
  reflection API, blurrs the lines between code and data
  even more than e.g. native plugins.
<P>
  If you want to write Java code that can be used without
  the user having to worry about licensing issues, consider
  using the Lesser GPL (LPGL). If you want to avoid seeing
  your classes and packages being used by non-free software,


<chapt>Java Compilers
<p>
<sect>What Java compilers are available in Debian?
<p>
<list>
<item><package>guavac</package>. The compiler of Effective Edge Technologies. This compiler is orphaned upstream; for real work use gcj or jikes.
<item><package>tya</package>. A just-in-time compiler, used to compile Java to byte code.
<item><package>jikes</package>. Reported to work fine with all JDKs (1.1 to 1.3), it is suggested you use -E when compiling under <prgn>Emacs</prgn>.
<item><package>bock</package>. Java to C compiler.
<item><package>gcj</package>. Compiles Java source to native code, also source to bytecode, or bytecode to native code.
<item><package>gck</package>. Is this available?
<item><prgn>kjc</prgn> is included in <prgn>kaffe</prgn> 1.0.5. There currently is no separate package.
</list>

<chapt>Java Virtual Machines (JVM)
<p>
<sect>What jvms work in Debian?

<p>Currently Blackdown's, Sun's and Ibm's jvms work in Debian.  (But,
for simple programs such as the ones used for teaching, the free kaffe
VM may be enough.  Another solution is to use gcj and to compile to
native code, thus solving the VM problem.)  

<P>All of them can be unpacked in /usr/local with links made in
/usr/local/bin. This will work in any Debian setting and version, the
only issue being is wether or not the version is glibc based or
libc5-based regarding (older versions of Debian do not have glibc
support since it was included in Debian 2.1 codename slink)


<sect>What free JVMs are available in Debian?
<p>
<list>
<item><package>kaffe</package>. Cannot run all programs, although it is alleged to run Jigsaw (a 10Mb distribution) see <url id="http://www.de.debian.org/Lists-Archives/debian-java-9911/msg00038.html">.
</list>
<sect>Are there known problems?
<p>
<list>
<item>Kaffe loops endlessly on the XML parsing.
</list>

<chapt>Java-related programs
<p>
<sect>What Java related programs are available in Debian?
<p>

<sect1>Debian 1.3.1 'bo'
<p>
<list>
<item><package>jdk 1.0.2</package>
</list>

<sect1>Debian 2.0 'hamm'
<p>
<list>
<item><package>jdk 1.1.5v5</package>
</list>

<sect1>Debian 2.1 'slink'
<p>
<list>
<item><package>jdk 1.1.5v5</package>
<item><package>vrwave</package>. A Java VRML browser.
<item><package>icq-java</package>. An installer
for the ICQJava program.
<item><package>jde</package>. A Java Development
Enviroment for Emacs <url id="http://sunsite.auc.dk/jde">.
<item><package>jlex</package>. A lexical analyser generator similar to the UNIX <prgn>lex</prgn>.
<item><package>mmake</package>. A generator of Makefiles for java
programs. More info at <url id="http://www.tildeslash.com/mmake">
<item><package>libpgjava</package>. A Java class that
enables communication with the PostgreSQL database using JDBC.
<item><package>cup</package>. A parser similar to
<prgn>yacc</prgn>.
<item><package>ilu-javadev</package>. Development
header and libraries for the Inter-Language Unification System.
</list>


<sect2>I've installed the latest jde package...what I have to do to let Emacs enter jde-mode automatically when loading a Java source file?
<p>As explained in /usr/doc/jde/README.Debian, all that is required is
putting
<tt>
 (require 'jde)
</tt>
into your <file>~/.emacs</file> file.
<p>Note that other add-on packages to Emacs are not enabled by default
either, e.g., AucTeX.

<sect1>Debian 2.2 'potato'
<p>
<list>

<item>Libraries
<list>
<item>lib-fop-java
<item>lib-gnu.getopt-java
<item>lib-gnu.regexp-java
<item>lib-openxml-java
<item>lib-rxtx-java
<item>lib-sax-java
<item>lib-xp-java
<item>lib-xslp-java
<item>lib-xt-java
<item>lib-dom-java
<item>libpgjava
<item>libgcj0
</list>


<item><package>bock</package> Bootstrap-only compiler kit for a subset of Java(tm)

<item><package>doc++</package>. A documentation system for C/C++ and Java

<item><package>fastjar</package>
a complete replacement for the jar utility
written in C under the GPL <url id="http://www.engr.orst.edu/~burnsbr/fastjar/"> (check <url id="http://www.debian.org/Lists-Archives/debian-java-9908/msg00015.html">

<item><package>java2html</package>. Highlits Java sources for WWW presentations.

<item><package>gcj</package> The GNU compiler for Java(TM).

<item><package>global</package>.Source code search and browse.

<item><package>guavac</package>. A Java compiler.

<item><package>jikes</package>. Fast Java compiler adhering to language and VM specifications

<item><package>jikes-pg</package>.Jikes Parser Generator.

<item><package>oo-browser</package>.Object Oriented (X)Emacs Class Browser.

<item><package>mmake</package>.Makefile generator for Java programs.

<item><package>cocoon</package>. A XML/XSL publishing framework servlet

<item><package>bsh</package> A Java scripting environment.
<item><package>cup</package>.  LALR parser generator for Java.
<item><package>freetds-jdbc</package>. Pure Java JDBC driver for MS
SQL and Sybase.

<item><package>gnujsp</package>.
A free implementation of Sun's Java Server Pages (JSP 1.0)

<item><package>jlex</package>.A Lex-style lexical analyser generator
for Java

<item><package>jserv</package>Java Servlet 2.0 engine with an optional Apache module

<item><package>tya</package>.JIT-compiler for Java.

<item><package>ibm-jdk1.1-installer</package>. Installer for IBM
Developer Kit for Linux, Java(TM) Technology Edition. (see <ref id="installer">).

<item><package>jdk1.1</package>.JDK 1.1.x (Java Development Kit) -
Runtime only

<item><package>jdk1.1-dev</package> JDK 1.1.x (Java Development Kit)

<item><package> biss-awt</package>  a Java GUI application programming framework.

<item><package>jdk1.1-native</package>.JDK 1.1.x Runtime - native threads extensions

<item><package>jdk1.1-native-dev</package>.  JDK 1.1.x - native threads extensions.

<item><package>vrwave</package>.VRML 2.0 java-based browser

</list>

<p>Also many editors (jed, elvis, vim, emacs, fte, xcoral,zed ....) have
support for Java syntax.

<sect1>Debian 3.0 'woody'

<p>FIXME Content missing

<list>
<item>runtime environments
<list>
<item>Sun's JDK 1.1.8
<item>IBM 's JDK 1.1.8 (installer package)
</list>
</list>

<sect1>Does swing based programs work?

<p>Swing does work and can be installed, please note that 1.2 and 1.3
jvms include swing, otherwise you need to download it for your
particular jvm. See later on <ref id="swing-run"> how to make it work.


<sect1>Is there a a free javadoc implementation?  

<p>You might take a look at <url
id="http://www.zib.de/Visual/software/doc++/">, it is package for
Debian, in packages <package>doc++</package> and
<package>doc++-doc</package> (documentation).


<sect>Making packages for Java progams.
<p>

<sect1>Can the package go to main?
<p>
Since there is not yet a free Java environment in Debian, the
dependance on any package to JDK avoids any Java program to be in
<file>main</file> even if it uses a free license, the program should
be moved to <file>contrib</file>. <em>But</em> if you can sucessfully
demonstrate that your program can compile and work with free tools it
can be moved to <file>main</file>.

<sect1>What virtual packages could I use?
<p>
<list>
<item><package>java-common</package>. It is the Mother Of All Java
Packages, in the proposed policy. It contains the text of the Policy
(Docbook), as well as utilities
scripts (for instance to build a CLASSPATH from a list of jars
(submissions welcome).
<item><package>java-virtual-machine</package>
<item><package>java-compiler</package>
<item><package>java-compiler-dummy</package>.It is a small tool useful for the transition to the new Policy. Until all 
compilers comply with the Policy, java-compiler-dummy provides the following 
services:
<list>
<item>Provides: java-compiler so upper packages are happy,
<item>set CLASSPATH before calling the real compiler.
</list>
<item><package>java-virtual-machine-dummy</package>.It is a small tool
useful for the transition to the new Policy. Until all virtual machines
comply with the Policy, java-virtual-machine-dummy provides the following
services:
<list>
<item>Provides: java-virtual-machine so upper packages are happy,
<item>set CLASSPATH before calling the real VM.
</list>

</list>


<sect>Installer packages
<p>
<sect1 id="installer">What Java programs have an installer?
<p>
<list>
<item><prgn>vajava</prgn> is a visual IDE for Java. You can find it in <url id="http://software.ibm.com/ad/vajava">.<em>TODO: check copyright</em>. The installer can be found at <url id="http://www.dat.etsit.upm.es/~jfs/debian/vajava">.

<item><prgn>ibm-jdk1.1</prgn>. Installer for IBM Developer Kit for
Linux, Java(TM) Technology Edition. It will install an alpha version
1.1.6 of the IBM Developer Kit.  The IBM Developer Kit is a
development environment for writing applets and applications that
conform to the Java 1.1 Core API.  Its compiler and other tools are
run from a shell and have no GUI interface.
<p>
The IBM Developer Kit includes the IBM JIT (libjitc.so) which is used by
all tools by default. Look for it in <url id="http://master.debian.org/~doko">. Needs to be upgraded to 1.1.8. However it seems that providing an installer might break their license (see <ref id="ibm-jdk1.1">)

<item><prgn>jdk1.2-installer</prgn>. Look for it in <url
id="http://www.pobox.com/~julio/debian/jdk1.2-installer/">. This one
works for the pre-release version, a little work is needed in order to
install the release candidate version. (Update, April 2000, the link seems
to be broken, anyone has one?)


</list>


<sect1>What Java programs could I develop an installer to?
<p>
<list>
<item><prgn>jdk-1.2.2</prgn> SE  Standard Edition
  <url id="http://www.javasoft.com/products/jdk/1.2/download-linux.html">.

<item><prgn>jbuilder3</prgn>. A Java IDE from Inprise (written in
java) <url
id="ftp://ftp.inprise.com/pub/jbuilder/jb3foundation/sol_linux/">.
Works well.
 
<item><prgn>netbeans</prgn>. Another Java IDE (also written in java) <url id="http://www.netbeans.com/"> for writing bean based GUI apps.  
</list>

<chapt>Java servlets
<p>
<sect>How can I make Java servlets work?
<p>You can use:
<list>
<item>GNUJSP
<item>Apache Jserv. <url id="http://java.apache.org/jserv/index.html">.
</list>
Also others not yet packaged for Debian but which migh be soon included are:
<list>
<item>tomcat from <url id="://jakarta.apache.org/tomcat/">.
<item>jigsaw from <url id="http://www.w3.org/Jigsaw/">.
<item>Jetty <url id="http://mortbay.com/software/Jetty.html"> (tested
successfully on a potato machine)

</list>


<sect>Do servlets work with kaffe?
<p>The <file>servlet.jar</file> in Kaffe will not work. It is only a shell.
There is another LGPL implementation that was written by Paul 
and Mark Wielaard. It is available at <url
id="http://www.euronet.nl/~pauls/java/servlet"> these will have (have been?)
added Apache JServ package so the user doesn't have
to download Sun's classes any longer.

<sect>Do I need non-free Java in order to run servlets?
<P>Not known. Possibly not, need to explain.

<chapt>Java policy
<p>
<sect>Is there a Java policy for Debian?
<p>
It is still in the works. The current policy addresses <em>some</em>
of the problems. It has not been officially released. You can find
it in <url id="http://www.debian.org/~bortz/Java/policy.html">.

<sect>Are there Holes in the Java Policy?
<p>Yes, some until under discussion. Thus it is <em>very</em> inconvenient to
use serveral compilers of virtual machines since there is not one
CLASSPATH setting for all.

<chapt>Running Java in Debian
<p>
<sect>Do it yourself

<p>If the releases provided aren't recent enough
for you, you can of course install the file from
the Blackdown mirrors. You can either use the Debian packages
provided by Blackdown or download their tar files.

<p>(contributed by Federico Mennite) If you want to use their packages, add
the following line to your <file>/etc/apt/sources.list</file> (use potato
or woody depending on the Debian release you are running):

<example>
deb -mirror-debian potato non-free
deb -mirror-debian woody non-free
</example>

Where <em>-mirror-</em> is one from the list available at
<url id="http://www.blackdown.org/java-linux/mirrors.html">. And then
do:
<example>
$ apt-get update
$ apt-get install j2sdk1.3
</example>


<p>(contributed by Paul Reavis) If you download and install the JDK tar.gz files, 
unpack them into /usr/local/jdk1.1.x, and use symlinks to create a /usr/local/jdk and
link in binaries to /usr/local/bin or whatever. It is not at all
difficult to install these. However, you can get segfaults under some
conditions depending on your libraries.

<p>Here is a list of releases that are known to work under each Debian
release, and what other software needed, if any, to make it happen.

<list>
<item>rex/bo: 1.1.5v7 (libc5).
<item>hamm:1.1.5v7 (glibc), also needed latest glibc from slink.
<item>slink: 1.1.6-test2 (glibc).
</list>

<sect id="swing-run">Making swing work in Debian


<p>(from Paul Reavis) [A quickie on getting Swing working under Debian
or any Linux really]

<p>Yes, it does work with the linux JDK; Swing is 100% Pure Java
(tm)(c)(SFD) and therefore should run under any compliant JVM. Paul
Reavis reported converting a commercial app (350+ classes) over to a
fully-Swing GUI; I've had no problems so far.

<p>If you are using jdk 1.1.3 ore below, all you need are the class
files. So, the easiest thing to do is grab the solaris distribution,
in tar.Z format, from javasoft. Depending on phase of moon, they
either call it swing or JFC 1.1 (to distinguish from 1.2, which is
part of Java 1.2). The current version is Swing 1.0.2 (not to be
confused with Java 1.0.2!). If you are using jdk 1.2.2 do not download
Swing (it is already integrated in the jdk).

<p>I don't have the archive handy here, so we'll pretend it's named
swing.tar.Z. It is recommended you install it in /usr/local. So

<example>
        skronk# cd /usr/local
        skronk# tar xzf /tmp/swing.tar.Z
</example>

<p>Now you should have a /usr/local/swing directory. To test, make
sure your JAVA_HOME variable is set, and CLASSPATH is unset, and run
the "runnit" script in each example. To be painfully obvious, do this:

<example>
        skronk$ cd /usr/local/swing/examples/SwingSet
        skronk$ echo $JAVA_HOME
        /usr/local/jdk
        skronk$ unset CLASSPATH
        skronk$ echo $CLASSPATH

        skronk$ ./runnit
</example>

<p>Of course, your directories, shell prompt, and mileage will vary.
To use with your own applications, just add the jars you want to your
classpath.

<sect>Making Java 2 work in Debian
<p>
If you wish to use Sun's or Blackdown's jdk 1.2 in Debian download the
packages provided by Blackdown (they are available in aptable
directories) from the different mirrors available  in
<url id="http://www.blackdown.org/java-linux/mirrors.html"> (check the debian 
subdir).  Currently there are i386 packages for the Java2 SDK and RE, JAI,
Java3D and JMF.  

<P>Or you can use the following mechanism:

<list>
<item>Make a directory under /usr/local (for example /usr/local/sun).
<item> Download  the  archine into  this  directory,  then  unpack it.   A
   directory jdk1.2.2 will be created.
<item> Adjust the alternatives to work correctly:
<example>
   update-alternatives --install /usr/bin/javac javac usr/local/sun/jdk1.2.2/bin/javac 120
   update-alternatives --install /usr/bin/java Java usr/local/sun/jdk1.2.2/bin/java 120
</example>
<item> Check your alternatives with "type"
<example>
   type javac
   type java
</example>
</list>

You should have now a fully working jdk 1.2 environment, virtual machine and compiler included.

<p>You might need to change your <file>/etc/profile</file> adding:

<example>
# JDK 1.2.2 (.tar)
export CLASSPATH=.:/usr/local/sun/jdk1.2.2/lib:/usr/local/sun/jdk1.2.2/jre/lib
export JAVA_COMPILER=javacomp
export JAVA_HOME=/usr/sun/local/jdk1.2.2
export PATH=$PATH:/usr/local/sun/jdk1.2.2/bin
</example>

<p>Note: As Juergen Kreileder correctly pointed me out
 The preferred name for versions >= 1.2 is Java 2 SE (Standard Edition).
 The jdk1.3 now is called "Java2 SDK v1.3" or "J2SDK 1.3".  The jre1.3 
 now is called "Java2 RE v1.3" or "J2RE 1.3".

<sect>Is there a way, using free software, to run a Java program in Debian?
<p>
Yes there is, since the problem currently now is the jvm you can try to run applications without a jvm. How? Compiling to native code is the solution.
<sect1>How do I compile to native code?
<p>

You might be able to use <prgn>gcj</prgn> or <prgn>jikes</prgn> (both free
programs),  to compile the program.
And use <prgn>gcj</prgn> to convert bytecode to native code. The entire
sofwtare chain is free.


<sect1>Are there any successes using this approach?
<p>Most certainly, read in <url id="http://www.debian.org/Lists-Archives/debian-java-9911/msg00044.html"> how this was done for the XML parser <prgn>xp</prgn>.
<example>
ezili:~/infosystems/XML/Java> gcj --main=UnTag UnTag.java UnTagHandler.java 
/usr/share/java/repository/org/xml/sax/helpers/*.class 
/usr/share/java/repository/org/xml/sax/*.class /usr/share/java/repository/com/j
clark/xml/sax/*.class /usr/share/java/repository/com/jclark/xml/parse/*.class 
/usr/share/java/repository/com/jclark/xml/tok/*.class 
/usr/share/java/repository/com/jclark/util/*.class 
/usr/share/java/repository/com/jclark/xml/parse/base/*.class
</example>

<sect1>Are there any problems with this approach?
<p>
Yes there are also some problems.
<p><prgn>gcj</prgn> does not fully support JNI. Tom Tromey is
responsible for the JNI implementation. As of april 2000
it is missing one feature (you can't currently compile a   
.class file that uses JNI functions to implement its native methods),
but Tom is working on this and hope to have it completed "soon".
<p>Lack of JNI affects use of Classpath (e.g. as an alternative to libgcj)
as well as small, standalone apps that replace AWT with some really simple
GUI (like using curses, e.g. for small installers). It also affects projects
which have native code for performance reasons. At the moment, gcj basically
forces a CNI port. The only alternative we are aware of is TowerJ, which is
good for commercial projects, but does not offer anything to free software.

<sect1>Does these work for architectures different than i386?
<p>Possibly not, since libgcj does not build on sparc and no one has
tried this for arm.


<sect>Other Java programs not yet available on Debian
<p>
The following are programs that have not yet been packaged for Debian
nor is there an installer. There are quite a lot Java programs out
there and this list is not an exhaustive list, it only includes
programs that <em>might</em> be packaged for Debian or those that
someone is working on an installer for:
<list>
<item>BlueJ. A development environment for Java with editor, compiler,
virtual machine and debugger. See <url
id="http://bluej.monash.edu.au/">
<item>Jacob (Java Commando Base): project maintainer and visualiser
for Java in Emacs. See <url
id="http://home.pages.de/~kclee/clemens/jacob">.
<item>Emacs in Java. See <url id="http://jemacs.sourceforge.net/">.
<item>Netbeans developer, now called <em>Forte</em>. Based on the Javabeans architecture. See
<url id="http://www.netbeans.com">.Sun recently announced they would
open-source it.  See <url id="http://www.sun.com/forte/tools4dotcom/opensource.html">.
<item>AnyJ. Graphic environment to develop applications, applets and
servlets. More info in <url id="http://www.netcomputing.de">.

<item>Free Builder. A Java IDE written in Java and distributed under
the GPL <url id="http://www.freebuilder.org">.
<item>CodeGuide. <url id="http://www.omnicore.com">. Non free license, but no charges non-commercial use (CHECK).
</list>.

</book>