diff options
Diffstat (limited to 'libjava/classpath/doc/www.gnu.org/docs')
| -rw-r--r-- | libjava/classpath/doc/www.gnu.org/docs/.cvsignore | 1 | ||||
| -rw-r--r-- | libjava/classpath/doc/www.gnu.org/docs/Makefile | 47 | ||||
| -rw-r--r-- | libjava/classpath/doc/www.gnu.org/docs/docs.wml | 37 | ||||
| -rw-r--r-- | libjava/classpath/doc/www.gnu.org/docs/jikesrvm.wml | 100 | ||||
| -rw-r--r-- | libjava/classpath/doc/www.gnu.org/docs/orp.wml | 92 |
5 files changed, 277 insertions, 0 deletions
diff --git a/libjava/classpath/doc/www.gnu.org/docs/.cvsignore b/libjava/classpath/doc/www.gnu.org/docs/.cvsignore new file mode 100644 index 00000000000..2d19fc766d9 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/docs/.cvsignore @@ -0,0 +1 @@ +*.html diff --git a/libjava/classpath/doc/www.gnu.org/docs/Makefile b/libjava/classpath/doc/www.gnu.org/docs/Makefile new file mode 100644 index 00000000000..1b7f8ca6794 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/docs/Makefile @@ -0,0 +1,47 @@ +SUBDIRS= + +ifndef WMK + export WMK=wmk +endif +ifndef WML + export WML=wml +endif + +TEXI_SRC := $(wildcard ../../*.texinfo) +VPATH = ../.. +WML_SRC = $(patsubst ../../%, %, $(TEXI_SRC:.texinfo=.html)) $(wildcard *.wml) +WML_OBJS = $(patsubst %.wml,%.html,$(WML_SRC)) + +%.html : %.texinfo + texi2html -monolithic --ifinfo --ifhtml $< +# texi2html -monolithic $<; +# cp $< $@ +# echo '#!wml --include=..' > $@ +# sed -e 's/<HTML>/\^\#use wml::std::lang\^\#use wml::fmt::isolatin\^\#use wml::std::case global=upper\^<lang:new id=en short>\^<lang:star:slice:>\^\#include <include\/macros.wml>\^<HTML>/' -e 's/<BODY>/<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD">/' -e 's/<\/BODY>/<footer>\^<\/BODY>/' $(subst .wml,.html,$(@)) > $@.sed; +# tr "\\^" "\n" < $@.sed >> $@ +# -rm -f $(subst .wml,.html,$(@)) $@.sed + +%.html: %.wml ../include/macros.wml ../include/layout.wml + $(WML) -o $@ $< +# -rm -f $(patsubst %.wml,%.html,$<) + +.PHONY : all +all : $(WML_OBJS) subdirs + +.PHONY : clean +clean : + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE) clean";) + -rm -f *.html + -rm -f hacking.wml vmintegration.wml + +.PHONY : subdirs +subdirs : + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE)";) + +.PHONY : publish +publish : + @sh -c "if [ "$(CLASSPATH_WEBROOT)x" = x ]; then echo 'You must set CLASSPATH_WEBROOT in your environment first'; exit 1; fi" + @sh -c "if [ ! -d $(CLASSPATH_WEBROOT) ]; then echo 'You must set CLASSPATH_WEBROOT in your environment first'; exit 1; fi" + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE) publish";) + -cp -f *.html $(CLASSPATH_WEBROOT)/docs/ + diff --git a/libjava/classpath/doc/www.gnu.org/docs/docs.wml b/libjava/classpath/doc/www.gnu.org/docs/docs.wml new file mode 100644 index 00000000000..c94b7ba5e57 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/docs/docs.wml @@ -0,0 +1,37 @@ +#!wml --include=.. + +#include "include/layout.wml" + +<subject "GNU Classpath Documentation"> + +<box> +<boxtitle>Classpath::Legal Information</boxtitle> + +<boxitem> +<blockquote> + <createlink url="license.html#documentation" name="Documentation Redistribution Policy"><br/> + <createlink url="license.html" name="Copyright and License Terms"><br/> +</blockquote> + +</boxitem> + +<boxtitle>Classpath::API & Language Documentation</boxtitle> +<boxitem> +<blockquote> + <createlink url="http://developer.classpath.org/doc/" name="GNU Classpath API Specification"> +</blockquote> + +</boxitem> + +<boxtitle>Classpath::Developer's Documentation</boxtitle> + +<boxitem> +<blockquote> + <createlink url="docs/hacking.html" name="GNU Classpath Hacker's Guide"><br/> + <createlink url="docs/vmintegration.html" name="Virtual Machine Integration Guide"><br/> + <createlink url="http://developer.classpath.org/mediation/" name="GNU Classpath Wiki"><br/> +</blockquote> +</boxitem> + + +</box> diff --git a/libjava/classpath/doc/www.gnu.org/docs/jikesrvm.wml b/libjava/classpath/doc/www.gnu.org/docs/jikesrvm.wml new file mode 100644 index 00000000000..1fb3996c09f --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/docs/jikesrvm.wml @@ -0,0 +1,100 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:new id=en short> +<lang:star:slice:> + +<set-var last-modified-author="<mjw>"> + +#include <include/macros.wml> + +<header title="GNU Classpath and Jikes RVM"> +<en> +<p> +</p> + +<H4>Steps to use Jikes RVM and GNU Classpath on GNU/Linux</H4> +<OL> + <LI> + Install jikes-1.18 on your machine, if you do not already have it. + Jikes can be retrieved from <createlink url="http://oss.software.ibm.com/developerworks/opensource/jikes/" name="http://oss.software.ibm.com/developerworks/opensource/jikes/"> + </LI> + <LI> + Check out the GNU Classpath head into some directory (hereinafter + called <classpathdir>) + <UL> + <LI>CVS root for GNU Classpath is :psevser:anoncvs@subversions.gnu.org:/cvsroot/classpath</LI> + <LI>Given that root, in <classpathdir> do `cvs checkout classpath'</LI> + </UL> + </LI> + <LI> + Build and configure GNU Classpath + <UL> + <LI>Do the aclocal; autoheader; automake; autoconf thing in <classpathdir>/classpath (see HACKING for details)</LI> + <LI>Make a directory '<classpathdir>i686' (i.e. <classpathdir> now contains a 'classpath' and a 'i686')</LI> + <LI>In i686, do a '../classpath/configure --enable-jni --with-jikes'</LI> + <LI>In i686, do 'make'</LI> + </UL> + <p> + You can, of course, use your own classpath tree if you have one. + But you must make an 'i686' directory parallel to the top of your tree, + and do configure there as specified above. + </p> + </LI> + <LI>Download Jikes RVM into some directory (hereinafter <rvmroot>) + <UL> + <LI>:pserver:anoncvs@www-124.ibm.com:/usr/cvs/jikesrvm</LI> + <LI>Given that root, in <rvmroot>, do 'cvs checkout rvm'</LI> + </UL> + </LI> + <LI> + Edit <rvmroot>/rvm/config/i686-pc-linux.eb to reflect your system. + Everything should be fine, except CLASSPATH_SRC, which should become + <classpathdir> + </LI> + <LI> + Set the following environment variables (bash style below, + mutatis mutandum)<br> + <pre> + export RVM_ROOT=<rvmroot> + export RVM_HOST_CONFIG=<rvmroot>/rvm/config/i686-pc-linux.eb + export RVM_TARGET_CONFIG=<rvmroot>/rvm/config/i686-pc-linux.eb + export RVM_BUILD=<some directory that can be trashed or created> + export PATH=<rvmroot>/rvm/bin:${PATH} + </pre> + </LI> + <LI> + Build Jikes RVM + <UL> + <LI>jconfigure -D RVM_WITH_GNU_CLASSPATH=1 BaseBaseSemiSpace</LI> + <LI>cd $RVM_BUILD</LI> + <LI>./jbuild</LI> + </UL> + </LI> +</OL> + +<p> +Many variations are possible. Be warned that BaseBaseSemiSpace instructs +jconfigure to prepare a version of JikesRVM that is slow to run but quick +to build. After verifying that that works, you may want to try +FastAdaptiveSemiSpace instead (just change the last argument to jconfigure; +you will probably want to change RVM_BUILD so that the FastAdaptive image +does not destroy the BaseBase one). That will prepare a Jikes RVM version +that takes much longer to build (~25 minutes on a fast machine) but will run +programs much faster. Also be warned that you currently need rather a +lot of memory to build the FastAdaptiveSemiSpace image; recommended at least +512MB. +</p> +<p> +If you have problems, refer to specific install documentation for each +project. Thank you to Julian Dolby for providing these instructions. +</p> +<ul> +<li><createlink url="http://www-124.ibm.com/developerWorks/opensource/jikesrvm/" name="Jikes RVM"></li> +</ul> +</en> +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/docs/orp.wml b/libjava/classpath/doc/www.gnu.org/docs/orp.wml new file mode 100644 index 00000000000..b8a81eaabfc --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/docs/orp.wml @@ -0,0 +1,92 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:new id=en short> +<lang:star:slice:> + +<set-var last-modified-author="<mjw>"> + +#include <include/macros.wml> + +<header title="GNU Classpath and ORP"> +<en> +<p> +The Open Runtime Platform (<link +url="http://orp.sourceforge.net/" name="ORP">) provides a +covenient and simple platform for both using and testing GNU +Classpath. With the release of ORP 1.0.9, GNU Classpath's native +libraries are supported out of the box. +</p> + +<H4>Steps to use ORP+GNU Classpath on GNU/Linux</H4> +<p> +Example assumes ORP 1.0.9, see above. In the example, GNU Classpath sources +are in ~/src/classpath/. +</p> +<UL> + <LI>Obtain <createlink url="http://sourceforge.net/projects/orp/" + name="ORP"> from the Sourceforge project page</LI> + <OL> + <LI><tt>wget + http://prdownloads.sourceforge.net/orp/orp-1.0.9.tgz</tt></LI> + <LI><tt>tar -xzvf orp-1.0.9.tgz</tt></LI> + </OL> + <LI>On some systems you might need to apply a patch to work around + gcc compile problems</LI> + <OL> + <LI><tt>cd orp-1.0.9</tt></LI> + <LI><tt>patch -p1 < ~/src/classpath/resource/orp-1.0.9.patch</tt></LI> + </OL> + <LI>Build ORP</LI> + <OL> + <LI><tt>make NON_ORP_NATIVE_LIBS=-DNON_ORP_NATIVE_LIBS dbg</tt></LI> + </OL> +</UL> +<p> +ORP should now be built and ready, orp-1.0.9/mains/orp/Linux/dbg/orp. +</p> +<H4>Using ORP+GNU Classpath on GNU/Linux</H4> +<p> +ORP needs to load shared libraries and the class library bytecode. +The recommended method is to use the environment variable +LD_LIBRARY_PATH to provide a colon separated list of directories in +which to look for GNU Classpath's shared libraries. The example below +assumes the user built and installed GNU Classpath without modifing +the default prefix. +</p> +<UL> + <LI>Set the LD_LIBRARY_PATH variable (assumes Bash shell)</LI> + <OL> + <LI><tt>export LD_LIBRARY_PATH=/usr/local/classpath/lib/classpath</tt></LI> + </OL> +</UL> +<UL> + <LI>Set the CLASSPATH variable (ORP doesn't yet use this but it + makes the command line easier).</LI> + <OL> + <LI><tt>export CLASSPATH=/usr/local/classpath/share/classpath/:.</tt></LI> + </OL> +</UL> +<UL> + <LI>Running HelloWorld with ORP</LI> + <OL> + <LI>Create a <tt>HelloWorld.java</tt> file and compile to a class file + with <tt>jikes</tt> or <tt>gcj -C</tt></LI> + <LI><tt>orp-1.0.9/mains/orp/Linux/dbg/orp -swapjit 0 1 -classpath + $CLASSPATH HelloWorld</tt></LI> + </OL> +</UL> +<p> +ORP contains two JITs at this time. By default ORP uses a +so-called JIT 3 and for some things it appears to have more problems +than when using JIT 1. This is the reasoning behind adding the +-swapjit 0 1 argument to ORP. ORP does not have the ability at this +time to execute raw bytecode and must use one of these two JIT +compilers. +</p> +</en> +<footer> |
