Documentation & annotation update/cleanup on new files.

2012-11-25  Andrew John Hughes  <gnu_andrew@member.fsf.org>

	* javax/annotation/processing/Filer.java,
	* javax/annotation/processing/Messager.java,
	* javax/annotation/processing/ProcessingEnvironment.java,
	* javax/annotation/processing/RoundEnvironment.java,
	* javax/lang/model/SourceVersion.java,
	* javax/lang/model/element/Element.java,
	* javax/lang/model/element/ElementKind.java:
	Add authorship.
	* javax/lang/model/element/ElementVisitor.java:
	Add authorship and properly document type parameters.
	* javax/lang/model/element/TypeElement.java:
	Add authorship.
	* javax/lang/model/util/ElementFilter.java:
	Add authorship.
	(FilteredSet.add(E)): Add @Override.
	(FilteredSet.addAll(Collection)): Likewise.
	(FilteredSet.clear()): Likewise.
	(FilteredSet.contains(Object)): Likewise.
	(FilteredSet.containsAll(Collection)): Likewise.
	(FilteredSet.equals(Object)): Likewise.
	(FilteredSet.hashCode()): Likewise.
	(FilteredSet.isEmpty()): Likewise.
	(FilteredSet.iterator()): Likewise.
	(FilteredSet.remove(Object)): Likewise.
	(FilteredSet.removeAll(Collection)): Likewise.
	(FilteredSet.retainAll(Collection)): Likewise.
	(FilteredSet.size()): Likewise.
	(FilteredSet.toArray()): Likewise.
	(FilteredSet.toArray(T[])): Likewise.
	(FilteredIterator.hasNext()): Likewise.
	(FilteredIterator.next()): Likewise.
	(FilteredIterator.remove()): Likewise.
	* javax/lang/model/util/Elements.java,
	* javax/lang/model/util/Types.java:
	Add authorship.
	* javax/tools/ForwardingFileObject.java,
	* javax/tools/ForwardingJavaFileObject.java:
	Document type parameter.
	* javax/tools/StandardLocation.java:
	(ANNOTATION_PROCESSOR_PATH.isOutputLocation()):
	Add @Override annotation.
	(CLASS_OUTPUT.isOutputLocation()): Likewise.
	(CLASS_PATH.isOutputLocation()): Likewise.
	(PLATFORM_CLASS_PATH.isOutputLocation()): Likewise.
	(SOURCE_OUTPUT.isOutputLocation()): Likewise.
	(SOURCE_PATH.isOutputLocation()): Likewise.
	(getName()): Likewise.

Signed-off-by: Andrew John Hughes <gnu_andrew@member.fsf.org>

3 files changed, 9 insertions, 6 deletions

diff --git a/javax/tools/ForwardingFileObject.java b/javax/tools/ForwardingFileObject.java
index 33ba40caf..20eb75e84 100644
--- a/javax/tools/ForwardingFileObject.java
+++ b/javax/tools/ForwardingFileObject.java
@@ -48,6 +48,7 @@ import java.net.URI;
 /**
  * Forwards calls to a specified file object.
  *
+ * @param <F> the kind of object calls are forwarded to.
  * @author Andrew John Hughes (gnu_andrew@member.fsf.org)
  * @since 1.6
  */
diff --git a/javax/tools/ForwardingJavaFileObject.java b/javax/tools/ForwardingJavaFileObject.java
index a66990d24..fa058cc0d 100644
--- a/javax/tools/ForwardingJavaFileObject.java
+++ b/javax/tools/ForwardingJavaFileObject.java
@@ -40,6 +40,7 @@ package javax.tools;
 /**
  * Forwards calls to a specified {@link JavaFileObject}.
  *
+ * @param <F> the kind of object calls are forwarded to.
  * @author Andrew John Hughes (gnu_andrew@member.fsf.org)
  * @since 1.6
  */
diff --git a/javax/tools/StandardLocation.java b/javax/tools/StandardLocation.java
index f3d2cfb63..bb4b70299 100644
--- a/javax/tools/StandardLocation.java
+++ b/javax/tools/StandardLocation.java
@@ -53,17 +53,17 @@ public enum StandardLocation
   implements Location
 {
   /** Location where annotation processors are found. */
-  ANNOTATION_PROCESSOR_PATH { public boolean isOutputLocation() { return false; } },
+  ANNOTATION_PROCESSOR_PATH { @Override public boolean isOutputLocation() { return false; } },
   /** Location to write class files to. */
-  CLASS_OUTPUT { public boolean isOutputLocation() { return true; } },
+  CLASS_OUTPUT { @Override public boolean isOutputLocation() { return true; } },
   /** Location where class files are found. */
-  CLASS_PATH { public boolean isOutputLocation() { return false; } },
+  CLASS_PATH { @Override public boolean isOutputLocation() { return false; } },
   /** Location where platform class files are found. */
-  PLATFORM_CLASS_PATH { public boolean isOutputLocation() { return false; } },
+  PLATFORM_CLASS_PATH { @Override public boolean isOutputLocation() { return false; } },
   /** Location to write source files to. */
-  SOURCE_OUTPUT { public boolean isOutputLocation() { return true; } },
+  SOURCE_OUTPUT { @Override public boolean isOutputLocation() { return true; } },
   /** Location where source files are found. */
-  SOURCE_PATH { public boolean isOutputLocation() { return false; } };
+  SOURCE_PATH { @Override public boolean isOutputLocation() { return false; } };
   
   private static final ConcurrentMap<String,Location> locCache =
     new ConcurrentHashMap<String,Location>();
@@ -80,6 +80,7 @@ public enum StandardLocation
    *
    * @return the name of the location.
    */
+  @Override
   public String getName()
   {
     return name();