From: William Morgan <wmorgan-sup@masanjin.net>
Date: Sat, 29 Dec 2007 22:37:29 +0000 (-0800)
Subject: comments clarification for UpdateManager
X-Git-Url: https://git.cworth.org/git?a=commitdiff_plain;h=2cae1972ad4fca96abf9f235b7f6129d0bd546a2;p=sup

comments clarification for UpdateManager
---

diff --git a/lib/sup/update.rb b/lib/sup/update.rb
index 655573e..021b7e1 100644
--- a/lib/sup/update.rb
+++ b/lib/sup/update.rb
@@ -1,17 +1,15 @@
 module Redwood
 
-## Classic listener/sender paradigm. Handles communication between various
+## 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 beyond standard object equality. For Thread equality, this is
-## because of computational cost. But message equality is trivial by comparing
-## message ids, so to communicate something about a particular thread, just
-## pass a representative message from it instead.
+## 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" (otherwise a message from a thread wouldn't uniquely
-## identify it). But that's true.
+## (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