X-Git-Url: http://git.megacz.com/?p=sbp.git;a=blobdiff_plain;f=src%2Fedu%2Fberkeley%2Fsbp%2FAtom.java;fp=src%2Fedu%2Fberkeley%2Fsbp%2FAtom.java;h=0a8ad12132a07d859244febaf899110e52cec038;hp=306e126e0e49a2f69561452ae038a8d77bc03c37;hb=d28917b3c84c429e8fd6587717df9e90a894b18f;hpb=b320f26b6e2cc13dcfcd810c7d5b507b942e8c70

diff --git a/src/edu/berkeley/sbp/Atom.java b/src/edu/berkeley/sbp/Atom.java
index 306e126..0a8ad12 100644
--- a/src/edu/berkeley/sbp/Atom.java
+++ b/src/edu/berkeley/sbp/Atom.java
@@ -7,12 +7,19 @@ import edu.berkeley.sbp.util.*;
 import edu.berkeley.sbp.*;
 import edu.berkeley.sbp.*;
 
-/** <font color=green>an element which matches exactly one input token</font> */
+/**
+ *  <font color=green>an element which matches some set of one-token-long input strings</font>.
+ *
+ *  This class is a topology over itself so that Atoms can be
+ *  intersected and unioned with each other to result in other
+ *  Atom<T>'s (rather than raw Topology<T>'s, which are not Elements).
+ *  If you want the latter, use the getTokenTopology() method.
+ */
 public abstract class Atom<T> extends Element implements Topology<Atom<T>> {
 
-    public  abstract Topology<T>  underlying();
-    public  abstract String       toString();
-    public           StringBuffer toString(StringBuffer sb) { sb.append(this); return sb; }
+    /** the set (topology) of tokens that can match this element */
+    public abstract Topology<T>  getTokenTopology();
 
+    public abstract StringBuffer toString(StringBuffer sb);
 }