diff options
| author | Jing Yu <jingyu@google.com> | 2009-11-05 15:11:04 -0800 |
|---|---|---|
| committer | Jing Yu <jingyu@google.com> | 2009-11-05 15:11:04 -0800 |
| commit | df62c1c110e8532b995b23540b7e3695729c0779 (patch) | |
| tree | dbbd4cbdb50ac38011e058a2533ee4c3168b0205 /gcc-4.2.1/libjava/classpath/INSTALL | |
| parent | 8d401cf711539af5a2f78d12447341d774892618 (diff) | |
| download | toolchain_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/INSTALL | 210 |
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. |
