4df7f4af80
Submitted by: Emily Boyd (emilyboyd at emilyboyd dot com) Sponsored by: Google Summer of Code 2005
71 lines
4.3 KiB
Text
71 lines
4.3 KiB
Text
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
|
|
<!ENTITY base CDATA "..">
|
|
<!ENTITY date "$FreeBSD: www/en/java/howhelp.sgml,v 1.10 2004/04/04 21:49:40 phantom Exp $">
|
|
<!ENTITY title "FreeBSD &java; Project: How To Help">
|
|
<!ENTITY % navincludes SYSTEM "../includes.navdevelopers.sgml"> %navincludes;
|
|
<!ENTITY % includes SYSTEM "../includes.sgml"> %includes;
|
|
]>
|
|
<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>
|