Minor scene changes.

git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@342 542714f4-19e9-0310-aa3c-eee0fc999fb1

src/java/com/threerings/whirled/data/DummyScene.java

@@ -1,5 +1,5 @@
 //
-// $Id: DummyScene.java,v 1.2 2001/08/16 18:05:17 shaper Exp $
+// $Id: DummyScene.java,v 1.3 2001/09/21 00:21:40 mdb Exp $
 
 package com.threerings.whirled.client.test;
 
@@ -22,7 +22,12 @@ public class DummyScene implements Scene
         return 1;
     }
 
-    public int[] getPortalIds ()
+    public String getName ()
+    {
+        return "scene";
+    }
+
+    public int[] getNeighborIds ()
     {
         return null;
     }

src/java/com/threerings/whirled/data/Scene.java

@@ -1,5 +1,5 @@
 //
-// $Id: Scene.java,v 1.2 2001/08/16 18:05:17 shaper Exp $
+// $Id: Scene.java,v 1.3 2001/09/21 00:21:40 mdb Exp $
 
 package com.threerings.whirled.data;
 
@@ -9,9 +9,28 @@ package com.threerings.whirled.data;
  */
 public interface Scene
 {
+    /**
+     * Returns the scene's unique identifier.
+     */
     public int getId ();
 
+    /**
+     * Returns the scene's version. The version should be updated every
+     * time the scene is modified and stored back to the repository. This
+     * allows a client to determine whether or not they need an updated
+     * version of the scene for their local cache.
+     */
     public int getVersion ();
 
-    public int[] getPortalIds ();
+    /**
+     * Returns the scene's name. Every scene has a descriptive name.
+     */
+    public String getName ();
+
+    /**
+     * Returns the scene ids of all scenes that neighbor this scene. A
+     * neighboring scene is one to which the user can traverse from this
+     * scene and vice versa.
+     */
+    public int[] getNeighborIds ();
 }