Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 333691

Summary:	Add support for multiple javadocs per Jar
Product:	[Eclipse Project] JDT	Reporter:	Glenview Jeff <junk>
Component:	Core	Assignee:	Jay Arthanareeswaran <jarthana>
Status:	NEW ---	QA Contact:
Severity:	enhancement
Priority:	P3	CC:	amj87.iitr, markus.kell.r, Olivier_Thomann, stanio
Version:	3.7
Target Milestone:	---
Hardware:	PC
OS:	Windows 7
Whiteboard:

Description Glenview Jeff

2011-01-06 15:15:02 EST

Build Identifier: M20100909-0800

Others and I have a need for adding more than one javadoc per jar file in Eclipse.  From Stackoverflow.com:

While this may sound strange, I want to be able to attach more than one JavaDoc location to the same JAR in an Eclipse project. This particular JAR has classes from two sets of JavaDoc. The reason for this is that it is an OSGi bundle, which consists of a third-party JAR, and some other third-party code on top of that JAR to make it work in OSGi.

If I have the source code to both packages, and have that source code in an Eclipse project, it works fine. But I'd like to be able to get this to work in the case that I just have the JARs and JavaDoc.

Reproducible: Always

Comment 1 Ayushman Jain

2011-01-07 01:06:20 EST

Olivier, what's your take on this?

Comment 2 Olivier Thomann

2011-01-07 08:31:00 EST

Jay, please investigate what would need to be done.

Comment 3 Jay Arthanareeswaran

2011-01-10 10:14:22 EST

While I am doing investigation on possible API breakage and changes, I am copying Markus also since it would involve UI changes as well.

Comment 4 Markus Keller

2011-01-11 10:22:37 EST

See also bug 173641 (asks for multiple source attachments).

Comment 5 Stanimir Stamenkov

2011-04-23 06:50:11 EDT

It would be nice if javadoc locations could be specified globally per package / package hierarchy (and possibly overridden for project).  This way one would not need to attach javadoc location to every jar which possibly implement and include certain APIs.  This would be especially useful for Java EE APIs.