This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 255839 - User.properties generates @author annotations with invalid syntax
Summary: User.properties generates @author annotations with invalid syntax
Status: NEW
Alias: None
Product: platform
Classification: Unclassified
Component: Templates (show other bugs)
Version: 8.2
Hardware: PC Linux
: P3 normal with 2 votes (vote)
Assignee: Martin Entlicher
URL:
Keywords: PATCH_AVAILABLE
Depends on:
Blocks:
 
Reported: 2015-10-09 22:07 UTC by alexhenrie
Modified: 2015-10-13 15:26 UTC (History)
1 user (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
[PATCH] Fix syntax errors in user properties template (1.31 KB, patch)
2015-10-09 22:07 UTC, alexhenrie
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description alexhenrie 2015-10-09 22:07:56 UTC
Created attachment 156647 [details]
[PATCH] Fix syntax errors in user properties template

JDK 8 and later have strict syntax requirements for Javadoc. Specifically, Javadoc comments must now be written in a particular dialect of HTML, and literal angle brackets must be escaped.

The attached patch follows the newer custom of putting the email address in parentheses instead of angle brackets, which causes NetBeans to generate @author annotations that any JDK can parse without errors.

See:
https://stackoverflow.com/questions/22528767/jdk8-and-javadoc-has-become-very-strict
https://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete
http://mail.openjdk.java.net/pipermail/build-infra-dev/2013-January/002899.html