--- old/src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java 2020-08-25 18:29:02.428876587 +0000 +++ new/src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java 2020-08-25 18:29:02.106860106 +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 */ @@ -152,9 +153,9 @@ * * @param name The feature name. * @param value The requested feature value. - * @exception org.xml.sax.SAXNotRecognizedException If the feature + * @throws org.xml.sax.SAXNotRecognizedException If the feature * value can't be assigned or retrieved from the parent. - * @exception org.xml.sax.SAXNotSupportedException When the + * @throws org.xml.sax.SAXNotSupportedException When the * parent recognizes the feature name but * cannot set the requested value. */ @@ -176,9 +177,9 @@ * * @param name The feature name. * @return The current value of the feature. - * @exception org.xml.sax.SAXNotRecognizedException If the feature + * @throws org.xml.sax.SAXNotRecognizedException If the feature * value can't be assigned or retrieved from the parent. - * @exception org.xml.sax.SAXNotSupportedException When the + * @throws org.xml.sax.SAXNotSupportedException When the * parent recognizes the feature name but * cannot determine its value at this time. */ @@ -200,9 +201,9 @@ * * @param name The property name. * @param value The requested property value. - * @exception org.xml.sax.SAXNotRecognizedException If the property + * @throws org.xml.sax.SAXNotRecognizedException If the property * value can't be assigned or retrieved from the parent. - * @exception org.xml.sax.SAXNotSupportedException When the + * @throws org.xml.sax.SAXNotSupportedException When the * parent recognizes the property name but * cannot set the requested value. */ @@ -222,9 +223,9 @@ * * @param name The property name. * @return The current value of the property. - * @exception org.xml.sax.SAXNotRecognizedException If the property + * @throws org.xml.sax.SAXNotRecognizedException If the property * value can't be assigned or retrieved from the parent. - * @exception org.xml.sax.SAXNotSupportedException When the + * @throws org.xml.sax.SAXNotSupportedException When the * parent recognizes the property name but * cannot determine its value at this time. */ @@ -331,9 +332,9 @@ * Parse a document. * * @param input The input source for the document entity. - * @exception org.xml.sax.SAXException Any SAX exception, possibly + * @throws org.xml.sax.SAXException Any SAX exception, possibly * wrapping another exception. - * @exception java.io.IOException An IO exception from the parser, + * @throws java.io.IOException An IO exception from the parser, * possibly from a byte stream or character stream * supplied by the application. */ @@ -349,9 +350,9 @@ * Parse a document. * * @param systemId The system identifier as a fully-qualified URI. - * @exception org.xml.sax.SAXException Any SAX exception, possibly + * @throws org.xml.sax.SAXException Any SAX exception, possibly * wrapping another exception. - * @exception java.io.IOException An IO exception from the parser, + * @throws java.io.IOException An IO exception from the parser, * possibly from a byte stream or character stream * supplied by the application. */ @@ -374,9 +375,9 @@ * @param publicId The entity's public identifier, or null. * @param systemId The entity's system identifier. * @return A new InputSource or null for the default. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. - * @exception java.io.IOException The client may throw an + * @throws java.io.IOException The client may throw an * I/O-related exception while obtaining the * new InputSource. */ @@ -403,7 +404,7 @@ * @param name The notation name. * @param publicId The notation's public identifier, or null. * @param systemId The notation's system identifier, or null. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void notationDecl (String name, String publicId, String systemId) @@ -422,7 +423,7 @@ * @param publicId The entity's public identifier, or null. * @param systemId The entity's system identifier, or null. * @param notationName The name of the associated notation. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void unparsedEntityDecl (String name, String publicId, @@ -459,7 +460,7 @@ /** * Filter a start document event. * - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void startDocument () @@ -474,7 +475,7 @@ /** * Filter an end document event. * - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void endDocument () @@ -491,7 +492,7 @@ * * @param prefix The Namespace prefix. * @param uri The Namespace URI. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void startPrefixMapping (String prefix, String uri) @@ -507,7 +508,7 @@ * Filter an end Namespace prefix mapping event. * * @param prefix The Namespace prefix. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void endPrefixMapping (String prefix) @@ -527,7 +528,7 @@ * @param qName The element's qualified (prefixed) name, or the empty * string. * @param atts The element's attributes. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void startElement (String uri, String localName, String qName, @@ -547,7 +548,7 @@ * @param localName The element's local name, or the empty string. * @param qName The element's qualified (prefixed) name, or the empty * string. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void endElement (String uri, String localName, String qName) @@ -565,7 +566,7 @@ * @param ch An array of characters. * @param start The starting position in the array. * @param length The number of characters to use from the array. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void characters (char ch[], int start, int length) @@ -583,7 +584,7 @@ * @param ch An array of characters. * @param start The starting position in the array. * @param length The number of characters to use from the array. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void ignorableWhitespace (char ch[], int start, int length) @@ -600,7 +601,7 @@ * * @param target The processing instruction target. * @param data The text following the target. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void processingInstruction (String target, String data) @@ -616,7 +617,7 @@ * Filter a skipped entity event. * * @param name The name of the skipped entity. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void skippedEntity (String name) @@ -638,7 +639,7 @@ * Filter a warning event. * * @param e The warning as an exception. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void warning (SAXParseException e) @@ -654,7 +655,7 @@ * Filter an error event. * * @param e The error as an exception. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void error (SAXParseException e) @@ -670,7 +671,7 @@ * Filter a fatal error event. * * @param e The error as an exception. - * @exception org.xml.sax.SAXException The client may throw + * @throws org.xml.sax.SAXException The client may throw * an exception during processing. */ public void fatalError (SAXParseException e)