stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8303480: Miscellaneous fixes to mostly invisible doc comments

Browse Source 
Reviewed-by: mullan, prr, cjplummer, aivanov, jjg, lancea, rriggs, ihse
This commit is contained in:
Pavel Rappo 2023-03-07 15:31:42 +00:00
parent 43288bbd68
commit 45a616a891
39 changed files with 75 additions and 75 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
make/ide/idea/jdk/template/src/idea/JdkIdeaAntLogger.java
View File

@ -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<String, String>} and method reference when moving to 8
* TODO: replace with {@code BiPredicate<String, String>} and method reference when moving to 8
*/
enum StringBinaryPredicate {
CONTAINS() {

2
make/ide/idea/langtools/template/src/idea/LangtoolsIdeaAntLogger.java
View File

@ -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<String, String>} and method reference when moving to 8
* TODO: replace with {@code BiPredicate<String, String>} and method reference when moving to 8
*/
enum StringBinaryPredicate {
CONTAINS() {

8
src/java.base/share/classes/java/lang/invoke/BootstrapMethodInvoker.java
View File

@ -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) {

2
src/java.base/share/classes/java/security/AccessControlContext.java
View File

@ -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
*/

6
src/java.base/share/classes/java/security/BasicPermission.java
View File

@ -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<String, Permission> 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
*/

2
src/java.base/share/classes/jdk/internal/foreign/abi/CallingSequence.java
View File

@ -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
*/

2
src/java.base/share/classes/jdk/internal/vm/VMSupport.java
View File

@ -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) {

4
src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java
View File

@ -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) {

12
src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboBoxUI.java
View File

@ -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, <em>or</em> 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,

2
src/java.desktop/share/classes/javax/swing/plaf/synth/SynthComboPopup.java
View File

@ -67,7 +67,7 @@ class SynthComboPopup extends BasicComboPopup {
}
/**
* @inheritDoc
* {@inheritDoc}
*
* Overridden to take into account any popup insets specified in
* SynthComboBoxUI

2
src/java.desktop/share/classes/sun/font/GlyphLayout.java
View File

@ -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
*/

4
src/java.desktop/share/classes/sun/java2d/StateTrackableDelegate.java
View File

@ -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() {

2
src/java.desktop/share/classes/sun/swing/AccumulativeRunnable.java
View File

@ -116,7 +116,7 @@ public abstract class AccumulativeRunnable<T> implements Runnable {
* appends arguments and sends this {@code Runnable} for the
* execution if needed.
* <p>
* 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
*/

4
src/java.desktop/share/classes/sun/swing/SwingUtilities2.java
View File

@ -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) {

2
src/java.desktop/unix/classes/sun/awt/X11/XToolkit.java
View File

@ -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) {

2
src/jdk.compiler/share/classes/com/sun/tools/javac/code/Type.java
View File

@ -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;

2
src/jdk.compiler/share/classes/com/sun/tools/javac/code/Types.java
View File

@ -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.
*/

2
src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Check.java
View File

@ -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?

2
src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Infer.java
View File

@ -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.
*

2
src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Resolve.java
View File

@ -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 {

4
src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/debugger/win32/coff/DebugDirectoryEntry.java
View File

@ -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();

4
src/jdk.hotspot.agent/share/classes/sun/jvm/hotspot/utilities/LivenessPath.java
View File

@ -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. */

2
src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/Cleaner.java
View File

@ -98,7 +98,7 @@ abstract class Cleaner extends WeakReference<Object> {
/**
* 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
* @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
*/

2
src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/HotSpotCompiledCodeStream.java
View File

@ -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();

6
src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/hotspot/JFR.java
View File

@ -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 {

4
src/jdk.internal.vm.ci/share/classes/jdk/vm/ci/meta/MethodHandleAccessProvider.java
View File

@ -66,7 +66,7 @@ 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
* @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
*/
@ -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}

4
src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/markup/Head.java
View File

@ -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

10
src/utils/LogCompilation/src/main/java/com/sun/hotspot/tools/compiler/LogParser.java
View File

@ -513,12 +513,12 @@ public class LogParser extends DefaultHandler implements ErrorHandler {
private HashMap<String, Method> methods = new HashMap<>();
/**
* Map compilation IDs ({@see #makeId()}) to newly created nmethods.
* Map compilation IDs ({@link #makeId()}) to newly created nmethods.
*/
private LinkedHashMap<String, NMethod> nmethods = new LinkedHashMap<>();
/**
* Map compilation task IDs {@see #makeId()}) to {@link Compilation}
* Map compilation task IDs {@link #makeId()}) to {@link Compilation}
* objects.
*/
private HashMap<String, Compilation> 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<CallSite> scopes = new ArrayDeque<>();

2
test/hotspot/jtreg/compiler/lib/ir_framework/TestFramework.java
View File

@ -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.

2
test/hotspot/jtreg/gc/g1/plab/lib/PlabGCStatistics.java
View File

@ -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);

2
test/hotspot/jtreg/vmTestbase/nsk/share/runner/MultiRunner.java
View File

@ -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();
}

4
test/jdk/java/rmi/testlibrary/TestLibrary.java
View File

@ -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 {

2
test/jdk/java/time/test/java/time/chrono/TestExampleCode.java
View File

@ -209,7 +209,7 @@ public class TestExampleCode {
* same chronology.
* @param <D> a parameterized ChronoLocalDate
* @param date a specific date extending ChronoLocalDate
* @return a [@code ChronoLocalDateTime<D>} using the change chronology.
* @return a {@code ChronoLocalDateTime<D>} using the change chronology.
*/
@SuppressWarnings("unchecked")
private <D extends ChronoLocalDate> ChronoLocalDateTime<D> tomorrowNoon(D date) {

4
test/jdk/sun/security/ssl/SignatureScheme/SigSchemePropOrdering.java
View File

@ -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.
*/

6
test/jdk/sun/security/tools/keytool/KeyToolTest.java
View File

@ -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 {

2
test/langtools/jdk/javadoc/doclet/testRecordTypes/examples/SerializableProxy.java
View File

@ -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);

2
test/lib/jdk/test/lib/ByteCodeLoader.java
View File

@ -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);

14
test/lib/jdk/test/lib/UIBuilder.java
View File

@ -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();

2
test/lib/jdk/test/lib/security/timestamp/TsaSigner.java
View File

@ -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();