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

8342827: Fix order of @param tags in other modules

Browse Source 
Reviewed-by: jpai, iris, joehw, darcy, dfuchs
This commit is contained in:
Hannes Wallnöfer 2024-10-25 07:08:29 +00:00
parent 415d8151a6
commit fd5ff0547c
28 changed files with 86 additions and 86 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
src/java.compiler/share/classes/javax/lang/model/util/Elements.java
View File

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

8
src/java.management/share/classes/javax/management/AttributeList.java
View File

@ -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<Object> {
* size())} a RuntimeOperationsException should be raised, wrapping the
* java.lang.IndexOutOfBoundsException thrown.
*
* @param object The <CODE>Attribute</CODE> object to be inserted.
* @param index The position in the list where the new {@code Attribute}
* object is to be inserted.
* @param object The <CODE>Attribute</CODE> object to be inserted.
*/
public void add(int index, Attribute object) {
try {
@ -202,8 +202,8 @@ public class AttributeList extends ArrayList<Object> {
* 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<Object> {
* 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
* <CODE>AttributeList</CODE> specified.
* @param list Elements to be inserted into the list.
*
* @return true if this list changed as a result of the call.
*

4
src/java.management/share/classes/javax/management/DefaultLoaderRepository.java
View File

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

6
src/java.management/share/classes/javax/management/MBeanConstructorInfo.java
View File

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

4
src/java.management/share/classes/javax/management/MBeanOperationInfo.java
View File

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

6
src/java.management/share/classes/javax/management/MBeanServer.java
View File

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

4
src/java.management/share/classes/javax/management/MBeanServerConnection.java
View File

@ -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 <CODE>ObjectInstance</CODE>, containing the
* <CODE>ObjectName</CODE> and the Java class name of the newly

6
src/java.management/share/classes/javax/management/loading/ClassLoaderRepository.java
View File

@ -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.</p>
*
* @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 <code>stop</code> is reached, a potential
* deadlock with concurrent class loading is avoided.</p>
*
* @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.
*

4
src/java.management/share/classes/javax/management/loading/DefaultLoaderRepository.java
View File

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

6
src/java.management/share/classes/javax/management/modelmbean/ModelMBeanOperationInfo.java
View File

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

6
src/java.naming/share/classes/javax/naming/CompositeName.java
View File

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

6
src/java.naming/share/classes/javax/naming/CompoundName.java
View File

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

10
src/java.naming/share/classes/javax/naming/Name.java
View File

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

4
src/java.naming/share/classes/javax/naming/Reference.java
View File

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

12
src/java.naming/share/classes/javax/naming/directory/SearchControls.java
View File

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

10
src/java.naming/share/classes/javax/naming/ldap/LdapName.java
View File

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

6
src/java.naming/share/classes/javax/naming/ldap/LdapReferralException.java
View File

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

6
src/java.scripting/share/classes/javax/script/Invocable.java
View File

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

6
src/java.sql.rowset/share/classes/javax/sql/rowset/CachedRowSet.java
View File

@ -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 <code>execute</code> that takes a <code>ResultSet</code> object.
*
* @param startRow the position in the <code>ResultSet</code> from where to start
* populating the records in this <code>CachedRowSet</code>
* @param rs the <code>ResultSet</code> object containing the data
* to be read into this <code>CachedRowSet</code> object
* @param startRow the position in the <code>ResultSet</code> from where to start
* populating the records in this <code>CachedRowSet</code>
* @throws SQLException if a null <code>ResultSet</code> object is supplied
* or this <code>CachedRowSet</code> object cannot
* retrieve the associated <code>ResultSetMetaData</code> object

12
src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java
View File

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

6
src/java.xml/share/classes/javax/xml/stream/XMLStreamException.java
View File

@ -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()+","+

4
src/java.xml/share/classes/javax/xml/stream/XMLStreamWriter.java
View File

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

4
src/java.xml/share/classes/javax/xml/transform/TransformerConfigurationException.java
View File

@ -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 <code>TransformerConfigurationException</code> with the
* given <code>Exception</code> 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);

4
src/java.xml/share/classes/javax/xml/validation/SchemaFactoryConfigurationError.java
View File

@ -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 <code>SchemaFactoryConfigurationError</code> with the
* given <code>Throwable</code> 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);

6
src/jdk.dynalink/share/classes/jdk/dynalink/linker/GuardedInvocation.java
View File

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

4
src/jdk.jdi/share/classes/com/sun/jdi/ArrayReference.java
View File

@ -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
* <CODE><I>index</I></CODE> is outside the range of this array,
* that is, if either of the following are true:

4
src/jdk.jdi/share/classes/com/sun/jdi/request/EventRequestManager.java
View File

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

10
src/jdk.sctp/share/classes/com/sun/nio/sctp/SctpMultiChannel.java
View File

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