J2SE Version (please include all output from java -version flag):

  java version "1.6.0_04"
  Java(TM) SE Runtime Environment (build 1.6.0_04-b12)
  Java HotSpot(TM) Client VM (build 10.0-b19, mixed mode, sharing)

Operating System Configuration Information (be specific):
Windows XP PRO SP2
IE 7.0

Hardware Configuration Information (be specific):
Sony VAIO laptop 2.8 Gz
1.25 GB RAM


Bug Description:
Docs are out-of-date, have errors, and need to talk about how to deal with query strings.

The readme for the JNLP servlet has a URL to get additional information. However, this page is out-of-date.
http://java.sun.com/j2se/1.5.0/docs/guide/javaws/developersguide/downloadservletguide.html
It does not talk about the $$site or $$hostname. However my biggest complain is that it says nothing about how to deal with string query strings...a subject I can find no good information on.

It mentions:
     <servlet-mapping>
        <servlet-name>JnlpDownloadServlet</servlet-name>
        <url-pattern>*.jnlp</url-pattern>
     </servlet-mapping>

But it makes no mention of something for the jar files. The docs state that it will automatically deliver the packed version if it can, but it won't without help. To use pack200, both the packed and unpacked forms of the jar file must exist on the webserver, making it difficult tell if the pack file is actually getting distributed or not. However, it seems that without a mapping like:
     <servlet-mapping>
        <servlet-name>JnlpDownloadServlet</servlet-name>
        <url-pattern>*.jar</url-pattern>
     </servlet-mapping>
there will be nothing to deliver the packed jar files. A brief look at network packets verifies this hypothesis.

(I realize that one could map a URL path, but presenting the *.jnlp URL pattern and not the jar one, causes confusion.)

In the downloaded JDK 6 docs it has this:
docs/technotes/guides/javaws/enhancements6.html
"The JnlpDownloadrServlet now contains both a $$hostname and a $$sight macro."
The $$sight is supposed to be $$site

Lastly, it seems the JnlpDownloadServlet is becoming a critical part of the webstart solution. For instance, it is referenced in the "guide". However, the servlet is buried in the samples of the JDK. Given this, I am not sure what the nature of it is. It seems like it is being supported, but is it going to continue to be? If I utilize it, do I need to worry about it going away in the future?