OpenJDK / jdk / jdk
changeset 56330:3aef3bccfae3
8231083: Clarify SAX documentation
Reviewed-by: lancea, alanb
line wrap: on
line diff
--- 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 */