Upgrading to sax 2.0.1 (sax2r2) from http://sourceforge.net/projects/sax/ as per Edwin Goei.

git-svn-id: https://svn.apache.org/repos/asf/xml/commons/trunk@225961 13f79535-47bb-0310-9956-ffa450edef68

java/external/src/org/xml/sax/Attributes.java

@@ -1,5 +1,6 @@
 // Attributes.java - attribute list with Namespace support
-// Written by David Megginson, sax@megginson.com
+// http://www.saxproject.org
+// Written by David Megginson
 // NO WARRANTY!  This class is in the public domain.
 
 // $Id$
@@ -14,6 +15,8 @@ package org.xml.sax;
  * <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
@@ -30,7 +33,13 @@ package org.xml.sax;
  * contain attributes used as Namespace declarations (xmlns*) unless
  * the <code>http://xml.org/sax/features/namespace-prefixes</code> 
  * feature is set to <var>true</var> (it is <var>false</var> by 
- * default).</p>
+ * default).
+ * Because SAX2 conforms to the "Namespaces in XML" specification,
+ * it does not give namespace declaration attributes a namespace URI.
+ * Some other W3C specifications are in conflict with that, expecting
+ * these declarations to be in a namespace.
+ * Handler code may need to resolve that conflict.
+ * </p>
  *
  * <p>If the namespace-prefixes feature (see above) is <var>false</var>, 
  * access by qualified name may not be available; if the 
@@ -47,10 +56,10 @@ package org.xml.sax;
  * vary from implementation to implementation.</p>
  *
  * @since SAX 2.0
- * @author David Megginson, 
- *         <a href="mailto:sax@megginson.com">sax@megginson.com</a>
- * @version 2.0r2pre
- * @see org.xml.sax.helpers.AttributeListImpl
+ * @author David Megginson
+ * @version 2.0.1 (sax2r2)
+ * @see org.xml.sax.helpers.AttributesImpl
+ * @see org.xml.sax.ext.DeclHandler#attributeDecl
  */
 public interface Attributes
 {