8047723: @since tag cleanup in jaxp

Reviewed-by: joehw
This commit is contained in:
Henry Jen 2014-06-19 15:35:10 -07:00
parent 80bb4ab1c8
commit 52f6412c53
105 changed files with 204 additions and 143 deletions

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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
*/

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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
*/

View file

@ -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

View file

@ -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

View file

@ -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
*/

View file

@ -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
*/

View file

@ -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

View file

@ -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
*/

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -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
*/

View file

@ -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; }

View file

@ -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

View file

@ -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)
*/

View file

@ -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

View file

@ -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

View file

@ -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)
*/