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.

It isn't.

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!

Topics: 

Comments

Search for "API documentation (Javadocs)" in http://java.sun.com/javaee/downloads/index.jsp url. You can find the Servlet 2.5 and JSP 2.1 javadoc as part of JavaEE 5 SDK. But, I don't why Sun doesn't provide interface to download the javadoc of each technology independently!!

Ramesh

Thanks...I looked everywhere for these docs until I found your page.

I had the same problem to download Javadoc for servlet 2.5. Many thanks to Ramesh.

Anyway, I have more times problems to find proper download on the Sun web. I do not, why they cannot make something like sf.net - easy to find anything. Anyway, other "big" companies have problems with their websites, too. meybe they are soo big so they do not need to care about it.

Agreed. Not only is the website disorganized and illogical but so is the version naming scheme.

I think in the page of http://download.oracle.com/otndocs/jcp/servlet-2.5-mrel-eval-oth-JSpec/
download the 384 kb content and extract it. It has the javadocs for javax.servlet
and javax.servlet.http
are u looking for these?? they also have that .jar for Implementation purpose.