Bug 136050 - [javadoc] Unknown tag should be reported by compiler
Summary: [javadoc] Unknown tag should be reported by compiler
Status: NEW
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.2   Edit
Hardware: PC Windows XP
: P5 enhancement (vote)
Target Milestone: ---   Edit
Assignee: JDT-Core-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on: 39699
Blocks:
  Show dependency tree
 
Reported: 2006-04-11 02:48 EDT by Frederic Fusier CLA
Modified: 2016-01-14 12:46 EST (History)
1 user (show)

See Also:

Attachments
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 Frederic Fusier CLA 2006-04-11 02:48:03 EDT 
In nightly build N20060410-0010 compilation results, there's a javadoc warning that our compiler does not currently report:
/builds/N200604100010/src/plugins/org.eclipse.platform.doc.isv/../org.eclipse.debug.ui/ui/org/eclipse/debug/ui/AbstractLaunchConfigurationTab.java:39: warning - @TODO is an unknown tag.

Perhaps should introduce a new javadoc compiler options to report unknown tag (ie. tags not currently in javadoc specification: http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#javadoctags).

See bug 39699 enhancement to specify new tags...
Comment 1 Frederic Fusier CLA 2006-04-11 02:49:08 EDT 
Defer post 3.2
Comment 2 Frederic Fusier CLA 2006-11-15 11:32:50 EST 
Another test case interesting to warn on should be:
/**
 * @since3.2
 */
public class Test {}

These are unknown tags for javadoc tool, however, javadoc parser can easily see that it starts with a known tag name...
Comment 3 Frederic Fusier CLA 2007-06-13 09:29:48 EDT 
To be discussed for 3.4...