Clean up remaining doclint errors and warnings.

Throughout dspace-sword I was baffled by the validation aspect, so
you'll see lots of "UNKNOWN.  PLEASE DOCUMENT." that I wrote just to
shut doclint up.  If you know how this works, please amend my
placeholders.

dspace-api/src/main/java/org/dspace/eperson/EPerson.java

@@ -104,8 +104,8 @@ public class EPerson extends DSpaceObject implements DSpaceObjectLegacySupport
     /**
      * Return true if this object equals obj, false otherwise.
      * 
-     * @param obj
-     * @return true if ResourcePolicy objects are equal
+     * @param obj another EPerson.
+     * @return true if EPerson objects are equal in ID, email, and full name
      */
     @Override
     public boolean equals(Object obj)