mirror of
https://github.com/openjdk/jdk.git
synced 2025-09-22 03:54:33 +02:00
8047723: @since tag cleanup in jaxp
Reviewed-by: joehw
This commit is contained in:
parent
80bb4ab1c8
commit
52f6412c53
105 changed files with 204 additions and 143 deletions
|
@ -88,7 +88,7 @@ package org.xml.sax;
|
|||
* @deprecated This interface has been replaced by the SAX2
|
||||
* {@link org.xml.sax.Attributes Attributes}
|
||||
* interface, which includes Namespace support.
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.DocumentHandler#startElement startElement
|
||||
* @see org.xml.sax.helpers.AttributeListImpl AttributeListImpl
|
||||
|
|
|
@ -85,7 +85,7 @@ package org.xml.sax;
|
|||
* <p>The order of attributes in the list is unspecified, and will
|
||||
* vary from implementation to implementation.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.helpers.AttributesImpl
|
||||
* @see org.xml.sax.ext.DeclHandler#attributeDecl
|
||||
|
|
|
@ -73,7 +73,7 @@ package org.xml.sax;
|
|||
* anyway, so the user should consider this a feature rather than a
|
||||
* bug.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.XMLReader
|
||||
* @see org.xml.sax.DTDHandler
|
||||
|
|
|
@ -67,7 +67,7 @@ package org.xml.sax;
|
|||
* obtained through this interface to find the entity and/or
|
||||
* notation corresponding with the attribute value.</p>
|
||||
*
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.XMLReader#setDTDHandler
|
||||
*/
|
||||
|
|
|
@ -62,7 +62,7 @@ package org.xml.sax;
|
|||
* @deprecated This interface has been replaced by the SAX2
|
||||
* {@link org.xml.sax.ContentHandler ContentHandler}
|
||||
* interface, which includes Namespace support.
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.Parser#setDocumentHandler
|
||||
* @see org.xml.sax.Locator
|
||||
|
|
|
@ -85,7 +85,7 @@ import java.io.IOException;
|
|||
* identifiers to local URIs or to look up replacements in a catalog
|
||||
* (possibly by using the public identifier).</p>
|
||||
*
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.XMLReader#setEntityResolver
|
||||
* @see org.xml.sax.InputSource
|
||||
|
|
|
@ -65,7 +65,7 @@ package org.xml.sax;
|
|||
* For example, {@link XMLReader#parse XMLReader.parse()} would throw
|
||||
* an IOException for errors accessing entities or the document.</p>
|
||||
*
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.XMLReader#setErrorHandler
|
||||
* @see org.xml.sax.SAXParseException
|
||||
|
|
|
@ -59,7 +59,7 @@ package org.xml.sax;
|
|||
* interface. It has been replaced by the SAX2
|
||||
* {@link org.xml.sax.helpers.DefaultHandler DefaultHandler}
|
||||
* class.
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.EntityResolver
|
||||
* @see org.xml.sax.DTDHandler
|
||||
|
|
|
@ -74,7 +74,7 @@ import java.io.InputStream;
|
|||
* so applications should not attempt to re-use such streams after they
|
||||
* have been handed to a parser. </p>
|
||||
*
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.XMLReader#parse(org.xml.sax.InputSource)
|
||||
* @see org.xml.sax.EntityResolver#resolveEntity
|
||||
|
|
|
@ -62,7 +62,7 @@ package org.xml.sax;
|
|||
* event, the application should assume that a locator is not
|
||||
* available.</p>
|
||||
*
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.ContentHandler#setDocumentLocator
|
||||
*/
|
||||
|
|
|
@ -64,7 +64,7 @@ import java.util.Locale;
|
|||
* @deprecated This interface has been replaced by the SAX2
|
||||
* {@link org.xml.sax.XMLReader XMLReader}
|
||||
* interface, which includes Namespace support.
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.EntityResolver
|
||||
* @see org.xml.sax.DTDHandler
|
||||
|
|
|
@ -54,7 +54,7 @@ package org.xml.sax;
|
|||
* specific location in an XML document, it should use the
|
||||
* {@link org.xml.sax.SAXParseException SAXParseException} subclass.</p>
|
||||
*
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @version 2.0.1 (sax2r2)
|
||||
* @see org.xml.sax.SAXParseException
|
||||
|
|
|
@ -46,7 +46,7 @@ package org.xml.sax;
|
|||
* unrecognized feature or property identifier; SAX applications and
|
||||
* extensions may use this class for other, similar purposes.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.SAXNotSupportedException
|
||||
*/
|
||||
|
|
|
@ -46,7 +46,7 @@ package org.xml.sax;
|
|||
* operation (setting a state or value). Other SAX2 applications and
|
||||
* extensions may use this class for similar purposes.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.SAXNotRecognizedException
|
||||
*/
|
||||
|
|
|
@ -52,7 +52,7 @@ package org.xml.sax;
|
|||
* <p>Since this exception is a subclass of {@link org.xml.sax.SAXException
|
||||
* SAXException}, it inherits the ability to wrap another exception.</p>
|
||||
*
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @version 2.0.1 (sax2r2)
|
||||
* @see org.xml.sax.SAXException
|
||||
|
|
|
@ -53,7 +53,7 @@ package org.xml.sax;
|
|||
* {@link org.xml.sax.ContentHandler ContentHandler} and {@link org.xml.sax.ErrorHandler
|
||||
* ErrorHandler} events automatically.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.helpers.XMLFilterImpl
|
||||
*/
|
||||
|
|
|
@ -75,7 +75,7 @@ import java.io.IOException;
|
|||
* <p>There are adapters available to convert a SAX1 Parser to
|
||||
* a SAX2 XMLReader and vice-versa.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.XMLFilter
|
||||
* @see org.xml.sax.helpers.ParserAdapter
|
||||
|
|
|
@ -57,7 +57,7 @@ import org.xml.sax.Attributes;
|
|||
* must have been declared.
|
||||
* </p>
|
||||
*
|
||||
* @since SAX 2.0 (extensions 1.1 alpha)
|
||||
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
|
||||
* @author David Brownell
|
||||
*/
|
||||
public interface Attributes2 extends Attributes
|
||||
|
|
|
@ -56,7 +56,7 @@ import org.xml.sax.helpers.AttributesImpl;
|
|||
* its <em>declared</em> flag to match.
|
||||
* </p>
|
||||
*
|
||||
* @since SAX 2.0 (extensions 1.1 alpha)
|
||||
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
|
||||
* @author David Brownell
|
||||
*/
|
||||
public class Attributes2Impl extends AttributesImpl implements Attributes2
|
||||
|
|
|
@ -66,7 +66,7 @@ import org.xml.sax.SAXException;
|
|||
* {@link org.xml.sax.SAXNotRecognizedException SAXNotRecognizedException}
|
||||
* when you attempt to register the handler.</p>
|
||||
*
|
||||
* @since SAX 2.0 (extensions 1.0)
|
||||
* @since 1.4, SAX 2.0 (extensions 1.0)
|
||||
* @author David Megginson
|
||||
*/
|
||||
public interface DeclHandler
|
||||
|
|
|
@ -55,7 +55,7 @@ import org.xml.sax.helpers.DefaultHandler;
|
|||
* <em>ContentHandler.startElement()</em> call might be passed a
|
||||
* {@link Attributes2} object.
|
||||
*
|
||||
* @since SAX 2.0 (extensions 1.1 alpha)
|
||||
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
|
||||
* @author David Brownell
|
||||
*/
|
||||
public class DefaultHandler2 extends DefaultHandler
|
||||
|
|
|
@ -80,7 +80,7 @@ import org.xml.sax.SAXException;
|
|||
*
|
||||
* @see org.xml.sax.XMLReader#setEntityResolver
|
||||
*
|
||||
* @since SAX 2.0 (extensions 1.1 alpha)
|
||||
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
|
||||
* @author David Brownell
|
||||
*/
|
||||
public interface EntityResolver2 extends EntityResolver
|
||||
|
|
|
@ -62,7 +62,7 @@ import org.xml.sax.SAXException;
|
|||
* {@link org.xml.sax.SAXNotRecognizedException SAXNotRecognizedException}
|
||||
* when you attempt to register the handler.</p>
|
||||
*
|
||||
* @since SAX 2.0 (extensions 1.0)
|
||||
* @since 1.4, SAX 2.0 (extensions 1.0)
|
||||
* @author David Megginson
|
||||
*/
|
||||
public interface LexicalHandler
|
||||
|
|
|
@ -51,7 +51,7 @@ import org.xml.sax.Locator;
|
|||
* <p> XMLReader implementations are not required to support this
|
||||
* information, and it is not part of core-only SAX2 distributions.</p>
|
||||
*
|
||||
* @since SAX 2.0 (extensions 1.1 alpha)
|
||||
* @since 1.5, SAX 2.0 (extensions 1.1 alpha)
|
||||
* @author David Brownell
|
||||
*/
|
||||
public interface Locator2 extends Locator
|
||||
|
|
|
@ -45,7 +45,7 @@ import org.xml.sax.helpers.LocatorImpl;
|
|||
*
|
||||
* <p> This is not part of core-only SAX2 distributions.</p>
|
||||
*
|
||||
* @since SAX 2.0.2
|
||||
* @since 1.5, SAX 2.0.2
|
||||
* @author David Brownell
|
||||
*/
|
||||
public class Locator2Impl extends LocatorImpl implements Locator2
|
||||
|
|
|
@ -82,7 +82,7 @@ import java.util.Vector;
|
|||
* which is implemented in the
|
||||
* {@link org.xml.sax.helpers.AttributesImpl
|
||||
* AttributesImpl} helper class.
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.AttributeList
|
||||
* @see org.xml.sax.DocumentHandler#startElement
|
||||
|
|
|
@ -64,7 +64,7 @@ import org.xml.sax.Attributes;
|
|||
* AttributeList} interface, it also includes a much more efficient
|
||||
* implementation using a single array rather than a set of Vectors.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
*/
|
||||
public class AttributesImpl implements Attributes
|
||||
|
|
|
@ -73,7 +73,7 @@ import org.xml.sax.SAXParseException;
|
|||
* <p>This class replaces the deprecated SAX1
|
||||
* {@link org.xml.sax.HandlerBase HandlerBase} class.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson,
|
||||
* @see org.xml.sax.EntityResolver
|
||||
* @see org.xml.sax.DTDHandler
|
||||
|
|
|
@ -69,7 +69,7 @@ import org.xml.sax.Locator;
|
|||
* is more efficient to provide location information only when
|
||||
* requested, rather than constantly updating a Locator object.</p>
|
||||
*
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.Locator Locator
|
||||
*/
|
||||
|
|
|
@ -90,7 +90,7 @@ import java.util.Vector;
|
|||
* Applications must track namespace information themselves if they
|
||||
* want to use namespace information.
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
*/
|
||||
public class NamespaceSupport
|
||||
|
@ -126,7 +126,7 @@ public class NamespaceSupport
|
|||
* <em>xmlns</em> and <em>xmlns:*</em> attributes, which are used to
|
||||
* declare namespaces. </p>
|
||||
*
|
||||
* @since SAX 2.1alpha
|
||||
* @since 1.5, SAX 2.1alpha
|
||||
* @see #setNamespaceDeclUris
|
||||
* @see #isNamespaceDeclUris
|
||||
*/
|
||||
|
@ -497,7 +497,7 @@ public class NamespaceSupport
|
|||
* by {@link #processName processName()}. This may only be
|
||||
* changed before any contexts have been pushed.
|
||||
*
|
||||
* @since SAX 2.1alpha
|
||||
* @since 1.5, SAX 2.1alpha
|
||||
*
|
||||
* @exception IllegalStateException when attempting to set this
|
||||
* after any context has been pushed.
|
||||
|
@ -521,7 +521,7 @@ public class NamespaceSupport
|
|||
* Returns true if namespace declaration attributes are placed into
|
||||
* a namespace. This behavior is not the default.
|
||||
*
|
||||
* @since SAX 2.1alpha
|
||||
* @since 1.5, SAX 2.1alpha
|
||||
*/
|
||||
public boolean isNamespaceDeclUris ()
|
||||
{ return namespaceDeclUris; }
|
||||
|
|
|
@ -72,7 +72,7 @@ import org.xml.sax.SAXNotSupportedException;
|
|||
* <p>This adapter does not test for duplicate Namespace-qualified
|
||||
* attribute names.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @version 2.0.1 (sax2r2)
|
||||
* @see org.xml.sax.helpers.XMLReaderAdapter
|
||||
|
|
|
@ -61,7 +61,7 @@ import org.xml.sax.Parser;
|
|||
* @deprecated This class works with the deprecated
|
||||
* {@link org.xml.sax.Parser Parser}
|
||||
* interface.
|
||||
* @since SAX 1.0
|
||||
* @since 1.4, SAX 1.0
|
||||
* @author David Megginson
|
||||
* @version 2.0.1 (sax2r2)
|
||||
*/
|
||||
|
|
|
@ -65,7 +65,7 @@ import org.xml.sax.SAXNotRecognizedException;
|
|||
* specific methods to modify the event stream or the configuration
|
||||
* requests as they pass through.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.XMLFilter
|
||||
* @see org.xml.sax.XMLReader
|
||||
|
|
|
@ -68,7 +68,7 @@ import org.xml.sax.SAXNotSupportedException;
|
|||
* supports a false value for the http://xml.org/sax/features/namespaces
|
||||
* property, that will also be used to improve efficiency.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson
|
||||
* @see org.xml.sax.Parser
|
||||
* @see org.xml.sax.XMLReader
|
||||
|
|
|
@ -67,7 +67,7 @@ import org.xml.sax.SAXException;
|
|||
* nothing bound its class name to <code>org.xml.sax.driver</code> so
|
||||
* those configuration mechanisms would see it.</p>
|
||||
*
|
||||
* @since SAX 2.0
|
||||
* @since 1.4, SAX 2.0
|
||||
* @author David Megginson, David Brownell
|
||||
* @version 2.0.1 (sax2r2)
|
||||
*/
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue