P3
It's a user-friendly bug.
When trying to follow the README of raf, I faced the following problems:
1. "To provide a simple and convenient packaging format of applications, Java Web Start includes a servlet in the developer's pack. The name of the servlet is JnlpDownloadServlet and is packaged into the jnlp-servlet.jar file."
<feedback>
a) Where's the jnlp-servlet.jar file?
b) If this jnlp-servlet.jar is the same as the sample/jnlp/servlet/jnlp-servlet.jar, then the README should explicitly tell the users to go to another sample code to get jnlp-servlet.jar
2. The GNUmakefile of this sample seems to create randomFile.jar under lib and .class under classes. Some feedback on the GNUmakefile:
<feedback>
a) Only the following 2 variables are used in the GNUmakefile: CLASS_PATH & SDK_HOME. FILE_SEPARATOR & TMPDIR are not used by the script.
# environment variable CLASS_PATH should contain path to javaws.jar and servlet.jar
# environment variable FILE_SEPARATOR variable for file separator (; on win32 and : o
n unix)
# environment variable TMPDIR should point to tmp directory
# environment variable SDK_HOME should point to SDK directory
b) Again, the location to javaws.jar and servlet.jar should be explicitly pointed out for users convenience.
3. "war/WEB-INF/lib/jnlp-servlet.jar (from building the JNLPDownloadServlet)"
<feedback>
a) Can users obtain jnlp-servlet.jar directly from sample/jnlp/servlet/jnlp-servlet.jar ?
b) If the answer to a) question is NOT, then users need to know how to build it. An instruction should also be provided here.
c) It's strongly recommended to have jnlp-servlet.jar bundled with the sample codes.
###@###.### 2004-03-22
When trying to follow the README of raf, I faced the following problems:
1. "To provide a simple and convenient packaging format of applications, Java Web Start includes a servlet in the developer's pack. The name of the servlet is JnlpDownloadServlet and is packaged into the jnlp-servlet.jar file."
<feedback>
a) Where's the jnlp-servlet.jar file?
b) If this jnlp-servlet.jar is the same as the sample/jnlp/servlet/jnlp-servlet.jar, then the README should explicitly tell the users to go to another sample code to get jnlp-servlet.jar
2. The GNUmakefile of this sample seems to create randomFile.jar under lib and .class under classes. Some feedback on the GNUmakefile:
<feedback>
a) Only the following 2 variables are used in the GNUmakefile: CLASS_PATH & SDK_HOME. FILE_SEPARATOR & TMPDIR are not used by the script.
# environment variable CLASS_PATH should contain path to javaws.jar and servlet.jar
# environment variable FILE_SEPARATOR variable for file separator (; on win32 and : o
n unix)
# environment variable TMPDIR should point to tmp directory
# environment variable SDK_HOME should point to SDK directory
b) Again, the location to javaws.jar and servlet.jar should be explicitly pointed out for users convenience.
3. "war/WEB-INF/lib/jnlp-servlet.jar (from building the JNLPDownloadServlet)"
<feedback>
a) Can users obtain jnlp-servlet.jar directly from sample/jnlp/servlet/jnlp-servlet.jar ?
b) If the answer to a) question is NOT, then users need to know how to build it. An instruction should also be provided here.
c) It's strongly recommended to have jnlp-servlet.jar bundled with the sample codes.
###@###.### 2004-03-22