Fixing JavaDoc issues
diff --git a/api/src/main/java/org/apache/sling/cms/CurrentUser.java b/api/src/main/java/org/apache/sling/cms/CurrentUser.java
index 6362f20..292e61b 100644
--- a/api/src/main/java/org/apache/sling/cms/CurrentUser.java
+++ b/api/src/main/java/org/apache/sling/cms/CurrentUser.java
@@ -27,7 +27,7 @@
      * Gets a collection of all of the groups this user belongs to including
      * containing groups.
      * 
-     * @return
+     * @return the groups the user belongs to
      */
     public Collection<String> getGroups();
 
diff --git a/api/src/main/java/org/apache/sling/cms/FileMetadataExtractor.java b/api/src/main/java/org/apache/sling/cms/FileMetadataExtractor.java
index 54a709e..9e485b6 100644
--- a/api/src/main/java/org/apache/sling/cms/FileMetadataExtractor.java
+++ b/api/src/main/java/org/apache/sling/cms/FileMetadataExtractor.java
@@ -31,9 +31,9 @@
      * Extract the metadata from the specified file and return the resulting
      * metadata
      * 
-     * @param file
+     * @param file the file from which to extract the metadata
      * @return the metadata from the file
-     * @throws IOException
+     * @throws IOException an exception occurs extracting the metadata
      */
     Map<String,Object> extractMetadata(File file) throws IOException;
 
@@ -42,7 +42,7 @@
      * the jcr:content/metadata node of the file resource
      * 
      * @param file the file to extract the metadata from
-     * @throws IOException
+     * @throws IOException an exception occurs updating the metadata
      */
     void updateMetadata(File file) throws IOException;
 
@@ -51,9 +51,9 @@
      * the jcr:content/metadata node of the file resource
      * 
      * @param file the file to extract the metadata from
-     * @param save if true, persist the results, if not leave the changes
+     * @param persist if true, persist the results, if not leave the changes
      *             unpersisted
-     * @throws IOException
+     * @throws IOException an exception occurs updating the metadata
      */
     void updateMetadata(File file, boolean persist) throws IOException;
 }