diff --git a/make/ide/idea/jdk/template/src/idea/JdkIdeaAntLogger.java b/make/ide/idea/jdk/template/src/idea/JdkIdeaAntLogger.java index d58fa40cc8b..9634fb9d388 100644 --- a/make/ide/idea/jdk/template/src/idea/JdkIdeaAntLogger.java +++ b/make/ide/idea/jdk/template/src/idea/JdkIdeaAntLogger.java @@ -54,7 +54,7 @@ public final class JdkIdeaAntLogger extends DefaultLogger { /** * This is just a way to pass in customized binary string predicates; * - * TODO: replace with @code{BiPredicate} and method reference when moving to 8 + * TODO: replace with {@code BiPredicate} and method reference when moving to 8 */ enum StringBinaryPredicate { CONTAINS() { diff --git a/make/ide/idea/langtools/template/src/idea/LangtoolsIdeaAntLogger.java b/make/ide/idea/langtools/template/src/idea/LangtoolsIdeaAntLogger.java index 11ebfbf3e39..8eb5313fb84 100644 --- a/make/ide/idea/langtools/template/src/idea/LangtoolsIdeaAntLogger.java +++ b/make/ide/idea/langtools/template/src/idea/LangtoolsIdeaAntLogger.java @@ -54,7 +54,7 @@ public final class LangtoolsIdeaAntLogger extends DefaultLogger { /** * This is just a way to pass in customized binary string predicates; * - * TODO: replace with @code{BiPredicate} and method reference when moving to 8 + * TODO: replace with {@code BiPredicate} and method reference when moving to 8 */ enum StringBinaryPredicate { CONTAINS() { diff --git a/src/java.base/share/classes/java/lang/invoke/BootstrapMethodInvoker.java b/src/java.base/share/classes/java/lang/invoke/BootstrapMethodInvoker.java index dc87cfdb761..c9734a07fa0 100644 --- a/src/java.base/share/classes/java/lang/invoke/BootstrapMethodInvoker.java +++ b/src/java.base/share/classes/java/lang/invoke/BootstrapMethodInvoker.java @@ -255,7 +255,7 @@ final class BootstrapMethodInvoker { /** * @return true iff the BSM method type exactly matches - * {@see java.lang.invoke.StringConcatFactory#makeConcatWithConstants(MethodHandles.Lookup, + * {@link java.lang.invoke.StringConcatFactory#makeConcatWithConstants(MethodHandles.Lookup, * String,MethodType,String,Object...))} */ private static boolean isStringConcatFactoryBSM(MethodType bsmType) { @@ -264,7 +264,7 @@ final class BootstrapMethodInvoker { /** * @return true iff the BSM method type exactly matches - * {@see java.lang.invoke.LambdaMetafactory#metafactory( + * {@link java.lang.invoke.LambdaMetafactory#metafactory( * MethodHandles.Lookup,String,Class,MethodType,MethodHandle,MethodType)} */ private static boolean isLambdaMetafactoryCondyBSM(MethodType bsmType) { @@ -273,7 +273,7 @@ final class BootstrapMethodInvoker { /** * @return true iff the BSM method type exactly matches - * {@see java.lang.invoke.LambdaMetafactory#metafactory( + * {@link java.lang.invoke.LambdaMetafactory#metafactory( * MethodHandles.Lookup,String,MethodType,MethodType,MethodHandle,MethodType)} */ private static boolean isLambdaMetafactoryIndyBSM(MethodType bsmType) { @@ -282,7 +282,7 @@ final class BootstrapMethodInvoker { /** * @return true iff the BSM method type exactly matches - * {@see java.lang.invoke.LambdaMetafactory#altMetafactory( + * {@link java.lang.invoke.LambdaMetafactory#altMetafactory( * MethodHandles.Lookup,String,MethodType,Object[])} */ private static boolean isLambdaMetafactoryAltMetafactoryBSM(MethodType bsmType) { diff --git a/src/java.base/share/classes/java/security/AccessControlContext.java b/src/java.base/share/classes/java/security/AccessControlContext.java index 41041f5b538..eb893c0d021 100644 --- a/src/java.base/share/classes/java/security/AccessControlContext.java +++ b/src/java.base/share/classes/java/security/AccessControlContext.java @@ -186,7 +186,7 @@ public final class AccessControlContext { } /** - * package private to allow calls from (@code ProtectionDomain} without + * package private to allow calls from {@code ProtectionDomain} without * performing the security check for * {@linkplain SecurityConstants#CREATE_ACC_PERMISSION} permission */ diff --git a/src/java.base/share/classes/java/security/BasicPermission.java b/src/java.base/share/classes/java/security/BasicPermission.java index de56016a826..817a343f7f2 100644 --- a/src/java.base/share/classes/java/security/BasicPermission.java +++ b/src/java.base/share/classes/java/security/BasicPermission.java @@ -260,7 +260,7 @@ public abstract class BasicPermission extends Permission /** * {@code readObject} is called to restore the state of the - * (@code BasicPermission} from a stream. + * {@code BasicPermission} from a stream. * * @param s the {@code ObjectInputStream} from which data is read * @throws IOException if an I/O error occurs @@ -323,8 +323,8 @@ final class BasicPermissionCollection private transient ConcurrentHashMap perms; /** - * This is set to {@code true} if this (@code BasicPermissionCollection} - * contains a {code BasicPermission} with '*' as its permission name. + * This is set to {@code true} if this {@code BasicPermissionCollection} + * contains a {@code BasicPermission} with '*' as its permission name. * * @see #serialPersistentFields */ diff --git a/src/java.base/share/classes/jdk/internal/foreign/abi/CallingSequence.java b/src/java.base/share/classes/jdk/internal/foreign/abi/CallingSequence.java index 458b174a4cb..cd56fbe548f 100644 --- a/src/java.base/share/classes/jdk/internal/foreign/abi/CallingSequence.java +++ b/src/java.base/share/classes/jdk/internal/foreign/abi/CallingSequence.java @@ -162,7 +162,7 @@ public class CallingSequence { /** * The size of the return buffer, if one is needed. * - * {@see #needsReturnBuffer} + * @see #needsReturnBuffer * * @return the return buffer size */ diff --git a/src/java.base/share/classes/jdk/internal/vm/VMSupport.java b/src/java.base/share/classes/jdk/internal/vm/VMSupport.java index 44f9ebdc8cb..86472e83830 100644 --- a/src/java.base/share/classes/jdk/internal/vm/VMSupport.java +++ b/src/java.base/share/classes/jdk/internal/vm/VMSupport.java @@ -66,7 +66,7 @@ public class VMSupport { } /** - * @returns a Properties object containing only the entries in {@code p} + * @return a Properties object containing only the entries in {@code p} * whose key and value are both Strings */ private static Properties onlyStrings(Properties p) { diff --git a/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java b/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java index 708eb11fc32..a0a0b6f5785 100644 --- a/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java +++ b/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java @@ -169,7 +169,7 @@ public class LocaleNameProviderImpl extends LocaleNameProvider implements Availa } /** - * @inheritDoc + * {@inheritDoc} */ @Override public String getDisplayUnicodeExtensionKey(String key, Locale locale) { @@ -180,7 +180,7 @@ public class LocaleNameProviderImpl extends LocaleNameProvider implements Availa } /** - * @inheritDoc + * {@inheritDoc} */ @Override public String getDisplayUnicodeExtensionType(String extType, String key, Locale locale) { diff --git a/src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboBoxUI.java b/src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboBoxUI.java index 9389806d499..70560f093c7 100644 --- a/src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboBoxUI.java +++ b/src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboBoxUI.java @@ -645,7 +645,7 @@ public class SynthComboBoxUI extends BasicComboBoxUI implements //------------------------------------------------------------------ /** - * @inheritDoc + * {@inheritDoc} * * Ensures that isPressed() will return true if the combo is pressed, * or the arrowButton is pressed, or if the combo popup is @@ -659,7 +659,7 @@ public class SynthComboBoxUI extends BasicComboBoxUI implements } /** - * @inheritDoc + * {@inheritDoc} * * Ensures that the armed state is in sync with the pressed state * if shouldActLikeButton is true. Without this method, the arrow @@ -674,7 +674,7 @@ public class SynthComboBoxUI extends BasicComboBoxUI implements } /** - * @inheritDoc + * {@inheritDoc} * * Ensures that isRollover() will return true if the combo is * rolled over, or the arrowButton is rolled over. @@ -685,7 +685,7 @@ public class SynthComboBoxUI extends BasicComboBoxUI implements } /** - * @inheritDoc + * {@inheritDoc} * * Forwards pressed states to the internal "pressed" field */ @@ -696,7 +696,7 @@ public class SynthComboBoxUI extends BasicComboBoxUI implements } /** - * @inheritDoc + * {@inheritDoc} * * Forwards rollover states to the internal "over" field */ @@ -738,7 +738,7 @@ public class SynthComboBoxUI extends BasicComboBoxUI implements //------------------------------------------------------------------ /** - * @inheritDoc + * {@inheritDoc} * * Ensures that the combo box is repainted when the popup is closed. * This avoids a bug where clicking off the combo wasn't causing a repaint, diff --git a/src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboPopup.java b/src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboPopup.java index 0864d115341..8903180ec24 100644 --- a/src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboPopup.java +++ b/src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboPopup.java @@ -67,7 +67,7 @@ class SynthComboPopup extends BasicComboPopup { } /** - * @inheritDoc + * {@inheritDoc} * * Overridden to take into account any popup insets specified in * SynthComboBoxUI diff --git a/src/java.desktop/share/classes/sun/font/GlyphLayout.java b/src/java.desktop/share/classes/sun/font/GlyphLayout.java index 3d7856ac492..fe2a8bf2599 100644 --- a/src/java.desktop/share/classes/sun/font/GlyphLayout.java +++ b/src/java.desktop/share/classes/sun/font/GlyphLayout.java @@ -346,7 +346,7 @@ public final class GlyphLayout { * @param text the text, including optional context before start and after start + count * @param offset the start of the text to lay out * @param count the length of the text to lay out - * @param flags bidi and context flags {@see #java.awt.Font} + * @param flags bidi and context flags {@link java.awt.Font} * @param result a StandardGlyphVector to modify, can be null * @return the laid out glyphvector, if result was passed in, it is returned */ diff --git a/src/java.desktop/share/classes/sun/java2d/StateTrackableDelegate.java b/src/java.desktop/share/classes/sun/java2d/StateTrackableDelegate.java index 25231aa8f4f..985f35e4fbb 100644 --- a/src/java.desktop/share/classes/sun/java2d/StateTrackableDelegate.java +++ b/src/java.desktop/share/classes/sun/java2d/StateTrackableDelegate.java @@ -93,7 +93,7 @@ public final class StateTrackableDelegate implements StateTrackable { } /** - * @inheritDoc + * {@inheritDoc} * @since 1.7 */ public State getState() { @@ -101,7 +101,7 @@ public final class StateTrackableDelegate implements StateTrackable { } /** - * @inheritDoc + * {@inheritDoc} * @since 1.7 */ public synchronized StateTracker getStateTracker() { diff --git a/src/java.desktop/share/classes/sun/swing/AccumulativeRunnable.java b/src/java.desktop/share/classes/sun/swing/AccumulativeRunnable.java index ed6b1539701..aea072f3ea8 100644 --- a/src/java.desktop/share/classes/sun/swing/AccumulativeRunnable.java +++ b/src/java.desktop/share/classes/sun/swing/AccumulativeRunnable.java @@ -116,7 +116,7 @@ public abstract class AccumulativeRunnable implements Runnable { * appends arguments and sends this {@code Runnable} for the * execution if needed. *

- * This implementation uses {@see #submit} to send this + * This implementation uses {@link #submit} to send this * {@code Runnable} for execution. * @param args the arguments to accumulate */ diff --git a/src/java.desktop/share/classes/sun/swing/SwingUtilities2.java b/src/java.desktop/share/classes/sun/swing/SwingUtilities2.java index 6aca541cd7d..706ba51b740 100644 --- a/src/java.desktop/share/classes/sun/swing/SwingUtilities2.java +++ b/src/java.desktop/share/classes/sun/swing/SwingUtilities2.java @@ -2278,11 +2278,11 @@ public class SwingUtilities2 { /** * Returns the client property for the given key if it is set; otherwise - * returns the {@L&F} property. + * returns the {@literal L&F} property. * * @param component the component * @param key an {@code String} specifying the key for the desired boolean value - * @return the boolean value of the client property if it is set or the {@L&F} + * @return the boolean value of the client property if it is set or the {@literal L&F} * property in other case. */ public static boolean getBoolean(JComponent component, String key) { diff --git a/src/java.desktop/unix/classes/sun/awt/X11/XToolkit.java b/src/java.desktop/unix/classes/sun/awt/X11/XToolkit.java index 822190334fc..7f10ca61684 100644 --- a/src/java.desktop/unix/classes/sun/awt/X11/XToolkit.java +++ b/src/java.desktop/unix/classes/sun/awt/X11/XToolkit.java @@ -2385,7 +2385,7 @@ public final class XToolkit extends UNIXToolkit implements Runnable { private static int oops_position = 0; /** - * @inheritDoc + * {@inheritDoc} */ @Override protected boolean syncNativeQueue(long timeout) { diff --git a/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Type.java b/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Type.java index c5c2d15b7c1..9e957444df2 100644 --- a/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Type.java +++ b/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Type.java @@ -594,7 +594,7 @@ public abstract class Type extends AnnoConstruct implements TypeMirror, PoolCons /** * A compound type is a special class type whose supertypes are used to store a list * of component types. There are two kinds of compound types: (i) intersection types - * {@see IntersectionClassType} and (ii) union types {@see UnionClassType}. + * {@link IntersectionClassType} and (ii) union types {@link UnionClassType}. */ public boolean isCompound() { return false; diff --git a/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Types.java b/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Types.java index 21e456458b0..36589d20872 100644 --- a/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Types.java +++ b/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Types.java @@ -2862,7 +2862,7 @@ public class Types { /** * Merge multiple abstract methods. The preferred method is a method that is a subsignature - * of all the other signatures and whose return type is more specific {@see MostSpecificReturnCheck}. + * of all the other signatures and whose return type is more specific {@link MostSpecificReturnCheck}. * The resulting preferred method has a thrown clause that is the intersection of the merged * methods' clauses. */ diff --git a/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Check.java b/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Check.java index 2e1689335e5..598ab23a99c 100644 --- a/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Check.java +++ b/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Check.java @@ -2445,7 +2445,7 @@ public class Check { * * @param pos Position to be used for error reporting. * @param t The type referred to. - * @returns True if the check completed on all attributed classes + * @return True if the check completed on all attributed classes */ private boolean checkNonCyclicInternal(DiagnosticPosition pos, Type t) { boolean complete = true; // was the check complete? diff --git a/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Infer.java b/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Infer.java index 1f1231b7f7a..f8725b95186 100644 --- a/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Infer.java +++ b/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Infer.java @@ -656,7 +656,7 @@ public class Infer { /** * Infer record type for pattern matching. Given an expression type - * (@code expressionType}), and a given record ({@code patternTypeSymbol}), + * ({@code expressionType}), and a given record ({@code patternTypeSymbol}), * a parameterized type of {@code patternTypeSymbol} is inferred * according to JLS 18.5.5. * diff --git a/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Resolve.java b/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Resolve.java index 9b4653a039a..35e64502d10 100644 --- a/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Resolve.java +++ b/src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Resolve.java @@ -3305,7 +3305,7 @@ public class Resolve { /** * This abstract class embodies the logic that converts one (bound lookup) or two (unbound lookup) - * {@code ReferenceLookupResult} objects into a (@code Symbol), which is then regarded as the + * {@code ReferenceLookupResult} objects into a {@code Symbol}, which is then regarded as the * result of method reference resolution. */ abstract class ReferenceChooser { diff --git a/src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/debugger/win32/coff/DebugDirectoryEntry.java b/src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/debugger/win32/coff/DebugDirectoryEntry.java index 1732e302b1c..d8cc722b055 100644 --- a/src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/debugger/win32/coff/DebugDirectoryEntry.java +++ b/src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/debugger/win32/coff/DebugDirectoryEntry.java @@ -46,7 +46,7 @@ public interface DebugDirectoryEntry { /** Format of debugging information: this field enables support of multiple debuggers. See - @link{sun.jvm.hotspot.debugger.win32.coff.DebugTypes}. */ + {@link sun.jvm.hotspot.debugger.win32.coff.DebugTypes}. */ public int getType(); /** Size of the debug data (not including the debug directory itself). */ @@ -60,7 +60,7 @@ public interface DebugDirectoryEntry { /** If this debug directory entry is of type IMAGE_DEBUG_TYPE_CODEVIEW (see - @link{sun.jvm.hotspot.debugger.win32.coff.DebugTypes}), returns + {@link sun.jvm.hotspot.debugger.win32.coff.DebugTypes}), returns the contents as a DebugVC50 object; otherwise, returns null. */ public DebugVC50 getDebugVC50(); diff --git a/src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/utilities/LivenessPath.java b/src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/utilities/LivenessPath.java index 3f7d1b481d4..24d56c51e11 100644 --- a/src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/utilities/LivenessPath.java +++ b/src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/utilities/LivenessPath.java @@ -30,9 +30,9 @@ import sun.jvm.hotspot.oops.*; /** Describes a path from an object back to the root which is keeping it alive. Elements of the path are (object, field) pairs, where - the object is expressed as a @link{sun.jvm.hotspot.oops.Oop}, and + the object is expressed as a {@link sun.jvm.hotspot.oops.Oop}, and where the field is expressed as a - @link{sun.jvm.hotspot.oops.FieldIdentifier}. If the element + {@link sun.jvm.hotspot.oops.FieldIdentifier}. If the element reflects a root, the Oop will be null. If the element is the end of the path, the FieldIdentifier will be null. */ diff --git a/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/Cleaner.java b/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/Cleaner.java index 1a88ec342f6..b6f4395f055 100644 --- a/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/Cleaner.java +++ b/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/Cleaner.java @@ -98,9 +98,9 @@ abstract class Cleaner extends WeakReference { /** * Performs the cleanup action now that this object's referent has become weakly reachable. * - * @returns true if the clean up action cleared the referent of an oop handle and requires a - * subsequent call to {@link CompilerToVM#releaseClearedOopHandles()} to reclaim the - * resources of the handle itself + * @return true if the clean up action cleared the referent of an oop handle and requires a + * subsequent call to {@link CompilerToVM#releaseClearedOopHandles()} to reclaim the + * resources of the handle itself */ abstract boolean doCleanup(); diff --git a/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/HotSpotCompiledCodeStream.java b/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/HotSpotCompiledCodeStream.java index dd260527595..f8b0585098b 100644 --- a/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/HotSpotCompiledCodeStream.java +++ b/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/HotSpotCompiledCodeStream.java @@ -629,7 +629,7 @@ final class HotSpotCompiledCodeStream implements AutoCloseable { * Determines if {@code name} or {@code method} are matched by * {@link Option#DumpSerializedCode}. * - * @returns the matched value or null if no match was made + * @return the matched value or null if no match was made */ private static String shouldDump(String name, HotSpotCompiledNmethod nmethod) { String filter = Option.DumpSerializedCode.getString(); diff --git a/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/JFR.java b/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/JFR.java index cf6894054b8..1339424236b 100644 --- a/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/JFR.java +++ b/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/JFR.java @@ -31,7 +31,7 @@ import jdk.vm.ci.meta.ResolvedJavaMethod; /** * Helper methods for interacting with the Java Flight Recorder (JFR) to register events and notify - * it when events occur. The JFR events are defined in {see @code + * it when events occur. The JFR events are defined in {@code * src/share/jfr/metadata/metadata.xml}. */ public final class JFR { @@ -50,7 +50,7 @@ public final class JFR { } /** - * Helper methods for managing JFR CompilerPhase events. The events are defined in {see @code + * Helper methods for managing JFR CompilerPhase events. The events are defined in {@code * src/share/jfr/metadata/metadata.xml}. */ public static final class CompilerPhaseEvent { @@ -75,7 +75,7 @@ public final class JFR { } /** - * Helper methods for managing JFR CompilerInlining events. The events are defined in {see @code + * Helper methods for managing JFR CompilerInlining events. The events are defined in {@code * src/share/jfr/metadata/metadata.xml}. */ public static final class CompilerInliningEvent { diff --git a/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/meta/MethodHandleAccessProvider.java b/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/meta/MethodHandleAccessProvider.java index 0faa2af5704..f053905b160 100644 --- a/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/meta/MethodHandleAccessProvider.java +++ b/src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/meta/MethodHandleAccessProvider.java @@ -66,8 +66,8 @@ public interface MethodHandleAccessProvider { * interpreter overhead. If the parameter forceBytecodeGeneration is set to true, the VM should * try to generate bytecodes before this method returns. * - * @returns {@code null} if {@code methodHandle} is not a {@link MethodHandle} or the invocation - * target is not available at this time + * @return {@code null} if {@code methodHandle} is not a {@link MethodHandle} or the invocation + * target is not available at this time * @throws NullPointerException if {@code methodHandle} is null */ ResolvedJavaMethod resolveInvokeBasicTarget(JavaConstant methodHandle, boolean forceBytecodeGeneration); @@ -77,7 +77,7 @@ public interface MethodHandleAccessProvider { * with the given constant member name. The member name is the last parameter of the * {@code linkTo*} method. * - * @returns {@code null} if the invocation target is not available at this time + * @return {@code null} if the invocation target is not available at this time * @throws NullPointerException if {@code memberName} is null * @throws IllegalArgumentException if {@code memberName} is not a * {@code java.lang.invoke.MemberName} diff --git a/src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/markup/Head.java b/src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/markup/Head.java index d014abd7b4c..9ba3f4ecdb8 100644 --- a/src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/markup/Head.java +++ b/src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/markup/Head.java @@ -94,7 +94,7 @@ public class Head extends Content { } /** - * Sets the charset to be declared in a META [@code Content-TYPE} element. + * Sets the charset to be declared in a META {@code Content-TYPE} element. * * @param charset the charset * @return this object @@ -123,7 +123,7 @@ public class Head extends Content { } /** - * Adds a list of keywords to appear in META [@code keywords} elements. + * Adds a list of keywords to appear in META {@code keywords} elements. * * @param keywords the list of keywords, or null if none need to be added * @return this object diff --git a/src/utils/LogCompilation/src/main/java/com/sun/hotspot/tools/compiler/LogParser.java b/src/utils/LogCompilation/src/main/java/com/sun/hotspot/tools/compiler/LogParser.java index 05407f8c969..09a852d05c7 100644 --- a/src/utils/LogCompilation/src/main/java/com/sun/hotspot/tools/compiler/LogParser.java +++ b/src/utils/LogCompilation/src/main/java/com/sun/hotspot/tools/compiler/LogParser.java @@ -513,12 +513,12 @@ public class LogParser extends DefaultHandler implements ErrorHandler { private HashMap methods = new HashMap<>(); /** - * Map compilation IDs ({@see #makeId()}) to newly created nmethods. + * Map compilation IDs ({@link #makeId()}) to newly created nmethods. */ private LinkedHashMap nmethods = new LinkedHashMap<>(); /** - * Map compilation task IDs {@see #makeId()}) to {@link Compilation} + * Map compilation task IDs {@link #makeId()}) to {@link Compilation} * objects. */ private HashMap compiles = new HashMap<>(); @@ -544,9 +544,9 @@ public class LogParser extends DefaultHandler implements ErrorHandler { * originating from that scope. * * New scopes are typically pushed when parse log events are encountered - * ({@see #startElement()}) and popped when parsing of a given Java method - * is done ({@see #endElement()}). Parsing events can be nested. Several - * other events add information to scopes ({@see #startElement()}). + * ({@link #startElement()}) and popped when parsing of a given Java method + * is done ({@link #endElement()}). Parsing events can be nested. Several + * other events add information to scopes ({@code startElement()}). */ private Deque scopes = new ArrayDeque<>(); diff --git a/test/hotspot/jtreg/compiler/lib/ir_framework/TestFramework.java b/test/hotspot/jtreg/compiler/lib/ir_framework/TestFramework.java index 84ce6c81859..81dd825930d 100644 --- a/test/hotspot/jtreg/compiler/lib/ir_framework/TestFramework.java +++ b/test/hotspot/jtreg/compiler/lib/ir_framework/TestFramework.java @@ -190,7 +190,7 @@ public class TestFramework { /** * Creates an instance acting as a builder to test {@code testClass}. * Use this constructor if you want to use multiple run options (flags, helper classes, scenarios). - * Use the associated add methods ({@link #addFlags(String...)}, @link #addScenarios(Scenario...)}, + * Use the associated add methods ({@link #addFlags(String...)}, {@link #addScenarios(Scenario...)}, * {@link #addHelperClasses(Class...)}) to set up everything and then start the testing by invoking {@link #start()}. * * @param testClass the class to be tested by the framework. diff --git a/test/hotspot/jtreg/gc/g1/plab/lib/PlabGCStatistics.java b/test/hotspot/jtreg/gc/g1/plab/lib/PlabGCStatistics.java index f409409a986..77bbf1384af 100644 --- a/test/hotspot/jtreg/gc/g1/plab/lib/PlabGCStatistics.java +++ b/test/hotspot/jtreg/gc/g1/plab/lib/PlabGCStatistics.java @@ -42,7 +42,7 @@ public class PlabGCStatistics { /** * Checks if the statistics contains the requested type. * @param reportType - * @returns true, if contains, false otherwise + * @return true, if contains, false otherwise */ public boolean containsKey(ReportType reportType) { return plabGCStatistics.containsKey(reportType); diff --git a/test/hotspot/jtreg/vmTestbase/nsk/share/runner/MultiRunner.java b/test/hotspot/jtreg/vmTestbase/nsk/share/runner/MultiRunner.java index 9b793356006..71bfcbca8e4 100644 --- a/test/hotspot/jtreg/vmTestbase/nsk/share/runner/MultiRunner.java +++ b/test/hotspot/jtreg/vmTestbase/nsk/share/runner/MultiRunner.java @@ -67,7 +67,7 @@ public interface MultiRunner extends Runnable { /** * Get execution controller for current thread. * - * @returns execution controller for current thread + * @return execution controller for current thread */ public ExecutionController getExecutionController(); } diff --git a/test/jdk/java/rmi/testlibrary/TestLibrary.java b/test/jdk/java/rmi/testlibrary/TestLibrary.java index cb2d2644660..51cfa2c9282 100644 --- a/test/jdk/java/rmi/testlibrary/TestLibrary.java +++ b/test/jdk/java/rmi/testlibrary/TestLibrary.java @@ -401,7 +401,7 @@ public class TestLibrary { /** * Creates an RMI {@link Registry} on a random, un-reserved port. * - * @returns an RMI Registry, using a random port. + * @return an RMI Registry, using a random port. * @throws RemoteException if there was a problem creating a Registry. */ public static Registry createRegistryOnUnusedPort() throws RemoteException { @@ -411,7 +411,7 @@ public class TestLibrary { /** * Creates an RMI {@link Registry} on an ephemeral port. * - * @returns an RMI Registry + * @return an RMI Registry * @throws RemoteException if there was a problem creating a Registry. */ public static Registry createRegistryOnEphemeralPort() throws RemoteException { diff --git a/test/jdk/java/time/test/java/time/chrono/TestExampleCode.java b/test/jdk/java/time/test/java/time/chrono/TestExampleCode.java index 434e272da33..7ce850b0007 100644 --- a/test/jdk/java/time/test/java/time/chrono/TestExampleCode.java +++ b/test/jdk/java/time/test/java/time/chrono/TestExampleCode.java @@ -209,7 +209,7 @@ public class TestExampleCode { * same chronology. * @param a parameterized ChronoLocalDate * @param date a specific date extending ChronoLocalDate - * @return a [@code ChronoLocalDateTime} using the change chronology. + * @return a {@code ChronoLocalDateTime} using the change chronology. */ @SuppressWarnings("unchecked") private ChronoLocalDateTime tomorrowNoon(D date) { diff --git a/test/jdk/sun/security/ssl/SignatureScheme/SigSchemePropOrdering.java b/test/jdk/sun/security/ssl/SignatureScheme/SigSchemePropOrdering.java index dddbc7bc7de..8ee04b39c28 100644 --- a/test/jdk/sun/security/ssl/SignatureScheme/SigSchemePropOrdering.java +++ b/test/jdk/sun/security/ssl/SignatureScheme/SigSchemePropOrdering.java @@ -231,7 +231,7 @@ public class SigSchemePropOrdering extends SSLEngineTemplate { * * @param data the ByteBuffer containing the ClientHello bytes * - * @returns A List of the signature schemes in string form. If no + * @return A List of the signature schemes in string form. If no * signature_algorithms extension is present in the client hello then * an empty list will be returned. */ @@ -302,7 +302,7 @@ public class SigSchemePropOrdering extends SSLEngineTemplate { * * @param data the ByteBuffer containing the CertificateRequest bytes * - * @returns A List of the signature schemes in string form. If no + * @return A List of the signature schemes in string form. If no * signature_algorithms extension is present in the CertificateRequest * then an empty list will be returned. */ diff --git a/test/jdk/sun/security/tools/keytool/KeyToolTest.java b/test/jdk/sun/security/tools/keytool/KeyToolTest.java index 76dd15b19ee..b17f7b7d999 100644 --- a/test/jdk/sun/security/tools/keytool/KeyToolTest.java +++ b/test/jdk/sun/security/tools/keytool/KeyToolTest.java @@ -311,9 +311,9 @@ public class KeyToolTest { /** * Helper method, load a keystore * @param file file for keystore, null or "NONE" for PKCS11 - * @pass password for the keystore - * @type keystore type - * @returns the KeyStore object + * @param pass password for the keystore + * @param type keystore type + * @return the KeyStore object * @exception Exception if anything goes wrong */ KeyStore loadStore(String file, String pass, String type) throws Exception { diff --git a/test/langtools/jdk/javadoc/doclet/testRecordTypes/examples/SerializableProxy.java b/test/langtools/jdk/javadoc/doclet/testRecordTypes/examples/SerializableProxy.java index e1dc6904e52..5ecf01133d9 100644 --- a/test/langtools/jdk/javadoc/doclet/testRecordTypes/examples/SerializableProxy.java +++ b/test/langtools/jdk/javadoc/doclet/testRecordTypes/examples/SerializableProxy.java @@ -44,7 +44,7 @@ public class SerializableProxy implements Serializable { /** * Returns a deserialized object. * - * @returns the deserialized object + * @return the deserialized object */ public SerializableProxy readResolve() { return new SerializableProxy(x, y); diff --git a/test/lib/jdk/test/lib/ByteCodeLoader.java b/test/lib/jdk/test/lib/ByteCodeLoader.java index ee66e84b870..cbaad46eca1 100644 --- a/test/lib/jdk/test/lib/ByteCodeLoader.java +++ b/test/lib/jdk/test/lib/ByteCodeLoader.java @@ -110,7 +110,7 @@ public class ByteCodeLoader extends SecureClassLoader { * @param className The name of the class * @param byteCode The byte code for the class * @throws ClassNotFoundException if the class can't be loaded - * @return A {@see Class} object representing the class + * @return A {@code Class} object representing the class */ public static Class load(String className, byte[] byteCode) throws ClassNotFoundException { return new ByteCodeLoader(className, byteCode).loadClass(className); diff --git a/test/lib/jdk/test/lib/UIBuilder.java b/test/lib/jdk/test/lib/UIBuilder.java index c58f563ff52..39b34c3d828 100644 --- a/test/lib/jdk/test/lib/UIBuilder.java +++ b/test/lib/jdk/test/lib/UIBuilder.java @@ -81,7 +81,7 @@ public class UIBuilder { /** * Returns this {@code DialogBuilder} setting the dialog's title to a new value. * @param title a string value - * @returns this DialogBuilder + * @return this DialogBuilder */ public DialogBuilder setTitle(String title) { dialog.setTitle(title); @@ -92,7 +92,7 @@ public class UIBuilder { * Returns this {@code DialogBuilder} setting the instruction text to a new * value. * @param instruction a string value - * @returns this DialogBuilder + * @return this DialogBuilder */ public DialogBuilder setInstruction(String instruction) { instructionsText.setText("Test instructions:\n" + instruction); @@ -102,7 +102,7 @@ public class UIBuilder { /** * Returns this {@code DialogBuilder} setting the message text to a new value. * @param message a string value - * @returns this DialogBuilder + * @return this DialogBuilder */ public DialogBuilder setMessage(String message) { messageText.setText(message); @@ -113,7 +113,7 @@ public class UIBuilder { * Returns this {@code DialogBuilder} setting pass button action to * {@link java.awt.event.ActionListener}. * @param action an action to perform on button click - * @returns this DialogBuilder + * @return this DialogBuilder */ public DialogBuilder setPassAction(ActionListener action) { pass.addActionListener(action); @@ -124,7 +124,7 @@ public class UIBuilder { * Returns this {@code DialogBuilder} setting fail button action to * {@link java.awt.event.ActionListener}. * @param action an action to perform on button click - * @returns this DialogBuilder + * @return this DialogBuilder */ public DialogBuilder setFailAction(ActionListener action) { fail.addActionListener(action); @@ -135,7 +135,7 @@ public class UIBuilder { * Returns this {@code DialogBuilder} setting window-closing action to * {@link java.lang.Runnable}. * @param action a runnerable action to perform on window close - * @returns this DialogBuilder + * @return this DialogBuilder */ public DialogBuilder setCloseAction(Runnable action) { dialog.addWindowListener(new WindowAdapter() { @@ -150,7 +150,7 @@ public class UIBuilder { /** * Returns a {@link javax.swing.JDialog} window. - * @returns a JDialog + * @return a JDialog */ public JDialog build() { dialog.pack(); diff --git a/test/lib/jdk/test/lib/security/timestamp/TsaSigner.java b/test/lib/jdk/test/lib/security/timestamp/TsaSigner.java index 2d18cf768c8..a3647552557 100644 --- a/test/lib/jdk/test/lib/security/timestamp/TsaSigner.java +++ b/test/lib/jdk/test/lib/security/timestamp/TsaSigner.java @@ -83,7 +83,7 @@ public class TsaSigner { /** * Sign data. * - * @returns the time-stamping response data + * @return the time-stamping response data */ public byte[] sign() throws Exception { TsaParam requestParam = parseRequestParam();