# HG changeset patch # User darcy # Date 1546981444 28800 # Node ID 28ec06beb091a029b0feedb70cfef99cd4f5294d # Parent 3cdf4d5148a8990f5c251ac3f26fddefe8bad9c0 8216335: Minor cleanups to javax.annotation.processing and javax.lang.model javadoc Reviewed-by: vromero diff -r 3cdf4d5148a8 -r 28ec06beb091 src/java.compiler/share/classes/javax/annotation/processing/AbstractProcessor.java --- a/src/java.compiler/share/classes/javax/annotation/processing/AbstractProcessor.java Tue Jan 08 14:15:14 2019 +0100 +++ b/src/java.compiler/share/classes/javax/annotation/processing/AbstractProcessor.java Tue Jan 08 13:04:04 2019 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -92,10 +92,10 @@ * same set of strings as the annotation. If the class is not so * annotated, an empty set is returned. * - * If the {@link ProcessingEnvironment#getSourceVersion source + * If the {@linkplain ProcessingEnvironment#getSourceVersion source * version} does not support modules, in other words if it is less * than or equal to {@link SourceVersion#RELEASE_8 RELEASE_8}, - * then any leading {@link Processor#getSupportedAnnotationTypes + * then any leading {@linkplain Processor#getSupportedAnnotationTypes * module prefixes} are stripped from the names. * * @return the names of the annotation types supported by this diff -r 3cdf4d5148a8 -r 28ec06beb091 src/java.compiler/share/classes/javax/annotation/processing/Filer.java --- a/src/java.compiler/share/classes/javax/annotation/processing/Filer.java Tue Jan 08 14:15:14 2019 +0100 +++ b/src/java.compiler/share/classes/javax/annotation/processing/Filer.java Tue Jan 08 13:04:04 2019 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -60,7 +60,7 @@ * by {@code '/'}; {@code '.'} and {@code '..'} are invalid path * segments. A valid relative name must match the * "path-rootless" rule of RFC 3986, section + * href="http://www.ietf.org/html/rfc3986.txt">RFC 3986, section * 3.3. * *

The file creation methods take a variable number of arguments to diff -r 3cdf4d5148a8 -r 28ec06beb091 src/java.compiler/share/classes/javax/annotation/processing/Processor.java --- a/src/java.compiler/share/classes/javax/annotation/processing/Processor.java Tue Jan 08 14:15:14 2019 +0100 +++ b/src/java.compiler/share/classes/javax/annotation/processing/Processor.java Tue Jan 08 13:04:04 2019 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -59,7 +59,7 @@ * constructor of the processor class. * *

  • Next, the tool calls the {@link #init init} method with - * an appropriate {@code ProcessingEnvironment}. + * an appropriate {@link ProcessingEnvironment}. * *
  • Afterwards, the tool calls {@link #getSupportedAnnotationTypes * getSupportedAnnotationTypes}, {@link #getSupportedOptions diff -r 3cdf4d5148a8 -r 28ec06beb091 src/java.compiler/share/classes/javax/lang/model/element/ModuleElement.java --- a/src/java.compiler/share/classes/javax/lang/model/element/ModuleElement.java Tue Jan 08 14:15:14 2019 +0100 +++ b/src/java.compiler/share/classes/javax/lang/model/element/ModuleElement.java Tue Jan 08 13:04:04 2019 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -317,7 +317,7 @@ /** * Returns the specific modules to which the package is being exported, - * or null, if the package is exported to all modules which + * or {@code null}, if the package is exported to all modules which * have readability to this module. * @return the specific modules to which the package is being exported */ @@ -339,7 +339,7 @@ /** * Returns the specific modules to which the package is being open - * or null, if the package is open all modules which + * or {@code null}, if the package is open all modules which * have readability to this module. * @return the specific modules to which the package is being opened */ diff -r 3cdf4d5148a8 -r 28ec06beb091 src/java.compiler/share/classes/javax/lang/model/util/Elements.java --- a/src/java.compiler/share/classes/javax/lang/model/util/Elements.java Tue Jan 08 14:15:14 2019 +0100 +++ b/src/java.compiler/share/classes/javax/lang/model/util/Elements.java Tue Jan 08 13:04:04 2019 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -511,6 +511,7 @@ * @param hidden the second element * @return {@code true} if and only if the first element hides * the second + * @jls 8.4.8 Inheritance, Overriding, and Hiding */ boolean hides(Element hider, Element hidden);