+// (C) 2006-2007 all rights reserved; see LICENSE file for BSD-style license
+
package edu.berkeley.sbp;
-import java.io.*;
-import java.util.*;
-import java.lang.reflect.*;
-import java.lang.ref.*;
import edu.berkeley.sbp.util.*;
-import edu.berkeley.sbp.*;
-import edu.berkeley.sbp.*;
/**
- * <font color=green>an element which matches some set of one-token-long input strings</font>.
+ * <font color=green>
+ * an element which matches some set of one-token-long input strings
+ * </font>.
*
* <p>
- * This class is a topology over itself (yes, that's sort of Frege'd
- * up) 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.
+ * This class is a topology over itself (yes, this is impredicative).
+ * This means that you can call Atom.union(Atom) and get back an Atom.
+ * If you are interested in the topology of <i>tokens</i> which this
+ * Atom can match, use the <tt>getTokenTopology()</tt> method.
* </p>
*/
-public abstract class Atom<T> extends Element implements Topology<Atom<T>> {
+public abstract class Atom<Token>
+ extends Element
+ implements Topology<Atom<Token>> {
/** the set (topology) of tokens that can match this element */
- public abstract Topology<T> getTokenTopology();
+ public abstract Topology<Token> getTokenTopology();
StringBuffer toString(StringBuffer sb) { sb.append(this); return sb; }