diff options
Diffstat (limited to 'en_US.ISO8859-1/htdocs/java/howhelp.sgml')
-rw-r--r-- | en_US.ISO8859-1/htdocs/java/howhelp.sgml | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/en_US.ISO8859-1/htdocs/java/howhelp.sgml b/en_US.ISO8859-1/htdocs/java/howhelp.sgml new file mode 100644 index 0000000000..8eec8fca46 --- /dev/null +++ b/en_US.ISO8859-1/htdocs/java/howhelp.sgml @@ -0,0 +1,70 @@ +<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [ +<!ENTITY base CDATA ".."> +<!ENTITY date "$FreeBSD: www/en/java/howhelp.sgml,v 1.11 2005/10/04 20:56:33 hrs Exp $"> +<!ENTITY title "FreeBSD &java; Project: How To Help"> +<!ENTITY % navinclude.developers "INCLUDE"> +]> +<html> +&header; +<table border="0"> +<tr> +<td> +<P><B>I want to</B>: +<BR>...<A HREF="#code">work on the port itself</A> +<BR>...<A HREF="#testing">help testing</A> +<BR>...<A HREF="#BUG">report a bug</A> +<BR>...<A HREF="#documentation">write documentation</A> + + +<A NAME="code"></A> +<P><B><FONT COLOR="#660000">So you want to help, do you?</FONT></B></P> +<P>Working on the &jdk; port requires a firm grasp of C, the FreeBSD architecture, and a lot of time to spare. The changes that need to be made in the code have to do with how FreeBSD differs from Solaris™, so if you don't know these, you will not go very far in the port. We have +had many people say they are willing to help, but when they see what is involved, they drop away. +<P>Having been dutifully warned, here is what you need to do to get involved: +<OL> +<LI><B>Obtain a license from Sun for the source code</B> +<UL> +<LI><B>For JDK 1.1.x</B> You will need to obtain a "Non-Commercial License" This is done at <A HREF="http://www.javasoft.com/nav/business/source_form.html">http://www.javasoft.com/nav/business/source_form.html</A> +<LI><B>For Java 2</B> You will need to agree to and sign the "Community Source License" This is done at <A HREF="http://jsecom4.sun.com:80/servlet/EComActionServlet/ECom.WelcomePageInfo;$sessionid$">the Sun Download Center</A> +</UL> +<LI><B>Download the source code</B> +<UL> +<LI><B>For JDK 1.1.x</B> Instructions will be provided to you by Sun. +<LI><B>For Java 2</B> You may download the source code from <A HREF="http://www.sun.com/software/java2/download.html">http://www.sun.com/software/java2/download.html</A> +</UL> +<LI><B>Use Patches</B> Patches and build instructions may be downloaded from +<A HREF="http://www.eyesbeyond.com/freebsd-jdk122-patches-latest.tar.gz">http://www.eyesbeyond.com/freebsd-jdk122-patches-latest.tar.gz</A>. Currently open +issues and test results may be found at +<A HREF="http://www.kjkoster.org/java/index.html">http://kjkoster.org/java/index.html</A> +<H3>AND/OR</H3> +<LI><B>Obtain source code "diffs"</B> Notify Nate Williams <A HREF="mailto:nate@yogotech.com">nate@yogotech.com</A> that you have the license and arrange to gain access to the CVS tree. +<H3>AND/OR</H3> +<LI><B>Begin hacking on the sources</B> Begin your porting. Jump right in and start digging. +<LI><B>Let the world know you have finished it!</B> +</OL> + +<A NAME="testing"></A> +<P><B><FONT COLOR="#660000">You want to help, but do not know C or FreeBSD <I>that</I> well?</FONT></B></P> +<P>The absolute best thing you can do is download the <A HREF="dists/">latest release</A>, install it, and try all your favorite Java applications. If they don't work, see below. + +<A NAME="BUG"></A> +<P><B><FONT COLOR="#660000">I have a bug!</FONT></B></P> +<P>If you find an application that does not work, or crashes, here are the steps you should follow before reporting it: +<OL> +<LI>Try it again. +<LI>Check your settings for this application. Check to see if you made a mistake in starting it up. +<LI>Try it on a different platform. If you have access to a reference platform, try it there. (We need to determine if it is an application error, a Java bug, or a FreeBSD specific bug.) +<LI>Narrow down the problem. If it is your own code, narrow down the bug to the offending code. Otherwise, determine the steps required to reproduce the problem. +<LI>Notify the JDK porting team. Send email to <A HREF="mailto:freebsd-java@FreeBSD.org">freebsd-java@FreeBSD.org</A>. Be sure to include the steps you have followed. +<LI>Finally, and most importantly, be willing to work with the team to fix the problem. +</OL> + +<A NAME="documentation"></A> +<P><B><FONT COLOR="#660000">I can help with the web site or documentation!</FONT></B></P> +<P>Everyone can help here. If you have a suggestion to add to the documentation, write it up and send it to <A HREF="mailto:freebsd-java@FreeBSD.org">freebsd-java@FreeBSD.org</A> +</td> +</tr> +</table> +&footer; +</BODY> +</HTML> |