[PIVOT-976] Many, many Javadoc errors building with Java 8

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.0.4, 2.1
• Fix Version/s: 2.1
• Component/s: all
• Environment: OSX 10.10.4, Java 1.8.0_45
• Assignee: Roger Lee Whitcomb
• Reporter: Roger Lee Whitcomb
• Created: 21/Jul/15 16:41
• Updated: 24/May/16 21:31
• Resolved: 24/May/16 21:31

Description

Java 8 has tightened up the description of Javadoc so that stuff that Java 7 ignored is now being flagged as either errors or warnings. Currently there are 64 errors and 100 warnings if you do "ant clean doc" with Java 8.

Many of these are due to @param tags that have no description for the parameter. A lot more are due to "<br/>" that could/should just be "<br>".