java apidocs for websockets

working thru the websocket examples in tomcat 8, and realize that i don't have javadocs for the javax.websocket stuff. this is a chronic annoyance with java - you're using interfaces that are pretty "standard", and they turn out to live in javaEE. and the apidocs are licensed in a way that platforms that implement the standard can't include the apidocs. so you're left with a lobotomized IDE with zero javadocs. it's dumb

for tomcat 8, netbeans 8 and the websocket and servlet stuff:

• download the websocket apidocs from
• http://download.oracle.com/otndocs/jcp/websocket-1_0-fr-spec/index.html
• currently called javax.websocket-api-1.0-apidoc.zip
• download the servlet apidocs from
• http://download.oracle.com/otndocs/jcp/servlet-3_1-fr-spec/index.html
• currently called javax.servlet-api-3.1-final-javadoc.jar
• in netbeans -> tools -> servers -> tomcat 8 -> javadocs, add the apidocs.zip (or jar) files

oracle is evil ...

• apidocs for standards should be liberally licensed
• this is "embrace, extend and extinguish" in all it's glory
• websockets and servlets don't belong in javaEE, they're standard web technologies