[java-common] Integrating to java-wrappers modifications suggested by Eric Lavarde

1 files changed, 45 insertions, 0 deletions

diff --git a/wrappers/java-wrappers.7 b/wrappers/java-wrappers.7
index 25a850b..28c48ad 100644
--- a/wrappers/java-wrappers.7
+++ b/wrappers/java-wrappers.7
@@ -46,6 +46,20 @@ command that will be run. If this variable is set, it disables all
 lookup for a java runtime.
 
 .TP
+.B JAVA_BINDIR
+Specifies a directory that will be looked for a 
+.I java
+or a 
+.I jdb
+executable (depending on the setting of
+.IR JAVA_DEBUGGER ).
+It has precedence over 
+.I JAVA_HOME
+but not over
+.IR JAVA_CMD .
+
+
+.TP
 .B JAVA_HOME
 A path to a java runtime. If this variable is set, all lookup for a
 java runtime is disabled, except that if no 
@@ -84,6 +98,18 @@ This is probably the most important variable; if it set, the wrapper
 will print out useful information as it goes by its business, such as
 which runtime it did find, and which command is run eventually.
 
+.TP
+.B JAVA_JARPATH
+The path where the wrappers will go looking for 
+.I jar
+archives. If not set, the wrapper will look into the default
+directory,
+.IR /usr/share/java .
+.B Warning :
+the wrapper will not look anywhere else than in 
+.IR JAVA_JARPATH .
+Setting it incorrectly will most probably result in early crashes.
+
 .SH EXAMPLES
 
 The examples all rely on 
@@ -103,11 +129,30 @@ Force rasterizer to run with
 
 .I JAVA_HOME=/usr/lib/kaffe rasterizer
 
+The same, but using 
+.IR JAVA_BINDIR :
+
+.I JAVA_BINDIR=/usr/lib/kaffe/bin rasterizer
+
 Debug rasterizer with Sun's debugger, while printing debugging
 information from the wrapper:
 
 .I DEBUG_WRAPPER=1 JAVA_CMD=/usr/lib/jvm/java-6-sun/bin/jdb rasterizer
 
+.SH BUGS
+
+Care has been taken to make the wrappers bug-free. If that was not
+the case, please file a bug report against
+.B java-common
+with a java-wrappers in the title.
+
+If you wish to submit any problem with a java executable relying on
+.BR java-wrappers ,
+please also submit the output of the command run with
+.IR DEBUG_WRAPPER=1 .
+It will save one mail exchange and therefore potentially reduce the
+time it will take to fix the bug.
+
 .SH SEE ALSO
 
 .BR java (1),