aboutsummaryrefslogtreecommitdiffstats
path: root/gcc-4.2.1/libjava/classpath/INSTALL
diff options
context:
space:
mode:
authorJing Yu <jingyu@google.com>2009-11-05 15:11:04 -0800
committerJing Yu <jingyu@google.com>2009-11-05 15:11:04 -0800
commitdf62c1c110e8532b995b23540b7e3695729c0779 (patch)
treedbbd4cbdb50ac38011e058a2533ee4c3168b0205 /gcc-4.2.1/libjava/classpath/INSTALL
parent8d401cf711539af5a2f78d12447341d774892618 (diff)
downloadtoolchain_gcc-df62c1c110e8532b995b23540b7e3695729c0779.tar.gz
toolchain_gcc-df62c1c110e8532b995b23540b7e3695729c0779.tar.bz2
toolchain_gcc-df62c1c110e8532b995b23540b7e3695729c0779.zip
Check in gcc sources for prebuilt toolchains in Eclair.
Diffstat (limited to 'gcc-4.2.1/libjava/classpath/INSTALL')
-rw-r--r--gcc-4.2.1/libjava/classpath/INSTALL210
1 files changed, 210 insertions, 0 deletions
diff --git a/gcc-4.2.1/libjava/classpath/INSTALL b/gcc-4.2.1/libjava/classpath/INSTALL
new file mode 100644
index 000000000..dae909eff
--- /dev/null
+++ b/gcc-4.2.1/libjava/classpath/INSTALL
@@ -0,0 +1,210 @@
+Installing GNU Classpath - Last updated: September 7, 2005
+
+First, this is a development release only! Unless you are interested in
+active development and debugging, or just like running random alpha code,
+this release is probably not for you. Please see the README file for a
+list of VMs that work with GNU Classpath.
+
+Note that if you are building from a non-released (CVS) version of GNU
+classpath, installation instructions are found in the doc/hacking.texi
+file. Or at http://www.gnu.org/software/classpath/docs/hacking.html
+
+------------------------------------------------------------------
+Suggested Software
+------------------------------------------------------------------
+ GNU make ("gmake") is required for building Classpath.
+
+ For any build environment involving native libraries, these
+ new versions of autoconf, automake, and libtool are required
+ if changes are made that require rebuilding configure, Makefile.in,
+ aclocal.m4, or config.h.in.
+
+ - GNU autoconf 2.59+
+ - GNU automake 1.9+
+ - GNU libtool 1.5+
+
+ When working from CVS you can run the above tools by executing
+ ./autogen.sh in the source directory.
+
+ For building the Java bytecode (.class files), one of these
+ compilers are required. You can select which compiler using
+ --with-jikes, --with-gcj, --with-ecj or --with-kjc as argument to
+ configure; the present default is gcj.
+
+ - GCJ 4.0+ (part of the GNU GCC package).
+ - IBM jikes 1.19+.
+ - Eclipse Compiler for Java 3.1+
+ - The kjc compiler is supported with configure but we have
+ been unable to successfully compile with it.
+
+ IMPORTANT: Versions of GCJ which are earlier than 4.0 contain
+ bugs which make it impossible to compile the class library and
+ are *not* supported any more. If you are stuck on a system where
+ GCC 3.x is the system compiler we recommend using Jikes.
+
+ For building the gtk+ AWT peer JNI native libraries, the following
+ are required unless --disable-gtk-peer is used as an argument to
+ configure.
+
+ - GTK+ 2.8.x (or higher)
+ - gdk-pixbuf
+
+ - XTest Extension (libXtst) for GdkRobot support in java.awt.
+
+ For building gcjwebplugin you'll need the Mozilla plugin
+ support headers and libraries.
+
+ For building the Qt AWT peer JNI native libraries you have to
+ specify --enable-qt-peer and need the following library:
+
+ - Qt 4.0.1
+
+ For building the X AWT peers see information below
+ (Building and running with the X AWT peers). You will need
+ the Escher 0.2.3 library:
+ http://escher.sourceforge.net
+
+ Please note that at the moment most operating systems do not
+ ship Qt4 by default. We recommend using GNU Classpath' Qt4
+ support only for its developers and bug reporters. See
+ http://developer.classpath.org/mediation/ClasspathShowcase
+ for details on how to get it to work.
+
+ For building the xmlj JAXP implementation (disabled by default, use
+ configure --enable-xmlj) you need the following installed:
+ - The XML C library for Gnome (libxml2)
+ http://www.xmlsoft.org/
+ Minimum version of libxml2 required: 2.6.8
+
+ - The XSLT C library for Gnome (libxslt)
+ http://www.xmlsoft.org/XSLT/
+ Minimum version of libxslt required: 1.1.11
+
+ For building the documentation you will need
+
+ - texinfo 4.2 or higher.
+
+ For building the ALSA midi provider code you will need
+ ALSA. http://www.alsa-project.org.
+
+ For building the DSSI midi synthesizer provider code you will
+ need DSSI from http://dssi.sourceforge.net. This, in turn,
+ introduces many dependencies, including:
+
+ - liblo: the Lightweight OSC implementation
+ http://plugin.org.uk/liblo/
+
+ - LADSPA: Linux Audio Developer's Simple Plugin API
+ http://www.ladspa.org
+
+ - the JACK Audio Connection Kit: A low latency audio server
+ http://jackit.sourceforge.net
+
+ - libsndfile: an audio file I/O library
+ http://www.mega-nerd.com/libsndfile/
+
+ - fluidsynth: a real-time SoundFont 2 based soft-synth
+ http://www.fluidsynth.org/
+
+
+This package was designed to use the GNU standard for configuration
+and makefiles. To build and install do the following:
+
+1). Run the "configure" script to configure the package. There are
+various options you might want to pass to configure to control how the
+package is built. Consider the following options, "configure --help"
+gives a complete list.
+
+ --enable-java compile Java source default=yes
+ --enable-jni compile JNI source default=yes
+ --enable-gtk-peer compile GTK native peers default=yes
+ --enable-qt-peer compile Qt4 native peers default=no
+ --enable-default-toolkit
+ fully qualified class name of default AWT toolkit
+ default=no
+ --enable-xmlj compile native libxml/xslt library default=no
+ --enable-load-library enable to use JNI native methods default=yes
+ --enable-local-sockets enable build of local Unix sockets
+ --with-jikes to compile the class library using jikes
+ the default is to use gcj
+ --with-glibj define what to install (zip|flat|both|none)
+ default=zip
+ --with-escher=/path/to/escher
+ enable build of the X/Escher peers, with
+ the escher library at /path/to/escher, either
+ in the form of a JAR file, or a directory
+ containing the .class files of Escher.
+ --enable-Werror whether to compile C code with -Werror which turns
+ any compiler warning into a compilation failure
+ default=no
+ --with-gjdoc generate documentation using gjdoc default=no
+ --with-jay Regenerate the parsers with jay must be given the
+ path to the jay executable
+ --with-glibj-zip=ABS.PATH
+ use prebuilt glibj.zip class library
+
+For more flags run configure --help.
+
+2). Type "gmake" to build the package. There is no longer a
+dependency problem and we aim to keep it that way.
+
+3). Type "gmake install" to install everything. This may require
+being the superuser. The default install path is /usr/local/classpath
+you may change it by giving configure the --prefix=<path> option.
+
+Report bugs to classpath@gnu.org or much better via Savannah at this
+URL: http://savannah.gnu.org/support/?func=addsupport&group=classpath
+
+Happy Hacking!
+
+Once installed, GNU Classpath is ready to be used by any VM that supports
+using the official version of GNU Classpath. Simply ensure that
+/usr/local/classpath/share/classpath is in your $CLASSPATH environment
+variable. You'll also have to set your LD_LIBRARY_PATH
+variable (or similar system configuration) to include the Classpath
+native libraries in /usr/local/classpath/lib/classpath.
+
+*NOTE* All example paths assume the default prefix is used with configure.
+If you don't know what this means then the examples are correct.
+
+LD_LIBRARY_PATH=/usr/local/classpath/lib/classpath
+CLASSPATH=/usr/local/classpath/share/classpath/glibj.zip:.
+export LD_LIBRARY_PATH CLASSPATH
+
+More information about the VMs that use GNU Classpath can be found in the
+README file.
+
+------------------------------------------------------------------
+Building and running with the X AWT peers
+------------------------------------------------------------------
+
+In order build the X peers you need the Escher library version 0.2.3
+from http://escher.sourceforge.net . Unpack (and optionally build) the
+Escher library following the instructions in the downloaded
+package. Enable the build of the X peers by passing
+--with-escher=/path/to/escher to ./configure where /path/to/escher
+either points to a directory structure or JAR file containing the
+Escher classes. For Unix systems it is preferable to also build local
+socket support by passing --enable-local-sockets, which accelerates
+the network communication to the X server significantly.
+
+In this release you have to enable the X peers at runtime by
+setting the system property awt.toolkit=gnu.java.awt.peer.x.XToolkit
+by passing -Dawt.toolkit=gnu.java.awt.peer.x.XToolkit to the java
+command when running an application.
+
+------------------------------------------------------------------
+Misc. Notes
+------------------------------------------------------------------
+Compilation is accomplished using a compiler's @file syntax. For our
+part, we avoid placing make style dependencies as rules upon the
+compilation of a particular class file and leave this up to the Java
+compiler instead.
+
+The --enable-maintainer-mode option to configure currently does very
+little and shouldn't be used by ordinary developers or users anyway.
+
+On Windows machines, the native libraries do not currently build, but
+the Java bytecode library will. Gcj trunk is beginning to work under
+Cygwin. The mingw32 version of jikes cannot follow symbolic links, you
+must use a cygwin build of jikes to access this limited functionality.