Is there any disadvantage to putting API code into a JAR along with the classes?

Question

In Java if you package the source code (.java) files into the jar along with classes (.class) most IDE\'s like eclipse will show the javadoc comments for code compl

Answer 1

Using maven, attach the sources automatically like this:

http://maven.apache.org/plugins/maven-source-plugin/usage.html

and the javadocs like this:

http://maven.apache.org/plugins/maven-javadoc-plugin/jar-mojo.html

That way they will automatically be picked up by

mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true 

or by m2eclipse