extra comments

darcs-hash:20041207191624-2eb37-4499057df63d6791227e1c466ba28b855a14e6f7.gz

diff --git a/src/java/org/ibex/xt/shell/Command.java b/src/java/org/ibex/xt/shell/Command.java
index c7f3025..a55ded4 100644 (file)
--- a/src/java/org/ibex/xt/shell/Command.java
+++ b/src/java/org/ibex/xt/shell/Command.java
@@ -10,6 +10,11 @@ import java.util.regex.*;
 import org.ibex.js.*;
 import org.ibex.util.*;
 
+/** Provides implementations for the shell commands. General contract
+ *  is commands named after standard unix tools (eg. rm, mkdir) are
+ *  as safe as possible. Extra functions such as replace have no such
+ *  saftey features.
+ */
 public abstract class Command {
     protected Shell shell;
 

diff --git a/src/java/org/ibex/xt/shell/JSRemote.java b/src/java/org/ibex/xt/shell/JSRemote.java
index e54a9f5..6356280 100644 (file)
--- a/src/java/org/ibex/xt/shell/JSRemote.java
+++ b/src/java/org/ibex/xt/shell/JSRemote.java
@@ -11,6 +11,9 @@ import org.ibex.util.Collections;
 import org.ibex.xt.Prevalence;
 import org.prevayler.*;
 
+// FIXME: replace Prevayler references with careful Obj.call(Obj o)
+//        implementation for dynamically changing scopes in rework
+//        of org.ibex.js.
 public class JSRemote extends JS {
     public static final int VERSION = 1;