Added documentation and usage of codebase_lookup=false

1 files changed, 27 insertions, 3 deletions

diff --git a/src/org/jdesktop/applet/util/JNLPAppletLauncher.java b/src/org/jdesktop/applet/util/JNLPAppletLauncher.java
index 283d2c8..bbb8372 100644
--- a/src/org/jdesktop/applet/util/JNLPAppletLauncher.java
+++ b/src/org/jdesktop/applet/util/JNLPAppletLauncher.java
@@ -37,8 +37,8 @@
  * intended for use in the design, construction, operation or
  * maintenance of any nuclear facility.
  *
- * $Revision: 1.12 $
- * $Date: 2007/07/04 20:45:31 $
+ * $Revision: 1.13 $
+ * $Date: 2007/07/05 16:06:47 $
  * $State: Exp $
  */
 
@@ -239,6 +239,27 @@ import org.xml.sax.helpers.DefaultHandler;
  * The <a href="#EXAMPLES">examples</a> show how to use the
  * JNLPAppletLauncher in a few different scenarios.
  *
+ * <h2>The codebase_lookup parameter</h2>
+ *
+ * <p>
+ *
+ * This applet parameter is not currently well documented, but it
+ * disables certain legacy behavior of the Java Plug-In. Before the
+ * introduction of jar files, applets used to host their class files
+ * and resources as flat files on the web server. Once jar files were
+ * introduced, it was possible to improve the efficiency of resource
+ * loading for applets, but (apparently) not without breaking
+ * compatibility. An applet can specify the parameter
+ *
+ * <pre>
+ * &lt;param name="codebase_lookup" value="false"&gt;
+ * </pre>
+ *
+ * <p>
+ *
+ * to improve efficiency of its loading if it does not rely on
+ * fetching flat files from the web server off the codebase.
+ *
  * <h2>Applets using the OpenGL(r) 3D API</h2>
  *
  * <p>
@@ -301,6 +322,7 @@ import org.xml.sax.helpers.DefaultHandler;
  *      height=480
  *      codebase="http://download.java.net/media/java3d/applets/applet-test/"
  *      archive="applet-launcher.jar,j3d-examples.jar,j3dcore.jar,j3dutils.jar,vecmath.jar"&gt;
+ *   &lt;param name="codebase_lookup" value="false"&gt;
  *   &lt;param name="subapplet.classname" value="org.jdesktop.j3d.examples.four_by_four.FourByFour"&gt;
  *   &lt;param name="subapplet.displayname" value="Java 3D Four by Four Applet"&gt;
  *   &lt;param name="jnlpNumExtensions" value="1"&gt;
@@ -327,6 +349,7 @@ import org.xml.sax.helpers.DefaultHandler;
  *               http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl.jar,
  *               http://download.java.net/media/gluegen/webstart/gluegen-rt.jar,
  *               http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl-demos.jar"&gt;
+ *   &lt;param name="codebase_lookup" value="false"&gt;
  *   &lt;param name="subapplet.classname" value="demos.applets.GearsApplet"&gt;
  *   &lt;param name="subapplet.displayname" value="JOGL Gears Applet"&gt;
  *   &lt;param name="noddraw.check" value="true"&gt;
@@ -355,6 +378,7 @@ import org.xml.sax.helpers.DefaultHandler;
  *               http://download.java.net/media/jogl/builds/archive/jsr-231-webstart-current/jogl-demos.jar,
  *               http://download.java.net/media/joal/webstart/joal.jar,
  *               http://download.java.net/media/joal/webstart/joal-demos.jar"&gt;
+ *   &lt;param name="codebase_lookup" value="false"&gt;
  *   &lt;param name="subapplet.classname" VALUE="demos.applets.GearsJOALApplet"&gt;
  *   &lt;param name="subapplet.displayname" VALUE="JOGL / JOAL Gears Applet"&gt;
  *   &lt;param name="noddraw.check" value="true"&gt;
@@ -537,7 +561,7 @@ import org.xml.sax.helpers.DefaultHandler;
  * <p>
  * 
  * The JNLPAppletLauncher was developed by Kevin Rushforth, Kenneth
- * Russell, and Chien Yang. It is based on the former
+ * Russell, and Chien Yang. It is based on the earlier
  * JOGLAppletLauncher developed by Lilian Chamontin.
  */