Updated user's guide with information on incompatibility between

JPackage "compatibility" Java RPMs and JOGL; thanks to Tim Lambert for
providing access to machine allowing this to be tracked down (again)


git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@1162 232f8b59-042b-4e1e-8c03-345bb8c30851

1 files changed, 43 insertions, 0 deletions

diff --git a/doc/userguide/index.html b/doc/userguide/index.html
index 69969cb9c..7bc47e671 100644
--- a/doc/userguide/index.html
+++ b/doc/userguide/index.html
@@ -32,6 +32,7 @@
   <UL>
     <LI> All Platforms
     <LI> Windows
+    <LI> Linux
     <LI> Solaris, Linux (X11 platforms)
     <LI> Macintosh OS X
   </UL>
@@ -141,6 +142,13 @@ conflicts with third-party applications launched via Java Web Start,
 and causes confusion later when upgrading the distribution.
 
 </P>
+<P>
+
+If you are on the Linux platform, please see the Linux-specific
+platform notes, below, with information on incompatibility between the
+JPackage Java RPMs and JOGL.
+
+</P>
 
 <H3> Java Web Start integration </H3>
 
@@ -858,6 +866,41 @@ hardware.
 
 </P>
 
+<H3> Linux </H3>
+
+<P>
+
+The Sun JDK "compatibility" RPMs (java-1.5.0-sun-compat,
+java-1.6.0-sun-compat) provided by jpackage.org are incompatible with
+JOGL. These RPMs symlink an internal JDK directory to /usr/lib, which
+overrides how both NVidia and ATI currently provide their drivers to
+some Linux distributions, which is through an override in
+/etc/ld.so.conf (actually, in /etc/ld.so.conf.d). The implicit
+presence of /usr/lib on LD_LIBRARY_PATH forces the /usr/lib/libGL.so.1
+version of OpenGL to be used, which is typically Mesa and which will
+provide only software rendering.
+
+</P>
+<P>
+
+Unfortunately the JPackage maintainers have so far been unreceptive to
+changing their installation mechanism; see <a
+href="https://www.zarb.org/pipermail/jpackage-discuss/2007-January/010871.html">this
+mailing list posting</a>. Until this is resolved, we strongly
+discourage the use of the JPackage installers for the Sun JDK.
+Instead, download the JRE or JDK installers directly from Sun's
+website.
+
+</P>
+<P>
+
+Archived forum postings illustrating this problem are <a
+href="http://www.javagaming.org/forums/index.php?topic=15610.0">here</a>
+and <a
+href="http://www.javagaming.org/forums/index.php?topic=16105.0">here</a>.
+
+</P>
+
 <H3> Solaris, Linux (X11 platforms) </H3>
 
 <P>