CODEWITHSUNDEEP
javaeclipseantjavadoc
IAmYourFaja
IAmYourFaja

Reputation: 56904

Javadocs Are Disappearing

I just whipped up a medium-sized utilities JAR to be used by many other Eclipse projects. I spent a good deal of time writing tedious javadocs so that it would be pretty obvious how to use the API.

I used Ant to throw everything in a JAR, and I am now adding that JAR to the build path of a new project. But low and behold...when I mouseover any of my utility classes/methods, the tool tip that pops up says:

Note: this element neither has attached source nor attached Javadoc and hence no Javadoc can be found.

What is going on here? What's the solution? Here is the dist Ant target that JARs up my utilities project:

<target name="dist" depends="compile">
    <jar jarfile="dist/testing-utils.jar">
        <fileset dir="bin/main" />
        <fileset dir="src/main/config" />
    </jar>
</target>

What else do I need to configure?!? Thanks in advance!

Upvotes: 0

Views: 676

Answers (2)

Miserable Variable
Miserable Variable

Reputation: 28752

If you do want to ship sources then johncarl's answer is probably correct; it is the first of the two options offered by eclipse -- attached sources. If you don't want to ship sources then you need to generate javadocs, see the ant javadoc task. With that approach, you would have two jars, one containing the compiled classes and another containing documentation. In eclipse, your users will add the class jar to project and then attach to it the javadoc jar.

Upvotes: 0

John Ericksen
John Ericksen

Reputation: 11113

The java compile task, which I assume you're using in the "compile" target, generates bytecode from your Java source. This bytecode will not include comments by design and thus your distribution jar will not include comments.

What you are probably looking for is to attach the source in Eclipse to get access to the Javadocs. You can attach source to your library jars by right clicking on the target jar, selecting properties, select Java Source Attachment and provide the location of the source jar. You can also provide a folder location, if you want to reference your project directly.

To generate a Jar that includes javadocs and source, you may use the following in ant:

<target description="bundle sources in a jar" name="package-sources">
    <jar basedir="src" destfile="build/release/${ant.project.name}-${project.version}-sources.jar"/>
</target>

Reference

Upvotes: 3

Related Questions