From 0d71e6a3f021d07f856dacee46621b4351151cc6 Mon Sep 17 00:00:00 2001
From: Arjen Poutsma <apoutsma@vmware.com>
Date: Thu, 16 Aug 2007 22:38:31 +0000
Subject: [PATCH] Added @since tags.

---
 .../main/java/org/springframework/xml/JaxpVersion.java   | 1 +
 .../main/java/org/springframework/xml/XmlException.java  | 1 +
 .../org/springframework/xml/dom/DomContentHandler.java   | 1 +
 .../org/springframework/xml/namespace/QNameEditor.java   | 1 +
 .../org/springframework/xml/namespace/QNameUtils.java    | 1 +
 .../xml/namespace/SimpleNamespaceContext.java            | 9 +++------
 .../org/springframework/xml/sax/AbstractXmlReader.java   | 1 +
 .../main/java/org/springframework/xml/sax/SaxUtils.java  | 1 +
 .../xml/stream/AbstractStaxContentHandler.java           | 1 +
 .../xml/stream/AbstractStaxXmlReader.java                | 1 +
 .../xml/stream/AbstractXmlStreamReader.java              | 1 +
 .../xml/stream/StaxEventContentHandler.java              | 1 +
 .../springframework/xml/stream/StaxEventXmlReader.java   | 1 +
 .../xml/stream/StaxStreamContentHandler.java             | 1 +
 .../springframework/xml/stream/StaxStreamXmlReader.java  | 1 +
 .../springframework/xml/stream/XmlEventStreamReader.java | 1 +
 .../springframework/xml/transform/ResourceSource.java    | 1 +
 .../org/springframework/xml/transform/StaxResult.java    | 1 +
 .../org/springframework/xml/transform/StaxSource.java    | 1 +
 .../org/springframework/xml/transform/StringResult.java  | 6 ++----
 .../org/springframework/xml/transform/StringSource.java  | 2 +-
 .../xml/transform/TransformerObjectSupport.java          | 1 +
 .../xml/validation/Jaxp10ValidatorFactory.java           | 5 ++---
 .../xml/validation/Jaxp13ValidatorFactory.java           | 5 ++---
 .../xml/validation/SchemaLoaderUtils.java                | 5 ++---
 .../xml/validation/XmlValidationException.java           | 1 +
 .../org/springframework/xml/validation/XmlValidator.java | 4 ++--
 .../xml/validation/XmlValidatorFactory.java              | 1 +
 .../springframework/xml/xpath/AbstractXPathTemplate.java | 1 +
 .../xml/xpath/JaxenXPathExpressionFactory.java           | 1 +
 .../springframework/xml/xpath/JaxenXPathTemplate.java    | 1 +
 .../xml/xpath/Jaxp13XPathExpressionFactory.java          | 1 +
 .../springframework/xml/xpath/Jaxp13XPathTemplate.java   | 1 +
 .../springframework/xml/xpath/NodeCallbackHandler.java   | 1 +
 .../java/org/springframework/xml/xpath/NodeMapper.java   | 1 +
 .../org/springframework/xml/xpath/XPathException.java    | 1 +
 .../org/springframework/xml/xpath/XPathExpression.java   | 1 +
 .../xml/xpath/XPathExpressionFactory.java                | 1 +
 .../xml/xpath/XPathExpressionFactoryBean.java            | 1 +
 .../org/springframework/xml/xpath/XPathOperations.java   | 1 +
 .../springframework/xml/xpath/XPathParseException.java   | 1 +
 41 files changed, 48 insertions(+), 22 deletions(-)

diff --git a/xml/src/main/java/org/springframework/xml/JaxpVersion.java b/xml/src/main/java/org/springframework/xml/JaxpVersion.java
index b9d610f6..14c6deed 100644
--- a/xml/src/main/java/org/springframework/xml/JaxpVersion.java
+++ b/xml/src/main/java/org/springframework/xml/JaxpVersion.java
@@ -26,6 +26,7 @@ import org.springframework.util.ClassUtils;
  * classes.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public abstract class JaxpVersion {
 
diff --git a/xml/src/main/java/org/springframework/xml/XmlException.java b/xml/src/main/java/org/springframework/xml/XmlException.java
index d70fbdfd..61b2dab1 100644
--- a/xml/src/main/java/org/springframework/xml/XmlException.java
+++ b/xml/src/main/java/org/springframework/xml/XmlException.java
@@ -22,6 +22,7 @@ import org.springframework.core.NestedRuntimeException;
  * Root of the hierarchy of XML exception.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public abstract class XmlException extends NestedRuntimeException {
 
diff --git a/xml/src/main/java/org/springframework/xml/dom/DomContentHandler.java b/xml/src/main/java/org/springframework/xml/dom/DomContentHandler.java
index 05dbc3fc..a1e35b49 100644
--- a/xml/src/main/java/org/springframework/xml/dom/DomContentHandler.java
+++ b/xml/src/main/java/org/springframework/xml/dom/DomContentHandler.java
@@ -34,6 +34,7 @@ import org.xml.sax.helpers.DefaultHandler;
  *
  * @author Arjen Poutsma
  * @see org.w3c.dom.Node
+ * @since 1.0
  */
 public class DomContentHandler extends DefaultHandler {
 
diff --git a/xml/src/main/java/org/springframework/xml/namespace/QNameEditor.java b/xml/src/main/java/org/springframework/xml/namespace/QNameEditor.java
index f6df3bde..e240728d 100644
--- a/xml/src/main/java/org/springframework/xml/namespace/QNameEditor.java
+++ b/xml/src/main/java/org/springframework/xml/namespace/QNameEditor.java
@@ -43,6 +43,7 @@ import org.springframework.util.StringUtils;
  * @see javax.xml.namespace.QName
  * @see javax.xml.namespace.QName#toString()
  * @see javax.xml.namespace.QName#valueOf(String)
+ * @since 1.0
  */
 public class QNameEditor extends PropertyEditorSupport {
 
diff --git a/xml/src/main/java/org/springframework/xml/namespace/QNameUtils.java b/xml/src/main/java/org/springframework/xml/namespace/QNameUtils.java
index 686884c3..03e2d253 100644
--- a/xml/src/main/java/org/springframework/xml/namespace/QNameUtils.java
+++ b/xml/src/main/java/org/springframework/xml/namespace/QNameUtils.java
@@ -27,6 +27,7 @@ import org.w3c.dom.Node;
  *
  * @author Arjen Poutsma
  * @see javax.xml.namespace.QName
+ * @since 1.0
  */
 public abstract class QNameUtils {
 
diff --git a/xml/src/main/java/org/springframework/xml/namespace/SimpleNamespaceContext.java b/xml/src/main/java/org/springframework/xml/namespace/SimpleNamespaceContext.java
index 509fbd62..d16e8bf6 100644
--- a/xml/src/main/java/org/springframework/xml/namespace/SimpleNamespaceContext.java
+++ b/xml/src/main/java/org/springframework/xml/namespace/SimpleNamespaceContext.java
@@ -33,14 +33,13 @@ import org.springframework.util.Assert;
  * <code>java.util.Properties</code> object
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public class SimpleNamespaceContext implements NamespaceContext {
 
     private Map prefixToNamespaceUri = new HashMap();
 
-    /**
-     * Maps a <code>String</code> namespaceUri to a <code>List</code> of prefixes
-     */
+    /** Maps a <code>String</code> namespaceUri to a <code>List</code> of prefixes */
     private Map namespaceUriToPrefixes = new HashMap();
 
     private String defaultNamespaceUri = "";
@@ -110,9 +109,7 @@ public class SimpleNamespaceContext implements NamespaceContext {
         }
     }
 
-    /**
-     * Removes all declared prefixes.
-     */
+    /** Removes all declared prefixes. */
     public void clear() {
         prefixToNamespaceUri.clear();
     }
diff --git a/xml/src/main/java/org/springframework/xml/sax/AbstractXmlReader.java b/xml/src/main/java/org/springframework/xml/sax/AbstractXmlReader.java
index 7f7484c5..73be78fd 100644
--- a/xml/src/main/java/org/springframework/xml/sax/AbstractXmlReader.java
+++ b/xml/src/main/java/org/springframework/xml/sax/AbstractXmlReader.java
@@ -33,6 +33,7 @@ import org.xml.sax.ext.LexicalHandler;
  * @see #setDTDHandler(org.xml.sax.DTDHandler)
  * @see #setEntityResolver(org.xml.sax.EntityResolver)
  * @see #setErrorHandler(org.xml.sax.ErrorHandler)
+ * @since 1.0
  */
 public abstract class AbstractXmlReader implements XMLReader {
 
diff --git a/xml/src/main/java/org/springframework/xml/sax/SaxUtils.java b/xml/src/main/java/org/springframework/xml/sax/SaxUtils.java
index 2c734eb1..d84e911e 100644
--- a/xml/src/main/java/org/springframework/xml/sax/SaxUtils.java
+++ b/xml/src/main/java/org/springframework/xml/sax/SaxUtils.java
@@ -25,6 +25,7 @@ import org.xml.sax.InputSource;
  * Convenient utility methods for dealing with SAX.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public abstract class SaxUtils {
 
diff --git a/xml/src/main/java/org/springframework/xml/stream/AbstractStaxContentHandler.java b/xml/src/main/java/org/springframework/xml/stream/AbstractStaxContentHandler.java
index 3cbdefd1..220f20df 100644
--- a/xml/src/main/java/org/springframework/xml/stream/AbstractStaxContentHandler.java
+++ b/xml/src/main/java/org/springframework/xml/stream/AbstractStaxContentHandler.java
@@ -31,6 +31,7 @@ import org.xml.sax.SAXException;
  * namespace context is used to keep track of declared namespaces.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public abstract class AbstractStaxContentHandler implements ContentHandler {
 
diff --git a/xml/src/main/java/org/springframework/xml/stream/AbstractStaxXmlReader.java b/xml/src/main/java/org/springframework/xml/stream/AbstractStaxXmlReader.java
index dee6b15e..6f21d558 100644
--- a/xml/src/main/java/org/springframework/xml/stream/AbstractStaxXmlReader.java
+++ b/xml/src/main/java/org/springframework/xml/stream/AbstractStaxXmlReader.java
@@ -34,6 +34,7 @@ import org.xml.sax.SAXParseException;
  * @see #setDTDHandler(org.xml.sax.DTDHandler)
  * @see #setEntityResolver(org.xml.sax.EntityResolver)
  * @see #setErrorHandler(org.xml.sax.ErrorHandler)
+ * @since 1.0
  */
 public abstract class AbstractStaxXmlReader extends AbstractXmlReader {
 
diff --git a/xml/src/main/java/org/springframework/xml/stream/AbstractXmlStreamReader.java b/xml/src/main/java/org/springframework/xml/stream/AbstractXmlStreamReader.java
index b244f627..de89f581 100644
--- a/xml/src/main/java/org/springframework/xml/stream/AbstractXmlStreamReader.java
+++ b/xml/src/main/java/org/springframework/xml/stream/AbstractXmlStreamReader.java
@@ -27,6 +27,7 @@ import org.springframework.util.Assert;
  * Abstract base class for <code>XMLStreamReader</code>s.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public abstract class AbstractXmlStreamReader implements XMLStreamReader {
 
diff --git a/xml/src/main/java/org/springframework/xml/stream/StaxEventContentHandler.java b/xml/src/main/java/org/springframework/xml/stream/StaxEventContentHandler.java
index f32454ab..6f92f7f4 100644
--- a/xml/src/main/java/org/springframework/xml/stream/StaxEventContentHandler.java
+++ b/xml/src/main/java/org/springframework/xml/stream/StaxEventContentHandler.java
@@ -40,6 +40,7 @@ import org.xml.sax.Locator;
  * @author Arjen Poutsma
  * @see XMLEvent
  * @see XMLEventConsumer
+ * @since 1.0
  */
 public class StaxEventContentHandler extends AbstractStaxContentHandler {
 
diff --git a/xml/src/main/java/org/springframework/xml/stream/StaxEventXmlReader.java b/xml/src/main/java/org/springframework/xml/stream/StaxEventXmlReader.java
index 3fb75ac5..24944752 100644
--- a/xml/src/main/java/org/springframework/xml/stream/StaxEventXmlReader.java
+++ b/xml/src/main/java/org/springframework/xml/stream/StaxEventXmlReader.java
@@ -45,6 +45,7 @@ import org.xml.sax.helpers.AttributesImpl;
  * @see #setDTDHandler(org.xml.sax.DTDHandler)
  * @see #setEntityResolver(org.xml.sax.EntityResolver)
  * @see #setErrorHandler(org.xml.sax.ErrorHandler)
+ * @since 1.0
  */
 public class StaxEventXmlReader extends AbstractStaxXmlReader {
 
diff --git a/xml/src/main/java/org/springframework/xml/stream/StaxStreamContentHandler.java b/xml/src/main/java/org/springframework/xml/stream/StaxStreamContentHandler.java
index 09bc9375..f107976c 100644
--- a/xml/src/main/java/org/springframework/xml/stream/StaxStreamContentHandler.java
+++ b/xml/src/main/java/org/springframework/xml/stream/StaxStreamContentHandler.java
@@ -32,6 +32,7 @@ import org.xml.sax.Locator;
  *
  * @author Arjen Poutsma
  * @see XMLStreamWriter
+ * @since 1.0
  */
 public class StaxStreamContentHandler extends AbstractStaxContentHandler {
 
diff --git a/xml/src/main/java/org/springframework/xml/stream/StaxStreamXmlReader.java b/xml/src/main/java/org/springframework/xml/stream/StaxStreamXmlReader.java
index 5d9397ff..b72da7ef 100644
--- a/xml/src/main/java/org/springframework/xml/stream/StaxStreamXmlReader.java
+++ b/xml/src/main/java/org/springframework/xml/stream/StaxStreamXmlReader.java
@@ -36,6 +36,7 @@ import org.xml.sax.helpers.AttributesImpl;
  * @see #setDTDHandler(org.xml.sax.DTDHandler)
  * @see #setEntityResolver(org.xml.sax.EntityResolver)
  * @see #setErrorHandler(org.xml.sax.ErrorHandler)
+ * @since 1.0
  */
 public class StaxStreamXmlReader extends AbstractStaxXmlReader {
 
diff --git a/xml/src/main/java/org/springframework/xml/stream/XmlEventStreamReader.java b/xml/src/main/java/org/springframework/xml/stream/XmlEventStreamReader.java
index 1ec62eee..666f2fb7 100644
--- a/xml/src/main/java/org/springframework/xml/stream/XmlEventStreamReader.java
+++ b/xml/src/main/java/org/springframework/xml/stream/XmlEventStreamReader.java
@@ -34,6 +34,7 @@ import javax.xml.stream.events.XMLEvent;
  * vice-versa.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public class XmlEventStreamReader extends AbstractXmlStreamReader {
 
diff --git a/xml/src/main/java/org/springframework/xml/transform/ResourceSource.java b/xml/src/main/java/org/springframework/xml/transform/ResourceSource.java
index 20ceb4b3..6dc2ea70 100644
--- a/xml/src/main/java/org/springframework/xml/transform/ResourceSource.java
+++ b/xml/src/main/java/org/springframework/xml/transform/ResourceSource.java
@@ -27,6 +27,7 @@ import org.springframework.xml.sax.SaxUtils;
  * set via the constructor.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public class ResourceSource extends SAXSource {
 
diff --git a/xml/src/main/java/org/springframework/xml/transform/StaxResult.java b/xml/src/main/java/org/springframework/xml/transform/StaxResult.java
index ce80cc8f..c34f03f4 100644
--- a/xml/src/main/java/org/springframework/xml/transform/StaxResult.java
+++ b/xml/src/main/java/org/springframework/xml/transform/StaxResult.java
@@ -43,6 +43,7 @@ import org.xml.sax.ContentHandler;
  * @see XMLEventWriter
  * @see XMLStreamWriter
  * @see javax.xml.transform.Transformer
+ * @since 1.0
  */
 public class StaxResult extends SAXResult {
 
diff --git a/xml/src/main/java/org/springframework/xml/transform/StaxSource.java b/xml/src/main/java/org/springframework/xml/transform/StaxSource.java
index db08b5a4..fa590a0d 100644
--- a/xml/src/main/java/org/springframework/xml/transform/StaxSource.java
+++ b/xml/src/main/java/org/springframework/xml/transform/StaxSource.java
@@ -43,6 +43,7 @@ import org.xml.sax.XMLReader;
  * @see XMLEventReader
  * @see XMLStreamReader
  * @see javax.xml.transform.Transformer
+ * @since 1.0
  */
 public class StaxSource extends SAXSource {
 
diff --git a/xml/src/main/java/org/springframework/xml/transform/StringResult.java b/xml/src/main/java/org/springframework/xml/transform/StringResult.java
index 3b7a748c..78d6b77b 100644
--- a/xml/src/main/java/org/springframework/xml/transform/StringResult.java
+++ b/xml/src/main/java/org/springframework/xml/transform/StringResult.java
@@ -17,7 +17,6 @@
 package org.springframework.xml.transform;
 
 import java.io.StringWriter;
-
 import javax.xml.transform.stream.StreamResult;
 
 /**
@@ -26,6 +25,7 @@ import javax.xml.transform.stream.StreamResult;
  *
  * @author Arjen Poutsma
  * @see #toString()
+ * @since 1.0
  */
 public class StringResult extends StreamResult {
 
@@ -33,9 +33,7 @@ public class StringResult extends StreamResult {
         super(new StringWriter());
     }
 
-    /**
-     * Returns the written XML as a string.
-     */
+    /** Returns the written XML as a string. */
     public String toString() {
         return getWriter().toString();
     }
diff --git a/xml/src/main/java/org/springframework/xml/transform/StringSource.java b/xml/src/main/java/org/springframework/xml/transform/StringSource.java
index 44368385..e4d6af74 100644
--- a/xml/src/main/java/org/springframework/xml/transform/StringSource.java
+++ b/xml/src/main/java/org/springframework/xml/transform/StringSource.java
@@ -17,7 +17,6 @@
 package org.springframework.xml.transform;
 
 import java.io.StringReader;
-
 import javax.xml.transform.stream.StreamSource;
 
 /**
@@ -25,6 +24,7 @@ import javax.xml.transform.stream.StreamSource;
  * can be set via the constructor.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public class StringSource extends StreamSource {
 
diff --git a/xml/src/main/java/org/springframework/xml/transform/TransformerObjectSupport.java b/xml/src/main/java/org/springframework/xml/transform/TransformerObjectSupport.java
index 6021e490..143a0dd8 100644
--- a/xml/src/main/java/org/springframework/xml/transform/TransformerObjectSupport.java
+++ b/xml/src/main/java/org/springframework/xml/transform/TransformerObjectSupport.java
@@ -34,6 +34,7 @@ import org.apache.commons.logging.LogFactory;
  * @author Arjen Poutsma
  * @see Transformer
  * @see #createTransformer()
+ * @since 1.0
  */
 public abstract class TransformerObjectSupport {
 
diff --git a/xml/src/main/java/org/springframework/xml/validation/Jaxp10ValidatorFactory.java b/xml/src/main/java/org/springframework/xml/validation/Jaxp10ValidatorFactory.java
index 7a1ca08b..67422316 100644
--- a/xml/src/main/java/org/springframework/xml/validation/Jaxp10ValidatorFactory.java
+++ b/xml/src/main/java/org/springframework/xml/validation/Jaxp10ValidatorFactory.java
@@ -43,6 +43,7 @@ import org.xml.sax.helpers.DefaultHandler;
  * Internal class that uses JAXP 1.0 features to create <code>XmlValidator</code> instances.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 abstract class Jaxp10ValidatorFactory {
 
@@ -154,9 +155,7 @@ abstract class Jaxp10ValidatorFactory {
         }
     }
 
-    /**
-     * <code>DefaultHandler</code> extension that stores errors and fatal errors in a list.
-     */
+    /** <code>DefaultHandler</code> extension that stores errors and fatal errors in a list. */
     private static class ValidationErrorHandler extends DefaultHandler {
 
         private List errors = new ArrayList();
diff --git a/xml/src/main/java/org/springframework/xml/validation/Jaxp13ValidatorFactory.java b/xml/src/main/java/org/springframework/xml/validation/Jaxp13ValidatorFactory.java
index 4b4f0191..8e04c6c6 100644
--- a/xml/src/main/java/org/springframework/xml/validation/Jaxp13ValidatorFactory.java
+++ b/xml/src/main/java/org/springframework/xml/validation/Jaxp13ValidatorFactory.java
@@ -31,6 +31,7 @@ import org.xml.sax.SAXParseException;
  * Internal class that uses JAXP 1.0 features to create <code>XmlValidator</code> instances.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 abstract class Jaxp13ValidatorFactory {
 
@@ -66,9 +67,7 @@ abstract class Jaxp13ValidatorFactory {
         }
     }
 
-    /**
-     * <code>ErrorHandler</code> implementation that stores errors and fatal errors in a list.
-     */
+    /** <code>ErrorHandler</code> implementation that stores errors and fatal errors in a list. */
     private static class ValidationErrorHandler implements ErrorHandler {
 
         private List errors = new ArrayList();
diff --git a/xml/src/main/java/org/springframework/xml/validation/SchemaLoaderUtils.java b/xml/src/main/java/org/springframework/xml/validation/SchemaLoaderUtils.java
index 9b2d86f0..aab603d0 100644
--- a/xml/src/main/java/org/springframework/xml/validation/SchemaLoaderUtils.java
+++ b/xml/src/main/java/org/springframework/xml/validation/SchemaLoaderUtils.java
@@ -31,6 +31,7 @@ import org.xml.sax.SAXException;
  * handling of input streams.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public abstract class SchemaLoaderUtils {
 
@@ -85,9 +86,7 @@ public abstract class SchemaLoaderUtils {
         }
     }
 
-    /**
-     * Retrieves the URL from the given resource as System ID. Returns <code>null</code> if it cannot be openened.
-     */
+    /** Retrieves the URL from the given resource as System ID. Returns <code>null</code> if it cannot be openened. */
     public static String getSystemId(Resource resource) {
         try {
             return resource.getURL().toString();
diff --git a/xml/src/main/java/org/springframework/xml/validation/XmlValidationException.java b/xml/src/main/java/org/springframework/xml/validation/XmlValidationException.java
index 9280f5e8..579876d1 100644
--- a/xml/src/main/java/org/springframework/xml/validation/XmlValidationException.java
+++ b/xml/src/main/java/org/springframework/xml/validation/XmlValidationException.java
@@ -22,6 +22,7 @@ import org.springframework.xml.XmlException;
  * Expection thrown when a validation error occurs
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public class XmlValidationException extends XmlException {
 
diff --git a/xml/src/main/java/org/springframework/xml/validation/XmlValidator.java b/xml/src/main/java/org/springframework/xml/validation/XmlValidator.java
index 5201fa3f..0c6e14e2 100644
--- a/xml/src/main/java/org/springframework/xml/validation/XmlValidator.java
+++ b/xml/src/main/java/org/springframework/xml/validation/XmlValidator.java
@@ -17,7 +17,6 @@
 package org.springframework.xml.validation;
 
 import java.io.IOException;
-
 import javax.xml.transform.Source;
 
 import org.xml.sax.SAXParseException;
@@ -29,7 +28,8 @@ import org.xml.sax.SAXParseException;
  * <code>XmlValidator</code> instances are designed to be thread safe.
  *
  * @author Arjen Poutsma
- * @see XmlValidatorFactory#createValidator(org.springframework.core.io.Resource, String)
+ * @see XmlValidatorFactory#createValidator(org.springframework.core.io.Resource,String)
+ * @since 1.0
  */
 public interface XmlValidator {
 
diff --git a/xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java b/xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java
index f8b06dda..71e8e75a 100644
--- a/xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java
+++ b/xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java
@@ -33,6 +33,7 @@ import org.springframework.xml.JaxpVersion;
  *
  * @author Arjen Poutsma
  * @see XmlValidator
+ * @since 1.0
  */
 public abstract class XmlValidatorFactory {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/AbstractXPathTemplate.java b/xml/src/main/java/org/springframework/xml/xpath/AbstractXPathTemplate.java
index 09f81d86..ebd4e0d1 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/AbstractXPathTemplate.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/AbstractXPathTemplate.java
@@ -31,6 +31,7 @@ import org.w3c.dom.Node;
  * Abstract base class for implementations of {@link XPathOperations}. Contains a namespaces property.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public abstract class AbstractXPathTemplate extends TransformerObjectSupport implements XPathOperations {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/JaxenXPathExpressionFactory.java b/xml/src/main/java/org/springframework/xml/xpath/JaxenXPathExpressionFactory.java
index bca4597e..a62e7158 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/JaxenXPathExpressionFactory.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/JaxenXPathExpressionFactory.java
@@ -32,6 +32,7 @@ import org.w3c.dom.Node;
  *
  * @author Arjen Poutsma
  * @see #createXPathExpression(String)
+ * @since 1.0
  */
 abstract class JaxenXPathExpressionFactory {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/JaxenXPathTemplate.java b/xml/src/main/java/org/springframework/xml/xpath/JaxenXPathTemplate.java
index fa618fe7..c04d2195 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/JaxenXPathTemplate.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/JaxenXPathTemplate.java
@@ -36,6 +36,7 @@ import org.w3c.dom.Node;
  *
  * @author Arjen Poutsma
  * @see <a href="http://www.jaxen.org/">Jaxen</a>
+ * @since 1.0
  */
 public class JaxenXPathTemplate extends AbstractXPathTemplate {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/Jaxp13XPathExpressionFactory.java b/xml/src/main/java/org/springframework/xml/xpath/Jaxp13XPathExpressionFactory.java
index f0cac8c2..41e465ce 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/Jaxp13XPathExpressionFactory.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/Jaxp13XPathExpressionFactory.java
@@ -35,6 +35,7 @@ import org.w3c.dom.NodeList;
  *
  * @author Arjen Poutsma
  * @see #createXPathExpression(String)
+ * @since 1.0
  */
 abstract class Jaxp13XPathExpressionFactory {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/Jaxp13XPathTemplate.java b/xml/src/main/java/org/springframework/xml/xpath/Jaxp13XPathTemplate.java
index 3e2223d8..eaef9006 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/Jaxp13XPathTemplate.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/Jaxp13XPathTemplate.java
@@ -44,6 +44,7 @@ import org.xml.sax.InputSource;
  *
  * @author Arjen Poutsma
  * @see #setNamespaces(java.util.Properties)
+ * @since 1.0
  */
 public class Jaxp13XPathTemplate extends AbstractXPathTemplate {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/NodeCallbackHandler.java b/xml/src/main/java/org/springframework/xml/xpath/NodeCallbackHandler.java
index 3462486c..13eeb60f 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/NodeCallbackHandler.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/NodeCallbackHandler.java
@@ -29,6 +29,7 @@ import org.w3c.dom.Node;
  *
  * @author Arjen Poutsma
  * @see XPathOperations#evaluate(String,javax.xml.transform.Source,NodeCallbackHandler)
+ * @since 1.0
  */
 public interface NodeCallbackHandler {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/NodeMapper.java b/xml/src/main/java/org/springframework/xml/xpath/NodeMapper.java
index 8122b3b1..89d9546a 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/NodeMapper.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/NodeMapper.java
@@ -29,6 +29,7 @@ import org.w3c.dom.Node;
  * @see XPathOperations#evaluateAsObject(String,javax.xml.transform.Source,NodeMapper)
  * @see XPathExpression#evaluate(org.w3c.dom.Node,NodeMapper)
  * @see XPathExpression#evaluateAsObject(org.w3c.dom.Node,NodeMapper)
+ * @since 1.0
  */
 public interface NodeMapper {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/XPathException.java b/xml/src/main/java/org/springframework/xml/xpath/XPathException.java
index d9f2f673..5be63400 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/XPathException.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/XPathException.java
@@ -22,6 +22,7 @@ import org.springframework.xml.XmlException;
  * Exception thrown when an error occurs during XPath processing.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public class XPathException extends XmlException {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/XPathExpression.java b/xml/src/main/java/org/springframework/xml/xpath/XPathExpression.java
index ac50bb49..57189649 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/XPathExpression.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/XPathExpression.java
@@ -28,6 +28,7 @@ import org.w3c.dom.Node;
  * used by {@link XPathOperations} implementations.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public interface XPathExpression {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/XPathExpressionFactory.java b/xml/src/main/java/org/springframework/xml/xpath/XPathExpressionFactory.java
index 3052142c..010724d4 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/XPathExpressionFactory.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/XPathExpressionFactory.java
@@ -34,6 +34,7 @@ import org.springframework.xml.JaxpVersion;
  *
  * @author Arjen Poutsma
  * @see XPathExpression
+ * @since 1.0
  */
 public abstract class XPathExpressionFactory {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/XPathExpressionFactoryBean.java b/xml/src/main/java/org/springframework/xml/xpath/XPathExpressionFactoryBean.java
index af13e1df..30bdad6b 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/XPathExpressionFactoryBean.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/XPathExpressionFactoryBean.java
@@ -30,6 +30,7 @@ import org.springframework.util.Assert;
  *
  * @author Arjen Poutsma
  * @see #setExpression(String)
+ * @since 1.0
  */
 public class XPathExpressionFactoryBean implements FactoryBean, InitializingBean {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/XPathOperations.java b/xml/src/main/java/org/springframework/xml/xpath/XPathOperations.java
index 2dabf5a9..98000417 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/XPathOperations.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/XPathOperations.java
@@ -31,6 +31,7 @@ import org.w3c.dom.Node;
  * @author Arjen Poutsma
  * @see Jaxp13XPathTemplate
  * @see JaxenXPathTemplate
+ * @since 1.0
  */
 public interface XPathOperations {
 
diff --git a/xml/src/main/java/org/springframework/xml/xpath/XPathParseException.java b/xml/src/main/java/org/springframework/xml/xpath/XPathParseException.java
index cbe1cebe..f078f4c2 100644
--- a/xml/src/main/java/org/springframework/xml/xpath/XPathParseException.java
+++ b/xml/src/main/java/org/springframework/xml/xpath/XPathParseException.java
@@ -20,6 +20,7 @@ package org.springframework.xml.xpath;
  * Exception throws when a XPath expression cannot be parsed.
  *
  * @author Arjen Poutsma
+ * @since 1.0
  */
 public class XPathParseException extends XPathException {