8280534: Enable compile-time doclint reference checking

Reviewed-by: serb, naoto, mchung, lancea, iris
This commit is contained in:
Joe Darcy 2022-01-31 23:22:38 +00:00
parent 4191b2b9b9
commit 4dbebb62aa
21 changed files with 28 additions and 7 deletions

View file

@ -39,6 +39,7 @@ package java.io;
* @see java.io.File#list(java.io.FilenameFilter)
* @since 1.0
*/
@SuppressWarnings("doclint:reference") // cross-module links
@FunctionalInterface
public interface FilenameFilter {
/**

View file

@ -10305,6 +10305,7 @@ class Character implements java.io.Serializable, Comparable<Character>, Constabl
* @see java.compiler/javax.lang.model.SourceVersion#isIdentifier(CharSequence)
* @since 1.1
*/
@SuppressWarnings("doclint:reference") // cross-module links
public static boolean isJavaIdentifierStart(char ch) {
return isJavaIdentifierStart((int)ch);
}
@ -10334,6 +10335,7 @@ class Character implements java.io.Serializable, Comparable<Character>, Constabl
* @see java.compiler/javax.lang.model.SourceVersion#isIdentifier(CharSequence)
* @since 1.5
*/
@SuppressWarnings("doclint:reference") // cross-module links
public static boolean isJavaIdentifierStart(int codePoint) {
return CharacterData.of(codePoint).isJavaIdentifierStart(codePoint);
}
@ -10371,6 +10373,7 @@ class Character implements java.io.Serializable, Comparable<Character>, Constabl
* @see java.compiler/javax.lang.model.SourceVersion#isIdentifier(CharSequence)
* @since 1.1
*/
@SuppressWarnings("doclint:reference") // cross-module links
public static boolean isJavaIdentifierPart(char ch) {
return isJavaIdentifierPart((int)ch);
}
@ -10404,6 +10407,7 @@ class Character implements java.io.Serializable, Comparable<Character>, Constabl
* @see java.compiler/javax.lang.model.SourceVersion#isIdentifier(CharSequence)
* @since 1.5
*/
@SuppressWarnings("doclint:reference") // cross-module links
public static boolean isJavaIdentifierPart(int codePoint) {
return CharacterData.of(codePoint).isJavaIdentifierPart(codePoint);
}

View file

@ -1240,6 +1240,7 @@ public final class System {
* @see java.lang.System.LoggerFinder
* @see java.lang.System.Logger
*/
@SuppressWarnings("doclint:reference") // cross-module links
public enum Level {
// for convenience, we're reusing java.util.logging.Level int values
@ -1600,6 +1601,7 @@ public final class System {
*
* @since 9
*/
@SuppressWarnings("doclint:reference") // cross-module links
public abstract static class LoggerFinder {
/**
* The {@code RuntimePermission("loggerFinder")} is

View file

@ -154,7 +154,8 @@ public class MethodHandleProxies {
// entry points, must be covered by hand-written or automatically
// generated adapter classes.
//
@SuppressWarnings("removal")
@SuppressWarnings({"removal",
"doclint:reference"}) // cross-module links
@CallerSensitive
public static <T> T asInterfaceInstance(final Class<T> intfc, final MethodHandle target) {
if (!intfc.isInterface() || !Modifier.isPublic(intfc.getModifiers()))

View file

@ -2105,6 +2105,7 @@ public class MethodHandles {
* @jvms 5.5 Initialization
* @jls 12.7 Unloading of Classes and Interfaces
*/
@SuppressWarnings("doclint:reference") // cross-module links
public Lookup defineHiddenClass(byte[] bytes, boolean initialize, ClassOption... options)
throws IllegalAccessException
{

View file

@ -157,4 +157,5 @@
*
* @since 1.0
*/
@SuppressWarnings("doclint:reference") // cross-module links
package java.net;

View file

@ -75,7 +75,7 @@ import java.util.Set;
* @see Annotation
* @since 1.2
*/
@SuppressWarnings("doclint:reference") // cross-module links
public interface AttributedCharacterIterator extends CharacterIterator {
/**

View file

@ -125,6 +125,7 @@ public final class Bidi {
* @see java.desktop/java.awt.font.TextAttribute#NUMERIC_SHAPING
* @see java.desktop/java.awt.font.TextAttribute#RUN_DIRECTION
*/
@SuppressWarnings("doclint:reference") // cross-module links
public Bidi(AttributedCharacterIterator paragraph) {
if (paragraph == null) {
throw new IllegalArgumentException("paragraph is null");

View file

@ -73,6 +73,7 @@ package java.util;
* {@link java.util.concurrent.Flow} API.
*/
@Deprecated(since="9")
@SuppressWarnings("doclint:reference") // cross-module links
public class Observable {
private boolean changed = false;
private Vector<Observer> obs;

View file

@ -1647,6 +1647,7 @@ public final class ServiceLoader<S>
* @revised 9
*/
@CallerSensitive
@SuppressWarnings("doclint:reference") // cross-module links
public static <S> ServiceLoader<S> load(Class<S> service,
ClassLoader loader)
{