X-Git-Url: http://git.megacz.com/?p=org.ibex.core.git;a=blobdiff_plain;f=README;h=92ae323d16b77851ae88b30050fdb022bebfdfd9;hp=8d202f5c48b0c58ed7c162d2a2f7d0e0838ccfca;hb=822ce1c92674de45fc53e626303a44d875dd5abb;hpb=4b148707e5045554564c33532b18d00b72cec33a diff --git a/README b/README index 8d202f5..92ae323 100644 --- a/README +++ b/README @@ -1,6 +1,6 @@ ============================================================================== XWT README - + ______________________________________________________________________________ Documentation @@ -26,17 +26,6 @@ presented below: authoritative source for how an XWT engine should behave. -- Javadoc [http://www.xwt.org/javadoc/] - - The org.xwt.* packages are all documented with javadoc. You - should start by reading the package summary for org.xwt.Main, - and work your way around from there. - -- Javasrc [http://www.xwt.org/javasrc] - - Javasrc generates a syntax-colored and hyperlinked html copy of - the XWT source code. - ______________________________________________________________________________ Directory Structure @@ -48,7 +37,9 @@ Directory Structure TM - trademark information for XWT ant - a unix shell script to launch ant bin/ - all binary stuff generated by ant builds + build.xml - ANT build file + Makefile - build file for gcc 3.3 lib/ - any third-party binary stuff needed during the build process javago - a copy of the javago post-compilation bytecode inliner @@ -58,7 +49,6 @@ Directory Structure javasrc.jar - javasrc, a tool for generating hyperlinked, syntax-colored html from java code src/ - all java source files and xwt sources go here - jazz/ - jazzlib, which XWT currently uses since libgcj's java.util.zip.* is broken org/ bouncycastle/ - the BouncyCastle Crypto Library mozilla/ - a copy of Rhino, the Mozilla JavaScript interpreter @@ -93,6 +83,10 @@ The following targets do not require that you specify a platform: ______________________________________________________________________________ Building +- WARNING: Jikes 1.16 has a bug which will cause it to generate + corrupt .class files; you must downgrade to 1.15 in order to compile + XWT. + - If you only want to build the JVM version of XWT, delete these three files: @@ -103,99 +97,12 @@ Building This will allow XWT to build correctly *without* gcc 3.1. Otherwise, you must compile and install gcc 3.1. - - The Win32 native version of XWT can ONLY be built with the very - latest pre-release of GCC 3.1. You can follow the steps below to - create a cross-compiler from linux to Win32. - - If the steps below fail, try adding "-D 20-Mar-2002" to the cvs - checkout line; 20-Mar-2002 was the last date on which the compiler - was known to work. Please don't do this unless you have attempted - without it, however, since it puts additional strain on the gcc cvs - server. - - There are also two patches at the end of this file which can be - applied to the branch -- the first fixes an inet_addr() bug on - Win32, the second enables stack traces. - - # create an install area - export CLASSPATH= - export PREFIX=/usr/local/gcc - export CC=/usr/bin/gcc - - sudo rm -rf $PREFIX - export PATH=$PATH:$PREFIX/bin - sudo mkdir $PREFIX - sudo mkdir $PREFIX/i686-pc-mingw32/ - - wget http://telia.dl.sourceforge.net/sourceforge/mingw/MinGW-1.1.tar.gz - sudo tar -C $PREFIX/i686-pc-mingw32/ -xvzf MinGW-1.1.tar.gz - - wget ftp://ftp.gnu.org/gnu/binutils/binutils-2.11.2.tar.gz - tar xzvf binutils-2.11.2.tar.gz - cd binutils-2.11.2 - ./configure --target=i686-pc-mingw32 --prefix=$PREFIX - make - sudo make install - cd .. - - cvs -d :pserver:anoncvs@subversions.gnu.org:/cvsroot/gcc co -rgcc-3_1-branch gcc - mkdir bin - cd bin - ../gcc/configure \ - --prefix=$PREFIX \ - --target=i686-pc-mingw32 \ - --host=i686-pc-linux-gnu \ - --enable-languages=c,c++,java \ - --disable-nls \ - --with-as=$PREFIX/i686-pc-mingw32/bin/as \ - --with-ld=$PREFIX/i686-pc-mingw32/bin/ld \ - --with-gnu-ld \ - --with-gnu-as \ - --enable-libgcj \ - --enable-gc-type=boehm \ - --disable-shared \ - --enable-threads=win32 \ - --disable-hash-synchronization \ - --disable-interpreter \ - --enable-sjlj-exceptions - - make - sudo make install - -- The Linux native version is still experimental. You should configure - your compiler with: - - ../gcc/configure \ - --prefix=$PREFIX \ - --enable-languages=c,c++,java \ - --disable-nls \ - --enable-libgcj \ - --enable-threads=posix \ - --enable-hash-synchronization \ - --enable-static \ - --disable-interpreter + latest pre-release of GCC 3.3. Run "make gcc-lin" to build a gcc + 3.3 that targets Linux; run "make gcc-win" to build a gcc 3.3 that + targets Win32. -______________________________________________________________________________ -Native-Code "ant" - -** THIS DOESN'T WORK YET ** - -Ant takes a long time to start up, mainly because it has to load a -JVM. If you compile ant to native code using GCJ, it will load much -more quickly. So far, this only works on Linux. - - mkdir /tmp/ant - cd /tmp/ant - jar xvf ~/xwt/lib/ant.jar - for A in `find * -name \*.properties -or -name \*.txt -or -name \*.mf` - do gcj -c --resource $A $A -o $A.o - done - CLASSPATH= gcj --main=org.apache.tools.ant.Main \ - `find . -name \*.class -or -name \*.o` -o ant - mv ant ~/xwt/ant - ______________________________________________________________________________ inet_addr patch