Bug 159839 - Attach local Javadoc archive using a relative path or variable
Summary: Attach local Javadoc archive using a relative path or variable
Status: NEW
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.2.1   Edit
Hardware: PC Windows XP
: P3 enhancement with 16 votes (vote)
Target Milestone: ---   Edit
Assignee: JDT-Core-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
: 122805 213366 (view as bug list)
Depends on:
Blocks:
 
Reported: 2006-10-05 03:18 EDT by Christian Nelson CLA
Modified: 2019-11-18 10:50 EST (History)
12 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Christian Nelson CLA 2006-10-05 03:18:20 EDT
When associating Javadoc to a library, there is no way to make a relative association.  All associations are either URLs to local or remote resources, or "Javdoc in archive" which also captures an absolute path.  "Javadoc in archive" even captures an absolute path when the Javadoc archive is located in the workspace.

This prevents teams from sharing projects files that make reference to Javadoc for 3rd party libs that live within the project's workspace, unless all team members use the same drive/directory layout.

Additionally, there is no way to extend a variable (like one can with source) for Javadoc.

It's desirable is some situations to store the source and Javadoc with the 3rd party libraries within the project.  The team can all share the benefits of navigating source and documentation without having to maintain it individually, and without having to actively hit the internet for public documentation.

Regards,
Christian
Comment 1 Olivier Thomann CLA 2008-07-30 10:47:02 EDT
*** Bug 213366 has been marked as a duplicate of this bug. ***
Comment 2 Markus Keller CLA 2011-02-04 06:35:58 EST
*** Bug 122805 has been marked as a duplicate of this bug. ***
Comment 3 Brad Clarke CLA 2013-03-05 14:23:03 EST
This is an example of the problem using JUnit in 4.2.2. The library itself and the source jar are put in .classpath using project-relative paths, but the javadoc jar path is workspace relative and includes a hard coded project name:

<classpath>
	<classpathentry kind="src" path="src"/>
	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.7"/>
	<classpathentry kind="lib" path="lib/junit-4.11.jar" sourcepath="lib/junit-4.11-sources.jar">
		<attributes>
			<attribute name="javadoc_location" value="jar:platform:/resource/MyProject/lib/junit-4.11-javadoc.jar!/"/>
		</attributes>
	</classpathentry>
	<classpathentry kind="output" path="bin"/>
</classpath>
Comment 4 Peter Larsen CLA 2017-09-15 10:23:06 EDT
We have the same problem.
We are using junit and have a shared project, that ppl named differently.
Comment 5 Holger Kanwischer CLA 2019-11-18 10:50:07 EST
I would be grateful if someone would finally take care of the problem (unfortunately, I can't).