diff options
Diffstat (limited to 'libjava/classpath/doc/www.gnu.org')
56 files changed, 7386 insertions, 0 deletions
diff --git a/libjava/classpath/doc/www.gnu.org/.cvsignore b/libjava/classpath/doc/www.gnu.org/.cvsignore new file mode 100644 index 00000000000..2d19fc766d9 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/.cvsignore @@ -0,0 +1 @@ +*.html diff --git a/libjava/classpath/doc/www.gnu.org/Makefile b/libjava/classpath/doc/www.gnu.org/Makefile new file mode 100644 index 00000000000..2724a1810ed --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/Makefile @@ -0,0 +1,46 @@ +SUBDIRS := announce downloads docs faq events cp-tools + +ifndef WMK + export WMK=wmk +endif +ifndef WML + export WML=wml +endif + +WML_SRC = $(wildcard *.wml) +WML_OBJS = $(patsubst %.wml,%.html,$(WML_SRC)) + +all : $(WML_OBJS) subdirs + +%.texinfo : + cp ../$(notdir $(@)) docs + +# home and news html includes newsitems.txt so we list that here explicitly +home.html: home.wml include/macros.wml include/layout.wml newsitems.txt + $(WML) -o $@ $< +news.html: news.wml include/macros.wml include/layout.wml newsitems.txt + $(WML) -o $@ $< + +%.html: %.wml include/macros.wml include/layout.wml + $(WML) -o $@ $< + +.PHONY : clean +clean : + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE) clean";) + -rm -f *.html + +.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 "mkdir -p $(CLASSPATH_WEBROOT)/$(dir);\ + cd $(dir) && $(MAKE) publish";) + -cp -f *.html $(CLASSPATH_WEBROOT) + -cp -f *.css $(CLASSPATH_WEBROOT) + # -cp -f *.jpg $(CLASSPATH_WEBROOT) + diff --git a/libjava/classpath/doc/www.gnu.org/README b/libjava/classpath/doc/www.gnu.org/README new file mode 100644 index 00000000000..beb8d637d3b --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/README @@ -0,0 +1,109 @@ +All HTML files are generated from WML source. + +If you wish to generate/view the HTML files locally, you'll need to +have wml and texi2html installed. To make the HTML files, just +type "make". + + +Quick and dirty "How To" + +How to create a webpage: + +1. When working in a subdirectory, begin the page with: + #!wml --include=.. + +2. Add: + #include "include/layout.wml" + +3. Add <subject "page title"> + + this will set the page title to: + "page title - GNU Project -Free Software Foundation (FSF)" + +4. Write your contents. Use the following pattern: + + <box> + <boxtitle>...section title...</boxtitle> + <boxitem>...section contents...</boxitem> + + <boxtitle>...section title...</boxtitle> + <boxitem>...section contents...</boxitem> + </box> + +5. To change the menu entries, edit include/layout.wml + +6. Call make to build the pages. + +7. Set "CLASSPATH_WEBROOT" to a directory before calling "make publish" + to deploy the pages locally + +A few useful tags (defined in layout.wml) + +* <createlink name="name" url="url> + +creates a <a href="url">name</a> entry + +Some pages define their own tags (e.g. faq.wml, tools.wml, downloads.wml) +to organize their content. + + +Guide to the custom-defined tags +-------------------------------- + +Links + Description: + creates a <a href="url">name</a> entry; if name is missing, uses the url + as name + Availability: + everywhere (defined in macros.wml) + Format: + <createlink name="name" url="url> + <createlink url="url> + +Commented code + Description: + creates a commented code example + Availability: + everywhere (defined in macros.wml) + Format: + <commented-code> + <code-line code="1st code-line">comment to 1st line of code</code-line> + <code-line code="2nd code-line">comment to 2nd line of code</code-line> + <code-line code="3rd code-line" /> + </commented-code> + + +FAQ-Lists + + <faq-section name="section name"> + <faq question="1st question"> + 1st answer + </faq> + <faq question="2nd question"> + 2nd answer + </faq> + </faq-section> + <faq-section name="section name"> + <faq question="1st question"> + 1st answer + </faq> + </faq-section> + +Project Tables + Description: + Define a project in a project table + Example: + stories.wml + Availability: + everywhere (defined in macros.wml) + Format: + <project-list> + <project name="proj name" url="proj url"> + project description + </project> + <project name="proj name" url="proj url"> + project description + </project> + </project-list> + + diff --git a/libjava/classpath/doc/www.gnu.org/announce/.cvsignore b/libjava/classpath/doc/www.gnu.org/announce/.cvsignore new file mode 100644 index 00000000000..2d19fc766d9 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/.cvsignore @@ -0,0 +1 @@ +*.html diff --git a/libjava/classpath/doc/www.gnu.org/announce/19990206.txt b/libjava/classpath/doc/www.gnu.org/announce/19990206.txt new file mode 100644 index 00000000000..8dc63057801 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/19990206.txt @@ -0,0 +1,64 @@ +I am pleased to announce the first development release of GNU Classpath, +a project to create a free software replacement for Sun's proprietary +Java class libraries. The project is initially providing class library +support for the Japhar JVM. + +Here are the answers to some questions you might have about this project +and this release. + +1). Where can I get it? + +GNU Classpath 0.00 can be downloaded from: + +ftp://alpha.gnu.ai.mit.edu/pub/gnu/classpath-0.00.tar.gz + +2). What is included? + +The following java packages are supported: + -- java.beans + -- java.io + -- java.lang + -- java.lang.reflect + -- java.math + -- java.net + -- java.security (partial and non-functioning) + -- java.security.acl + -- java.security.interfaces + -- java.util + +This is enough to run many non-awt programs. Not all classes and methods +are implemented in this release, but most are. The major missing piece +of core functionality is java.text. Many of the implemented classes are +already up to the Java 1.2 spec. + +3). What is required to build/install/run? + +GNU Classpath requires that Japhar 0.07 be installed. Information on +obtaining Japhar is available from http://www.japhar.org/. A working +C compiler is also required. You will need the Sun JDK installed if you +elect to recompile the Java classes. + +4). What platforms are supported? + +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. + +5). Who should use this software? + +This is a development release only. You should only install it if you +are interested in Classpath development or reporting bugs. We appreciate +both. You might also be interested if you enjoy installing random alpha +software. + +6). Where do I go for more information? + +The project has a web page at + +http://www.classpath.org/ + +and + +http://www.gnu.org/software/classpath/classpath.html + +Information on our mailing list is available at the web site. + diff --git a/libjava/classpath/doc/www.gnu.org/announce/19990206.wml b/libjava/classpath/doc/www.gnu.org/announce/19990206.wml new file mode 100644 index 00000000000..9b541f8fcc8 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/19990206.wml @@ -0,0 +1,130 @@ +#!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="cbj"> + +#include <include/macros.wml> + +<header title="<en>GNU Classpath Annoucement (1999-02-06)</en>"> + +<p> +<en> +I am pleased to announce the first development release of GNU Classpath, +a project to create a free software replacement for Sun's proprietary +Java class libraries. The project is initially providing class library +support for the Japhar JVM. +</en> +</p> +<p> +<en> +Here are the answers to some questions you might have about this project +and this release. +</en> +</p> +<p> +<en> +1). Where can I get it? +</en> +</p> +<p> +<en> +GNU Classpath 0.00 can be downloaded from: +<createlink url="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.00.tar.gz" + name="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.00.tar.gz"> +</en> +</p> +<p> +<en> +2). What is included? +</en> +</p> +<p> +<en> +The following java packages are supported: +</en> +</p> +<UL> + <LI>java.beans</LI> + <LI>java.io</LI> + <LI>java.lang</LI> + <LI>java.lang.reflect</LI> + <LI>java.math</LI> + <LI>java.net</LI> + <LI>java.security (partial and non-functioning)</LI> + <LI>java.security.acl</LI> + <LI>java.security.interfaces</LI> + <LI>java.util</LI> +</UL> +<p> +<en> +This is enough to run many non-awt programs. Not all classes and methods +are implemented in this release, but most are. The major missing piece +of core functionality is java.text. Many of the implemented classes are +already up to the Java 1.2 spec. +</en> +</p> +<p> +<en> +3). What is required to build/install/run? +</en> +</p> +<p> +<en> +GNU Classpath requires that Japhar 0.07 be installed. Information on +obtaining Japhar is available from <createlink url="http://www.hungry.com/old-hungry/products/japhar/" +name="http://www.hungry.com/old-hungry/products/japhar/">. A working C compiler is also required. You +will need the Sun JDK installed if you elect to recompile the Java +classes. +</en> +</p> +<p> +<en> +4). What platforms are supported? +</en> +</p> +<p> +<en> +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. +</en> +</p> +<p> +<en> +5). Who should use this software? +</en> +</p> +<p> +<en> +This is a development release only. You should only install it if you +are interested in Classpath development or reporting bugs. We appreciate +both. You might also be interested if you enjoy installing random alpha +software. +</en> +</p> +<p> +<en> +6). Where do I go for more information? +</en> +</p> +<p> +<en> +The project has a web page at +<createlink url="http://www.classpath.org/" name="http://www.classpath.org/"> + +and + +<createlink url="http://www.gnu.org/software/classpath/classpath.html" + name="http://www.gnu.org/software/classpath/classpath.html"> + +Information on our mailing list is available at the web site. +</en> +</p> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20001120.wml b/libjava/classpath/doc/www.gnu.org/announce/20001120.wml new file mode 100644 index 00000000000..eeff38d698b --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20001120.wml @@ -0,0 +1,137 @@ +#!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="cbj"> + +#include <include/macros.wml> + +<header title="<en>GNU Classpath Annoucement (2000-11-20)</en>"> + +<p> +<en> +I am pleased to announce a new development release of GNU Classpath, +a project to create a free software replacement for Sun's proprietary +Java class libraries. The project is initially providing class library +support for the Japhar JVM. There are a few other JVMs which have taken +the project libraries and used them in their own projects as well. +</en> +</p> +<p> +<en> +Here are the answers to some questions you might have about this project +and this release. +</en> +</p> +<p> +<en> +1). Where can I get it? +</en> +</p> +<p> +<en> +GNU Classpath 0.01 can be downloaded from: + +<createlink url="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.01.tar.gz" + name="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.01.tar.gz"> +</en> +</p> +<p> +<en> +2). What is included? +</en> +</p> +<p> +<en> +The following java packages are supported: +</en> +</p> +<UL> + <LI>java.beans</LI> + <LI>java.io</LI> + <LI>java.lang</LI> + <LI>java.lang.reflect</LI> + <LI>java.math</LI> + <LI>java.net</LI> + <LI>java.security (partial and non-functioning)</LI> + <LI>java.security.acl</LI> + <LI>java.security.interfaces</LI> + <LI>java.util</LI> +</UL> +<p> +<en> +This is enough to run many non-awt programs. Not all classes and +methods are implemented in this release, but most are. Many of the +implemented classes are already up to the Java 1.2 spec. +</en> +</p> +<p> +<en> +3). What is required to build/install/run? +</en> +</p> +<p> +<en> +GNU Classpath requires that Japhar 0.09 be installed. Information on +obtaining Japhar is available from <createlink url="http://www.hungry.com/old-hungry/products/japhar/" +name="http://www.hungry.com/old-hungry/products/japhar/">. A working C compiler is also required. You +will need IBM's Jikes Java compiler installed if you elect to +recompile the Java classes and Sun's 1.1.8 JDK javah installed to +create native header files. RPMs compatible with Red Hat 7 have been +created of Japhar, NSPR, a cross platform thread library Japhar uses, +and GNU Classpath. Installing onto a Gnome workstation should +provide the rest of the required libraries automatically. Otherwise, +you may need to install libart and other packages detailed more +precisely in the HACKING file. +</en> +</p> +<p> +<en> +4). What platforms are supported? +</en> +</p> +<p> +<en> +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. +</en> +<p> +<p> +<en> +5). Who should use this software? +</en> +</p> +<p> +<en> +This is a development release only. You should only install it if you +are interested in Classpath development or reporting bugs. We appreciate +both. You might also be interested if you enjoy installing random alpha +software. +</en> +</p> +<p> +<en> +6). Where do I go for more information? +</en> +</p> +<p> +<en> +The project has a web page at + +<createlink url="http://www.classpath.org/" name="http://www.classpath.org/"> + +and + +<createlink url="http://www.gnu.org/software/classpath/classpath.html" + name="http://www.gnu.org/software/classpath/classpath.html"> + +Information on our mailing list is available at the web site. +</en> +</p> +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20010106.wml b/libjava/classpath/doc/www.gnu.org/announce/20010106.wml new file mode 100644 index 00000000000..7f07400e360 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20010106.wml @@ -0,0 +1,141 @@ +#!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="cbj"> + +#include <include/macros.wml> + +<header title="<en>GNU Classpath Annoucement (2001-01-05)</en>"> + +<p> +<en> +I am pleased to announce a new development +release of GNU Classpath, a project to create a free software +replacement for Sun's proprietary Java class libraries. The project +is initially providing class library support for the Japhar JVM, but +will soon provide out of the box support SableVM, Intel's ORP, and +Kaffe. The major improvements for this release are the addition of a +correct security policy file and exception stack traces are now +printed when using Japhar. +</en> +</p> +<p> +<en> +Here are the answers to some questions you might have about this project +and this release. +</en> +</p> +<p> +<en> +1). Where can I get it? +</en> +</p> +<p> +<en> +GNU Classpath 0.02 can be downloaded from: + +<createlink url="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.02.tar.gz" + name="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.02.tar.gz"> +</en> +</p> +<p> +<en> +2). What is included? +</en> +</p> +<p> +<en> +The following java packages are supported: +</en> +</p> +<UL> + <LI>java.beans</LI> + <LI>java.io</LI> + <LI>java.lang</LI> + <LI>java.lang.reflect</LI> + <LI>java.math</LI> + <LI>java.net</LI> + <LI>java.security (partially functioning)</LI> + <LI>java.security.acl</LI> + <LI>java.security.interfaces</LI> + <LI>java.util</LI> +</UL> +<p> +<en> +This is enough to run many non-awt programs. Not all classes and +methods are implemented in this release, but most are. Many of the +implemented classes are already up to the Java 1.2 spec. +</en> +</p> +<p> +<en> +3). What is required to build/install/run? +</en> +</p> +<p> +<en> +GNU Classpath requires that Japhar 0.09 be installed along with a +single patch to Japhar 0.09 included with the release. Information on +obtaining Japhar is available from <createlink url="http://www.hungry.com/old-hungry/products/japhar/" +name="http://www.hungry.com/old-hungry/products/japhar/">. A working C compiler is also required. You +will need IBM's Jikes Java compiler installed if you elect to +recompile the Java classes and Sun's 1.1.8 JDK javah installed to +create native header files. RPMs compatible with Red Hat 7 have been +created of Japhar, NSPR, a cross platform thread library Japhar uses, +and GNU Classpath. Installing onto a Gnome workstation should provide +the rest of the required libraries automatically. Otherwise, you may +need to install libart and other packages detailed more precisely in +the HACKING file. +</en> +</p> +<p> +<en> +4). What platforms are supported? +</en> +</p> +<p> +<en> +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. +</en> +</p> +<p> +<en> +5). Who should use this software? +</en> +</p> +<p> +<en> +This is a development release only. You should only install it if you +are interested in Classpath development or reporting bugs. We appreciate +both. You might also be interested if you enjoy installing random alpha +software. +</en> +</p> +<p> +<en> +6). Where do I go for more information? +</en> +</p> +<p> +<en> +The project has a web page at + +<createlink url="http://www.classpath.org/" name="http://www.classpath.org/"> + +and + +<createlink url="http://www.gnu.org/software/classpath/classpath.html" + name="http://www.gnu.org/software/classpath/classpath.html"> + +Information on our mailing list is available at the web site. +</en> +</p> +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20020208.wml b/libjava/classpath/doc/www.gnu.org/announce/20020208.wml new file mode 100644 index 00000000000..471d2a083e7 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20020208.wml @@ -0,0 +1,166 @@ +#!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="<en>GNU Classpath 0.03 Announcement (2002-02-08)</en>"> + +<p> +<en> +We are pleased to announce a new development release of GNU Classpath. +GNU Classpath, Essential Libraries for Java, is a project to create free +core class libraries for use with virtual machines and compilers for the +Java language. +</en> +</p> +<p> +<en> +New in this release are the addition of java.util.zip and java.rmi +packages, VM independent jni.h, more flexible build environment to +separate class and native code generation, out of the box support for +the ORP VM, and lots of bug fixes and updates to make GNU Classpath more +compliant with the 1.2, 1.3 and 1.4 API specification. The copyleft +has been clarified and all code in the library is now distributed under +the same terms. +</en> +</p> +<p> +<en> +Here are the answers to some questions you might have about this project +and this release. +</en> +</p> +<p> +<en> +1). Where can I get it? +</en> +</p> +<p> +<en> +GNU Classpath 0.03 can be downloaded from: + +<createlink url="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.03.tar.gz" + name="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.03.tar.gz"> +</en> +</p> +<p> +<en> +2). What is included? +</en> +</p> +<p> +<en> +The following packages (some with subpackages) are supported: +</en> +</p> +<UL> + <LI>java.applet (untested)</LI> + <LI>java.awt (very experimental)</LI> + <LI>java.beans</LI> + <LI>java.io</LI> + <LI>java.lang</LI> + <LI>java.math</LI> + <LI>java.net</LI> + <LI>java.rmi</LI> + <LI>java.security (partially functioning)</LI> + <LI>java.sql</LI> + <LI>java.text (untested)</LI> + <LI>java.util</LI> + <LI>java.util.jar</LI> + <LI>java.util.zip</LI> +</UL> +<p> +<en> +This is enough to run many non-awt programs. Not all classes and +methods are implemented in this release, but most are. Many of the +implemented classes are already up to the 1.2 API spec. Some are +already compliant with the 1.3 and (preliminary) 1.4 API specification. + +More information on the current status of each package can be found at +<createlink url="http://www.gnu.org/software/classpath/status.html" + name="http://www.gnu.org/software/classpath/status.html"> +</en> +</p> +<p> +<en> +3). What is required to build/install/run? +</en> +</p> +<p> +<en> +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development libraries +(gtk+, libart and gdk-pixbuf). More information on the precise version +numbers for the tools and libraries can be found in the INSTALL file. +</en> +</p> +<p> +<en> +4). What platforms and VMs are supported? +</en> +</p> +<p> +<en> +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. +</en> +</p> +<p> +<en> +This release support ORP 1.0.9 out of the box. But other compilers and +virtual machines such as gcj, Kissme, SableVM, Jupiter and Jaos also work +with slightly customized versions of GNU Classpath. Please check if there +is a customized version available for the VM you use before trying the bare +bones GNU Classpath release. We are working with the VM creators to keep +the differences between the core classes as small as possible. +</en> +</p> +<p> +<en> +5). Who should use this software? +</en> +</p> +<p> +<en> +Although it is already capable of supporting many Java applications, +this is a development release. As such, there are still many unfinished +components, and some problems are to be expected. You should install it +if you are interested in Classpath development or reporting bugs. We +appreciate both. +</en> +</p> +<p> +<en> +6). Where do I go for more information? +</en> +</p> +<p> +<en> +The project home page with information on our mailing list can be found at + +<createlink url="http://www.classpath.org/" name="http://www.classpath.org/"> + +or + +<createlink url="http://www.gnu.org/software/classpath/classpath.html" + name="http://www.gnu.org/software/classpath/classpath.html"> +</en> +</p> +<p> +<en> +The bug database, CVS, task-manager and latest news can be found on Savannah at +<createlink url="http://savannah.gnu.org/projects/classpath/" + name="http://savannah.gnu.org/projects/classpath/"> +</en> +</p> +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20040313.wml b/libjava/classpath/doc/www.gnu.org/announce/20040313.wml new file mode 100755 index 00000000000..71b12138a0e --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20040313.wml @@ -0,0 +1,108 @@ +#!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="prr"> + +#include <include/macros.wml> + +<header title="<en>GNU Classpath 0.08 Announcement (2004-03-15)</en>"> +<pre> +We are pleased to announce a new development release of GNU Classpath. + +GNU Classpath, Essential Libraries for Java, is a project to create free +core class libraries for use with virtual machines and compilers for the +java programming language. + +GNU Classpath 0.08 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.08.tar.gz<br> +MD5sum: 17f200744c31f36fdbe15347745562fb + +New in GNU Classpath 0.08: + +* java.util.regexp implementation through gnu.regexp wrappers. +* java.net.URI implementation. +* Working implementation of javax.swing.undo. +* java.awt.geom.CubicCurve2D/QuadCurve2D: Can now solve cubic and + quadratic equations; implementation adapted from the GNU Scientific + Library. +* Lots of java.awt and gtk+ peer improvements. Also more Swing work. + Start of EmbeddedWindow support. +* BufferedReader speed improvements. +* Improved useabilty of java.text implementation for several + applications. +* ObjectInputStream is much faster and more compatible with other + implementations. +* Fix handling of alias methods, where a method has been deprecated in + favour of a new one with the same funtion but a different name. + (See Deprecated Methods section in the GNU Classpath Hacking Guide.) +* javax.print.attribute.standard added. +* Lots of java.nio, java.net, java.io fixes and updates. +* Depend on autoconf 2.59+ and automake 1.7+, GCJ 3.3+, jikes 1.18+. + +VM Interface changes: +* Split native methods in java.lang.Runtime into java.lang.VMRuntime. +* Resources are now also loaded/needed through the bootstrap classloader + (gnu.regexp needs MessageBundle included in glibj.zip + +Fixed Classpath bugs: + #6095 java.awt.geom.QuadCurve2D.solveQuadratic sometimes gives + wrong results + #7099 EventListenerList.getListenerCount should accept null argument + #7104 EventListenerList.add does not work + #7105 EventListenerList.remove does not work + #7107 DefaultBoundedRangeModel.setValue and friends should not throw + And lots more. + +Here are answers to some questions you might have about this project and +this release. + +1). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +A list of virtual machines and compilers known to work with GNU +Classpath can be found at our website: +http://www.gnu.org/software/classpath/stories.htm + +2). What platforms are supported? + +GNU/Linux is the only platform that has been tested. +We plan to eventually support many others. + +3). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +A good overview of the current status can be found on the GNU Classpath +at FOSDEM'04 page which describes the last GNU Classpath hacker meeting. +It includes reports and presentations on the current status and future +plans: http://www.gnu.org/software/classpath/events/fosdem04.html + +4). Where do I go for more information? + +The project home page with information on our mailing list can be +found http://www.gnu.org/software/classpath/. +</pre> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20040502.wml b/libjava/classpath/doc/www.gnu.org/announce/20040502.wml new file mode 100755 index 00000000000..35a2cd98be2 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20040502.wml @@ -0,0 +1,133 @@ +#!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="prr"> + +#include <include/macros.wml> + +<header title="<en>GNU Classpath 0.09 Announcement (2004-05-02)</en>"> +<pre> +We are pleased to announce a new development release of GNU Classpath. + +GNU Classpath, Essential Libraries for Java, is a project to create free +core class libraries for use with virtual machines and compilers for the +java programming language. + +GNU Classpath 0.09 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.09.tar.gz +MD5sum: 1c4bcf2e6b5201c6496ba55ee8aac04d + +New in GNU Classpath 0.09: + +* Includes updated GNU JAXP version from 2004-02-01. +* Native C code is now -ansi -pedantic (C89) clean and (almost) -Wall clean. +* java.io is now implemented by delegating most tasks directly to java.nio. +* Reworked/Optimized implementations of java.nio.Buffer and subclasses. +* New javax.print, javax.print.attribute[.standard] and javax.print.event + packages and classes. +* java.text attributed iterators support. +* New javax.imageio, javax.imageio.event and javax.imageio.spi packages and + classes. +* GNU Classpath can now load service providers that are described via + META-INF/services/* resources in extension JARs. This is useful for + implementing the various APIs that are supposed to be extensible via + custom plugins. For details, please see the documentation of + gnu.classpath.ServiceFactory. + Application developers are strongly discouraged from calling glibj + internal packages. Instead, they might want invoke the newly implemented + javax.imageio.spi.ServiceRegistry.lookupProviders, which is a standard + method for loading plug-ins. +* New developers wanting to help the GNU Classpath project might want to + review the greatly expanded Hacker Guide included in the doc directory + or online at http://www.gnu.org/software/classpath/docs/hacking.html + Also the FAQ has been expanded. And when working from CVS you can now use + a simple autogen.sh script to get all autotools magic done automagically. +* New configure option --with-glibj which defines how to install the glibj + class files as zip, as flat directory files or both (zip|flat|both) + [default=zip]. When working with multiple runtimes some of which might + not support bootstrap classes in zip files the --with-glibj=both option + is recommended (this does take extra disc space). +* Two big code drops from the libgcj gui branch updating various java.awt + and javax.swing classes. +* Multiple java.net.InetAdress fixes and java.rmi fixes. +* ServerSocket.accept() now restarts listening when system call interrupted. +* Much cleanups to make standard API doc valid XHTML (not completed yet). +* A scan for unused variables and non-static invocation of static methods + turned up a couple of subtle bugs which have now all been fixed. +* The Mauve testsuite has been cleaned up considerable and lots of issues + in the GNU Classpath core class implementation have been fixed. + +VM Interface changes: + +* java.lang.Class/VMClass interface was changed. The interface now no + longer requires an instance of VMClass for each Class instance. Instead + the field vmdata in Class is now of type Object. +* GNU Classpath now assumes that JNI calls SetXField can modify final + fields. This was previously used silently for System.in/out/err and should + be considered as a feature now. +* A new VMProcess and a sample JNI C implementation are now provided to + make Runtime.exec() work out of the box on some systems. This requires + a small change to VMRuntime.exec() when a runtime wants to use it as the + default java.lang.Process implementation. +* The implementation of most of java.io through java.nio moved serveral + runtime specific I/O methods. Most methods do have a generic default native + C JNI implementation in native/jni/java-nio. +* Runtime support methods for java.io.File have been moved to VMFile which + also comes with a default JNI C implementation. +* To support the new service provider mechanism runtimes must make sure that + extension JARs are made accessible via the default context class loader. + + +Here are answers to some questions you might have about this project and +this release. + +1). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +A list of virtual machines and compilers known to work with GNU +Classpath can be found at our website: +http://www.gnu.org/software/classpath/stories.htm + +2). What platforms are supported? + +GNU/Linux is the only platform that has been tested. +We plan to eventually support many others. + +3). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +A good overview of the current status can be found on the GNU Classpath +at FOSDEM'04 page which describes the last GNU Classpath hacker meeting. +It includes reports and presentations on the current status and future +plans: http://www.gnu.org/software/classpath/events/fosdem04.html + +4). Where do I go for more information? + +The project home page with information on our mailing list can be +found http://www.gnu.org/software/classpath/. +</pre> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20040712.wml b/libjava/classpath/doc/www.gnu.org/announce/20040712.wml new file mode 100755 index 00000000000..3814a1d722b --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20040712.wml @@ -0,0 +1,159 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:star:slice:> + +<set-var last-modified-author="prr"> + +#include <include/macros.wml> + +<header title="GNU Classpath 0.10 Announcement (2004-07-09)"> +<pre> +We are pleased to announce a new development release of GNU Classpath. + +GNU Classpath, Essential Libraries for Java, is a project to create free +core class libraries for use with virtual machines and compilers for the +java programming language. + +GNU Classpath 0.10 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.10.tar.gz +MD5sum: a59a5040f9c1237dbf27bfc668919943 + +New in release 0.10 (Jul 9, 2004) + +* java.net.URL now uses application classloader to load URLStreamHandlers + and reuses URLStreamHandlers when URL is reset (but protocol isn't changed). +* java.io.File.deleteOnExit() implementation. +* java.text multiple new features and bug fixes + (only 2 out of the 1000+ java.text Mauve tests now fail). +* Better (non-black) default AWT System colors. +* AWT lists use GTK treeviews. +* Proper AWT focus management has been implemented. +* Swing menus and scrollpanes are beginning to work. +* Swing splitpanes, dialogs and internal frames were added. +* Swing repainting / double buffering was redone. +* Font management and Pango DPI conversion fixes. +* A lot of AWT imaging and event bugs have been picked out. +* More of javax.swing.text has been implemented. +* javax.swing.Timer has been reimplemented. +* java.security.AccessController has been implemented + (see runtime section). +* The default java.lang.SecurityManager now uses AccessController. +* New java.beans.Statement and Expression implementations. +* Small FileChannel implementation speed improvement for traditional + JNI based systems. +* Regenerated all included JNI header files with gcjh (3.5 CVS), + removes extra extern modifier and allows stricter compiler warning. +* More C code cleanups (-Wmissing-declarations, -Wmissing-prototypes and + -Wstring-prototypes) and jni.h fixes (a few funtion prototype fixes, + made it compilable with C++ compilers and jni.h got renamed from jni.h.in). +* Double.toString() and Float.toString() now work properly on 64-bit + PowerPC systems. +* PPC Darwin, arm, x86-64 and s/390 JNI C code compilation fixes. +* Build system refactored and removed old Japhar specific support. +* The gnu.java.awt.EmbeddedWindow class has been improved, and now + supports embedding AWT windows in other top-level X windows. + This functionality is required by gcjwebplugin. +* gcjwebplugin, an applet viewer that can be embedded into several web + browsers, has been extensively tested with this release of classpath. + (See http://www.nongnu.org/gcjwebplugin/) +* Runtime environments based on GNU Classpath 0.10 should be able to + start up Eclipse 3.0 out of the box now. + +Runtime interface Changes: + +* VMProcess.destroy() default implementation fixes. +* Fixed the "portable native sync" code; it had been broken since + Classpath release 0.06, when we upgraded to GTK+2. + Classpath's AWT peers use GTK+. GTK+ uses GLIB. GLIB by default uses + the platform's native threading model -- pthreads in most cases. + If the Java runtime doesn't use the native threading model, then you should + specify --portable-native-sync when configuring Classpath, so that GLIB will + use the Java threading primitives instead. (For a superior alternative, + see below.) +* The VM can set the system property + gnu.classpath.awt.gtk.portable.native.sync instead of using the + --portable-native-sync configure-type option. + See doc/vmintegration.texinfo for details. +* We intend that the next release of GNU Classpath will require the VM + to provide JNI 1.2. Classpath currently uses only JNI 1.1, except for + one JNI 1.2 function: GetEnv(), in the JNI Invocation API. + If this poses problems, please raise them on the classpath mailing list. +* The reference implementation of VMThread.holdsLock(Object) now has + a default implementation written in java. For efficiency and to + prevent spurious wakeups a real 'native' runtime version can be supplied. +* There is a new java.security.VMAccessController class that runtimes need + to implement to properly support SecurityManagers. The default + implementation that comes with GNU Classpath makes sure that ANY attempt + to access a protected resource is denied when a SecurityManager is + installed. Which is pretty secure, but also no very useful. + Please see the documentation in + vm/reference/java/security/VMAccessController.java, + and please give feedback on the GNU Classpath mailinglist whether or not + the current AccessController framework is flexible enough. + +Here are answers to some questions you might have about this project and +this release. + +1). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +You will also need a runtime environment. The following environments +have been tested to work out of the box with this release: + + * JamVM (http://jamvm.sourceforge.net/) + * Jikes RVM (http://www.ibm.com/developerworks/oss/jikesrvm/) + * Kissme (http://kissme.sourceforge.net/) + +For other environments that might need modified version of the current +release see the README file. A complete list of virtual machines and +compilers known to be based on GNU Classpath can be found at our +website: http://www.gnu.org/software/classpath/stories.html + +2). What platforms are supported? + +GNU/Linux is the only platform that has been tested. +We plan to eventually support many others. + +3). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +For end users we recommend to use one of the development environments +based on GNU Classpath which combine the core libraries with compilers +and other tools needed for creating applications and libraries. + + * GCC with GCJ (http://gcc.gnu.org/java/) + * Kaffe (http://www.kaffe.org/) + +4). Where do I go for more information? + +The project home page with information on our mailing list can be +found http://www.gnu.org/software/classpath/. + +A good overview of the current status can be found on the GNU Classpath +at FOSDEM'04 page which describes the last GNU Classpath hacker meeting. +It includes reports and presentations on the current status and future +plans: http://www.gnu.org/software/classpath/events/fosdem04.html +</pre> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20040913.wml b/libjava/classpath/doc/www.gnu.org/announce/20040913.wml new file mode 100755 index 00000000000..8d0ad347388 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20040913.wml @@ -0,0 +1,245 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:star:slice:> + +<set-var last-modified-author="prr"> + +#include <include/macros.wml> + +<header title="GNU Classpath 0.11 Announcement (2004-09-13)"> +<pre> +We are pleased to announce a new developer snapshot release of GNU Classpath. + +GNU Classpath, Essential Libraries for Java, is a project to create free +core class libraries for use with runtimes, compilers and tools for the +java programming language. + +GNU Classpath 0.11 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.11.tar.gz +MD5sum: fa0e0f2532b838e67f9d9f93d45556a2 + +Some highlights of this release (more extensive list below): + +Inclusion of full javax.crypto, javax.security, javax.net and +subpackages. Complete implementation of java.awt.geom. GTK+ 2.4 AWT +peer implementation for AWT FileDialog, better java.awt.image +LookupTable, Kernel and BufferedImage support. AWT 1.0 Event Model +implemented, and new Swing classes (Spring, SpringLayout, JMenu, +JPopupMenu, JColorChooser, JComboBox, JTextField, internal JFrame +support and start of JTable and JTree implementations). The Collection +classes have seen extensive documentation updates. GNU Classpath +Examples have been added - a GPL demo framework for AWT and Swing. + +Included, but not activated by default in this release is a Graphics2D +implementation based on the Cairo Graphics framework +(http://www.cairographics.org). Enabling this makes programs like +JFreeChart work on GNU Classpath based runtimes. + +[It is recommended that people wanting to experiment with the +Graphics2D implementation follow the instructions for building gcj +with jhbuild which automatically builds the latest CVS version of GCJ +and Cairo at http://people.redhat.com/fitzsim/gcj-and-jhbuild.html] + +Not yet included is an implementation of Generic collection classes +and classes for other 1.5 language extensions. Work on this is being +done on a special development branch that will be included in a future +GNU Classpath release when free runtimes, compilers and tools have all +been upgraded to support these new language features. + +GNU Classpath uses the Mauve test suite for Compatibility, Completeness +and Correctness checking. This release passes 16816 of 17102 mauve tests. +Free Software programs and libraries tested against this release are +Ant, Eclipse 2.1, Eclipse 3.0 (starts up, but does not yet completely +run), JFreeChart (see above), the Nice programming language +environment (which can now be bootstrapped with any GNU Classpath +based runtime and which works out of the box with Kaffe and GCJ for +creating native executables), gcjwebplugin and many other programs, +libraries and applets. + +Here are answers to some questions you might have about this project and +this release. + +1). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +For end users we recommend to use one of the development environments +based on GNU Classpath which combine the core libraries with compilers +and other tools needed for creating applications and libraries. + + * GCC with GCJ (http://gcc.gnu.org/java/) + * Kaffe (http://www.kaffe.org/) + +2). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +You will also need a runtime environment. The following runtime +environments should work out of the box with GNU Classpath + + * JamVM (http://jamvm.sourceforge.net/) + * Jikes RVM (http://www.ibm.com/developerworks/oss/jikesrvm/) + * Kissme (http://kissme.sourceforge.net/) + +Note that these are just byte code execution runtimes. For development +of programs written in the java programming language you will also +need compilers and other tools for creating libraries and/or +executables (see question 1). + +For other environments that might need modified version of the current +release see the README file. A complete list of virtual machines and +compilers known to be based on GNU Classpath can be found at our +website: http://www.gnu.org/software/classpath/stories.html + +2). What platforms are supported? + +GNU/Linux and FreeBSD on x86 and powerpc are regularly tested by the +developers. We plan to eventually support many others. + +5). Where do I go for more information? + +The project home page with information on our mailing list can be +found at http://www.gnu.org/software/classpath/ + +A good overview of the current status can be found on the GNU Classpath +at FOSDEM'04 page which describes the last GNU Classpath hacker meeting. +It includes reports and presentations on the current status and future +plans: http://www.gnu.org/software/classpath/events/fosdem04.html + +The following presentation given during the Desktop Developers +Conference shows how to integrate GNU Claspath and GCJ more with the +Free Desktop environments: http://people.redhat.com/fitzsim/ddc2004/ + +6). How do I extend the functionality of the core classes? + +Besides combining GNU Classpath with the runtimes and compilers above +you might want to add support for additional encryption libraries and +algorithms as provided by GNU Crypto +(http://www.gnu.org/software/gnu-crypto/). And for additional +extension libraries (mail, xml, activation, infobus, servlet) check +out GNU ClasspathX (http://www.gnu.org/software/classpathx). + +Additional network protocol support is provided by a sub-project +called GNU Classpath Inetlib, an extension library to provide extra +network protocol support (ftp, finger, gopher) for GNU Classpath, but +it can also standalone to ease adding http, imap, pop3 and smtp client +support to applictions. Also distributed from +<ftp://ftp.gnu.org/gnu/classpath/> + +The following projects extend the functionality of GNU Classpath +with additional algorithms, new core packages and tools. +All are released under GPL compatible licenses: + +* Jessie: A free implementation of the JSSE. Secure Sockets Extension. + http://www.nongnu.org/jessie/ +* Tritonus: A implementation of the javax.sound API. + http://www.tritonus.org/ +* gcjwebplugin: A plugin for the execution of applets in web browsers. + http://www.nongnu.org/gcjwebplugin/ + +Note that the above libraries might already have been included in the +various platforms that also integrate GNU Classpath like done by the +Kaffe project. + +6). What is new in this release? + +New in release 0.11 (Sep 13, 2004) +(See the ChangeLog file for a full list of changes.) + +* javax.swing.Spring and SpringLayout support. +* Added pluggable look and feel support for BasicTextFieldUI and + BasicToolBarSeparatorUI. +* java.swing.text support for (Default and Layered) Highlighter, FieldView, + PlainView, TabExpander and TabableView added. +* Start of JTable and JTree implementation. +* Internal Swing frames work. +* JMenu and JPopupMenu work. +* New gtk+ AWT FileDialog peer now based on gtk+2.4 or higher. +* java.awt.image LookupTables and kernel support. +* Improved java.awt.image.BufferedImage support. +* AWT 1.0 event model support. +* GNU Classpath now comes with some example programs (see examples/README). +* New javax.crypto, javax.crypto.interfaces, javax.crypto.spec, javax.net, + javax.net.ssl, javax.security.auth, javax.security.auth.callback, + javax.security.auth.login, javax.security.auth.x500, javax.security.sasl + and org.ietf.jgss packages are now officially part of GNU Classpath. + Extra crypto algorithms can be obtained from the GNU Crypto project, + a full TLS implementation is provided by the Jessie project. + http://www.gnu.org/software/gnu-crypto/ + http://www.nongnu.org/jessie/ +* Frame.setIconImage() support. +* AWT GDKGraphics scaling. +* New configure flag --enable-gtk-cairo to build Graphics2D implementation + build on cairo and pangoft2. Enabled at runtime by defining the system + property gnu.java.awt.peer.gtk.Graphics=Graphics2D. +* javax.swing.JSpinner implemented. +* Extensive documentation update for java.util collection classes. +* java.awt.geom completed. Area, Arc2D, Ellipse2D and Line2D implemented. +* GNU JAXP is no longer included with GNU Classpath. Runtime, compiler and + tool integrators are encouraged to directly integrate GNU JAXP. + This release has been tested against GNU JAXP 1.1. + http://www.gnu.org/software/classpathx/jaxp/jaxp.html +* JColorChooser, JComboBox and JTextField implemented, including example + uses in GNU Classpath Examples swing Demo. + +Runtime interface Changes: + +* java.lang.Compiler now uses the new java.lang.VMCompiler; there is + a reference implementation that most VMs can use. +* java.lang.VMSystem has a new getenv(String) method and a reference C/JNI + implementation that should work on most Posix like systems. +* java.util.TimeZone has been split into a platform independent class and + a platform dependent class VMTimeZone. GNU Classpath comes with a generic + way to get at the default time zone for Posix/GNU-like platforms. +* [VM]AccessController improvements. In particular it handles + `doPrivileged' calls better, and allows for recursive `doPrivileged' + calls in the same Thread. (see vm/reference/java/security/) + +The following people helped with this release: + +Andreas Tobler (libgcj merging), Andrew Haley (object streams), Andrew +John Hughes (documentation, swing and acessibility), Archie Cobbs +(freebsd testing and bugfixing), Bryce McKinlay (libgcj merging, image +producers, access controller actions), Casey Marshall (crypto, +security and access controller implementation), Craig Black (image +scaling, round rect support, awt tear-off menus), Dalibor Topic (kaffe +merging), David Gilbert (documentation updates, mauve tests, awt and +geom bug fixes), David Jee (awt gtk+ image and choice fixes, frame +icon support, focus manger), Florian Weimer (bug reporting), Graydon +Hoare (lots of Swing and Graphics2D implementation and fixes), Guilhem +Lavaux (java.text bug fixing), Jerry Quinn (java.awt.image lookup +table and kernel implemented), Jeroen Frijters (Runtime loadlibrary, +encoding manager, file and classloader fixes), Ka-Hing Cheung +(jspinner implementation), Kim Ho (jcolorchooser, jtooltip, internal +jfram implementations, event and repaint manager fixes), Mark Wielaard +(packaging and coordination), Michael Koch (javax.swing.text +implementation, build environment, embedded window support, libgcj +merging, bug fixes), Olga Rodimina (swing combobox, jmenu and popup +menu support), Patrik Reali (web master, nio vm class restructuring), +Roman Kennke (boxlayout, spring and springlayout), Sven de Marothy +(java.awt.geom), Thomas Fitzsimmons (lots of gtk+ peers work, awt 1.0 +event model), Tom Tromey (bug fixing, libgcj merging, vmcompiler). + + +</pre> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20041115.wml b/libjava/classpath/doc/www.gnu.org/announce/20041115.wml new file mode 100644 index 00000000000..c877a9b7ab5 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20041115.wml @@ -0,0 +1,237 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:star:slice:> + +<set-var last-modified-author="prr"> + +#include <include/macros.wml> + +<header title="GNU Classpath 0.12 Announcement (2004-11-15)"> +<pre> + +We are pleased to announce a new developer snapshot release of GNU +Classpath. + +GNU Classpath, Essential Libraries for Java, is a project to create free +core class libraries for use with runtimes, compilers and tools for the +java programming language. + +GNU Classpath 0.12 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.12.tar.gz +MD5sum: ce1f7fbe6f2e3b738bae3b46f01a9670 + +Some highlights of this release (more extensive list below): + +X.509 certificate path checking, signed JAR file support, full +java.awt.color implementation, java.beans 1.4 updates, improved +build process, better AWT focus management, much faster and better +fonts support, AWT Choice fixes, HTTP POST fixes, better collection +documentation, Calendar bug fixes, lookahead support for regular +expressions, jtree starts working and improved Eclipse 3 support. + +Included, but not activated by default in this release is a Graphics2D +implementation based on the Cairo Graphics framework +(http://www.cairographics.org). Enabling this makes programs like +JFreeChart work on GNU Classpath based runtimes. Note that this release +needs a cairo CVS build. + +[It is recommended that people wanting to experiment with the +Graphics2D implementation follow the instructions for building gcj +with jhbuild which automatically builds the latest CVS version of GCJ +and Cairo at http://people.redhat.com/fitzsim/gcj-and-jhbuild.html] + +Not yet included is an implementation of Generic collection classes +and classes for other 1.5 language extensions. Work on this is being +done on a special development branch that will be included in a future +GNU Classpath release when free runtimes, compilers and tools have all +been upgraded to support these new language features. + +GNU Classpath uses the Mauve test suite for Compatibility, Completeness +and Correctness checking. This release passes 21245 of 21593 mauve +tests. +Free Software programs and libraries tested against this release are +Eclipse 3.0, JFreeChart (see above), gcjwebplugin and many other +programs, +libraries and applets. + +Here are answers to some questions you might have about this project and +this release. + +1). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +For end users we recommend to use one of the development environments +based on GNU Classpath which combine the core libraries with compilers +and other tools needed for creating applications and libraries. + + * GCC with GCJ (http://gcc.gnu.org/java/) + * Kaffe (http://www.kaffe.org/) + +2). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +You will also need a runtime environment. The following runtime +environments should work out of the box with GNU Classpath + + * JamVM (http://jamvm.sourceforge.net/) + * Jikes RVM (http://www.ibm.com/developerworks/oss/jikesrvm/) + * Kissme (http://kissme.sourceforge.net/) + +Note that these are just byte code execution runtimes. For development +of programs written in the java programming language you will also +need compilers and other tools for creating libraries and/or +executables (see question 1). + +For other environments that might need modified version of the current +release see the README file. A complete list of virtual machines and +compilers known to be based on GNU Classpath can be found at our +website: http://www.gnu.org/software/classpath/stories.html + +2). What platforms are supported? + +GNU/Linux and FreeBSD on x86 and powerpc are regularly tested by the +developers. Since 0.12 there is also support for cygwin. +We plan to eventually support many others. + +5). Where do I go for more information? + +The project home page with information on our mailing list can be +found at http://www.gnu.org/software/classpath/ + +A good overview of the current status can be found on the GNU Classpath +at FOSDEM'04 page which describes the last GNU Classpath hacker meeting. +It includes reports and presentations on the current status and future +plans: http://www.gnu.org/software/classpath/events/fosdem04.html + +The following presentation given during the Desktop Developers +Conference shows how to integrate GNU Claspath and GCJ more with the +Free Desktop environments: http://people.redhat.com/fitzsim/ddc2004/ + +6). How do I extend the functionality of the core classes? + +Besides combining GNU Classpath with the runtimes and compilers above +you might want to add support for additional encryption libraries and +algorithms as provided by GNU Crypto +(http://www.gnu.org/software/gnu-crypto/). And for additional +extension libraries (mail, xml, activation, infobus, servlet) check +out GNU ClasspathX (http://www.gnu.org/software/classpathx). + +Additional network protocol support is provided by a sub-project +called GNU Classpath Inetlib, an extension library to provide extra +network protocol support (ftp, finger, gopher) for GNU Classpath, but +it can also standalone to ease adding http, imap, pop3 and smtp client +support to applictions. Also distributed from +<ftp://ftp.gnu.org/gnu/classpath/> + +The following projects extend the functionality of GNU Classpath +with additional algorithms, new core packages and tools. +All are released under GPL compatible licenses: + +* Jessie: A free implementation of the JSSE. Secure Sockets Extension. + http://www.nongnu.org/jessie/ +* Tritonus: A implementation of the javax.sound API. + http://www.tritonus.org/ +* gcjwebplugin: A plugin for the execution of applets in web browsers. + http://www.nongnu.org/gcjwebplugin/ + +Note that the above libraries might already have been included in the +various platforms that also integrate GNU Classpath like done by the +Kaffe project. + +6). What is new in this release? + +New in release 0.12 (Nov 14, 2004) +(See the ChangeLog file for a full list of changes.) + +* GNU Classpath's JAR implementation now has preliminary support for + signed entries, for so called "signed JAR" file support. Signed JAR + files are one of the key security features of managed runtimes, and + allows code to run privileged given unforgeable proofs of identity. +* A much improved version of X.509 certificates has been added, + including a robust certificate path checking algorithm. Also + included is an implementation of the RSA signature scheme. +* Full java.awt.color implementation, with all standard ICC profiles, + except for PhotoYCC color space. +* java.beans 1.4 updates and bug fixes. +* java.awt.image support updated to 1.4. +* Improved build process. Uses less memory with gcj and C code is + buildable with -Werror on most platform. Please configure with + --enable-Werror and report any remaining issues. +* Big-endian (PowerPC) fixes for native awt GTK+ peers. +* Checkstyle support, see scripts/checkstyle-config.xml. +* Better AWT focus management fro GTK+ peers. +* Much faster and better fonts support + (for both gdk Graphics and cairo Graphics2D) +* AWT Choice fixes for hidden components. +* HTTP Connection Handler fixes for POST support. +* Much fuller collection documentation. +* Lots of Calendar bug fixes. +* More javax.imageio support. +* Better AWT Help MenuBar support. +* Lookahead support for regular expressions. +* Serialization object stream fixes for multiple ClassLoader scenarios. +* Swing TabbedPane, ColorChooser and ComboBox improvements. +* Start of JTree functionality. +* Improved Eclipse 3 support for GNU Classpath based runtimes. + +Runtime interface Changes: + +* New --enable-java-lang-system-explicit-initialization configuration + option. (Warning, will be replaced in next release, please consult + the mailinglist.) +* The reference implementation of VMClassLoader has default + implementations for getResource(s) and provides support for a new + default getSystemClassLoader implementation. + +The following people helped with this release: + +Andreas Tobler (gtk/c compilation and PPC fixes), Andrew Haley +(Object stream serialization fixes), Andrew John Hughes (java.util +documentation updates), Bryce McKinlay (Calendar bugfixes), Casey +Marshall (X.509 certificate path checking and signed jar file +support), Dalibor Topic (AWT Component postevent fix), David Daney +(URL bug fixes), David Gilbert (geom documentation updates and mauve +checking), David Jee (AWT HelpMenuBar fixes), Graydon Hoare +(Graphics2D and Swing work), Ilya Perminov (RMI fixes), Jeroen +Frijters (Application Classloader updates and IKVM integration), Jerry +Quinn (AWT image work), Kim Ho (Swing TabbedPane and ColorChooser +fixes), Mark Wielaard (libgcj merging and packaging), Mattias Rehnberg +(Inet6Address and serialization fixes), Michael Koch (Build +system/compiler updates, libgcj merging, code cleanups, swing, net, +imageio and other fixes and improvements), Noa Resare (Calendar, net, +AWT choice and GeneralPath fixes, kaffe integration), Olga Rodimina +(Swing ComboBox fixes), Patrik Reali (Website), Paul Jenner (AWT Image +raster and Swing JTree fixes), Per Bothner (Collections efficiency), +Robert Schuster (java.beans 1.4 updates and bug fixes), Shashank Bapat +(Regex lookahead support), Steven Augart (JikesRVM integration), Sven +de Marothy (AWT color package implementation, Polygon, GeneralPath, +Double parsing and nio fixes), Thomas Fitzsimmons (AWT gtk+ peer +work), Tom Tromey (Code cleanups all over), Torsten Rupp (Native +java.net cleanups and fixes) + +</pre> + +<footer> + + diff --git a/libjava/classpath/doc/www.gnu.org/announce/20050107.wml b/libjava/classpath/doc/www.gnu.org/announce/20050107.wml new file mode 100644 index 00000000000..ed603e2627e --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20050107.wml @@ -0,0 +1,256 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:star:slice:> + +<set-var last-modified-author="prr"> + +#include <include/macros.wml> + +<header title="GNU Classpath 0.13 Announcement (2005-01-07)"> +<pre> +We are pleased to announce a new developer snapshot release of GNU Classpath. + +GNU Classpath, essential libraries for the java, is a project to create free +core class libraries for use with runtimes, compilers and tools for the +java programming language. + +GNU Classpath 0.13 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.13.tar.gz +MD5sum: 9920904c15f2cdb15e38c4a44968c4f9 +SHA1sum: f431a24d7f25259123ae8a897b4d71be76ac76ea + +Some highlights of this release (more extensive list below): + +Includes HTTP/1.1 and FTP URL handlers. Added java.beans XMLEncoder and +XMLDecoder classes. More than 250 locales are supported now. SAX, DOM, +XSL and XPath implementations for javax.xml (JAXP 1.3) have been added. +Better AWT on gtk+ and Swing support. An AWT Robot implementation based +on the XServer XTest Extension for the gtk+ peers has been added. + +GNU Classpath uses the Mauve test suite for Compatibility, Completeness +and Correctness checking. This release passes 23131 of 23729 mauve tests. +Conformance reports for the included jaxp support can be found in the +doc/README.jaxp file. + +22 people are listed in the ChangeLog file (full list below) +and there were 245 commits to CVS since the last release. + +Included, but not activated by default in this release is a Graphics2D +implementation based on the Cairo Graphics framework +(http://www.cairographics.org/). Enabling this makes programs like +JFreeChart work on GNU Classpath based runtimes. Note that this release +needs a cairo CVS build. + +[It is recommended that people wanting to experiment with the +Graphics2D implementation follow the instructions for building gcj +with jhbuild which automatically builds the latest CVS version of GCJ +and Cairo at http://people.redhat.com/fitzsim/gcj-and-jhbuild.html] + +Not yet included is an implementation of Generic collection classes +and classes for other 1.5 language extensions. Work on this is being +done on a special development branch that will be included in a future +GNU Classpath release when free runtimes, compilers and tools have all +been upgraded to support these new language features. + +Here are answers to some questions you might have about this project and +this release. + +1). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +For end users we recommend to use one of the development environments +based on GNU Classpath which combine the core libraries with compilers +and other tools needed for creating applications and libraries. + + * GCC with GCJ (http://gcc.gnu.org/java/) + * Kaffe (http://www.kaffe.org/) + +Both projects have CVS versions which track GNU Classpath closely. + +2). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +You will also need a runtime environment. The following runtime +environments (which don't include compilers or other tools, see above) +work out of the box with GNU Classpath (tested by and recommended for +GNU Classpath hackers). + + * JamVM (1.2.3) (http://jamvm.sourceforge.net/) + * Kissme (CVS) (http://kissme.sourceforge.net/) + +Other runtimes known to work with the latest or a previous release are +JikesRVM, IKVM.NET, JC, SableVM (-Xgnuclasspath) and CACAO. +(You might need staging, development or CVS versions for support of the +latest GNU Classpath release with some of these.) + +Note that these are just byte code execution runtimes. For development +of programs written in the java programming language you will also +need compilers and other tools for creating libraries and/or +executables (see question 1). + +For other environments that might need modified version of the current +release see the README file. A complete list of virtual machines and +compilers known to be based on GNU Classpath can be found at our +website: http://www.gnu.org/software/classpath/stories.html + +2). What platforms are supported? + +GNU/Linux and FreeBSD on x86 and powerpc are regularly tested by the +developers. Since 0.12 there is also support for cygwin. +We plan to eventually support many others. + +5). Where do I go for more information? + +The project home page with information on our mailing list can be +found at http://www.gnu.org/software/classpath/ + +A good overview of the current status can be found on the GNU Classpath +at FOSDEM'04 page which describes the last GNU Classpath hacker meeting. +It includes reports and presentations on the current status and future +plans: http://www.gnu.org/software/classpath/events/fosdem04.html + +The following presentation given during the Desktop Developers +Conference shows how to integrate GNU Claspath and GCJ more with the +Free Desktop environments: http://people.redhat.com/fitzsim/ddc2004/ + +6). How do I extend the functionality of the core classes? + +Besides combining GNU Classpath with the runtimes and compilers above +you might want to add support for additional encryption libraries and +algorithms as provided by GNU Crypto +(http://www.gnu.org/software/gnu-crypto/). And for additional +extension libraries (mail, activation, infobus, servlet, etc.) +check out GNU ClasspathX (http://www.gnu.org/software/classpathx). + +Additional network protocol support is provided by a sub-project +called GNU Classpath Inetlib, an extension library to provide extra +network protocol support (ftp, finger, gopher) for GNU Classpath, but +it can also standalone to ease adding http, imap, pop3 and smtp client +support to applictions. Also distributed from +<ftp://ftp.gnu.org/gnu/classpath/> + +The following projects extend the functionality of GNU Classpath +with additional algorithms, new core packages and tools. +All are released under GPL compatible licenses: + +* Jessie: A free implementation of the JSSE. Secure Sockets Extension. + http://www.nongnu.org/jessie/ +* Tritonus: A implementation of the javax.sound API. + http://www.tritonus.org/ +* gcjwebplugin: A plugin for the execution of applets in web browsers. + http://www.nongnu.org/gcjwebplugin/ + +Note that the above libraries might already have been included in the +various platforms that also integrate GNU Classpath like done by the +Kaffe project. + +6). What is new in this release? + +New in release 0.13 (Jan 6, 2005) +(See the ChangeLog file for a full list of changes.) + +* The http url protocol handler has been replaced with a full HTTP/1.1 + version from GNU inetlib. +* A new ftp url protocol handler has been added also from GNU inetlib. +* java.beans has been updated to 1.4 including support for XMLEncoder + and XMLDecoder. +* The java.util.Locale support is now based on the Common Locale Data + Repository (CLDR) Project (see http://www.unicode.org/cldr/). + GNU Classpath provides support for more than 250 locales now. + This new support is experimental and the GNU Classpath hackers are + working together with runtime developers and the unicode consortium + to improve them in the future. + If your runtime misdetects your locale or if the default locale gives + problems please try running with -Duser.language=en and -Duser.region=US + to fall back on a known good locale. +* Added implementations of javax.xml (JAXP 1.3), org.xml.sax (SAX2) and + org.w3c.dom (DOM Level 3) interfaces. It is possible to switch between + different implementations AElfred2, GNU DOM, GNU XSL, libxmlj SAX, + libxmlj DOM and libxmlj XSL by setting different system properties. + Also provided is a preliminary XPath 1.0 implementation. + The libxmlj versions are build around libxml2 and libxslt and have to + be enabled during build time by the --enable-xmlj configure flag. + The current support is equal to the last released GNU JAXP 1.3 release. + These packages will be maintained as part of the GNU Classpath core classes + in the future. For more information, conformance results and documentation + on selecting different implementations see doc/README.jaxp. +* More AWT accessible support. +* AWT gtk+ peers component layout, dialog placement, keyboard focus + handling and text positioning have been improved. +* ImageIO interfaces are more complete. +* JList, JTable and JTree have been hugely improved. +* java.awt.Robot support with GdkRobot in the gtk+ awt peers. + Needs XTest Extension (libXtst) XServer support. +* New --disable-examples configure argument. + +Runtime interface changes: + +* Added a new method (VMRuntime.enableShutdownHooks) that enables the VM + to lazily register an exit handler. +* The java.lang.Class constructor now automatically sets the protection + domain for array classes, based on the protection domain of the component + type class. +* New gnu.classpath.VMSystemProperties class. This replaces the + system properties initialization in VMRuntime. Note that it is + now the VMs responsibility to set one additional property: + gnu.cpu.endian should be set to "big" or "little". +* VMRuntime.nativeGetLibname() has been renamed to VMRuntime.mapLibraryName() + and has only one argument, the name of the library. +* String and StringBuffer now call VMSystem.arraycopy() directly and don't + go through java.lang.System. Be careful to not initialize java.lang.System + early in the bootstrap sequence in your VM runtime interface classes. +* Some (wrong) documentation about the behavior of VMThread.sleep(0, 0) + has been updated. Also, VMThread.sleep() now has a default non-native + implementation, but it is a generic implementation that ignores the + nano-seconds argument. Runtime hackers are encouraged to provide a more + efficient version. +* There is prelimenary support for nio direct byte buffers. + See VMDirectByteBuffer. Please contact the GNU Classpath mailinglist when + you add support for this to your runtime. + +The following people helped with this release: + +Andrew John Hughes (Locale, Currency and java.text updates), Archie Cobbs +(Thread improvements), Bryce McKinlay (ResourceBundle speedups), Casey +Marshall (FileLock fixes), Chris Burdess (locale generator, xml integration, +http and ftp handlers), Craig Black (BeanInfoEmbryo improvements), David +Gilbert (AWT and geom documentation), Graydon Hoare (Graphics2D and +BufferedImage improvements), Guilhem Lavaux (CLDR parser and Object stream +serialization improvements), Ito Kazumitsu (nio ByteBuffer fixes), Jeroen +Frijters (Runtime interfaces improvements, including shutdown hooks and +system properties, nio and zip fixes), Jerry Quinn (AWT accessibility +support), Mark Wielaard (packaging and integration), Michael Koch (Locale, +Swing, InetAddress, ImageIO, nio improvements and libgcj integration), +Olga Rodimina (JTable improvements), Patrik Reali (website maintenance), +Paul Jenner (ImageIcon additions), Ranjit Mathew (IdentityHashMap fix), +Robert Schuster (java.beans updates, XMLEncode and XMLDecoder +implementations and JComboBox improvements), Sven de Marothy (Graphics2D, +java.awt.image and java.awt.geom fixes), Thomas Fitzsimmons (GdkRobot, +gtk+ peers component layout, dialog placement, keyboard focus handling and +text positioning), Tom Tromey (gcjx support, zip and ResourceBundle fixes) +</pre> + +<footer> + + diff --git a/libjava/classpath/doc/www.gnu.org/announce/20050226.wml b/libjava/classpath/doc/www.gnu.org/announce/20050226.wml new file mode 100644 index 00000000000..2cea8b8516e --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20050226.wml @@ -0,0 +1,240 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:star:slice:> + +<set-var last-modified-author="prr"> + +#include <include/macros.wml> + +<header title="GNU Classpath 0.14 Announcement (2005-02-26)"> +<pre> +"GNU Classpath delivers core libraries for upcoming GCC and Kaffe releases" + +We are pleased to announce a new developer snapshot release of GNU Classpath. + +GNU Classpath, essential libraries for java, is a project to create free +core class libraries for use with runtimes, compilers and tools for the +java programming language. + +The GNU Classpath developer snapshot releases are not directly aimed at +the end user but are meant to be integrated into larger development +platforms. This 0.14 release snapshot can be seen as the feature complete +base library that will be used in the upcoming GCC 4.0 (gcj) and Kaffe +1.1.5 runtimes, compilers and tools collections. + +Developers wanting to have a look at the core library classes provided by +these upcoming releases can take a look at the new GNU Classpath developers +site. http://developer.classpath.org/ provides detailed information +on how to start with helping the GNU Classpath project and gives an +overview of the core class library packages currently provided. +With this release generated documentation is provided through the new +GNU Classpath Tools gjdoc 0.7.x series. A large update of the documentation +generation framework for java source files used by the GNU project. +See http://developer.classpath.org/doc/. + +One of the major focusses of the GNU Classpath project is expanding and +using the Mauve test suite for Compatibility, Completeness and Correctness +checking. Various groups around GNU Classpath collaborate on the free +software Mauve test suite which contains more then 25.000 library tests. +Mauve has various modules for testing core class library implementations, +byte code verifiers, source to byte code and native code compiler tests. +Mauve also contains the Wonka visual test suite and the Jacks Compiler +Killer Suite. This release passes 25442 of the mauve core library tests. + +The GNU Classpath developer recently held a conference during Fosdem. +This was a standing room event and provided lot of communication between +the GNU Classpath, Kaffe, GCJ, IKVM, Apache, java-gnome and Cacao hackers +and users. The presentations of this event have been publised and should +give a good overview of the current status and future plans of the project: +http://www.gnu.org/software/classpath/events/escape_fosdem05.html + +Some highlights of changes in this release (more extensive list below): + +ImageIO support through gdkpixbuf, lots of new nio character encoders +and decoders, fully automated class documentation generation, generic +VMStackWalker support for runtimes, lots of bug fixes, optimizations and +new swing support. + +Included, but not activated by default in this release is a Graphics2D +implementation based on the Cairo Graphics framework +(http://www.cairographics.org). Enabling this makes programs like +JFreeChart work and JEdit start up on GNU Classpath based runtimes. +To enable this support install the cairo 0.3.0 snapshot, configure +GNU Classpath with --enable-gtk-cairo and make sure the system +property gnu.java.awt.peer.gtk.Graphics=Graphics2D is set. + +Not yet included is an implementation of Generic collection classes +and classes for other 1.5 language extensions. Work on this is being +done on a special development branch that will be included in a future +GNU Classpath release when free runtimes, compilers and tools have all +been upgraded to support these new language features. + +29 people actively contributed code to this release and made 232 CVS +commits during the last two months of development. diffstat since 0.13: +1189 files changed, 31388 insertions(+), 13744 deletions(-) +More details below. + +GNU Classpath 0.14 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.14.tar.gz +MD5sum: 227beb20b927c042628539601c867614 + +Here are answers to some questions you might have about this project and +this release. + +1). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +For end users we recommend to use one of the development environments +based on GNU Classpath which combine the core libraries with compilers +and other tools needed for creating applications and libraries. + + * GCC with GCJ (http://gcc.gnu.org/java/) + * Kaffe (http://www.kaffe.org/) + +2). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +You will also need a runtime environment. The following runtime +environments should work out of the box with GNU Classpath + + * JamVM (http://jamvm.sourceforge.net/) + * Jikes RVM (http://www.ibm.com/developerworks/oss/jikesrvm/) + * Kissme (http://kissme.sourceforge.net/) + +Note that these are just byte code execution runtimes. For development +of programs written in the java programming language you will also +need compilers and other tools for creating libraries and/or +executables (see question 1). + +For other environments that might need modified version of the current +release see the README file. A complete list of virtual machines and +compilers known to be based on GNU Classpath can be found at our +website: http://www.gnu.org/software/classpath/stories.html + +2). What platforms are supported? + +GNU/Linux and FreeBSD on x86 and powerpc are regularly tested by the +developers. Many more architectures and platforms are supported. +Check the actual runtime you use together with GNU Classpath for +detailed information on the supported platforms. + +5). Where do I go for more information? + +The project home page with information on our mailing list can be +found at http://www.gnu.org/software/classpath/ + +A good overview of the current status can be found on the GNU Classpath +Escape The Java Trap event held at FOSDEM this year. +It includes reports and presentations on the current status and future +plans: http://www.gnu.org/software/classpath/events/escape-fosdem05.html + +6). How do I extend the functionality of the core classes? + +Besides combining GNU Classpath with the runtimes and compilers above +you might want to add support for additional encryption libraries and +algorithms as provided by GNU Crypto +(http://www.gnu.org/software/gnu-crypto/). And for additional +extension libraries (mail, xml, activation, infobus, servlet) check +out GNU ClasspathX (http://www.gnu.org/software/classpathx). + +Additional network protocol support is provided by a sub-project +called GNU Classpath Inetlib, an extension library to provide extra +network protocol support (ftp, finger, gopher) for GNU Classpath, but +it can also standalone to ease adding http, imap, pop3 and smtp client +support to applictions. Also distributed from +<ftp://ftp.gnu.org/gnu/classpath/> + +The following projects extend the functionality of GNU Classpath +with additional algorithms, new core packages and tools. +All are released under GPL compatible licenses: + +* Jessie: A free implementation of the JSSE. Secure Sockets Extension. + http://www.nongnu.org/jessie/ +* Tritonus: A implementation of the javax.sound API. + http://www.tritonus.org/ +* gcjwebplugin: A plugin for the execution of applets in web browsers. + http://www.nongnu.org/gcjwebplugin/ + +Note that the above libraries may already be available in some platforms +that integrate GNU Classpath, such as in the Kaffe project. + +6). What is new in this release? + +New in release 0.14 (Feb 25, 2005) +(See the ChangeLog file for a full list of changes.) + +* Character encoders and decoders have been added for: + iso-8859-6 (arabic), iso-8859-7 (greek), iso-8859-8 (hebrew), + iso-8859-9 (latin-5), iso-8859-13, iso-8859-15 (latin-9), cp1047 (ebcdic), + ebcdic-xml-us,ascii, windows-1250, windows-1252, UTF-16BE (Big Endian), + UTF-16LE (Little Endian), UTF-32BE (Big Endian), UTF-32LE (Little Endian). +* Full documentation for all classes can be generated (again) by using + the --with-gjdoc configure option. +* javax.awt.imageio support through gdkpixbuf. + +Runtime interface changes: + +* VMSecurityManager has been replaced by gnu.classpath.VMStackWalker. + currentClassLoader() is no longer needed, and there are also two new + methods with non-native implementations. VM implementors are encouraged + to provide more efficient versions. +* VMRuntime.nativeLoad() now takes an additional ClassLoader parameter. + +The following people helped with this release: + +Andrew Haley (nio optimizations) +Andrew John Hughes (Locale, java.text fixes and generics work) +Anthony Green (rmi cleanup) +Archie Cobbs (Throwable simplification) +Audrius Meskauskas (Swing JComboBox, JTextArea, and Timer fixes) +Bryce McKinlay (serialization fixes) +C. Brian Jones (rmi cleanups) +Chris Burdess (Base64 fix, gnu.xml cleanups, http connection fixes) +Craig Black (native state library, and gtk+ awt peer fixes) +Dalibor Topic (PropertyAction cleanups, inner class and dead code cleanups) +David Gilbert (DefaultListModel, Font text transform fixes and documentation) +Graydon Hoare (Lots of GdkGraphics updates) +Ito Kazumitsu (nio charset provider, FileChannel and SimpleDateFormat fixes) +Jeroen Frijters (Serialization and Collator fixes) +Julian Scheid (UTF8 fix and lots of gjdoc work) +Mark Wielaard (JarFile, TimeZone, URLClassLoader, serialization and packaging) +Michael Koch (AWT Window and Checkbox fixes, code cleanup, LocalInformation +maintenance, checkstyle cleanups, swing and nio updates) +Olga Rodimina (Jtable updates) +Patrik Reali (Website maintenance) +Quentin Anciaux (Lots of new character encoders and decoders) +Ranjit Mathew (IdentityHashMap bug fix) +Robert Schuster (nio charset and ChannelReader implementations) +Roman Kennke (Better swing BasicLookAndFeel) +Rutger Ovidius (GNU security provider update) +Steven Augart (OpenBSD script fixes and stack walker documentation) +Sven de Marothy (Lots of Calendar and TimeZone fixes and SpinnerDateModel) +Thomas Fitzsimmons (Much awt gtk+ peer and Robot work) +Timo Lindfors (regex fixes) +Tom Tromey (generics work, classloader and xml fixes) +</pre> + +<footer> + + diff --git a/libjava/classpath/doc/www.gnu.org/announce/20050429.wml b/libjava/classpath/doc/www.gnu.org/announce/20050429.wml new file mode 100644 index 00000000000..16f0dd7c48b --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20050429.wml @@ -0,0 +1,309 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:star:slice:> + +<set-var last-modified-author="prr"> + +#include <include/macros.wml> + +<header title="GNU Classpath 0.15 Announcement (2005-04-29)"> +<pre> +We are pleased to announce a new developer snapshot release of GNU Classpath. + +GNU Classpath, essential libraries for java, is a project to create free +core class libraries for use with runtimes, compilers and tools for the +java programming language. + +The GNU Classpath developer snapshot releases are not directly aimed +at the end user but are meant to be integrated into larger development +platforms. For example the GCC (gcj) and Kaffe projects will use the +developer snapshots as a base for future versions. + +Some highlights of changes in this release (more extensive list below): + +Optimized nio and nio.charset plus io streams integration leading to +large speedups in character stream performance. To compliment this +new framework a native iconv based charset provider was added. Better +support for free swing metal and pluggable lafs. Some org.omg.CORBA +support added. Better java.beans support for the Eclipse Visual Editor +Project. Completely lock free ThreadLocal implementation added. More +javax.swing.text support for RTF and HTML. More flexible runtime +interfaces and build configuration options. + +26 people actively contributed code to this release and made 299 CVS +commits during the last two months of development. diffstat since 0.14: +993 files changed, 74259 insertions(+), 15666 deletions(-) +More details about the various changes and contributions below. + +GNU Classpath 0.15 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.15.tar.gz +MD5sum: 036c23aec7cb53a43b7b9dc63a92fbbe +SHA1sum: 971bdd436b8010ab30096869f689a44d41e5a01c + +Included, but not activated by default in this release is a Graphics2D +implementation based on the Cairo Graphics framework +(http://www.cairographics.org). Enabling this makes programs like +JFreeChart work and JEdit start up on GNU Classpath based runtimes. +To enable this support install the cairo 0.3.0 snapshot, configure +GNU Classpath with --enable-gtk-cairo and make sure the system +property gnu.java.awt.peer.gtk.Graphics=Graphics2D is set. + +Not yet included is an implementation of Generic collection classes +and classes for other 1.5 language extensions. Work on this is being +done on a special development branch that will be included in a future +GNU Classpath release when free runtimes, compilers and tools have all +been upgraded to support these new language features. + +One of the major focusses of the GNU Classpath project is expanding +and using the Mauve test suite for Compatibility, Completeness and +Correctness checking. Various groups around GNU Classpath collaborate +on the free software Mauve test suite which contains more then 27.500 +library tests. Mauve has various modules for testing core class +library implementations, byte code verifiers, source to byte code and +native code compiler tests. Mauve also contains the Wonka visual test +suite and the Jacks Compiler Killer Suite. This release passes 27.325 +of the mauve core library tests. +See for more information: http://sources.redhat.com/mauve/ + +Conformance reports for the included jaxp support can be found in the +doc/README.jaxp file. + +The GNU Classpath developers site http://developer.classpath.org/ +provides detailed information on how to start with helping the GNU +Classpath project and gives an overview of the core class library +packages currently provided. For each snapshot release generated +documentation is provided through the GNU Classpath Tools gjdoc +project. A documentation generation framework for java source files +used by the GNU project. Full documentation on the currently +implementated packages and classes can be found at: +http://developer.classpath.org/doc/ + + +Here are answers to some questions you might have about this project and +this release. + +1). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +For end users we recommend to use one of the development environments +based on GNU Classpath which combine the core libraries with compilers +and other tools needed for creating applications and libraries. + + * GCC with GCJ (http://gcc.gnu.org/java/) + * Kaffe (http://www.kaffe.org/) + +Both projects have CVS versions which track GNU Classpath closely. + +2). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +You will also need a runtime environment. Most active GNU Classpath +hackers use JamVM (http://jamvm.sourceforge.net/) and the gcj or Jikes +bytecode compiler (http://www.jikes.org) for quick development. But +other environments can certainly be used to hack on the GNU Classpath +core libraries. + +For other environments that might need modified version of the current +release see the README file. A complete list of virtual machines and +compilers known to be based on GNU Classpath can be found at our +website: http://www.gnu.org/software/classpath/stories.html + +Note that these are just byte code execution compilers and/or +runtimes. For development of programs written in the java programming +language you will also need compilers and other tools for creating +libraries and/or executables (see question 1). + +2). What platforms are supported? + +GNU/Linux and FreeBSD on x86 and powerpc are regularly tested by the +developers. Since 0.12 there is also support for cygwin. We plan to +eventually support many others. Many more architectures and platforms +are supported. Check the actual runtime you use together with GNU +Classpath for detailed information on the supported platforms. + +5). Where do I go for more information? + +The project home page with information on our mailing list can be +found at http://www.gnu.org/software/classpath/ + +The GNU Classpath developer recently held a conference during Fosdem. +This was a standing room event and provided lot of communication between +the GNU Classpath, Kaffe, GCJ, IKVM, Apache, java-gnome and Cacao hackers +and users. The presentations of this event have been publised and should +give a good overview of the current status and future plans of the project: +http://www.gnu.org/software/classpath/events/escape_fosdem05.html + +Developers wanting to help out with the project will find more +information and tools on http://developer.classpath.org/ + +6). How do I extend the functionality of the core classes? + +Besides combining GNU Classpath with the runtimes and compilers above +you might want to add support for additional encryption libraries and +algorithms as provided by GNU Crypto +(http://www.gnu.org/software/gnu-crypto/). And for additional +extension libraries (mail, activation, infobus, servlet, etc.) check +out GNU ClasspathX (http://www.gnu.org/software/classpathx). + +Additional network protocol support is provided by a sub-project +called GNU Classpath Inetlib, an extension library to provide extra +network protocol support (ftp, finger, gopher) for GNU Classpath, but +it can also standalone to ease adding http, imap, pop3 and smtp client +support to applictions. Also distributed from +<ftp://ftp.gnu.org/gnu/classpath/> + +The following projects extend the functionality of GNU Classpath +with additional algorithms, new core packages and tools. +All are released under GPL compatible licenses: + +* Jessie: A free implementation of the JSSE. Secure Sockets Extension. + http://www.nongnu.org/jessie/ +* Tritonus: A implementation of the javax.sound API. + http://www.tritonus.org/ +* gcjwebplugin: A plugin for the execution of applets in web browsers. + http://www.nongnu.org/gcjwebplugin/ + +Note that the above libraries might already have been included in the +various platforms that also integrate GNU Classpath like done by the +Kaffe project. + +6). What is new in this release? + +New in release 0.15 (Apr 29, 2005) +(See the ChangeLog file for a full list of changes.) + +* The old character encoding framework (gnu.java.io.EncodingManager) +has been replaced by a system based completely on nio.charset +providers. Many converters have been added, both the io, lang and nio +frameworks now use the same set of converters and the whole character +stream framework (Readers and Writers) have been optimized. For some +workloads this leads to 2x till 20x speedups. + +The default charsets supported are: + + Cp424, Cp437, Cp737, Cp775, Cp850, Cp852, Cp855, Cp857, Cp860, Cp861, + Cp862, Cp863, Cp864, Cp865, Cp866, Cp869, Cp874, ISO_8859_1, ISO_8859_13, + ISO_8859_15, ISO_8859_2, ISO_8859_3, ISO_8859_4, ISO_8859_5, ISO_8859_6, + ISO_8859_7, ISO_8859_8, ISO_8859_9, KOI_8, MS874, MacCentralEurope, + MacCroatian, MacCyrillic, MacDingbat, MacGreek, MacIceland, MacRoman, + MacRomania, MacSymbol, MacThai, MacTurkish, US_ASCII, UTF_16, UTF_16BE, + UTF_16Decoder, UTF_16Encoder, UTF_16LE, UTF_8, UnicodeLittle, Windows1250, + Windows1251, Windows1252, Windows1253, Windows1254, Windows1255, + Windows1256, Windows1257, Windows1258. + +Many more encoding are supported through the new IconvProvider +depending on the platform iconv support. GNU libiconv is recommended. +The IconvProvider is currently not enabled by default. To enable it +define the system property gnu.classpath.nio.charset.provider.iconv=true. +Some runtimes might choose to enable this by default by setting it +through VMSystemProperties. We would like to get feedback on whether +enabling or disabling the IconvProvider by default results in the +highest speedups. + +* Free swing metal and pluggable look and feels have been improved. +The GNU Classpath free swing example can now be run with different +"skins" by setting the system property swing.defaultlaf to the GNU, +Basic or Metal look and feel. + +* Some of the org.omg.CORBA classes and packages have now been +implemented. The Savannah bug tracker contains additional tasks for +which we are seeking help. + +* Fixed compatibility problems in the java.beans which affected +Eclipse's Visual Editor Project. + +* New completely lock free (Inheritable)ThreadLocal implementation. + +* javax.swing.text.rtf framework added which can handle simple (plain) +text tokens. + +* Support for parsing html files into Level 2 Document Object Model +(org.w3c.dom.html2 and javax.swing.text.html.parser). And a start of +javax.swing.text.html framework added. + +Runtime interface changes: + +* jni.h changed to better support compiling runtimes implementing jni; + see VM integration guide for details. +* New --enable-default-toolkit option to configure can be used to set + the fully qualified class name of the default AWT toolkit to use. + If not given, the old default of gnu.java.awt.peerk.gtk.GtkToolkit + is used. +* New --disable-core-jni option can be used to disable building the + "core" JNI libraries. This is primarily useful if your VM can use the + Gtk peers but not the core JNI libraries. +* New system property "gnu.classpath.boot.library.path" can be specified + to define the location of the JNI libraries. It is by all means meant + ONLY for VM implementors and GNU Classpath hackers. See the hacking + guide for more information. +* The helper methods currentLoader() and allocateObject() for + java.io.ObjectInputStream have been moved to a VMObjectInputStream class. + Reference implementations are provided. +* java.net.InetAddress now uses VMInetAddress for runtime/platform + specific methods getLocalHostname(), getHostByAddr() and + getHostByName(). java.net.NetworkInterface now uses VMNetworkInterface + for runtime/platform specific getInterfaces() support. Default + (Posix/GNU JNI) implementations are provided. +* VMClass has a new method getModifiers(Class, boolean) which can be + used to get the real modifiers for an inner class or the ones + specified by the InnerClasses attribute. +* All (possible) runtime specific methods of Object and Double are now + in VMObject and VMDouble. Where possible generic reference + implementations are provided. +* The reference implementation of VMClassLoader now handles zip files + on the boot loader class path in getResources(). + +The following people helped with this release: + +Andreas Tobler (Security warning fixes, fdlibm merging and cleanups) +Andrew Haley (FileChannel optimizations) +Andrew John Hughes (URL/URI, rmi.naming, java.text, Currency and generics) +Archie Cobbs (RPM spec file, VMClassLoader fixes, jni cleanups) +Audrius Meskauskas (Lots of corba work, javax.swing.text.html and dom parser) +Casey Marshall (x509 and asn1/der fixes) +Chris Burdess (writeUTF optimization, html2 dom support and net protocols) +Dalibor Topic (FileChannel fixes, kaffe porting) +David Daney (InetAddress fixes) +David Gilbert (awt documentation, font fixes) +Guilhem Lavaux (VMSelector and IndexColorModel fixes) +Ito Kazumitsu (DecimalFormat parse fixes) +Jeroen Frijters (nio optimizations, VMClass fixes, ThreadLocal rewrite) +Luca Barbieri (FileChannel.tryLock fixes) +Mark Wielaard (cleanups and packaging) +Michael Franz (OSX testing) +Michael Koch (VM interface restructuring, libgcj merging, lots of bug fixing) +Mike Stump (fdlibm ppc64 fixes) +Olafur Bragason (PipedInputStream bug reporting) +Patrik Reali (Website maintenance) +Rei Odaira (VMSelector bug reporting) +Riccardo Mottola (Darwin6 testing) +Robert Schuster (java.beans, boot.library.path, jni fixes, mediation work) +Roman Kennke (Lots of free swing work, MediaTracker and RTF work) +Sven de Marothy (io, nio and charset optimizations and rewrites) +Thomas Fitzsimmons (URL, gtk-peers and free swing work) +Tom Tromey (build and code cleanups, jni merging with libgcj and generics) + +</pre> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20050630.wml b/libjava/classpath/doc/www.gnu.org/announce/20050630.wml new file mode 100644 index 00000000000..1784e2f11f2 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20050630.wml @@ -0,0 +1,329 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:star:slice:> + +<set-var last-modified-author="prr"> + +#include <include/macros.wml> + +<header title="GNU Classpath 0.16 Announcement (2005-04-29)"> +<pre> +GNU Classpath 0.16 "Harmony!" released. + +We are pleased to announce a new developer snapshot of GNU Classpath. + +GNU Classpath, essential libraries for java, is a project to create free +core class libraries for use with runtimes, compilers and tools for the +java programming language. + +The GNU Classpath developer snapshot releases are not directly aimed +at the end user but are meant to be integrated into larger development +platforms. For example the GCC (gcj) and Kaffe projects will use the +developer snapshots as a base for future versions. + +This is the first release of GNU Classpath since our Harmony +collaboration with the Apache group. Instructions for developers +wanting to try out and help with the core library implementation can +be found at: http://developer.classpath.org/ + +New is our wiki with simple steps to setup a quick development +environment. For example developers using cygwin can find examples +here: http://developer.classpath.org/mediation/ClasspathOnCygwin + +Some highlights of changes in this release (more extensive list below): + +AWT GtkScrollBar and GtkImage improvements. All image operations are +now working correctly. Graphics2D has been upgraded to use Cairo +0.5.x. Free Swing updates for 1.5 top-level compatibility. JTree +interface completed. JFileChooser has been implemented. Completed +implementations of BoxLayout, GrayFilter and SplitPane. Upgraded the +Corba features to 1.3 and included new CORBA 2.3 features. Start of +generic JDWP framework. And lots of bug fixes based on real world +application usage. + +31 people actively contributed code to this release and made 389 CVS +commits during the last two months of development. diffstat since 0.15: +1248 files changed, 133649 insertions(+), 41802 deletions(-) + +More details about the various changes and contributions below. + +GNU Classpath 0.16 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.16.tar.gz +MD5sum: 220a9c86719a2c6bd7ba9b9877495113 +SHA1sum: be6d30fbfe4d71015a455a367411a6d55df3484e + +This release depends on gtk+ 2.4 for AWT support. But gtk+ 2.6 or +higher is recommended. Included, but not activated by default in this +release is a Graphics2D implementation based on the Cairo Graphics +framework (http://www.cairographics.org). Enabling this makes programs +like JEdit start up on GNU Classpath based runtimes. To enable this +support install the cairo 0.5.x snapshot, configure GNU Classpath with +--enable-gtk-cairo and make sure the system property +gnu.java.awt.peer.gtk.Graphics=Graphics2D is set. + +This release was explicitly tested against the last Eclipse 3.1 +release (thanks to various eclipse hackers for the support). For end +user we do however recommend to use the GCJ4 packaged version of +Eclipse 3.1 that have been prepared for the various distributions: + +Fedora Core + http://overholt.ca/wp/?p=27 +Debian GNU/Linux + http://gnu.wildebeest.org/diary-man-di/index.php?p=19 +Ubuntu + http://www.larvalstage.net/index.php?/archives/2-Introducing-Eclipse-3.1.html + +Not yet included is an implementation of Generic collection classes +and classes for other 1.5 language extensions. Work on this is being +done on a special development branch that will be included in a future +GNU Classpath release when free runtimes, compilers and tools have all +been upgraded to support these new language features. + +One of the major focuses of the GNU Classpath project is expanding +and using the Mauve test suite for Compatibility, Completeness and +Correctness checking. Various groups around GNU Classpath collaborate +on the free software Mauve test suite which contains ~30.000 core +library tests. Mauve has various modules for testing core class +library implementations, byte code verifiers, source to byte code and +native code compiler tests. Mauve also contains the Wonka visual test +suite and the Jacks Compiler Killer Suite. This release passes 28801 +of the mauve core library tests. See for more information: +http://www.sourceware.org/mauve/ + +Conformance reports for the included jaxp support can be found in the +doc/README.jaxp file. + +The GNU Classpath developers site http://developer.classpath.org/ +provides detailed information on how to start with helping the GNU +Classpath project and gives an overview of the core class library +packages currently provided. For each snapshot release generated +documentation is provided through the GNU Classpath Tools gjdoc +project. A documentation generation framework for java source files +used by the GNU project. Full documentation on the currently +implementated packages and classes can be found at: +http://developer.classpath.org/doc/ + +Here are answers to some questions you might have about this project and +this release. + +1). Who should use this software? + +Although GNU Classpath is already capable of supporting many +applications written in the java programming language, this is a +development release. As such, there are still some unfinished +components, and some problems are to be expected. You should install it +if you are interested in GNU Classpath development or reporting bugs. +We appreciate both. + +For end users we recommend to use one of the development environments +based on GNU Classpath which combine the core libraries with compilers +and other tools needed for creating applications and libraries. + + * GCC with GCJ (http://gcc.gnu.org/java/) + * Kaffe (http://www.kaffe.org/) + +Both projects have CVS versions which track GNU Classpath closely. + +2). What is required to build/install/run? + +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development +libraries (gtk+, libart and gdk-pixbuf). More information on the +precise version numbers for the tools and libraries can be found in +the INSTALL file. + +You will also need a runtime environment. Most active GNU Classpath +hackers use JamVM (http://jamvm.sourceforge.net/) and the gcj or Jikes +bytecode compiler (http://www.jikes.org) for quick development. But +other environments can certainly be used to hack on the GNU Classpath +core libraries. + +For other environments that might need modified version of the current +release see the README file. A complete list of virtual machines and +compilers known to be based on GNU Classpath can be found at our +website: http://www.gnu.org/software/classpath/stories.html + +Note that these are just byte code execution compilers and/or +runtimes. For development of programs written in the java programming +language you will also need compilers and other tools for creating +libraries and/or executables (see question 1). + +3). What platforms are supported? + +GNU/Linux and FreeBSD on x86 and powerpc are regularly tested by the +developers. Since 0.12 there is also support for cygwin. We plan to +eventually support many others. Many more architectures and platforms +are supported. Check the actual runtime you use together with GNU +Classpath for detailed information on the supported platforms. + +4). Where do I go for more information? + +The project home page with information on our mailing list can be +found at http://www.gnu.org/software/classpath/ + +The GNU Classpath developer recently held a conference during Fosdem. +This was a standing room event and provided lot of communication between +the GNU Classpath, Kaffe, GCJ, IKVM, Apache, java-gnome and Cacao hackers +and users. The presentations of this event have been publised and should +give a good overview of the current status and future plans of the project: +http://www.gnu.org/software/classpath/events/escape_fosdem05.html + +Developers wanting to help out with the project will find more +information and tools on http://developer.classpath.org/ + +5). How do I extend the functionality of the core classes? + +Besides combining GNU Classpath with the runtimes and compilers above +you might want to add support for additional encryption libraries and +algorithms as provided by GNU Crypto +(http://www.gnu.org/software/gnu-crypto/). And for additional +extension libraries (mail, activation, infobus, servlet, etc.) check +out GNU ClasspathX (http://www.gnu.org/software/classpathx). + +Additional network protocol support is provided by a sub-project +called GNU Classpath Inetlib, an extension library to provide extra +network protocol support (ftp, finger, gopher) for GNU Classpath, but +it can also standalone to ease adding http, imap, pop3 and smtp client +support to applictions. Also distributed from +<ftp://ftp.gnu.org/gnu/classpath/> + +The following projects extend the functionality of GNU Classpath +with additional algorithms, new core packages and tools. +All are released under GPL compatible licenses: + +* Jessie: A free implementation of the JSSE. Secure Sockets Extension. + http://www.nongnu.org/jessie/ +* Tritonus: A implementation of the javax.sound API. + http://www.tritonus.org/ +* gcjwebplugin: A plugin for the execution of applets in web browsers. + http://www.nongnu.org/gcjwebplugin/ + +Note that the above libraries might already have been included in the +various platforms that also integrate GNU Classpath like done by the +Kaffe project. + +6). What is new in this release? + +New in release 0.16 (Jun 30, 2005) +(See the ChangeLog file for a full list of changes.) + +* Better GTK scrollbar peer implementation when using GTK >= 2.6. +* GdkGraphics2D has been updated to use Cairo 0.5.x APIs. +* BufferedImage and GtkImage rewrites. All image drawing operations + should now work correctly (flipping requires gtk+ >= 2.6) +* Future Graphics2D, Image and Text work is documented at: + http://developer.classpath.org/mediation/ClasspathGraphicsImagesText +* Free Swing Top-Level Compatibility. JFrame, JDialog, JApplet, + JInternalFrame, and JWindow are now 1.5 compatible in the sense that you + can call add() and setLayout() directly on them, which will have the same + effect as calling getContentPane().add() and getContentPane().setLayout(). +* The JTree interface has been completed. JTrees now recognizes mouse clicks + and selections work, but the visual implementation is not yet complete. + Work on expansion and collapsing of the tree nodes is being implemented. +* BoxLayout works properly now. +* Fixed GrayFilter to actually work. +* Metal SplitPane implemented. +* Lots of free swing text and editor stuff work now. + +* When gtk+ 2.6 or higher is installed the default log handler will produce + stack traces whenever a WARNING, CRITICAL or ERROR message is produced. + +* The CORBA implementation is now a working prototype that should support + features up till 1.3 inclusive. + We would invite groups writing CORBA dependent applications to + try Classpath implementation, reporting any possible bugs. + + The CORBA prototype is interoperable with Sun's implementation v 1.4, + transferring object references, primitive types, narrow and wide + strings, arrays, structures, trees, abstract interfaces and + value types (feature of CORBA 2.3) between these two platforms. + The remote exceptions are transferred and handled correctly. + The stringified object references (IORs) from various sources are + parsed as required. + The transient (for current session) and permanent (till jre restart) + redirections work. + Both Little and Big Endian encoded messages are accepted. + The implementation is verified using tests from the former cost.omg.org. + The current release includes working examples (see the examples directory), + demonstrating the client-server communication, using either CORBA Request + or IDL-based stub (usually generated by a IDL to java compiler). + These examples also show how to use the Classpath CORBA naming service. + The IDL to java compiler is not yet written, but as our library must be + compatible, it naturally accepts the output of other idlj implementations. + +* New --with-vm-classes configure option, and new 'build' setting + for --with-glibj. (Only for integrators.) + +Runtime interface changes: + +* Start of a generic JDWP framework in gnu/classpath/jdwp. + This is unfinished, but feedback (at classpath@gnu.org) from runtime + hackers is greatly appreciated. Although most of the work is currently + being done around gcj/gij we want this framework to be as VM neutral as + possible. Early design is described in: + http://gcc.gnu.org/ml/java/2005-05/msg00260.html +* Native method VMClass.getModifiers() now takes an additional + boolean parameter. +* Deprecated native method VMClassLoader.defineClass(ClassLoader, + String, byte[], int, int) has been replaced by + VMClassLoader.defineClass(ClassLoader, String, byte[], int, int, + ProtectionDomain) +* VMClassLoader.loadClass(String name, boolean resolve) is now native, + replacing the former version which just returned null. +* Deprecated native method VMClassLoader.getPrimitiveClass(String) has + been replaced by new native method VMClassLoader.getPrimitiveClass(char). +* Previously empty implementations of methods VMThread.countStackFrames(), + VMThrowable.fillInStackTrace(), and VMThrowable.getStackTrace() have + been removed; these methods are now native methods. +* Fields "exceptionTypes" and "parameterTypes" have been removed from + Contructor.java and getExceptionTypes() and getParameterTypes() are + now native methods. + +The following people helped with this release: + +Andreas Jaeger (mprec updates) +Andreas Tobler (Darwin support) +Andrew John Hughes (Locale and net fixes, URI RFC2986 updates) +Andrew Overholt (File locking) +Anthony Balkissoon (JList, Free Swing 1.5 updates and mouse event fixes) +Archie Cobbs (VM interface updates) +Audrius Meskauskas (Corba and HTML work) +Bryce McKinlay (RMI work) +Chris Burdess (XML work) +Christian Thalinger (fdlibm updates) +Dalibor Topic (SHA1PRNG and GdkPixbugDecoder updates) +David Daney (BitSet bugfixes) +David Gilbert (Lots and lots of documentation and awt/swing fixes) +Gary Benson (MessageFormat fixes) +Goffredo Baroncelli (HTTPURLConnection fixes) +Jan Roehrich (JTree fixes) +Jeroen Frijters (ClassLoader and nio cleanups) +Ka-Hing Cheung (TreePath and TreeSelection fixes) +Kalle Olavi Niemitalo (Build fixes) +Keith Seitz (JDWP work) +Kim Ho (JFileChooser implementation) +Lillian Angel (JTree implementation and lots of bug fixes) +Mark Wielaard (build fixes, GdkPixpufDecoder fixes and packaging) +Michael Koch (Locale updates, bug and build fixes) +Olga Rodimina (MenuSelectionManager) +Robert Schuster (charset and awt fixes) +Roman Kennke (BoxLayout, GrayFilter and SplitPane, plus bugfixes all over) +Sven de Marothy (GtkImage rewrite, 2D, awt, free swing and date/time fixes) +Thomas Fitzsimmons (Lot of upgrades to the gtk+ AWT and cairo 2D support) +Tom Tromey (libgcj merging, build infrastructure and bug fixes) +Ziga Mahkovec (Graphics2D upgraded to cairo 0.5 and new regex features) + +We would also like to thank the numerous bug reporters and testers! +</pre> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/20050715.wml b/libjava/classpath/doc/www.gnu.org/announce/20050715.wml new file mode 100644 index 00000000000..8f40c58a80a --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/20050715.wml @@ -0,0 +1,132 @@ +#!wml --include=.. + +#use wml::std::page +#use wml::std::lang +#use wml::fmt::isolatin +#use wml::std::case global=upper + +<lang:star:slice:> + +<set-var last-modified-author="prr"> + +#include <include/macros.wml> + +<header title="GNU Classpatchy 0.17 Announcement (2005-07-15)"> +<pre> +GNU Classpatchy 0.17 released. + +We are pleased to announce a new developer snapshot of GNU Classpath. + +GNU Classpath, essential libraries for java, is a project to create free +core class libraries for use with runtimes, compilers and tools for the +java programming language. + +The GNU Classpath developer snapshot releases are not directly aimed +at the end user but are meant to be integrated into larger development +platforms. For example the GCC (gcj) and Kaffe projects will use the +developer snapshots as a base for future versions. + +This is mainly a bug fix release for issues found with eclipse 3.1 and +Free Swing applications just after our 0.16 release. But it also +includes some exciting new features. + +Some highlights of changes in this release (more extensive list below): + +XML DOM, XPATH and XSL fixes. Free Swing is much more responsive. +JInternalFram, JTree, JMenu, JTable, JButton and JFileChooser fixes. +FileChannel lock and force implementations added. The logging +FileHandler now rotates files. Clean locking and namespace for gtkpeer +library. System call interrupts and timeouts are now handled correctly +for net and nio. Corba bug fixes. Lots of documentation updates. The +VM Integration Guide now comes with a full section on the VM/Classpath +hooks. GNU Classpath Examples now includes a Tree World demo. + +21 people actively contributed code to this release and made 171 CVS +commits during the two weeks of development. diffstat since 0.16: +3638 files changed, 25798 insertions(+), 15596 deletions(-) + +More details about the various changes and contributions below. + +This release passes 29508 out of 30320 Mauve core library tests. +Conformance reports for the included jaxp support can be found in the +doc/README.jaxp file. + +GNU Classpath 0.17 can be downloaded from +ftp://ftp.gnu.org/pub/gnu/classpath/ +or one of the ftp.gnu.org mirrors +http://www.gnu.org/order/ftp.html + +File: classpath-0.17.tar.gz +MD5sum: eb620987422878e05ea889d5e7496c63 +SHA1sum: 3b47cb37c91803fbc9d0426d97e1faa6a993615a + +The GNU Classpath developers site http://developer.classpath.org/ +provides detailed information on how to start with helping the GNU +Classpath project and gives an overview of the core class library +packages currently provided. For each snapshot release generated +documentation is provided through the GNU Classpath Tools gjdoc +project. A documentation generation framework for java source files +used by the GNU project. Full documentation on the currently +implementated packages and classes can be found at: +http://developer.classpath.org/doc/ + +New in release 0.17 (Jul 15, 2005) +(See the ChangeLog file for a full list of changes.) + +* gnu.xml fix for nodes created outside a namespace context. +* Add support for output indenting and cdata-section-elements output + instruction in xml.transform. +* xml.xpath corrections for cases where elements/attributes might have + been created in non-namespace-aware mode. Corrections to handling of + XSL variables and minor conformance updates. +* DefaultMutableTreeNode preorder, postorder, depthFirst and breadthFirst + traversal enumerations implemented. +* JInternalFrame colors and titlebar draw properly. +* JTree is working up to par (icons, selection and keyboard traversal). +* JMenus were made more compatible in visual and programmatic behavior. +* JTable changeSelection and multiple selections implemented. +* JButton and JToggleButton change states work properly now. +* JFileChooser fixes. +* revalidate and repaint fixes which make Free Swing much more responsive. +* Correctly handle system call interrupts and timeouts in native nio + and net functions. +* MetalIconFactory implemented. +* Handle image loading errors correctly for gdkpixbuf and MediaTracker. +* Added Tree World to GNU Classpath examples Free Swing demo. +* FileChannel.lock() and FileChannel.force() implemented. +* java.util.logging.FileHandler now rotates files. +* Better handle GDK lock. Properly prefix gtkpeer native functions (cp_gtk). +* Corba bug fixes and documentation updates. +* Updated gcj build infrastructure. +* Documentation fixes all over the place. + See http://developer.classpath.org/doc/ +* VM Integration Guide updates with a full section on VM/Classpath hooks. + +The following people helped with this release: + +Aaron Luchko (JDWP updates and documentation fixes) +Andrew John Hughes (VMIntegration guide update) +Anthony Balkissoon (Lots of Free Swing updates) +Archie Cobbs (build and URLClassLoader updates) +Audrius Meskauskas (Corba and text and html parser fixes) +Casey Marshall (FileChannel lock, SystemLogger and FileHandler rotate impl.) +Chris Burdess (Lots of gnu.xml and http protocol fixes) +Dalibor Topic (Better DEBUG support) +Daniel Bonniot (Serialization fixes) +David Gilbert (Lots of documentation and MetalIconFactory implementation) +Guilhem Lavaux (Logger bug fixes) +Jeroen Frijters (Serialization fixes) +Lillian Angel (Lots of Free Swing updates) +Mark Wielaard (System call interrupts, timeouts and packaging) +Robert Schuster (TreeNode enumerations and ActionCommand and various fixes) +Roman Kennke (Lots of Free Swing updates) +Sven de Marothy (GtkImage fixes) +Thomas Fitzsimmons (gtk peer updates and restructuring) +Simon Kitching (String cleanups and optimization suggestions) +Tom Tromey (gcj build update) +Ziga Mahkovec (build fixes) + +We would also like to thank the numerous bug reporters and testers! +</pre> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/announce/Makefile b/libjava/classpath/doc/www.gnu.org/announce/Makefile new file mode 100644 index 00000000000..f260bda9a16 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/Makefile @@ -0,0 +1,32 @@ +ifndef WMK + export WMK=wmk +endif +ifndef WML + export WML=wml +endif + +WML_SRC = $(wildcard *.wml) +WML_OBJS = $(patsubst %.wml,%.html,$(WML_SRC)) + +%.html: %.wml ../include/macros.wml + $(WML) -o $@ $< +# -rm -f $(patsubst %.wml,%.html,$<) + +all : $(WML_OBJS) subdirs + +.PHONY : clean +clean : + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE) clean";) + -rm -f *.html + +.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)/announce/ + diff --git a/libjava/classpath/doc/www.gnu.org/announce/announcements.wml b/libjava/classpath/doc/www.gnu.org/announce/announcements.wml new file mode 100644 index 00000000000..1e0c1b5b359 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/announce/announcements.wml @@ -0,0 +1,25 @@ +#!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="cbj"> + +#include <include/macros.wml> + +<header title="<en>GNU Classpath Annoucements</en>"> + +<H4><en>Announcements</en></H4> +<UL> +<LI><createlink url="/software/classpath/announce/20020208.html" name="GNU Classpath Version 0.03"> (2002-02-08)</LI> +<LI><createlink url="/software/classpath/announce/20010106.html" name="GNU Classpath Version 0.02"> (2001-01-06)</LI> +<LI><createlink url="/software/classpath/announce/20001120.html" name="GNU Classpath Version 0.01"> (2000-11-20)</LI> +<LI><createlink url="/software/classpath/announce/19990206.html" name="GNU Classpath Version 0.00"> (1999-02-06)</LI> +</UL> + +<footer> diff --git a/libjava/classpath/doc/www.gnu.org/benchmarks.wml b/libjava/classpath/doc/www.gnu.org/benchmarks.wml new file mode 100644 index 00000000000..011cd57f7d7 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/benchmarks.wml @@ -0,0 +1,51 @@ +#include "include/layout.wml" + +<set-var last-modified-author="prk"> +<subject "GNU Classpath Test and Benchmark Page"> + +<box> +<boxtitle><a name="testing">Classpath::Testing</a></boxtitle> +<boxitem> +<p> +The test framework for GNU Classpath is called +<createlink url="http://sources.redhat.com/mauve/" name="Mauve">. There +are instructions within the Mauve website on how to download and use Mauve. +Writing Mauve tests is the most important thing GNU Classpath developers +could do for the project at this time. +</p> +<p> +Java API compatibility testing can be performed using +<createlink url="http://www.kaffe.org/~stuart/japi/" +name="japitools">. Japitools already does +full API comparisons but it doesn't have the capability to extract +APIs from the documentation - instead, the "japize" tool uses the +jode.bytecode library to identify the public members of a given set of +packages from the binary jars or zips. But japitools does separate the +API-inspection phase ("japize") from the compatibility-testing phase +("japicompat") so it would be easy to offer an alternative to japize +that worked on API documentation. +</p> +<p> +Another method of API compatibility testing is to use <createlink +url="http://majestix.ucnet.uoc.gr/~jgeorgal/pub/jdiff.sh" +name="jdiff.sh">, at least until this functionality is merged into +japitools. +</boxitem> + + +<boxtitle><a name="benchmarks">Classpath::Benchmarks</a></boxtitle> +<boxitem> +Many free benchmarks are available. Benchmarks are a good way to test the functionality of a VM and at the same time get results that can be compared. + +<table border="0"> +<tr> + <th>Name</th><th>Description</th> +</tr> +<tr> + <td><createlink name="Ashes" url="http://www.sable.mcgill.ca/ashes/"></td> + <td>The Ashes benchmark</td> +</tr> +</table> +</boxitem> + +</box> diff --git a/libjava/classpath/doc/www.gnu.org/cp-tools/Makefile b/libjava/classpath/doc/www.gnu.org/cp-tools/Makefile new file mode 100644 index 00000000000..93ec48c625f --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/cp-tools/Makefile @@ -0,0 +1,32 @@ +ifndef WMK + export WMK=wmk +endif +ifndef WML + export WML=wml +endif + +WML_SRC = $(wildcard *.wml) +WML_OBJS = $(patsubst %.wml,%.html,$(WML_SRC)) + +%.html: %.wml ../include/macros.wml ../include/layout.wml + $(WML) -o $@ $< +# -rm -f $(patsubst %.wml,%.html,$<) + +all : $(WML_OBJS) subdirs + +.PHONY : clean +clean : + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE) clean";) + -rm -f *.html + +.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)/cp-tools/ + diff --git a/libjava/classpath/doc/www.gnu.org/cp-tools/cp-tools.wml b/libjava/classpath/doc/www.gnu.org/cp-tools/cp-tools.wml new file mode 100755 index 00000000000..902544fbe32 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/cp-tools/cp-tools.wml @@ -0,0 +1,59 @@ +#!wml --include=..
+
+#include "include/layout.wml"
+
+<set-var last-modified-author="mjw">
+<subject "GNU Classpath Tools">
+
+<box>
+<boxtitle><a name="Tools">GNU Classpath::Tools</a></boxtitle>
+<boxitem>
+GNU Classpath Tools is a collection of tools for programmers using the
+GNU Classpath library including a byte code disassembler, a JNI C header
+file generator, serial version uid calculator, character converter, remote
+method invocation tools and a documentation generation framework for java
+source files. Plus tools specific to GNU Classpath development for generating
+locale, currency and timezone information.
+</boxitem>
+</box>
+
+<box>
+<boxtitle><a name="Programs">GNU Classpath::Tools::Programs</a></boxtitle>
+<boxitem>
+GNU Classpath Tools contains the following tools. Some have their own
+page describing them in more detail:
+<ul>
+<li><b>gjdoc</b>
+ A documentation generation framework for java source files.</li>
+<li><b><createlink url="cp-tools/texidoclet.html" name="texidoclet"/></b>
+ A "doclet" for converting comments into GNU TexInfo source.</li>
+<li>RMI tools such as rmic and rmiregistry.</li>
+<li>Miscellaneous tools such as javap, javah, serialver and native2ascii/</a>
+<li>GNU Classpath specific tools localgen and currencygen.</li>
+</lu>
+</boxitem>
+</box>
+
+<box>
+<boxtitle><a name="Development">GNU Classpath::Tools::Development</a></boxtitle>
+<boxitem>
+GNU Classpath Tools is part of the GNU Classpath project which is hosted at
+Savannah. The project page is
+<createlink url="http://savannah.gnu.org/projects/classpath/"/>.
+From there you can submit bug reports, check the latest news, find tasks
+yet to be done, and most importantly submit patches!
+<p>
+There is one general discussion list for Classpath-tools. You may
+<createlink url="" name="subscribe"/> to the mailing list via the web.
+However, you may also just send an email message with a subject of "subscribe"
+to <createlink url="mailto:cp-tools-discuss-request@gnu.org"/>.
+You may <createlink url="" name="unsubscribe"/> from the mailing list via the
+web as well.
+</boxitem>
+
+<boxtitle><a name="License">GNU Classpath::Tools::Distribution Terms</a></boxtitle>
+<boxitem>
+All GNU Classpath Tools are distributed under the terms of the
+<createlink url="/copyleft/gpl.html" name="GNU General Public License">.
+</boxitem>
+</box>
diff --git a/libjava/classpath/doc/www.gnu.org/cp-tools/texidoclet.html b/libjava/classpath/doc/www.gnu.org/cp-tools/texidoclet.html new file mode 100644 index 00000000000..1395442ab74 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/cp-tools/texidoclet.html @@ -0,0 +1,597 @@ +<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN"> +<HTML> +<HEAD> +<TITLE>GNU texidoclet - GNU Project - Free Software Foundation (FSF)</TITLE> +<A HREF=""></A> +</HEAD> +<BODY BGCOLOR="#ffffff" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD"> +<H1>GNU texidoclet</H1> + +<h2>Table Of Contents</h2> +<ol> + </li><li><a href="#Introduction">Introduction</a> + + <ul> + <li><a href="#whatis">What is TexiDoclet?</a> + </li><li><a href="#whyuse">Why use the info format?</a> + </li><li><a href="#howstart">How do I get started?</a> + </li></ul> + + </li><li><a href="#Requirements">Requirements</a> + + </li><li><a href="#Download">Download</a> + + </li><li><a href="#Installation">Installation</a> + + </li><li><a href="#configure">Configure</a> + + </li><li><a href="#Usage">Usage</a> + </li><li><a href="#Bugs">BUGS</a> + </li><li><a href="#History">History</a> + </li><li><a href="#Todo">TODO</a> + </li> +</ol> + +<hr> + +<a name="Introduction"></a> <h2>1. Introduction</h2> + +<h3><a name="whatis"></a>What is GNU TexiDoclet?</h3> + +GNU TexiDoclet is a system for creating <b>info</b> pages from Java +source documentation. It is part of the <a +href="/software/classpath/">GNU Classpath</a> project, however it can +also be used as standalone doclet used with any Java-compatible +platform. + +<p>You can use TexiDoclet to create API documentation in <b>info</b> +format for any set of Java packages (including classpath). The latter +will reproduce the full Java API documentation for use on text-only +displays, or for integrating it into the GNU Emacs online help +facility. </p><p>TexiDoclet also includes an Elisp package which adds +context-sensitive help features to GNU Emacs. +</p> + +<table bgcolor="#cccccc" border="0" cols="1" width="100%"> + <tbody> + <tr> + <td><b>Note:</b> This is alpha software. You should not use + TexiDoclet in a production environment, because it has not yet + been tested for reliability. Also, see <a href="#Bugs">Bugs</a> + for a list of currently missing + features.</td></tr></tbody></table> <h3><a name="whyuse"></a>Why + use the <b>info</b> format?</h3>Although the <b>info</b> format + is raw text with nearly no formatting or highlighting, using the + <b>info</b> version of the Java API documentation can have a + number of advantages even on graphical displays - especially if + you are using GNU Emacs: + +<ul> + <li>Because it is text-only, <b>info</b> is pretty fast. + </li><li>You can easily navigate through <b>info</b> pages using only the keyboard + - which doesn't hold true for most HTML browsers available today, where you + always have to grab the mouse or tab the focus. + </li><li>You can use all the powerful Emacs facilities to browse the documentation + (e.g. incremental search, regular expressions, bookmarks). + </li><li>You can copy documentation fragments (like the definition of a method you + want to overload) easily using the keyboard, again having all Emacs facilities + right at hand, such as the ring buffer. + </li><li>You have no frames in <b>info</b>, but you can use the Speedbar contained + in recent Emacs distributions for the same purpose [not tested as yet]. + </li></ul> + +<h3><a name="howstart"></a>How do I get started?</h3> +<ul> + <li>Check the <a href="#Requirements">Requirements</a> + section and download/install any missing tools. + </li><li><a href="#Download">Download</a> + and <a href="#Installation">unpack</a> + the TexiDoclet package. + </li><li>See section <a href="#configure">Configure</a> + for further instructions. </li></ul> + +<h3>Thanks!</h3> +<p>TexiDoclet was originally written as a standalone doclet by <a +href="http://savannah.gnu.org/users/julian/">Julian Scheid</a> and was +contributed to the GNU Project as part of GNU Classpath.</a> +</p> + + +<hr> + +<a name="Requirements"></a> + +<h2>2. Requirements</h2>In order to use TexiDoclet, you need the +following software installed: + +<ul> + <li>A Java platform 1.2 or better. The intention is to be able have + TexiDoclet work first and foremost with <a + href="/software/classpath/">GNU Classpath</a> and other completely + free toolchains (<em>with <a href="gjdoc.en.html">gjdoc</a> we are + 99% there!</em>) although it can be used with non-free VMs.</li> + + <li>GNU Make and GNU makeinfo. Note: makeinfo is contained in the GNU + texinfo package. </li> + + <li>A Unix environment: + <ul> + <li><tt>bash</tt> and the standard commands like <tt>cp</tt> are essential + </li><li><tt>which</tt> and <tt>awk</tt> are required for checking the setup + </li><li><tt>gzip</tt> is used to compress the <b>info</b> pages. </li> + </ul> + +<!-- + </li><li>The Java Community source code, if you want to reproduce + documentation for the Java core API. <strong>Note: this is + <em>not</em> distributed with TexiDoclet because it is released + under a non-free software license, the SCSL, which is incompatible + with the GNU GPL. If you wish to create the Java API documentation + you must download and agree to it's terms (we cannot do + this).</strong></li> +--> + + </ul> + + Makeinfo is required to convert the texinfo source into the + <b>info</b> format. If you only need the texinfo source, you don't + need makeinfo. Unix users will probably find a makeinfo preinstalled + on their system. Windows users can find free precompiled binaries + on the Internet (look for the Texinfo package). <br> + +<table bgcolor="#cccccc" border="0" cols="1" width="100%"> + <tbody> + <tr> + <td><b>Note:</b> There are some 16-bit makeinfo binaries available online, + but they won't work. You need to look for an up-to-date 32-bit + binary.</td></tr></tbody> +</table> + +<p>GNU Make is required because if you want to generate the full +standard Java API documentation, each package must be processed +individually. The Makefile works with patterns to process the packages +individually and merge the results.</p> + +<p>Again, Unix users will find Make preinstalled. Windows users can +find precompiled binaries on the Internet for free. <br> +</p> + +<table bgcolor="#cccccc" border="0" cols="1" width="100%"> + <tbody> + <tr> + <td><b>Note:</b> Use only GNU Make - you will probably get into + trouble if you try to use a different Make tool, because the + TexiDoclet Makefile uses some GNU-specific + features.</td></tr> + </tbody> +</table> + +<!-- +<p>You need the Java community source code if you want to reproduce the full +core API documentation. Get it from <a href="http://developer.java.sun.com/">Sun's Java Developer Website</a>. Having +the source at hand is generally recommended. <br> +</p> +--> + +<table bgcolor="#cccccc" border="0" cols="1" width="100%"> + <tbody> + <tr> + <td><b>Tip:</b> Configuring TexiDoclet is much easier if you make sure + that all utilities (including the Java tools) are on your system search + path.</td></tr></tbody></table> + +<p> +TexiDoclet has been tested on the following systems: +</p><p> + +</p><table border="1" cols="3" width="100%"> + <tbody> + <tr> + <td><b>Operating System</b></td> + <td><b>JDK</b></td> + <td><b>Other</b></td></tr> + +<!-- Windows untested at the moment + <tr> + <td>Windows 98</td> + <td>Sun JDK 1.3 RC2</td> + <td>Cygwin B-20 (GNU bash 2.02.1) <br>GNU Make 3.78.1 <br>GNU makeinfo + 1.68 (GNU texinfo 3.12) <br>GNU Emacs 20.6.1</td> + </tr> +--> + <tr> + <td>Linux kernel 2.2.16 on Intel / Red Hat 7.0 distribution</td> + <td>Sun JDK 1.2.2</td> + + <td>GNU bash 2.04.11 <br>GNU Make 3.79.1 <br>GNU makeinfo 4.0 + <br>GNU Emacs 20.3.1</td></tr> + + <tr> + <td>Linux kernel 2.2.9-27mdk / Mandrake distribution + <em>(thanks to Owen Lydiard for the report)</em></td> + <td>JDK 1.3</td> + <td> GNU make 3.77<br> + makeinfo (GNU texinfo) 4.0<br> + GNU Emacs 20.3.1</td> + </tr> + + <tr> + + <td colspan="3">As of the date of this document, no other + configurations have been tested. If you install TexiDoclet on a + different system, be it successful or not, please contact the <a + href="http://savannah.gnu.org/project/memberlist.php?group_id=508">developers</a> + so that this list can be extended.</td></tr></tbody> +</table> + + +<h3>3.1 Tool download locations for Windows users [untested]</h3> + +<p>Although the present version of TexiDoclet has not been tested on +Windows, a previous incarnation was working using the following: +Windows 98 / Sun JDK 1.3 RC2 / Cygwin B-20 (GNU bash 2.02.1) / GNU +Make 3.78.1 / GNU makeinfo 1.68 (GNU texinfo 3.12) / GNU Emacs +20.6.1</p> + +<p>Here are a few URLs for getting the Windows ports of the required +software:</p> + +<ul> +<li><a href="http://sourceware.cygnus.com/cygwin/">The Cygwin project</a> offers the most + sophisticated port of Unix utilities for free download. Their "full" package + includes a Bash and a full-featured Unix environment (including <tt>grep</tt>, <tt>less</tt>, <tt>awk</tt> and other + useful commands.) With regard to TexiDoclet, only GNU <tt>make</tt> and <tt>makeinfo</tt> + are missing. + +</li><li><a href="http://www.tertius.com/projects/library/#cygwin32">tertius.com</a> contains a + link to a Windows port of the texinfo package, + including the required <tt>makeinfo</tt> tool. It also includes a standalone <b>info</b> viewer. + +</li> + +<li>Refer to the <a +href="http://www.gnu.org/software/make/make.html">GNU Make +homepage</a> and to <a +href="http://ftp.gnu.org/pub/gnu/">http://ftp.gnu.org</a> for +downloading the GNU Make binaries for Windows. </li></ul> + +<hr> + +<a name="Download"></a> + +<a name="Download"> +<h2>3. Download</a></h2> + +The old (pre-GNU) version of TexiDoclet is still located at our old +development site on sourceforge and is available from <a +href="http://sourceforge.net/project/showfiles.php?group_id=7984">SourceForge</a>. +This (old) 0.5 version is provided purely as a convenience, and will +soon be replaced by a new version . Subsequent releases will be made +available at via the GNU ftp site (<a +href="http://ftp.gnu.org/pub/gnu/">http://ftp.gnu.org/pub/gnu/).</a> + +<p>The package includes an autoconfiguration system, the full source +code, and additional Emacs add-ons. It unpacks into a separate +directory named "<tt>texidoclet-(version)</tt>". </p> + +<p>If you want to take a look at TexiDoclet's output first, here is a +<a +href="http://texidoclet.sf.net/texidoclet-api-info-0.5.tar.gz">sample +(32 K gzipped tar)</a>. It's the converted `info' docs for the +TexiDoclet API (please note that the package name +<tt>gnu.texidoclet</tt> is now obsoleted by +<tt>gnu.classpath.tools.doclets.texidoclet</tt>) itself. [To view run +the standalone <tt>info</tt> viewer: <tt>info -f +texidoclet.info</tt>.] +</p> + +<hr> + +<a name="Installation"></a> + +<h2>4. Installation</h2> + + +<p><strong>Please note the following instructions relate purely to the +old 0.5 version of GNU texidoclet, which is currently the only +release</strong></p> + +<p>In order to install TexiDoclet, you should unpack it to a location +of your choice. TexiDoclet will unpack into a separate subdirectory, +which contains the following files and directories:</p> + +<table> + <tbody> + <tr> + <td><tt>Makefile </tt></td> + <td></td> + <td>the TexiDoclet main Makefile.</td></tr> + <tr> + <td><tt>COPYING </tt></td> + <td> </td> + <td>the GNU public license (Version 2)</td></tr> + <tr> + <td><tt>etc/ </tt></td> <td></td> + + <td>contains Makefile template for generating the docs for Sun's + code.</td></tr> + <tr> + <td><tt>lisp/ </tt></td> + <td></td> + <td>contains add-ons for enabling context-sensitive help in Emacs.</td></tr> + <tr> + <td><tt>source/ </tt></td> + <td></td> + <td>contains the full Java source code for TexiDoclet</td></tr> +</tbody></table> + +<p>After you have unpacked the archive, you should configure TexiDoclet as +described in the following section, <a href="#configure">Configure</a>.</p> + +<hr> + +<a name="configure"></a> + +<h2>6. Configure</h2> + +<p><strong>Please note the following instructions relate purely to the +old 0.5 version of GNU texidoclet, which is currently the only +release</strong></p> + +[Taken from the <tt>README</tt> file in the distribution] + +<pre> +Installation: +============ + +1. The usual GNU autoconf procedure applies: + + ./configure + make + + Read the generic INSTALL file for the details. + +2. Extra texidoclet-specific options for `configure': + + `--with-jdkdir=DIR' + + DIR specifies the location of the JDK (if it's not on the PATH) + + `--with-javadocjar=FILE' + + Use FILE as jar file with javadoc support. + +3. This will generate the jar file in source/TexiDoclet.jar. You can + choose to run "make install" at this point, although this is not, + strictly speaking, necessary. + +4. To see an example of the invocation of TexiDoclet, type "make + check". This will build the `info' docs for texidoclet itself in + the "source" subdirectory. +</pre> + +<hr> + +<a name="Usage"></a> + +<h2>8. Usage</h2> + +<p><strong>Please note the following instructions relate purely to the +old 0.5 version of GNU texidoclet, which is currently the only +release</strong></p> + +[Taken from the <tt>README</tt> file in the distribution] + +<pre> +Usage: +===== + +1. TexiDoclet now works like any other doclet [Consult + http://java.sun.com/j2se/javadoc/ for further information on + Javadoc and the Javadoc API], it can be invoked with default + options by merely supplying the path the doclet and the doclet + invocation class (which is `gnu.texidoclet.Driver'): + +javadoc -docletpath TexiDoclet.jar -doclet gnu.texidoclet.Driver <filename> ... + +2. It also accepts all the Standard Sun doclet options, in addition + to some TexiDoclet-specific ones, which are listed if you invoke + javadoc without any Java source files or packages. Here are those + options: + +-d <directory> Destination directory for output files +-tocbase <base> Prefix for all package-level texi files (default 'packages' +-indexbase <base> Prefix for package index +-allclassesbase <base> Prefix for all class list +-treebase <base> Prefix for tree output +-etagsname <base> Prefix for package etags +-tocheader <text> Header for each texi file +-tocfooter <text> Footer for each texi file +-copyrightnotice <text> Copyright information on each texi page +-wordwrappos <chars> Number of columns at which to wrap +-firstlineindent <chars> Number of columns to indent +-includeauthor Include author information? +-fulltreealignment <type> 'replace' or null +-heritagealignment <type> 'replace' or null + + Most of these options are self-explanatory and all have + `reasonable' defaults, and are in the process of being more fully + documented. + +3. To generate the `info' documentation, invoke `makeinfo' on the + resultant `.texi' file. See the documentation accompanying your + texinfo installation for more details. [Note you can use texinfo + to also generate printed and HTML documentation from the `.texi' + files, but note that there are more specialised doclets for that + purpose]. +</pre> + +<hr> + +<a name="Bugs"></a> + +<h2>7. Bugs</h2> + +<p><strong>Please note the following instructions relate purely to the +old 0.5 version of GNU texidoclet, which is currently the only +release</strong></p> + +[Taken from <tt>BUGS</tt> in the distribution] + +<pre>Known Bugs, or "features not yet implemented", in roughly the order +they will be attacked. New versions of this software implementing all +or part of the missing features can be expected soon. + +* No cross-links for parameter types, return types, and thrown exceptions. + +* No support for {@link}. + +* Not very configurable at the time. + +* Various small improvements on Info page layout pending. + +* Elisp scripts for context sensitive help are preliminary. (Can + anyone help me out here? I am new to Lisp and would need some + advice.) + +* Autoconf support for the Cygnus environment (simply untested at the + moment).</pre> + +<hr> + +<a name="History"></a> + +<h2>8. History</h2> + + [Taken from <tt>NEWS</tt> in the distribution] + +<pre> + +2002-01-24 -- CVS + +* now a GNU project (part of classpath) +* all copyright changed to FSF. +* distribution now based at http://savannah.gnu.org/projects/cp-tools/ + +2001-04-02 -- 0.5 + +* complete overhaul of distribution +* distribution now based at SourceForge. +* rewrote Makefile system to use GNU automake/autoconf +* added a new Driver class to generate the .texi in one pass + +2000.04.02 -- 0.4.1 + +* features full information - all documentation nodes are implemented +* added "implements" information +* added post-processing to include information about derived and + implementing classes. +* removed self-reference in heritage tree +* improved node reference formatting ("(package) class" instead of + "(package)class") +* added switch to control inclusion of author information +* added caption to index, all classes, and full tree node +* added "abstract" keyword and class prototype to class node +* added serialization node +* added ability to split the full index into 27 parts (A-Z|_) + (not configurable yet) + +2000.04.01 -- 0.3.3 + +* index is now sorted case-insensitive +* major revision of configuration file structure +* added preliminary version of inherited fields and methods +* took preparations for adding derivation information after generating + the texi files. + +2000.04.01 -- 0.3.2 + +* improved front page layout +* added copyright messages as requested by Sun Microsystems Inc. so + that the core API docs +* can be distributed in converted format. +* removed heritage chart from interfaces +* added "extends" line to class node +* added @author tag to all nodes + +2000.03.30 -- 0.3.1 + +* added Interfaces, Exceptions and Errors to package node +* fixed bug: bad layout when HTML paragraph ends with <br> +* added @deprecated and @since info to all nodes +* added support for multiple source paths + +2000.03.29 -- 0.2.1 + +* fixed bug: class node only displayed first description line. +* added @since tag for all nodes. +* fixed bug: generated text displayed bogus texi tags. +* corrected/finished full tree layout. +* fixed bug: field prototype was missing. +* <sup> is now translated to ^ (caret) for denoting powers. +* Method listing in class node is now sorted. +* added "see also" for classes + +2000.03.28 -- 0.1.2 + +* Source code structure significantly improved. +* added "all classes", full index, and full tree. +* added preliminary emacs .el-script for context-sensitive help. + +2000.03.27 -- 0.1.1 + +* Initial non-public pre-alpha release. +</pre> + +<hr> + +<a name="Todo"></a> + +<h2>9. TODO</h2> + +[Taken from <tt>TODO</tt> in distribution] + +<pre> +* Check bug list. + +* Improve source code documentation and this page. + +* Check Speedbar compatibility. + +* Look for a way to add a link to the corresponding Java source code + into all Info nodes. + +* Same for original HTML documentation (using browse-url) + +* Perhaps integrate XML/XSL support when it becomes part of the Java + standard. Currently, the user would have had to download a package + of some MB and install it, if an XML library would have been + employed for TexiDoclet. +</pre> + +<BR> +<HR> + +Return to <A HREF="/home.html">GNU's home page</A>. +<P> +Please send FSF & GNU inquiries & questions to +<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. +There are also <A HREF="/home.html#ContactInfo">other ways to +contact</A> the FSF. +<P> +Please send comments on these web pages to +<A HREF="mailto:webmasters@www.gnu.org"><EM>webmasters@www.gnu.org</EM></A>, +send other questions to +<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. +<P> +Copyright (C) 1999, 2005 Free Software Foundation, Inc., +51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA +<P> +Verbatim copying and distribution of this entire article is +permitted in any medium, provided this notice is preserved.<P> +Updated: + +$Date: 2005/07/02 20:32:08 $ by $Author: mark $ +<HR> +</BODY> +</HTML> 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> diff --git a/libjava/classpath/doc/www.gnu.org/downloads/.cvsignore b/libjava/classpath/doc/www.gnu.org/downloads/.cvsignore new file mode 100644 index 00000000000..2d19fc766d9 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/downloads/.cvsignore @@ -0,0 +1 @@ +*.html diff --git a/libjava/classpath/doc/www.gnu.org/downloads/19990206.wml b/libjava/classpath/doc/www.gnu.org/downloads/19990206.wml new file mode 100644 index 00000000000..fe5181b71d0 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/downloads/19990206.wml @@ -0,0 +1,128 @@ +#!wml --include=.. + +<set-var last-modified-author="cbj"> + +## +# Ignore <en> tags without removing them (may be used in future) +# +<define-tag en endtag=required> +%body +</define-tag> + +#include <include/layout.wml> + +<subject "GNU Classpath 0.00 Annoucement (1999-02-06)"> +<h1>GNU Classpath 0.00 Annoucement (1999-02-06)</h1> + +<p> +<en> +I am pleased to announce the first development release of GNU Classpath, +a project to create a free software replacement for Sun's proprietary +Java class libraries. The project is initially providing class library +support for the Japhar JVM. +</en> +</p> +<p> +<en> +Here are the answers to some questions you might have about this project +and this release. +</en> +</p> +<p> +<en> +1). Where can I get it? +</en> +</p> +<p> +<en> +GNU Classpath 0.00 can be downloaded from: +<createlink url="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.00.tar.gz" + name="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.00.tar.gz"> +</en> +</p> +<p> +<en> +2). What is included? +</en> +</p> +<p> +<en> +The following java packages are supported: +</en> +</p> +<UL> + <LI>java.beans</LI> + <LI>java.io</LI> + <LI>java.lang</LI> + <LI>java.lang.reflect</LI> + <LI>java.math</LI> + <LI>java.net</LI> + <LI>java.security (partial and non-functioning)</LI> + <LI>java.security.acl</LI> + <LI>java.security.interfaces</LI> + <LI>java.util</LI> +</UL> +<p> +<en> +This is enough to run many non-awt programs. Not all classes and methods +are implemented in this release, but most are. The major missing piece +of core functionality is java.text. Many of the implemented classes are +already up to the Java 1.2 spec. +</en> +</p> +<p> +<en> +3). What is required to build/install/run? +</en> +</p> +<p> +<en> +GNU Classpath requires that Japhar 0.07 be installed. Information on +obtaining Japhar is available from <createlink url="http://www.hungry.com/old-hungry/products/japhar/" +name="http://www.hungry.com/old-hungry/products/japhar/">. A working C compiler is also required. You +will need the Sun JDK installed if you elect to recompile the Java +classes. +</en> +</p> +<p> +<en> +4). What platforms are supported? +</en> +</p> +<p> +<en> +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. +</en> +</p> +<p> +<en> +5). Who should use this software? +</en> +</p> +<p> +<en> +This is a development release only. You should only install it if you +are interested in Classpath development or reporting bugs. We appreciate +both. You might also be interested if you enjoy installing random alpha +software. +</en> +</p> +<p> +<en> +6). Where do I go for more information? +</en> +</p> +<p> +<en> +The project has a web page at +<createlink url="http://www.classpath.org/" name="http://www.classpath.org/"> + +and + +<createlink url="http://www.gnu.org/software/classpath/classpath.html" + name="http://www.gnu.org/software/classpath/classpath.html"> + +Information on our mailing list is available at the web site. +</en> +</p> diff --git a/libjava/classpath/doc/www.gnu.org/downloads/20001120.wml b/libjava/classpath/doc/www.gnu.org/downloads/20001120.wml new file mode 100644 index 00000000000..28a3992bb06 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/downloads/20001120.wml @@ -0,0 +1,137 @@ +#!wml --include=.. + + +<set-var last-modified-author="cbj"> +## +# Ignore <en> tags without removing them (may be used in future) +# +<define-tag en endtag=required> +%body +</define-tag> + + +#include <include/layout.wml> + +<subject "GNU Classpath 0.01 Annoucement (2000-11-20)"> +<h1>GNU Classpath 0.01 Annoucement (2000-11-20)</h1> + +<p> +<en> +I am pleased to announce a new development release of GNU Classpath, +a project to create a free software replacement for Sun's proprietary +Java class libraries. The project is initially providing class library +support for the Japhar JVM. There are a few other JVMs which have taken +the project libraries and used them in their own projects as well. +</en> +</p> +<p> +<en> +Here are the answers to some questions you might have about this project +and this release. +</en> +</p> +<p> +<en> +1). Where can I get it? +</en> +</p> +<p> +<en> +GNU Classpath 0.01 can be downloaded from: + +<createlink url="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.01.tar.gz" + name="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.01.tar.gz"> +</en> +</p> +<p> +<en> +2). What is included? +</en> +</p> +<p> +<en> +The following java packages are supported: +</en> +</p> +<UL> + <LI>java.beans</LI> + <LI>java.io</LI> + <LI>java.lang</LI> + <LI>java.lang.reflect</LI> + <LI>java.math</LI> + <LI>java.net</LI> + <LI>java.security (partial and non-functioning)</LI> + <LI>java.security.acl</LI> + <LI>java.security.interfaces</LI> + <LI>java.util</LI> +</UL> +<p> +<en> +This is enough to run many non-awt programs. Not all classes and +methods are implemented in this release, but most are. Many of the +implemented classes are already up to the Java 1.2 spec. +</en> +</p> +<p> +<en> +3). What is required to build/install/run? +</en> +</p> +<p> +<en> +GNU Classpath requires that Japhar 0.09 be installed. Information on +obtaining Japhar is available from <createlink url="http://www.hungry.com/old-hungry/products/japhar/" +name="http://www.hungry.com/old-hungry/products/japhar/">. A working C compiler is also required. You +will need IBM's Jikes Java compiler installed if you elect to +recompile the Java classes and Sun's 1.1.8 JDK javah installed to +create native header files. RPMs compatible with Red Hat 7 have been +created of Japhar, NSPR, a cross platform thread library Japhar uses, +and GNU Classpath. Installing onto a Gnome workstation should +provide the rest of the required libraries automatically. Otherwise, +you may need to install libart and other packages detailed more +precisely in the HACKING file. +</en> +</p> +<p> +<en> +4). What platforms are supported? +</en> +</p> +<p> +<en> +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. +</en> +<p> +<p> +<en> +5). Who should use this software? +</en> +</p> +<p> +<en> +This is a development release only. You should only install it if you +are interested in Classpath development or reporting bugs. We appreciate +both. You might also be interested if you enjoy installing random alpha +software. +</en> +</p> +<p> +<en> +6). Where do I go for more information? +</en> +</p> +<p> +<en> +The project has a web page at + +<createlink url="http://www.classpath.org/" name="http://www.classpath.org/"> + +and + +<createlink url="http://www.gnu.org/software/classpath/classpath.html" + name="http://www.gnu.org/software/classpath/classpath.html"> + +Information on our mailing list is available at the web site. +</en> +</p> diff --git a/libjava/classpath/doc/www.gnu.org/downloads/20010106.wml b/libjava/classpath/doc/www.gnu.org/downloads/20010106.wml new file mode 100644 index 00000000000..36a0d8b8b71 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/downloads/20010106.wml @@ -0,0 +1,141 @@ +#!wml --include=.. + +<set-var last-modified-author="cbj"> + +## +# Ignore <en> tags without removing them (may be used in future) +# +<define-tag en endtag=required> +%body +</define-tag> + +#include <include/layout.wml> + +<subject "GNU Classpath 0.02 Annoucement (2001-01-05)"> +<h1>GNU Classpath 0.02 Annoucement (2001-01-05)</h1> + + +<p> +<en> +I am pleased to announce a new development +release of GNU Classpath, a project to create a free software +replacement for Sun's proprietary Java class libraries. The project +is initially providing class library support for the Japhar JVM, but +will soon provide out of the box support SableVM, Intel's ORP, and +Kaffe. The major improvements for this release are the addition of a +correct security policy file and exception stack traces are now +printed when using Japhar. +</en> +</p> +<p> +<en> +Here are the answers to some questions you might have about this project +and this release. +</en> +</p> +<p> +<en> +1). Where can I get it? +</en> +</p> +<p> +<en> +GNU Classpath 0.02 can be downloaded from: + +<createlink url="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.02.tar.gz" + name="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.02.tar.gz"> +</en> +</p> +<p> +<en> +2). What is included? +</en> +</p> +<p> +<en> +The following java packages are supported: +</en> +</p> +<UL> + <LI>java.beans</LI> + <LI>java.io</LI> + <LI>java.lang</LI> + <LI>java.lang.reflect</LI> + <LI>java.math</LI> + <LI>java.net</LI> + <LI>java.security (partially functioning)</LI> + <LI>java.security.acl</LI> + <LI>java.security.interfaces</LI> + <LI>java.util</LI> +</UL> +<p> +<en> +This is enough to run many non-awt programs. Not all classes and +methods are implemented in this release, but most are. Many of the +implemented classes are already up to the Java 1.2 spec. +</en> +</p> +<p> +<en> +3). What is required to build/install/run? +</en> +</p> +<p> +<en> +GNU Classpath requires that Japhar 0.09 be installed along with a +single patch to Japhar 0.09 included with the release. Information on +obtaining Japhar is available from <createlink url="http://www.hungry.com/old-hungry/products/japhar/" +name="http://www.hungry.com/old-hungry/products/japhar/">. A working C compiler is also required. You +will need IBM's Jikes Java compiler installed if you elect to +recompile the Java classes and Sun's 1.1.8 JDK javah installed to +create native header files. RPMs compatible with Red Hat 7 have been +created of Japhar, NSPR, a cross platform thread library Japhar uses, +and GNU Classpath. Installing onto a Gnome workstation should provide +the rest of the required libraries automatically. Otherwise, you may +need to install libart and other packages detailed more precisely in +the HACKING file. +</en> +</p> +<p> +<en> +4). What platforms are supported? +</en> +</p> +<p> +<en> +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. +</en> +</p> +<p> +<en> +5). Who should use this software? +</en> +</p> +<p> +<en> +This is a development release only. You should only install it if you +are interested in Classpath development or reporting bugs. We appreciate +both. You might also be interested if you enjoy installing random alpha +software. +</en> +</p> +<p> +<en> +6). Where do I go for more information? +</en> +</p> +<p> +<en> +The project has a web page at + +<createlink url="http://www.classpath.org/" name="http://www.classpath.org/"> + +and + +<createlink url="http://www.gnu.org/software/classpath/classpath.html" + name="http://www.gnu.org/software/classpath/classpath.html"> + +Information on our mailing list is available at the web site. +</en> +</p> diff --git a/libjava/classpath/doc/www.gnu.org/downloads/20020208.wml b/libjava/classpath/doc/www.gnu.org/downloads/20020208.wml new file mode 100644 index 00000000000..2833d938471 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/downloads/20020208.wml @@ -0,0 +1,166 @@ +#!wml --include=.. + +<set-var last-modified-author="mjw"> + +## +# Ignore <en> tags without removing them (may be used in future) +# +<define-tag en endtag=required> +%body +</define-tag> + +#include <include/layout.wml> + +<subject "GNU Classpath 0.03 Announcement (2002-02-08)"> +<h1>GNU Classpath 0.03 Announcement (2002-02-08)</h1> + + +<p> +<en> +We are pleased to announce a new development release of GNU Classpath. +GNU Classpath, Essential Libraries for Java, is a project to create free +core class libraries for use with virtual machines and compilers for the +Java language. +</en> +</p> +<p> +<en> +New in this release are the addition of java.util.zip and java.rmi +packages, VM independent jni.h, more flexible build environment to +separate class and native code generation, out of the box support for +the ORP VM, and lots of bug fixes and updates to make GNU Classpath more +compliant with the 1.2, 1.3 and 1.4 API specification. The copyleft +has been clarified and all code in the library is now distributed under +the same terms. +</en> +</p> +<p> +<en> +Here are the answers to some questions you might have about this project +and this release. +</en> +</p> +<p> +<en> +1). Where can I get it? +</en> +</p> +<p> +<en> +GNU Classpath 0.03 can be downloaded from: + +<createlink url="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.03.tar.gz" + name="ftp://alpha.gnu.org/pub/gnu/classpath/classpath-0.03.tar.gz"> +</en> +</p> +<p> +<en> +2). What is included? +</en> +</p> +<p> +<en> +The following packages (some with subpackages) are supported: +</en> +</p> +<UL> + <LI>java.applet (untested)</LI> + <LI>java.awt (very experimental)</LI> + <LI>java.beans</LI> + <LI>java.io</LI> + <LI>java.lang</LI> + <LI>java.math</LI> + <LI>java.net</LI> + <LI>java.rmi</LI> + <LI>java.security (partially functioning)</LI> + <LI>java.sql</LI> + <LI>java.text (untested)</LI> + <LI>java.util</LI> + <LI>java.util.jar</LI> + <LI>java.util.zip</LI> +</UL> +<p> +<en> +This is enough to run many non-awt programs. Not all classes and +methods are implemented in this release, but most are. Many of the +implemented classes are already up to the 1.2 API spec. Some are +already compliant with the 1.3 and (preliminary) 1.4 API specification. + +More information on the current status of each package can be found at +<createlink url="http://www.gnu.org/software/classpath/status.html" + name="http://www.gnu.org/software/classpath/status.html"> +</en> +</p> +<p> +<en> +3). What is required to build/install/run? +</en> +</p> +<p> +<en> +GNU Classpath requires a working GNU build environment and a byte code +compiler such as jikes, gcj or kjc. When creating native code you will +also need a working C compiler and up to date Gnome development libraries +(gtk+, libart and gdk-pixbuf). More information on the precise version +numbers for the tools and libraries can be found in the INSTALL file. +</en> +</p> +<p> +<en> +4). What platforms and VMs are supported? +</en> +</p> +<p> +<en> +GNU/Linux is the only platform that has been tested. We plan to +eventually support many others. +</en> +</p> +<p> +<en> +This release support ORP 1.0.9 out of the box. But other compilers and +virtual machines such as gcj, Kissme, SableVM, Jupiter and Jaos also work +with slightly customized versions of GNU Classpath. Please check if there +is a customized version available for the VM you use before trying the bare +bones GNU Classpath release. We are working with the VM creators to keep +the differences between the core classes as small as possible. +</en> +</p> +<p> +<en> +5). Who should use this software? +</en> +</p> +<p> +<en> +Although it is already capable of supporting many Java applications, +this is a development release. As such, there are still many unfinished +components, and some problems are to be expected. You should install it +if you are interested in Classpath development or reporting bugs. We +appreciate both. +</en> +</p> +<p> +<en> +6). Where do I go for more information? +</en> +</p> +<p> +<en> +The project home page with information on our mailing list can be found at + +<createlink url="http://www.classpath.org/" name="http://www.classpath.org/"> + +or + +<createlink url="http://www.gnu.org/software/classpath/classpath.html" + name="http://www.gnu.org/software/classpath/classpath.html"> +</en> +</p> +<p> +<en> +The bug database, CVS, task-manager and latest news can be found on Savannah at +<createlink url="http://savannah.gnu.org/projects/classpath/" + name="http://savannah.gnu.org/projects/classpath/"> +</en> +</p> diff --git a/libjava/classpath/doc/www.gnu.org/downloads/Makefile b/libjava/classpath/doc/www.gnu.org/downloads/Makefile new file mode 100644 index 00000000000..9f217023d4d --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/downloads/Makefile @@ -0,0 +1,32 @@ +ifndef WMK + export WMK=wmk +endif +ifndef WML + export WML=wml +endif + +WML_SRC = $(wildcard *.wml) +WML_OBJS = $(patsubst %.wml,%.html,$(WML_SRC)) + +%.html: %.wml ../include/macros.wml ../include/layout.wml + $(WML) -o $@ $< +# -rm -f $(patsubst %.wml,%.html,$<) + +all : $(WML_OBJS) subdirs + +.PHONY : clean +clean : + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE) clean";) + -rm -f *.html + +.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)/downloads/ + diff --git a/libjava/classpath/doc/www.gnu.org/downloads/downloads.wml b/libjava/classpath/doc/www.gnu.org/downloads/downloads.wml new file mode 100644 index 00000000000..48bbe5ea270 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/downloads/downloads.wml @@ -0,0 +1,211 @@ +#!wml --include=.. + +#include "include/layout.wml" + +## +# +# Special Tags +# + +<: +sub mylink { + my ($name, $url) = @_; + + if ($url eq "") { + return "not available"; + } else { + return '<a href="$url">$name</a>'; + } +} +:> + +<define-tag maybelink> + <preserve name> + <preserve url> + <set-var %attributes> + <:{ + my $name = qq|<get-var name>|; + my $url = qq|<get-var url>|; + + if ($url eq '') { + print "not available"; + } else { + print "<a href=\"$url\">$name</a>"; + } + }:> + <restore url> + <restore name> +</define-tag> + +<define-tag download-block endtag=required> + <div align="center"> + <table cellspacing="2" cellpadding="4"> + <tr><th>Version</th><th colspan="2">Links</th></tr> + %body + </table> + </div> +</define-tag> + +<define-tag download> + <preserve date> + <preserve version> + <preserve url> + <preserve notes> + <set-var %attributes> + + <tr bgcolor="#CCCCCC"> + <td align="center"><strong><get-var version></strong> / <get-var date></td> + <td align="center"><maybelink name="download" url="<get-var url>"></td> + <td align="center">[ <maybelink name="release notes" url="<get-var notes>"> ]</td> + </tr> + + <restore notes> + <restore url> + <restore version> + <restore date> +</define-tag> + +<set-var last-modified-author="prk"> + +<subject "GNU Classpath Downloads"> + +<box> +<boxtitle><a name="downloads">Classpath Downloads::Current Version</a></boxtitle> + +<boxitem> + +<download-block> + +<download + date="15 July 2005" + version="0.17" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.17.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20050715.html" +> + +<!-- download + date="yesterday" + version="tarball" + url="" + notes="" +---> + +</download-block> +</boxitem> + + +<boxtitle><a name="downloads">Classpath Downloads::Archive</a></boxtitle> + +<boxitem> + +<download-block> +<download + date="30 June 2005" + version="0.16" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.16.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20050630.html" +> +<download + date="29 April 2005" + version="0.15" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.15.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20050429.html" +> +<download + date="26 February 2005" + version="0.14" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.14.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20050226.html" +> + +<download + date="6 January 2005" + version="0.13" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.13.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20050107.html" +> + +<download + date="15 November 2004" + version="0.12" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.12.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20041115.html" +> + +<download + date="13 September 2004" + version="0.11" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.11.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20040913.html" +> +<download + date="12 July 2004" + version="0.10" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.10.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20040712.html" +> +<download + date="02 May 2004" + version="0.09" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.09.tar.gz" + notes="http://www.gnu.org/software/classpath/announce/20040502.html" +> +<download + date="13 Mar. 2004" + version="0.08" + url="ftp://ftp.gnu.org/gnu/classpath/classpath-0.08.tar.gz" +> +<download + date="05 Dec. 2003" + version="0.07" + url="ftp://alpha.gnu.org/gnu/classpath/classpath-0.07.tar.gz" +> + +<download + date="09 Sep. 2003" + version="0.06" + url="ftp://alpha.gnu.org/gnu/classpath/classpath-0.06.tar.gz" + notes="http://savannah.gnu.org/forum/forum.php?forum_id=2466" +> + +<download + date="16 Feb. 2003" + version="0.05" + notes="http://mail.gnu.org/archive/html/classpath/2003-02/msg00043.html" +> + +<download + date="06 May. 2002" + version="0.04" + notes="http://mail.gnu.org/archive/html/classpath/2002-05/msg00061.html" +> + +<download + date="08 Feb. 2002" + version="0.03" + notes="downloads/20020208.html" +> + +<download + date="06 Jan. 2001" + version="0.02" + notes="downloads/20010106.html" +> + +<download + date="20 Nov. 2000" + version="0.01" + notes="downloads/20001120.html" +> + +<download + date="06 Feb. 1999" + version="0.00" + notes="downloads/19990206.html" +> + + +</download-block> +</boxitem> + +</box> diff --git a/libjava/classpath/doc/www.gnu.org/events/.cvsignore b/libjava/classpath/doc/www.gnu.org/events/.cvsignore new file mode 100644 index 00000000000..2d19fc766d9 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/events/.cvsignore @@ -0,0 +1 @@ +*.html diff --git a/libjava/classpath/doc/www.gnu.org/events/Makefile b/libjava/classpath/doc/www.gnu.org/events/Makefile new file mode 100644 index 00000000000..62145274798 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/events/Makefile @@ -0,0 +1,32 @@ +ifndef WMK + export WMK=wmk +endif +ifndef WML + export WML=wml +endif + +WML_SRC = $(wildcard *.wml) +WML_OBJS = $(patsubst %.wml,%.html,$(WML_SRC)) + +%.html: %.wml ../include/macros.wml ../include/layout.wml + $(WML) -o $@ $< +# -rm -f $(patsubst %.wml,%.html,$<) + +all : $(WML_OBJS) subdirs + +.PHONY : clean +clean : + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE) clean";) + -rm -f *.html + +.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)/events/ + diff --git a/libjava/classpath/doc/www.gnu.org/events/escape_fosdem05.wml b/libjava/classpath/doc/www.gnu.org/events/escape_fosdem05.wml new file mode 100644 index 00000000000..78fe412134d --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/events/escape_fosdem05.wml @@ -0,0 +1,149 @@ +#!wml --include=.. + +#include "include/layout.wml" + +<set-var last-modified-author="mjw"> +<subject "Escape the Java Trap @ Fosdem 2005"> + +<box> +<boxitem> +<h2>Escape the Java Trap! - GNU Classpath Hacker Room</h2> + +<i>Fosdem, Saturday/Sunday 26/27 February 2005, Brussels, Belgium</i> +<p> +<b>UPDATE: Presentations are now linked below!</b> +<p> +The Fosdem organisation has generously offered the developers of +various projects around GNU classpath the opportunity to meet face +to face in their own developer room. +<p> +We have brought together a wide range of different speakers from +various projects that together provide a free software alternative to +the proprietary java platform. Developers from these various projects +will come from all over the world to discuss cooperation and to make +development plans to the next year. +<p> +You are very welcome to join us and learn about the IKVM architecture +and how to freely mix and match traditional java and .net applications +and libraries, how GNU and Apache developers can and should work +together, how you can do rapid GNOME desktop development through +java-gnome, how researchers are using GNU Classpath to do cutting edge +research into Just In Time compilation, see demonstrations of +lightning fast native eclipse, learn what will be possible with GNU +Classpath and GCC 4.0, whether Kaffe will ever release their version +1.1.5, what we think about compatibility, freedom vs control and +learn how you can create your own GNU Compiler Collection frontend for +languages such as the 1.5 java programming language. +<p> +Full schedule and abstracts at <a +href="http://www.fosdem.org/2005/index/dev_room_classpath/schedule">http://www.fosdem.org/2005/index/dev_room_classpath/schedule</a> +<p> +</boxitem> + +<boxitem> + <h3>Saturday 14:00 - 17:00 - "Building Bridges"</h3> + + <p> + Reaching out to other communities. + How can GNU Classpath, GCC/GCJ and Kaffe hackers + learn from and work together with others? + </p> + <p> + <b>14:00 - 14:50</b> <i>Jeroen Frijters</i> + <a href="http://www.frijters.net/fosdem2005.sxi">IKVM.NET -- Motivation and Architecture</a> (sxi) + </p> + <p> + <b>15:00 - 15:50</b> <i>Leo Simons</i> + <a href="http://www.apache.org/~leosimons/presentations/fosdem2005/gump@fosdem.pdf">Apache Gump -- Continuous integration on steroids</a> (pdf) + </p> + + <p> + <b>16:00 - 16:50</b> <i>Jeffrey Morgan</i> + <a href="http://java-gnome.sourceforge.net/presentations/fosdem05/img0.html">Liberation through Binding! -- Using java-gnome to build desktop applications</a> (html) + </p> + <p> + <b>17:00 - 17:30</b> <i>Christian Thalinger</i> + <a href="http://www.complang.tuwien.ac.at/cacaojvm/papers/fosdem2005.ps">CACAO -- From the fastest JIT to a JVM</a> (ps) + </p> +<p> +</boxitem> + +<boxitem> + <h3>Sunday 10:00 - 13:00 - "Demo Time!"</h3> + <p> + Public presentations and overviews of the current state of the + GNU Classpath library , GCC/GCJ(X) compiler and Kaffe runtime. + </p> + <p> + <b>10:00 - 10:50</b> + <i>Thomas Fitzsimmons</i> + <a href="http://people.redhat.com/fitzsim/fosdem-2005/html/fosdem-2005-presentation.html">Free AWT and Swing -- The GUI parts of GNU Classpath</a> (html) + (<a href="http://people.redhat.com/fitzsim/fosdem-2005/fosdem-2005-presentation.sxi">sxi</a>) + </p> + <p> + <b>11:00 - 11:50</b> + <i>Tom Tromey</i> + <a href="http://www.peakpeak.com/~tromey/fosdem-2005.sxi">GCJX -- Writing a new GCC front end</a> (sxi) + </p> + <p> + <b>12:00 - 12:50</b> + <i>Dalibor Topic</i> + <a href="http://www.kaffe.org/~robilad/kaffe-past-present-future-FOSDEM05.pdf">Kaffe -- Past, Present and Future</a> (pdf) + </p> +<p> +<boxitem> + +<boxitem> + <b>Extra (13h15 - 13h30) GCJ & Native Eclipse</b> + <p> + <i>Bryce McKinlay</i> -- Lightning Talk. + GCJ and the Eclipse IDE: desktop application development with Java-gnome. + </p> +<p> +</boxitem> + +<boxitem> + <h3>Sunday 14:00 - 17:00 - "The Future"</h3> + <p> + + Technical Planning Session + <p> + This 3 hour session for hackers will consist of: + <ul> + <li> A general part explaining what is needed. + <li> Splitting up in groups to discuss specific topics to + solve the problems and make development plans. + <li> A short present by each group about the ideas discussed. + </ul> + <p> + Please add ideas and suggestions to the WIKI: +<a href="http://developer.classpath.org/mediation/Fosdem2005">http://developer.classpath.org/mediation/Fosdem2005</a> +<p> +</boxitem> + +<boxitem> +<b>Additional Resources:</b> +<ul> +<li><createlink name="Free But Shackled - The Java Trap" + url="http://www.gnu.org/philosophy/java-trap.html"> + (by Richard Stallman) +</li> +</ul> +<p> +<boxitem> + +<boxitem> +<b>Official links:</b> +<ul> +<li><createlink name="FOSDEM Homepage" + url="http://www.fosdem.org/"> +</li> +<li><createlink name="GNU Classpath Room" + url="http://www.fosdem.org/2005/index/dev_room_classpath/"> +</li> +<li><createlink name="GNU Classpath Room Schedule" + url="http://www.fosdem.org/2005/index/dev_room_classpath/schedule/"> +</li> +</ul> +<boxitem> +</box> diff --git a/libjava/classpath/doc/www.gnu.org/events/events.wml b/libjava/classpath/doc/www.gnu.org/events/events.wml new file mode 100644 index 00000000000..fcb3de9019d --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/events/events.wml @@ -0,0 +1,28 @@ +#!wml --include=.. + +#include "include/layout.wml" + +<set-var last-modified-author="prk"> +<subject "GNU Classpath Events"> + +<box> +<boxitem> +<strong>Upcoming Events:</strong><br> +<ul> +none +</ul> +</boxitem> + +<boxitem> +<strong>Past Events:</strong><br> +<ul> +<li>[26+27 Feb. 2004] FOSDEM'05 in Brussels, Belgium. [<createlink name="Escape The Java Trap!" url="events/escape_fosdem05.html">] +<li>[14+15 Oct. 2003] Linux Kongress '03 in Saarbrücken, Germany. +<li>[21+22 Feb. 2004] FOSDEM'04 in Brussels, Belgium. [<createlink name="report" url="events/fosdem04.html">] +<li>[14+15 Oct. 2003] Linux Kongress '03 in Saarbrücken, Germany. +</ul> +<br><br><br> +</boxitem> + + +</box> diff --git a/libjava/classpath/doc/www.gnu.org/events/fosdem04.wml b/libjava/classpath/doc/www.gnu.org/events/fosdem04.wml new file mode 100644 index 00000000000..257a7b671ea --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/events/fosdem04.wml @@ -0,0 +1,100 @@ +#!wml --include=.. + +#include "include/layout.wml" + +<set-var last-modified-author="prk"> +<subject "GNU Classpath: FOSDEM'04"> + +<box> +<boxitem> +<h2>GNU Classpath at FOSDEM'04</h2> + +Saturday, 21 February 2004 + +A whole room was devoted to Free Java Developers. The following talks took place: +<ul> +<li><strong>GNU Classpath -- Core Classes for a Diversity of Free Java Virtual Machines</strong>, Sascha Brawer and Mark Wielaard (GNU Classpath)<br> +[<createlink name="slides" url="http://www.dandelis.ch/people/brawer/articles/classpathFeb2004/">]<br> +<i>Mark presented an overview of the GNU Classpath project, the current development state, and the problems encountered, in particular the ability to fit so many JVM with different requirements and constraints</i> + +<li><strong>SableVM - the Apache of Java Virtual Machines</strong>, Grzegorz B. Prokopski (SableVM)<br> +[<createlink name="slides" url="http://gadek.debian.net/FOSDEM/">]<br> +<i>Grzegorz presented the SableVM JVM and its technical details; a whole unter the hood tour, including the use of m4 macro expansion for generating the VM code and an overview of interpreter and JIT techniques used.</i><br> + + +<li><strong>fbAWT - Direct to your buffer</strong>, Stephane Meslin-Weber<br> +<i>Stephane presented his project to map AWT directly to a framebuffer and VNC, and made a short demo of it.</i> + +</ul> + +Sunday, 22 February 2004 + +There was a whole track of Java-related presentations: + +<ul> +<li><strong>JOnAS</strong>, Florent Benoit (WebObjects) +<li><strong>GCJ</strong>, Tom Tromey (GCJ, Red Hat)<br> +[<createlink name="slides" url="http://www.peakpeak.com/~tromey/FOSDEM/gcj.html">]<br> +<i>Tom presented the GCJ project and its goals. Many details on performance and status.</i><br> + +<li><strong>NetBeans</strong>, Ian Formanek (Sun) +<li><strong>Java Security: How Free Software Is Secured Using the Java Language +</strong>, Sascha Brawer (GNU Classpath, Dandelis)<br> +Abstract: After a general introduction to why Java seems a reasonable choice for +writing large and robust free software packages, the talk discusses the +security features of the Java platform. It is shown how several actors +play together to ensure type safety, encapsulation and declarative access +control. Four concrete denial-of-service attacks illustrate the +importance of enhancing the platform by techniques for managing resource +consumption. +<br>[<createlink name="slides" url="http://www.dandelis.ch/people/brawer/articles/classpathSecurity/">] +</ul> + +</ul> + +In the afternoon, more discussions took place in the Free Java Developers room. + +<ul> +<li><strong>Packaging Free Java Applications For Free Operating Systems</strong>, Dalibor Topic (Kaffe) and Arnaud Vandyck (Debian)<br> +[<createlink name="Wiki" url="http://java.debian.net">]<br> +<i>Dalibor and Arnaud explained the problems encountered while packaging Java for Debian.</i> + +<li><strong>Free Discussion</strong><br> +<i>A proposal by Andrew Haley (GCJ) for the standardization of the JIT interface in the VM was discussed.</i> + +</ul> + +</boxitem> +<boxitem> +In Mark Wielaard's words +<ul> +<li> <i>There were between 20 and 50 people following the different +presentations, talks and discussions in our developer room. And Tom +Tromey his talk on gcj in the big room got 120 interested people.</li> +<li> <i>We could have had more in depth technical discussions. Most of the +presentations now were more overviews of what was already there. Which +is great for attracting new developers and explaining our goals to +outsiders. But for next time we must really appoint people that lead +some technical issue. Many thanks to Andrew for just standing up and +starting the pluggable JIT interface discussion by telling how gcj would +like to support it. +</i> + +</ul> + +See his whole message in the <createlink name="mail archive" url="http://mail.gnu.org/archive/html/classpath/2004-02/msg00051.html">. +</boxitem> +<boxitem> +Additional Resources: +<ul> +<li><createlink name="GNU Classpath's Flyer" url="http://www.klomp.org/mark/classpath/fosdem/"> (Kudos to Mark Wielaard) +<li><createlink name="Group Picture" url="http://adorphuye.com/gallery/FOSDEM2004/IMGP0234"> (thanks to Stephane Meslin-Weber) +</ul> + +Official links: +<ul> +<li><createlink name="FOSDEM Homepage" url="http://www.fosdem.org"> +<li><createlink name="FOSDEM Java Dev Room" url="http://www.fosdem.org/2004/index/dev_room_java/"> +<li><createlink name="FOSDEM Java Dev Room Schedule" url="http://www.fosdem.org/2004/index/dev_room_java/schedule/"> +</ul> +</box> diff --git a/libjava/classpath/doc/www.gnu.org/external.wml b/libjava/classpath/doc/www.gnu.org/external.wml new file mode 100644 index 00000000000..f3624a8653a --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/external.wml @@ -0,0 +1,86 @@ +#include "include/layout.wml" + + +## +# +# Special Tags +# + +<define-tag tool endtag=required> + <preserve maintainer> + <preserve name> + <preserve url> + <set-var %attributes> + + <boxtitle><a name="<get-var name>">Classpath External Tools::<get-var name></a></boxtitle> + <boxitem> + <table cellspacing="4"> + <tr><td valign="top"><strong>Maintainer</strong></td><td><get-var maintainer></td></tr> + <tr><td valign="top"><strong>Link</strong></td><td><createlink name="<get-var url>" url="<get-var url>"></td></tr> + <tr><td valign="top"><strong>Description</strong></td><td>%body</td></tr> + </table> + </boxitem> + <restore url> + <restore name> + <restore maintainer> +</define-tag> + + + + +<set-var last-modified-author="prk"> +<subject "GNU Classpath External Tools"> + +<box> +<boxtitle><a name="packages">Classpath::External Packages</a></boxtitle> + +<boxitem> +<en> +<p>Below is a table of providers for free core packages not part of GNU Classpath +</p> + +<project-list> +<project name="GNU ClasspathX" url="http://www.gnu.org/software/classpathx/"> +<ul> +<li>javax.activation +<li>javax.infobus +<li>javax.xml +<li>javax.mail +<li>javax.servlet +<li>javax.speech +</ul> +</project> + +<project name="GNU Crypto" url="http://www.gnu.org/software/gnu-crypto/"> +<ul> +<li>javax.crypto +</ul> +</project> + +<project name="Jessie" url="http://www.nongnu.org/jessie/"> +<ul> +<li>javax.net.ssl +</ul> +</project> + +<project name="Tritonus" url="http://tritonus.org/"> +<ul> +<li>javax.sound +</ul> +</project> + +</project-list> +</en> + +</boxitem> + +<tool + name="Jalopy" + maintainer="Tom Tromey" + url="ftp://sources.redhat.com/pub/java/jalopy-console-1.0.4.tar.gz" +> +Jalopy is a pretty-printer to format Java code. To do our coding style you also need this +<a href="ftp://sources.redhat.com/pub/java/GNU.xml">style definition file</a>. +</tool> + +</box> diff --git a/libjava/classpath/doc/www.gnu.org/faq/.cvsignore b/libjava/classpath/doc/www.gnu.org/faq/.cvsignore new file mode 100644 index 00000000000..2d19fc766d9 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/faq/.cvsignore @@ -0,0 +1 @@ +*.html diff --git a/libjava/classpath/doc/www.gnu.org/faq/Makefile b/libjava/classpath/doc/www.gnu.org/faq/Makefile new file mode 100644 index 00000000000..584db90dc86 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/faq/Makefile @@ -0,0 +1,32 @@ +ifndef WMK + export WMK=wmk +endif +ifndef WML + export WML=wml +endif + +WML_SRC = $(wildcard *.wml) +WML_OBJS = $(patsubst %.wml,%.html,$(WML_SRC)) + +%.html: %.wml ../include/macros.wml ../include/layout.wml + $(WML) -o $@ $< +# -rm -f $(patsubst %.wml,%.html,$<) + +all : $(WML_OBJS) subdirs + +.PHONY : clean +clean : + $(foreach dir, $(SUBDIRS), sh -c "cd $(dir) && $(MAKE) clean";) + -rm -f *.html + +.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)/faq/ + diff --git a/libjava/classpath/doc/www.gnu.org/faq/faq.wml b/libjava/classpath/doc/www.gnu.org/faq/faq.wml new file mode 100644 index 00000000000..25c6dd1e8dd --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/faq/faq.wml @@ -0,0 +1,585 @@ +#!wml --include=.. + +#include "include/layout.wml" + +## +# +# Special Tags +# + + + +# +# <faq-section name="XYZ> +# <faq question="ABC">answer</faq> +# <faq question="ABC">answer</faq> +# </faq-section> +# + +# the section counter +# +<set-var __SECCNT=1> + +<define-tag faq-section endtag=required> + <preserve name> + <set-var %attributes> +{#FAQINDEX#: + <boxtitle><get-var __SECCNT>. <get-var name></boxtitle> + <boxitem> +:#FAQINDEX#} + <boxtitle><get-var __SECCNT>. <get-var name></boxtitle> + <set-var __FAQCNT=1> + <boxitem>%body</boxitem> +{#FAQINDEX#: + <br> + </boxitem> +:#FAQINDEX#} + <increment __SECCNT> + <restore name> +</define-tag> + +<define-tag faq endtag=required> +<preserve question> +<set-var %attributes> +{#FAQINDEX#: + <strong><a href="faq/faq.html#faq<get-var __SECCNT>_<get-var __FAQCNT>"><get-var __SECCNT>.<get-var __FAQCNT> <get-var question></a></strong><br> +:#FAQINDEX#} + <h3><a name="faq<get-var __SECCNT>_<get-var __FAQCNT>"><get-var __SECCNT>.<get-var __FAQCNT> <get-var question></a></h3> + %body + <br> +<increment __FAQCNT> +<restore question> +</define-tag> + + +<set-var last-modified-author="prk"> + +<subject "GNU Classpath FAQ"> + +<box> +{#FAQINDEX#} + +<faq-section name="introduction"> +<faq question="What is GNU Classpath?"> +<p>GNU Classpath is a set of essential libraries for supporting +the Java programming language.</p> + +<p>Classpath serves the same role that <a +href="http://www.gnu.org/software/libc/libc.html">libc</a> has for C, +but is much richer in functionality. The broadness of the standard +library is an important reason why Java has been so successful. For +example, the library includes frameworks to convert between character +encodings, for accessing relational databases, for building Graphical +User Interfaces, for encryption, for logging, and for numerous other +tasks that are needed to build complex applications.</p> + +</faq> + +<faq question="Why Java?"> +<p>On the GNU operating system, we want to run software independent of +the programming language in which it was written. Because Java is +widespread, and because Java has some nice features, we want to +support Java as well.</p> + +</faq> + +<faq question="But isn't Java free already?"> +<p>Sun Microsystems, the company who has created Java, currently +distributes the “Java Development Kit” and “Java +Runtime Environment” at no cost. The former even comes with the +source code of the standard class library. However, the “Sun +Community Source License” <a +href="http://www.gnu.org/licenses/license-list.html#SunCommunitySourceLicense">does +not grant essential freedoms</a>, for example the right to distribute +a modified version of the code.</p> + +<p>Therefore, Sun’s implementation does not qualify as Free +Software.</p> + +</faq> + +<faq question="What do we need to make Java free?"> + +<p>Though it would be helpful if Sun would open their sources, this is not the +most important step toward a free Java. Even more important for a free Java are: +<ul> +<li>Access to the TCK (Technology Compatibility Kits) on acceptable terms +<li>Involvement in the JCP without contamination or other unacceptable + constraints +<li>Easing of the requirements on subsetting. The free software + community doesn't work well with the "one big perfect release" + model that Sun seems to want. +</ul> + +<p>There was already a lot of discussions around this topic on other sites: +<ul> +<li><createlink name="Sys-Con: <i>Let's Bundle Free Java with Linux</i>, Says IBM's Sutor" url="http://sys-con.com/story/print.cfm?storyid=43969"> +<li><createlink name="Hacking Log 4.0: RE: JCP 2.6 - Are we there yet?" url="http://linuxintegrators.com/blog/acoliver/news/?permalink=0124.html"> +<li><createlink name="Javalobby: ESR - Open Letter to Sun: Let Java Go" url="http://www.javalobby.org/thread.jspa?forumID=61&threadID=11412"> +</ul> + + +</faq> + +<faq question="Is GNU Classpath all that is needed for running Java programs?"> +<p>GNU Classpath is a free implementation of Java’s standard +library. To execute Java programs, it is also necessary to have a +Java Virtual Machine (JVM). This component manages memory, enforces +security restrictions, compiles Java bytecodes to the instruction set +of your computer, and provides other runtime services. There exist +several projects for <createlink name="free JVMs" url="stories.html#jvm">. Most use GNU Classpath as the +up-stream source for their library.</p> + +<p>Java programs can also be compiled “ahead of time,” +like C++ or other compiled languages. The GNU Compiler Collection +(GCC) does this, and its Java library is mostly derived from GNU +Classpath.</p> +</faq> + +</faq-section> + +<faq-section name="licensing"> + +<faq question="Under which licence is GNU Classpath released?"> +GNU Classpath is licensed under the GPL plus a special exception: + +<blockquote> +<p> +<code> +Linking this library statically or dynamically with other modules is +making a combined work based on this library. Thus, the terms and +conditions of the GNU General Public License cover the whole +combination. +</code> +</p> +<p> +<code> +As a special exception, the copyright holders of this library give you +permission to link this library with independent modules to produce an +executable, regardless of the license terms of these independent +modules, and to copy and distribute the resulting executable under +terms of your choice, provided that you also meet, for each linked +independent module, the terms and conditions of the license of that +module. An independent module is a module which is not derived from +or based on this library. If you modify this library, you may extend +this exception to your version of the library, but you are not +obligated to do so. If you do not wish to do so, delete this +exception statement from your version. +</code> +</p> +</blockquote> + +</faq> + +<faq question="Where can I find more about the GPL?"> +Please check the FSF FAQ on the GNU GPL: <createlink name="http://www.fsf.org/licenses/gpl-faq.html" url="http://www.fsf.org/licenses/gpl-faq.html">. +</faq> + +<faq question="What does the exception allow me to do?"> +<p>If you combine GNU Classpath <em>with independent modules to produce an +executable</em> you can <em>copy and distribute the resulting executable under +terms of your choice</em>.</p> + +<p>So you can use and distribute GNU Classpath as is in your program without changing the license of your software.</p> +</faq> + +<faq question="I have a question about licensing GNU Classpath. Who can I ask?"> +Direct such questions to <a href="mailto:licensing@gnu.org">licensing@gnu.org</a>. The FSF is the +official copyright holder of Classpath and sets the distribution terms +</faq> + +<faq question="How can I be sure that my application does not break the license?"> +The FSF has a GPL-compliance lab which offers consulting services for +companies who are working to develop products that incorporate Free +Software so that they can do so in ways that comply with the terms of +the GPL and other Free Software licenses. If you are interested in this +service, please write to <a href="mailto:compliance-lab@fsf.org">compliance-lab@fsf.org</a>. +</faq> +</faq-section> + +<faq-section name="Classpath Development"> + +<faq question="I would like to contribute, where shall I start?"> +<p>See the <a +href="docs/">documentation page</a>, especially the <a +href="docs/hacking.html">GNU +Classpath Hacker’s Guide</a>, and pick up a <createlink name="task" url="tasks.html"> from the list! +</faq> + +<faq question="Can I look at source code distributed with other +implementations to get inspiration?"> +If you are going to contribute source code to GNU Classpath we must +make sure that you have not studied the source code of the JDK/JRE or +decompiled any of its classes. Furthermore you must not have signed +any non-disclosure agreements with Sun or other companies in regard +with java technology that might cover the core class libaries or +tools. The reason for this requirement is that we want to make sure +that Sun or any other company cannot rightfully claim that GNU +Classpath infringes their copyright. You are therefore questioned +about your experience with other implementations of similar source +code and any agreements with companies you might have signed when you +request to contribute to GNU Classpath. +<p> +Please note that this does not mean you cannot help GNU Classpath at +all in such a case. Here is a list of things you can do instead: +<ul> + <li>write Mauve test cases</li> + <li>write example applications demonstrating the usage of the packages</li> + <li>writing/fixing helper programs (like japitools) and scripts</li> + <li>report bugs</li> + <li>help fixing the documentation</li> + <li>help in other related Free software projects + (e.g. virtual machine development, + <createlink name="GUMP" url="http://gump.apache.org/">) +</ul> +<p> +Here are some rough guidelines for deciding whether or not it would be +wise to accept a contribution from someone that studied source code +for another implementation of the core libraries or is under contract +with some company covering implementations of core library classes. +<p> +If the developer got access to the source code by signing some +contract (like the SCSL) with Sun then it would be best to examine +that contract (by FSF legal) before deciding. +<p> +If the developer just accidentally saw some of the source code and had +no intention (and didn't actually) study the implementation (with the +intention of contributing to GNU Classpath) there is no problem. +<p> +Studying a proprietary implementation with the intention of +implementing it (better) for GNU Classpath is a clear no-no. +<strong>The general rule is that if you have looked at or studied any +(proprietary) implementation of a package you should not work on that +package for GNU Classpath.</strong> That is because it would be +difficult to proof that you really did an independent +implementation. Since what you create might look very similar (which +is not unlikely). Working on something completely unrelated is OK (as +long as there are no contractual obligations with Sun or some other +company to not do this of course). +<p> +The important thing is that we want to be clear on the fact that we +created an independent implementation. We don't want to get into +tricky legal situations. We want to avoid risking to go to court over +reverse engineering or clean room situation questions if not +absolutely necessary. That is why we in general just say "please don't +contribute if you looked at other implementations". If someone thinks +that their actions might be explained as copying directly or +indirectly another (proprietary) implementation then that could be a +problem that we want to avoid. +<p> +FSF Legal will always advise not to take any unnecessary risks that +might endanger the (perceived) free software status of a GNU +project. (If we might need to go to court to proof that what we did +was OK, then don't!) +<p> +This isn't a GNU Classpath project specific issue. +See <createlink name="GNU: Reading Non-Free Code" +url="http://www.gnu.org/prep/standards/html_node/Reading-Non_002dFree-Code.html">. +</faq> + +<faq question="I'm tainted by; can I help anyway?"> +Even if you have seen Sun's source and you cannot contribute code to GNU Classpath, there are still many way you can help us. + +Here's a few examples of contributions you can make that would greatly help us: +<ul> +<li>Mauve test cases +<li>Example programs for GNU Classpath +<li>Documentation fixes +<li>Help programs (e.g. japitools) and scripts +</ul> + +In general, if you just accidentally saw some of the source code and had no intention (and didn't actually) study the implementation (with the intention of contributing to GNU Classpath), there is no problem. + +In case of doubt, please refer to FSF legal. +</faq> + +<faq question="Why do I have to give the copyright to the FSF?"> +Some contributors of Classpath might be annoyed if their work was being +used under conditions that are not according to the terms of the license. +However, enforcing the license in court (if this was ever needed) would +be easier if the Free Software Foundation can claim to speak in the name +of all authors. For this reason, and for others that are specific to the +intellectual property system of the United States, GNU projects tend to +be a bit picky about getting signatures from all contributors. Please do +not see this as a personal offence. + +<p>Giving the copyright to the FSF also gives us a clear paper trail where changes come from, which confirms our clean-room status. + +<p>See also <a href="http://www.gnu.org/licenses/why-assign.html">http://www.gnu.org/licenses/why-assign.html</a>. +</p> + +<p>For getting the assignment form, please send an e-mail with your name (as +it appears in your passport) and your current postal address to the +maintainer of GNU Classpath, Mark Wielaard <mark@klomp.org>. +</p> +</faq> + +<faq question="How do I install GNU Classpath?"> +<p>Follow these steps to install GNU Classpath. Please note that you need this only if you want to work directly with it; usually JVMs contain a pre-packaged version of GNU Classpath. + +<bold>Prerequisites</bold> + +Please check the exact version of the prerequisites from your release's INSTALL file. + +In every case, you need: +<ul> +<li>GNU gmake +<li>GNU autoconf +<li>GNU automake +<li>GNU libtool +</ul> + +For building the Java bytecode (.class files), one of these compilers are required. You can select which compiler using --with-jikes, --with-gcj or --with-kjc as argument to configure; the present default is gcj. + +<ul> +<li>GCJ (part of GNU GCC) +<li>IBM Jikes +</ul> + +For building the JNI native libraries, the following are required unless --disable-gtk-peer is used as an argument to configure. +<ul> +<li><createlink name="GTK+ 2" url="http://www.gtk.org/"> +<li>gdk-pixbuf +</ul> + +For building the documentation you will need: +<ul> +<li>texinfo +</ul> + +<bold>Install from CVS</bold> + +<commented-code> +<code-line code="cvs checkout" /> +<code-line code="./autogen.sh" /> +<code-line code="./configure" /> +<code-line code="make" /> +</commented-code> + +<bold>Install a release</bold> +<commented-code> +<code-line code="<createlink url="ftp://ftp.gnu.org/gnu/classpath/">"> + Download the current release +</code-line> +<code-line code="tar zxf classpath-<i>version</i>.tar.gz"> + unpack +</code-line> +<code-line code="cd classpath-<i>version</i>" /> +<code-line code="more INSTALL"> + make sure you have all pre-requirements +</code-line> +<code-line code="./configure"> + configure the distribution; use <code>--help</code> to get the list of options: you will usually need <code>--prefix=<i>dest/dir/for/classpath</i>; use <code>--disable-gtk-peer</code> if you don't use gtk+/gnome. +</code-line> + +<code-line code="make; make install" /> +</commented-code> + + +</faq> + +<faq question="How do I install Mauve?"> + +<commented-code> +<code-line code="export CVSROOT=:ext:anoncvs@bogus.example.com:/cvs/mauve" /> +<code-line code="cvs login">password is anoncvs</code-line> +<code-line code="cvs checkout mauve" /> +<code-line code="cd mauve" /> +<code-line code="./configure"> +The main thing this does is creating the gnu/testlet/config.java. You could also do this by hand from the config.java.in file +</code-line> +<code-line code="vi batch_runner"> +Edit the script 'batch_runner' to set the variable COMPILER correctly + (there are a couple of example settings) +</code-line> +<code-line code="vi runner"> +Edit script 'runner' to set the variable RUNTIME correctly + (there are a couple of example settings) +</code-line> +<code-line code="./batch_run"> +run ./batch_run and look at the results. You can also run individual tests with<br> +<code>- echo gnu.testlet.java.lang.String.getBytes | jamvm +gnu.testlet.SimpleTestHarness</code><br> +(Option flags are -verbose and -debug) + +</code-line> + +</commented-code> + + +</faq> + +<faq question="How can I synchronize my sources with GNU Classpath?"> + +When developing a JVM that uses GNU Classpath, a copy of GNU Classpath local to the JVM is often used. To keep the Classpath sources synchronized with the main development, a few approaches are possible (we assume here that you are keeping the local copy of Classpath in your JVM revision control software): +<ul> +<li>Use CVS import and CVS update as explained in <createlink url="http://www.cvshome.org/docs/manual/cvs-1.11.14/cvs_13.html#SEC104" name="Section 13: Tracking Thirdparty sources"> of the CVS manual. This works well for minor changes, but has the disadvantage of a limited control on the update / merge of the sources. In fact, most of the developers prefer merging the changes by hand. + +<li>libgcj, which is almost always trying to be +as synchronized as possible with GNU Classpath CVS, has a script +that runs daily which produces a (colored) differences overview +(including patch/diffs). They also put in special markers into the +source for gcj specific changes that the script recognizes. +<ul> +<li>Script can be found at: +<createlink url="http://savannah.gnu.org/cgi-bin/viewcvs/gcc/wwwdocs/bin/gen-classpath-compare"> + +<li>Daily updated result: +<createlink url="http://gcc.gnu.org/java/libgcj-classpath-compare.html"> +</ul> +</ul> + +</faq> + +<faq question="How do I avoid compiling some files or packages?"> +The file <code>lib/standard.omit</code> controls which files are omitted from the compilation. Add a regex with the files to be omitted and rebuild classpath. +</faq> + +<faq question="How do I change classpath's web pages?"> + +<p>To modify and upload GNU Classpath's web pages, you need write access to the CVS. First, checkout the modules "classpath" and "website". + +<p>The web pages are stored in doc/www.gnu.org and are written in wml (Web Meta Language, see <createlink url="http://thewml.org/">). + +<p>A typical page usually looks like this: +<pre> +\#include "include/layout.wml" + +<subject "here goes the page title"> + +<box> + +<boxtitle>Section 1 Title<\boxtitle> +<boxitem> + section 1 contents +<\boxitem> + +.... + +<\box> + +</pre> + +<p>Invoking "make" creates the html pages in the same directory. To copy those pages to another directory, use +<pre> +> export CLASSPATH_WEBROOT=...destination... +> make publish +</pre> + +<p>The steps to publish the pages are: +<ol> +<li>Update ChangeLog +<li>Commit your changes in module Classpath to the CVS +<li>cd doc/www.gnu.org +<li>make +<li>copy the modified / new pages to the website module +<li>commit the changes in the website module +</ol> + +<p>Note that it takes up to an hour for the pages to appear on the GNU website after an upload. + + +</faq> + +<faq question="Is it possible to use Classpath in a prorietary VM?"> + +<p>Only the proprietary VM's vendor can make it work with GNU Classpath, by the nature of the VM being proprietary. GNU Classpath provides well documented and widely used interfaces for interfacing with runtimes. It's up to proprietary VM vendors to make their products work with GNU Classpath, if they wish to do so. If you, as a customer, want the runtime to use GNU Classpath, please talk to your proprietary software vendor. + +<p>You can also try using a free runtime that supports GNU Classpath out-of-the-box instead. + +</faq> + +</faq-section> + +<faq-section name="Classpath Implementation"> + +<faq question="Why does java.lang.Throwable delay the StackTrace array construction?"> + +Well consider what happens in a VM. VMThrowable.fillInStackTrace() is +very fast -- it's just a chain of addresses. +VMThrowable.getStackTrace() is very slow, because it has to convert +all those addresses into StackTraceElements. I suspect that you can +get the trace for the whole stack in less time than it takes to create +a single StackTraceElement. For this reason, the vmState is stored +and lazily converted to a StackTraceElement[]. (<i>Andrew Haley</i>) + +<p> A particular problem is posed by OutOfMemoryException: throwing it shouldn't require any memory (there's none anyway). Some propose that the VM should preallocate it at bootstrap, but this doesn't solve the problem. In Chris Gray's words <i>"if several threads throw OOME at the same time, the stack traces can get mixed up [...snip...] This situation is less improbable than you might think, since if one thread encounters an OOM situation, all other threads should encounter one too. With some forms of co-operative multi-threading you may get away with it, but in the general pre-emptive case you could be living dangerously."</i></p> + +</faq> +</faq-section> + + +<faq-section name="Varia"> +<faq question="How to generate API Documentation with gjdoc/libxmlj?"> + +Beware: generating the complete API Documentation non-trivial and the generation of a full tree takes more then one and half hour (on a 1.4 Ghz Athlon), +150+ MB of memory, at least 25MB of tmp storage, and at least +twice so much in your obj build dir. + +<ol> +<br><li>set the CVS_RSH environment variable to ssh<br> +<br><li>install gcj 3.3.2 (or higher)<br> +<code> +gjdoc CVS :ext:anoncvs@savannah.gnu.org:/cvsroot/cp-tools module gjdoc +</code> +<br><li>install libxmlj<br> +<code> +libxmlj CVS :ext:anoncvs@savannah.gnu.org:/cvsroot/classpathx module libxmlj<br> +make && make install +</code> + +<br><li>For gjdoc add at the start of gnu/classpath/tools/gjdoc/Main.java (main):<br> + +<code> + System.setProperty("javax.xml.transform.TransformerFactory", + "gnu.xml.libxmlj.transform.TransformerFactoryImpl"); +</code> + +<br><li>There is a ant build.xml file, but you can also compile it all by hand together with the external/jaxp/source files from Classpath which can be copied in the src direcrory as follows:<br> + +<code> + find * -name \*.java | xargs gcj -O2 -g -o gjdoc \<br> + --main=gnu.classpath.tools.gjdoc.Main +</code> + +<br><li>Create a simple gjdoc script and put it in your PATH:<br> + +<code> + #!/bin/sh<br> + CLASSPATH=/home/mark/src/libxmlj:/home/mark/src/gjdoc/src/resources \<br> + LD_LIBRARY_PATH=/usr/local/libxmlj/lib \<br> + /home/mark/src/gjdoc/src/gjdoc $* +</code> + +<br><li>Configure classpah with --enable-gjdoc. +<br><li>Type make and go get yourself some coffe, take a shower and do some work in the garden. +</ol> + +<p>There is one catch. The above setup is completely broken for some HTML +entities (see [bugs #4823] HTML entities such as auml and nbsp should be +put back in the API doc). So if you have spectacular and mysterious +crashes then make sure that your java source files don't contain such +entities. + + +<p>Alternatively, you may also try the following command (the one used to generate the doc on <createlink url="http://developer.classpath.org/doc/">):<br> +<ul> +<code> +$(GJDOC) -public -use \<br> + -sourcepath "$(sourcepath)" \<br> + -encoding UTF-8 \<br> + -breakiterator \<br> + -licensetext \<br> + -linksource \<br> + -splitindex \<br> + -d html \<br> + -doctitle "GNU Classpath $(VERSION)" \<br> + -windowtitle "GNU Classpath $(VERSION) Documentation" \<br> + -header $(classpathbox) -footer $(classpathbox) \<br> + -subpackages java:javax:org +</code> +</ul> + +</faq> +</faq-section> +</box> diff --git a/libjava/classpath/doc/www.gnu.org/home.wml b/libjava/classpath/doc/www.gnu.org/home.wml new file mode 100644 index 00000000000..1d59593b8f4 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/home.wml @@ -0,0 +1,65 @@ +#include "include/layout.wml" + +<set-var last-modified-author="prk"> +<subject "GNU Classpath"> + +<box> + +<boxtitle><a name="news">Classpath::Short News</a></boxtitle> +<boxitem> +<news newscount="8"> +#include "newsitems.txt" +</news> +<p><createlink name="... more news" url="news.html"> +</boxitem> + +<boxtitle><a name="home">Classpath::Home</a></boxtitle> + +<boxitem> +<p>GNU Classpath, Essential Libraries for Java, is a GNU project to +create free core class libraries for use with virtual machines and compilers +for the java programming language. +</P> +<P>Classpath is still a work in progress. The first public release +will be version 1.0. There have been no public releases; however, pre-release +source code is available via GNU's anonymous <A href="https://savannah.gnu.org/cvs/?group=classpath"> +CVS server</A> , and snapshots of the Classpath tree have been released and +are available from <A href="ftp://ftp.gnu.org/gnu/classpath/">ftp://ftp.gnu.org/gnu/classpath/</A> +</P> +</boxitem> + +<boxtitle><a name="status">Classpath::Status</a></boxtitle> +<boxitem> +<p> +An up to date view of the current state of GNU Classpath can be +obtained by looking at these resources. + <ul> + <li><createlink url="tasks.html" name="Task descriptions"></li> + <li>GNU Classpath vs: <createlink url="http://www.kaffe.org/~stuart/japi/htmlout/h-jdk10-classpath.html" name="JDK 1.0"> <createlink url="http://www.kaffe.org/~stuart/japi/htmlout/h-jdk11-classpath.html" name="JDK 1.1"> <createlink url="http://www.kaffe.org/~stuart/japi/htmlout/h-jdk12-classpath.html" name="JDK 1.2"> <createlink url="http://www.kaffe.org/~stuart/japi/htmlout/h-jdk13-classpath.html" name="JDK 1.3"> <createlink url="http://www.kaffe.org/~stuart/japi/htmlout/h-jdk14-classpath.html" name="JDK 1.4"> (updated nightly)</li> + <li>GNU Classpath <createlink url="http://ontographics.com/classpath/mauve/mauvereport.cgi" name="Mauve Results"></li> + </ul> +</p> +</boxitem> + +<boxtitle><a name="roadmap">Classpath::Roadmap</a></boxtitle> +<boxitem> +<p> +GNU Classpath 1.0 will be fully compatible with the 1.1 and largely +compliant with the 1.2 API specification and will have a stable API +for interacting with virtual machines. +</p> +<p> +Current snapshot releases have implementations for the following +packages (and some subpackages) <code>java.applet, java.awt, +java.beans, java.io, java.lang, java.math, java.net, java.rmi, +java.security, java.sql, java.text, java.util, java.util.jar, +java.util.zip, org.omg</code>. Not all classes and methods are implemented yet, +but most are. many of the implemented classes are already up to the +1.2 API spec. Some are already compliant with the 1.3 and 1.4 API +specification (there are preliminary implementations of +<code>java.nio</code> and <code>javax.swing</code>). +</p> +</boxitem> + + +</box> diff --git a/libjava/classpath/doc/www.gnu.org/include/layout.wml b/libjava/classpath/doc/www.gnu.org/include/layout.wml new file mode 100644 index 00000000000..61cf0bcbb02 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/include/layout.wml @@ -0,0 +1,165 @@ +#include "include/macros.wml" + +## +# Useful tags +# + +<define-tag menutitle endtag=required> +<br><span class="menutitle">%body</span><br> +</define-tag> + +<define-tag menuitem endtag=required> +<span class="menuitem">%body</span><br> +</define-tag> + +<define-tag box endtag=required> +<table class="boxtable">%body</table> +</define-tag> + +<define-tag boxtitle endtag=required> +<tr><td class="boxtitle">%body</td><tr> +</define-tag> + +<define-tag boxitem endtag=required> +<tr><td class="boxitem">%body</td><tr> +</define-tag> + +<define-tag boxitemalt endtag=required> +<tr><td class="boxitemalt">%body</td><tr> +</define-tag> + +<define-tag boxhighlight endtag=required> +<tr><td class="boxhighlight">%body</td><tr> +</define-tag> + +## +# Site Layout +# +# Uses: +# #SUBJECT# +# #BODY# +# + +<html> +<head> + <base href="http://www.gnu.org/software/classpath/"> + <title>{#SUBJECT#} - GNU Project - Free Software Foundation (FSF)</title> + <LINK REV="made" HREF="mailto:webmasters@www.gnu.org"> + <LINK REL="stylesheet" TYPE="text/css" HREF="http://www.gnu.org/software/classpath/savannah.css"> +</head> +<body> + +<table border="0"> + +<tr> +<td> +<applet code="Animation.class" CODEBASE="http://www.gnu.org/graphics" WIDTH="130" HEIGHT="86"> + <param name="base-name" value="drop"> + <param name="extension" value="jpg"> + <param name="num-images" value="15"> + <param name="image-sequence" value="1..10,9,7,5,3,1"> + <param name="frame-delay" value="30"> + <param name="inner-loop-repeat" value="2"> + <param name="loop-delay" value="10000"> + <param name="outer-loop-repeat" value="0"> + <a href="http://www.gnu.org/graphics/drop-1.jpg"> + <img src="http://www.gnu.org/graphics/drop-1.jpg" alt=" [image of the evil water droplet] " + width="130" height="86" border="0"> (jpeg 3k) + </a> + <a href="http://www.gnu.org/philosophy/gif.html">no gifs due to patent problems</a> +</applet> +</td><td> +<div align="center"> + +<!--img src="logo5.jpg"--> +<h1>GNU Classpath</h1> +</div> + +</td> +</tr> + +<tr> +<td class="menutable" valign="top"> + +## +# Menu +# + +<menutitle>Classpath</menutitle> +<menuitem><createlink name="Home" url="home.html"></menuitem> +<!-- +<menuitem><createlink name="Status" url="home.html#status"></menuitem> +<menuitem><createlink name="Roadmap" url="home.html#roadmap"></menuitem> +--> +<menuitem><createlink name="License" url="license.html"></menuitem> +<menuitem><createlink name="Team" url="http://savannah.gnu.org/project/memberlist.php?group_id=85"></menuitem> +<menuitem><createlink name="Download" url="downloads/downloads.html"></menuitem> +<menuitem><createlink name="FAQ" url="faq/faq.html"></menuitem> +<menuitem><createlink name="News" url="home.html#news"></menuitem> +<menuitem><createlink name="Events" url="events/events.html"></menuitem> +<menuitem><createlink name="Planet Classpath" url="http://classpath.wildebeest.org/planet/"></menuitem> + +<menutitle>Success Stories</menutitle> +<menuitem><createlink name="JVMs" url="stories.html#jvm"></menuitem> +<menuitem><createlink name="Research" url="stories.html#research"></menuitem> + +<menutitle>Savannah</menutitle> +<menuitem><createlink name="Project Home" url="http://savannah.gnu.org/projects/classpath/"></menuitem> +<menuitem><createlink name="Bug Reports" url="http://savannah.gnu.org/bugs/?group=classpath"></menuitem> +<!-- +<menuitem><createlink name="Support" url="http://savannah.gnu.org/support/?group=classpath"></menuitem> +<menuitem><createlink name="Patches" url="http://savannah.gnu.org/patch/?group=classpath"></menuitem> +<menuitem><createlink name="Tasks" url="http://savannah.gnu.org/pm/?group=classpath"></menuitem> +--> +<menuitem><createlink name="Mailing Lists" url="http://savannah.gnu.org/mail/?group=classpath"></menuitem> +<menuitem><createlink name="News" url="http://savannah.gnu.org/news/?group=classpath"></menuitem> +<menuitem><createlink name="CVS" url="http://savannah.gnu.org/cvs/?group=classpath"></menuitem> + +<menutitle>Development</menutitle> +<menuitem><createlink name="Tasks" url="tasks.html"></menuitem> +<menuitem><createlink name="Docs" url="docs/docs.html"></menuitem> +<menuitem><createlink name="Testing" url="benchmarks.html#testing"></menuitem> +<menuitem><createlink name="Benchmarks" url="benchmarks.html#benchmarks"></menuitem> + +<menutitle>Classpath Projects</menutitle> +<menuitem><createlink name="Inetlib" url="inetlib.html"></menuitem> +<menuitem><createlink name="Classpath Tools" url="cp-tools/"></menuitem> + +<menutitle>External Tools</menutitle> +<menuitem><createlink name="External Packages" url="external.html#packages"></menuitem> +<menuitem><createlink name="ClasspathX" url="http://www.gnu.org/software/classpathx/"></menuitem> +<menuitem><createlink name="Mauve" url="http://sources.redhat.com/mauve/"></menuitem> +<menuitem><createlink name="Jessie" url="http://www.nongnu.org/jessie/"></menuitem> +<menuitem><createlink name="Jalopy" url="external.html#jalopy"></menuitem> + +</td> +<td valign="top"> + +{#BODY#} + +</td> +</tr> + +<tr> +<td colspan="2"> + +## +# Footer +# + +<footer> + +</td> +</tr> +</table> + +</body> + +# hook into the template +# + +<define-tag subject> +{#SUBJECT#:%0:##} +</define-tag> + +{#BODY#: diff --git a/libjava/classpath/doc/www.gnu.org/include/macros.wml b/libjava/classpath/doc/www.gnu.org/include/macros.wml new file mode 100644 index 00000000000..46c6ba87c68 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/include/macros.wml @@ -0,0 +1,171 @@ +## +# +# Useful macros +# +# createlink, footer, news, newsitem, PROJECT-LIST, PROJECT +# + +## +# +# commented-code, code-line +# +# insert a commented code example in the text +# +# tag +# commented-code +# attributes +# +# body +# a list of code-lines +# +# tag +# code-line +# attributes +# code +# body +# comment +# +<define-tag commented-code endtag=required> + <ul> + <table cellspacing="0" cellpadding="4"> + %body + </table> + </ul> +</define-tag> + +<define-tag code-line endtag=required> + <preserve code> + <set-var %attributes> + <tr><td valign="top"><code><get-var code></code></td><td style="padding-left: 20px;">%body</td></tr> + <tr bgcolor="#999999"><td colspan="2"></td></tr> + <restore code> +</define-tag> + + +## +# +# createlink +# +# create a link (a tag); if no name given, uses url as name +# +# tag +# createlink +# attributes +# name, url +# + +<define-tag createlink> +<preserve name> +<preserve url> +<set-var %attributes> +<ifeq <get-var name> "" <set-var name="<get-var url>">> +<a href="<get-var url>"><get-var name></a> +<restore url> +<restore name> +</define-tag> + +## +# +# Newslines +# +# Use the news and newsitem to create a table with news entries +# +<define-tag news endtag=required> + <preserve newscount> + <preserve __NEWSCNT> + <set-var __NEWSCNT=0> + <set-var %attributes> + <table> + %body + </table> + <restore __NEWSCNT> + <restore newscount> +</define-tag> + +<define-tag newsitem endtag=required> + <preserve date> + <set-var %attributes> + <if <lt <get-var __NEWSCNT> <get-var newscount>> + "<tr><td><strong><get-var date></strong></td><td>%body</td></tr>" + > + <increment __NEWSCNT> + <restore date> +</define-tag> + + +## +# +# Project table as custom tag, to ensure consistency and +# simplify layout changes in the table +# +# tag: PROJECT-LIST +# attributes: +# +# tag: PROJECT +# attributes: name url +# + +<define-tag project-list endtag=required> + <table border="0" cellpadding="6"> + %body + </table> +</define-tag> + +<define-tag project endtag=required> + <preserve name> + <preserve url> + <set-var %attributes> + <tr> + <td valign="top"><a href="<get-var url>"><get-var name></a></td> + <td>%body</td> + </tr> + <restore url> + <restore name> +</define-tag> + + +## +# +# Page footer +# +# tag: footer +# + + +<define-tag footer> +<BR><BR> +<HR> +<en> +Return to <A HREF="/home.html">GNU's home page</A>. +<P> + +Please send FSF & GNU inquiries & questions to + +<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. +There are also <A HREF="/home.html#ContactInfo">other ways to +contact</A> the FSF. +<P> + +Please send comments on these web pages to + +<A HREF="mailto:webmasters@www.gnu.org"><EM>webmasters@www.gnu.org</EM></A>, +send other questions to +<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>. +<P> +Copyright (C) 1999-2003 Free Software Foundation, Inc., +51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA +<P> +Verbatim copying and distribution of this entire article is +permitted in any medium, provided this notice is preserved.<P> +Updated: +</en> +$Date: 2005/07/02 20:32:08 $ $Author: mark $ +<!-- +<preserve info> +<set-var info=<get-file-properties <__file__>>> +<date <get-var info[2]>> <get-var last-modified-author> +<restore info> +--> +<HR> +</define-tag> + diff --git a/libjava/classpath/doc/www.gnu.org/inetlib.wml b/libjava/classpath/doc/www.gnu.org/inetlib.wml new file mode 100755 index 00000000000..6ac8705f0ee --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/inetlib.wml @@ -0,0 +1,186 @@ +#include "include/layout.wml"
+
+<set-var last-modified-author="prk">
+<subject "GNU Classpath inetlib">
+
+<box>
+<boxtitle><a name="main">Classpath::inetlib</a></boxtitle>
+<boxitem>
+<en>
+
+<p>
+GNU inetlib is a library of clients for common internet protocols.
+The following protocols are currently supported:
+</p>
+
+<ul>
+<li>Hypertext Transfer Protocol (HTTP)</li>
+<li>File Transfer Protocol (FTP)</li>
+<li>Simple Mail Transfer Protocol (SMTP)</li>
+<li>Internet Message Access Protocol (IMAP)</li>
+<li>Post Office Protocol (POP)</li>
+<li>Network News Transfer Protocol (NNTP)</li>
+<li>Lightweight Directory Access Protocol (LDAP) (alpha)</li>
+<li>Gopher</li>
+<li>Finger</li>
+</ul>
+
+<p>
+The inetlib library is similar in intent to the Python internet protocols
+library - the API is as close as possible to the intent of the underlying
+protocol design. This allows for very efficient coding of user agents.
+</p>
+
+<p>
+Additionally, inetlib includes URLStreamHandler implementations for some
+of the protocols. These can be used to add support for the corresponding
+URL scheme to the java.net.URL class.
+</p>
+
+</en>
+</boxitem>
+
+<boxtitle><a name="http">Classpath::inetlib::HTTP</a></boxtitle>
+<boxitem>
+<en>
+
+<p>
+The inetlib HTTP client supports HTTP/1.1 as described in RFC 2616, with
+the following features:
+</p>
+
+<ul>
+<li>Persistent connections</li>
+<li>Basic and Digest authentication (RFC 2617)</li>
+<li>HTTPS</li>
+<li>HTTP proxies</li>
+<li>HTTP/1.0 compatibility</li>
+<li>Support for WebDAV methods and other HTTP extensions</li>
+<li>Automatic decoding of the chunked transfer-coding</li>
+<li>Parsing of HTTP date headers</li>
+<li>Support for the 100-continue expectation</li>
+</ul>
+
+<p>
+The design of the API is similar to the
+<createlink url="http://www.webdav.org/neon/" name="neon">
+WebDAV/HTTP library. A logical connection to the server is instantiated,
+and multiple requests can be issued on this connection. Each request has
+an atomic <code>dispatch</code> method which returns the response.
+All I/O, authentication, etc is handled by registering callback objects
+with the request prior to dispatch, which are notified during the dispatch
+procedure as necessary. Simple byte-array content callbacks are supplied
+which can manage any request/response content that fits in available memory.
+</p>
+
+<p>
+An URL stream handler is provided, supporting the full HttpURLConnection
+specification.
+</p>
+
+</en>
+</boxitem>
+
+<boxtitle><a name="ftp">Classpath::inetlib::FTP</a></boxtitle>
+<boxitem>
+<en>
+
+<p>
+The inetlib FTP client supports both active and passive mode FTP and all
+transfer modes and representation types. The client implements RFC 959,
+with the following exceptions and limitations:
+</p>
+
+<ul>
+<li>Only one concurrent transfer connection is supported</li>
+<li>The STAT, HELP, SITE, SMNT, and ACCT commands are not supported</li>
+<li>The TYPE command does not allow alternatives to the default bytesize
+(Non-print), and local bytesize is not supported</li>
+</ul>
+
+<p>
+An URL stream handler is provided, which allows the setting of transfer modes
+and representation types by means of the <code>setRequestProperty</code>
+method.
+</p>
+
+</en>
+</boxitem>
+
+<boxtitle><a name="smtp">Classpath::inetlib::SMTP</a></boxtitle>
+<boxitem>
+<en>
+
+<p>
+The inetlib SMTP client fully implements RFC 2821 including the ESMTP
+extension standard.
+</p>
+
+<p>
+The client also implements TLS negotiation (RFC 3207) and SASL
+authentication (RFC 2554).
+</p>
+
+</en>
+</boxitem>
+
+<boxtitle><a name="imap">Classpath::inetlib::IMAP</a></boxtitle>
+<boxitem>
+<en>
+
+<p>
+The inetlib IMAP client fully implements IMAP4rev1 and includes the
+following features:
+</p>
+
+<ul>
+<li>Extensible authentication using any available SASL mechanism</li>
+<li>TLS negotiation (RFC 2595)</li>
+<li>Automatic UTF-7imap folder name decoding/encoding</li>
+<li>IMAP over SSL</li>
+</ul>
+
+</en>
+</boxitem>
+
+<boxtitle><a name="pop3">Classpath::inetlib::POP3</a></boxtitle>
+<boxitem>
+<en>
+
+<p>
+The inetlib POP client implements version 3 only, as specified in RFC 1939,
+with the exception of the no-arg LIST and UIDL commands (use STAT followed
+by multiple LIST and/or UIDL instead).
+It supports the following features:
+</p>
+
+<ul>
+<li>The POP3 extension mechanism CAPA</li>
+<li>Extensible authentication using any available SASL mechanism via
+the AUTH mechanism (RFC 1734)</li>
+<li>TLS negotiation (RFC 2595)</li>
+</ul>
+
+</en>
+</boxitem>
+
+<boxtitle><a name="nntp">Classpath::inetlib::NNTP</a></boxtitle>
+<boxitem>
+<en>
+
+<p>
+The inetlib NNTP client implements all of RFC 977, and many of the common
+NNTP extensions specified in RFC 2980. It supports the XOVER and XHDR
+commands, and simple authentication.
+</p>
+
+<p>
+There is also a newsrc mechanism for storing newsgroup subscriptions and read
+articles in an implementation-independent manner, including a file-based
+implementation.
+</p>
+
+</en>
+</boxitem>
+</box>
+
diff --git a/libjava/classpath/doc/www.gnu.org/license.wml b/libjava/classpath/doc/www.gnu.org/license.wml new file mode 100644 index 00000000000..54d2c49bfaa --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/license.wml @@ -0,0 +1,70 @@ +#include "include/layout.wml" +<set-var last-modified-author="prk"> + +<subject "GNU Classpath License"> + +<box> +<boxtitle><a name="license">Classpath::License</a></boxtitle> +<boxitem> +<en> +<p> +Classpath is distributed under the terms of the +<createlink url="/copyleft/gpl.html" name="GNU General Public License"> with +the following clarification and special exception. +</p> + +<p> +<blockquote> +<p> +<code> +Linking this library statically or dynamically with other modules is +making a combined work based on this library. Thus, the terms and +conditions of the GNU General Public License cover the whole +combination. +</code> +</p> +<p> +<code> +As a special exception, the copyright holders of this library give you +permission to link this library with independent modules to produce an +executable, regardless of the license terms of these independent +modules, and to copy and distribute the resulting executable under +terms of your choice, provided that you also meet, for each linked +independent module, the terms and conditions of the license of that +module. An independent module is a module which is not derived from +or based on this library. If you modify this library, you may extend +this exception to your version of the library, but you are not +obligated to do so. If you do not wish to do so, delete this +exception statement from your version. +</code> +</p> +</blockquote> +</p> + +<p> +As such, it can be used to run, create and distribute a large class of +applications and applets. When GNU Classpath is used unmodified as the +core class library for a virtual machine, compiler for the java languge, +or for a program written in the java programming language it does not +affect the licensing for distributing those programs directly. +</p> + +</en> +</boxitem> + +<boxtitle><a name="documentation">Classpath::Documentation Redistribution Policy</a></boxtitle> +<boxitem> + +GNU Documentation is unique because of our attitude towards it. We +believe the reader should be free to copy and redistribute it, just +like our software. Originally, all our documentation was released under +a short <createlink url="/licenses/licenses.html#WhatIsCopyleft" name="Copyleft"> +license, or under the <createlink url="/licenses/licenses.html#GPL" +name="GNU General Public License (GPL)"> itself; in 2001 the +<createlink url="/licenses/licenses.html#FDL" +name="Free Documentation License (FDL)"> was created to +address certain needs that were not met by licenses originally designed +for software. +</boxitem> + +</box>
\ No newline at end of file diff --git a/libjava/classpath/doc/www.gnu.org/news.wml b/libjava/classpath/doc/www.gnu.org/news.wml new file mode 100755 index 00000000000..cce37b1a6ec --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/news.wml @@ -0,0 +1,15 @@ +#include "include/layout.wml" + +<set-var last-modified-author="prk"> +<subject "GNU Classpath"> + +<box> + +<boxtitle><a name="ShortNews">Classpath::News</a></boxtitle> +<boxitem> +<news newscount="9999"> +#include "newsitems.txt" +</news> +</boxitem> + +</box> diff --git a/libjava/classpath/doc/www.gnu.org/newsitems.txt b/libjava/classpath/doc/www.gnu.org/newsitems.txt new file mode 100644 index 00000000000..815a60ff78e --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/newsitems.txt @@ -0,0 +1,177 @@ +<newsitem date="15 Jul 2005"> +<createlink name="GNU Classpath 0.17" + url="announce/20050715.html"> +</newsitem> + +<newsitem date="30 Jun 2005"> +<createlink name="GNU Classpath 0.16" + url="announce/20050630.html"> +</newsitem> + +<newsitem date="29 Apr 2005"> +<createlink name="GNU Classpath 0.15" + url="announce/20050429.html"> +</newsitem> + +<newsitem date="25 Feb 2005"> +<createlink name="GNU Classpath 0.14" + url="announce/20050226.html"> +Base core class libraries for the GCC 4.0 (gcj) and Kaffe 1.1.5 releases. +</newsitem> + +<newsitem date="18 Feb 2005"> +<createlink + name="The gui branch is dead!" + url="http://lists.gnu.org/archive/html/classpath/2005-02/msg00081.html"> + Long live the gui work. +</newsitem> + +<newsitem date="18 Feb 2005"> +<createlink name="Escape the Java Trap @ Fosdem 2005" + url="events/escape_fosdem05.html"> +</newsitem> + +<newsitem date="14 Feb 2005"> +<createlink name="Calientra runs on GNU Classpath" + url="http://lists.gnu.org/archive/html/classpath/2005-02/msg00065.html"> +</newsitem> + +<newsitem date="07 Jan 2005"> +<createlink name="GNU Classpath 0.13" url="announce/20050107.html"> +</newsitem> + +<newsitem date="15 Nov 2004"> +<createlink name="GNU Classpath 0.12" url="announce/20041115.html"> +</newsitem> + +<newsitem date="06 Nov 2004"> +GNU Classpath is full API compatible with JDK 1.0 (<createlink url="http://www.kaffe.org/~stuart/japi/htmlout/h-jdk10-classpath.html" name="japi results for 1.0">) +</newsitem> + +<newsitem date="03 Oct 2004"> +GNU Classpath Tools (cp-tools) now part of savannah classpath project (<createlink url="http://lists.gnu.org/archive/html/classpath/2004-10/msg00012.html" name="link">) +</newsitem> + +<newsitem date="13 Sep 2004"> +<createlink name="GNU Classpath 0.11" url="announce/20040913.html"> +</newsitem> + +<newsitem date="03 Sep 2004"> +<createlink url="ftp://ftp.gnu.org/gnu/classpath/inetlib-1.1.tar.gz" name="inetlib 1.1"> released. +</newsitem> + +<newsitem date="15 Aug 2004"> +<createlink url="http://lists.gnu.org/archive/html/classpath-patches/2004-08/msg00078.html" name="JSpinner"> added to classpath. +</newsitem> + +<newsitem date="13 Aug 2004"> +<createlink url="http://lists.gnu.org/archive/html/classpath/2004-08/msg00076.html" name="javax.crypto and javax.security"> implementation added to classpath. +</newsitem> + +<newsitem date="05 Aug 2004"> +CVS generics-branch started for java 1.5 related changes. [<createlink name="more..." url="http://lists.gnu.org/archive/html/classpath/2004-08/msg00030.html">] +</newsitem> + +<newsitem date="02 Aug 2004"> +Latest <createlink name="AWT" url="http://www.klomp.org/mark/classpath/awtdemo-2004-jul-25.png"> and <createlink name="SWING" url="http://www.klomp.org/mark/classpath/swingdemo-2004-jul-25.png"> screenshots by Mark. +</newsitem> + +<newsitem date="27 Jul 2004"> +AWT bug reports are now on <createlink name="GCC Bugzilla" url="http://gcc.gnu.org/bugzilla/"> +</newsitem> + +<newsitem date="23 Jul 2004"> +HTTP client added to inetlib +</newsitem> + +<newsitem date="27 Jul 2004"> +Directory with Examples added to the project. +</newsitem> + +<newsitem date="22 Jul 2004"> +Latest "montly-changes" for AWT committed. This now required GTK+ 2.4. +</newsitem> + +<newsitem date="18 Jul 2004"> +Roman Kennke's <createlink name="automated mauve reports" url="http://ontographics.com/classpath/mauve/mauvereport.cgi">. +</newsitem> + +<newsitem date="13 Jul 2004"> +<createlink name="JC 1.2.1" url="http://lists.gnu.org/archive/html/classpath/2004-07/msg00168.html"> released +</newsitem> + +<newsitem date="12 Jul 2004"> +<createlink name="GNU Classpath 0.10" url="announce/20040712.html"> +</newsitem> + +<newsitem date="10 Jul 2004"> +<createlink name="SableVM 1.1.6" url="http://lists.gnu.org/archive/html/classpath/2004-07/msg00148.html"> +</newsitem> + +<newsitem date="06 Jul 2004"> +<createlink name="Emacs support for GNU Classpath coding style" url="http://lists.gnu.org/archive/html/classpath/2004-07/msg00077.html"> +</newsitem> + +<newsitem date="14 Jun 2004"> +<createlink name="Inetlib 1.0 released" url="http://lists.gnu.org/archive/html/classpath/2004-06/msg00077.html"> +</newsitem> + +<newsitem date="14 Jun 2004"> +<createlink name="Some fresh Swing snapshots" url="http://gadek.debian.net/SableVM-Swing-new/"> from SableVM. +</newsitem> + +<newsitem date="02 Jun 2004"> +<createlink name="SableVM 1.1.5" url="http://lists.gnu.org/archive/html/classpath/2004-06/msg00011.html"> released +</newsitem> + +<newsitem date="22 May 2004"> +<createlink name="JamVM 1.1.4" url="http://mail.gnu.org/archive/html/classpath/2004-05/msg00090.html"> released +</newsitem> + +<newsitem date="15 May 2004"> +<createlink name="SableVM 1.1.4" url="http://mail.gnu.org/archive/html/classpath/2004-05/msg00075.html"> released +</newsitem> + +<newsitem date="2 May 2004"> +<createlink name="GNU Classpath 0.09" url="announce/20040502.html"> released +</newsitem> + +<newsitem date="29 Apr 2004"> +Use Eclipse to hack GNU Classpath; see the <createlink url="http://mail.gnu.org/archive/html/classpath/2004-04/msg00371.html" name="instructions"> +</newsitem> + +<newsitem date="12 Apr 2004"> +<createlink url="http://mail.gnu.org/archive/html/classpath/2004-04/msg00228.html" name="SableVM 1.1.3"> released +</newsitem> + +<newsitem date="12 Apr 2004"> +<createlink url="http://mail.gnu.org/archive/html/classpath/2004-04/msg00226.html" name="JC 1.1"> released ; upgraded to GNU Classpath 0.08. +</newsitem> + +<newsitem date="12 Apr 2004"> +<createlink url="http://mail.gnu.org/archive/html/classpath/2004-04/msg00225.html" name="Jikes RVM 2.3.2"> released ; upgraded to GNU Classpath 0.08 and completely built with free tools! +</newsitem> + +<newsitem date="8 Apr 2004"> +The big NIO patch: java.io file operations now rely on java.nio.channels +</newsitem> + +<newsitem date="29 Mar 2004"> +<createlink name="JamVM-1.1.2 " url="http://mail.gnu.org/archive/html/classpath/2004-03/msg00267.html"> released +</newsitem> + +<newsitem date="26 Mar. 2004"> +<createlink name="Planet Classpath" url="http://classpath.wildebeest.org/planet/"> launched; it aggregates the blogs of most Classpath's developers +</nextitem> + +<newsitem date="19 Mar. 2004"> +Sascha has released <createlink name="ServiceFactory" url="http://mail.gnu.org/archive/html/classpath/2004-03/msg00153.html"> +</nextitem> + +<newsitem date="13 Mar. 2004"> +<createlink name="GNU Classpath 0.08" url="announce/20040313.html"> released +</nextitem> + +<newsitem date="21+22 Feb. 2004"> +GNU Classpath at the <createlink name="FOSDEM'04" url="http://www.fosdem.org/2004/">: see the <createlink name="report" url="events/fosdem04.html"> +</newsitem> diff --git a/libjava/classpath/doc/www.gnu.org/savannah.css b/libjava/classpath/doc/www.gnu.org/savannah.css new file mode 100644 index 00000000000..5ec8f09c9e5 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/savannah.css @@ -0,0 +1,140 @@ +/* + * + * the savannah project + * copyright 2002 (c) mathieu roy <yeupou@gnu.org> + * see the changelog file for a detailed list of changes + * + * http://savannah.gnu.org + * + * this program is free software; you can redistribute it and/or + * modify it under the terms of the gnu general public license + * as published by the free software foundation; either version 2 + * of the license, or (at your option) any later version. + * + * this program is distributed in the hope that it will be useful, + * but without any warranty; without even the implied warranty of + * merchantability or fitness for a particular purpose. see the + * gnu general public license for more details. + * + * you should have received a copy of the gnu general public license + * along with this program; if not, write to the free software + * foundation, inc., 59 temple place - suite 330, boston, ma 02110-1301, usa. + * + * $id: savannah.css,v 1.33 2002/10/29 10:53:12 yeupou exp $ + * + * + * as savannah.theme is the default theme of images, this css + * is the default css2 style definition + * any valuable changes added that any theme should implement + * should be implemented here + * +*/ + +/* general stuff */ +body { + margin-top: 0.5%; + margin-left: 0.5%; + margin-right: 0.5%; + margin-bottom: 0.5%; + background-color: #ffffff; + font-family: arial,helvetica; + font-size: small; + color: #333333; +} + +a { text-decoration: none; color: #841212;} +a:hover { text-decoration: underline; color: #ff0000; } +a:active { color: #ff0000; } + +.smaller { font-size: smaller; } +.small { font-size: small; } +.xsmall { font-size: xx-small; } +.center { text-align: center; } +.left { text-align: left; } +.error { font-weight: bold; color: #ff0000; } +.bold { font-weight: bold; } +.feedback { color: red; } + +pre,tt { font-family: courier,sans-serif; } +input { + background-color: #fff9e0; + color: #841212; +} +input:hover { color: #ff0000; } +select { + background-color: #fff9e0; + color: #841212; +} + +/* commented out because of a bug in Mozilla 1.2* and 1.1 +select:hover { color: #ff0000; } +*/ +textarea { + background-color: #fff9e0; + color: #000000; +} +textarea:hover { color: #ff0000; } +.footer { font-size: x-small; color: #333333; } +.standardtable { width: 99%; border-spacing: 0; border: 0; color: #333333; } + +/* content frame specific */ +.contenttable { + background-color: #ffffff; + vertical-align: top; + width: 99%; + border-spacing: 0; + border-bottom: thin solid #333333; + border-top: thin solid #333333; + border-right: thin solid #333333; +} + +/* group menu specific (see tabs and tabselect too) */ +.groupmenutable { background-color: #f9e4a2; width: 100% ; border-top: thin solid #000000; border-bottom: thin solid #000000; } + +/* left menu specific */ +.menutable { vertical-align: top; background-color: #f4d495; width: 150px; border-spacing: 0; border: 0; font-size: small;} +.menutitle { vertical-align: top; font-weight: bold; text-align: left; color: #333333; } +.menuitem { vertical-align: top; text-align: right; color: #333333; } +.menusearch { font-size: xx-small; } + +/* classic box */ +.boxtable { width: 99%; vertical-align: top; border-spacing: 1px; border: 0; } +.boxtitle { background-image: url("/images/savannah.theme/leopard.png"); background-color: #eddb5a; font-weight: bold; text-align: center; text-transform: capitalize; color: #000000; } +.boxitem { /*background-image: url("/images/savannah.theme/sand.png");*/ background-color: #fff9e0; text-align: left; color: #333333; } +.boxitemalt { background-color: #ffffff; text-align: left; color: #333333; } +.boxhighlight { background-color: #ffe0db; text-align: left; color: #333333; } + +/* priority */ +.priora { background-color: #f9f7f2; } +.priorb { background-color: #f4f0e8; } +.priorc { background-color: #efeade; } +.priord { background-color: #eae3d5; } +.priore { background-color: #e2dbcc; } +.priorf { background-color: #ddd7c7; } +.priorg { background-color: #d8d1be; } +.priorh { background-color: #d6ceb8; } +.priori { background-color: #d3caaf; } + +/* index.php */ +.indexcenter { vertical-align: top; width: 65%; color: #333333; } +.indexright { vertical-align: top; width: 35%; color: #333333; } + +/* tabs */ +.tabselect { color: #000000; font-weight: bold; } +.tabselect:visited { font-weight: bold;} +.tabselect:hover { color:#ff0000; font-weight: bold; } + +.titlebar { text-decoration:none; color:#000000; font-size: small; font-weight: bold; } +.develtitle { color:#000000; font-weight: bold; } +.legallink { color:#000000; font-weight: bold; } + + + +/* this is the original sourceforge css.. we let this stuff here until this savaannah css is fully used */ + +span.center { text-align: center; } +span.boxspace { font-size: 2pt; } +span.alignright { text-align: right } +span.maintitlebar { font-size: 10pt; color: #ffffff; } +span.titlebar { text-align: center; font-size: larger; color: #000000; font-weight: bold; } + diff --git a/libjava/classpath/doc/www.gnu.org/stories.wml b/libjava/classpath/doc/www.gnu.org/stories.wml new file mode 100644 index 00000000000..c01ac193788 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/stories.wml @@ -0,0 +1,225 @@ +#include "include/layout.wml" + +<set-var last-modified-author="prk"> + +<subject "GNU Classpath Success Stories"> + +<box> +<boxtitle><a name="jvm">Classpath::JVM</a></boxtitle> + +<boxitem> +<en> +<p> +The primary target for GNU Classpath was originally <createlink +url="http://www.hungry.com/old-hungry/products/japhar/" name="Japhar">. Japhar-0.07 works out-of-the-box with +GNU Classpath-0.00. Current Japhar versions do not work with current versions +of GNU Classpath. +</p> + +<p>In the meantime, many other JVM have choosen GNU Classpath as their library implementation:</p> + +<table border="0" width="100%" cellpadding="6"> +<!--tr><th>JVM</th><th>Description</th></tr--> + +<project url="http://aegisvm.sourceforge.net/" name="AegisVM"> +The Aegis VM Project is an on-going effort to develop a lightweight, +secure virtual machine for executing Java bytecode. The Aegis VM will +eventually feature a modular bytecode verification architecture that +allows user-defined static verification procedures to be integrated +into the VM's dynamic linking process through pluggable verification +modules. +</project> + +<project url="http://gcc.gnu.org/java/" name="GCJ"> +Although GNU Classpath cannot be directly compiled for use with +GCJ at this time, a lot of work has been done to merge GCJ class +library code and GNU Classpath class library code. This has resulted +in a better version of each. The current merge status between the two +projects is <createlink url="http://gcc.gnu.org/java/libgcj-classpath-compare.html" +name="located here">. +</project> + +<project url="http://www.ikvm.net/" name="IKVM.NET"> +A JVM for the .NET platform. +Runs on top of <createlink url="http://www.go-mono.org/" name="Mono">. +</project> + +<project url="http://sourceforge.net/projects/jamiga" name="JAmiga"> +A JRE implementation for the Amiga Platform. +</project> + +<project url="http://jamvm.sourceforge.net/" name="JamVM"> +JamVM is a Java Virtual Machine which conforms to the JVM specification version 2 (blue book). In comparison to most other VM's (free and commercial) it is extremely small, with a stripped executable on PowerPC of only ~100K, and Intel 80K. However, unlike other small VMs (e.g. KVM) it is designed to support the full specification, and includes support for object finalisation, the Java Native Interface (JNI) and the Reflection API. +</project> + +<project url="http://www.oberon.ethz.ch/jaos/" name="Jaos"> +The Jaos VM is a JVM using GNU Classpath implemented on top of the +<createlink url="http://bluebottle.ethz.ch/" name="Aos/Bluebottle"> kernel. +This kernel offers many useful features like garbage collected memory +management, dynamic module loading, and object-oriented model. This makes the +implementation of a JVM particularly attractive and simple. +</project> + +<project url="http://jcvm.sourceforge.net/" name="JC"> +JC is a Java virtual machine implementation that converts class +files into C source files using the Soot Java bytecode analysis +framework, compiles them with GCC, and loads them using a built-in +ELF object file loader. +</project> + +<project url="http://www.ibm.com/developerworks/oss/jikesrvm/" name="Jikes RVM"> +Jikes RVM uses GNU Classpath for all of its libraries. Instructions for using +Classpath are provided in the Jikes RVM user's guide as of the Jikes RVM +release 2.2.1 (4/7/03). Nightly regression tests are run against the latest +Classpath release and the Classpath CVS head. The results are posted on the +jikesrvm-regression mailing list, which is archived and available on the Jikes +RVM home page. +</project> + +<project url="http://jnode.sourceforge.net/" name="JNode"> +JNode is a <i>Java New Operating System Design Effort</i>. +The goal is to get an simple to use and install Java operating system for personal use. Any java application should run on it, fast & secure! +</project> + +<project url="http://www.eecg.toronto.edu/~doylep/jupiter/" name="Jupiter"> +This VM also uses a modified version of the GNU Classpath libraries. +</project> + +<project url="http://www.kaffe.org/" name="Kaffe"> +Kaffe OpenVM is a complete virtual machine, library framework and +tools for programming in the java language. It has its own +implementation of part of the core libraries, but uses large parts of +the GNU Classpath framework. +</project> + +<project url="http://kissme.sourceforge.net/" name="Kissme"> +This VM is almost always guaranteed to work with GNU Classpath CVS +source code. +</project> + +<project url="http://www.intel.com/research/mrl/orp/" name="ORP"> +Information about ORP +can also be found at <createlink url="http://orp.sourceforge.net/" +name="http://orp.sourceforge.net/">. ORP 1.10 does not work with +current GNU Classpath libraries. Information is available in the +mailing list archives. +</project> + +<project url="http://www.sablevm.org/" name="SableVM"> +SableVM is a robust, extremely portable, efficient, and +specifications-compliant Java Virtual Machine that aims to be easy to +maintain and to extend. It features a state-of-the-art, efficient +interpreter engine. Its source code is very accessible and easy to +understand, and has many robustness features that have been the object +of careful design. +</project> + +<project url="http://www.cacaojvm.org/" name="CACAO"> +CACAO is a research Java Virtual Machine developed at the Vienna +University of Technology. It has a compile-only approach, which means +there is no interpreter at all but a JIT compiler ported to different +architectures, like Alpha, i386, MIPS, PowerPC, and x86_64. The main +aim of CACAO is to keep the JIT compilation time as small as possible +while producing quite fast code. +</project> + +</table> +</en> + +<H4>Other projects using GNU classpath</H4> +<en> +<table border="0" width="100%" cellpadding="6"> +<!--tr><th>Project</th><th>Description</th></tr--> +<project url="http://www.flex-compiler.lcs.mit.edu/" name="Flex Compiler"> +FLEX is a compiler infrastructure written in Java for Java. Applications +include a program analysis and transformation framework for distributed +and embedded systems. Native backends exist for the StrongARM and MIPS +processors; it can also generate portable C code that can run on any +platform with gcc. +</project> +</table> +</en> + +</boxitem> + +<!-- +<boxtitle><a name="applications">Classpath::Applications</a></boxtitle> +<boxitem> +Having an application running on a JVM using classpath implicitly proves that +classpath is fit enough for its purpose. +<p>The following free software applications have been run on classpath-based environments: +<ul> +<li>Eclipse (on gcj) +</ul> +</boxitem> +--> + +<boxtitle><a name="research">Classpath::Research</a></boxtitle> +<boxitem> +<p>Many research projects have choosen GNU Classpath as their implementation of choice for +the Java Libraries, mostly because it is free software, which means the freedom to use, +analyze, and change the code for one's purposes.</p> + +## +# Shortcut for table entries +# +<define-tag entry endtag=required> +<preserve name> +<set-var %attributes> +<tr> + <td valign="top"><get-var name></td> + <td>%body</td> +</tr> +<restore name> +</define-tag> + +<p>The following research projects are using GNU Classpath: +<table border="0" cellpadding="6"> +<!--tr><th>Project</th><th>Description</th> +</tr--> + +<entry name="Intel's ORP"> +<createlink url="http://orp.sourceforge.net/" name="ORP"> (Open Runtime Platform) is an open source research infrastructure project that provides these features thus enabling the rapid evolution of systems research of dynamic compilation and memory management. + +<p>[<createlink name="Publications" url="http://www.intel.com/research/mrl/library/java-pubs.htm">] +</entry> + +<entry name="IBM's Jikes RVM"> +<createlink url="http://www-124.ibm.com/developerworks/oss/jikesrvm/" name="Jikes RVM"> (the Jikes Research Virtual Machine) provides the research community with a flexible open testbed to prototype virtual machine technologies and experiment with a large variety of design alternatives. The virtual machine infrastructure in the Jikes RVM release was independently developed as part of the Jalapeņo research project at the IBM T.J. Watson Research Center. + +<p>[<createlink name="Publications" url="http://www-124.ibm.com/developerworks/oss/jikesrvm/info/papers.shtml">] +</entry> + +<entry name="SableVM"> +<createlink url="http://www.sablevm.org/" name="SableVM"> SableVM is a +highly portable and efficient Java virtual machine, using +state-of-the-art interpratation techniques. Its goals are to be +reasonably small, fast, and compliant with the various specifications +(JVM specification, JNI, invocation interface, etc.). + +<p> The initial development of SableVM was done as part of the +Ph.D. research project of <createlink name="Etienne Gagnon" +url="http://www.info.uqam.ca/~egagnon">. Continuing development of +SableVM project involves the <createlink name="Sable Research Group" +url="http://www.sable.mcgill.ca/"> (McGill University and Universite +du Quebec a Montreal), and other generous <createlink name="Free +software contributors" +url="http://devel.sablevm.org/svn/repository/sablevm/branches/staging/AUTHORS">. + +<p>[<createlink name="SableVM Documents" url="http://www.sablevm.org/docs.html">] +<br>[<createlink name="Sable Publications (Papers)" url="http://www.sable.mcgill.ca/publications/papers/">] +</entry> + +<entry name="Jaos"> +<createlink name="Jaos" url="http://www.oberon.ethz.ch/jaos/"> (Java on Active Object System) is a Java Virtual Machine for the Bluebottle System and a case study in interoperability between the Oberon and Java Languages. + +<p>Jaos was developed as part of Patrik Reali's Ph.D research project at the <createlink name="Programming Languages and Run-Time Systems Research Group" url="http://www.cs.inf.ethz.ch/gutknecht/"> at <createlink name="ETH Zurich" url="http://www.ethz.ch">. + +<p>[<createlink name="Publications" url="http://www.oberon.ethz.ch/jaos/docs/index.html">] +</entry> + +</table> + +</boxitem> + +</box> diff --git a/libjava/classpath/doc/www.gnu.org/tasks.wml b/libjava/classpath/doc/www.gnu.org/tasks.wml new file mode 100755 index 00000000000..00959bd9a48 --- /dev/null +++ b/libjava/classpath/doc/www.gnu.org/tasks.wml @@ -0,0 +1,326 @@ +#include "include/layout.wml" + +## +# +# Special Tags +# + +# <task +# title="task title" +# contact="contact person" +# skills="..." +# estimation="..." +# > +# ... task description ... +# </task> + + + +# the task counter +# +<set-var __TASKSEQCNT=1> + +<define-tag task-section endtag=required> + <preserve name> + <set-var %attributes> +{#TASKINDEX#: + <boxitem> + <!---boxtitle---> + <strong><get-var __TASKSEQCNT>. <get-var name></strong> <br> + <!---/boxtitle---> +:#TASKINDEX#} + <boxtitle><get-var __TASKSEQCNT>. <get-var name></boxtitle> + <set-var __TASKCNT=1> + %body +{#TASKINDEX#: + </boxitem> + <br> +:#TASKINDEX#} + <increment __TASKSEQCNT> + <restore name> +</define-tag> + +<define-tag task endtag=required> +<preserve title> +<preserve contact> +<preserve skills> +<preserve estimation> +<set-var %attributes> +{#TASKINDEX#: + <!---strong--><a href="tasks.html#task<get-var __TASKSEQCNT>_<get-var __TASKCNT>"><get-var __TASKSEQCNT>.<get-var __TASKCNT> <get-var title></a><!---/strong--> (<get-var estimation>)<br> +:#TASKINDEX#} + <boxitem> + <h3><a name="task<get-var __TASKSEQCNT>_<get-var __TASKCNT>"><get-var __TASKSEQCNT>.<get-var __TASKCNT> <get-var title></a></h3> + <table border="0"> + <tr><td valign="top"><strong>Description:</strong></td><td>%body</td></tr> + <tr><td><strong>Skills:</strong></td><td><get-var skills></td></tr> + <tr><td><strong>Estimated time:</strong></td><td><get-var estimation></td></tr> + <tr><td><strong>Contact person:</strong></td><td><get-var contact></td></tr> + </table> + </boxitem> +<increment __TASKCNT> +<restore estimation> +<restore skills> +<restore contact> +<restore title> + +</define-tag> + + +<define-tag sb> + Sascha Brawer +</define-tag> +<define-tag mw> + Mark Wielaard +</define-tag> +<define-tag pr> + Patrik Reali +</define-tag> +<define-tag cm> + Casey Marshall +</define-tag> +<define-tag dt> + Dalibor Topic +</define-tag> +<define-tag mk> + Michael Koch +</define-tag> + +<set-var last-modified-author="prk"> + +<subject "GNU Classpath Tasklist"> + +<h1>GNU Classpath Tasklist</h1> + +<box> + +<boxitem> +This list is a collection of tasks for helping GNU Classpath's progress. They are a good starting point if you would like to help in producing a complete and high-quality free Java implementation. + +<p>Another source of inspiration are GNU Classpath's <createlink name="task list" url="http://savannah.gnu.org/pm/?group=classpath"> and <createlink name="patch list" url="http://savannah.gnu.org/patch/?group=classpath"> on Savannah, though these are usually meant for the project members. +</boxitem> + +<boxtitle>Index</boxtitle> +{#TASKINDEX#} + + + +<task-section name="Graphics"> +<task + title="javax.imageio" + estimation="2 weeks" + skills="" + contact="<sb> or <mk>" +> +Write an implementation of the javax.imageio framework. +</task> + +<task + title="Constructive Area Geometry" + estimation="6 weeks (?)." + skills="Computational geometry skills" + contact="<sb>" +> +Implement java.awt.geom.Area. This would be useful for some +graphics applications. +</task> + +<task + title="Composite Contexts" + estimation="2 days for each operator" + skills="It helps if you are familiar with the java.awt.image framework." + contact="<sb>" +> +Implement some CompositeContexts for Porter/Duff operators on raster +images. This would be useful for supporting 2D graphics. See +java.awt.AlphaComposite and its createContext method. +</task> + +</task-section> + +<task-section name="CORBA"> +<task + title="Help with CORBA implementation" + estimation="This depends on the sub-task you pick." + skills="Know or be ready to read the OMG documentation." + contact="Audrius Meskauskas" +> +The CORBA implementation in the Classpath project is +now a working but incomplete prototype. A number of CORBA +related tasks are available. If you are not a CORBA expert, you should be ready +to learn by reading the <createlink name="OMG specifications" +url="http://www.omg.org/cgi-bin/doc?formal/04-03-12"> and probably by writing some +relatively simple classes. +</task> +</task-section> + +<task-section name="Testing"> +<task + title="Make Mauve an application" + estimation="" + skills="" + contact="<pr>" +> +On some environments, it is not possible to run shell scripts +because there is no shell. Make the Mauve test suite a self-contained +application (one big JAR file). +</task> + +<task + title="Write Mauve tests" + estimation="" + skills="" + contact="<mw>" +> +Write Mauve tests. +</task> + +<task + title="Mauve tests for javax.image.io" + estimation="1 week" + skills="" + contact="<sb>" +> +<p>Write Mauve tests for reading in images. You could use the test images +at libpng.org and write Mauve testlets that load each image from +a file. Compute a hash (such as SHA-1) over the contents of the +DataBuffer. If the hash matches, the test succeeds. +</p><p> +Note that we don't have javax.imageio yet, so you'd have to develop +this with the Sun JDK. +</p> +</task> + +<task + title="Generator for Mauve tests" + estimation="2 weeks (prototype) + 2 weeks (tuning)" + skills="" + contact="<dt>" +> +Write a program which automatically generates basic Mauve tests. + + +</task> + +</task-section> + +<task-section name="Automation"> + +<task + title="Script for running regression tests" + estimation="1 week" + skills="???" + contact="" +> +Write a script that once a night checks out Classpath from cvs, +compiles it, runs the Mauve test suite (also from cvs) on it +using some free JVM (e.g. Kissme), and posts the results to +some web site. For comparison, it would be very helpful if the +same Mauve testlets were also run with a current Sun JVM. +</task> + +<task + title="Integrate Classpath testsuite into Mauve" + estimation="" + skills="" + contact="<mw>" +> +Classpath has a rather small number of tests in the subdirectories +test/ and testsuite/. Look through these tests and check whether the +same functionality is already tested by Mauve. If not, write a +Mauve testlet and submit it to mauve-patches@sources.redhat.com <mailto:mauve-patches@sources.redhat.com>. +The goal is to remove the test suite from Classpath. +</task> + + +<task + title="Script for running Japitools" + estimation="1 week" + skills="" + contact="???" +> +Write a script that once a night checks out Classpath from cvs, +runs Japitools on it, and posts the results on some web site. +</task> + +<task + title="Script for running gjdoc" + estimation="1 week" + skills="" + contact="" +> +Write a script that once a night checks out Classpath from cvs, +runs gjdoc on it, and posts the generated documentation on some +web site. While you're at it, fix gjdoc so it copies embedded +documentation images (classpath-tools support request #102205). +</task> + +<task + title="JAR file verification" + estimation="" + skills="" + contact="<mw>" +> +</task> +</task-section> + +<task-section name="Native stuff"> + +<task + title="Libiconv Service Provider for java.nio.charset" + estimation="2 weeks" + skills="" + contact="" +>Write a service provider for java.nio.charset that uses the +libiconv library for converting character encodings to and +from UTF-16. This would be a first step for replacing +gnu.java.io.EncodingManager by the java.nio.charset framework, +which is richer and not specific to Classpath. +</task> +</task-section> + +<task-section name="Security"> + +<task + title="Security Audit" + estimation="" + skills="" + contact="" +>We need to make a pass over the Classpath Java source, making sure +that all required calls to the SecurityManager are in place. At the same +time we need to ensure that there is no way to get around +SecurityManager by directly calling code in gnu.*. +</task> + +<task + title="Security Testing" + estimation="" + skills="" + contact="" +>We need Mauve tests for all the calls to SecurityManager. +Additionally, enabling a security manager will probably reveal +code in Classpath that needs to be wrapped in AccessController.doPrivileged(). +</task> + +</task-section> + +<task-section name="Related Projects"> +<task + title="Help GNU Crypto" + estimation="" + skills="" + contact="<cm>" +> +</task> +<task + title="Help Classpath-x" + estimation="" + skills="" + contact="" +> +??? (maybe this should be more specific, e.g. "Write an +IMAP plug-in for javax.mail on top of inetlib" (if they want +this at all) +</task-section> + +</box> |
