Bug 24276

Summary:	javadoc - Imports marked as unused when they are really necessary.
Product:	[Eclipse Project] JDT	Reporter:	humphreys
Component:	Core	Assignee:	Philipe Mulet <philippe_mulet>
Status:	RESOLVED WONTFIX	QA Contact:
Severity:	normal
Priority:	P3
Version:	2.0.1
Target Milestone:	2.1 M3
Hardware:	PC
OS:	Windows 2000
Whiteboard:

Description humphreys

2002-10-01 13:13:15 EDT

Sometimes imports are necessary only for the purpose of creating javadoc links 
via the @link/@see tags, even though the imported class(es) are not referenced 
in the code itself. However, the eclipse compiler option will mark such imports 
are unneeded. They are not needed by the Java compiler but ARE needed by the 
javadoc compiler.

Comment 1 Philipe Mulet

2002-10-02 05:16:05 EDT

The Java compiler doesn't introspect Javadoc (except for looking for 
@deprecated tags). 

I would rather wonder why javadoc compiler relies on extra imports. Such extra 
imports should rather be located in a javadoc itself rather than polluting the 
real source code.

Comment 2 Philipe Mulet

2002-11-06 02:20:39 EST

Ok to close?

Comment 3 humphreys

2002-11-06 10:45:20 EST

A workaround is to fully qualify the class in the Javadoc comment. This way 
there is no need to import the class.

Comment 4 Philipe Mulet

2002-11-13 03:51:57 EST

Exactly, closing.

Comment 5 Philipe Mulet

2002-11-13 03:52:19 EST

Forgot to assign

Comment 6 Philipe Mulet

2002-11-13 03:52:46 EST

Closing

Comment 7 Philipe Mulet

2002-11-13 03:53:16 EST

Again

Comment 8 Philipe Mulet

2002-11-13 03:53:51 EST

Closing