Eclipse how to link a jar containing javadocs/source with its binary?

JavaEclipseJarJavadoc

Java Problem Overview

I would like to have the javadoc comments contained in a jar file show in eclipse when I hover over a class.

For example, after downloading JODA-2.0, three jars are obtained:

In eclipse, [right click project -> Properties -> Java Build Path -> Libraries -> ADD JARs...] includes the binary in the project (can reference those classes) for joda-time-2.0.jar.

But how can I link in the sources/javadoc comments contained in the other two jar files so that when I hover over those classes I see the javadocs?

Adding the other two jars (joda-time-2.0-javadoc.jar and joda-time-2.0-sources.jar) to the build path does not link the javadocs or the source.

Java Solutions

Solution 1 - Java

  1. Right click over the project -> Build path -> Configure build path
  2. In the new window, go to the "Libraries" tab.
  3. Select the library and expand it.
  4. There are 4 child options. Select "Javadoc location" and click the "Edit" button on the right.
  5. Now you can add a jar file containing the docs. This would be just a zip file with the extension changed to jar. Make sure inside the jar the index.html is in the root. You can press the "Validate" button to check everything is ok.

Solution 2 - Java

You can try to CTRL + click on a class that has no source attached (do that in editor). When it shows you some info about the class you'll see the button that guides to attach source dialog. Click it and in dialog that pops up pick the source/javadoc location for your class.

You can also do that from project build path settings you are mentioning: pick libraries tab, expand the library (jar) you want and you'll be offered to pick: source attachment, javadoc attachment, native library location, etc. You just pick whatever you want and edit its current settings.

Or you can do as @JB Nizet said...

Solution 3 - Java

Right-click on the jar (the one with the class files), choose "Properties", the "Javadoc location", and choose the jar file with the javadoc. Do similarly for the source jar, using "Java source attachment".

Solution 4 - Java

You can also edit the classpathentry in the file ".classpath" in your eclipse project. This can be helpful if you want to modify many entries at once or if you want to generate the path. e.g.:

<classpathentry kind="var" path="HOME/3rdparty/junit.jar" sourcepath="/SOURCE/junit_src.zip"/>

Solution 5 - Java

The easiest way is :

  1. Press control+(The word for which you want to see the Java doc)
  2. A page will appear that has a button for attach source.Click This
  3. Select External location.
  4. Browse The location to Java folder than your jdk .Than select src .zip.
  5. press OK.

The Problem is Solved.

Categories
Recommended Java Solutions
Recommended Eclipse Solutions
Recommended Jar Solutions
Recommended Javadoc Solutions

Previous Solution:

How to get 100% CPU usage from a C program

CWindowsLinuxPerformanceCray

Next Solution:

Connecting postgresql with sqlalchemy

PythonDatabasePostgresqlOrmSqlalchemy

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionearthbounceView Question on Stackoverflow
Solution 1 - JavaMister SmithView Answer on Stackoverflow
Solution 2 - JavadraganstankovicView Answer on Stackoverflow
Solution 3 - JavaJB NizetView Answer on Stackoverflow
Solution 4 - JavaMichael_SView Answer on Stackoverflow
Solution 5 - JavarajView Answer on Stackoverflow