From fd5ff0547ced6733ae05f1428664062615408dc9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Hannes=20Walln=C3=B6fer?= Date: Fri, 25 Oct 2024 07:08:29 +0000 Subject: [PATCH] 8342827: Fix order of @param tags in other modules Reviewed-by: jpai, iris, joehw, darcy, dfuchs --- .../classes/javax/lang/model/util/Elements.java | 4 ++-- .../classes/javax/management/AttributeList.java | 8 ++++---- .../javax/management/DefaultLoaderRepository.java | 4 ++-- .../javax/management/MBeanConstructorInfo.java | 6 +++--- .../classes/javax/management/MBeanOperationInfo.java | 4 ++-- .../share/classes/javax/management/MBeanServer.java | 6 +++--- .../javax/management/MBeanServerConnection.java | 4 ++-- .../management/loading/ClassLoaderRepository.java | 6 +++--- .../management/loading/DefaultLoaderRepository.java | 4 ++-- .../modelmbean/ModelMBeanOperationInfo.java | 6 +++--- .../share/classes/javax/naming/CompositeName.java | 6 +++--- .../share/classes/javax/naming/CompoundName.java | 6 +++--- src/java.naming/share/classes/javax/naming/Name.java | 10 +++++----- .../share/classes/javax/naming/Reference.java | 4 ++-- .../javax/naming/directory/SearchControls.java | 12 ++++++------ .../share/classes/javax/naming/ldap/LdapName.java | 10 +++++----- .../javax/naming/ldap/LdapReferralException.java | 6 +++--- .../share/classes/javax/script/Invocable.java | 6 +++--- .../share/classes/javax/sql/rowset/CachedRowSet.java | 6 +++--- .../classes/javax/xml/stream/XMLEventFactory.java | 12 ++++++------ .../classes/javax/xml/stream/XMLStreamException.java | 6 +++--- .../classes/javax/xml/stream/XMLStreamWriter.java | 4 ++-- .../transform/TransformerConfigurationException.java | 4 ++-- .../validation/SchemaFactoryConfigurationError.java | 4 ++-- .../jdk/dynalink/linker/GuardedInvocation.java | 6 +++--- .../share/classes/com/sun/jdi/ArrayReference.java | 4 ++-- .../com/sun/jdi/request/EventRequestManager.java | 4 ++-- .../classes/com/sun/nio/sctp/SctpMultiChannel.java | 10 +++++----- 28 files changed, 86 insertions(+), 86 deletions(-) diff --git a/src/java.compiler/share/classes/javax/lang/model/util/Elements.java b/src/java.compiler/share/classes/javax/lang/model/util/Elements.java index 5159ac26e3b..7f0b493572e 100644 --- a/src/java.compiler/share/classes/javax/lang/model/util/Elements.java +++ b/src/java.compiler/share/classes/javax/lang/model/util/Elements.java @@ -81,8 +81,8 @@ public interface Elements { * @implSpec The default implementation of this method returns * {@code null}. * - * @param name fully qualified package name, or an empty string for an unnamed package * @param module module relative to which the lookup should happen + * @param name fully qualified package name, or an empty string for an unnamed package * @return the specified package, or {@code null} if it cannot be found * @see #getAllPackageElements * @since 9 @@ -167,8 +167,8 @@ public interface Elements { * @implSpec The default implementation of this method returns * {@code null}. * - * @param name the canonical name * @param module module relative to which the lookup should happen + * @param name the canonical name * @return the named type element, or {@code null} if it cannot be found * @see #getAllTypeElements * @since 9 diff --git a/src/java.management/share/classes/javax/management/AttributeList.java b/src/java.management/share/classes/javax/management/AttributeList.java index 74c9b860f91..932c4974244 100644 --- a/src/java.management/share/classes/javax/management/AttributeList.java +++ b/src/java.management/share/classes/javax/management/AttributeList.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -182,9 +182,9 @@ public class AttributeList extends ArrayList { * size())} a RuntimeOperationsException should be raised, wrapping the * java.lang.IndexOutOfBoundsException thrown. * - * @param object The Attribute object to be inserted. * @param index The position in the list where the new {@code Attribute} * object is to be inserted. + * @param object The Attribute object to be inserted. */ public void add(int index, Attribute object) { try { @@ -202,8 +202,8 @@ public class AttributeList extends ArrayList { * out of range {@literal (index < 0 || index > size())} a RuntimeOperationsException * should be raised, wrapping the java.lang.IndexOutOfBoundsException thrown. * - * @param object The value to which the attribute element should be set. * @param index The position specified. + * @param object The value to which the attribute element should be set. */ public void set(int index, Attribute object) { try { @@ -238,9 +238,9 @@ public class AttributeList extends ArrayList { * RuntimeOperationsException should be raised, wrapping the * java.lang.IndexOutOfBoundsException thrown. * - * @param list Elements to be inserted into the list. * @param index Position at which to insert the first element from the * AttributeList specified. + * @param list Elements to be inserted into the list. * * @return true if this list changed as a result of the call. * diff --git a/src/java.management/share/classes/javax/management/DefaultLoaderRepository.java b/src/java.management/share/classes/javax/management/DefaultLoaderRepository.java index 461ab1ec3c4..6e846287027 100644 --- a/src/java.management/share/classes/javax/management/DefaultLoaderRepository.java +++ b/src/java.management/share/classes/javax/management/DefaultLoaderRepository.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -80,8 +80,8 @@ public class DefaultLoaderRepository { * is not found the method will throw a ClassNotFoundException * exception. * - * @param className The name of the class to be loaded. * @param loader The class loader to be excluded. + * @param className The name of the class to be loaded. * * @return the loaded class. * diff --git a/src/java.management/share/classes/javax/management/MBeanConstructorInfo.java b/src/java.management/share/classes/javax/management/MBeanConstructorInfo.java index f327920d7d9..5803b306bab 100644 --- a/src/java.management/share/classes/javax/management/MBeanConstructorInfo.java +++ b/src/java.management/share/classes/javax/management/MBeanConstructorInfo.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -75,10 +75,10 @@ public class MBeanConstructorInfo extends MBeanFeatureInfo implements Cloneable * Constructs an {@code MBeanConstructorInfo} object. * * @param name The name of the constructor. + * @param description A human readable description of the constructor. * @param signature {@code MBeanParameterInfo} objects * describing the parameters(arguments) of the constructor. This * may be null with the same effect as a zero-length array. - * @param description A human readable description of the constructor. */ public MBeanConstructorInfo(String name, String description, @@ -90,10 +90,10 @@ public class MBeanConstructorInfo extends MBeanFeatureInfo implements Cloneable * Constructs an {@code MBeanConstructorInfo} object. * * @param name The name of the constructor. + * @param description A human readable description of the constructor. * @param signature {@code MBeanParameterInfo} objects * describing the parameters(arguments) of the constructor. This * may be null with the same effect as a zero-length array. - * @param description A human readable description of the constructor. * @param descriptor The descriptor for the constructor. This may be null * which is equivalent to an empty descriptor. * diff --git a/src/java.management/share/classes/javax/management/MBeanOperationInfo.java b/src/java.management/share/classes/javax/management/MBeanOperationInfo.java index 5069737edef..a0c6b76a79d 100644 --- a/src/java.management/share/classes/javax/management/MBeanOperationInfo.java +++ b/src/java.management/share/classes/javax/management/MBeanOperationInfo.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -97,9 +97,9 @@ public class MBeanOperationInfo extends MBeanFeatureInfo implements Cloneable { * fields contributed by any annotations on the {@code Method} * object that contain the {@link DescriptorKey} meta-annotation. * + * @param description A human readable description of the operation. * @param method The {@code java.lang.reflect.Method} object * describing the MBean operation. - * @param description A human readable description of the operation. */ public MBeanOperationInfo(String description, Method method) { this(method.getName(), diff --git a/src/java.management/share/classes/javax/management/MBeanServer.java b/src/java.management/share/classes/javax/management/MBeanServer.java index 8bf68ef35bf..488c9615515 100644 --- a/src/java.management/share/classes/javax/management/MBeanServer.java +++ b/src/java.management/share/classes/javax/management/MBeanServer.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -622,11 +622,11 @@ public interface MBeanServer extends MBeanServerConnection { * newly created object is not registered in the MBean server.

* * @param className The class name of the object to be instantiated. + * @param loaderName The object name of the class loader to be used. * @param params An array containing the parameters of the * constructor to be invoked. * @param signature An array containing the signature of the * constructor to be invoked. - * @param loaderName The object name of the class loader to be used. * * @return The newly instantiated object. * @@ -711,10 +711,10 @@ public interface MBeanServer extends MBeanServerConnection { * * @param className The name of the class whose class loader should be * used for the de-serialization. - * @param data The byte array to be de-sererialized. * @param loaderName The name of the class loader to be used for * loading the specified class. If null, the MBean Server's class * loader will be used. + * @param data The byte array to be de-sererialized. * * @implSpec This method throws {@link UnsupportedOperationException} by default. * diff --git a/src/java.management/share/classes/javax/management/MBeanServerConnection.java b/src/java.management/share/classes/javax/management/MBeanServerConnection.java index 87764b81c91..22b68f19123 100644 --- a/src/java.management/share/classes/javax/management/MBeanServerConnection.java +++ b/src/java.management/share/classes/javax/management/MBeanServerConnection.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2002, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2002, 2024, 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 @@ -278,11 +278,11 @@ public interface MBeanServerConnection { * * @param className The class name of the MBean to be instantiated. * @param name The object name of the MBean. May be null. + * @param loaderName The object name of the class loader to be used. * @param params An array containing the parameters of the * constructor to be invoked. * @param signature An array containing the signature of the * constructor to be invoked. - * @param loaderName The object name of the class loader to be used. * * @return An ObjectInstance, containing the * ObjectName and the Java class name of the newly diff --git a/src/java.management/share/classes/javax/management/loading/ClassLoaderRepository.java b/src/java.management/share/classes/javax/management/loading/ClassLoaderRepository.java index 3512f51238c..ecd46e8a66d 100644 --- a/src/java.management/share/classes/javax/management/loading/ClassLoaderRepository.java +++ b/src/java.management/share/classes/javax/management/loading/ClassLoaderRepository.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2002, 2007, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2002, 2024, 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 @@ -100,10 +100,10 @@ public interface ClassLoaderRepository { * the same time. The {@link #loadClassBefore} method is * recommended to avoid the risk of deadlock.

* - * @param className The name of the class to be loaded. * @param exclude The class loader to be excluded. May be null, * in which case this method is equivalent to {@link #loadClass * loadClass(className)}. + * @param className The name of the class to be loaded. * * @return the loaded class. * @@ -133,10 +133,10 @@ public interface ClassLoaderRepository { * search as soon as stop is reached, a potential * deadlock with concurrent class loading is avoided.

* - * @param className The name of the class to be loaded. * @param stop The class loader at which to stop. May be null, in * which case this method is equivalent to {@link #loadClass(String) * loadClass(className)}. + * @param className The name of the class to be loaded. * * @return the loaded class. * diff --git a/src/java.management/share/classes/javax/management/loading/DefaultLoaderRepository.java b/src/java.management/share/classes/javax/management/loading/DefaultLoaderRepository.java index 014ed0fccf6..6277c6d1317 100644 --- a/src/java.management/share/classes/javax/management/loading/DefaultLoaderRepository.java +++ b/src/java.management/share/classes/javax/management/loading/DefaultLoaderRepository.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2024, 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 @@ -88,8 +88,8 @@ public class DefaultLoaderRepository { * is not found the method will throw a ClassNotFoundException * exception. * - * @param className The name of the class to be loaded. * @param loader The class loader to be excluded. + * @param className The name of the class to be loaded. * * @return the loaded class. * diff --git a/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanOperationInfo.java b/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanOperationInfo.java index 1d22b41b1e8..4120bc2cd2d 100644 --- a/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanOperationInfo.java +++ b/src/java.management/share/classes/javax/management/modelmbean/ModelMBeanOperationInfo.java @@ -136,9 +136,9 @@ public class ModelMBeanOperationInfo extends MBeanOperationInfo * on the {@code Method} object that contain the {@link * DescriptorKey} meta-annotation. * + * @param description A human readable description of the operation. * @param operationMethod The java.lang.reflect.Method object * describing the MBean operation. - * @param description A human readable description of the operation. */ public ModelMBeanOperationInfo(String description, @@ -160,10 +160,10 @@ public class ModelMBeanOperationInfo extends MBeanOperationInfo * contributed by any annotations on the {@code Method} object * that contain the {@link DescriptorKey} meta-annotation. * - * @param operationMethod The java.lang.reflect.Method object - * describing the MBean operation. * @param description A human readable description of the * operation. + * @param operationMethod The java.lang.reflect.Method object + * describing the MBean operation. * @param descriptor An instance of Descriptor containing the * appropriate metadata for this instance of the * ModelMBeanOperationInfo. If it is null a default diff --git a/src/java.naming/share/classes/javax/naming/CompositeName.java b/src/java.naming/share/classes/javax/naming/CompositeName.java index d731c20facc..021a2f59044 100644 --- a/src/java.naming/share/classes/javax/naming/CompositeName.java +++ b/src/java.naming/share/classes/javax/naming/CompositeName.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2021, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -485,9 +485,9 @@ public class CompositeName implements Name { * new component are shifted up (away from index 0) * to accommodate the new components. * - * @param n The non-null components to add. * @param posn The index in this name at which to add the new * components. Must be in the range [0,size()]. + * @param n The non-null components to add. * @return The updated CompositeName, not a new one. Cannot be null. * @throws InvalidNameException If n is not a composite name. * @throws ArrayIndexOutOfBoundsException @@ -525,9 +525,9 @@ public class CompositeName implements Name { * component are shifted up by one (away from index 0) to accommodate * the new component. * - * @param comp The non-null component to add. * @param posn The index at which to add the new component. * Must be in the range [0,size()]. + * @param comp The non-null component to add. * @return The updated CompositeName, not a new one. Cannot be null. * @throws ArrayIndexOutOfBoundsException * If posn is outside the specified range. diff --git a/src/java.naming/share/classes/javax/naming/CompoundName.java b/src/java.naming/share/classes/javax/naming/CompoundName.java index ec570acbb34..e66d9d1b434 100644 --- a/src/java.naming/share/classes/javax/naming/CompoundName.java +++ b/src/java.naming/share/classes/javax/naming/CompoundName.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2021, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -472,9 +472,9 @@ public class CompoundName implements Name { * Implementation note: Currently the syntax properties of suffix * is not used or checked. They might be in the future. * - * @param n The non-null components to add. * @param posn The index in this name at which to add the new * components. Must be in the range [0,size()]. + * @param n The non-null components to add. * @return The updated CompoundName, not a new one. Cannot be null. * @throws ArrayIndexOutOfBoundsException * If posn is outside the specified range. @@ -512,9 +512,9 @@ public class CompoundName implements Name { * component are shifted up by one (away from index 0) * to accommodate the new component. * - * @param comp The non-null component to add. * @param posn The index at which to add the new component. * Must be in the range [0,size()]. + * @param comp The non-null component to add. * @throws ArrayIndexOutOfBoundsException * If posn is outside the specified range. * @return The updated CompoundName, not a new one. Cannot be null. diff --git a/src/java.naming/share/classes/javax/naming/Name.java b/src/java.naming/share/classes/javax/naming/Name.java index 163b9507176..24865fb64e4 100644 --- a/src/java.naming/share/classes/javax/naming/Name.java +++ b/src/java.naming/share/classes/javax/naming/Name.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2018, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -215,11 +215,11 @@ public interface Name * component are shifted up (away from 0) to accommodate the new * components. * - * @param n - * the components to add * @param posn * the index in this name at which to add the new * components. Must be in the range [0,size()]. + * @param n + * the components to add * @return the updated name (not a new one) * * @throws ArrayIndexOutOfBoundsException @@ -248,11 +248,11 @@ public interface Name * are shifted up by one (away from index 0) to accommodate the new * component. * - * @param comp - * the component to add * @param posn * the index at which to add the new component. * Must be in the range [0,size()]. + * @param comp + * the component to add * @return the updated name (not a new one) * * @throws ArrayIndexOutOfBoundsException diff --git a/src/java.naming/share/classes/javax/naming/Reference.java b/src/java.naming/share/classes/javax/naming/Reference.java index 789ddb95195..3d096f4b84f 100644 --- a/src/java.naming/share/classes/javax/naming/Reference.java +++ b/src/java.naming/share/classes/javax/naming/Reference.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2021, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -164,10 +164,10 @@ public class Reference implements Cloneable, java.io.Serializable { * * @param className The non-null class name of the object to * which this reference refers. + * @param addr The non-null address of the object. * @param factory The possibly null class name of the object's factory. * @param factoryLocation The possibly null location from which * to load the factory (e.g. URL) - * @param addr The non-null address of the object. * @see javax.naming.spi.ObjectFactory * @see javax.naming.spi.NamingManager#getObjectInstance */ diff --git a/src/java.naming/share/classes/javax/naming/directory/SearchControls.java b/src/java.naming/share/classes/javax/naming/directory/SearchControls.java index 6d7cc4bb6cd..8d1f04e06ff 100644 --- a/src/java.naming/share/classes/javax/naming/directory/SearchControls.java +++ b/src/java.naming/share/classes/javax/naming/directory/SearchControls.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2000, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -163,16 +163,16 @@ public class SearchControls implements java.io.Serializable { * Constructs a search constraints using arguments. * @param scope The search scope. One of: * OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE. - * @param timelim The number of milliseconds to wait before returning. - * If 0, wait indefinitely. - * @param deref If true, dereference links during search. * @param countlim The maximum number of entries to return. If 0, return * all entries that satisfy filter. - * @param retobj If true, return the object bound to the name of the - * entry; if false, do not return object. + * @param timelim The number of milliseconds to wait before returning. + * If 0, wait indefinitely. * @param attrs The identifiers of the attributes to return along with * the entry. If null, return all attributes. If empty * return no attributes. + * @param retobj If true, return the object bound to the name of the + * entry; if false, do not return object. + * @param deref If true, dereference links during search. */ public SearchControls(int scope, long countlim, diff --git a/src/java.naming/share/classes/javax/naming/ldap/LdapName.java b/src/java.naming/share/classes/javax/naming/ldap/LdapName.java index 773f3b534b4..bca85cbc11c 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/LdapName.java +++ b/src/java.naming/share/classes/javax/naming/ldap/LdapName.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2024, 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 @@ -436,9 +436,9 @@ public class LdapName implements Name { * index (if any) of the first new component are shifted up * (away from index 0) to accommodate the new components. * - * @param suffix The non-null components to add. * @param posn The index at which to add the new component. * Must be in the range [0,size()]. + * @param suffix The non-null components to add. * * @return The updated name (not a new instance). * @@ -471,9 +471,9 @@ public class LdapName implements Name { * index (if any) of the first new RDN are shifted up (away from index 0) to * accommodate the new RDNs. * - * @param suffixRdns The non-null suffix {@code Rdn}s to add. * @param posn The index at which to add the suffix RDNs. * Must be in the range [0,size()]. + * @param suffixRdns The non-null suffix {@code Rdn}s to add. * * @return The updated name (not a new instance). * @throws IndexOutOfBoundsException @@ -524,9 +524,9 @@ public class LdapName implements Name { * component are shifted up by one (away from index 0) to accommodate * the new component. * - * @param comp The non-null component to add. * @param posn The index at which to add the new component. * Must be in the range [0,size()]. + * @param comp The non-null component to add. * @return The updated LdapName, not a new instance. * Cannot be null. * @exception IndexOutOfBoundsException @@ -548,9 +548,9 @@ public class LdapName implements Name { * RDN are shifted up by one (away from index 0) to accommodate * the new RDN. * - * @param comp The non-null RDN to add. * @param posn The index at which to add the new RDN. * Must be in the range [0,size()]. + * @param comp The non-null RDN to add. * @return The updated LdapName, not a new instance. * Cannot be null. * @exception IndexOutOfBoundsException diff --git a/src/java.naming/share/classes/javax/naming/ldap/LdapReferralException.java b/src/java.naming/share/classes/javax/naming/ldap/LdapReferralException.java index 95a1ca7df0e..70009333f10 100644 --- a/src/java.naming/share/classes/javax/naming/ldap/LdapReferralException.java +++ b/src/java.naming/share/classes/javax/naming/ldap/LdapReferralException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2024, 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 @@ -143,11 +143,11 @@ public abstract class LdapReferralException extends ReferralException { * Service provider implementors should read the "Service Provider" section * in the {@code LdapContext} class description for implementation details. * - * @param reqCtls The possibly null request controls to use for the new context. - * If null or the empty array means use no request controls. * @param env The possibly null environment properties to use when * for the new context. If null, the context is initialized with no environment * properties. + * @param reqCtls The possibly null request controls to use for the new context. + * If null or the empty array means use no request controls. * @return The non-null context at which to continue the method. * @throws NamingException If a naming exception was encountered. * Call either {@code retryReferral()} or {@code skipReferral()} diff --git a/src/java.scripting/share/classes/javax/script/Invocable.java b/src/java.scripting/share/classes/javax/script/Invocable.java index 1fda248a521..87a9624fecd 100644 --- a/src/java.scripting/share/classes/javax/script/Invocable.java +++ b/src/java.scripting/share/classes/javax/script/Invocable.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2024, 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 @@ -38,13 +38,13 @@ public interface Invocable { * Calls a method on a script object compiled during a previous script execution, * which is retained in the state of the ScriptEngine. * - * @param name The name of the procedure to be called. - * * @param thiz If the procedure is a member of a class * defined in the script and thiz is an instance of that class * returned by a previous execution or invocation, the named method is * called through that instance. * + * @param name The name of the procedure to be called. + * * @param args Arguments to pass to the procedure. The rules for converting * the arguments to scripting variables are implementation-specific. * diff --git a/src/java.sql.rowset/share/classes/javax/sql/rowset/CachedRowSet.java b/src/java.sql.rowset/share/classes/javax/sql/rowset/CachedRowSet.java index c10cefef290..e9efa2c7118 100644 --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/CachedRowSet.java +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/CachedRowSet.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2024, 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 @@ -1561,10 +1561,10 @@ public interface CachedRowSet extends RowSet, Joinable { * method is more a matter of convenience when compared to using the version * of execute that takes a ResultSet object. * - * @param startRow the position in the ResultSet from where to start - * populating the records in this CachedRowSet * @param rs the ResultSet object containing the data * to be read into this CachedRowSet object + * @param startRow the position in the ResultSet from where to start + * populating the records in this CachedRowSet * @throws SQLException if a null ResultSet object is supplied * or this CachedRowSet object cannot * retrieve the associated ResultSetMetaData object diff --git a/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java b/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java index 6ca9768915c..d47f4d0e122 100644 --- a/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java +++ b/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2023, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2009, 2024, 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 @@ -258,9 +258,9 @@ public abstract class XMLEventFactory { * an empty NamespaceContext. Querying this event for its namespaces or * attributes will result in an empty iterator being returned. * + * @param prefix the prefix of the QName of the new StartElement * @param namespaceUri the uri of the QName of the new StartElement * @param localName the local name of the QName of the new StartElement - * @param prefix the prefix of the QName of the new StartElement * @return an instance of the requested StartElement */ public abstract StartElement createStartElement(String prefix, @@ -272,9 +272,9 @@ public abstract class XMLEventFactory { * Attributes can be added to this StartElement by passing an iterator * that walks over a set of Attribute interfaces. * + * @param prefix the prefix of the QName of the new StartElement * @param namespaceUri the uri of the QName of the new StartElement * @param localName the local name of the QName of the new StartElement - * @param prefix the prefix of the QName of the new StartElement * @param attributes an unordered set of objects that implement * Attribute to add to the new StartElement * @param namespaces an unordered set of objects that implement @@ -293,9 +293,9 @@ public abstract class XMLEventFactory { * Attributes can be added to this StartElement by passing an iterator * that walks over a set of Attribute interfaces. * + * @param prefix the prefix of the QName of the new StartElement * @param namespaceUri the uri of the QName of the new StartElement * @param localName the local name of the QName of the new StartElement - * @param prefix the prefix of the QName of the new StartElement * @param attributes an unordered set of objects that implement * Attribute to add to the new StartElement, may be null * @param namespaces an unordered set of objects that implement @@ -323,9 +323,9 @@ public abstract class XMLEventFactory { /** * Create a new EndElement + * @param prefix the prefix of the QName of the new StartElement * @param namespaceUri the uri of the QName of the new StartElement * @param localName the local name of the QName of the new StartElement - * @param prefix the prefix of the QName of the new StartElement * @return an instance of the requested EndElement */ public abstract EndElement createEndElement(String prefix, @@ -333,9 +333,9 @@ public abstract class XMLEventFactory { String localName); /** * Create a new EndElement + * @param prefix the prefix of the QName of the new StartElement * @param namespaceUri the uri of the QName of the new StartElement * @param localName the local name of the QName of the new StartElement - * @param prefix the prefix of the QName of the new StartElement * @param namespaces an unordered set of objects that implement * Namespace that have gone out of scope, may be null * @return an instance of the requested EndElement diff --git a/src/java.xml/share/classes/javax/xml/stream/XMLStreamException.java b/src/java.xml/share/classes/javax/xml/stream/XMLStreamException.java index 47ef2e437c9..a6bac73e528 100644 --- a/src/java.xml/share/classes/javax/xml/stream/XMLStreamException.java +++ b/src/java.xml/share/classes/javax/xml/stream/XMLStreamException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2009, 2024, 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 @@ -77,8 +77,8 @@ public class XMLStreamException extends Exception { /** * Construct an exception with the associated message and exception * - * @param th a nested exception * @param msg the message to report + * @param th a nested exception */ public XMLStreamException(String msg, Throwable th) { super(msg, th); @@ -88,9 +88,9 @@ public class XMLStreamException extends Exception { /** * Construct an exception with the associated message, exception and location. * - * @param th a nested exception * @param msg the message to report * @param location the location of the error + * @param th a nested exception */ public XMLStreamException(String msg, Location location, Throwable th) { super("ParseError at [row,col]:["+location.getLineNumber()+","+ diff --git a/src/java.xml/share/classes/javax/xml/stream/XMLStreamWriter.java b/src/java.xml/share/classes/javax/xml/stream/XMLStreamWriter.java index 7cd383245a8..9f0f49776e5 100644 --- a/src/java.xml/share/classes/javax/xml/stream/XMLStreamWriter.java +++ b/src/java.xml/share/classes/javax/xml/stream/XMLStreamWriter.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2009, 2024, 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 @@ -209,8 +209,8 @@ public interface XMLStreamWriter { /** * Writes a start tag to the output - * @param localName local name of the tag, may not be null * @param prefix the prefix of the tag, may not be null + * @param localName local name of the tag, may not be null * @param namespaceURI the uri to bind the prefix to, may not be null * @throws XMLStreamException if an error occurs */ diff --git a/src/java.xml/share/classes/javax/xml/transform/TransformerConfigurationException.java b/src/java.xml/share/classes/javax/xml/transform/TransformerConfigurationException.java index a90e29121a8..9c0b9a4be5b 100644 --- a/src/java.xml/share/classes/javax/xml/transform/TransformerConfigurationException.java +++ b/src/java.xml/share/classes/javax/xml/transform/TransformerConfigurationException.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2024, 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 @@ -67,9 +67,9 @@ public class TransformerConfigurationException extends TransformerException { * Create a new TransformerConfigurationException with the * given Exception base cause and detail message. * + * @param msg The detail message. * @param e The exception to be encapsulated in a * TransformerConfigurationException - * @param msg The detail message. */ public TransformerConfigurationException(String msg, Throwable e) { super(msg, e); diff --git a/src/java.xml/share/classes/javax/xml/validation/SchemaFactoryConfigurationError.java b/src/java.xml/share/classes/javax/xml/validation/SchemaFactoryConfigurationError.java index 47c4dda1ee6..b61060b7404 100644 --- a/src/java.xml/share/classes/javax/xml/validation/SchemaFactoryConfigurationError.java +++ b/src/java.xml/share/classes/javax/xml/validation/SchemaFactoryConfigurationError.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2013, 2024, 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 @@ -69,9 +69,9 @@ public final class SchemaFactoryConfigurationError extends Error { * Create a new SchemaFactoryConfigurationError with the * given Throwable base cause and detail message. * + * @param message The detail message. * @param cause The exception or error to be encapsulated in a * SchemaFactoryConfigurationError. - * @param message The detail message. */ public SchemaFactoryConfigurationError(String message, Throwable cause) { super(message, cause); diff --git a/src/jdk.dynalink/share/classes/jdk/dynalink/linker/GuardedInvocation.java b/src/jdk.dynalink/share/classes/jdk/dynalink/linker/GuardedInvocation.java index 174e63bff26..ff59ddf8268 100644 --- a/src/jdk.dynalink/share/classes/jdk/dynalink/linker/GuardedInvocation.java +++ b/src/jdk.dynalink/share/classes/jdk/dynalink/linker/GuardedInvocation.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2010, 2024, 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 @@ -431,10 +431,10 @@ public class GuardedInvocation { * Composes the invocation, guard, switch points, and the exception into a * composite method handle that knows how to fall back when the guard fails * or the invocation is invalidated. - * @param switchpointFallback the fallback method handle in case a switch - * point is invalidated. * @param guardFallback the fallback method handle in case guard returns * false. + * @param switchpointFallback the fallback method handle in case a switch + * point is invalidated. * @param catchFallback the fallback method in case the exception handler * triggers. * @return a composite method handle. diff --git a/src/jdk.jdi/share/classes/com/sun/jdi/ArrayReference.java b/src/jdk.jdi/share/classes/com/sun/jdi/ArrayReference.java index 11b5bdbcf70..7f445f7c05a 100644 --- a/src/jdk.jdi/share/classes/com/sun/jdi/ArrayReference.java +++ b/src/jdk.jdi/share/classes/com/sun/jdi/ArrayReference.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2024, 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 @@ -108,8 +108,8 @@ public interface ArrayReference extends ObjectReference { * See JLS section 5.2 for more information on assignment * compatibility. * - * @param value the new value * @param index the index of the component to set + * @param value the new value * @throws java.lang.IndexOutOfBoundsException if * index is outside the range of this array, * that is, if either of the following are true: diff --git a/src/jdk.jdi/share/classes/com/sun/jdi/request/EventRequestManager.java b/src/jdk.jdi/share/classes/com/sun/jdi/request/EventRequestManager.java index 2ffa7008ee4..3bd363af56e 100644 --- a/src/jdk.jdi/share/classes/com/sun/jdi/request/EventRequestManager.java +++ b/src/jdk.jdi/share/classes/com/sun/jdi/request/EventRequestManager.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2024, 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 @@ -261,8 +261,8 @@ public interface EventRequestManager extends Mirror { * } * * @param thread the thread in which to step - * @param depth the step depth * @param size the step size + * @param depth the step depth * @return the created {@link StepRequest} * @throws DuplicateRequestException if there is already a pending * step request for the specified thread. diff --git a/src/jdk.sctp/share/classes/com/sun/nio/sctp/SctpMultiChannel.java b/src/jdk.sctp/share/classes/com/sun/nio/sctp/SctpMultiChannel.java index b9069173938..290838755cd 100644 --- a/src/jdk.sctp/share/classes/com/sun/nio/sctp/SctpMultiChannel.java +++ b/src/jdk.sctp/share/classes/com/sun/nio/sctp/SctpMultiChannel.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2009, 2020, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2009, 2024, 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 @@ -481,14 +481,14 @@ public abstract class SctpMultiChannel * @param name * The socket option * - * @param association - * The association whose option should be set, or {@code null} - * if this option should be set at the channel's socket level. - * * @param value * The value of the socket option. A value of {@code null} may be * a valid value for some socket options. * + * @param association + * The association whose option should be set, or {@code null} + * if this option should be set at the channel's socket level. + * * @return This channel * * @throws UnsupportedOperationException