May 11, 2004
I am launching javadocs.org today! The site is strikingly similar to my cfdocs.org site for CFML, but just as useful.
The site is basically a URL shortcut to java documentation, for example if you want the documentation for the String class, simply type: javadocs.org/string. You can also type in the full class name http://javadocs.org/java.lang.string, but only the class name is needed (which is nice if your not sure what package a class is in).
You can also type in a package name, for example: javadocs.org/java.util
I will attempt to keep it up to date with the latest java documentation. It currently points to J2SE 1.4.2, and J2EE 1.4. I am accepting donations through Amazon honor system for hosting, and upkeep.
Comments and suggestions are welcome.
Trackback Address: 133/E6D55BF7FBDBB0F77777AE45BD2F20DA
Awesome! Just added it as a bookmarklet to Safari:
Sam, not sure about Safari but in any Mozilla/Firefox you can use bookmark keywords. http://devedge.netscape.com/viewsource/2002/bookmarks/
Nice, but would be even nicer if you could add support for J2ME and its associated APIs (MIDP 1.0, MIDP 2.0, etc).
Excellent idea! Now why can't I find java.sql.List or java.awt.List ?
Oops. I misunderstood there. Remaining question: what in case of name collisions (java.awt.List vs. java.util.List) ?
Simple but very useful site. It would be better if more intelligent for various cases. Sam Pullara's bookmarlet is cool~.
Yeah, it would be nice if name collisions resulted in a page that listed the options. Perhaps for another day. Also would be nice to add more API's.
Would it help if I offered to help add the J2ME APIs, or at least made a donation to help you do the work? :-D
Great tool! As far as improvements, apart from the 'important' name collision issue, someone also noted that different JDK versions differ, so it would be nice if we can select which version to search. J2ME also very much requested! ;)
I will add J2ME API's as soon as I have a chance.
Great minds think alike! I have a SourceForge project called Joogle [ http://sourceforge.net/projects/joogle ] to do much the same thing. We got it working, but never got round to launching it and hosting it.
It has a couple of facilities that you haven't gotten to yet: (a) end-users can register their own sites, (b) if the same package occurs on multiple sites, it will give you a choice, (c) niceties like a package-list file which make the site look like a regular (if huge!) javadoc site.
Last count, its database contains about 200 sites containing about 10,000 packages.
Please drop me a line. I think you've built something really great here, and I'd like to pool our resources to build something even better for the Java community.
You can use keywords in safari but it is slower than using a bookmarklet that gets launched with a key combo, i.e. to search i type: [Apple-4]httpsession[enter] for keywords, i have to type Apple-Lj[space]httpsession[enter] and memorize all the keywords.
Even more powerful, on esus.com, you can do a full-text search on the javadocs of J2SE1.3.1, J2SE1.4.1, J2SE1.5.0, J2EE1.3, J2EE1.4.
-Doug Kramer Javadoc team
I'm going to bookmark your site with Mozilla "bookmark keyword". I already had a "j2se" bookmark on Mozilla but it had to use Google and its "I'm feeling lucky" feature:
Before javadocs.org http://www.google.com/search?hl=en&ie=UTF-8&oe=UTF-8&q=allintitle%3A+%s+%28Java+2+Platform+SE+v1.4.2%29+site%3Ajava.sun.com&btnI=I'm%20Feeling%20Lucky
After javadocs.org http://javadocs.org/%s
Some suggestions :
1) A link to suggestions, or at least to this page. I had to google for "blog javadocs.org", because I remembered reading a blog about this.
2) Partial class name searches. I know there's only 1-2 classes which start with "JTextF", why should I have to write the whole thing? I see this as working in conjunction with whatever you come up with for resolving name collisions - presumably a page with link to each colliding class.
3) Specify the JDK as part of the search , with some default.
4) I personally use <a href='http://sumitkishore.tripod.com/java/j2se14api.html'>this layout</a> to view the javadocs, and have found it to be easier to navigate than the Sun default. Maybe an option to switch layouts?
To all the people that suggested bookmark keywords over my bookmarklet at the top. The bookmarklet is much faster than keywords, one keystroke to bring up the input window, then type what you want, and press enter versus getting to the location bar, typing the keyword and space and the search plus enter. Anyway, whatever you find easier.
Well I'm a few years too late at commenting but I just found this today and I think it's very handy!