diff --git a/src/java/com/threerings/whirled/zone/data/ZoneSummary.java b/src/java/com/threerings/whirled/zone/data/ZoneSummary.java
index a9a1f2eb4..178b18fac 100644
--- a/src/java/com/threerings/whirled/zone/data/ZoneSummary.java
+++ b/src/java/com/threerings/whirled/zone/data/ZoneSummary.java
@@ -1,5 +1,5 @@
 //
-// $Id: ZoneSummary.java,v 1.1 2001/12/04 00:31:58 mdb Exp $
+// $Id: ZoneSummary.java,v 1.2 2001/12/13 05:49:50 mdb Exp $
 
 package com.threerings.whirled.zone.data;
 
@@ -16,7 +16,7 @@ import com.threerings.presents.io.Streamable;
  */
 public class ZoneSummary implements Streamable
 {
-    /** The zone's unique identifier. */
+    /** The zone's fully qualified unique identifier. */
     public int zoneId;
 
     /** The name of the zone. */
diff --git a/src/java/com/threerings/whirled/zone/server/ZoneManager.java b/src/java/com/threerings/whirled/zone/server/ZoneManager.java
index 738eb9217..1b7d55b3a 100644
--- a/src/java/com/threerings/whirled/zone/server/ZoneManager.java
+++ b/src/java/com/threerings/whirled/zone/server/ZoneManager.java
@@ -1,5 +1,5 @@
 //
-// $Id: ZoneManager.java,v 1.1 2001/12/04 00:31:58 mdb Exp $
+// $Id: ZoneManager.java,v 1.2 2001/12/13 05:49:50 mdb Exp $
 
 package com.threerings.whirled.zone.server;
 
@@ -37,6 +37,10 @@ public interface ZoneManager
      * Resolves and delivers the scene summary information for the
      * requested zone. Zone resolution is an asynchronous process, which
      * necessitates this callback-style interface.
+     *
+     * @param zoneId the qualified zone id of the zone to resolve.
+     * @param listener the listener that should be notified when the zone
+     * is successfully resolved or is known to have failed to resolve.
      */
     public void resolveZone (int zoneId, ResolutionListener listener);
 }
diff --git a/src/java/com/threerings/whirled/zone/server/ZoneProvider.java b/src/java/com/threerings/whirled/zone/server/ZoneProvider.java
index 067efab77..37e020bb8 100644
--- a/src/java/com/threerings/whirled/zone/server/ZoneProvider.java
+++ b/src/java/com/threerings/whirled/zone/server/ZoneProvider.java
@@ -1,5 +1,5 @@
 //
-// $Id: ZoneProvider.java,v 1.2 2001/12/04 01:06:33 mdb Exp $
+// $Id: ZoneProvider.java,v 1.3 2001/12/13 05:49:50 mdb Exp $
 
 package com.threerings.whirled.zone.server;
 
@@ -45,7 +45,7 @@ public class ZoneProvider
      *
      * @param source the user requesting the move.
      * @param invid the invocation id of the request.
-     * @param zoneId the identifier of the new zone.
+     * @param zoneId the qualified zone id of the new zone.
      * @param sceneId the identifier of the new scene.
      * @param sceneVew the version of the scene model currently held by
      * the client.