X-Git-Url: https://jxself.org/git/?p=8sync.git;a=blobdiff_plain;f=8sync%2Fsystems%2Factors.scm;h=376531a1787029c2c398d9950a8c5352d5ed6376;hp=c33240f309cc181dcf030b905a43b989e4cec186;hb=b06280f2319441e147943543ebd098b1e0abcdd9;hpb=e8a99d0a22f93676617c1d7d0f45cb675ed852ee

diff --git a/8sync/systems/actors.scm b/8sync/systems/actors.scm
index c33240f..376531a 100644
--- a/8sync/systems/actors.scm
+++ b/8sync/systems/actors.scm
@@ -352,6 +352,8 @@ Which is like doing manually:
     (let* ((action (message-action message))
            (method (assoc-ref action-map action)))
       (if (not method)
+          ;; @@: There's every possibility this should be handled in
+          ;;  hive-process-message instead.
           (throw 'action-not-found
                  "No appropriate action handler found for actor"
                  #:action action
@@ -370,6 +372,12 @@ Which is like doing manually:
      (cons (quote action-name) handler))))
 
 (define-syntax-rule (build-actions action-item ...)
+  "Build a mapping of actions.  Same syntax as make-action-dispatch
+but this doesn't build the dispatcher for you (you probably want to
+pass it to simple-dispatcher).
+
+The advantage here is that since this simply builds an alist, you can
+compose it with other action maps."
   (list (%expand-action-item action-item) ...))
 
 (define-syntax make-action-dispatch