diff --git a/en/java/howhelp.sgml b/en/java/howhelp.sgml index 67f00af704..7af9234a29 100644 --- a/en/java/howhelp.sgml +++ b/en/java/howhelp.sgml @@ -1,65 +1,72 @@ - + %includes; ]> &header;

I want to:
...work on the port itself
...help testing
...report a bug
...write documentation

So you want to help, do you?

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.

Having been dutifully warned, here is what you need to do to get involved:

  1. Obtain a license from Sun for the source code
  2. Download the source code +
  3. Use Patches Patches and build instructions may be downloaded from +http://www.e +yesbeyond.com/freebsd-jdk122-patches-4.tar.gz. Currently open +issues and test results may be found at +http://web.inte +r.nl.net/users/kjkoster/java/index.html. +

    AND/OR

  4. Obtain source code "diffs" Notify Nate Williams nate@yogotech.com that you have the license and arrange to gain access to the CVS tree.

    AND/OR

  5. Begin hacking on the sources Begin your porting. Jump right in and start digging.
  6. Let the world know you have finished it!

You want to help, but do not know C or FreeBSD that well?

The absolute best thing you can do is download the latest release, install it, and try all your favorite Java applications. If they don't work, see below.

I have a bug!

If you find an application that does not work, or crashes, here are the steps you should follow before reporting it:

  1. Try it again.
  2. Check your settings for this application. Check to see if you made a mistake in starting it up.
  3. 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.)
  4. 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.
  5. Notify the JDK porting team. Send email to freebsd-java@freebsd.org. Be sure to include the steps you have followed.
  6. Finally, and most importantly, be willing to work with the team to fix the problem.

I can help with the web site or documentation!

Everyone can help here. If you have a suggestion to add to the documentation, write it up and send it to freebsd-java@freebsd.org

&footer; diff --git a/en/java/newsflash.sgml b/en/java/newsflash.sgml index 336407cf7e..2c5773ca5b 100644 --- a/en/java/newsflash.sgml +++ b/en/java/newsflash.sgml @@ -1,323 +1,339 @@ - + %includes; ]> &header;
+

March, 2000

+
    +
  • March 22, 2000: Pre-Alpha JDK 1.2.2 patches availible. +
    Greg Lewis releases the pre-alpha patches for enterprisi +ng +Java users to build their own native FreeBSD JDK 1.2.2 from. This +process is not for the faint of heart, and the resulting JDK is not for +production systems. Having said that, most AWT and Swing demo's have been +found to run. There is plenty of work to do, and we need all the testers we +can find. Patches and build instructions may be downloaded from +http://www.e +yesbeyond.com/freebsd-jdk122-patches-4.tar.gz. Currently open +issues and test results may be found at +http://web.inte +r.nl.net/users/kjkoster/java/index.html. +

January, 2000

  • January 30, 2000: Blackdown 1.2.2RC4 JDK
    The Linux Blackdown Port Team has released RC4 of JDK 1.2. It has been tested on FreeBSD 3.4-STABLE and later and runs all demo applets and jfc demos. Several people have mentioned some problems running it with Apache JServ. Until it can be added to the FreeBSD port tree, it can be found at http://www.jmcm.org/tech/ports/linux_jdk.html. (Reported by Jose Marques)

November, 1999

  • November 28, 1999:Request for Enhancement
    We have petitioned Sun to provide an official FreeBSD JDK2 port. We are currently in 2nd place in the vote count. If you are a member of the Java Developer's Connection (it's free), you can vote for it as well http://developer.java.sun.com/developer/bugParade/bugs/4288745.html
  • November 9, 1999:Another JDK1.1.8 release to fix a separate class of multicast bugs.

October, 1999

  • October 11, 1999: Work has re-started on the Java2/JDK1.2 port. Expect an early 'alpha' release in the coming weeks for FreeBSD 3.3-stable/ELF boxes.

September, 1999

  • September 22, 1999: Re-rolled the JDK1.1.8 yet again to fixup some minor bugs that people have found, as well as to speedup the JDK. For details checkout the README.FreeBSD supplied in the releases.

July, 1999

  • July 19, 1999: Re-rolled the JDK1.1.8 release to fix a couple of minor (but annoying bugs). First, the netpatch (see below) was incorporated into the build, and second an annoying Floating Point bug was found and fixed. The latter bug affected multi-threaded code that did floating point calculations and based on the code could produce completely bogus results.
  • July 2, 1999: Organization of FreeBSD 'CommAPI' porting team wich is an effort to make JAVA's CommAPI freely available to the FreeBSD community. Project is coordinated by DRICOT Jean-Michel and will officialy be maintained in http://student.ulb.ac.be/~jdricot/commapi/. Feel free to contact him if you want to join the project.

June, 1999

  • June 8, 1999: A small bug was found in the JDK1.1.8 release which affected people using UDP sockets. If you tried to send a packet to the broadcast address, the FreeBSD JDK refused with a permissions error. This error was fixed, and rather than re-releasing the entire release a small patchset was re-rolled for those folks who are experiencing this problem. If you experience this problem, feel free to download the gzipped tarfile and untar it wherever you installed the jdk. It will install itself over top of the old version. If you aren't experiencing the bug, there is no need to apply the patch, although it wouldn't hurt.
  • June 3, 1999: JDK1.1.8 for A.OUT and ELF releases. This release adds support for older 3.*/ELF releases (without requiring any runtime loader changes), as well as fixes bugs in LOCALE and timezone support for all FreeBSD releases.
  • June 1, 1999: JDK2 status
    • Work on JDK1.2/JDK2 has been going very slow as the development team has been focusing it's effort on solid JDK1 releases. For most JDK2 development issues, you can use the JDK1 release and the Swing releases provided by Sun for JDK1, which works very well under FreeBSD.

April, 1999

  • Apr. 16, 1999: New JDK1.1.7 A.OUT release. This fixes build problems in the March release. A new ELF release will be made to support older 3.0 releases as well sometime in the near future.

March, 1999

  • Mar. 26, 1999: ELF support for JDK1.1.7, as well as a new A.OUT release which includes minor bugfixes.
    • jdk1.1.7_AOUT.V99-3-24.tar.gz. For FreeBSD versions 2.2.*, which use the A.OUT binary format.
    • jdk1.1.7_ELF.V99-3-25.tar.gz. For FreeBSD versions 3.x and 4 which use the ELF binary format. Note: This requires changes made to the runtime loader to support dladdr() functionality made on 1999/3/24. You will need to be running 3.1-stable or 4.0-current dated later than 1999/3/24. If you don't have the new loader binary or are not tracking -stable or -current, you can download it from here and install it as /usr/libexec/ld-elf.so.1 (you need to be root to do this): 
      # install -c -s -o bin -g bin -m 555 -C -fschg ld-elf.so.1 /usr/libexec
  • Mar. 16, 1999: Updates on current development:
    • ELF JDK1.1.7 : An ELF build of JDK1.1.7 (for use on FreeBSD 3.x and later) is currently entering it's initial internal testing phase. A beta release should be availible in a few weeks.
    • JDK2 (aka JDK1.2): Several individuals are working on porting JDK2 to FreeBSD, but the work is progressing slowly. This is primarily due to a lack of developer time to work on this project. (The release of Blackdown's JDK2 port will assist our development when they release their source diffs.)

December, 1998

  • Dec. 21, 1998: jdk1.1.7.V98-12-21.tar.gz.
    • Bugfix version of JDK1.1.7. Thanks go to Keith White who tracked down a couple annoying (and serious) bugs in the JDK, notably the modulo bug. This release also has the 256 file-descriptor limit bumped up to 2048. The JRE should also be much more usable, again thanks to Keith.

November, 1998

September, 1998

  • Sept 23, 1998: jdk1.1.6.V98-9-23.tar.gz.
    • The August 14 build had jre incorrectly linked in both the JDK and the JRE, so a new release was rebuilt with the correct linkage. Otherwise, there were no changes from the older release.

August, 1998

  • Aug 22, 1998:
    • Updated page to list numerous sites who have agreed to mirror the JDK and provide ftp access. Thanks to all!
  • Aug 14, 1998: jdk1.1.6.V98-8-14.tar.gz.
    • The SO_REUSEADDR option is now correctly set on ServerSockets (may affect other sockets as well.)

July, 1998

  • July 21, 1998: jdk1.1.6.V98-7-21.tar.gz.
    • Updated port to JDK1.1.6. Thanks go to Keith White kwhite@site.uottawa.ca who did most of the work to make this release happen!
    • More standard 'naming' for java.version and such.
    • Fixes for UDP/Multicast sockets.
    • The signal abort error may be fixed (knock on wood).
    • Add support for the "KOI8-R" and "CP866" encodings.
    • Timezone's now work correctly under FreeBSD (this required some native code, but it is embedded in the JDK so shouldn't affect users. However, FreeBSD has one of the few (only?) VM's that correctly support Timezones now).
    • sysRmdir() now correctly removes directories.
    • Link in the xpg4 library to support CJK locales.

May, 1998

  • May 5, 1998:
    • Updated page to include instruction on how to get Sun's JWS (Java Work Shop) working under FreeBSD.

February, 1998

  • February 25, 1998: jdk1.1.5.V98-2-25.tar.gz.
    • JDK's built on 2.2.2 should now work again.
    • The AWT now correctly sets the Window name.
    • Fixed obscure bug that could cause a core dump if you hit a button in a dialog box multiple times.
    • Fixed bug where SHMEM wasn't released when using images, causing a leak.
    February 12, 1998:
    • Johan Larsson graciously provided an ftp mirror site for the JDK, so if you have an aversion to using HTTP, then feel free to grab it from his site.
    • Replaced the 'Steaming Cup of Java' logo with the 'Jump to Java' logo, which is more politically (and legally) acceptable to SUN's lawyers.
    February 9, 1998: jdk1.1.5.V98-2-8.tar.gz.
    • Fixed bugs in Process.waitFor()
    • Modified the way the Motif library was linked in. This will allow anyone with a Motif library (static or dynamic) to build their own JDK once the patchkit is released. If their Motif license allows for it, they can also make binary releases available.
    • Non blocking reads on PIPE did not work reliably on all versions of the OS.
    • Multicast now works.

January, 1998

  • January, 1998:
    • Organization of FreeBSD 'JDK' porting team, which now jointly creates new JDK releases for FreeBSD.
    • New JDK1.1.5 binary, which has Motif statically compiled in. (Unfortunately, this release was lost in a disk crash on the ftp server.)
&footer;