Bug 237937 - [javadoc] Wrong "Javadoc: Malformed link reference" if href label contains //
Summary: [javadoc] Wrong "Javadoc: Malformed link reference" if href label contains //
Status: VERIFIED FIXED
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.4   Edit
Hardware: PC Windows XP
: P3 normal (vote)
Target Milestone: 3.5 M1   Edit
Assignee: Frederic Fusier CLA
QA Contact:
URL:
Whiteboard:
Keywords:
: 239783 (view as bug list)
Depends on:
Blocks:
 
Reported: 2008-06-20 10:36 EDT by Markus Keller CLA
Modified: 2022-07-28 15:02 EDT (History)
3 users (show)

See Also:

Attachments
Proposed patch (9.52 KB, patch)
2008-07-09 05:27 EDT, Frederic Fusier CLA 		no flags Details | Diff
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Markus Keller CLA 2008-06-20 10:36:08 EDT 
I20080617-2000

Follow-up to bug 77452 comment 3.

The two links in the Javadoc below are correct, but the Eclipse compiler says "Javadoc: Malformed link reference".

/**
 * @see <a href="http://www.eclipse.org/">http://www.eclipse.org</a>
 * @see <a href="http://www.eclipse.org/">//</a>
 */
public class Link {}

Maybe the // are wrongly being parsed as line comments inside the Javadoc?
Comment 1 Frederic Fusier CLA 2008-07-07 09:47:45 EDT 
*** Bug 239783 has been marked as a duplicate of this bug. ***
Comment 2 Frederic Fusier CLA 2008-07-09 05:27:40 EDT 
Created attachment 106929 [details]
Proposed patch

The JavadocParser needs to skip comments while scanning tokens in the href label...
Comment 3 Frederic Fusier CLA 2008-07-09 05:29:10 EDT 
Released for 3.5M1
Comment 4 Kent Johnson CLA 2008-08-06 13:06:08 EDT 
Verified for 3.5M1 using I20080805-1307
Comment 5 Lee Rhodes CLA 2022-07-28 14:58:44 EDT 
This bug is still not fixed as of Eclipse IDE for Java Version: 2022-06 (4.24.0).

Eclipse marks the Javadoc tag @see <a href=https://datasketches.apache.org/docs/Quantiles/SketchingQuantilesAndRanksTutorial.html>Sketching Quantiles and Ranks Tutorial</a>

as "Malformed link reference", which it is not as per Oracle Javadoc specification:

https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#CHDJGIJB
Comment 6 Lee Rhodes CLA 2022-07-28 15:02:34 EDT 
Please ignore comment 5.  My error.