[UIMA-3500] update jcasgen templates to generate Javdoc comments that pass Java8 default lint checking

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.4.2SDK
• Fix Version/s: 2.5.0SDK
• Component/s: Core Java Framework
• Assignee: Marshall Schor
• Reporter: Marshall Schor
• Created: 11/Dec/13 22:52
• Updated: 08/Jan/14 14:41
• Resolved: 08/Jan/14 14:41

Description

Javadocs for Java 8 have (by default) "lint" checking enabled. The Javadocs generated by JCasGen, many of which have elements needed by JCasGen itself (the @generated annotations, for example), are missing the @param and @return elements for many of the functions; these are flagged by the lint checker. Fix these to be valid Javadoc comments by adding these elements back in.