FreeBSD Java Project web content improvements

[Mike Brown]

To whom it may concern,

I have some suggestions for improving some of the FreeBSD Java Project's web
page content. Someone should audit these suggestions for accuracy before
implementing them.

Thanks!


http://www.freebsd.org/java/
===========================================================================
Indent the JDK links listed under the Release Information link,
so that it's clear that the links take you to release info only.

To clarify that there are different distributions described in these pages, do
the following:

Change the intro sentence to say "The FreeBSD Java Project maintains the
official port of Sun's Java™ Development Kit for FreeBSD. The port allows
native JDK binaries to be built on FreeBSD 4.x and up."

Start the first sentence of the 2nd paragraph with "Additionally,".

Merge the last paragraph ("For further information...") into the one preceding
it, so that it's clear that it only applies to the FreeBSD Foundation's
binaries. Or consider removing the sentence entirely, if you accept my
proposal below re: adding the Diablo details to the Getting Java for FreeBSD /
How To Install page.

Add another paragraph to the end:

"It is possible to use non-native JDKs and JREs on FreeBSD, such as the Linux
binaries provided by Sun, IBM, and the Blackdown project. These are covered
under Getting Java for FreeBSD."


http://www.freebsd.org/java/docs/faq.html
===========================================================================
The FAQ is way out of date; there has been a Blackdown port for ages, so
no manual patching is necessary, and the question about the availability
of native JDK 1.3 predates the availability of that information elsewhere.

I suggest deleting the two questions in the FAQ, and adding this one:

  Q. Why do I get a "Can't detect initial thread stack location" warning when 
     I run a Linux Java VM?
  A. linprocfs is not mounted. To rectify this, as root, do the following:

     mkdir -p /compat/linux/proc
     kldload linprocfs
     mount -t linprocfs linprocfs /compat/linux/proc

     For permanence, you may also consider adding an entry to /etc/fstab:
     linprocfs	/compat/linux/proc	linprocfs	rw	0	0

     and /boot/loader.conf:
     linprocfs_load="YES"

Also consider adding the answer to:

  Q. What's the difference between this project's native JDK ports, the
     FreeBSD Foundation's packages, and the diablo-jdk ports?
     Which should I install?


http://www.freebsd.org/java/install.html
===========================================================================
The title of this page is "How To Install" but it is linked from the main
page as "Getting Java for FreeBSD". Decide what it should be called and
update accordingly.

Update all examples to use jdk15 instead of jdk14.

Since other JDK ports are being mentioned, below the first entry, add a
section for Diablo (/usr/ports/java/diablo-jdk15), the FreeBSD Foundation's
native JDK on FreeBSD. Mention the packages at
http://www.freebsdfoundation.org/downloads/java.shtml as well as the port.

Mention that X11 libraries are required for the native JDKs, except jdk11.
linux-ibm-jdk13 also requires native X libs. The other Linux versions don't
require X at install time, but some may need the linux-XFree86-libs port or
package to be installed in order to run.


http://www.freebsd.org/java/dists/
===========================================================================
To clarify that this info only applies to one of the many available Java
distributions, change the intro sentence to "This is the release information
for the FreeBSD Java Project's official port of Sun's Java Development Kit for
FreeBSD. Release information about other JDKs is not provided here."


http://www.freebsd.org/java/newsflash.html
http://www.freebsd.org/java/dists/15.html
===========================================================================
On both of these pages, consider adding an announcement of Diablo, and in it,
clarify the relationship between the FreeBSD Foundation's efforts and those of
the FreeBSD Java Project. Both have produced "native" JDKs, so it's rather
confusing.