package edu.northwestern.bioinformatics.studycalendar.domain;

/**
 * @author Rhett Sutphin
 * @see edu.northwestern.bioinformatics.studycalendar.utils.NamedComparator
 */
public interface Named {
    /**
     * Get the name for this instance, either set explicitly or computed.
     * @return
     */
    String getName();

    /**
     * Set the name.  This is an optional operation; if an implementor uses a computed
     * name, it should throw {@link UnsupportedOperationException}.
     * @param name
     */
    void setName(String name);
}

package edu.northwestern.bioinformatics.studycalendar.domain;

/**
 * @author Rhett Sutphin
 */
public interface Named {
    String getName();
    void setName(String name);
}

--- 
+++ 
@@ -2,8 +2,19 @@
 
 /**
  * @author Rhett Sutphin
+ * @see edu.northwestern.bioinformatics.studycalendar.utils.NamedComparator
  */
 public interface Named {
+    /**
+     * Get the name for this instance, either set explicitly or computed.
+     * @return
+     */
     String getName();
+
+    /**
+     * Set the name.  This is an optional operation; if an implementor uses a computed
+     * name, it should throw {@link UnsupportedOperationException}.
+     * @param name
+     */
     void setName(String name);
 }
Add javadoc, particularly for the fact that the setName operation is optional

git-svn-id: 4b387fe5ada7764508e2ca96c335714e4c1692c6@1772 0d517254-b314-0410-acde-c619094fa49f
