libjava/classpath/README

   1 GNU Classpath README - Last updated: May 15, 2006
   2
   3 GNU Classpath, Essential Libraries for Java is a project to create a
   4 free software implementation of the core class libraries for the java
   5 programming language.
   6
   7 Additionally GNU Classpath includes a sub-project called GNU Classpath
   8 Tools whose goal is to provide a number of free replacements for
   9 standard Java development tools like javadoc, javap, javah, and
  10 others.  And a sub-project called GNU Inetlib, an extension library to
  11 provide extra network protocol support (ftp, finger, gopher) for GNU
  12 Classpath, but it can also standalone to ease adding http, imap, pop3
  13 and smtp client support to applictions. These subprojects are normally
  14 released independent from the core libraries.
  15
  16 This is a development snapshot release only and is not for general
  17 purpose use.  GNU Classpath needs to be combine with a proper
  18 development environments to be useable for end users.  Eventually,
  19 these essential libraries for java will work with as many free
  20 compilers and runtimes as possible.
  21
  22 Complete development environments known to be based on GNU Classpath
  23 include (recommended for end users):
  24
  25         * GCC with GCJ  (http://gcc.gnu.org/java/)
  26         * Kaffe         (http://www.kaffe.org/)
  27
  28 Smaller environments (runtime only, no compilers, no tools) which work
  29 with this GNU Classpath releases include
  30 (tested by and recommended for GNU Classpath hackers):
  31
  32         * CACAO         (http://www.cacaojvm.org/)
  33         * JamVM         (http://jamvm.sourceforge.net/)
  34         * Jikes RVM     (http://www.ibm.com/developerworks/oss/jikesrvm/)
  35         * Kissme        (http://kissme.sourceforge.net/)
  36
  37 In general the latest releases of the above VMs will work out of the box
  38 with the latest GNU Classpath release (and in most cases directly with the
  39 development sources from CVS).
  40
  41 Besides combining GNU Classpath with the runtimes and compilers above
  42 you might want to add support for encryption libraries as provided by
  43 GNU Crypto (http://www.gnu.org/software/gnu-crypto/).
  44 And for additional extension libraries (mail, xml, activation, infobus,
  45 servlet) check out GNU ClasspathX (http://www.gnu.org/software/classpathx).
  46
  47 Some tools come with their own customized version of GNU Classpath.
  48 Please check if there is a customised version available for the tool you
  49 use before trying the bare bones GNU Classpath release. We are working with
  50 the tool creators to keep the differences between the core classes as small
  51 as possible. Please tell us if you make GNU Classpath work with a new tool.
  52
  53 Active projects which use modified versions of the Classpath libraries
  54 some of which synchronizes with the Classpath CVS head every couple of weeks:
  55
  56         * IKVM.NET      (http://www.ikvm.net/)
  57         * JC            (http://jcvm.sourceforge.net/)
  58         * JNode         (http://jnode.sourceforge.net/)
  59         * MysaifuVM     (http://www2s.biglobe.ne.jp/~dat/java/project/jvm/)
  60         * SableVM       (http://www.sablevm.org)
  61
  62 See for a more complete list of GNU Classpath based projects the
  63 GNU Classpath website: http://www.gnu.org/software/classpath/stories.html
  64
  65 See the file INSTALL for details on installing GNU Classpath.
  66 See the file NEWS for details on what is included in this release.
  67 See the file TODO for the latest to do list.
  68 See the file HACKING for working on (non-released) CVS development versions.
  69
  70 Homepage: http://www.gnu.org/software/classpath/
  71
  72 General Mailing List: classpath@gnu.org
  73   --> Bugs and patches can be reported via Savannah if you have a browser
  74       or via this address otherwise.
  75   --> To subscribe send email to classpath-request@gnu.org with a
  76       subject and body of "subscribe".  To unsubscribe do the same,
  77       only with a body and subject of "unsubscribe".  This is a
  78       smartlist managed mailing list.
  79
  80 CVS Commit, Bugs and Patches List: commit-classpath@gnu.org
  81   --> To subscribe send email to commit-classpath-request@gnu.org with a
  82       subject and body of "subscribe".  To unsubscribe do the same,
  83       only with a body and subject of "unsubscribe".  This is a
  84       smartlist managed mailing list.
  85
  86 Anonymous CVS:
  87   --> export CVS_RSH="ssh"
  88   --> cvs -z3 -d:ext:anoncvs@savannah.gnu.org:/cvsroot/classpath co classpath
  89   --> More detailed instructions available on the Savannah project website.
  90       http://savannah.gnu.org/projects/classpath/
  91
  92 Happy Hacking!