Date: Sat, 29 Jul 2006 14:56:49 -0600 (MDT) From: Mike Brown <mike@skew.org> To: freebsd-doc@FreeBSD.org, freebsd-java@FreeBSD.org Subject: FreeBSD Java Project web content improvements Message-ID: <200607292056.k6TKunSw091046@chilled.skew.org>
next in thread | raw e-mail | index | archive | help
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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200607292056.k6TKunSw091046>