lib/sup/update.rb in sup-0.3 vs lib/sup/update.rb in sup-0.4

@@ -1,6 +1,17 @@
 module Redwood
 
+## Classic listener/broadcaster paradigm. Handles communication between various
+## parts of Sup.
+##
+## Usage note: don't pass threads around. Neither thread nor message equality is
+## defined anywhere in Sup beyond standard object equality. To communicate
+## something about a particular thread, just pass a representative message from
+## it around.
+##
+## (This assumes that no message will be a part of more than one thread within a
+## single "view". Luckily, that's true.)
+
 class UpdateManager
   include Singleton
 
   def initialize
     @targets = {}