Fixed a few javadocs.

@@ -3,7 +3,7 @@ package org.onlab.onos.net;
 import java.util.Set;
 
 /**
- * Represents an set of simply key/value string annotations.
+ * Represents an set of simple key/value string annotations.
  */
 public interface Annotations {
 

@@ -3,7 +3,8 @@ package org.onlab.onos.net;
 import java.util.Set;
 
 /**
- * Represents an set of simply key/value string annotations.
+ * Represents an set of sparse key/value string annotations capable of carrying
+ * annotation keys tagged for removal.
  */
 public interface SparseAnnotations extends Annotations {
 

@@ -12,8 +12,7 @@ public interface ProxyArpService {
     /**
      * Returns whether this particular ip address is known to the system.
      *
-     * @param addr
-     *            a ip address
+     * @param addr a ip address
      * @return true if know, false otherwise
      */
     boolean known(IpPrefix addr);
@@ -22,14 +21,14 @@ public interface ProxyArpService {
      * Sends a reply for a given request. If the host is not known then the arp
      * will be flooded at all edge ports.
      *
-     * @param eth
-     *            an arp request
+     * @param eth an arp request
      */
     void reply(Ethernet eth);
 
     /**
      * Forwards an ARP request to its destination. Floods at the edge the ARP request if the
      * destination is not known.
+     *
      * @param eth an ethernet frame containing an ARP request.
      */
     void forward(Ethernet eth);