cfd9e12239
- Move includes.nav*.sgml to share/sgml/navibar.ent and
<lang>/share/sgml/nabibar.l10n.ent.
- Move includes.sgml and includes.xsl to
share/sgml/common.ent, share/sgml/header.ent, <lang>/share/sgml/l10n.ent,
and <lang>?share/sgml/header.l10n.ent.
- Move most of XSLT libraries to share/sgml/*.xsl and
<lang>/share/sgml/*.xsl.
- Move news.xml and other *.xml files for the similar purpose
to share/sgml/*.xml and <lang>/share/sgml/*.xml.
- Switch to use a custom DTD for HTML document. Now we use
"-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension", which is
HTML 4.01 + some entities previously pulled via
"<!ENTITY % includes SYSTEM "includes.sgml"> %includes;" line.
The location of entity file will be resolved by using catalog file.
- Add DOCTYPE declearation to XML documents. This makes the followings
possible:
* Use of &foo; entities for SGML in an XML file instead of defining
{$foo} as the same content.
* &symbolic; entities for Latin characters.
- Duplicated information between SGML and XML, or English and
translated doc, has been removed as much as possible.
70 lines
4.2 KiB
Text
70 lines
4.2 KiB
Text
<!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>
|