Just Plain Limmen

Well it seems I stumbled upon a JDK bug related to the standard doclet. When a URL is found in the JavaDoc the doclet checks if the URL is valid. Not very unlogical. The parsing however is strange: if the doclets finds anything in the JavaDoc that starts with <a is must end with </a>.
So?

/**
* Map<Address, String> ...
*/

This is officially correct JavaDoc but the doclet will crash. The doclet has two bugs:

1. The doclet can not handle generics snippits in JavaDoc.
2. The doclet can not find it’s message bundle for reporting errors.

The doclet parses this comment and fails trying to show a message that the URL is malformed but it can not find the key, thus throwing a java.util.MissingResourceException.

Workaround is to avoid using <a within JavaDoc unless is it a correct URL.

I use StubleUpon with the FireFox plugin. Great fun software. I came acros this site called Pandora. This is a radio station where you can create a station that broadcasts your music. You type in an artist and it will play music that is the same. You can tell Pandora if you like the song or not so it will improve the music it plays.