|
 |
88a3402 |
Disable doclint by default
|
|
|
88a3402 |
|
|
|
88a3402 |
OpenJDK 8 adds and enables doclint by default. This catches issues in
|
|
|
88a3402 |
javadoc comments. It is too strict, breaks javadoc compilation and, in
|
|
|
88a3402 |
general, breaks the build for old code known to build with previous
|
|
|
88a3402 |
versions of OpenJDK.
|
|
|
88a3402 |
|
|
|
88a3402 |
See: http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html
|
|
|
88a3402 |
See: https://lists.fedoraproject.org/pipermail/java-devel/2014-February/005150.html
|
|
|
88a3402 |
|
|
|
8f540da |
Author: Andrew John Hughes <ahughes@redhat.com>
|
|
|
8f540da |
Author: Emmanuel Bourg <ebourg@apache.org>
|
|
|
8f540da |
--- jdk8/langtools/src/share/classes/com/sun/tools/javadoc/DocEnv.java
|
|
|
8f540da |
+++ jdk8/langtools/src/share/classes/com/sun/tools/javadoc/DocEnv.java
|
|
|
88a3402 |
@@ -811,10 +811,9 @@
|
|
|
88a3402 |
doclintOpts.add(opt == null ? DocLint.XMSGS_OPTION : DocLint.XMSGS_CUSTOM_PREFIX + opt);
|
|
|
88a3402 |
}
|
|
|
88a3402 |
|
|
|
88a3402 |
- if (doclintOpts.isEmpty()) {
|
|
|
88a3402 |
- doclintOpts.add(DocLint.XMSGS_OPTION);
|
|
|
88a3402 |
- } else if (doclintOpts.size() == 1
|
|
|
88a3402 |
- && doclintOpts.get(0).equals(DocLint.XMSGS_CUSTOM_PREFIX + "none")) {
|
|
|
88a3402 |
+ if (doclintOpts.isEmpty() ||
|
|
|
88a3402 |
+ (doclintOpts.size() == 1
|
|
|
88a3402 |
+ && doclintOpts.get(0).equals(DocLint.XMSGS_CUSTOM_PREFIX + "none"))) {
|
|
|
88a3402 |
return;
|
|
|
88a3402 |
}
|
|
|
88a3402 |
|
|
|
8f540da |
--- jdk8/langtools/test/tools/javadoc/doclint/DocLintTest.java
|
|
|
8f540da |
+++ jdk8/langtools/test/tools/javadoc/doclint/DocLintTest.java
|
|
|
8f540da |
@@ -130,12 +130,12 @@
|
|
|
8f540da |
};
|
|
|
8f540da |
|
|
|
8f540da |
test(Collections.<String>emptyList(),
|
|
|
8f540da |
- Main.Result.ERROR,
|
|
|
8f540da |
- EnumSet.of(Message.DL_ERR9A, Message.DL_WRN12A));
|
|
|
8f540da |
+ Main.Result.OK,
|
|
|
8f540da |
+ EnumSet.of(Message.JD_WRN10, Message.JD_WRN13));
|
|
|
8f540da |
|
|
|
8f540da |
test(Arrays.asList(rawDiags),
|
|
|
8f540da |
- Main.Result.ERROR,
|
|
|
8f540da |
- EnumSet.of(Message.DL_ERR9, Message.DL_WRN12));
|
|
|
8f540da |
+ Main.Result.OK,
|
|
|
8f540da |
+ EnumSet.of(Message.JD_WRN10, Message.JD_WRN13));
|
|
|
8f540da |
|
|
|
8f540da |
test(Arrays.asList("-Xdoclint:none"),
|
|
|
8f540da |
Main.Result.OK,
|
|
|
8f540da |
@@ -158,8 +158,8 @@
|
|
|
8f540da |
EnumSet.of(Message.DL_WRN12));
|
|
|
8f540da |
|
|
|
8f540da |
test(Arrays.asList(rawDiags, "-private"),
|
|
|
8f540da |
- Main.Result.ERROR,
|
|
|
8f540da |
- EnumSet.of(Message.DL_ERR6, Message.DL_ERR9, Message.DL_WRN12));
|
|
|
8f540da |
+ Main.Result.OK,
|
|
|
8f540da |
+ EnumSet.of(Message.JD_WRN10, Message.JD_WRN13));
|
|
|
8f540da |
|
|
|
8f540da |
test(Arrays.asList(rawDiags, "-Xdoclint:syntax", "-private"),
|
|
|
8f540da |
Main.Result.ERROR,
|