Recently at work I had to write a set of JSP tag files (as in .tag files, not Java classes) for our designers to use. Naturally, when you write software for someone else to work with you need good documentation. At first I used Sun's tool for generating the JavaDoc for those tag files. Soon, however, I discovered that it had a few bugs: It was borking non-ASCII characters. And there didn't seem to be a way to exclude certain folders so it was often listing tags twice in the resulting documentation. Another gripe I had (which is also the case with the regular JavaDoc tool) was the extremely ugly mid-90s default stylesheet. The tool seemed to have been abandoned (last change in 2005), but I managed to checkout a working copy from their CVS. Stupidly, dev.java.net requires an account to simply checkout code, but luckily I found account details on bugmenot.