diff --git a/core/api/src/main/java/org/onlab/onos/net/HostLocation.java b/core/api/src/main/java/org/onlab/onos/net/HostLocation.java
index 626b027..76e2312 100644
--- a/core/api/src/main/java/org/onlab/onos/net/HostLocation.java
+++ b/core/api/src/main/java/org/onlab/onos/net/HostLocation.java
@@ -9,16 +9,23 @@
     // Note that time is explicitly excluded from the notion of equality.
     private final long time;
 
+    /**
+     * Creates a new host location using the supplied device &amp; port.
+     *
+     * @param deviceId   device identity
+     * @param portNumber device port number
+     * @param time       time when detected, in millis since start of epoch
+     */
     public HostLocation(DeviceId deviceId, PortNumber portNumber, long time) {
         super(deviceId, portNumber);
         this.time = time;
     }
 
     /**
-     * Returns the timestamp when the location was established, given in
+     * Returns the time when the location was established, given in
      * milliseconds since start of epoch.
      *
-     * @return timestamp in milliseconds since start of epoch
+     * @return time in milliseconds since start of epoch
      */
     public long time() {
         return time;