A few years ago, while dumping out some Java class files, I was thinking that it would be nice if the Javadoc were embedded in the class files. That way, a tools like javap (or IDEs) could be so much more useful when given some jar file. With JDK 1.5 and annotations, such things do get embedded into class files. Why not have an option to compile Javadoc into class files as annotations?