better comments in FleetProcess.java
authoradam <adam@megacz.com>
Mon, 3 Nov 2008 09:34:37 +0000 (10:34 +0100)
committeradam <adam@megacz.com>
Mon, 3 Nov 2008 09:34:37 +0000 (10:34 +0100)
src/edu/berkeley/fleet/api/FleetProcess.java

index 2b8f9d7..80d9f6c 100644 (file)
@@ -7,8 +7,8 @@ import java.util.*;
  *  facilities controlled by the "master" JVM.
  *
  *  <p>Each Fleet which supports this API must include:
- *  <ul><li> The ability to dispatch instructions from the master, "on
- *           the fly".
+ *  <ul><li> The ability to dispatch instructions, words, and tokens
+ *           from the master, "on the fly".
  *      <li> A "debug.in" dock such that any words delivered there
  *           are sent back to the master.
  *  </ul>
@@ -32,14 +32,18 @@ public abstract class FleetProcess {
     /** Terminate the process; subclasses may be assured that this will be called exactly once. */
     protected abstract void _terminate();
 
+    /** Terminate the process. */
     public final synchronized void terminate() {
         if (terminated) return;
         terminated = true;
         _terminate();
     }
 
+    /** Returns true if the process is terminated */
     public final boolean isTerminated() { return terminated; }
+
     public synchronized void finalize() { terminate(); }
 
+    /** return the Fleet that this FleetProcess controls */
     public abstract Fleet getFleet();
 }