Mercurial Mercurial > jdk-sandbox / changeset
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
8231083: Clarify SAX documentation
authorjoehw
Fri, 20 Sep 2019 22:11:45 +0000
changeset 58247 3aef3bccfae3
parent 58246 3c8f89e2ec03
child 58248 e6231dbaa862
8231083: Clarify SAX documentation Reviewed-by: lancea, alanb
src/java.xml/share/classes/org/xml/sax/AttributeList.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/Attributes.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ContentHandler.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/DTDHandler.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/DocumentHandler.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/EntityResolver.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ErrorHandler.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/HandlerBase.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/InputSource.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/Locator.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/Parser.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/SAXException.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/SAXNotRecognizedException.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/SAXNotSupportedException.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/SAXParseException.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/XMLFilter.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/XMLReader.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/Attributes2.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/Attributes2Impl.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/DeclHandler.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/DefaultHandler2.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/EntityResolver2.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/LexicalHandler.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/Locator2.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/Locator2Impl.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/ext/package-info.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/AttributeListImpl.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/AttributesImpl.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/DefaultHandler.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/LocatorImpl.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/NamespaceSupport.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/NewInstance.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/ParserAdapter.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/ParserFactory.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/XMLReaderAdapter.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/XMLReaderFactory.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/helpers/package-info.java file | annotate | diff | comparison | revisions
src/java.xml/share/classes/org/xml/sax/package-info.java file | annotate | diff | comparison | revisions 
--- a/src/java.xml/share/classes/org/xml/sax/AttributeList.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/AttributeList.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,23 +23,11 @@
  * questions.
  */
 
-// SAX Attribute List Interface.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: AttributeList.java,v 1.3 2004/11/03 22:44:51 jsuttor Exp $
-
 package org.xml.sax;
 
 /**
  * Interface for an element's attribute specifications.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This is the original SAX1 interface for reporting an element's
  * attributes.  Unlike the new {@link org.xml.sax.Attributes Attributes}
  * interface, it does not support Namespace-related information.
--- a/src/java.xml/share/classes/org/xml/sax/Attributes.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/Attributes.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,25 +23,12 @@
  * questions.
  */
 
-// Attributes.java - attribute list with Namespace support
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the public domain.
-// $Id: Attributes.java,v 1.2 2004/11/03 22:44:51 jsuttor Exp $
-
 package org.xml.sax;
 
 
 /**
  * Interface for a list of XML attributes.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This interface allows access to a list of attributes in
  * three different ways:</p>
  *
--- a/src/java.xml/share/classes/org/xml/sax/ContentHandler.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ContentHandler.java	Fri Sep 20 22:11:45 2019 +0000
@@ -23,25 +23,12 @@
  * questions.
  */
 
-// ContentHandler.java - handle main document content.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the public domain.
-// $Id: ContentHandler.java,v 1.2 2004/11/03 22:44:51 jsuttor Exp $
-
 package org.xml.sax;
 
 
 /**
  * Receive notification of the logical content of a document.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This is the main interface that most SAX applications
  * implement: if the application needs to be informed of basic parsing
  * events, it implements this interface and registers an instance with
--- a/src/java.xml/share/classes/org/xml/sax/DTDHandler.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/DTDHandler.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,23 +23,11 @@
  * questions.
  */
 
-// SAX DTD handler.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: DTDHandler.java,v 1.2 2004/11/03 22:44:51 jsuttor Exp $
-
 package org.xml.sax;
 
 /**
  * Receive notification of basic DTD-related events.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>If a SAX application needs information about notations and
  * unparsed entities, then the application implements this
  * interface and registers an instance with the SAX parser using
--- a/src/java.xml/share/classes/org/xml/sax/DocumentHandler.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/DocumentHandler.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,23 +23,11 @@
  * questions.
  */
 
-// SAX document handler.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: DocumentHandler.java,v 1.2 2004/11/03 22:44:51 jsuttor Exp $
-
 package org.xml.sax;
 
 /**
  * Receive notification of general document events.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This was the main event-handling interface for SAX1; in
  * SAX2, it has been replaced by {@link org.xml.sax.ContentHandler
  * ContentHandler}, which provides Namespace support and reporting
--- a/src/java.xml/share/classes/org/xml/sax/EntityResolver.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/EntityResolver.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// SAX entity resolver.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: EntityResolver.java,v 1.2 2004/11/03 22:44:52 jsuttor Exp $
-
 package org.xml.sax;
 
 import java.io.IOException;
@@ -36,13 +31,6 @@
 /**
  * Basic interface for resolving entities.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>If a SAX application needs to implement customized handling
  * for external entities, it must implement this interface and
  * register an instance with the SAX driver using the
--- a/src/java.xml/share/classes/org/xml/sax/ErrorHandler.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ErrorHandler.java	Fri Sep 20 22:11:45 2019 +0000
@@ -23,24 +23,12 @@
  * questions.
  */
 
-// SAX error handler.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: ErrorHandler.java,v 1.2 2004/11/03 22:44:52 jsuttor Exp $
-
 package org.xml.sax;
 
 
 /**
  * Basic interface for SAX error handlers.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>If a SAX application needs to implement customized error
  * handling, it must implement this interface and then register an
  * instance with the XML reader using the
--- a/src/java.xml/share/classes/org/xml/sax/HandlerBase.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/HandlerBase.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,24 +23,12 @@
  * questions.
  */
 
-// SAX default handler base class.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: HandlerBase.java,v 1.2 2005/06/10 03:50:47 jeffsuttor Exp $
-
 package org.xml.sax;
 
 /**
  * Default base class for handlers.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
- * <p>This class implements the default behaviour for four SAX1
+ * <p>This class implements the default behavior for four SAX1
  * interfaces: EntityResolver, DTDHandler, DocumentHandler,
  * and ErrorHandler.  It is now obsolete, but is included in SAX2 to
  * support legacy SAX1 applications.  SAX2 applications should use
--- a/src/java.xml/share/classes/org/xml/sax/InputSource.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/InputSource.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// SAX input source.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: InputSource.java,v 1.2 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 import java.io.IOException;
@@ -37,13 +32,6 @@
 /**
  * A single input source for an XML entity.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class allows a SAX application to encapsulate information
  * about an input source in a single object, which may include
  * a public identifier, a system identifier, a byte stream (possibly
--- a/src/java.xml/share/classes/org/xml/sax/Locator.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/Locator.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,24 +23,12 @@
  * questions.
  */
 
-// SAX locator interface for document events.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: Locator.java,v 1.2 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 
 /**
  * Interface for associating a SAX event with a document location.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>If a SAX parser provides location information to the SAX
  * application, it does so by implementing this interface and then
  * passing an instance to the application using the content
--- a/src/java.xml/share/classes/org/xml/sax/Parser.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/Parser.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// SAX parser interface.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: Parser.java,v 1.2 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 import java.io.IOException;
@@ -37,13 +32,6 @@
 /**
  * Basic interface for SAX (Simple API for XML) parsers.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This was the main event supplier interface for SAX1; it has
  * been replaced in SAX2 by {@link org.xml.sax.XMLReader XMLReader},
  * which includes Namespace support and sophisticated configurability
--- a/src/java.xml/share/classes/org/xml/sax/SAXException.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/SAXException.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// SAX exception class.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: SAXException.java,v 1.3 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 import java.io.IOException;
@@ -39,13 +34,6 @@
 /**
  * Encapsulate a general SAX error or warning.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class can contain basic error or warning information from
  * either the XML parser or the application: a parser writer or
  * application writer can subclass it to provide additional
--- a/src/java.xml/share/classes/org/xml/sax/SAXNotRecognizedException.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/SAXNotRecognizedException.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,25 +23,12 @@
  * questions.
  */
 
-// SAXNotRecognizedException.java - unrecognized feature or value.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the Public Domain.
-// $Id: SAXNotRecognizedException.java,v 1.3 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 
 /**
  * Exception class for an unrecognized identifier.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>An XMLReader will throw this exception when it finds an
  * unrecognized feature or property identifier; SAX applications and
  * extensions may use this class for other, similar purposes.</p>
--- a/src/java.xml/share/classes/org/xml/sax/SAXNotSupportedException.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/SAXNotSupportedException.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,24 +23,11 @@
  * questions.
  */
 
-// SAXNotSupportedException.java - unsupported feature or value.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the Public Domain.
-// $Id: SAXNotSupportedException.java,v 1.4 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 /**
  * Exception class for an unsupported operation.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>An XMLReader will throw this exception when it recognizes a
  * feature or property identifier, but cannot perform the requested
  * operation (setting a state or value).  Other SAX2 applications and
--- a/src/java.xml/share/classes/org/xml/sax/SAXParseException.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/SAXParseException.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,23 +23,11 @@
  * questions.
  */
 
-// SAX exception class.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: SAXParseException.java,v 1.2 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 /**
  * Encapsulate an XML parse error or warning.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This exception may include information for locating the error
  * in the original XML document, as if it came from a {@link Locator}
  * object.  Note that although the application
--- a/src/java.xml/share/classes/org/xml/sax/XMLFilter.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/XMLFilter.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,25 +23,12 @@
  * questions.
  */
 
-// XMLFilter.java - filter SAX2 events.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the Public Domain.
-// $Id: XMLFilter.java,v 1.2 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 
 /**
  * Interface for an XML filter.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>An XML filter is like an XML reader, except that it obtains its
  * events from another XML reader rather than a primary source like
  * an XML document or database.  Filters can modify a stream of
--- a/src/java.xml/share/classes/org/xml/sax/XMLReader.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/XMLReader.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,12 +23,6 @@
  * questions.
  */
 
-// XMLReader.java - read an XML document.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the Public Domain.
-// $Id: XMLReader.java,v 1.3 2004/11/03 22:55:32 jsuttor Exp $
-
 package org.xml.sax;
 
 import java.io.IOException;
@@ -37,17 +31,6 @@
 /**
  * Interface for reading an XML document using callbacks.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
- * <p><strong>Note:</strong> despite its name, this interface does
- * <em>not</em> extend the standard Java {@link java.io.Reader Reader}
- * interface, because reading XML is a fundamentally different activity
- * than reading character data.</p>
  *
  * <p>XMLReader is the interface that an XML parser's SAX2 driver must
  * implement.  This interface allows an application to set and
@@ -75,6 +58,11 @@
  * <p>There are adapters available to convert a SAX1 Parser to
  * a SAX2 XMLReader and vice-versa.</p>
  *
+ * @apiNote Despite its name, this interface does
+ * <em>not</em> extend the standard Java {@link java.io.Reader Reader}
+ * interface, because reading XML is a fundamentally different activity
+ * than reading character data.
+ *
  * @since 1.4, SAX 2.0
  * @author David Megginson
  * @see org.xml.sax.XMLFilter
--- a/src/java.xml/share/classes/org/xml/sax/ext/Attributes2.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/Attributes2.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2004, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// Attributes2.java - extended Attributes
-// http://www.saxproject.org
-// Public Domain: no warranty.
-// $Id: Attributes2.java,v 1.2 2004/11/03 22:49:07 jsuttor Exp $
-
 package org.xml.sax.ext;
 
 import org.xml.sax.Attributes;
@@ -35,18 +30,13 @@
 
 /**
  * SAX2 extension to augment the per-attribute information
- * provided though {@link Attributes}.
+ * provided through {@link Attributes}.
  * If an implementation supports this extension, the attributes
  * provided in {@link org.xml.sax.ContentHandler#startElement
  * ContentHandler.startElement() } will implement this interface,
  * and the <em>http://xml.org/sax/features/use-attributes2</em>
  * feature flag will have the value <em>true</em>.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * </blockquote>
- *
  * <p> XMLReader implementations are not required to support this
  * information, and it is not part of core-only SAX2 distributions.</p>
  *
--- a/src/java.xml/share/classes/org/xml/sax/ext/Attributes2Impl.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/Attributes2Impl.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2004, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// Attributes2Impl.java - extended AttributesImpl
-// http://www.saxproject.org
-// Public Domain: no warranty.
-// $Id: Attributes2Impl.java,v 1.3 2005/02/24 11:20:18 gg156739 Exp $
-
 package org.xml.sax.ext;
 
 import org.xml.sax.Attributes;
@@ -38,11 +33,6 @@
  * SAX2 extension helper for additional Attributes information,
  * implementing the {@link Attributes2} interface.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * </blockquote>
- *
  * <p>This is not part of core-only SAX2 distributions.</p>
  *
  * <p>The <em>specified</em> flag for each attribute will always
--- a/src/java.xml/share/classes/org/xml/sax/ext/DeclHandler.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/DeclHandler.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// DeclHandler.java - Optional handler for DTD declaration events.
-// http://www.saxproject.org
-// Public Domain: no warranty.
-// $Id: DeclHandler.java,v 1.2 2004/11/03 22:49:08 jsuttor Exp $
-
 package org.xml.sax.ext;
 
 import org.xml.sax.SAXException;
@@ -36,13 +31,6 @@
 /**
  * SAX2 extension handler for DTD declaration events.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This is an optional extension handler for SAX2 to provide more
  * complete information about DTD declarations in an XML document.
  * XML readers are not required to recognize this handler, and it
--- a/src/java.xml/share/classes/org/xml/sax/ext/DefaultHandler2.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/DefaultHandler2.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2004, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// DefaultHandler2.java - extended DefaultHandler
-// http://www.saxproject.org
-// Public Domain: no warranty.
-// $Id: DefaultHandler2.java,v 1.2 2004/11/03 22:49:08 jsuttor Exp $
-
 package org.xml.sax.ext;
 
 import java.io.IOException;
@@ -44,11 +39,6 @@
  * method the added handler methods just return.  Subclassers may
  * override everything on a method-by-method basis.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * </blockquote>
- *
  * <p> <em>Note:</em> this class might yet learn that the
  * <em>ContentHandler.setDocumentLocator()</em> call might be passed a
  * {@link Locator2} object, and that the
--- a/src/java.xml/share/classes/org/xml/sax/ext/EntityResolver2.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/EntityResolver2.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2004, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// EntityResolver2.java - Extended SAX entity resolver.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: EntityResolver2.java,v 1.2 2004/11/03 22:49:08 jsuttor Exp $
-
 package org.xml.sax.ext;
 
 import java.io.IOException;
@@ -48,11 +43,6 @@
  * method (in this interface) is used <em>instead of</em> the older (SAX 1.0)
  * {@link EntityResolver#resolveEntity EntityResolver.resolveEntity()} method.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * </blockquote>
- *
  * <p>If a SAX application requires the customized handling which this
  * interface defines for external entities, it must ensure that it uses
  * an XMLReader with the
--- a/src/java.xml/share/classes/org/xml/sax/ext/LexicalHandler.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/LexicalHandler.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// LexicalHandler.java - optional handler for lexical parse events.
-// http://www.saxproject.org
-// Public Domain: no warranty.
-// $Id: LexicalHandler.java,v 1.2 2004/11/03 22:49:08 jsuttor Exp $
-
 package org.xml.sax.ext;
 
 import org.xml.sax.SAXException;
@@ -35,13 +30,6 @@
 /**
  * SAX2 extension handler for lexical events.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This is an optional extension handler for SAX2 to provide
  * lexical information about an XML document, such as comments
  * and CDATA section boundaries.
--- a/src/java.xml/share/classes/org/xml/sax/ext/Locator2.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/Locator2.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2004, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// Locator2.java - extended Locator
-// http://www.saxproject.org
-// Public Domain: no warranty.
-// $Id: Locator2.java,v 1.2 2004/11/03 22:49:08 jsuttor Exp $
-
 package org.xml.sax.ext;
 
 import org.xml.sax.Locator;
@@ -35,7 +30,7 @@
 
 /**
  * SAX2 extension to augment the entity information provided
- * though a {@link Locator}.
+ * through a {@link Locator}.
  * If an implementation supports this extension, the Locator
  * provided in {@link org.xml.sax.ContentHandler#setDocumentLocator
  * ContentHandler.setDocumentLocator() } will implement this
@@ -43,11 +38,6 @@
  * <em>http://xml.org/sax/features/use-locator2</em> feature
  * flag will have the value <em>true</em>.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * </blockquote>
- *
  * <p> XMLReader implementations are not required to support this
  * information, and it is not part of core-only SAX2 distributions.</p>
  *
--- a/src/java.xml/share/classes/org/xml/sax/ext/Locator2Impl.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/Locator2Impl.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2004, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// Locator2Impl.java - extended LocatorImpl
-// http://www.saxproject.org
-// Public Domain: no warranty.
-// $Id: Locator2Impl.java,v 1.2 2004/11/03 22:49:08 jsuttor Exp $
-
 package org.xml.sax.ext;
 
 import org.xml.sax.Locator;
@@ -38,11 +33,6 @@
  * SAX2 extension helper for holding additional Entity information,
  * implementing the {@link Locator2} interface.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * </blockquote>
- *
  * <p> This is not part of core-only SAX2 distributions.</p>
  *
  * @since 1.5, SAX 2.0.2
--- a/src/java.xml/share/classes/org/xml/sax/ext/package-info.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/ext/package-info.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2015, 2019, 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
@@ -27,9 +27,6 @@
  * Provides interfaces to SAX2 facilities that
  * conformant SAX drivers won't necessarily support.
  *
- * <p>
- * See <a target='_top' href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for more information about SAX.
  *
  * <p>
  * This package is independent of the SAX2 core, though the functionality
@@ -66,6 +63,10 @@
  * As an example, most validation systems can be cleanly layered on top
  * of parsers supporting the standardized SAX2 interfaces.
  *
+ * @apiNote The SAX API, originally developed at
+ * <a href="http://www.saxproject.org">the SAX Project</a>,
+ * has been defined by Java SE since 1.4.
+ *
  * @since 1.4
  */
 
--- a/src/java.xml/share/classes/org/xml/sax/helpers/AttributeListImpl.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/AttributeListImpl.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// SAX default implementation for AttributeList.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: AttributeListImpl.java,v 1.2 2004/11/03 22:53:08 jsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import java.util.ArrayList;
@@ -38,13 +33,6 @@
 /**
  * Default implementation for AttributeList.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>AttributeList implements the deprecated SAX1 {@link
  * org.xml.sax.AttributeList AttributeList} interface, and has been
  * replaced by the new SAX2 {@link org.xml.sax.helpers.AttributesImpl
--- a/src/java.xml/share/classes/org/xml/sax/helpers/AttributesImpl.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/AttributesImpl.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,12 +23,6 @@
  * questions.
  */
 
-// AttributesImpl.java - default implementation of Attributes.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the public domain.
-// $Id: AttributesImpl.java,v 1.2 2004/11/03 22:53:08 jsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import org.xml.sax.Attributes;
@@ -37,13 +31,6 @@
 /**
  * Default implementation of the Attributes interface.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class provides a default implementation of the SAX2
  * {@link org.xml.sax.Attributes Attributes} interface, with the
  * addition of manipulators so that the list can be modified or
--- a/src/java.xml/share/classes/org/xml/sax/helpers/DefaultHandler.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/DefaultHandler.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2006, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,12 +23,6 @@
  * questions.
  */
 
-// DefaultHandler.java - default implementation of the core handlers.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the public domain.
-// $Id: DefaultHandler.java,v 1.3 2006/04/13 02:06:32 jeffsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import java.io.IOException;
@@ -47,13 +41,6 @@
 /**
  * Default base class for SAX2 event handlers.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class is available as a convenience base class for SAX2
  * applications: it provides default implementations for all of the
  * callbacks in the four core SAX2 handler classes:</p>
--- a/src/java.xml/share/classes/org/xml/sax/helpers/LocatorImpl.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/LocatorImpl.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// SAX default implementation for Locator.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: LocatorImpl.java,v 1.2 2004/11/03 22:53:09 jsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import org.xml.sax.Locator;
@@ -36,13 +31,6 @@
 /**
  * Provide an optional convenience implementation of Locator.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class is available mainly for application writers, who
  * can use it to make a persistent snapshot of a locator at any
  * point during a document parse:</p>
--- a/src/java.xml/share/classes/org/xml/sax/helpers/NamespaceSupport.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/NamespaceSupport.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,12 +23,6 @@
  * questions.
  */
 
-// NamespaceSupport.java - generic Namespace support for SAX.
-// http://www.saxproject.org
-// Written by David Megginson
-// This class is in the Public Domain.  NO WARRANTY!
-// $Id: NamespaceSupport.java,v 1.5 2004/11/03 22:53:09 jsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import java.util.ArrayList;
@@ -44,13 +38,6 @@
  * Encapsulate Namespace logic for use by applications using SAX,
  * or internally by SAX drivers.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class encapsulates the logic of Namespace processing: it
  * tracks the declarations currently in force for each context and
  * automatically processes qualified XML names into their Namespace
--- a/src/java.xml/share/classes/org/xml/sax/helpers/NewInstance.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/NewInstance.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2001, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2001, 2019, 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
@@ -23,13 +23,6 @@
  * questions.
  */
 
-// NewInstance.java - create a new instance of a class by name.
-// http://www.saxproject.org
-// Written by Edwin Goei, edwingo@apache.org
-// and by David Brownell, dbrownell@users.sourceforge.net
-// NO WARRANTY!  This class is in the Public Domain.
-// $Id: NewInstance.java,v 1.2 2005/06/10 03:50:50 jeffsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import java.lang.reflect.InvocationTargetException;
@@ -38,12 +31,6 @@
 /**
  * Create a new instance of a class by name.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
  *
  * <p>This class contains a static method for creating an instance of a
  * class from an explicit class name.  It tries to use the thread's context
--- a/src/java.xml/share/classes/org/xml/sax/helpers/ParserAdapter.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/ParserAdapter.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,12 +23,6 @@
  * questions.
  */
 
-// ParserAdapter.java - adapt a SAX1 Parser to a SAX2 XMLReader.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the public domain.
-// $Id: ParserAdapter.java,v 1.3 2004/11/03 22:53:09 jsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import java.io.IOException;
@@ -56,13 +50,6 @@
 /**
  * Adapt a SAX1 Parser as a SAX2 XMLReader.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class wraps a SAX1 {@link org.xml.sax.Parser Parser}
  * and makes it act as a SAX2 {@link org.xml.sax.XMLReader XMLReader},
  * with feature, property, and Namespace support.  Note
--- a/src/java.xml/share/classes/org/xml/sax/helpers/ParserFactory.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/ParserFactory.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,11 +23,6 @@
  * questions.
  */
 
-// SAX parser factory.
-// http://www.saxproject.org
-// No warranty; no copyright -- use this as you will.
-// $Id: ParserFactory.java,v 1.2 2004/11/03 22:53:09 jsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import jdk.xml.internal.SecuritySupport;
@@ -35,13 +30,6 @@
 /**
  * Java-specific class for dynamically loading SAX parsers.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p><strong>Note:</strong> This class is designed to work with the now-deprecated
  * SAX1 {@link org.xml.sax.Parser Parser} class.  SAX2 applications should use
  * {@link org.xml.sax.helpers.XMLReaderFactory XMLReaderFactory} instead.</p>
--- a/src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/XMLFilterImpl.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,12 +23,6 @@
  * questions.
  */
 
-// XMLFilterImpl.java - base SAX2 filter implementation.
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the Public Domain.
-// $Id: XMLFilterImpl.java,v 1.3 2004/11/03 22:53:09 jsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import java.io.IOException;
@@ -51,13 +45,6 @@
 /**
  * Base class for deriving an XML filter.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class is designed to sit between an {@link org.xml.sax.XMLReader
  * XMLReader} and the client application's event handlers.  By default, it
  * does nothing but pass requests up to the reader and events
--- a/src/java.xml/share/classes/org/xml/sax/helpers/XMLReaderAdapter.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/XMLReaderAdapter.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,12 +23,6 @@
  * questions.
  */
 
-// XMLReaderAdapter.java - adapt an SAX2 XMLReader to a SAX1 Parser
-// http://www.saxproject.org
-// Written by David Megginson
-// NO WARRANTY!  This class is in the public domain.
-// $Id: XMLReaderAdapter.java,v 1.3 2004/11/03 22:53:09 jsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import java.io.IOException;
@@ -53,13 +47,6 @@
 /**
  * Adapt a SAX2 XMLReader as a SAX1 Parser.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class wraps a SAX2 {@link org.xml.sax.XMLReader XMLReader}
  * and makes it act as a SAX1 {@link org.xml.sax.Parser Parser}.  The XMLReader
  * must support a true value for the
--- a/src/java.xml/share/classes/org/xml/sax/helpers/XMLReaderFactory.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/XMLReaderFactory.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, 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
@@ -23,13 +23,6 @@
  * questions.
  */
 
-// XMLReaderFactory.java - factory for creating a new reader.
-// http://www.saxproject.org
-// Written by David Megginson
-// and by David Brownell
-// NO WARRANTY!  This class is in the Public Domain.
-// $Id: XMLReaderFactory.java,v 1.2.2.1 2005/07/31 22:48:08 jeffsuttor Exp $
-
 package org.xml.sax.helpers;
 
 import java.io.BufferedReader;
@@ -50,13 +43,6 @@
 /**
  * Factory for creating an XML reader.
  *
- * <blockquote>
- * <em>This module, both source code and documentation, is in the
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
- * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for further information.
- * </blockquote>
- *
  * <p>This class contains static methods for creating an XML reader
  * from an explicit class name, or based on runtime defaults:
  *
--- a/src/java.xml/share/classes/org/xml/sax/helpers/package-info.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/helpers/package-info.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2015, 2019, 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
@@ -28,9 +28,9 @@
  * Provides helper classes, including
  * support for bootstrapping SAX-based applications.
  *
- * <p>
- * See <a target='_top' href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for more information about SAX.
+ * @apiNote The SAX API, originally developed at
+ * <a href="http://www.saxproject.org">the SAX Project</a>,
+ * has been defined by Java SE since 1.4.
  *
  * @since 1.4
  */
--- a/src/java.xml/share/classes/org/xml/sax/package-info.java	Fri Sep 20 21:33:24 2019 +0000
+++ b/src/java.xml/share/classes/org/xml/sax/package-info.java	Fri Sep 20 22:11:45 2019 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2015, 2019, 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
@@ -24,16 +24,10 @@
  */
 
 /**
- * Provides the core SAX APIs.
- * Some SAX1 APIs are deprecated to encourage integration of
- * namespace-awareness into designs of new applications
- * and into maintenance of existing infrastructure.
+ * Provides the interfaces for the Simple API for XML (SAX). Supports both
+ * the SAX1 and SAX2 APIs.
  *
  * <p>
- * See <a target='_top' href='http://www.saxproject.org'>http://www.saxproject.org</a>
- * for more information about SAX.
- *
- *
  * <h2> SAX2 Standard Feature Flags </h2>
  *
  * <p>
@@ -330,6 +324,9 @@
  * All of these standard properties are optional.
  * XMLReader implementations are not required to support them.
  *
+ * @apiNote The SAX API, originally developed at
+ * <a href="http://www.saxproject.org">the SAX Project</a>,
+ * has been defined by Java SE since 1.4.
  *
  * @since 1.4
  */
jdk-sandbox