Similarly stay where we are on a failed move if we didn't leave our current

location in trying to get there.


git-svn-id: svn+ssh://src.earth.threerings.net/vilya/trunk@500 c613c5cb-e716-0410-b11b-feb51c14d237

src/java/com/threerings/whirled/zone/client/ZoneService.java

@@ -38,11 +38,22 @@ public interface ZoneService extends InvocationService
     /** Used to deliver responses to {@link #moveTo} requests. */
     public static interface ZoneMoveListener extends InvocationListener
     {
+        /**
+         * Called in response to a successful {@link #moveTo} request.
+         */
         public void moveSucceeded (int placeId, PlaceConfig config, ZoneSummary summary);
 
-        public void moveSucceededWithUpdates (
-            int placeId, PlaceConfig config, ZoneSummary summary, SceneUpdate[] updates);
+        /**
+         * Called in response to a successful {@link #moveTo} request when our cached scene was out
+         * of date and the server determined that we needed some updates.
+         */
+       public void moveSucceededWithUpdates (
+           int placeId, PlaceConfig config, ZoneSummary summary, SceneUpdate[] updates);
 
+        /**
+         * Called in response to a successful {@link #moveTo} request when our cached scene was out
+         * of date and the server determined that we needed an updated copy.
+         */
         public void moveSucceededWithScene (
             int placeId, PlaceConfig config, ZoneSummary summary, SceneModel model);
     }