[HTRACE-232] Make htrace4-core work with the new Javadoc lint standards in jdk8

• Type: Task
• Status: Resolved
• Priority: Trivial
• Resolution: Fixed
• Affects Version/s: 3.1.0
• Fix Version/s: 4.2
• Component/s: build, docs
• Labels: newbie

Environment

java 8, maven 3

• Target Version/s: 4.2
• Assignee: Colin McCabe
• Reporter: Arun Khetarpal
• Created: 31/Aug/15 18:37
• Updated: 13/Apr/16 21:32
• Resolved: 13/Apr/16 18:53

Description

Doclint gives the following errors while compiling with Java 8

[ERROR] /Users/arun.khetarpal/Opensource/apache/htrace/incubator-htrace/htrace-core/src/main/java/org/apache/htrace/core/Span.java:62: warning: no @return
[ERROR] boolean isRunning();

The errors could be divided into two groups
a) No @return
b) no self-closed HTML tags, such as <br /> or <a id="x" />

Issue Links

• breaks: HTRACE-354 Enable javadoc lint in htrace-flume and htrace-htraced and avoid build breaks in jdk7 because of unknown doclint flag
• relates to: HTRACE-262 Temporarily suppress doclint for Java 8 to prevent build failure