--- old/make/Docs.gmk 2020-08-24 17:28:45.597741348 +0000
+++ new/make/Docs.gmk 2020-08-24 17:28:45.301726246 +0000
@@ -298,6 +298,9 @@
# Create a string like "-Xdoclint:all,-syntax,-html,..."
$1_OPTIONS += -Xdoclint:all,$$(call CommaList, $$(addprefix -, \
$$(JAVADOC_DISABLED_DOCLINT)))
+ # Ignore the W3C DOM package
+ $1_OPTIONS += -Xdoclint/package:-org.w3c.*
+ $1_OPTIONS += -Xmaxwarns 10000
$1_DOC_TITLE := $$($1_LONG_NAME)
Version $$(VERSION_SPECIFICATION) API \
Specification
--- old/src/java.xml/share/classes/javax/xml/stream/FactoryConfigurationError.java 2020-08-24 17:28:46.297777062 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/FactoryConfigurationError.java 2020-08-24 17:28:46.005762164 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -36,6 +36,9 @@
public class FactoryConfigurationError extends Error {
private static final long serialVersionUID = -2994412584589975744L;
+ /**
+ * The nested exception
+ */
Exception nested;
/**
--- old/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java 2020-08-24 17:28:46.980811908 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLEventFactory.java 2020-08-24 17:28:46.694797316 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -45,11 +45,15 @@
* @since 1.6
*/
public abstract class XMLEventFactory {
- protected XMLEventFactory(){}
-
static final String JAXPFACTORYID = "javax.xml.stream.XMLEventFactory";
static final String DEFAULIMPL = "com.sun.xml.internal.stream.events.XMLEventFactoryImpl";
+ /**
+ * Protected constructor to prevent instantiation.
+ * Use {@link #newFactory()} instead.
+ */
+ protected XMLEventFactory(){}
+
/**
* Creates a new instance of the {@code XMLEventFactory} builtin
* system-default implementation.
@@ -66,6 +70,8 @@
/**
* Creates a new instance of the factory in exactly the same manner as the
* {@link #newFactory()} method.
+ *
+ * @return an instance of the {@code XMLEventFactory}
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLEventFactory newInstance()
@@ -126,6 +132,7 @@
* Once an application has obtained a reference to a XMLEventFactory it
* can use the factory to configure and obtain stream instances.
*
+ * @return an instance of the {@code XMLEventFactory}
* @throws FactoryConfigurationError in case of {@linkplain
* java.util.ServiceConfigurationError service configuration error} or if
* the implementation is not available or cannot be instantiated.
@@ -474,9 +481,9 @@
public abstract EntityReference createEntityReference(String name,
EntityDeclaration declaration);
/**
- * Create a comment
+ * Create a comment.
* @param text The text of the comment
- * a Comment event
+ * @return a Comment event
*/
public abstract Comment createComment(String text);
--- old/src/java.xml/share/classes/javax/xml/stream/XMLEventReader.java 2020-08-24 17:28:47.675847367 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLEventReader.java 2020-08-24 17:28:47.389832775 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -68,7 +68,7 @@
*
* @return the next XMLEvent
* @see XMLEvent
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public XMLEvent peek() throws XMLStreamException;
--- old/src/java.xml/share/classes/javax/xml/stream/XMLEventWriter.java 2020-08-24 17:28:48.366882621 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLEventWriter.java 2020-08-24 17:28:48.079867979 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -50,13 +50,13 @@
/**
* Writes any cached events to the underlying output mechanism
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void flush() throws XMLStreamException;
/**
* Frees any resources associated with this stream
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void close() throws XMLStreamException;
@@ -180,7 +180,7 @@
*
*
* @param event the event to be added
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void add(XMLEvent event) throws XMLStreamException;
@@ -192,7 +192,7 @@
* event reader and call add on each event.
*
* @param reader the event stream to add to the output
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void add(XMLEventReader reader) throws XMLStreamException;
@@ -200,7 +200,8 @@
/**
* Gets the prefix the uri is bound to
* @param uri the uri to look up
- * @throws XMLStreamException
+ * @return the prefix
+ * @throws XMLStreamException if an error occurs
*/
public String getPrefix(String uri) throws XMLStreamException;
@@ -211,7 +212,7 @@
* the prefix is bound in the root scope.
* @param prefix the prefix to bind to the uri
* @param uri the uri to bind to the prefix
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void setPrefix(String prefix, String uri) throws XMLStreamException;
@@ -222,7 +223,7 @@
* If this method is called before a START_ELEMENT has been written
* the uri is bound in the root scope.
* @param uri the uri to bind to the default namespace
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void setDefaultNamespace(String uri) throws XMLStreamException;
@@ -234,7 +235,7 @@
* the context passed to the method as the root context for resolving
* namespaces.
* @param context the namespace context to use for this writer
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void setNamespaceContext(NamespaceContext context)
throws XMLStreamException;
--- old/src/java.xml/share/classes/javax/xml/stream/XMLInputFactory.java 2020-08-24 17:28:49.056917825 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLInputFactory.java 2020-08-24 17:28:48.770903233 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -135,6 +135,10 @@
static final String DEFAULIMPL = "com.sun.xml.internal.stream.XMLInputFactoryImpl";
+ /**
+ * Protected constructor to prevent instantiation.
+ * Use {@link #newFactory()} instead.
+ */
protected XMLInputFactory(){}
/**
@@ -153,6 +157,7 @@
/**
* Creates a new instance of the factory in exactly the same manner as the
* {@link #newFactory()} method.
+ * @return an instance of the {@code XMLInputFactory}
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLInputFactory newInstance()
@@ -210,6 +215,7 @@
* Once an application has obtained a reference to a XMLInputFactory it
* can use the factory to configure and obtain stream instances.
*
+ * @return an instance of the {@code XMLInputFactory}
* @throws FactoryConfigurationError in case of {@linkplain
* java.util.ServiceConfigurationError service configuration error} or if
* the implementation is not available or cannot be instantiated.
@@ -221,7 +227,7 @@
}
/**
- * Create a new instance of the factory
+ * Create a new instance of the factory.
*
* @param factoryId Name of the factory to find, same as
* a property name
@@ -324,9 +330,10 @@
}
/**
- * Create a new XMLStreamReader from a reader
+ * Create a new XMLStreamReader from a reader.
* @param reader the XML data to read from
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLStreamReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamReader createXMLStreamReader(java.io.Reader reader)
throws XMLStreamException;
@@ -334,59 +341,68 @@
/**
* Create a new XMLStreamReader from a JAXP source. This method is optional.
* @param source the source to read from
+ * @return an instance of the {@code XMLStreamReader}
* @throws UnsupportedOperationException if this method is not
* supported by this XMLInputFactory
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamReader createXMLStreamReader(Source source)
throws XMLStreamException;
/**
- * Create a new XMLStreamReader from a java.io.InputStream
+ * Create a new XMLStreamReader from a java.io.InputStream.
* @param stream the InputStream to read from
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLStreamReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamReader createXMLStreamReader(java.io.InputStream stream)
throws XMLStreamException;
/**
- * Create a new XMLStreamReader from a java.io.InputStream
+ * Create a new XMLStreamReader from a java.io.InputStream.
* @param stream the InputStream to read from
* @param encoding the character encoding of the stream
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLStreamReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamReader createXMLStreamReader(java.io.InputStream stream, String encoding)
throws XMLStreamException;
/**
- * Create a new XMLStreamReader from a java.io.InputStream
+ * Create a new XMLStreamReader from a java.io.InputStream.
* @param systemId the system ID of the stream
* @param stream the InputStream to read from
+ * @return an instance of the {@code XMLStreamReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamReader createXMLStreamReader(String systemId, java.io.InputStream stream)
throws XMLStreamException;
/**
- * Create a new XMLStreamReader from a java.io.InputStream
+ * Create a new XMLStreamReader from a java.io.InputStream.
* @param systemId the system ID of the stream
* @param reader the InputStream to read from
+ * @return an instance of the {@code XMLStreamReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamReader createXMLStreamReader(String systemId, java.io.Reader reader)
throws XMLStreamException;
/**
- * Create a new XMLEventReader from a reader
+ * Create a new XMLEventReader from a reader.
* @param reader the XML data to read from
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLEventReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventReader createXMLEventReader(java.io.Reader reader)
throws XMLStreamException;
/**
- * Create a new XMLEventReader from a reader
+ * Create a new XMLEventReader from a reader.
* @param systemId the system ID of the input
* @param reader the XML data to read from
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLEventReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventReader createXMLEventReader(String systemId, java.io.Reader reader)
throws XMLStreamException;
@@ -397,7 +413,7 @@
* the XMLStreamReader must not be used.
* @param reader the XMLStreamReader to read from (may not be modified)
* @return a new XMLEventReader
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventReader createXMLEventReader(XMLStreamReader reader)
throws XMLStreamException;
@@ -406,6 +422,8 @@
* Create a new XMLEventReader from a JAXP source.
* Support of this method is optional.
* @param source the source to read from
+ * @return an instance of the {@code XMLEventReader}
+ * @throws XMLStreamException if an error occurs
* @throws UnsupportedOperationException if this method is not
* supported by this XMLInputFactory
*/
@@ -415,7 +433,8 @@
/**
* Create a new XMLEventReader from a java.io.InputStream
* @param stream the InputStream to read from
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLEventReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventReader createXMLEventReader(java.io.InputStream stream)
throws XMLStreamException;
@@ -424,7 +443,8 @@
* Create a new XMLEventReader from a java.io.InputStream
* @param stream the InputStream to read from
* @param encoding the character encoding of the stream
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLEventReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventReader createXMLEventReader(java.io.InputStream stream, String encoding)
throws XMLStreamException;
@@ -433,7 +453,8 @@
* Create a new XMLEventReader from a java.io.InputStream
* @param systemId the system ID of the stream
* @param stream the InputStream to read from
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLEventReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventReader createXMLEventReader(String systemId, java.io.InputStream stream)
throws XMLStreamException;
@@ -442,7 +463,8 @@
* Create a filtered reader that wraps the filter around the reader
* @param reader the reader to filter
* @param filter the filter to apply to the reader
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLEventReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamReader createFilteredReader(XMLStreamReader reader, StreamFilter filter)
throws XMLStreamException;
@@ -451,7 +473,8 @@
* Create a filtered event reader that wraps the filter around the event reader
* @param reader the event reader to wrap
* @param filter the filter to apply to the event reader
- * @throws XMLStreamException
+ * @return an instance of the {@code XMLEventReader}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventReader createFilteredReader(XMLEventReader reader, EventFilter filter)
throws XMLStreamException;
@@ -459,6 +482,7 @@
/**
* The resolver that will be set on any XMLStreamReader or XMLEventReader created
* by this factory instance.
+ * @return an instance of the {@code XMLResolver}
*/
public abstract XMLResolver getXMLResolver();
@@ -472,6 +496,7 @@
/**
* The reporter that will be set on any XMLStreamReader or XMLEventReader created
* by this factory instance.
+ * @return an instance of the {@code XMLReporter}
*/
public abstract XMLReporter getXMLReporter();
@@ -535,6 +560,7 @@
/**
* Gets the allocator used by streams created with this factory
+ * @return an instance of the {@code XMLEventAllocator}
*/
public abstract XMLEventAllocator getEventAllocator();
--- old/src/java.xml/share/classes/javax/xml/stream/XMLOutputFactory.java 2020-08-24 17:28:49.754953437 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLOutputFactory.java 2020-08-24 17:28:49.468938845 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -112,6 +112,10 @@
static final String DEFAULIMPL = "com.sun.xml.internal.stream.XMLOutputFactoryImpl";
+ /**
+ * Protected constructor to prevent instantiation.
+ * Use {@link #newFactory()} instead.
+ */
protected XMLOutputFactory(){}
/**
@@ -130,6 +134,7 @@
/**
* Creates a new instance of the factory in exactly the same manner as the
* {@link #newFactory()} method.
+ * @return an instance of the {@code XMLOutputFactory}
* @throws FactoryConfigurationError if an instance of this factory cannot be loaded
*/
public static XMLOutputFactory newInstance()
@@ -190,6 +195,7 @@
* Once an application has obtained a reference to a XMLOutputFactory it
* can use the factory to configure and obtain stream instances.
*
+ * @return an instance of the {@code XMLOutputFactory}
* @throws FactoryConfigurationError in case of {@linkplain
* java.util.ServiceConfigurationError service configuration error} or if
* the implementation is not available or cannot be instantiated.
@@ -302,14 +308,16 @@
/**
* Create a new XMLStreamWriter that writes to a writer
* @param stream the writer to write to
- * @throws XMLStreamException
+ * @return instance of the {@code XMLStreamWriter}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamWriter createXMLStreamWriter(java.io.Writer stream) throws XMLStreamException;
/**
* Create a new XMLStreamWriter that writes to a stream
* @param stream the stream to write to
- * @throws XMLStreamException
+ * @return instance of the {@code XMLStreamWriter}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamWriter createXMLStreamWriter(java.io.OutputStream stream) throws XMLStreamException;
@@ -317,7 +325,8 @@
* Create a new XMLStreamWriter that writes to a stream
* @param stream the stream to write to
* @param encoding the encoding to use
- * @throws XMLStreamException
+ * @return instance of the {@code XMLStreamWriter}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamWriter createXMLStreamWriter(java.io.OutputStream stream,
String encoding) throws XMLStreamException;
@@ -325,9 +334,10 @@
/**
* Create a new XMLStreamWriter that writes to a JAXP result. This method is optional.
* @param result the result to write to
+ * @return instance of the {@code XMLStreamWriter}
* @throws UnsupportedOperationException if this method is not
* supported by this XMLOutputFactory
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLStreamWriter createXMLStreamWriter(Result result) throws XMLStreamException;
@@ -335,16 +345,18 @@
/**
* Create a new XMLEventWriter that writes to a JAXP result. This method is optional.
* @param result the result to write to
+ * @return instance of the {@code XMLEventWriter}
* @throws UnsupportedOperationException if this method is not
* supported by this XMLOutputFactory
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventWriter createXMLEventWriter(Result result) throws XMLStreamException;
/**
* Create a new XMLEventWriter that writes to a stream
* @param stream the stream to write to
- * @throws XMLStreamException
+ * @return instance of the {@code XMLEventWriter}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventWriter createXMLEventWriter(java.io.OutputStream stream) throws XMLStreamException;
@@ -354,7 +366,8 @@
* Create a new XMLEventWriter that writes to a stream
* @param stream the stream to write to
* @param encoding the encoding to use
- * @throws XMLStreamException
+ * @return instance of the {@code XMLEventWriter}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventWriter createXMLEventWriter(java.io.OutputStream stream,
String encoding) throws XMLStreamException;
@@ -362,7 +375,8 @@
/**
* Create a new XMLEventWriter that writes to a writer
* @param stream the stream to write to
- * @throws XMLStreamException
+ * @return instance of the {@code XMLEventWriter}
+ * @throws XMLStreamException if an error occurs
*/
public abstract XMLEventWriter createXMLEventWriter(java.io.Writer stream) throws XMLStreamException;
--- old/src/java.xml/share/classes/javax/xml/stream/XMLReporter.java 2020-08-24 17:28:50.453989099 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLReporter.java 2020-08-24 17:28:50.168974559 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -35,27 +35,16 @@
public interface XMLReporter {
/**
-
* Report the desired message in an application specific format.
-
* Only warnings and non-fatal errors should be reported through
-
* this interface.
-
* Fatal errors should be thrown as XMLStreamException.
-
*
-
* @param message the error message
-
* @param errorType an implementation defined error type
-
* @param relatedInformation information related to the error, if available
-
* @param location the location of the error, if available
-
- * @throws XMLStreamException
-
+ * @throws XMLStreamException if an error occurs
*/
public void report(String message, String errorType, Object relatedInformation, Location location)
throws XMLStreamException;
--- old/src/java.xml/share/classes/javax/xml/stream/XMLStreamException.java 2020-08-24 17:28:51.144024303 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLStreamException.java 2020-08-24 17:28:50.858009711 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -37,7 +37,14 @@
public class XMLStreamException extends Exception {
private static final long serialVersionUID = 2018819321811497362L;
+ /**
+ * The nested exception
+ */
protected Throwable nested;
+
+ /**
+ * The location of the error
+ */
protected Location location;
/**
--- old/src/java.xml/share/classes/javax/xml/stream/XMLStreamReader.java 2020-08-24 17:28:51.833059455 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLStreamReader.java 2020-08-24 17:28:51.544044711 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -256,6 +256,7 @@
* return buf.toString();
*
*
+ * @return the content of a text-only element
* @throws XMLStreamException if the current event is not a START_ELEMENT
* or if a non text element is encountered
*/
--- old/src/java.xml/share/classes/javax/xml/stream/XMLStreamWriter.java 2020-08-24 17:28:52.528094914 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/XMLStreamWriter.java 2020-08-24 17:28:52.243080373 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -192,7 +192,7 @@
* open a new scope in the internal namespace context. Writing the
* corresponding EndElement causes the scope to be closed.
* @param localName local name of the tag, may not be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeStartElement(String localName)
throws XMLStreamException;
@@ -212,7 +212,7 @@
* @param localName local name of the tag, may not be null
* @param prefix the prefix of the tag, may not be null
* @param namespaceURI the uri to bind the prefix to, may not be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeStartElement(String prefix,
String localName,
@@ -234,7 +234,7 @@
* @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 tag to, may not be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeEmptyElement(String prefix, String localName, String namespaceURI)
throws XMLStreamException;
@@ -242,7 +242,7 @@
/**
* Writes an empty element tag to the output
* @param localName local name of the tag, may not be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeEmptyElement(String localName)
throws XMLStreamException;
@@ -264,14 +264,14 @@
* Writes an end tag to the output relying on the internal
* state of the writer to determine the prefix and local name
* of the event.
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeEndElement()
throws XMLStreamException;
/**
* Closes any start tags and writes corresponding end tags.
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeEndDocument()
throws XMLStreamException;
@@ -279,14 +279,14 @@
/**
* Close this writer and free any resources associated with the
* writer. This must not close the underlying output stream.
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void close()
throws XMLStreamException;
/**
* Write any cached data to the underlying output mechanism.
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void flush()
throws XMLStreamException;
@@ -297,7 +297,7 @@
* @param localName the local name of the attribute
* @param value the value of the attribute
* @throws IllegalStateException if the current state does not allow Attribute writing
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeAttribute(String localName, String value)
throws XMLStreamException;
@@ -341,7 +341,7 @@
* @param prefix the prefix to bind this namespace to
* @param namespaceURI the uri to bind the prefix to
* @throws IllegalStateException if the current state does not allow Namespace writing
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeNamespace(String prefix, String namespaceURI)
throws XMLStreamException;
@@ -350,7 +350,7 @@
* Writes the default namespace to the stream
* @param namespaceURI the uri to bind the default namespace to
* @throws IllegalStateException if the current state does not allow Namespace writing
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeDefaultNamespace(String namespaceURI)
throws XMLStreamException;
@@ -358,7 +358,7 @@
/**
* Writes an xml comment with the data enclosed
* @param data the data contained in the comment, may be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeComment(String data)
throws XMLStreamException;
@@ -366,7 +366,7 @@
/**
* Writes a processing instruction
* @param target the target of the processing instruction, may not be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeProcessingInstruction(String target)
throws XMLStreamException;
@@ -375,7 +375,7 @@
* Writes a processing instruction
* @param target the target of the processing instruction, may not be null
* @param data the data contained in the processing instruction, may not be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeProcessingInstruction(String target,
String data)
@@ -384,7 +384,7 @@
/**
* Writes a CData section
* @param data the data contained in the CData Section, may not be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeCData(String data)
throws XMLStreamException;
@@ -394,7 +394,7 @@
* from the XML 1.0 specification.
*
* @param dtd the DTD to be written
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeDTD(String dtd)
throws XMLStreamException;
@@ -402,14 +402,14 @@
/**
* Writes an entity reference
* @param name the name of the entity
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeEntityRef(String name)
throws XMLStreamException;
/**
* Write the XML Declaration. Defaults the XML version to 1.0, and the encoding to utf-8
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeStartDocument()
throws XMLStreamException;
@@ -417,7 +417,7 @@
/**
* Write the XML Declaration. Defaults the XML version to 1.0
* @param version version of the xml document
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeStartDocument(String version)
throws XMLStreamException;
@@ -439,7 +439,7 @@
/**
* Write text to the output
* @param text the value to write
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeCharacters(String text)
throws XMLStreamException;
@@ -449,15 +449,16 @@
* @param text the value to write
* @param start the starting position in the array
* @param len the number of characters to write
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void writeCharacters(char[] text, int start, int len)
throws XMLStreamException;
/**
- * Gets the prefix the uri is bound to
+ * Gets the prefix the uri is bound to.
+ * @param uri the uri the prefix is bound to
* @return the prefix or null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public String getPrefix(String uri)
throws XMLStreamException;
@@ -469,7 +470,7 @@
* the prefix is bound in the root scope.
* @param prefix the prefix to bind to the uri, may not be null
* @param uri the uri to bind to the prefix, may be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void setPrefix(String prefix, String uri)
throws XMLStreamException;
@@ -482,7 +483,7 @@
* If this method is called before a START_ELEMENT has been written
* the uri is bound in the root scope.
* @param uri the uri to bind to the default namespace, may be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void setDefaultNamespace(String uri)
throws XMLStreamException;
@@ -499,7 +500,7 @@
* context it is treated as declared and the prefix may be used
* by the StreamWriter.
* @param context the namespace context to use for this writer, may not be null
- * @throws XMLStreamException
+ * @throws XMLStreamException if an error occurs
*/
public void setNamespaceContext(NamespaceContext context)
throws XMLStreamException;
--- old/src/java.xml/share/classes/javax/xml/stream/events/Attribute.java 2020-08-24 17:28:53.230130730 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/events/Attribute.java 2020-08-24 17:28:52.943116087 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -41,11 +41,13 @@
/**
* Returns the QName for this attribute
+ * @return the QName of the attribute
*/
QName getName();
/**
* Gets the normalized value of this attribute
+ * @return the value of the attribute
*/
public String getValue();
--- old/src/java.xml/share/classes/javax/xml/stream/events/Characters.java 2020-08-24 17:28:53.951167515 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/events/Characters.java 2020-08-24 17:28:53.663152821 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -40,6 +40,7 @@
public interface Characters extends XMLEvent {
/**
* Get the character data of this event
+ * @return the character data
*/
public String getData();
@@ -49,6 +50,7 @@
* is reported as CHARACTERS. This method allows
* checking of CHARACTERS events to see if they
* are composed of only whitespace characters
+ * @return true if the {@code Characters} are all whitespace, false otherwise
*/
public boolean isWhiteSpace();
@@ -60,6 +62,7 @@
* that are surrounded by non CDATA characters will be reported
* as a single Characters event. This method will return false
* in this case.
+ * @return true if it is {@code CDATA}, false otherwise
*/
public boolean isCData();
@@ -67,6 +70,7 @@
* Return true if this is ignorableWhiteSpace. If
* this event is ignorableWhiteSpace its event type will
* be SPACE.
+ * @return true if it is ignorable whitespace, false otherwise
*/
public boolean isIgnorableWhiteSpace();
--- old/src/java.xml/share/classes/javax/xml/stream/events/Comment.java 2020-08-24 17:28:54.641202718 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/events/Comment.java 2020-08-24 17:28:54.351187923 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -37,6 +37,7 @@
/**
* Return the string data of the comment, returns empty string if it
* does not exist
+ * @return the text content
*/
public String getText();
}
--- old/src/java.xml/share/classes/javax/xml/stream/events/EntityReference.java 2020-08-24 17:28:55.328237769 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/events/EntityReference.java 2020-08-24 17:28:55.043223228 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -48,6 +48,7 @@
/**
* Return the declaration of this entity.
+ * @return the declaration
*/
EntityDeclaration getDeclaration();
--- old/src/java.xml/share/classes/javax/xml/stream/events/Namespace.java 2020-08-24 17:28:56.020273074 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/events/Namespace.java 2020-08-24 17:28:55.735258534 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -41,16 +41,19 @@
/**
* Gets the prefix, returns "" if this is a default
* namespace declaration.
+ * @return the prefix
*/
public String getPrefix();
/**
* Gets the uri bound to the prefix of this namespace
+ * @return the {@code NamespaceURI}
*/
public String getNamespaceURI();
/**
* returns true if this attribute declares the default namespace
+ * @return true if this is default namespace, false otherwise
*/
public boolean isDefaultNamespaceDeclaration();
}
--- old/src/java.xml/share/classes/javax/xml/stream/events/NotationDeclaration.java 2020-08-24 17:28:56.714308482 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/events/NotationDeclaration.java 2020-08-24 17:28:56.424293686 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -40,16 +40,19 @@
public interface NotationDeclaration extends XMLEvent {
/**
* The notation name.
+ * @return the name
*/
String getName();
/**
* The notation's public identifier, or null if none was given.
+ * @return the public identifier
*/
String getPublicId();
/**
* The notation's system identifier, or null if none was given.
+ * @return the system identifier
*/
String getSystemId();
}
--- old/src/java.xml/share/classes/javax/xml/stream/events/StartDocument.java 2020-08-24 17:28:57.402343584 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/events/StartDocument.java 2020-08-24 17:28:57.116328992 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -46,8 +46,9 @@
public String getCharacterEncodingScheme();
/**
- * Returns true if CharacterEncodingScheme was set in
+ * Returns true if CharacterEncodingScheme is set in
* the encoding declaration of the document
+ * @return true if {@code CharacterEncodingScheme} is set, false otherwise
*/
public boolean encodingSet();
@@ -58,8 +59,9 @@
public boolean isStandalone();
/**
- * Returns true if the standalone attribute was set in
+ * Returns true if the standalone attribute is set in
* the encoding declaration of the document.
+ * @return true if the standalone attribute is set, false otherwise
*/
public boolean standaloneSet();
--- old/src/java.xml/share/classes/javax/xml/stream/events/XMLEvent.java 2020-08-24 17:28:58.094378889 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/events/XMLEvent.java 2020-08-24 17:28:57.809364349 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -51,6 +51,7 @@
/**
* Returns an integer code for this event.
+ * @return the event type
* @see #START_ELEMENT
* @see #END_ELEMENT
* @see #CHARACTERS
@@ -68,24 +69,28 @@
* Return the location of this event. The Location
* returned from this method is non-volatile and
* will retain its information.
+ * @return the location of the event
* @see javax.xml.stream.Location
*/
javax.xml.stream.Location getLocation();
/**
* A utility function to check if this event is a StartElement.
+ * @return true if the event is {@code StartElement}, false otherwise
* @see StartElement
*/
public boolean isStartElement();
/**
* A utility function to check if this event is an Attribute.
+ * @return true if the event is {@code Attribute}, false otherwise
* @see Attribute
*/
public boolean isAttribute();
/**
* A utility function to check if this event is a Namespace.
+ * @return true if the event is {@code Namespace}, false otherwise
* @see Namespace
*/
public boolean isNamespace();
@@ -93,36 +98,42 @@
/**
* A utility function to check if this event is a EndElement.
+ * @return true if the event is {@code EndElement}, false otherwise
* @see EndElement
*/
public boolean isEndElement();
/**
* A utility function to check if this event is an EntityReference.
+ * @return true if the event is {@code EntityReference}, false otherwise
* @see EntityReference
*/
public boolean isEntityReference();
/**
* A utility function to check if this event is a ProcessingInstruction.
+ * @return true if the event is {@code ProcessingInstruction}, false otherwise
* @see ProcessingInstruction
*/
public boolean isProcessingInstruction();
/**
* A utility function to check if this event is Characters.
+ * @return true if the event is {@code Characters}, false otherwise
* @see Characters
*/
public boolean isCharacters();
/**
* A utility function to check if this event is a StartDocument.
+ * @return true if the event is {@code StartDocument}, false otherwise
* @see StartDocument
*/
public boolean isStartDocument();
/**
* A utility function to check if this event is an EndDocument.
+ * @return true if the event is {@code EndDocument}, false otherwise
* @see EndDocument
*/
public boolean isEndDocument();
@@ -130,18 +141,21 @@
/**
* Returns this event as a start element event, may result in
* a class cast exception if this event is not a start element.
+ * @return a {@code StartElement} event
*/
public StartElement asStartElement();
/**
* Returns this event as an end element event, may result in
* a class cast exception if this event is not a end element.
+ * @return a {@code EndElement} event
*/
public EndElement asEndElement();
/**
* Returns this event as Characters, may result in
* a class cast exception if this event is not Characters.
+ * @return a {@code Characters} event
*/
public Characters asCharacters();
@@ -150,6 +164,7 @@
* optional type information about the associated event.
* It is optional and will return null if no information
* is available.
+ * @return the type of the event, null if not available
*/
public QName getSchemaType();
--- old/src/java.xml/share/classes/javax/xml/stream/util/XMLEventAllocator.java 2020-08-24 17:28:58.784414093 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/util/XMLEventAllocator.java 2020-08-24 17:28:58.499399552 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -47,6 +47,7 @@
/**
* This method creates an instance of the XMLEventAllocator. This
* allows the XMLInputFactory to allocate a new instance per reader.
+ * @return an instance of the {@code XMLEventAllocator}
*/
public XMLEventAllocator newInstance();
@@ -58,6 +59,7 @@
* must not modify the state of the XMLStreamReader.
* @param reader The XMLStreamReader to allocate from
* @return the event corresponding to the current reader state
+ * @throws XMLStreamException if an error occurs
*/
public XMLEvent allocate(XMLStreamReader reader)
throws XMLStreamException;
@@ -72,6 +74,7 @@
* This method may modify the state of the XMLStreamReader.
* @param reader The XMLStreamReader to allocate from
* @param consumer The XMLEventConsumer to add to.
+ * @throws XMLStreamException if an error occurs
*/
public void allocate(XMLStreamReader reader, XMLEventConsumer consumer)
throws XMLStreamException;
--- old/src/java.xml/share/classes/javax/xml/stream/util/XMLEventConsumer.java 2020-08-24 17:28:59.474449296 +0000
+++ new/src/java.xml/share/classes/javax/xml/stream/util/XMLEventConsumer.java 2020-08-24 17:28:59.189434756 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2009, 2020, 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
@@ -49,6 +49,7 @@
* is undefined.
*
* @param event the event to add, may not be null
+ * @throws XMLStreamException if there is an error in adding the event
*/
public void add(XMLEvent event)
throws XMLStreamException;
--- old/src/java.xml/share/classes/org/xml/sax/InputSource.java 2020-08-24 17:29:00.173484959 +0000
+++ new/src/java.xml/share/classes/org/xml/sax/InputSource.java 2020-08-24 17:28:59.885470265 +0000
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2020, 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
@@ -139,6 +139,7 @@
*
*
The character stream shall not include a byte order mark.
* + * @param characterStream the character stream * @see #setPublicId * @see #setSystemId * @see #setByteStream --- old/src/java.xml/share/classes/javax/xml/xpath/XPathException.java 2020-08-24 17:29:00.864520214 +0000 +++ new/src/java.xml/share/classes/javax/xml/xpath/XPathException.java 2020-08-24 17:29:00.577505571 +0000 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2020, 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 @@ -40,7 +40,9 @@ * @since 1.5 */ public class XPathException extends Exception { - + /** + * serializable fields + */ private static final ObjectStreamField[] serialPersistentFields = { new ObjectStreamField( "cause", Throwable.class ) }; --- old/src/java.xml/share/classes/org/xml/sax/SAXException.java 2020-08-24 17:29:01.551555264 +0000 +++ new/src/java.xml/share/classes/org/xml/sax/SAXException.java 2020-08-24 17:29:01.266540723 +0000 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2020, 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 @@ -166,6 +166,9 @@ // Internal state. ////////////////////////////////////////////////////////////////////// + /** + * serializable fields + */ private static final ObjectStreamField[] serialPersistentFields = { new ObjectStreamField( "exception", Exception.class ) }; --- old/src/java.xml/share/classes/org/xml/sax/helpers/NamespaceSupport.java 2020-08-24 17:29:02.249590876 +0000 +++ new/src/java.xml/share/classes/org/xml/sax/helpers/NamespaceSupport.java 2020-08-24 17:29:01.964576335 +0000 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2020, 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 @@ -487,6 +487,8 @@ * by {@link #processName processName()}. This may only be * changed before any contexts have been pushed. * + * @param value a flag indicating whether namespace declaration attributes + * are placed into the {@link #NSDECL NSDECL} namespace * @since 1.5, SAX 2.1alpha * * @exception IllegalStateException when attempting to set this @@ -511,6 +513,8 @@ * Returns true if namespace declaration attributes are placed into * a namespace. This behavior is not the default. * + * @return true if namespace declaration attributes are placed into a namespace, + * false otherwise * @since 1.5, SAX 2.1alpha */ public boolean isNamespaceDeclUris () --- old/src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java 2020-08-24 17:29:02.950626641 +0000 +++ new/src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java 2020-08-24 17:29:02.665612100 +0000 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -92,6 +92,7 @@ /** * Construct an XML filter with the specified parent. * + * @param parent the specified parent * @see #setParent * @see #getParent */ --- old/src/java.xml/share/classes/org/xml/sax/helpers/XMLReaderFactory.java 2020-08-24 17:29:03.649662303 +0000 +++ new/src/java.xml/share/classes/org/xml/sax/helpers/XMLReaderFactory.java 2020-08-24 17:29:03.358647456 +0000 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2020, 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 @@ -166,6 +166,7 @@ * the caller (perhaps an applet) is not permitted to load classes * dynamically. * + * @param className a class name * @return A new XML reader. * @exception org.xml.sax.SAXException If the class cannot be * loaded, instantiated, and cast to XMLReader.