Bug 23208 - The javadoc shown by Eclipse is different from what javadoc produces
Summary: The javadoc shown by Eclipse is different from what javadoc produces
Status: RESOLVED WONTFIX
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 2.0   Edit
Hardware: PC All
: P3 normal (vote)
Target Milestone: 2.1 M3   Edit
Assignee: Philipe Mulet CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2002-09-05 05:47 EDT by Claude Knaus CLA
Modified: 2002-10-29 05:55 EST (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Claude Knaus CLA 2002-09-05 05:47:19 EDT
20020903-I on w2k and linux-gtk:

Consider the following case where two javadocs are following each other.
javadoc (the tool) creates html pages with the javadoc immediately preceding
the method, while Eclipse shows the first javadoc (e.g. press F2 or hover).

IMethod.getSourceRange() returns the source range including both javadocs.
I'm not sure if this should be changed to include only the 'last' javadoc,
or handled by an entity above which would decide which javadoc to use.

---8<---

public class A {
	/**
	 * Used by eclipse.
	 */
	/**
	 * Used by javadoc.
	 */
    public void foo(int value) {}
}
Comment 1 Philipe Mulet CLA 2002-10-28 08:43:58 EST
We are providing all comments in between 2 members, so that the segmented view 
can perform properly.

We only care about the last comment for deprecation check (following the spec).

Using the DOM, you can get finer grain information.

Ok to close?
Comment 2 Claude Knaus CLA 2002-10-28 12:17:14 EST
ok
Comment 3 Philipe Mulet CLA 2002-10-29 05:55:15 EST
Closing