Where Are The Servlet 2.5 Javadocs?
I'm working on a project that involves Tomcat 6.0, which uses the Servlet 2.5 spec. Apparently as of Tomcat 6.0 the Tomcat team has decided that it's no longer their place to provide any API documentation, at all.
Instead they shuttle you over to Sun's site, which has them available online. And nowhere else.
Want to download just the API docs? Well, you can't. The download page tells you that if you want to get the Javadocs, you're going to start with a 110MB download. Uh, no. Not happening.
If you search further eventually you'll be informed that there's a merge 5MB download that may contain just the Javadocs. Possibly. I'm not sure. Unfortunately it contains the documentation for absolutely every part of J2EE, all in one large bundle of crap, which makes essentially completely useless. No one cares about Enterprise Java Beans, and I don't need to wade through thousands of classes to find the twenty or so I actually care about.
But wait, what's this? They send you over to JSR-154, and tell you that you can download the specification there. One of the two listed.
Well, since I'm not creating an implementation and I just want to use the damned thing, I guess that means the first option.
Unfortunately they don't tell you what that first specification actually is. If I were to guess, I would have guessed it was the entire specification, including details about the WEB-INF directory and all that stuff.
Click through and you'll get taken to a scary license agreement describing your rights to the contained software. Software?! I just want the documentation!
Which is what it is. It's the Javadocs I was looking for in the first place, plus a completely useless JAR containing an implementation of just those classes.
How is anyone supposed to guess that's how you get the documentation?! It's not even labeled "documentation" it's described as the "Java(TM) Servlet Specification Evaluation 2.5 Maintenance Release."
But I finally have the Javadocs I needed, about an hour after I started looking for them. Thanks for making the process so easy, Sun!