From e0bdece5511c5b1db1c009697819bc42c342f0c3 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 15 Jan 2025 13:33:25 -0500
Subject: [PATCH 01/73] random gitignores

---
 .gitignore | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.gitignore b/.gitignore
index c800ff1..76b1a43 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,3 +24,7 @@ pom.xml.versionsBackup
 .calva/
 .lsp/
 .vscode/
+.project
+.classpath
+ccw.repl.cmdhistory.prefs
+nbactions.xml

From 03b97e0b3e0ec329629bcbf76106658dce4a5d61 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 15 Jan 2025 14:20:08 -0500
Subject: [PATCH 02/73] added core.async.flow

---
 src/main/clojure/clojure/core/async/flow.clj  | 270 +++++++++++++++++
 .../clojure/clojure/core/async/flow/impl.clj  | 273 ++++++++++++++++++
 .../clojure/core/async/flow/impl/graph.clj    |  28 ++
 .../clojure/clojure/core/async/flow/spi.clj   |  95 ++++++
 4 files changed, 666 insertions(+)
 create mode 100644 src/main/clojure/clojure/core/async/flow.clj
 create mode 100644 src/main/clojure/clojure/core/async/flow/impl.clj
 create mode 100644 src/main/clojure/clojure/core/async/flow/impl/graph.clj
 create mode 100644 src/main/clojure/clojure/core/async/flow/spi.clj

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
new file mode 100644
index 0000000..e0c06dd
--- /dev/null
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -0,0 +1,270 @@
+;;   Copyright (c) Rich Hickey and contributors. All rights reserved.
+;;   The use and distribution terms for this software are covered by the
+;;   Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php)
+;;   which can be found in the file epl-v10.html at the root of this distribution.
+;;   By using this software in any fashion, you are agreeing to be bound by
+;;   the terms of this license.
+;;   You must not remove this notice, or any other, from this software.
+
+(ns ^{:author "Rich Hickey"}
+  clojure.core.async.flow
+  "A library for building concurrent, event driven data processing
+  flows out of communication-free functions, while centralizing
+  control, reporting, execution and error handling. Built on core.async.
+
+  The top-level construct is the flow, comprising:
+  a set of processes (generally, threads) - concurrent activities
+  a set of channels flowing data into and out of the processes
+  a set of channels for centralized control, reporting, error-handling,
+    and execution of the processes
+
+  A flow is constructed from flow definition data which defines a
+  directed graph of processes and the connections between
+  them. Processes describe their I/O requirements and the
+  flow (library) itself creates channels and passes them to the
+  processes that requested them. See 'create-flow' for the
+  details. The flow definition provides a centralized place for policy
+  decisions regarding configuration, threading, buffering etc. 
+
+  It is expected that applications will rarely define processes but
+  instead use the API functions here, 'process' and 'step-process',
+  that implement the process protocol in terms of calls to ordinary
+  functions that include no communication or core.async code. In this
+  way the library helps you achieve a strict separation of your
+  application logic from its execution, communication, lifecycle and
+  monitoring.
+
+  Note that at several points the library calls upon the user to
+  supply ids for processes, inputs, outputs etc. These should be
+  keywords. When a namespaced keyword is required it is explicitly
+  stated. This documentation refers to various keywords utilized by
+  the library itself as ::flow/xyz, weere ::flow is an alias for
+  clojure.core.async.flow
+
+  A process is represented in the flow definition by an implementation
+  of spi/ProcLauncher that starts it. See the spi docs for
+  details."
+
+  (:require
+   [clojure.core.async.flow.impl :as impl]
+   [clojure.core.async.flow.impl.graph :as g]))
+
+(defn create-flow
+  "Creates a flow from the supplied definition: a map containing the
+  keys :procs and :conns, and optionally :mixed-exec/:io-exec/:compute-exec
+
+  :procs - a map of pid->proc-def
+  where proc-def is a map with keys :proc, :args, :chan-opts
+
+  :proc - a function that starts a process
+  :args - a map of param->val which will be passed to the process ctor
+  :chan-opts - a map of in-or-out-id->{:keys [buf-or-n xform]}, where buf-or-n
+               and xform have their meanings per core.async/chan
+               the default is {:buf-or-n 10}
+  
+  :conns - a collection of [[from-pid outid] [to-pid inid]] tuples.
+
+  Inputs and outputs support mutliple connections. When an output is
+  connected multiple times every connection will get every message,
+  as per a core.async/mult.
+
+  :mixed-exec/:io-exec/:compute-exec -> ExecutorService
+  These can be used to specify the ExecutorService to use for the
+  corresonding context, in lieu of the lib defaults
+
+  N.B. The flow is not started. See 'start'"
+  [def] (impl/create-flow def))
+
+(defn start
+  "starts the entire flow from init values. The processes start paused.
+  Call resume or resume-proc to start flow.
+  returns {::flow/report-chan - a core.async chan for reading
+           ::flow/error-chan - a core.async chan for reading}"
+  [g] (g/start g))
+
+(defn stop
+  "shuts down the flow, stopping all procsesses and closing the error
+  and report channels. The flow can be started again"
+  [g] (g/stop g))
+
+(defn pause
+  "pauses a running flow"
+  [g] (g/pause g))
+
+(defn resume
+  "resumes a paused flow"
+  [g] (g/resume g))
+
+(defn ping
+  "pings all processes, which will put their status and state on the
+  report channel"
+  [g] (g/ping g))
+
+(defn pause-proc
+  "pauses a process"
+  [g pid] (g/pause-proc g pid))
+
+(defn resume-proc
+  "resumes a process"
+  [g pid] (g/resume-proc g pid))
+
+(defn ping-proc
+  "pings the process, which will put its status and state on the report
+  channel"
+  [g pid] (g/ping-proc g pid))
+
+(defn command-proc
+  "synchronously sends a process-specific command with the given id and
+  additional kvs to the process. The cmd-id must be ns-qualified with
+  a ns you own."
+  [g pid cmd-id more-kvs] (g/command-proc g pid cmd-id more-kvs))
+  
+(defn inject
+  "synchronously puts the messages on the channel corresponding to the
+  input or output of the process"
+  [g [pid io-id :as coord] msgs] (g/inject g coord msgs))
+
+(defn process
+  "Given a map of functions (described below), returns a launcher that
+  creates a process compliant with the process protocol (see the
+  spi/ProcLauncher doc). The possible entries for process-impl-map
+  are :describe, :init, :transition, :transform and :inject. This is
+  the core facility for defining the logic for processes via ordinary
+  functions.
+
+  :describe - required, () -> desc
+  where desc is a map with keys :params :ins and :outs, each of which
+  in turn is a map of keyword to doc string
+  
+  :params describes the initial arguments to setup the state for the function.
+  :ins enumerates the input[s], for which the flow will create channels
+  :outs enumerates the output[s], for which the flow may create channels.
+  
+  No key may be present in both :ins and :outs The ins/outs/params of f
+  will be the ins/outs/params of the process. describe may be called
+  by users to understand how to use the proc. It will also be called
+  by the impl in order to discover what channels are needed.
+
+  :init - optional, (arg-map) -> initial-state
+  
+  init will be called once by the process to establish any
+  initial state. The arg-map will be a map of param->val, as supplied
+  in the flow def. init must be provided if 'describe' returns :params.
+
+  :transition - optional, (state transition) -> state'
+
+  transition will be called when the process makes a state transition,
+  transition being one of ::flow/resume, ::flow/pause or ::flow/stop
+
+  With this fn a process impl can track changes and coordinate
+  resources, especially cleaning up any resources on :stop, since the
+  process will no longer be used following that. See the SPI for
+  details. state' will be the state supplied to subsequent calls.
+
+  Exactly one of either :transform or :inject are required.
+
+  :transform - (state in-name msg) -> [state' output]
+  where output is a map of outid->[msgs*]
+
+  The transform fn will be called every time a message arrives at any
+  of the inputs. Output can be sent to none, any or all of the :outs
+  enumerated, and/or an input named by a [pid inid] tuple (e.g. for
+  reply-to), and/or to the ::flow/report output. A step need not
+  output at all (output or msgs can be empyt/nil), however an output _message_
+  may never be nil (per core.async channels). state' will be the state
+  supplied to subsequent calls.
+
+  :inject - (state) -> [state' output]
+  where output is a map of outid->[msgs*], per :transform
+ 
+  The inject fn is used for sources - proc-impls that inject new data
+  into the flow by doing I/O with something external to the flow and
+  feeding that data to its outputs. A proc-impl specifying :inject may not
+  specify any :ins in its descriptor, as none but the ::flow/control channel
+  will be read. Instead, inject will be called every time through the
+  process loop, and will presumably do blocking or paced I/O to get
+  new data to return via its outputs. If it does blocking I/O it
+  should do so with a timeout so it can regularly return to the
+  process loop which can then look for control messages - it's fine
+  for inject to return with no output. Do not spin poll in the inject
+  fn.
+
+  proc accepts an option map with keys:
+  :exec - one of :mixed, :io or :compute, default :mixed
+  :compute-timeout-ms - if :exec is :compute, this timeout (default 5000 msec)
+                will be used when getting the return from the future - see below
+
+  The :compute context is not allowed for proc impls that
+  provide :inject (as I/O is presumed).
+
+  In the :exec context of :mixed or :io, this dictates the type of
+  thread in which the process loop will run, _including its calls to
+  transform/inject_. 
+
+  When :io is specified transform/inject should not do extensive computation.
+
+  When :compute is specified (only allowed for :transform), each call
+  to transform will be run in a separate thread. The process loop will
+  run in an :io context (since it no longer directly calls transform,
+  all it does is I/O) and it will submit transform to the :compute
+  executor then await (blocking, for compute-timeout-ms) the
+  completion of the future returned by the executor. If the future
+  times out it will be reported on ::flow/error.
+
+  When :compute is specified transform must not block!"
+  ([process-impl-map] (process process-impl-map nil))
+  ([process-impl-map {:keys [exec timeout-ms]
+                      :or {exec :mixed, timeout-ms 5000} :as opts}]
+   (impl/proc process-impl-map opts)))
+
+(defn step-process
+  "Given a (e.g. communication-free) step function f of three
+  arities (described below), and the same opts as 'process', returns a
+  launcher that creates a process compliant with the process
+  protocol (see 'process').
+
+  The arities of f are:
+
+  ()->desc
+  a function matching the semantics of process' :describe
+
+  (arg-map)->initial-state
+  a function matching the semantics of process' :init
+  
+  (state in-name msg)->[state' output]
+  a function matching the semantics of process' :transform"
+  ([f] (step-process f nil))
+  ([f opts]
+   (process {:describe f, :init f, :transform f} opts)))
+
+(defn futurize
+  "Takes a fn f and returns a fn that takes the same arguments as f and
+  immediately returns a future, having starting a thread of the
+  indicated type, or via the supplied executor, that invokes f with
+  those args and completes that future with its return.
+
+  futurize accepts kwarg options:
+  :exec - one of :mixed, :io, :compute
+          or a j.u.c.ExecutorService object,
+          default :mixed"
+  [f & {:keys [exec]
+        :or {exec :mixed} :as opts}]
+  (impl/futurize f opts))
+
+(defn lift*->step
+  "given a fn f taking one arg and returning a collection of non-nil
+  values, create a 'step' fn as needed by step-process, with one input
+  and one output (named :in and :out), and no state."
+  [f]
+  (fn
+    ([] {:params {}
+         :ins {:in (str "the argument to " f)}
+         :outs {:out (str "the return of " f)}})
+    ([_] nil)
+    ([_ _ msg] [nil {:out (f msg)}])))
+
+(defn lift1->step
+  "like lift*->step except taking a fn returning one value, which, when
+  nil, will yield no output."
+  [f]
+  (lift*->step #(when-some [m (f %)] (vector m))))
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
new file mode 100644
index 0000000..e6362db
--- /dev/null
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -0,0 +1,273 @@
+;;   Copyright (c) Rich Hickey and contributors. All rights reserved.
+;;   The use and distribution terms for this software are covered by the
+;;   Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php)
+;;   which can be found in the file epl-v10.html at the root of this distribution.
+;;   By using this software in any fashion, you are agreeing to be bound by
+;;   the terms of this license.
+;;   You must not remove this notice, or any other, from this software.
+
+(ns clojure.core.async.flow.impl
+  (:require [clojure.core.async :as async]
+            [clojure.core.async.flow :as-alias flow]
+            [clojure.core.async.flow.spi :as spi]
+            [clojure.core.async.flow.impl.graph :as graph])
+  (:import [java.util.concurrent Future Executors ExecutorService TimeUnit]
+           [java.util.concurrent.locks ReentrantLock]))
+
+(set! *warn-on-reflection* true)
+
+;;TODO - something specific, e.g. make aware of JDK version and vthreads
+(defonce mixed-exec clojure.lang.Agent/soloExecutor)
+(defonce io-exec clojure.lang.Agent/soloExecutor)
+(defonce compute-exec clojure.lang.Agent/pooledExecutor)
+
+(defn futurize ^Future [f {:keys [exec]}]
+  (fn [& args]
+    (^[Callable] ExecutorService/.submit
+     (case exec
+       :compute compute-exec
+       :io io-exec
+       :mixed mixed-exec
+       exec)
+     #(apply f args))))
+
+(defn prep-proc [ret pid {:keys [proc, args, chan-opts] :or {chan-opts {}}}]
+  (let [{:keys [ins outs]} (spi/describe proc)
+        copts (fn [cs]
+                (zipmap (keys cs) (map #(chan-opts %) (keys cs))))
+        inopts (copts ins)
+        outopts (copts outs)]
+    (when (or (some (partial contains? inopts) (keys outopts))
+              (some (partial contains? outopts) (keys inopts)))
+      (throw (ex-info ":ins and :outs cannot share ids within a process"
+                      {:pid pid :ins (keys inopts) :outs (keys outopts)})))
+    (assoc ret pid {:pid pid :proc proc :ins inopts :outs outopts :args args})))
+
+(defn create-flow
+  "see lib ns for docs"
+  [{:keys [procs conns mixed-exec io-exec compute-exec]
+    :or {mixed-exec mixed-exec, io-exec io-exec, compute-exec compute-exec}
+    :as desc}]
+  (let [lock (ReentrantLock.)
+        chans (atom nil)
+        execs {:mixed mixed-exec :io io-exec :compute compute-exec}
+        _ (assert (every? #(instance? ExecutorService %) (vals execs))
+                  "mixed-exe, io-exec and compute-exec must be ExecutorServices")
+        pdescs (reduce-kv prep-proc {} procs)
+        allopts (fn [iok] (into {} (mapcat #(map (fn [[k opts]] [[(:pid %) k] opts]) (iok %)) (vals pdescs))))
+        inopts (allopts :ins)
+        outopts (allopts :outs)
+        set-conj (fnil conj #{})
+        ;;out-coord->#{in-coords}
+        conn-map (reduce (fn [ret [out in :as conn]]
+                           (if (and (contains? outopts out)
+                                    (contains? inopts in))
+                             (update ret out set-conj in)
+                             (throw (ex-info "invalid connection" {:conn conn}))))
+                         {} conns)
+        running-chans #(or (deref chans) (throw (Exception. "flow not running")))
+        send-command (fn [command to]
+                       (let [{:keys [control]} (running-chans)]
+                         (async/>!! control #::flow{:command command :to to})))]
+    (reify
+     clojure.core.async.flow.impl.graph.Graph
+      (start [_]
+        (.lock lock)
+        (try
+          (if-let [{:keys [report error]} @chans]
+            {:report-chan report :error-chan error :already-running true}
+            (let [control-chan (async/chan 10)
+                  control-mult (async/mult control-chan)
+                  report-chan (async/chan (async/sliding-buffer 100))
+                  error-chan (async/chan (async/sliding-buffer 100))
+                  make-chan (fn [[[pid cid]{:keys [buf-or-n xform]}]]
+                              (if xform
+                                (async/chan
+                                 buf-or-n xform
+                                 (fn [ex]
+                                   (async/put! error-chan
+                                               #::flow{:ex ex, :pid pid, :cid cid, :xform xform})
+                                   nil))
+                                (async/chan (or buf-or-n 10))))
+                  in-chans (zipmap (keys inopts) (map make-chan inopts))
+                  out-chans (zipmap (keys outopts)
+                                    (map (fn [[coord opts :as co]]
+                                           (let [conns (conn-map coord)]
+                                             (cond
+                                               (empty? conns) nil
+                                               ;;direct connect 1:1
+                                               (= 1 (count conns)) (in-chans (first conns))
+                                               :else (make-chan co)))) 
+                                         outopts))
+                  ;;mults
+                  _  (doseq [[out ins] conn-map]
+                       (when (< 1 (count ins))
+                         (let [m (async/mult (out-chans out))]
+                           (doseq [in ins]
+                             (async/tap m (in-chans in))))))
+                  write-chan #(if-let [[_ c] (or (find in-chans %) (find out-chans %))]
+                                c
+                                (throw (ex-info "can't resolve channel with coord" {:coord %})))
+                  resolver (reify spi/Resolver
+                             (get-write-chan [_ coord]
+                               (write-chan coord))
+                             (get-exec [_ context] (execs context)))
+                  start-proc
+                  (fn [{:keys [pid proc args ins outs]}]
+                    (try
+                      (let [chan-map (fn [ks coll] (zipmap (keys ks) (map #(coll [pid %]) (keys ks))))
+                            control-tap (async/chan 10)]
+                        (async/tap control-mult control-tap)
+                        (spi/start proc {:pid pid :args args :resolver resolver
+                                         :ins (assoc (chan-map ins in-chans)
+                                                     ::flow/control control-tap)
+                                         :outs (assoc (chan-map outs out-chans)
+                                                      ::flow/error error-chan
+                                                      ::flow/report report-chan)}))
+                      (catch Throwable ex
+                        (async/>!! control-chan #::flow{:command ::flow/stop :to ::flow/all})
+                        (throw ex))))]
+              (doseq [p (vals pdescs)]
+                (start-proc p))
+              ;;the only connection to a running flow is via channels
+              (reset! chans {:control control-chan :resolver resolver
+                             :report report-chan, :error error-chan
+                             :ins in-chans, :outs out-chans})
+              {:report-chan report-chan :error-chan error-chan}))
+          (finally (.unlock lock))))
+      (stop [_]
+        (.lock lock)
+        (try
+          (when-let [{:keys [report error]} @chans]
+            (send-command ::flow/stop ::flow/all)
+            (async/close! error)
+            (async/close! report)
+            (reset! chans nil)
+            true)
+          (finally (.unlock lock))))
+      (pause [_] (send-command ::flow/pause ::flow/all))
+      (resume [_] (send-command ::flow/resume ::flow/all))
+      (ping [_] (send-command ::flow/ping ::flow/all))
+
+      (pause-proc [_ pid] (send-command ::flow/pause pid))
+      (resume-proc [_ pid] (send-command ::flow/resume pid))
+      (ping-proc [_ pid] (send-command ::flow/ping pid))
+      (command-proc [_ pid command kvs]
+        (assert (and (namespace command) (not= (namespace ::flow/command) (namespace command)))
+                "extension commands must be in your own namespace")
+        (let [{:keys [control]} (running-chans)]
+          (async/>!! control (merge kvs #::flow{:command command :to pid}))))
+          
+      (inject [_ coord msgs]
+        (let [{:keys [resolver]} (running-chans)
+              chan (spi/get-write-chan resolver coord)]
+          (doseq [m msgs]
+            (async/>!! chan m)))))))
+
+(defn handle-command
+  [pid pong status cmd]
+  (let [transition #::flow{:stop :exit, :resume :running, :pause :paused}
+        {::flow/keys [to command]} cmd]
+    (if (#{::flow/all pid} to)
+      (do
+        (when (= command ::flow/ping) (pong))
+        (or (transition command) status))
+      status)))
+
+(defn handle-transition
+  "when transition, returns maybe new state"
+  [transition status nstatus state]
+  (if (and transition (not= status nstatus))
+    (transition state nstatus)
+    state))
+
+(defn send-outputs [status state outputs outs resolver control handle-command transition]
+  (loop [nstatus status, nstate state, outputs (seq outputs)]
+    (if (or (nil? outputs) (= nstatus :exit))
+      [nstatus nstate]
+      (let [[output msgs] (first outputs)]
+        (if-let [outc (or (outs output) (spi/get-write-chan resolver output))]
+          (let [[nstatus nstate]
+                (loop [nstatus nstatus, nstate nstate, msgs (seq msgs)]
+                  (if (or (nil? msgs) (= nstatus :exit))
+                    [nstatus nstate]
+                    (let [[v c] (async/alts!!
+                                 [control [outc (first msgs)]]
+                                 :priority true)]
+                      (if (= c control)
+                        (let [nnstatus (handle-command nstatus v)
+                              nnstate (handle-transition transition nstatus nnstatus nstate)]
+                          (recur nnstatus nnstate msgs))
+                        (recur nstatus nstate (next msgs))))))]
+            (recur nstatus nstate (next outputs)))
+          (recur nstatus nstate  (next outputs)))))))
+
+(defn proc
+  "see lib ns for docs"
+  [{:keys [describe init transition transform inject] :as impl} {:keys [exec compute-timeout-ms]}]
+  ;;validate the preconditions
+  (assert (= 1 (count (keep identity [transform inject]))) "must provide exactly one of :transform or :inject")
+  (assert (not (and inject (= exec :compute))) "can't specify :inject and :compute")
+  (reify
+    clojure.core.protocols/Datafiable
+    (datafy [_]
+      (let [{:keys [params ins outs]} (describe)]
+        {:impl impl :params (-> params keys vec) :ins (-> ins keys vec) :outs (-> outs keys vec)}))
+    spi/ProcLauncher
+    (describe [_]
+      (let [{:keys [params ins] :as desc} (describe)]
+        (assert (not (and ins inject)) "can't specify :ins when :inject")
+        (assert (or (not params) init) "must have :init if :params")
+        desc))
+    (start [_ {:keys [pid args ins outs resolver]}]
+      (let [comp? (= exec :compute)
+            transform (cond-> transform (= exec :compute)
+                              #(.get (futurize transform {:exec (spi/get-exec resolver :compute)})
+                                     compute-timeout-ms TimeUnit/MILLISECONDS))
+            exs (spi/get-exec resolver (if (= exec :mixed) :mixed :io))
+            io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
+            control (::flow/control ins)
+            ;;TODO rotate/randomize after control per normal alts?
+            read-chans (into [control] (-> ins (dissoc ::flow/control) vals))
+            run
+            #(loop [status :paused, state (when init (init args)), count 0]
+               (let [pong (fn [] (async/>!! (outs ::flow/report)
+                                            #::flow{:report :ping, :pid pid, :status status
+                                                     :state state, :count count}))
+                     handle-command (partial handle-command pid pong)
+                     [nstatus nstate count]
+                     (try
+                       (if (= status :paused)
+                         (let [nstatus (handle-command status (async/<!! control))
+                               nstate (handle-transition transition status nstatus state)]
+                           [nstatus nstate count])
+                         ;;:running
+                         (let [[msg c] (if transform
+                                         (async/alts!! read-chans :priority true)
+                                         ;;inject
+                                         (when-let [msg (async/poll! control)]
+                                           [msg control]))
+                               cid (io-id c)]
+                           (if (= c control)
+                             (let [nstatus (handle-command status msg)
+                                   nstate (handle-transition transition status nstatus state)]
+                               [nstatus nstate count])
+                             (try
+                               (let [[nstate outputs] (if transform
+                                                        (transform state cid msg)
+                                                        (inject state))
+                                     [nstatus nstate]
+                                     (send-outputs status nstate outputs outs resolver control handle-command transition)]
+                                 [nstatus nstate (inc count)])
+                               (catch Throwable ex
+                                 (async/>!! (outs ::flow/error)
+                                            #::flow{:pid pid, :status status, :state state,
+                                                     :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
+                                 [status state count])))))
+                       (catch Throwable ex
+                         (async/>!! (outs ::flow/error)
+                                    #::flow{:pid pid, :status status, :state state, :count (inc count), :ex ex})
+                         [status state count]))]
+                 (when-not (= nstatus :exit) ;;fall out
+                   (recur nstatus nstate (long count)))))]
+        ((futurize run {:exec exs}))))))
diff --git a/src/main/clojure/clojure/core/async/flow/impl/graph.clj b/src/main/clojure/clojure/core/async/flow/impl/graph.clj
new file mode 100644
index 0000000..181a392
--- /dev/null
+++ b/src/main/clojure/clojure/core/async/flow/impl/graph.clj
@@ -0,0 +1,28 @@
+;;   Copyright (c) Rich Hickey and contributors. All rights reserved.
+;;   The use and distribution terms for this software are covered by the
+;;   Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php)
+;;   which can be found in the file epl-v10.html at the root of this distribution.
+;;   By using this software in any fashion, you are agreeing to be bound by
+;;   the terms of this license.
+;;   You must not remove this notice, or any other, from this software.
+
+(ns clojure.core.async.flow.impl.graph)
+
+(defprotocol Graph
+  (start [g] "starts the entire graph from init values. The processes start paused. 
+              Call resume-all or resume-proc to start flow.
+              returns {:report-chan -  a core.async chan for reading 
+                       :error-chan - a core.async chan for reading}")
+  (stop [g] "shuts down the graph, stopping all procs, can be started again")
+  (pause [g] "pauses a running graph")
+  (resume [g] "resumes a paused graph")
+  (ping [g] "pings all processes, which will put their status and state on the report channel")
+
+  (pause-proc [g pid] "pauses a process")
+  (resume-proc [g pid] "resumes a process")
+  (ping-proc [g pid] "pings the process, which will put its status and state on the report channel")
+  (command-proc [g pid cmd-id more-kvs] "synchronously sends a process-specific command with the given id 
+                                         and additional kvs to the process")
+  
+  (inject [g [pid io-id] msgs] "synchronously puts the messages on the channel 
+                         corresponding to the input or output of the process"))
diff --git a/src/main/clojure/clojure/core/async/flow/spi.clj b/src/main/clojure/clojure/core/async/flow/spi.clj
new file mode 100644
index 0000000..3bb4df4
--- /dev/null
+++ b/src/main/clojure/clojure/core/async/flow/spi.clj
@@ -0,0 +1,95 @@
+;;   Copyright (c) Rich Hickey and contributors. All rights reserved.
+;;   The use and distribution terms for this software are covered by the
+;;   Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php)
+;;   which can be found in the file epl-v10.html at the root of this distribution.
+;;   By using this software in any fashion, you are agreeing to be bound by
+;;   the terms of this license.
+;;   You must not remove this notice, or any other, from this software.
+
+(ns clojure.core.async.flow.spi)
+
+(defprotocol ProcLauncher
+  "Note - definine a ProcLauncher is an advanced feature and should not
+  be needed for ordinary use of the library. This protocol is for
+  creating new types of Processes that are not possible to create
+  with ::flow/process.
+  
+  A ProcLauncher is a constructor for a process, a thread of activity.
+  It has two functions - to describe the parameters and input/output
+  requirements of the process and to start it. The launcher should
+  acquire no resources, nor retain any connection to the started
+  process. A launcher may be called upon to start a process more than
+  once, and should start a new process each time start is called.
+  
+  The process launched process must obey the following:
+
+  It must have 2 logical statuses, :paused and :running. In
+  the :paused status operation is suspended and no output is
+  produced.
+
+  When the process starts it must be :paused
+
+  Whenever it is reading or writing to any channel a process must use
+  alts!! and include a read of the ::flow/control channel, giving it
+  priority.
+
+  Command messages sent over the ::flow/control channel have the keys:
+  ::flow/to - either ::flow/all or a process id
+  ::flow/command - ::flow/stop|pause|resume|ping or process-specific
+  
+  It must act upon any, and only, control messages whose ::flow/to key is its pid or ::flow/all
+  It must act upon the following values of ::flow/command:
+
+  ::flow/stop - all resources should be cleaned up and any thread(s)
+     should exit ordinarily - there will be no more subsequent use
+     of the process.
+  ::flow/pause - enter the :paused status
+  ::flow/resume - enter the :running status and resume processing
+  ::flow/ping - emit a ping message (format TBD) to
+     the ::flow/report channel containing at least its pid and status
+
+  A process can define and respond to other commands in its own namespace.
+
+  A process should not transmit channel objects (use [pid io-id] data
+  coordinates instead) A process should not close channels
+
+  Finally, if a process encounters an error it must report it on the
+  ::flow/error channel (format TBD) and attempt to continue, though it
+  may subsequently get a ::flow/stop command it must respect"
+  
+  (describe [p]
+    "returns a map with keys - :params, :ins and :outs,
+  each of which in turn is a map of keyword to docstring
+
+  :params describes the initial arguments to setup the state for the process
+  :ins enumerates the input[s], for which the graph will create channels
+  :outs enumerates the output[s], for which the graph may create channels.
+
+  describe may be called by users to understand how to use the
+  proc. It will also be called by the impl in order to discover what
+  channels are needed.")
+  
+  (start [p {:keys [pid args ins outs resolver]}]
+    "return ignored, called for the
+  effect of starting the process (typically, starting its thread)
+
+  where:
+
+  :pid - the id of the process in the graph, so that e.g. it can refer to itself in control, reporting etc
+  :args - a map of param->val,  as supplied in the graph def
+  :ins - a map of in-id->readable-channel, plus the ::flow/control channel
+  :outs - a map of out-id->writeable-channel, plus the ::flow/error and ::flow/report channels
+          N.B. outputs may be nil if not connected
+  :resolver - an impl of spi/Resolver, which can be used to find
+              channels given their logical [pid cid] coordinates, as well as to
+              obtain ExecutorServices corresponding to the
+              logical :mixed/:io/:compute contexts"))
+
+(defprotocol Resolver
+  (get-write-chan [_ coord]
+    "Given a tuple of [pid cid], returns a core.async chan to
+    write to or nil (in which case the output should be dropped,
+    e.g. nothing is connected).")
+  (get-exec [_ context]
+    "returns the ExecutorService for the given context, one
+     of :mixed, :io, :compute"))

From 5b086bcf163903514a641dcbf2600bdb5547dcfc Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 15 Jan 2025 15:24:44 -0500
Subject: [PATCH 03/73] added channel status to ping replies

---
 src/main/clojure/clojure/core/async/flow.clj  |  2 ++
 .../clojure/clojure/core/async/flow/impl.clj  | 24 +++++++++++++++----
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index e0c06dd..09553ac 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -49,6 +49,8 @@
    [clojure.core.async.flow.impl :as impl]
    [clojure.core.async.flow.impl.graph :as g]))
 
+(set! *warn-on-reflection* true)
+
 (defn create-flow
   "Creates a flow from the supplied definition: a map containing the
   keys :procs and :conns, and optionally :mixed-exec/:io-exec/:compute-exec
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index e6362db..5a2cb90 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -21,6 +21,17 @@
 (defonce io-exec clojure.lang.Agent/soloExecutor)
 (defonce compute-exec clojure.lang.Agent/pooledExecutor)
 
+(defn chan->data
+  [^clojure.core.async.impl.channels.ManyToManyChannel c]
+    (let [b (.buf c)]
+      {:buffer-type (if b
+                      (-> b class .getSimpleName symbol)
+                      :none)
+       :buffer-count (count b)
+       :put-count (count (.puts c))
+       :take-count (count (.takes c))
+       :closed? (clojure.core.async.impl.protocols/closed? c)}))
+
 (defn futurize ^Future [f {:keys [exec]}]
   (fn [& args]
     (^[Callable] ExecutorService/.submit
@@ -231,9 +242,14 @@
             read-chans (into [control] (-> ins (dissoc ::flow/control) vals))
             run
             #(loop [status :paused, state (when init (init args)), count 0]
-               (let [pong (fn [] (async/>!! (outs ::flow/report)
-                                            #::flow{:report :ping, :pid pid, :status status
-                                                     :state state, :count count}))
+               (let [pong (fn []
+                            (let [pins (dissoc ins ::flow/control)
+                                  pouts (dissoc outs ::flow/error ::flow/report)]
+                              (async/>!! (outs ::flow/report)
+                                         #::flow{:report :ping, :pid pid, :status status
+                                                 :state state, :count count
+                                                 :ins (zipmap (keys pins) (map chan->data (vals pins)))
+                                                 :outs (zipmap (keys pouts) (map chan->data (vals pouts)))})))
                      handle-command (partial handle-command pid pong)
                      [nstatus nstate count]
                      (try
@@ -262,7 +278,7 @@
                                (catch Throwable ex
                                  (async/>!! (outs ::flow/error)
                                             #::flow{:pid pid, :status status, :state state,
-                                                     :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
+                                                    :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
                                  [status state count])))))
                        (catch Throwable ex
                          (async/>!! (outs ::flow/error)

From bf3c034acb0b0499320a4d71355431fb8439f4b3 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 15 Jan 2025 18:27:51 -0500
Subject: [PATCH 04/73] more docs on 'start' return, typos

---
 src/main/clojure/clojure/core/async/flow.clj | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 09553ac..c1b8833 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -38,7 +38,7 @@
   supply ids for processes, inputs, outputs etc. These should be
   keywords. When a namespaced keyword is required it is explicitly
   stated. This documentation refers to various keywords utilized by
-  the library itself as ::flow/xyz, weere ::flow is an alias for
+  the library itself as ::flow/xyz, where ::flow is an alias for
   clojure.core.async.flow
 
   A process is represented in the flow definition by an implementation
@@ -79,9 +79,17 @@
 
 (defn start
   "starts the entire flow from init values. The processes start paused.
-  Call resume or resume-proc to start flow.
-  returns {::flow/report-chan - a core.async chan for reading
-           ::flow/error-chan - a core.async chan for reading}"
+  Call 'resume' or 'resume-proc' to start flow.  returns a map with keys:
+  
+  ::flow/report-chan - a core.async chan for reading.'ping' reponses
+  will show up here, as will any explicit ::flow/report outputs
+  from :transform/:inject
+  
+  ::flow/error-chan - a core.async chan for reading. Any (and only)
+  exceptions thrown anywhere on any thread inside a flow will appear
+  in maps sent here. There will at least be a ::flow/ex entry with the
+  exception, and may be additional keys for pid, state, status etc
+  depending on the context of the error."
   [g] (g/start g))
 
 (defn stop
@@ -99,7 +107,7 @@
 
 (defn ping
   "pings all processes, which will put their status and state on the
-  report channel"
+  report channel returned from start"
   [g] (g/ping g))
 
 (defn pause-proc
@@ -112,7 +120,7 @@
 
 (defn ping-proc
   "pings the process, which will put its status and state on the report
-  channel"
+  channel returned from start"
   [g pid] (g/ping-proc g pid))
 
 (defn command-proc

From 8e18e17c8a6ad579bc40701b335c46f1fa29f608 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 15 Jan 2025 20:53:51 -0500
Subject: [PATCH 05/73] first cut at flow rationale and overview

---
 doc/flow.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 doc/flow.md

diff --git a/doc/flow.md b/doc/flow.md
new file mode 100644
index 0000000..b48427c
--- /dev/null
+++ b/doc/flow.md
@@ -0,0 +1,29 @@
+# core.async.flow #
+## Rationale ##
+
+The [rationale](https://clojure.org/news/2013/06/28/clojure-clore-async-channels) for **core.async** says "There comes a time in all good programs when components or subsystems must stop communicating directly with one another." And core.async provides fundamental tools (channels) for doing that. 
+
+But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes *emerges* out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.
+
+The fundamental objective of __core.async.flow__ is to enable a strict separation of your application logic from its topology, execution, communication, lifecycle, monitoring and error handling, all of which are provided by and centralized in, c.a.flow, yielding more consistent, robust, testable, observable and operable systems.
+
+## Overview ##
+
+__core.async.flow__ provides *concrete* implementations of two more abstractions - the '__process__' - a thread of activity, and the '__flow__' - a directed graph of processes communicating via channels. A single data structure describes your flow topology, and has all of the settings for threads, channels etc. A process accepts data from and provides data to channels. The process implementation in c.a.flow handles all channel I/O, thread lifecycle and coordination with the flow graph.
+
+All you need to do in you application is:
+
+1. Define ordinary, often pure, data->data functions that the processes will run in their inner loop to do the *computational* part of processing messages. These functions do not handle channels or threads or lifecycle, and do not even know they are running in a flow. They can be tested in isolation, and hot-reloaded. If they encounter a problem they can, and should, just throw an exception. The process will take care of it from there.
+
+2. Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.
+
+With these application inputs, c.a.flow does the rest. It inquires of the processes what channels they require, creates those channels, then instantiates the processes making all of the channel connections between them. The processes in turn start threads (in fully user-configurable thread pools), await inputs, monitor the admin control channel, and when inputs arrive make a data->data calls to your application logic, taking the return from that and sending it to the designated output channels. The processes follow a protocol used by the flow to do lifecycle management and error handling.
+
+Once you've created a flow, the API provides functions to start/stop(shutdown) the flow, and to pause/resume both the flow and individual processes, to ping processes to get their state and that of their connected channels, to inject data into any point in the graph etc. The flow provides channels containing the ordinary monitoring/reporting stream and, separately, the error stream. 
+
+The library provides many more details and features, including the ability to create, via ordinary functions, processes that act as __sources__ (of data from outside the flow) or __sinks__ (to recipients outside the flow) so you can situate your flow in a broader context while still coordinating resource management with the flow lifecycle.
+
+I hope __core.async.flow__ enables you to write more robust and smaller applications, with more focus on your domain logic and less on plumbing.
+
+Rich Hickey 
+1/2025

From 313569a932dffd6c683438909926a719d80a5d04 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 15 Jan 2025 20:59:58 -0500
Subject: [PATCH 06/73] typo

---
 doc/flow.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/flow.md b/doc/flow.md
index b48427c..c24c697 100644
--- a/doc/flow.md
+++ b/doc/flow.md
@@ -17,7 +17,7 @@ All you need to do in you application is:
 
 2. Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.
 
-With these application inputs, c.a.flow does the rest. It inquires of the processes what channels they require, creates those channels, then instantiates the processes making all of the channel connections between them. The processes in turn start threads (in fully user-configurable thread pools), await inputs, monitor the admin control channel, and when inputs arrive make a data->data calls to your application logic, taking the return from that and sending it to the designated output channels. The processes follow a protocol used by the flow to do lifecycle management and error handling.
+With these application inputs, c.a.flow does the rest. It inquires of the processes what channels they require, creates those channels, then instantiates the processes making all of the channel connections between them. The processes in turn start threads (in fully user-configurable thread pools), await inputs, monitor the admin control channel, and when inputs arrive make data->data calls to your application logic, taking the return from that and sending it to the designated output channels. The processes follow a protocol used by the flow to do lifecycle management and error handling.
 
 Once you've created a flow, the API provides functions to start/stop(shutdown) the flow, and to pause/resume both the flow and individual processes, to ping processes to get their state and that of their connected channels, to inject data into any point in the graph etc. The flow provides channels containing the ordinary monitoring/reporting stream and, separately, the error stream. 
 

From 3ee4a34f474334e8f6d6ed9dc348767878280936 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Thu, 16 Jan 2025 16:17:21 -0500
Subject: [PATCH 07/73] prevent nil messages from messing up alts

---
 .gitignore                                        | 1 +
 src/main/clojure/clojure/core/async/flow/impl.clj | 5 +++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/.gitignore b/.gitignore
index 76b1a43..033484d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -28,3 +28,4 @@ pom.xml.versionsBackup
 .classpath
 ccw.repl.cmdhistory.prefs
 nbactions.xml
+.DS_Store
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 5a2cb90..8332b68 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -202,8 +202,9 @@
                 (loop [nstatus nstatus, nstate nstate, msgs (seq msgs)]
                   (if (or (nil? msgs) (= nstatus :exit))
                     [nstatus nstate]
-                    (let [[v c] (async/alts!!
-                                 [control [outc (first msgs)]]
+                    (let [m (if-some [m (first msgs)] m (throw "messages must be non-nil"))
+                          [v c] (async/alts!!
+                                 [control [outc m]]
                                  :priority true)]
                       (if (= c control)
                         (let [nnstatus (handle-command nstatus v)

From 17b05383302c490165cfe6be31b3a2605de0ba20 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Thu, 16 Jan 2025 16:31:38 -0500
Subject: [PATCH 08/73] :inject in process fn-map is now :introduce, more
 accurate and avoids confusion with flow/inject

---
 src/main/clojure/clojure/core/async/flow.clj  | 22 +++++++++----------
 .../clojure/clojure/core/async/flow/impl.clj  | 14 ++++++------
 2 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index c1b8833..3beb519 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -83,7 +83,7 @@
   
   ::flow/report-chan - a core.async chan for reading.'ping' reponses
   will show up here, as will any explicit ::flow/report outputs
-  from :transform/:inject
+  from :transform/:introduce
   
   ::flow/error-chan - a core.async chan for reading. Any (and only)
   exceptions thrown anywhere on any thread inside a flow will appear
@@ -138,7 +138,7 @@
   "Given a map of functions (described below), returns a launcher that
   creates a process compliant with the process protocol (see the
   spi/ProcLauncher doc). The possible entries for process-impl-map
-  are :describe, :init, :transition, :transform and :inject. This is
+  are :describe, :init, :transition, :transform and :introduce. This is
   the core facility for defining the logic for processes via ordinary
   functions.
 
@@ -171,7 +171,7 @@
   process will no longer be used following that. See the SPI for
   details. state' will be the state supplied to subsequent calls.
 
-  Exactly one of either :transform or :inject are required.
+  Exactly one of either :transform or :introduce are required.
 
   :transform - (state in-name msg) -> [state' output]
   where output is a map of outid->[msgs*]
@@ -184,19 +184,19 @@
   may never be nil (per core.async channels). state' will be the state
   supplied to subsequent calls.
 
-  :inject - (state) -> [state' output]
+  :introduce - (state) -> [state' output]
   where output is a map of outid->[msgs*], per :transform
  
-  The inject fn is used for sources - proc-impls that inject new data
+  The introduce fn is used for sources - proc-impls that introduce new data
   into the flow by doing I/O with something external to the flow and
-  feeding that data to its outputs. A proc-impl specifying :inject may not
+  feeding that data to its outputs. A proc-impl specifying :introduce may not
   specify any :ins in its descriptor, as none but the ::flow/control channel
-  will be read. Instead, inject will be called every time through the
+  will be read. Instead, introduce will be called every time through the
   process loop, and will presumably do blocking or paced I/O to get
   new data to return via its outputs. If it does blocking I/O it
   should do so with a timeout so it can regularly return to the
   process loop which can then look for control messages - it's fine
-  for inject to return with no output. Do not spin poll in the inject
+  for introduce to return with no output. Do not spin poll in the introduce
   fn.
 
   proc accepts an option map with keys:
@@ -205,13 +205,13 @@
                 will be used when getting the return from the future - see below
 
   The :compute context is not allowed for proc impls that
-  provide :inject (as I/O is presumed).
+  provide :introduce (as I/O is presumed).
 
   In the :exec context of :mixed or :io, this dictates the type of
   thread in which the process loop will run, _including its calls to
-  transform/inject_. 
+  transform/introduce_. 
 
-  When :io is specified transform/inject should not do extensive computation.
+  When :io is specified transform/introduce should not do extensive computation.
 
   When :compute is specified (only allowed for :transform), each call
   to transform will be run in a separate thread. The process loop will
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 8332b68..fdbf4db 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -202,7 +202,7 @@
                 (loop [nstatus nstatus, nstate nstate, msgs (seq msgs)]
                   (if (or (nil? msgs) (= nstatus :exit))
                     [nstatus nstate]
-                    (let [m (if-some [m (first msgs)] m (throw "messages must be non-nil"))
+                    (let [m (if-some [m (first msgs)] m (throw (Exception.  "messages must be non-nil")))
                           [v c] (async/alts!!
                                  [control [outc m]]
                                  :priority true)]
@@ -216,10 +216,10 @@
 
 (defn proc
   "see lib ns for docs"
-  [{:keys [describe init transition transform inject] :as impl} {:keys [exec compute-timeout-ms]}]
+  [{:keys [describe init transition transform introduce] :as impl} {:keys [exec compute-timeout-ms]}]
   ;;validate the preconditions
-  (assert (= 1 (count (keep identity [transform inject]))) "must provide exactly one of :transform or :inject")
-  (assert (not (and inject (= exec :compute))) "can't specify :inject and :compute")
+  (assert (= 1 (count (keep identity [transform introduce]))) "must provide exactly one of :transform or :introduce")
+  (assert (not (and introduce (= exec :compute))) "can't specify :introduce and :compute")
   (reify
     clojure.core.protocols/Datafiable
     (datafy [_]
@@ -228,7 +228,7 @@
     spi/ProcLauncher
     (describe [_]
       (let [{:keys [params ins] :as desc} (describe)]
-        (assert (not (and ins inject)) "can't specify :ins when :inject")
+        (assert (not (and ins introduce)) "can't specify :ins when :introduce")
         (assert (or (not params) init) "must have :init if :params")
         desc))
     (start [_ {:keys [pid args ins outs resolver]}]
@@ -261,7 +261,7 @@
                          ;;:running
                          (let [[msg c] (if transform
                                          (async/alts!! read-chans :priority true)
-                                         ;;inject
+                                         ;;introduce
                                          (when-let [msg (async/poll! control)]
                                            [msg control]))
                                cid (io-id c)]
@@ -272,7 +272,7 @@
                              (try
                                (let [[nstate outputs] (if transform
                                                         (transform state cid msg)
-                                                        (inject state))
+                                                        (introduce state))
                                      [nstatus nstate]
                                      (send-outputs status nstate outputs outs resolver control handle-command transition)]
                                  [nstatus nstate (inc count)])

From 6d9fc5a6b4e9d4cef8b51725aa9b1b47029d72ba Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 17 Jan 2025 12:48:59 -0600
Subject: [PATCH 09/73] use pre-1.12 compatible interop syntax

---
 src/main/clojure/clojure/core/async/flow/impl.clj | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index fdbf4db..e5473a0 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -34,13 +34,12 @@
 
 (defn futurize ^Future [f {:keys [exec]}]
   (fn [& args]
-    (^[Callable] ExecutorService/.submit
-     (case exec
-       :compute compute-exec
-       :io io-exec
-       :mixed mixed-exec
-       exec)
-     #(apply f args))))
+    (let [^ExecutorService exec (case exec
+                                  :compute compute-exec
+                                  :io io-exec
+                                  :mixed mixed-exec
+                                  exec)]
+      (.submit exec ^Callable #(apply f args)))))
 
 (defn prep-proc [ret pid {:keys [proc, args, chan-opts] :or {chan-opts {}}}]
   (let [{:keys [ins outs]} (spi/describe proc)

From 103393bc0552243dcbe7d2fe2fc20313255950c7 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Fri, 17 Jan 2025 15:17:16 -0500
Subject: [PATCH 10/73] :exec option -> :workload, proc-fn :describe can return
 :workflow, process opt overridesflow definition -> config, no use of Clojure
 1.12 features so 1.11 compatible

---
 src/main/clojure/clojure/core/async/flow.clj  |  82 +++++----
 .../clojure/clojure/core/async/flow/impl.clj  | 160 +++++++++---------
 .../clojure/clojure/core/async/flow/spi.clj   |   2 +-
 3 files changed, 128 insertions(+), 116 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 3beb519..4a957f2 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -8,7 +8,10 @@
 
 (ns ^{:author "Rich Hickey"}
   clojure.core.async.flow
-  "A library for building concurrent, event driven data processing
+  "
+  Note - Alpha, work-in-progress, names and other details are in flux 
+
+  A library for building concurrent, event driven data processing
   flows out of communication-free functions, while centralizing
   control, reporting, execution and error handling. Built on core.async.
 
@@ -18,21 +21,21 @@
   a set of channels for centralized control, reporting, error-handling,
     and execution of the processes
 
-  A flow is constructed from flow definition data which defines a
+  A flow is constructed from flow configuration data which defines a
   directed graph of processes and the connections between
   them. Processes describe their I/O requirements and the
   flow (library) itself creates channels and passes them to the
   processes that requested them. See 'create-flow' for the
-  details. The flow definition provides a centralized place for policy
-  decisions regarding configuration, threading, buffering etc. 
+  details. The flow configuration provides a centralized place for
+  policy decisions regarding process settings, threading, buffering etc.
 
-  It is expected that applications will rarely define processes but
-  instead use the API functions here, 'process' and 'step-process',
-  that implement the process protocol in terms of calls to ordinary
-  functions that include no communication or core.async code. In this
-  way the library helps you achieve a strict separation of your
-  application logic from its execution, communication, lifecycle and
-  monitoring.
+  It is expected that applications will rarely define instances of the
+  process protocol but instead use the API functions here, 'process'
+  and 'step-process', that implement the process protocol in terms of
+  calls to ordinary functions that might include no communication or
+  core.async code. In this way the library helps you achieve a strict
+  separation of your application logic from its execution,
+  communication, lifecycle, error handling and monitoring.
 
   Note that at several points the library calls upon the user to
   supply ids for processes, inputs, outputs etc. These should be
@@ -52,7 +55,7 @@
 (set! *warn-on-reflection* true)
 
 (defn create-flow
-  "Creates a flow from the supplied definition: a map containing the
+  "Creates a flow from the supplied configuration: a map containing the
   keys :procs and :conns, and optionally :mixed-exec/:io-exec/:compute-exec
 
   :procs - a map of pid->proc-def
@@ -66,26 +69,26 @@
   
   :conns - a collection of [[from-pid outid] [to-pid inid]] tuples.
 
-  Inputs and outputs support mutliple connections. When an output is
+  Inputs and outputs support multiple connections. When an output is
   connected multiple times every connection will get every message,
   as per a core.async/mult.
 
   :mixed-exec/:io-exec/:compute-exec -> ExecutorService
   These can be used to specify the ExecutorService to use for the
-  corresonding context, in lieu of the lib defaults
+  corresonding workflow, in lieu of the lib defaults.
 
   N.B. The flow is not started. See 'start'"
-  [def] (impl/create-flow def))
+  [config] (impl/create-flow config))
 
 (defn start
   "starts the entire flow from init values. The processes start paused.
   Call 'resume' or 'resume-proc' to start flow.  returns a map with keys:
   
-  ::flow/report-chan - a core.async chan for reading.'ping' reponses
+  :report-chan - a core.async chan for reading.'ping' reponses
   will show up here, as will any explicit ::flow/report outputs
   from :transform/:introduce
   
-  ::flow/error-chan - a core.async chan for reading. Any (and only)
+  :error-chan - a core.async chan for reading. Any (and only)
   exceptions thrown anywhere on any thread inside a flow will appear
   in maps sent here. There will at least be a ::flow/ex entry with the
   exception, and may be additional keys for pid, state, status etc
@@ -144,16 +147,23 @@
 
   :describe - required, () -> desc
   where desc is a map with keys :params :ins and :outs, each of which
-  in turn is a map of keyword to doc string
+  in turn is a map of keyword to doc string, and :workload with
+  possible values of :mixed :io :compute. All entries in the describe
+  return map are optional.
   
   :params describes the initial arguments to setup the state for the function.
   :ins enumerates the input[s], for which the flow will create channels
   :outs enumerates the output[s], for which the flow may create channels.
+  :workload - describes the nature of the workload, one of :mixed :io or :compute
+          an :io workload should not do extended computation
+          a :compute workload should never block
   
-  No key may be present in both :ins and :outs The ins/outs/params of f
-  will be the ins/outs/params of the process. describe may be called
-  by users to understand how to use the proc. It will also be called
-  by the impl in order to discover what channels are needed.
+  No key may be present in both :ins and :outs, allowing for a uniform
+  channel coordinate system of [:process-id :channel-id]. The
+  ins/outs/params returned will be the ins/outs/params of the
+  process. describe may be called by users to understand how to use
+  the proc. It will also be called by the impl in order to discover
+  what channels are needed.
 
   :init - optional, (arg-map) -> initial-state
   
@@ -199,15 +209,19 @@
   for introduce to return with no output. Do not spin poll in the introduce
   fn.
 
-  proc accepts an option map with keys:
-  :exec - one of :mixed, :io or :compute, default :mixed
-  :compute-timeout-ms - if :exec is :compute, this timeout (default 5000 msec)
+  process accepts an option map with keys:
+  :workflow - one of :mixed, :io or :compute
+  :compute-timeout-ms - if :workflow is :compute, this timeout (default 5000 msec)
                 will be used when getting the return from the future - see below
 
-  The :compute context is not allowed for proc impls that
+  A :workflow supplied as an option to process will override
+  any :workflow returned by the :describe fn of the process. If neither
+  are provded the default is :mixed.
+
+  The :compute workload is not allowed for proc impls that
   provide :introduce (as I/O is presumed).
 
-  In the :exec context of :mixed or :io, this dictates the type of
+  In the :workflow context of :mixed or :io, this dictates the type of
   thread in which the process loop will run, _including its calls to
   transform/introduce_. 
 
@@ -223,8 +237,8 @@
 
   When :compute is specified transform must not block!"
   ([process-impl-map] (process process-impl-map nil))
-  ([process-impl-map {:keys [exec timeout-ms]
-                      :or {exec :mixed, timeout-ms 5000} :as opts}]
+  ([process-impl-map {:keys [workflow timeout-ms]
+                      :or {timeout-ms 5000} :as opts}]
    (impl/proc process-impl-map opts)))
 
 (defn step-process
@@ -248,13 +262,13 @@
    (process {:describe f, :init f, :transform f} opts)))
 
 (defn futurize
-  "Takes a fn f and returns a fn that takes the same arguments as f and
-  immediately returns a future, having starting a thread of the
-  indicated type, or via the supplied executor, that invokes f with
-  those args and completes that future with its return.
+  "Takes a fn f and returns a fn that takes the same arguments as f
+  and immediately returns a future, having started a thread for the
+  indicated workload, or via the supplied executor, that invokes f
+  with those args and completes that future with its return.
 
   futurize accepts kwarg options:
-  :exec - one of :mixed, :io, :compute
+  :exec - one of the workloads :mixed, :io, :compute
           or a j.u.c.ExecutorService object,
           default :mixed"
   [f & {:keys [exec]
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index fdbf4db..89c51bf 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -34,13 +34,12 @@
 
 (defn futurize ^Future [f {:keys [exec]}]
   (fn [& args]
-    (^[Callable] ExecutorService/.submit
-     (case exec
-       :compute compute-exec
-       :io io-exec
-       :mixed mixed-exec
-       exec)
-     #(apply f args))))
+    (let [^ExecutorService e (case exec
+                                   :compute compute-exec
+                                   :io io-exec
+                                   :mixed mixed-exec
+                                   exec)]
+      (.submit e ^Callable #(apply f args)))))
 
 (defn prep-proc [ret pid {:keys [proc, args, chan-opts] :or {chan-opts {}}}]
   (let [{:keys [ins outs]} (spi/describe proc)
@@ -57,8 +56,7 @@
 (defn create-flow
   "see lib ns for docs"
   [{:keys [procs conns mixed-exec io-exec compute-exec]
-    :or {mixed-exec mixed-exec, io-exec io-exec, compute-exec compute-exec}
-    :as desc}]
+    :or {mixed-exec mixed-exec, io-exec io-exec, compute-exec compute-exec}}]
   (let [lock (ReentrantLock.)
         chans (atom nil)
         execs {:mixed mixed-exec :io io-exec :compute compute-exec}
@@ -216,75 +214,75 @@
 
 (defn proc
   "see lib ns for docs"
-  [{:keys [describe init transition transform introduce] :as impl} {:keys [exec compute-timeout-ms]}]
-  ;;validate the preconditions
-  (assert (= 1 (count (keep identity [transform introduce]))) "must provide exactly one of :transform or :introduce")
-  (assert (not (and introduce (= exec :compute))) "can't specify :introduce and :compute")
-  (reify
-    clojure.core.protocols/Datafiable
-    (datafy [_]
-      (let [{:keys [params ins outs]} (describe)]
-        {:impl impl :params (-> params keys vec) :ins (-> ins keys vec) :outs (-> outs keys vec)}))
-    spi/ProcLauncher
-    (describe [_]
-      (let [{:keys [params ins] :as desc} (describe)]
-        (assert (not (and ins introduce)) "can't specify :ins when :introduce")
-        (assert (or (not params) init) "must have :init if :params")
-        desc))
-    (start [_ {:keys [pid args ins outs resolver]}]
-      (let [comp? (= exec :compute)
-            transform (cond-> transform (= exec :compute)
-                              #(.get (futurize transform {:exec (spi/get-exec resolver :compute)})
-                                     compute-timeout-ms TimeUnit/MILLISECONDS))
-            exs (spi/get-exec resolver (if (= exec :mixed) :mixed :io))
-            io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
-            control (::flow/control ins)
-            ;;TODO rotate/randomize after control per normal alts?
-            read-chans (into [control] (-> ins (dissoc ::flow/control) vals))
-            run
-            #(loop [status :paused, state (when init (init args)), count 0]
-               (let [pong (fn []
-                            (let [pins (dissoc ins ::flow/control)
-                                  pouts (dissoc outs ::flow/error ::flow/report)]
-                              (async/>!! (outs ::flow/report)
-                                         #::flow{:report :ping, :pid pid, :status status
-                                                 :state state, :count count
-                                                 :ins (zipmap (keys pins) (map chan->data (vals pins)))
-                                                 :outs (zipmap (keys pouts) (map chan->data (vals pouts)))})))
-                     handle-command (partial handle-command pid pong)
-                     [nstatus nstate count]
-                     (try
-                       (if (= status :paused)
-                         (let [nstatus (handle-command status (async/<!! control))
-                               nstate (handle-transition transition status nstatus state)]
-                           [nstatus nstate count])
-                         ;;:running
-                         (let [[msg c] (if transform
-                                         (async/alts!! read-chans :priority true)
-                                         ;;introduce
-                                         (when-let [msg (async/poll! control)]
-                                           [msg control]))
-                               cid (io-id c)]
-                           (if (= c control)
-                             (let [nstatus (handle-command status msg)
-                                   nstate (handle-transition transition status nstatus state)]
-                               [nstatus nstate count])
-                             (try
-                               (let [[nstate outputs] (if transform
-                                                        (transform state cid msg)
-                                                        (introduce state))
-                                     [nstatus nstate]
-                                     (send-outputs status nstate outputs outs resolver control handle-command transition)]
-                                 [nstatus nstate (inc count)])
-                               (catch Throwable ex
-                                 (async/>!! (outs ::flow/error)
-                                            #::flow{:pid pid, :status status, :state state,
-                                                    :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
-                                 [status state count])))))
-                       (catch Throwable ex
-                         (async/>!! (outs ::flow/error)
-                                    #::flow{:pid pid, :status status, :state state, :count (inc count), :ex ex})
-                         [status state count]))]
-                 (when-not (= nstatus :exit) ;;fall out
-                   (recur nstatus nstate (long count)))))]
-        ((futurize run {:exec exs}))))))
+  [{:keys [describe init transition transform introduce] :as impl} {:keys [workflow compute-timeout-ms]}]
+  (assert (= 1 (count (keep identity [transform introduce]))) "must provide exactly one of :transform or :introduce") 
+  (let [{:keys [params ins] :as desc} (describe)
+        workflow (or workflow (:workflow desc) :mixed)]
+    (assert (not (and ins introduce)) "can't specify :ins when :introduce")
+    (assert (or (not params) init) "must have :init if :params")
+    (assert (not (and introduce (= workflow :compute))) "can't specify :introduce and :compute")
+    (reify
+     clojure.core.protocols/Datafiable
+     (datafy [_]
+             (let [{:keys [params ins outs]} desc]
+               {:impl impl :params (-> params keys vec) :ins (-> ins keys vec) :outs (-> outs keys vec)}))
+     spi/ProcLauncher
+     (describe [_] desc)
+     (start [_ {:keys [pid args ins outs resolver]}]
+            (let [comp? (= workflow :compute)
+                  transform (cond-> transform (= workflow :compute)
+                                    #(.get (futurize transform {:exec (spi/get-exec resolver :compute)})
+                                           compute-timeout-ms TimeUnit/MILLISECONDS))
+                  exs (spi/get-exec resolver (if (= workflow :mixed) :mixed :io))
+                  io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
+                  control (::flow/control ins)
+                  ;;TODO rotate/randomize after control per normal alts?
+                  read-chans (into [control] (-> ins (dissoc ::flow/control) vals))
+                  run
+                  #(loop [status :paused, state (when init (init args)), count 0]
+                     (let [pong (fn []
+                                  (let [pins (dissoc ins ::flow/control)
+                                        pouts (dissoc outs ::flow/error ::flow/report)]
+                                    (async/>!! (outs ::flow/report)
+                                               #::flow{:report :ping, :pid pid, :status status
+                                                       :state state, :count count
+                                                       :ins (zipmap (keys pins) (map chan->data (vals pins)))
+                                                       :outs (zipmap (keys pouts) (map chan->data (vals pouts)))})))
+                           handle-command (partial handle-command pid pong)
+                           [nstatus nstate count]
+                           (try
+                             (if (= status :paused)
+                               (let [nstatus (handle-command status (async/<!! control))
+                                     nstate (handle-transition transition status nstatus state)]
+                                 [nstatus nstate count])
+                               ;;:running
+                               (let [[msg c] (if transform
+                                               (async/alts!! read-chans :priority true)
+                                               ;;introduce
+                                               (when-let [msg (async/poll! control)]
+                                                 [msg control]))
+                                     cid (io-id c)]
+                                 (if (= c control)
+                                   (let [nstatus (handle-command status msg)
+                                         nstate (handle-transition transition status nstatus state)]
+                                     [nstatus nstate count])
+                                   (try
+                                     (let [[nstate outputs] (if transform
+                                                              (transform state cid msg)
+                                                              (introduce state))
+                                           [nstatus nstate]
+                                           (send-outputs status nstate outputs outs
+                                                         resolver control handle-command transition)]
+                                       [nstatus nstate (inc count)])
+                                     (catch Throwable ex
+                                       (async/>!! (outs ::flow/error)
+                                                  #::flow{:pid pid, :status status, :state state,
+                                                          :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
+                                       [status state count])))))
+                             (catch Throwable ex
+                               (async/>!! (outs ::flow/error)
+                                          #::flow{:pid pid, :status status, :state state, :count (inc count), :ex ex})
+                               [status state count]))]
+                       (when-not (= nstatus :exit) ;;fall out
+                         (recur nstatus nstate (long count)))))]
+              ((futurize run {:exec exs})))))))
diff --git a/src/main/clojure/clojure/core/async/flow/spi.clj b/src/main/clojure/clojure/core/async/flow/spi.clj
index 3bb4df4..e86a66a 100644
--- a/src/main/clojure/clojure/core/async/flow/spi.clj
+++ b/src/main/clojure/clojure/core/async/flow/spi.clj
@@ -9,7 +9,7 @@
 (ns clojure.core.async.flow.spi)
 
 (defprotocol ProcLauncher
-  "Note - definine a ProcLauncher is an advanced feature and should not
+  "Note - defining a ProcLauncher is an advanced feature and should not
   be needed for ordinary use of the library. This protocol is for
   creating new types of Processes that are not possible to create
   with ::flow/process.

From c5a524c6607a792bc51a81f727e7d24ef4cae23b Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Fri, 17 Jan 2025 15:59:03 -0500
Subject: [PATCH 11/73] s/workflow/workload

---
 src/main/clojure/clojure/core/async/flow.clj      | 14 +++++++-------
 src/main/clojure/clojure/core/async/flow/impl.clj | 12 ++++++------
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 4a957f2..38d8943 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -75,7 +75,7 @@
 
   :mixed-exec/:io-exec/:compute-exec -> ExecutorService
   These can be used to specify the ExecutorService to use for the
-  corresonding workflow, in lieu of the lib defaults.
+  corresonding workload, in lieu of the lib defaults.
 
   N.B. The flow is not started. See 'start'"
   [config] (impl/create-flow config))
@@ -210,18 +210,18 @@
   fn.
 
   process accepts an option map with keys:
-  :workflow - one of :mixed, :io or :compute
-  :compute-timeout-ms - if :workflow is :compute, this timeout (default 5000 msec)
+  :workload - one of :mixed, :io or :compute
+  :compute-timeout-ms - if :workload is :compute, this timeout (default 5000 msec)
                 will be used when getting the return from the future - see below
 
-  A :workflow supplied as an option to process will override
-  any :workflow returned by the :describe fn of the process. If neither
+  A :workload supplied as an option to process will override
+  any :workload returned by the :describe fn of the process. If neither
   are provded the default is :mixed.
 
   The :compute workload is not allowed for proc impls that
   provide :introduce (as I/O is presumed).
 
-  In the :workflow context of :mixed or :io, this dictates the type of
+  In the :workload context of :mixed or :io, this dictates the type of
   thread in which the process loop will run, _including its calls to
   transform/introduce_. 
 
@@ -237,7 +237,7 @@
 
   When :compute is specified transform must not block!"
   ([process-impl-map] (process process-impl-map nil))
-  ([process-impl-map {:keys [workflow timeout-ms]
+  ([process-impl-map {:keys [workload timeout-ms]
                       :or {timeout-ms 5000} :as opts}]
    (impl/proc process-impl-map opts)))
 
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 89c51bf..cc264d0 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -214,13 +214,13 @@
 
 (defn proc
   "see lib ns for docs"
-  [{:keys [describe init transition transform introduce] :as impl} {:keys [workflow compute-timeout-ms]}]
+  [{:keys [describe init transition transform introduce] :as impl} {:keys [workload compute-timeout-ms]}]
   (assert (= 1 (count (keep identity [transform introduce]))) "must provide exactly one of :transform or :introduce") 
   (let [{:keys [params ins] :as desc} (describe)
-        workflow (or workflow (:workflow desc) :mixed)]
+        workload (or workload (:workload desc) :mixed)]
     (assert (not (and ins introduce)) "can't specify :ins when :introduce")
     (assert (or (not params) init) "must have :init if :params")
-    (assert (not (and introduce (= workflow :compute))) "can't specify :introduce and :compute")
+    (assert (not (and introduce (= workload :compute))) "can't specify :introduce and :compute")
     (reify
      clojure.core.protocols/Datafiable
      (datafy [_]
@@ -229,11 +229,11 @@
      spi/ProcLauncher
      (describe [_] desc)
      (start [_ {:keys [pid args ins outs resolver]}]
-            (let [comp? (= workflow :compute)
-                  transform (cond-> transform (= workflow :compute)
+            (let [comp? (= workload :compute)
+                  transform (cond-> transform (= workload :compute)
                                     #(.get (futurize transform {:exec (spi/get-exec resolver :compute)})
                                            compute-timeout-ms TimeUnit/MILLISECONDS))
-                  exs (spi/get-exec resolver (if (= workflow :mixed) :mixed :io))
+                  exs (spi/get-exec resolver (if (= workload :mixed) :mixed :io))
                   io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
                   control (::flow/control ins)
                   ;;TODO rotate/randomize after control per normal alts?

From 55225fa05a7cbfc184bd711447f8d92d101e5f33 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Tue, 21 Jan 2025 12:29:05 -0600
Subject: [PATCH 12/73] add codox task

---
 deps.edn                                     | 8 ++++++++
 src/main/clojure/clojure/core/async.clj      | 2 ++
 src/test/clojure/clojure/core/async_test.clj | 7 +++++++
 3 files changed, 17 insertions(+)

diff --git a/deps.edn b/deps.edn
index 91e5dfb..ad96f46 100644
--- a/deps.edn
+++ b/deps.edn
@@ -22,4 +22,12 @@
   ;; clj -M:outdated
   :outdated {:extra-deps {com.github.liquidz/antq {:mvn/version "2.11.1250"}}
              :main-opts ["-m" "antq.core"]}
+
+  ;; Regenerate docs in docs/
+  ;; clj -X:docs
+  :docs {:extra-deps {codox/codox {:mvn/version "0.10.8"}}
+         :exec-fn codox.main/generate-docs
+         :exec-args {:source-paths ["src/main/clojure"]
+                     :namespaces [clojure.core.async clojure.core.async.flow clojure.core.async.flow.spi]
+                     :output-path "apidocs"}}
   }}
diff --git a/src/main/clojure/clojure/core/async.clj b/src/main/clojure/clojure/core/async.clj
index 8b40571..de90e04 100644
--- a/src/main/clojure/clojure/core/async.clj
+++ b/src/main/clojure/clojure/core/async.clj
@@ -277,6 +277,8 @@ to catch and handle."
   "returns derefable [val port] if immediate, nil if enqueued"
   [fret ports opts]
   (assert (pos? (count ports)) "alts must have at least one channel operation")
+  (doseq [port ports :when (vector? port)]
+    (assert (not (nil? (nth port 1))) "alts can't put nil on channel"))
   (let [flag (alt-flag)
         ports (vec ports) ;; ensure vector for indexed nth
         n (count ports)
diff --git a/src/test/clojure/clojure/core/async_test.clj b/src/test/clojure/clojure/core/async_test.clj
index 017ba7d..866808a 100644
--- a/src/test/clojure/clojure/core/async_test.clj
+++ b/src/test/clojure/clojure/core/async_test.clj
@@ -465,3 +465,10 @@
              :ok
              (catch AssertionError e
                :ko))))))
+
+(deftest test-alts-put-nil-invalid
+  (is
+    (thrown? AssertionError
+      (let [c1 (a/chan)
+            c2 (a/chan)]
+        (a/alts!! [c1 [c2 nil]])))))
\ No newline at end of file

From 1022d370e4c862d6a910aa1bf45c1789120e7e59 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Tue, 21 Jan 2025 12:29:29 -0600
Subject: [PATCH 13/73] add apidocs

---
 apidocs/clojure.core.async.flow.html     | 206 +++++++++
 apidocs/clojure.core.async.flow.spi.html |  74 +++
 apidocs/clojure.core.async.html          | 270 +++++++++++
 apidocs/css/default.css                  | 551 +++++++++++++++++++++++
 apidocs/css/highlight.css                |  97 ++++
 apidocs/flow.html                        |  24 +
 apidocs/index.html                       |   3 +
 apidocs/intro.html                       |   4 +
 apidocs/js/highlight.min.js              |   2 +
 apidocs/js/jquery.min.js                 |   4 +
 apidocs/js/page_effects.js               | 112 +++++
 11 files changed, 1347 insertions(+)
 create mode 100644 apidocs/clojure.core.async.flow.html
 create mode 100644 apidocs/clojure.core.async.flow.spi.html
 create mode 100644 apidocs/clojure.core.async.html
 create mode 100644 apidocs/css/default.css
 create mode 100644 apidocs/css/highlight.css
 create mode 100644 apidocs/flow.html
 create mode 100644 apidocs/index.html
 create mode 100644 apidocs/intro.html
 create mode 100644 apidocs/js/highlight.min.js
 create mode 100644 apidocs/js/jquery.min.js
 create mode 100644 apidocs/js/page_effects.js

diff --git a/apidocs/clojure.core.async.flow.html b/apidocs/clojure.core.async.flow.html
new file mode 100644
index 0000000..d7d4900
--- /dev/null
+++ b/apidocs/clojure.core.async.flow.html
@@ -0,0 +1,206 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4 current"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-step-process"><div class="inner"><span>step-process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+Note - Alpha, work-in-progress, names and other details are in flux 
+
+A library for building concurrent, event driven data processing
+flows out of communication-free functions, while centralizing
+control, reporting, execution and error handling. Built on core.async.
+
+The top-level construct is the flow, comprising:
+a set of processes (generally, threads) - concurrent activities
+a set of channels flowing data into and out of the processes
+a set of channels for centralized control, reporting, error-handling,
+  and execution of the processes
+
+A flow is constructed from flow configuration data which defines a
+directed graph of processes and the connections between
+them. Processes describe their I/O requirements and the
+flow (library) itself creates channels and passes them to the
+processes that requested them. See 'create-flow' for the
+details. The flow configuration provides a centralized place for
+policy decisions regarding process settings, threading, buffering etc.
+
+It is expected that applications will rarely define instances of the
+process protocol but instead use the API functions here, 'process'
+and 'step-process', that implement the process protocol in terms of
+calls to ordinary functions that might include no communication or
+core.async code. In this way the library helps you achieve a strict
+separation of your application logic from its execution,
+communication, lifecycle, error handling and monitoring.
+
+Note that at several points the library calls upon the user to
+supply ids for processes, inputs, outputs etc. These should be
+keywords. When a namespaced keyword is required it is explicitly
+stated. This documentation refers to various keywords utilized by
+the library itself as ::flow/xyz, where ::flow is an alias for
+clojure.core.async.flow
+
+A process is represented in the flow definition by an implementation
+of spi/ProcLauncher that starts it. See the spi docs for
+details.</pre></div><div class="public anchor" id="var-command-proc"><h3>command-proc</h3><div class="usage"><code>(command-proc g pid cmd-id more-kvs)</code></div><div class="doc"><pre class="plaintext">synchronously sends a process-specific command with the given id and
+additional kvs to the process. The cmd-id must be ns-qualified with
+a ns you own.</pre></div></div><div class="public anchor" id="var-create-flow"><h3>create-flow</h3><div class="usage"><code>(create-flow config)</code></div><div class="doc"><pre class="plaintext">Creates a flow from the supplied configuration: a map containing the
+keys :procs and :conns, and optionally :mixed-exec/:io-exec/:compute-exec
+
+:procs - a map of pid-&gt;proc-def
+where proc-def is a map with keys :proc, :args, :chan-opts
+
+:proc - a function that starts a process
+:args - a map of param-&gt;val which will be passed to the process ctor
+:chan-opts - a map of in-or-out-id-&gt;{:keys [buf-or-n xform]}, where buf-or-n
+             and xform have their meanings per core.async/chan
+             the default is {:buf-or-n 10}
+
+:conns - a collection of [[from-pid outid] [to-pid inid]] tuples.
+
+Inputs and outputs support multiple connections. When an output is
+connected multiple times every connection will get every message,
+as per a core.async/mult.
+
+:mixed-exec/:io-exec/:compute-exec -&gt; ExecutorService
+These can be used to specify the ExecutorService to use for the
+corresonding workload, in lieu of the lib defaults.
+
+N.B. The flow is not started. See 'start'</pre></div></div><div class="public anchor" id="var-futurize"><h3>futurize</h3><div class="usage"><code>(futurize f &amp; {:keys [exec], :or {exec :mixed}, :as opts})</code></div><div class="doc"><pre class="plaintext">Takes a fn f and returns a fn that takes the same arguments as f
+and immediately returns a future, having started a thread for the
+indicated workload, or via the supplied executor, that invokes f
+with those args and completes that future with its return.
+
+futurize accepts kwarg options:
+:exec - one of the workloads :mixed, :io, :compute
+        or a j.u.c.ExecutorService object,
+        default :mixed</pre></div></div><div class="public anchor" id="var-inject"><h3>inject</h3><div class="usage"><code>(inject g [pid io-id :as coord] msgs)</code></div><div class="doc"><pre class="plaintext">synchronously puts the messages on the channel corresponding to the
+input or output of the process</pre></div></div><div class="public anchor" id="var-lift*-.3Estep"><h3>lift*-&gt;step</h3><div class="usage"><code>(lift*-&gt;step f)</code></div><div class="doc"><pre class="plaintext">given a fn f taking one arg and returning a collection of non-nil
+values, create a 'step' fn as needed by step-process, with one input
+and one output (named :in and :out), and no state.</pre></div></div><div class="public anchor" id="var-lift1-.3Estep"><h3>lift1-&gt;step</h3><div class="usage"><code>(lift1-&gt;step f)</code></div><div class="doc"><pre class="plaintext">like lift*-&gt;step except taking a fn returning one value, which, when
+nil, will yield no output.</pre></div></div><div class="public anchor" id="var-pause"><h3>pause</h3><div class="usage"><code>(pause g)</code></div><div class="doc"><pre class="plaintext">pauses a running flow
+</pre></div></div><div class="public anchor" id="var-pause-proc"><h3>pause-proc</h3><div class="usage"><code>(pause-proc g pid)</code></div><div class="doc"><pre class="plaintext">pauses a process
+</pre></div></div><div class="public anchor" id="var-ping"><h3>ping</h3><div class="usage"><code>(ping g)</code></div><div class="doc"><pre class="plaintext">pings all processes, which will put their status and state on the
+report channel returned from start</pre></div></div><div class="public anchor" id="var-ping-proc"><h3>ping-proc</h3><div class="usage"><code>(ping-proc g pid)</code></div><div class="doc"><pre class="plaintext">pings the process, which will put its status and state on the report
+channel returned from start</pre></div></div><div class="public anchor" id="var-process"><h3>process</h3><div class="usage"><code>(process process-impl-map)</code><code>(process process-impl-map {:keys [workload timeout-ms], :or {timeout-ms 5000}, :as opts})</code></div><div class="doc"><pre class="plaintext">Given a map of functions (described below), returns a launcher that
+creates a process compliant with the process protocol (see the
+spi/ProcLauncher doc). The possible entries for process-impl-map
+are :describe, :init, :transition, :transform and :introduce. This is
+the core facility for defining the logic for processes via ordinary
+functions.
+
+:describe - required, () -&gt; desc
+where desc is a map with keys :params :ins and :outs, each of which
+in turn is a map of keyword to doc string, and :workload with
+possible values of :mixed :io :compute. All entries in the describe
+return map are optional.
+
+:params describes the initial arguments to setup the state for the function.
+:ins enumerates the input[s], for which the flow will create channels
+:outs enumerates the output[s], for which the flow may create channels.
+:workload - describes the nature of the workload, one of :mixed :io or :compute
+        an :io workload should not do extended computation
+        a :compute workload should never block
+
+No key may be present in both :ins and :outs, allowing for a uniform
+channel coordinate system of [:process-id :channel-id]. The
+ins/outs/params returned will be the ins/outs/params of the
+process. describe may be called by users to understand how to use
+the proc. It will also be called by the impl in order to discover
+what channels are needed.
+
+:init - optional, (arg-map) -&gt; initial-state
+
+init will be called once by the process to establish any
+initial state. The arg-map will be a map of param-&gt;val, as supplied
+in the flow def. init must be provided if 'describe' returns :params.
+
+:transition - optional, (state transition) -&gt; state'
+
+transition will be called when the process makes a state transition,
+transition being one of ::flow/resume, ::flow/pause or ::flow/stop
+
+With this fn a process impl can track changes and coordinate
+resources, especially cleaning up any resources on :stop, since the
+process will no longer be used following that. See the SPI for
+details. state' will be the state supplied to subsequent calls.
+
+Exactly one of either :transform or :introduce are required.
+
+:transform - (state in-name msg) -&gt; [state' output]
+where output is a map of outid-&gt;[msgs*]
+
+The transform fn will be called every time a message arrives at any
+of the inputs. Output can be sent to none, any or all of the :outs
+enumerated, and/or an input named by a [pid inid] tuple (e.g. for
+reply-to), and/or to the ::flow/report output. A step need not
+output at all (output or msgs can be empyt/nil), however an output _message_
+may never be nil (per core.async channels). state' will be the state
+supplied to subsequent calls.
+
+:introduce - (state) -&gt; [state' output]
+where output is a map of outid-&gt;[msgs*], per :transform
+
+The introduce fn is used for sources - proc-impls that introduce new data
+into the flow by doing I/O with something external to the flow and
+feeding that data to its outputs. A proc-impl specifying :introduce may not
+specify any :ins in its descriptor, as none but the ::flow/control channel
+will be read. Instead, introduce will be called every time through the
+process loop, and will presumably do blocking or paced I/O to get
+new data to return via its outputs. If it does blocking I/O it
+should do so with a timeout so it can regularly return to the
+process loop which can then look for control messages - it's fine
+for introduce to return with no output. Do not spin poll in the introduce
+fn.
+
+process accepts an option map with keys:
+:workload - one of :mixed, :io or :compute
+:compute-timeout-ms - if :workload is :compute, this timeout (default 5000 msec)
+              will be used when getting the return from the future - see below
+
+A :workload supplied as an option to process will override
+any :workload returned by the :describe fn of the process. If neither
+are provded the default is :mixed.
+
+The :compute workload is not allowed for proc impls that
+provide :introduce (as I/O is presumed).
+
+In the :workload context of :mixed or :io, this dictates the type of
+thread in which the process loop will run, _including its calls to
+transform/introduce_. 
+
+When :io is specified transform/introduce should not do extensive computation.
+
+When :compute is specified (only allowed for :transform), each call
+to transform will be run in a separate thread. The process loop will
+run in an :io context (since it no longer directly calls transform,
+all it does is I/O) and it will submit transform to the :compute
+executor then await (blocking, for compute-timeout-ms) the
+completion of the future returned by the executor. If the future
+times out it will be reported on ::flow/error.
+
+When :compute is specified transform must not block!</pre></div></div><div class="public anchor" id="var-resume"><h3>resume</h3><div class="usage"><code>(resume g)</code></div><div class="doc"><pre class="plaintext">resumes a paused flow
+</pre></div></div><div class="public anchor" id="var-resume-proc"><h3>resume-proc</h3><div class="usage"><code>(resume-proc g pid)</code></div><div class="doc"><pre class="plaintext">resumes a process
+</pre></div></div><div class="public anchor" id="var-start"><h3>start</h3><div class="usage"><code>(start g)</code></div><div class="doc"><pre class="plaintext">starts the entire flow from init values. The processes start paused.
+Call 'resume' or 'resume-proc' to start flow.  returns a map with keys:
+
+:report-chan - a core.async chan for reading.'ping' reponses
+will show up here, as will any explicit ::flow/report outputs
+from :transform/:introduce
+
+:error-chan - a core.async chan for reading. Any (and only)
+exceptions thrown anywhere on any thread inside a flow will appear
+in maps sent here. There will at least be a ::flow/ex entry with the
+exception, and may be additional keys for pid, state, status etc
+depending on the context of the error.</pre></div></div><div class="public anchor" id="var-step-process"><h3>step-process</h3><div class="usage"><code>(step-process f)</code><code>(step-process f opts)</code></div><div class="doc"><pre class="plaintext">Given a (e.g. communication-free) step function f of three
+arities (described below), and the same opts as 'process', returns a
+launcher that creates a process compliant with the process
+protocol (see 'process').
+
+The arities of f are:
+
+()-&gt;desc
+a function matching the semantics of process' :describe
+
+(arg-map)-&gt;initial-state
+a function matching the semantics of process' :init
+
+(state in-name msg)-&gt;[state' output]
+a function matching the semantics of process' :transform</pre></div></div><div class="public anchor" id="var-stop"><h3>stop</h3><div class="usage"><code>(stop g)</code></div><div class="doc"><pre class="plaintext">shuts down the flow, stopping all procsesses and closing the error
+and report channels. The flow can be started again</pre></div></div></div></body></html>
\ No newline at end of file
diff --git a/apidocs/clojure.core.async.flow.spi.html b/apidocs/clojure.core.async.flow.spi.html
new file mode 100644
index 0000000..e9048a6
--- /dev/null
+++ b/apidocs/clojure.core.async.flow.spi.html
@@ -0,0 +1,74 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+be needed for ordinary use of the library. This protocol is for
+creating new types of Processes that are not possible to create
+with ::flow/process.
+
+A ProcLauncher is a constructor for a process, a thread of activity.
+It has two functions - to describe the parameters and input/output
+requirements of the process and to start it. The launcher should
+acquire no resources, nor retain any connection to the started
+process. A launcher may be called upon to start a process more than
+once, and should start a new process each time start is called.
+
+The process launched process must obey the following:
+
+It must have 2 logical statuses, :paused and :running. In
+the :paused status operation is suspended and no output is
+produced.
+
+When the process starts it must be :paused
+
+Whenever it is reading or writing to any channel a process must use
+alts!! and include a read of the ::flow/control channel, giving it
+priority.
+
+Command messages sent over the ::flow/control channel have the keys:
+::flow/to - either ::flow/all or a process id
+::flow/command - ::flow/stop|pause|resume|ping or process-specific
+
+It must act upon any, and only, control messages whose ::flow/to key is its pid or ::flow/all
+It must act upon the following values of ::flow/command:
+
+::flow/stop - all resources should be cleaned up and any thread(s)
+   should exit ordinarily - there will be no more subsequent use
+   of the process.
+::flow/pause - enter the :paused status
+::flow/resume - enter the :running status and resume processing
+::flow/ping - emit a ping message (format TBD) to
+   the ::flow/report channel containing at least its pid and status
+
+A process can define and respond to other commands in its own namespace.
+
+A process should not transmit channel objects (use [pid io-id] data
+coordinates instead) A process should not close channels
+
+Finally, if a process encounters an error it must report it on the
+::flow/error channel (format TBD) and attempt to continue, though it
+may subsequently get a ::flow/stop command it must respect</pre></div><div class="members"><h4>members</h4><div class="inner"><div class="public anchor" id="var-describe"><h3>describe</h3><div class="usage"><code>(describe p)</code></div><div class="doc"><pre class="plaintext">returns a map with keys - :params, :ins and :outs,
+each of which in turn is a map of keyword to docstring
+
+:params describes the initial arguments to setup the state for the process
+:ins enumerates the input[s], for which the graph will create channels
+:outs enumerates the output[s], for which the graph may create channels.
+
+describe may be called by users to understand how to use the
+proc. It will also be called by the impl in order to discover what
+channels are needed.</pre></div></div><div class="public anchor" id="var-start"><h3>start</h3><div class="usage"><code>(start p {:keys [pid args ins outs resolver]})</code></div><div class="doc"><pre class="plaintext">return ignored, called for the
+effect of starting the process (typically, starting its thread)
+
+where:
+
+:pid - the id of the process in the graph, so that e.g. it can refer to itself in control, reporting etc
+:args - a map of param-&gt;val,  as supplied in the graph def
+:ins - a map of in-id-&gt;readable-channel, plus the ::flow/control channel
+:outs - a map of out-id-&gt;writeable-channel, plus the ::flow/error and ::flow/report channels
+        N.B. outputs may be nil if not connected
+:resolver - an impl of spi/Resolver, which can be used to find
+            channels given their logical [pid cid] coordinates, as well as to
+            obtain ExecutorServices corresponding to the
+            logical :mixed/:io/:compute contexts</pre></div></div></div></div></div><div class="public anchor" id="var-Resolver"><h3>Resolver</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext"></pre></div><div class="members"><h4>members</h4><div class="inner"><div class="public anchor" id="var-get-exec"><h3>get-exec</h3><div class="usage"><code>(get-exec _ context)</code></div><div class="doc"><pre class="plaintext">returns the ExecutorService for the given context, one
+of :mixed, :io, :compute</pre></div></div><div class="public anchor" id="var-get-write-chan"><h3>get-write-chan</h3><div class="usage"><code>(get-write-chan _ coord)</code></div><div class="doc"><pre class="plaintext">Given a tuple of [pid cid], returns a core.async chan to
+write to or nil (in which case the output should be dropped,
+e.g. nothing is connected).</pre></div></div></div></div></div></div></body></html>
\ No newline at end of file
diff --git a/apidocs/clojure.core.async.html b/apidocs/clojure.core.async.html
new file mode 100644
index 0000000..64fc4ef
--- /dev/null
+++ b/apidocs/clojure.core.async.html
@@ -0,0 +1,270 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3 current"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+
+go blocks are dispatched over an internal thread pool, which
+defaults to 8 threads. The size of this pool can be modified using
+the Java system property `clojure.core.async.pool-size`.
+
+Set Java system property `clojure.core.async.go-checking` to true
+to validate go blocks do not invoke core.async blocking operations.
+Property is read once, at namespace load time. Recommended for use
+primarily during development. Invalid blocking calls will throw in
+go block threads - use Thread.setDefaultUncaughtExceptionHandler()
+to catch and handle.</pre></div><div class="public anchor" id="var-.3C.21"><h3>&lt;!</h3><div class="usage"><code>(&lt;! port)</code></div><div class="doc"><pre class="plaintext">takes a val from port. Must be called inside a (go ...) block. Will
+return nil if closed. Will park if nothing is available.</pre></div></div><div class="public anchor" id="var-.3C.21.21"><h3>&lt;!!</h3><div class="usage"><code>(&lt;!! port)</code></div><div class="doc"><pre class="plaintext">takes a val from port. Will return nil if closed. Will block
+if nothing is available.
+Not intended for use in direct or transitive calls from (go ...) blocks.
+Use the clojure.core.async.go-checking flag to detect invalid use (see
+namespace docs).</pre></div></div><div class="public anchor" id="var-.3E.21"><h3>&gt;!</h3><div class="usage"><code>(&gt;! port val)</code></div><div class="doc"><pre class="plaintext">puts a val into port. nil values are not allowed. Must be called
+inside a (go ...) block. Will park if no buffer space is available.
+Returns true unless port is already closed.</pre></div></div><div class="public anchor" id="var-.3E.21.21"><h3>&gt;!!</h3><div class="usage"><code>(&gt;!! port val)</code></div><div class="doc"><pre class="plaintext">puts a val into port. nil values are not allowed. Will block if no
+buffer space is available. Returns true unless port is already closed.
+Not intended for use in direct or transitive calls from (go ...) blocks.
+Use the clojure.core.async.go-checking flag to detect invalid use (see
+namespace docs).</pre></div></div><div class="public anchor" id="var-admix"><h3>admix</h3><div class="usage"><code>(admix mix ch)</code></div><div class="doc"><pre class="plaintext">Adds ch as an input to the mix
+</pre></div></div><div class="public anchor" id="var-alt.21"><h3>alt!</h3><h4 class="type">macro</h4><div class="usage"><code>(alt! &amp; clauses)</code></div><div class="doc"><pre class="plaintext">Makes a single choice between one of several channel operations,
+as if by alts!, returning the value of the result expr corresponding
+to the operation completed. Must be called inside a (go ...) block.
+
+Each clause takes the form of:
+
+channel-op[s] result-expr
+
+where channel-ops is one of:
+
+take-port - a single port to take
+[take-port | [put-port put-val] ...] - a vector of ports as per alts!
+:default | :priority - an option for alts!
+
+and result-expr is either a list beginning with a vector, whereupon that
+vector will be treated as a binding for the [val port] return of the
+operation, else any other expression.
+
+(alt!
+  [c t] ([val ch] (foo ch val))
+  x ([v] v)
+  [[out val]] :wrote
+  :default 42)
+
+Each option may appear at most once. The choice and parking
+characteristics are those of alts!.</pre></div></div><div class="public anchor" id="var-alt.21.21"><h3>alt!!</h3><h4 class="type">macro</h4><div class="usage"><code>(alt!! &amp; clauses)</code></div><div class="doc"><pre class="plaintext">Like alt!, except as if by alts!!, will block until completed, and
+not intended for use in (go ...) blocks.</pre></div></div><div class="public anchor" id="var-alts.21"><h3>alts!</h3><div class="usage"><code>(alts! ports &amp; {:as opts})</code></div><div class="doc"><pre class="plaintext">Completes at most one of several channel operations. Must be called
+inside a (go ...) block. ports is a vector of channel endpoints,
+which can be either a channel to take from or a vector of
+[channel-to-put-to val-to-put], in any combination. Takes will be
+made as if by &lt;!, and puts will be made as if by &gt;!. Unless
+the :priority option is true, if more than one port operation is
+ready a non-deterministic choice will be made. If no operation is
+ready and a :default value is supplied, [default-val :default] will
+be returned, otherwise alts! will park until the first operation to
+become ready completes. Returns [val port] of the completed
+operation, where val is the value taken for takes, and a
+boolean (true unless already closed, as per put!) for puts.
+
+opts are passed as :key val ... Supported options:
+
+:default val - the value to use if none of the operations are immediately ready
+:priority true - (default nil) when true, the operations will be tried in order.
+
+Note: there is no guarantee that the port exps or val exprs will be
+used, nor in what order should they be, so they should not be
+depended upon for side effects.</pre></div></div><div class="public anchor" id="var-alts.21.21"><h3>alts!!</h3><div class="usage"><code>(alts!! ports &amp; opts)</code></div><div class="doc"><pre class="plaintext">Like alts!, except takes will be made as if by &lt;!!, and puts will
+be made as if by &gt;!!, will block until completed.
+Not intended for use in direct or transitive calls from (go ...) blocks.
+Use the clojure.core.async.go-checking flag to detect invalid use (see
+namespace docs).</pre></div></div><div class="public anchor" id="var-buffer"><h3>buffer</h3><div class="usage"><code>(buffer n)</code></div><div class="doc"><pre class="plaintext">Returns a fixed buffer of size n. When full, puts will block/park.
+</pre></div></div><div class="public anchor" id="var-chan"><h3>chan</h3><div class="usage"><code>(chan)</code><code>(chan buf-or-n)</code><code>(chan buf-or-n xform)</code><code>(chan buf-or-n xform ex-handler)</code></div><div class="doc"><pre class="plaintext">Creates a channel with an optional buffer, an optional transducer
+(like (map f), (filter p) etc or a composition thereof), and an
+optional exception-handler.  If buf-or-n is a number, will create
+and use a fixed buffer of that size. If a transducer is supplied a
+buffer must be specified. ex-handler must be a fn of one argument -
+if an exception occurs during transformation it will be called with
+the Throwable as an argument, and any non-nil return value will be
+placed in the channel.</pre></div></div><div class="public anchor" id="var-close.21"><h3>close!</h3><div class="usage"><code>(close! chan)</code></div><div class="doc"><pre class="plaintext">Closes a channel. The channel will no longer accept any puts (they
+will be ignored). Data in the channel remains available for taking, until
+exhausted, after which takes will return nil. If there are any
+pending takes, they will be dispatched with nil. Closing a closed
+channel is a no-op. Returns nil.
+
+Logically closing happens after all puts have been delivered. Therefore, any
+blocked or parked puts will remain blocked/parked until a taker releases them.</pre></div></div><div class="public anchor" id="var-defblockingop"><h3>defblockingop</h3><h4 class="type">macro</h4><div class="usage"><code>(defblockingop op doc arglist &amp; body)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-do-alt"><h3>do-alt</h3><div class="usage"><code>(do-alt alts clauses)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-do-alts"><h3>do-alts</h3><div class="usage"><code>(do-alts fret ports opts)</code></div><div class="doc"><pre class="plaintext">returns derefable [val port] if immediate, nil if enqueued
+</pre></div></div><div class="public anchor" id="var-dropping-buffer"><h3>dropping-buffer</h3><div class="usage"><code>(dropping-buffer n)</code></div><div class="doc"><pre class="plaintext">Returns a buffer of size n. When full, puts will complete but
+val will be dropped (no transfer).</pre></div></div><div class="public anchor" id="var-fn-handler"><h3>fn-handler</h3><div class="usage"><code>(fn-handler f)</code><code>(fn-handler f blockable)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-go"><h3>go</h3><h4 class="type">macro</h4><div class="usage"><code>(go &amp; body)</code></div><div class="doc"><pre class="plaintext">Asynchronously executes the body, returning immediately to the
+calling thread. Additionally, any visible calls to &lt;!, &gt;! and alt!/alts!
+channel operations within the body will block (if necessary) by
+'parking' the calling thread rather than tying up an OS thread (or
+the only JS thread when in ClojureScript). Upon completion of the
+operation, the body will be resumed.
+
+go blocks should not (either directly or indirectly) perform operations
+that may block indefinitely. Doing so risks depleting the fixed pool of
+go block threads, causing all go block processing to stop. This includes
+core.async blocking ops (those ending in !!) and other blocking IO.
+
+Returns a channel which will receive the result of the body when
+completed</pre></div></div><div class="public anchor" id="var-go-loop"><h3>go-loop</h3><h4 class="type">macro</h4><div class="usage"><code>(go-loop bindings &amp; body)</code></div><div class="doc"><pre class="plaintext">Like (go (loop ...))
+</pre></div></div><div class="public anchor" id="var-into"><h3>into</h3><div class="usage"><code>(into coll ch)</code></div><div class="doc"><pre class="plaintext">Returns a channel containing the single (collection) result of the
+items taken from the channel conjoined to the supplied
+collection. ch must close before into produces a result.</pre></div></div><div class="public anchor" id="var-ioc-alts.21"><h3>ioc-alts!</h3><div class="usage"><code>(ioc-alts! state cont-block ports &amp; {:as opts})</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-map"><h3>map</h3><div class="usage"><code>(map f chs)</code><code>(map f chs buf-or-n)</code></div><div class="doc"><pre class="plaintext">Takes a function and a collection of source channels, and returns a
+channel which contains the values produced by applying f to the set
+of first items taken from each source channel, followed by applying
+f to the set of second items from each channel, until any one of the
+channels is closed, at which point the output channel will be
+closed. The returned channel will be unbuffered by default, or a
+buf-or-n can be supplied</pre></div></div><div class="public anchor" id="var-merge"><h3>merge</h3><div class="usage"><code>(merge chs)</code><code>(merge chs buf-or-n)</code></div><div class="doc"><pre class="plaintext">Takes a collection of source channels and returns a channel which
+contains all values taken from them. The returned channel will be
+unbuffered by default, or a buf-or-n can be supplied. The channel
+will close after all the source channels have closed.</pre></div></div><div class="public anchor" id="var-Mix"><h3>Mix</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext"></pre></div><div class="members"><h4>members</h4><div class="inner"><div class="public anchor" id="var-admix*"><h3>admix*</h3><div class="usage"><code>(admix* m ch)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-solo-mode*"><h3>solo-mode*</h3><div class="usage"><code>(solo-mode* m mode)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-toggle*"><h3>toggle*</h3><div class="usage"><code>(toggle* m state-map)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-unmix*"><h3>unmix*</h3><div class="usage"><code>(unmix* m ch)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-unmix-all*"><h3>unmix-all*</h3><div class="usage"><code>(unmix-all* m)</code></div><div class="doc"><pre class="plaintext"></pre></div></div></div></div></div><div class="public anchor" id="var-mix"><h3>mix</h3><div class="usage"><code>(mix out)</code></div><div class="doc"><pre class="plaintext">Creates and returns a mix of one or more input channels which will
+be put on the supplied out channel. Input sources can be added to
+the mix with 'admix', and removed with 'unmix'. A mix supports
+soloing, muting and pausing multiple inputs atomically using
+'toggle', and can solo using either muting or pausing as determined
+by 'solo-mode'.
+
+Each channel can have zero or more boolean modes set via 'toggle':
+
+:solo - when true, only this (ond other soloed) channel(s) will appear
+        in the mix output channel. :mute and :pause states of soloed
+        channels are ignored. If solo-mode is :mute, non-soloed
+        channels are muted, if :pause, non-soloed channels are
+        paused.
+
+:mute - muted channels will have their contents consumed but not included in the mix
+:pause - paused channels will not have their contents consumed (and thus also not included in the mix)</pre></div></div><div class="public anchor" id="var-Mult"><h3>Mult</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext"></pre></div><div class="members"><h4>members</h4><div class="inner"><div class="public anchor" id="var-tap*"><h3>tap*</h3><div class="usage"><code>(tap* m ch close?)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-untap*"><h3>untap*</h3><div class="usage"><code>(untap* m ch)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-untap-all*"><h3>untap-all*</h3><div class="usage"><code>(untap-all* m)</code></div><div class="doc"><pre class="plaintext"></pre></div></div></div></div></div><div class="public anchor" id="var-mult"><h3>mult</h3><div class="usage"><code>(mult ch)</code></div><div class="doc"><pre class="plaintext">Creates and returns a mult(iple) of the supplied channel. Channels
+containing copies of the channel can be created with 'tap', and
+detached with 'untap'.
+
+Each item is distributed to all taps in parallel and synchronously,
+i.e. each tap must accept before the next item is distributed. Use
+buffering/windowing to prevent slow taps from holding up the mult.
+
+Items received when there are no taps get dropped.
+
+If a tap puts to a closed channel, it will be removed from the mult.</pre></div></div><div class="public anchor" id="var-Mux"><h3>Mux</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext"></pre></div><div class="members"><h4>members</h4><div class="inner"><div class="public anchor" id="var-muxch*"><h3>muxch*</h3><div class="usage"><code>(muxch* _)</code></div><div class="doc"><pre class="plaintext"></pre></div></div></div></div></div><div class="public anchor" id="var-offer.21"><h3>offer!</h3><div class="usage"><code>(offer! port val)</code></div><div class="doc"><pre class="plaintext">Puts a val into port if it's possible to do so immediately.
+nil values are not allowed. Never blocks. Returns true if offer succeeds.</pre></div></div><div class="public anchor" id="var-onto-chan"><h3>onto-chan</h3><h4 class="deprecated">deprecated in 1.2</h4><div class="usage"><code>(onto-chan ch coll)</code><code>(onto-chan ch coll close?)</code></div><div class="doc"><pre class="plaintext">Deprecated - use onto-chan! or onto-chan!!
+</pre></div></div><div class="public anchor" id="var-onto-chan.21"><h3>onto-chan!</h3><div class="usage"><code>(onto-chan! ch coll)</code><code>(onto-chan! ch coll close?)</code></div><div class="doc"><pre class="plaintext">Puts the contents of coll into the supplied channel.
+
+By default the channel will be closed after the items are copied,
+but can be determined by the close? parameter.
+
+Returns a channel which will close after the items are copied.
+
+If accessing coll might block, use onto-chan!! instead</pre></div></div><div class="public anchor" id="var-onto-chan.21.21"><h3>onto-chan!!</h3><div class="usage"><code>(onto-chan!! ch coll)</code><code>(onto-chan!! ch coll close?)</code></div><div class="doc"><pre class="plaintext">Like onto-chan! for use when accessing coll might block,
+e.g. a lazy seq of blocking operations</pre></div></div><div class="public anchor" id="var-pipe"><h3>pipe</h3><div class="usage"><code>(pipe from to)</code><code>(pipe from to close?)</code></div><div class="doc"><pre class="plaintext">Takes elements from the from channel and supplies them to the to
+channel. By default, the to channel will be closed when the from
+channel closes, but can be determined by the close?  parameter. Will
+stop consuming the from channel if the to channel closes</pre></div></div><div class="public anchor" id="var-pipeline"><h3>pipeline</h3><div class="usage"><code>(pipeline n to xf from)</code><code>(pipeline n to xf from close?)</code><code>(pipeline n to xf from close? ex-handler)</code></div><div class="doc"><pre class="plaintext">Takes elements from the from channel and supplies them to the to
+channel, subject to the transducer xf, with parallelism n. Because
+it is parallel, the transducer will be applied independently to each
+element, not across elements, and may produce zero or more outputs
+per input.  Outputs will be returned in order relative to the
+inputs. By default, the to channel will be closed when the from
+channel closes, but can be determined by the close?  parameter. Will
+stop consuming the from channel if the to channel closes. Note this
+should be used for computational parallelism. If you have multiple
+blocking operations to put in flight, use pipeline-blocking instead,
+If you have multiple asynchronous operations to put in flight, use
+pipeline-async instead. See chan for semantics of ex-handler.</pre></div></div><div class="public anchor" id="var-pipeline-async"><h3>pipeline-async</h3><div class="usage"><code>(pipeline-async n to af from)</code><code>(pipeline-async n to af from close?)</code></div><div class="doc"><pre class="plaintext">Takes elements from the from channel and supplies them to the to
+channel, subject to the async function af, with parallelism n. af
+must be a function of two arguments, the first an input value and
+the second a channel on which to place the result(s). The
+presumption is that af will return immediately, having launched some
+asynchronous operation whose completion/callback will put results on
+the channel, then close! it. Outputs will be returned in order
+relative to the inputs. By default, the to channel will be closed
+when the from channel closes, but can be determined by the close?
+parameter. Will stop consuming the from channel if the to channel
+closes. See also pipeline, pipeline-blocking.</pre></div></div><div class="public anchor" id="var-pipeline-blocking"><h3>pipeline-blocking</h3><div class="usage"><code>(pipeline-blocking n to xf from)</code><code>(pipeline-blocking n to xf from close?)</code><code>(pipeline-blocking n to xf from close? ex-handler)</code></div><div class="doc"><pre class="plaintext">Like pipeline, for blocking operations.
+</pre></div></div><div class="public anchor" id="var-poll.21"><h3>poll!</h3><div class="usage"><code>(poll! port)</code></div><div class="doc"><pre class="plaintext">Takes a val from port if it's possible to do so immediately.
+Never blocks. Returns value if successful, nil otherwise.</pre></div></div><div class="public anchor" id="var-promise-chan"><h3>promise-chan</h3><div class="usage"><code>(promise-chan)</code><code>(promise-chan xform)</code><code>(promise-chan xform ex-handler)</code></div><div class="doc"><pre class="plaintext">Creates a promise channel with an optional transducer, and an optional
+exception-handler. A promise channel can take exactly one value that consumers
+will receive. Once full, puts complete but val is dropped (no transfer).
+Consumers will block until either a value is placed in the channel or the
+channel is closed, then return the value (or nil) forever. See chan for the
+semantics of xform and ex-handler.</pre></div></div><div class="public anchor" id="var-Pub"><h3>Pub</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext"></pre></div><div class="members"><h4>members</h4><div class="inner"><div class="public anchor" id="var-sub*"><h3>sub*</h3><div class="usage"><code>(sub* p v ch close?)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-unsub*"><h3>unsub*</h3><div class="usage"><code>(unsub* p v ch)</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-unsub-all*"><h3>unsub-all*</h3><div class="usage"><code>(unsub-all* p)</code><code>(unsub-all* p v)</code></div><div class="doc"><pre class="plaintext"></pre></div></div></div></div></div><div class="public anchor" id="var-pub"><h3>pub</h3><div class="usage"><code>(pub ch topic-fn)</code><code>(pub ch topic-fn buf-fn)</code></div><div class="doc"><pre class="plaintext">Creates and returns a pub(lication) of the supplied channel,
+partitioned into topics by the topic-fn. topic-fn will be applied to
+each value on the channel and the result will determine the 'topic'
+on which that value will be put. Channels can be subscribed to
+receive copies of topics using 'sub', and unsubscribed using
+'unsub'. Each topic will be handled by an internal mult on a
+dedicated channel. By default these internal channels are
+unbuffered, but a buf-fn can be supplied which, given a topic,
+creates a buffer with desired properties.
+
+Each item is distributed to all subs in parallel and synchronously,
+i.e. each sub must accept before the next item is distributed. Use
+buffering/windowing to prevent slow subs from holding up the pub.
+
+Items received when there are no matching subs get dropped.
+
+Note that if buf-fns are used then each topic is handled
+asynchronously, i.e. if a channel is subscribed to more than one
+topic it should not expect them to be interleaved identically with
+the source.</pre></div></div><div class="public anchor" id="var-put.21"><h3>put!</h3><div class="usage"><code>(put! port val)</code><code>(put! port val fn1)</code><code>(put! port val fn1 on-caller?)</code></div><div class="doc"><pre class="plaintext">Asynchronously puts a val into port, calling fn1 (if supplied) when
+complete, passing false iff port is already closed. nil values are
+not allowed. If on-caller? (default true) is true, and the put is
+immediately accepted, will call fn1 on calling thread.
+
+fn1 may be run in a fixed-size dispatch thread pool and should not
+perform blocking IO, including core.async blocking ops (those that
+end in !!).
+
+Returns true unless port is already closed.</pre></div></div><div class="public anchor" id="var-reduce"><h3>reduce</h3><div class="usage"><code>(reduce f init ch)</code></div><div class="doc"><pre class="plaintext">f should be a function of 2 arguments. Returns a channel containing
+the single result of applying f to init and the first item from the
+channel, then applying f to that result and the 2nd item, etc. If
+the channel closes without yielding items, returns init and f is not
+called. ch must close before reduce produces a result.</pre></div></div><div class="public anchor" id="var-sliding-buffer"><h3>sliding-buffer</h3><div class="usage"><code>(sliding-buffer n)</code></div><div class="doc"><pre class="plaintext">Returns a buffer of size n. When full, puts will complete, and be
+buffered, but oldest elements in buffer will be dropped (not
+transferred).</pre></div></div><div class="public anchor" id="var-solo-mode"><h3>solo-mode</h3><div class="usage"><code>(solo-mode mix mode)</code></div><div class="doc"><pre class="plaintext">Sets the solo mode of the mix. mode must be one of :mute or :pause
+</pre></div></div><div class="public anchor" id="var-split"><h3>split</h3><div class="usage"><code>(split p ch)</code><code>(split p ch t-buf-or-n f-buf-or-n)</code></div><div class="doc"><pre class="plaintext">Takes a predicate and a source channel and returns a vector of two
+channels, the first of which will contain the values for which the
+predicate returned true, the second those for which it returned
+false.
+
+The out channels will be unbuffered by default, or two buf-or-ns can
+be supplied. The channels will close after the source channel has
+closed.</pre></div></div><div class="public anchor" id="var-sub"><h3>sub</h3><div class="usage"><code>(sub p topic ch)</code><code>(sub p topic ch close?)</code></div><div class="doc"><pre class="plaintext">Subscribes a channel to a topic of a pub.
+
+By default the channel will be closed when the source closes,
+but can be determined by the close? parameter.</pre></div></div><div class="public anchor" id="var-take"><h3>take</h3><div class="usage"><code>(take n ch)</code><code>(take n ch buf-or-n)</code></div><div class="doc"><pre class="plaintext">Returns a channel that will return, at most, n items from ch. After n items
+ have been returned, or ch has been closed, the return channel will close.
+
+The output channel is unbuffered by default, unless buf-or-n is given.</pre></div></div><div class="public anchor" id="var-take.21"><h3>take!</h3><div class="usage"><code>(take! port fn1)</code><code>(take! port fn1 on-caller?)</code></div><div class="doc"><pre class="plaintext">Asynchronously takes a val from port, passing to fn1. Will pass nil
+if closed. If on-caller? (default true) is true, and value is
+immediately available, will call fn1 on calling thread.
+
+fn1 may be run in a fixed-size dispatch thread pool and should not
+perform blocking IO, including core.async blocking ops (those that
+end in !!).
+
+Returns nil.</pre></div></div><div class="public anchor" id="var-tap"><h3>tap</h3><div class="usage"><code>(tap mult ch)</code><code>(tap mult ch close?)</code></div><div class="doc"><pre class="plaintext">Copies the mult source onto the supplied channel.
+
+By default the channel will be closed when the source closes,
+but can be determined by the close? parameter.</pre></div></div><div class="public anchor" id="var-thread"><h3>thread</h3><h4 class="type">macro</h4><div class="usage"><code>(thread &amp; body)</code></div><div class="doc"><pre class="plaintext">Executes the body in another thread, returning immediately to the
+calling thread. Returns a channel which will receive the result of
+the body when completed, then close.</pre></div></div><div class="public anchor" id="var-thread-call"><h3>thread-call</h3><div class="usage"><code>(thread-call f)</code></div><div class="doc"><pre class="plaintext">Executes f in another thread, returning immediately to the calling
+thread. Returns a channel which will receive the result of calling
+f when completed, then close.</pre></div></div><div class="public anchor" id="var-timeout"><h3>timeout</h3><div class="usage"><code>(timeout msecs)</code></div><div class="doc"><pre class="plaintext">Returns a channel that will close after msecs
+</pre></div></div><div class="public anchor" id="var-to-chan"><h3>to-chan</h3><h4 class="deprecated">deprecated in 1.2</h4><div class="usage"><code>(to-chan coll)</code></div><div class="doc"><pre class="plaintext">Deprecated - use to-chan! or to-chan!!
+</pre></div></div><div class="public anchor" id="var-to-chan.21"><h3>to-chan!</h3><div class="usage"><code>(to-chan! coll)</code></div><div class="doc"><pre class="plaintext">Creates and returns a channel which contains the contents of coll,
+closing when exhausted.
+
+If accessing coll might block, use to-chan!! instead</pre></div></div><div class="public anchor" id="var-to-chan.21.21"><h3>to-chan!!</h3><div class="usage"><code>(to-chan!! coll)</code></div><div class="doc"><pre class="plaintext">Like to-chan! for use when accessing coll might block,
+e.g. a lazy seq of blocking operations</pre></div></div><div class="public anchor" id="var-toggle"><h3>toggle</h3><div class="usage"><code>(toggle mix state-map)</code></div><div class="doc"><pre class="plaintext">Atomically sets the state(s) of one or more channels in a mix. The
+state map is a map of channels -&gt; channel-state-map. A
+channel-state-map is a map of attrs -&gt; boolean, where attr is one or
+more of :mute, :pause or :solo. Any states supplied are merged with
+the current state.
+
+Note that channels can be added to a mix via toggle, which can be
+used to add channels in a particular (e.g. paused) state.</pre></div></div><div class="public anchor" id="var-transduce"><h3>transduce</h3><div class="usage"><code>(transduce xform f init ch)</code></div><div class="doc"><pre class="plaintext">async/reduces a channel with a transformation (xform f).
+Returns a channel containing the result.  ch must close before
+transduce produces a result.</pre></div></div><div class="public anchor" id="var-unblocking-buffer.3F"><h3>unblocking-buffer?</h3><div class="usage"><code>(unblocking-buffer? buff)</code></div><div class="doc"><pre class="plaintext">Returns true if a channel created with buff will never block. That is to say,
+puts into this buffer will never cause the buffer to be full. </pre></div></div><div class="public anchor" id="var-unmix"><h3>unmix</h3><div class="usage"><code>(unmix mix ch)</code></div><div class="doc"><pre class="plaintext">Removes ch as an input to the mix
+</pre></div></div><div class="public anchor" id="var-unmix-all"><h3>unmix-all</h3><div class="usage"><code>(unmix-all mix)</code></div><div class="doc"><pre class="plaintext">removes all inputs from the mix
+</pre></div></div><div class="public anchor" id="var-unsub"><h3>unsub</h3><div class="usage"><code>(unsub p topic ch)</code></div><div class="doc"><pre class="plaintext">Unsubscribes a channel from a topic of a pub
+</pre></div></div><div class="public anchor" id="var-unsub-all"><h3>unsub-all</h3><div class="usage"><code>(unsub-all p)</code><code>(unsub-all p topic)</code></div><div class="doc"><pre class="plaintext">Unsubscribes all channels from a pub, or a topic of a pub
+</pre></div></div><div class="public anchor" id="var-untap"><h3>untap</h3><div class="usage"><code>(untap mult ch)</code></div><div class="doc"><pre class="plaintext">Disconnects a target channel from a mult
+</pre></div></div><div class="public anchor" id="var-untap-all"><h3>untap-all</h3><div class="usage"><code>(untap-all mult)</code></div><div class="doc"><pre class="plaintext">Disconnects all target channels from a mult
+</pre></div></div></div></body></html>
\ No newline at end of file
diff --git a/apidocs/css/default.css b/apidocs/css/default.css
new file mode 100644
index 0000000..33f78fe
--- /dev/null
+++ b/apidocs/css/default.css
@@ -0,0 +1,551 @@
+body {
+    font-family: Helvetica, Arial, sans-serif;
+    font-size: 15px;
+}
+
+pre, code {
+    font-family: Monaco, DejaVu Sans Mono, Consolas, monospace;
+    font-size: 9pt;
+    margin: 15px 0;
+}
+
+h1 {
+    font-weight: normal;
+    font-size: 29px;
+    margin: 10px 0 2px 0;
+    padding: 0;
+}
+
+h2 {
+    font-weight: normal;
+    font-size: 25px;
+}
+
+h5.license {
+    margin: 9px 0 22px 0;
+    color: #555;
+    font-weight: normal;
+    font-size: 12px;
+    font-style: italic;
+}
+
+.document h1, .namespace-index h1 {
+    font-size: 32px;
+    margin-top: 12px;
+}
+
+#header, #content, .sidebar {
+    position: fixed;
+}
+
+#header {
+    top: 0;
+    left: 0;
+    right: 0;
+    height: 22px;
+    color: #f5f5f5;
+    padding: 5px 7px;
+}
+
+#content {
+    top: 32px;
+    right: 0;
+    bottom: 0;
+    overflow: auto;
+    background: #fff;
+    color: #333;
+    padding: 0 18px;
+}
+
+.sidebar {
+    position: fixed;
+    top: 32px;
+    bottom: 0;
+    overflow: auto;
+}
+
+.sidebar.primary {
+    background: #e2e2e2;
+    border-right: solid 1px #cccccc;
+    left: 0;
+    width: 250px;
+}
+
+.sidebar.secondary {
+    background: #f2f2f2;
+    border-right: solid 1px #d7d7d7;
+    left: 251px;
+    width: 200px;
+}
+
+#content.namespace-index, #content.document {
+    left: 251px;
+}
+
+#content.namespace-docs {
+    left: 452px;
+}
+
+#content.document {
+    padding-bottom: 10%;
+}
+
+#header {
+    background: #3f3f3f;
+    box-shadow: 0 0 8px rgba(0, 0, 0, 0.4);
+    z-index: 100;
+}
+
+#header h1 {
+    margin: 0;
+    padding: 0;
+    font-size: 18px;
+    font-weight: lighter;
+    text-shadow: -1px -1px 0px #333;
+}
+
+#header h1 .project-version {
+    font-weight: normal;
+}
+
+.project-version {
+    padding-left: 0.15em;
+}
+
+#header a, .sidebar a {
+    display: block;
+    text-decoration: none;
+}
+
+#header a {
+    color: #f5f5f5;
+}
+
+.sidebar a {
+    color: #333;
+}
+
+#header h2 {
+    float: right;
+    font-size: 9pt;
+    font-weight: normal;
+    margin: 4px 3px;
+    padding: 0;
+    color: #bbb;
+}
+
+#header h2 a {
+    display: inline;
+}
+
+.sidebar h3 {
+    margin: 0;
+    padding: 10px 13px 0 13px;
+    font-size: 19px;
+    font-weight: lighter;
+}
+
+.sidebar h3 a {
+    color: #444;
+}
+
+.sidebar h3.no-link {
+    color: #636363;
+}
+
+.sidebar ul {
+    padding: 7px 0 6px 0;
+    margin: 0;
+}
+
+.sidebar ul.index-link {
+    padding-bottom: 4px;
+}
+
+.sidebar li {
+    display: block;
+    vertical-align: middle;
+}
+
+.sidebar li a, .sidebar li .no-link {
+    border-left: 3px solid transparent;
+    padding: 0 10px;
+    white-space: nowrap;
+}
+
+.sidebar li .no-link {
+    display: block;
+    color: #777;
+    font-style: italic;
+}
+
+.sidebar li .inner {
+    display: inline-block;
+    padding-top: 7px;
+    height: 24px;
+}
+
+.sidebar li a, .sidebar li .tree {
+    height: 31px;
+}
+
+.depth-1 .inner { padding-left: 2px; }
+.depth-2 .inner { padding-left: 6px; }
+.depth-3 .inner { padding-left: 20px; }
+.depth-4 .inner { padding-left: 34px; }
+.depth-5 .inner { padding-left: 48px; }
+.depth-6 .inner { padding-left: 62px; }
+
+.sidebar li .tree {
+    display: block;
+    float: left;
+    position: relative;
+    top: -10px;
+    margin: 0 4px 0 0;
+    padding: 0;
+}
+
+.sidebar li.depth-1 .tree {
+    display: none;
+}
+
+.sidebar li .tree .top, .sidebar li .tree .bottom {
+    display: block;
+    margin: 0;
+    padding: 0;
+    width: 7px;
+}
+
+.sidebar li .tree .top {
+    border-left: 1px solid #aaa;
+    border-bottom: 1px solid #aaa;
+    height: 19px;
+}
+
+.sidebar li .tree .bottom {
+    height: 22px;
+}
+
+.sidebar li.branch .tree .bottom {
+    border-left: 1px solid #aaa;
+}
+
+.sidebar.primary li.current a {
+    border-left: 3px solid #a33;
+    color: #a33;
+}
+
+.sidebar.secondary li.current a {
+    border-left: 3px solid #33a;
+    color: #33a;
+}
+
+.namespace-index h2 {
+    margin: 30px 0 0 0;
+}
+
+.namespace-index h3 {
+    font-size: 16px;
+    font-weight: bold;
+    margin-bottom: 0;
+}
+
+.namespace-index .topics {
+    padding-left: 30px;
+    margin: 11px 0 0 0;
+}
+
+.namespace-index .topics li {
+    padding: 5px 0;
+}
+
+.namespace-docs h3 {
+    font-size: 18px;
+    font-weight: bold;
+}
+
+.public h3 {
+    margin: 0;
+    float: left;
+}
+
+.usage {
+    clear: both;
+}
+
+.public {
+    margin: 0;
+    border-top: 1px solid #e0e0e0;
+    padding-top: 14px;
+    padding-bottom: 6px;
+}
+
+.public:last-child {
+    margin-bottom: 20%;
+}
+
+.members .public:last-child {
+    margin-bottom: 0;
+}
+
+.members {
+    margin: 15px 0;
+}
+
+.members h4 {
+    color: #555;
+    font-weight: normal;
+    font-variant: small-caps;
+    margin: 0 0 5px 0;
+}
+
+.members .inner {
+    padding-top: 5px;
+    padding-left: 12px;
+    margin-top: 2px;
+    margin-left: 7px;
+    border-left: 1px solid #bbb;
+}
+
+#content .members .inner h3 {
+    font-size: 12pt;
+}
+
+.members .public {
+    border-top: none;
+    margin-top: 0;
+    padding-top: 6px;
+    padding-bottom: 0;
+}
+
+.members .public:first-child {
+    padding-top: 0;
+}
+
+h4.type,
+h4.dynamic,
+h4.added,
+h4.deprecated {
+    float: left;
+    margin: 3px 10px 15px 0;
+    font-size: 15px;
+    font-weight: bold;
+    font-variant: small-caps;
+}
+
+.public h4.type,
+.public h4.dynamic,
+.public h4.added,
+.public h4.deprecated {
+    font-size: 13px;
+    font-weight: bold;
+    margin: 3px 0 0 10px;
+}
+
+.members h4.type,
+.members h4.added,
+.members h4.deprecated {
+    margin-top: 1px;
+}
+
+h4.type {
+    color: #717171;
+}
+
+h4.dynamic {
+    color: #9933aa;
+}
+
+h4.added {
+    color: #508820;
+}
+
+h4.deprecated {
+    color: #880000;
+}
+
+.namespace {
+    margin-bottom: 30px;
+}
+
+.namespace:last-child {
+    margin-bottom: 10%;
+}
+
+.index {
+    padding: 0;
+    font-size: 80%;
+    margin: 15px 0;
+    line-height: 16px;
+}
+
+.index * {
+    display: inline;
+}
+
+.index p {
+    padding-right: 3px;
+}
+
+.index li {
+    padding-right: 5px;
+}
+
+.index ul {
+    padding-left: 0;
+}
+
+.type-sig {
+    clear: both;
+    color: #088;
+}
+
+.type-sig pre {
+    padding-top: 10px;
+    margin: 0;
+}
+
+.usage code {
+    display: block;
+    color: #008;
+    margin: 2px 0;
+}
+
+.usage code:first-child {
+    padding-top: 10px;
+}
+
+p {
+    margin: 15px 0;
+}
+
+.public p:first-child, .public pre.plaintext {
+    margin-top: 12px;
+}
+
+.doc {
+    margin: 0 0 26px 0;
+    clear: both;
+}
+
+.public .doc {
+    margin: 0;
+}
+
+.namespace-index .doc {
+    margin-bottom: 20px;
+}
+
+.namespace-index .namespace .doc {
+    margin-bottom: 10px;
+}
+
+.markdown p, .markdown li, .markdown dt, .markdown dd, .markdown td {
+    line-height: 22px;
+}
+
+.markdown li {
+    padding: 2px 0;
+}
+
+.markdown h2 {
+    font-weight: normal;
+    font-size: 25px;
+    margin: 30px 0 10px 0;
+}
+
+.markdown h3 {
+    font-weight: normal;
+    font-size: 20px;
+    margin: 30px 0 0 0;
+}
+
+.markdown h4 {
+    font-size: 15px;
+    margin: 22px 0 -4px 0;
+}
+
+.doc, .public, .namespace .index {
+    max-width: 680px;
+    overflow-x: visible;
+}
+
+.markdown pre > code {
+    display: block;
+    padding: 10px;
+}
+
+.markdown pre > code, .src-link a {
+    border: 1px solid #e4e4e4;
+    border-radius: 2px;
+}
+
+.markdown code:not(.hljs), .src-link a {
+    background: #f6f6f6;
+}
+
+pre.deps {
+    display: inline-block;
+    margin: 0 10px;
+    border: 1px solid #e4e4e4;
+    border-radius: 2px;
+    padding: 10px;
+    background-color: #f6f6f6;
+}
+
+.markdown hr {
+    border-style: solid;
+    border-top: none;
+    color: #ccc;
+}
+
+.doc ul, .doc ol {
+    padding-left: 30px;
+}
+
+.doc table {
+    border-collapse: collapse;
+    margin: 0 10px;
+}
+
+.doc table td, .doc table th {
+    border: 1px solid #dddddd;
+    padding: 4px 6px;
+}
+
+.doc table th {
+    background: #f2f2f2;
+}
+
+.doc dl {
+    margin: 0 10px 20px 10px;
+}
+
+.doc dl dt {
+    font-weight: bold;
+    margin: 0;
+    padding: 3px 0;
+    border-bottom: 1px solid #ddd;
+}
+
+.doc dl dd {
+    padding: 5px 0;
+    margin: 0 0 5px 10px;
+}
+
+.doc abbr {
+    border-bottom: 1px dotted #333;
+    font-variant: none;
+    cursor: help;
+}
+
+.src-link {
+    margin-bottom: 15px;
+}
+
+.src-link a {
+    font-size: 70%;
+    padding: 1px 4px;
+    text-decoration: none;
+    color: #5555bb;
+}
diff --git a/apidocs/css/highlight.css b/apidocs/css/highlight.css
new file mode 100644
index 0000000..d0cdaa3
--- /dev/null
+++ b/apidocs/css/highlight.css
@@ -0,0 +1,97 @@
+/*
+github.com style (c) Vasily Polovnyov <vast@whiteants.net>
+*/
+
+.hljs {
+  display: block;
+  overflow-x: auto;
+  padding: 0.5em;
+  color: #333;
+  background: #f8f8f8;
+}
+
+.hljs-comment,
+.hljs-quote {
+  color: #998;
+  font-style: italic;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-subst {
+  color: #333;
+  font-weight: bold;
+}
+
+.hljs-number,
+.hljs-literal,
+.hljs-variable,
+.hljs-template-variable,
+.hljs-tag .hljs-attr {
+  color: #008080;
+}
+
+.hljs-string,
+.hljs-doctag {
+  color: #d14;
+}
+
+.hljs-title,
+.hljs-section,
+.hljs-selector-id {
+  color: #900;
+  font-weight: bold;
+}
+
+.hljs-subst {
+  font-weight: normal;
+}
+
+.hljs-type,
+.hljs-class .hljs-title {
+  color: #458;
+  font-weight: bold;
+}
+
+.hljs-tag,
+.hljs-name,
+.hljs-attribute {
+  color: #000080;
+  font-weight: normal;
+}
+
+.hljs-regexp,
+.hljs-link {
+  color: #009926;
+}
+
+.hljs-symbol,
+.hljs-bullet {
+  color: #990073;
+}
+
+.hljs-built_in,
+.hljs-builtin-name {
+  color: #0086b3;
+}
+
+.hljs-meta {
+  color: #999;
+  font-weight: bold;
+}
+
+.hljs-deletion {
+  background: #fdd;
+}
+
+.hljs-addition {
+  background: #dfd;
+}
+
+.hljs-emphasis {
+  font-style: italic;
+}
+
+.hljs-strong {
+  font-weight: bold;
+}
diff --git a/apidocs/flow.html b/apidocs/flow.html
new file mode 100644
index 0000000..33a5136
--- /dev/null
+++ b/apidocs/flow.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>core.async.flow #</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
+<h2><a href="#rationale" id="rationale"></a>Rationale</h2>
+<p>The <a href="https://clojure.org/news/2013/06/28/clojure-clore-async-channels">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
+<p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
+<p>The fundamental objective of <strong>core.async.flow</strong> is to enable a strict separation of your application logic from its topology, execution, communication, lifecycle, monitoring and error handling, all of which are provided by and centralized in, c.a.flow, yielding more consistent, robust, testable, observable and operable systems.</p>
+<h2><a href="#overview" id="overview"></a>Overview</h2>
+<p><strong>core.async.flow</strong> provides <em>concrete</em> implementations of two more abstractions - the ‘<strong>process</strong>’ - a thread of activity, and the ‘<strong>flow</strong>’ - a directed graph of processes communicating via channels. A single data structure describes your flow topology, and has all of the settings for threads, channels etc. A process accepts data from and provides data to channels. The process implementation in c.a.flow handles all channel I/O, thread lifecycle and coordination with the flow graph.</p>
+<p>All you need to do in you application is:</p>
+<ol>
+<li>
+<p>Define ordinary, often pure, data-&gt;data functions that the processes will run in their inner loop to do the <em>computational</em> part of processing messages. These functions do not handle channels or threads or lifecycle, and do not even know they are running in a flow. They can be tested in isolation, and hot-reloaded. If they encounter a problem they can, and should, just throw an exception. The process will take care of it from there.</p>
+</li>
+<li>
+<p>Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.</p>
+</li>
+</ol>
+<p>With these application inputs, c.a.flow does the rest. It inquires of the processes what channels they require, creates those channels, then instantiates the processes making all of the channel connections between them. The processes in turn start threads (in fully user-configurable thread pools), await inputs, monitor the admin control channel, and when inputs arrive make data-&gt;data calls to your application logic, taking the return from that and sending it to the designated output channels. The processes follow a protocol used by the flow to do lifecycle management and error handling.</p>
+<p>Once you’ve created a flow, the API provides functions to start/stop(shutdown) the flow, and to pause/resume both the flow and individual processes, to ping processes to get their state and that of their connected channels, to inject data into any point in the graph etc. The flow provides channels containing the ordinary monitoring/reporting stream and, separately, the error stream.</p>
+<p>The library provides many more details and features, including the ability to create, via ordinary functions, processes that act as <strong>sources</strong> (of data from outside the flow) or <strong>sinks</strong> (to recipients outside the flow) so you can situate your flow in a broader context while still coordinating resource management with the flow lifecycle.</p>
+<p>I hope <strong>core.async.flow</strong> enables you to write more robust and smaller applications, with more focus on your domain logic and less on plumbing.</p>
+<p>Rich Hickey 1/2025</p>
+</div></div></div></body></html>
\ No newline at end of file
diff --git a/apidocs/index.html b/apidocs/index.html
new file mode 100644
index 0000000..b7367fc
--- /dev/null
+++ b/apidocs/index.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow #</a></li><li><a href="intro.html">Introduction to core.async</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-step-process">step-process</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
diff --git a/apidocs/intro.html b/apidocs/intro.html
new file mode 100644
index 0000000..290d669
--- /dev/null
+++ b/apidocs/intro.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>Introduction to core.async</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1  current"><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#introduction-to-coreasync" id="introduction-to-coreasync"></a>Introduction to core.async</h1>
+</div></div></div></body></html>
\ No newline at end of file
diff --git a/apidocs/js/highlight.min.js b/apidocs/js/highlight.min.js
new file mode 100644
index 0000000..6486ffd
--- /dev/null
+++ b/apidocs/js/highlight.min.js
@@ -0,0 +1,2 @@
+/*! highlight.js v9.6.0 | BSD3 License | git.io/hljslicense */
+!function(e){var n="object"==typeof window&&window||"object"==typeof self&&self;"undefined"!=typeof exports?e(exports):n&&(n.hljs=e({}),"function"==typeof define&&define.amd&&define([],function(){return n.hljs}))}(function(e){function n(e){return e.replace(/[&<>]/gm,function(e){return I[e]})}function t(e){return e.nodeName.toLowerCase()}function r(e,n){var t=e&&e.exec(n);return t&&0===t.index}function a(e){return k.test(e)}function i(e){var n,t,r,i,o=e.className+" ";if(o+=e.parentNode?e.parentNode.className:"",t=B.exec(o))return R(t[1])?t[1]:"no-highlight";for(o=o.split(/\s+/),n=0,r=o.length;r>n;n++)if(i=o[n],a(i)||R(i))return i}function o(e,n){var t,r={};for(t in e)r[t]=e[t];if(n)for(t in n)r[t]=n[t];return r}function u(e){var n=[];return function r(e,a){for(var i=e.firstChild;i;i=i.nextSibling)3===i.nodeType?a+=i.nodeValue.length:1===i.nodeType&&(n.push({event:"start",offset:a,node:i}),a=r(i,a),t(i).match(/br|hr|img|input/)||n.push({event:"stop",offset:a,node:i}));return a}(e,0),n}function c(e,r,a){function i(){return e.length&&r.length?e[0].offset!==r[0].offset?e[0].offset<r[0].offset?e:r:"start"===r[0].event?e:r:e.length?e:r}function o(e){function r(e){return" "+e.nodeName+'="'+n(e.value)+'"'}l+="<"+t(e)+w.map.call(e.attributes,r).join("")+">"}function u(e){l+="</"+t(e)+">"}function c(e){("start"===e.event?o:u)(e.node)}for(var s=0,l="",f=[];e.length||r.length;){var g=i();if(l+=n(a.substr(s,g[0].offset-s)),s=g[0].offset,g===e){f.reverse().forEach(u);do c(g.splice(0,1)[0]),g=i();while(g===e&&g.length&&g[0].offset===s);f.reverse().forEach(o)}else"start"===g[0].event?f.push(g[0].node):f.pop(),c(g.splice(0,1)[0])}return l+n(a.substr(s))}function s(e){function n(e){return e&&e.source||e}function t(t,r){return new RegExp(n(t),"m"+(e.cI?"i":"")+(r?"g":""))}function r(a,i){if(!a.compiled){if(a.compiled=!0,a.k=a.k||a.bK,a.k){var u={},c=function(n,t){e.cI&&(t=t.toLowerCase()),t.split(" ").forEach(function(e){var t=e.split("|");u[t[0]]=[n,t[1]?Number(t[1]):1]})};"string"==typeof a.k?c("keyword",a.k):E(a.k).forEach(function(e){c(e,a.k[e])}),a.k=u}a.lR=t(a.l||/\w+/,!0),i&&(a.bK&&(a.b="\\b("+a.bK.split(" ").join("|")+")\\b"),a.b||(a.b=/\B|\b/),a.bR=t(a.b),a.e||a.eW||(a.e=/\B|\b/),a.e&&(a.eR=t(a.e)),a.tE=n(a.e)||"",a.eW&&i.tE&&(a.tE+=(a.e?"|":"")+i.tE)),a.i&&(a.iR=t(a.i)),null==a.r&&(a.r=1),a.c||(a.c=[]);var s=[];a.c.forEach(function(e){e.v?e.v.forEach(function(n){s.push(o(e,n))}):s.push("self"===e?a:e)}),a.c=s,a.c.forEach(function(e){r(e,a)}),a.starts&&r(a.starts,i);var l=a.c.map(function(e){return e.bK?"\\.?("+e.b+")\\.?":e.b}).concat([a.tE,a.i]).map(n).filter(Boolean);a.t=l.length?t(l.join("|"),!0):{exec:function(){return null}}}}r(e)}function l(e,t,a,i){function o(e,n){var t,a;for(t=0,a=n.c.length;a>t;t++)if(r(n.c[t].bR,e))return n.c[t]}function u(e,n){if(r(e.eR,n)){for(;e.endsParent&&e.parent;)e=e.parent;return e}return e.eW?u(e.parent,n):void 0}function c(e,n){return!a&&r(n.iR,e)}function g(e,n){var t=N.cI?n[0].toLowerCase():n[0];return e.k.hasOwnProperty(t)&&e.k[t]}function h(e,n,t,r){var a=r?"":y.classPrefix,i='<span class="'+a,o=t?"":C;return i+=e+'">',i+n+o}function p(){var e,t,r,a;if(!E.k)return n(B);for(a="",t=0,E.lR.lastIndex=0,r=E.lR.exec(B);r;)a+=n(B.substr(t,r.index-t)),e=g(E,r),e?(M+=e[1],a+=h(e[0],n(r[0]))):a+=n(r[0]),t=E.lR.lastIndex,r=E.lR.exec(B);return a+n(B.substr(t))}function d(){var e="string"==typeof E.sL;if(e&&!x[E.sL])return n(B);var t=e?l(E.sL,B,!0,L[E.sL]):f(B,E.sL.length?E.sL:void 0);return E.r>0&&(M+=t.r),e&&(L[E.sL]=t.top),h(t.language,t.value,!1,!0)}function b(){k+=null!=E.sL?d():p(),B=""}function v(e){k+=e.cN?h(e.cN,"",!0):"",E=Object.create(e,{parent:{value:E}})}function m(e,n){if(B+=e,null==n)return b(),0;var t=o(n,E);if(t)return t.skip?B+=n:(t.eB&&(B+=n),b(),t.rB||t.eB||(B=n)),v(t,n),t.rB?0:n.length;var r=u(E,n);if(r){var a=E;a.skip?B+=n:(a.rE||a.eE||(B+=n),b(),a.eE&&(B=n));do E.cN&&(k+=C),E.skip||(M+=E.r),E=E.parent;while(E!==r.parent);return r.starts&&v(r.starts,""),a.rE?0:n.length}if(c(n,E))throw new Error('Illegal lexeme "'+n+'" for mode "'+(E.cN||"<unnamed>")+'"');return B+=n,n.length||1}var N=R(e);if(!N)throw new Error('Unknown language: "'+e+'"');s(N);var w,E=i||N,L={},k="";for(w=E;w!==N;w=w.parent)w.cN&&(k=h(w.cN,"",!0)+k);var B="",M=0;try{for(var I,j,O=0;;){if(E.t.lastIndex=O,I=E.t.exec(t),!I)break;j=m(t.substr(O,I.index-O),I[0]),O=I.index+j}for(m(t.substr(O)),w=E;w.parent;w=w.parent)w.cN&&(k+=C);return{r:M,value:k,language:e,top:E}}catch(T){if(T.message&&-1!==T.message.indexOf("Illegal"))return{r:0,value:n(t)};throw T}}function f(e,t){t=t||y.languages||E(x);var r={r:0,value:n(e)},a=r;return t.filter(R).forEach(function(n){var t=l(n,e,!1);t.language=n,t.r>a.r&&(a=t),t.r>r.r&&(a=r,r=t)}),a.language&&(r.second_best=a),r}function g(e){return y.tabReplace||y.useBR?e.replace(M,function(e,n){return y.useBR&&"\n"===e?"<br>":y.tabReplace?n.replace(/\t/g,y.tabReplace):void 0}):e}function h(e,n,t){var r=n?L[n]:t,a=[e.trim()];return e.match(/\bhljs\b/)||a.push("hljs"),-1===e.indexOf(r)&&a.push(r),a.join(" ").trim()}function p(e){var n,t,r,o,s,p=i(e);a(p)||(y.useBR?(n=document.createElementNS("http://www.w3.org/1999/xhtml","div"),n.innerHTML=e.innerHTML.replace(/\n/g,"").replace(/<br[ \/]*>/g,"\n")):n=e,s=n.textContent,r=p?l(p,s,!0):f(s),t=u(n),t.length&&(o=document.createElementNS("http://www.w3.org/1999/xhtml","div"),o.innerHTML=r.value,r.value=c(t,u(o),s)),r.value=g(r.value),e.innerHTML=r.value,e.className=h(e.className,p,r.language),e.result={language:r.language,re:r.r},r.second_best&&(e.second_best={language:r.second_best.language,re:r.second_best.r}))}function d(e){y=o(y,e)}function b(){if(!b.called){b.called=!0;var e=document.querySelectorAll("pre code");w.forEach.call(e,p)}}function v(){addEventListener("DOMContentLoaded",b,!1),addEventListener("load",b,!1)}function m(n,t){var r=x[n]=t(e);r.aliases&&r.aliases.forEach(function(e){L[e]=n})}function N(){return E(x)}function R(e){return e=(e||"").toLowerCase(),x[e]||x[L[e]]}var w=[],E=Object.keys,x={},L={},k=/^(no-?highlight|plain|text)$/i,B=/\blang(?:uage)?-([\w-]+)\b/i,M=/((^(<[^>]+>|\t|)+|(?:\n)))/gm,C="</span>",y={classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0},I={"&":"&amp;","<":"&lt;",">":"&gt;"};return e.highlight=l,e.highlightAuto=f,e.fixMarkup=g,e.highlightBlock=p,e.configure=d,e.initHighlighting=b,e.initHighlightingOnLoad=v,e.registerLanguage=m,e.listLanguages=N,e.getLanguage=R,e.inherit=o,e.IR="[a-zA-Z]\\w*",e.UIR="[a-zA-Z_]\\w*",e.NR="\\b\\d+(\\.\\d+)?",e.CNR="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",e.BNR="\\b(0b[01]+)",e.RSR="!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",e.BE={b:"\\\\[\\s\\S]",r:0},e.ASM={cN:"string",b:"'",e:"'",i:"\\n",c:[e.BE]},e.QSM={cN:"string",b:'"',e:'"',i:"\\n",c:[e.BE]},e.PWM={b:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|like)\b/},e.C=function(n,t,r){var a=e.inherit({cN:"comment",b:n,e:t,c:[]},r||{});return a.c.push(e.PWM),a.c.push({cN:"doctag",b:"(?:TODO|FIXME|NOTE|BUG|XXX):",r:0}),a},e.CLCM=e.C("//","$"),e.CBCM=e.C("/\\*","\\*/"),e.HCM=e.C("#","$"),e.NM={cN:"number",b:e.NR,r:0},e.CNM={cN:"number",b:e.CNR,r:0},e.BNM={cN:"number",b:e.BNR,r:0},e.CSSNM={cN:"number",b:e.NR+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",r:0},e.RM={cN:"regexp",b:/\//,e:/\/[gimuy]*/,i:/\n/,c:[e.BE,{b:/\[/,e:/\]/,r:0,c:[e.BE]}]},e.TM={cN:"title",b:e.IR,r:0},e.UTM={cN:"title",b:e.UIR,r:0},e.METHOD_GUARD={b:"\\.\\s*"+e.UIR,r:0},e});hljs.registerLanguage("clojure",function(e){var t={"builtin-name":"def defonce cond apply if-not if-let if not not= = < > <= >= == + / * - rem quot neg? pos? delay? symbol? keyword? true? false? integer? empty? coll? list? set? ifn? fn? associative? sequential? sorted? counted? reversible? number? decimal? class? distinct? isa? float? rational? reduced? ratio? odd? even? char? seq? vector? string? map? nil? contains? zero? instance? not-every? not-any? libspec? -> ->> .. . inc compare do dotimes mapcat take remove take-while drop letfn drop-last take-last drop-while while intern condp case reduced cycle split-at split-with repeat replicate iterate range merge zipmap declare line-seq sort comparator sort-by dorun doall nthnext nthrest partition eval doseq await await-for let agent atom send send-off release-pending-sends add-watch mapv filterv remove-watch agent-error restart-agent set-error-handler error-handler set-error-mode! error-mode shutdown-agents quote var fn loop recur throw try monitor-enter monitor-exit defmacro defn defn- macroexpand macroexpand-1 for dosync and or when when-not when-let comp juxt partial sequence memoize constantly complement identity assert peek pop doto proxy defstruct first rest cons defprotocol cast coll deftype defrecord last butlast sigs reify second ffirst fnext nfirst nnext defmulti defmethod meta with-meta ns in-ns create-ns import refer keys select-keys vals key val rseq name namespace promise into transient persistent! conj! assoc! dissoc! pop! disj! use class type num float double short byte boolean bigint biginteger bigdec print-method print-dup throw-if printf format load compile get-in update-in pr pr-on newline flush read slurp read-line subvec with-open memfn time re-find re-groups rand-int rand mod locking assert-valid-fdecl alias resolve ref deref refset swap! reset! set-validator! compare-and-set! alter-meta! reset-meta! commute get-validator alter ref-set ref-history-count ref-min-history ref-max-history ensure sync io! new next conj set! to-array future future-call into-array aset gen-class reduce map filter find empty hash-map hash-set sorted-map sorted-map-by sorted-set sorted-set-by vec vector seq flatten reverse assoc dissoc list disj get union difference intersection extend extend-type extend-protocol int nth delay count concat chunk chunk-buffer chunk-append chunk-first chunk-rest max min dec unchecked-inc-int unchecked-inc unchecked-dec-inc unchecked-dec unchecked-negate unchecked-add-int unchecked-add unchecked-subtract-int unchecked-subtract chunk-next chunk-cons chunked-seq? prn vary-meta lazy-seq spread list* str find-keyword keyword symbol gensym force rationalize"},r="a-zA-Z_\\-!.?+*=<>&#'",n="["+r+"]["+r+"0-9/;:]*",a="[-+]?\\d+(\\.\\d+)?",o={b:n,r:0},s={cN:"number",b:a,r:0},i=e.inherit(e.QSM,{i:null}),c=e.C(";","$",{r:0}),d={cN:"literal",b:/\b(true|false|nil)\b/},l={b:"[\\[\\{]",e:"[\\]\\}]"},m={cN:"comment",b:"\\^"+n},p=e.C("\\^\\{","\\}"),u={cN:"symbol",b:"[:]{1,2}"+n},f={b:"\\(",e:"\\)"},h={eW:!0,r:0},y={k:t,l:n,cN:"name",b:n,starts:h},b=[f,i,m,p,c,u,l,s,d,o];return f.c=[e.C("comment",""),y,h],h.c=b,l.c=b,{aliases:["clj"],i:/\S/,c:[f,i,m,p,c,u,l,s,d]}});hljs.registerLanguage("clojure-repl",function(e){return{c:[{cN:"meta",b:/^([\w.-]+|\s*#_)=>/,starts:{e:/$/,sL:"clojure"}}]}});
\ No newline at end of file
diff --git a/apidocs/js/jquery.min.js b/apidocs/js/jquery.min.js
new file mode 100644
index 0000000..73f33fb
--- /dev/null
+++ b/apidocs/js/jquery.min.js
@@ -0,0 +1,4 @@
+/*! jQuery v1.11.0 | (c) 2005, 2014 jQuery Foundation, Inc. | jquery.org/license */
+!function(a,b){"object"==typeof module&&"object"==typeof module.exports?module.exports=a.document?b(a,!0):function(a){if(!a.document)throw new Error("jQuery requires a window with a document");return b(a)}:b(a)}("undefined"!=typeof window?window:this,function(a,b){var c=[],d=c.slice,e=c.concat,f=c.push,g=c.indexOf,h={},i=h.toString,j=h.hasOwnProperty,k="".trim,l={},m="1.11.0",n=function(a,b){return new n.fn.init(a,b)},o=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,p=/^-ms-/,q=/-([\da-z])/gi,r=function(a,b){return b.toUpperCase()};n.fn=n.prototype={jquery:m,constructor:n,selector:"",length:0,toArray:function(){return d.call(this)},get:function(a){return null!=a?0>a?this[a+this.length]:this[a]:d.call(this)},pushStack:function(a){var b=n.merge(this.constructor(),a);return b.prevObject=this,b.context=this.context,b},each:function(a,b){return n.each(this,a,b)},map:function(a){return this.pushStack(n.map(this,function(b,c){return a.call(b,c,b)}))},slice:function(){return this.pushStack(d.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(a){var b=this.length,c=+a+(0>a?b:0);return this.pushStack(c>=0&&b>c?[this[c]]:[])},end:function(){return this.prevObject||this.constructor(null)},push:f,sort:c.sort,splice:c.splice},n.extend=n.fn.extend=function(){var a,b,c,d,e,f,g=arguments[0]||{},h=1,i=arguments.length,j=!1;for("boolean"==typeof g&&(j=g,g=arguments[h]||{},h++),"object"==typeof g||n.isFunction(g)||(g={}),h===i&&(g=this,h--);i>h;h++)if(null!=(e=arguments[h]))for(d in e)a=g[d],c=e[d],g!==c&&(j&&c&&(n.isPlainObject(c)||(b=n.isArray(c)))?(b?(b=!1,f=a&&n.isArray(a)?a:[]):f=a&&n.isPlainObject(a)?a:{},g[d]=n.extend(j,f,c)):void 0!==c&&(g[d]=c));return g},n.extend({expando:"jQuery"+(m+Math.random()).replace(/\D/g,""),isReady:!0,error:function(a){throw new Error(a)},noop:function(){},isFunction:function(a){return"function"===n.type(a)},isArray:Array.isArray||function(a){return"array"===n.type(a)},isWindow:function(a){return null!=a&&a==a.window},isNumeric:function(a){return a-parseFloat(a)>=0},isEmptyObject:function(a){var b;for(b in a)return!1;return!0},isPlainObject:function(a){var b;if(!a||"object"!==n.type(a)||a.nodeType||n.isWindow(a))return!1;try{if(a.constructor&&!j.call(a,"constructor")&&!j.call(a.constructor.prototype,"isPrototypeOf"))return!1}catch(c){return!1}if(l.ownLast)for(b in a)return j.call(a,b);for(b in a);return void 0===b||j.call(a,b)},type:function(a){return null==a?a+"":"object"==typeof a||"function"==typeof a?h[i.call(a)]||"object":typeof a},globalEval:function(b){b&&n.trim(b)&&(a.execScript||function(b){a.eval.call(a,b)})(b)},camelCase:function(a){return a.replace(p,"ms-").replace(q,r)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toLowerCase()===b.toLowerCase()},each:function(a,b,c){var d,e=0,f=a.length,g=s(a);if(c){if(g){for(;f>e;e++)if(d=b.apply(a[e],c),d===!1)break}else for(e in a)if(d=b.apply(a[e],c),d===!1)break}else if(g){for(;f>e;e++)if(d=b.call(a[e],e,a[e]),d===!1)break}else for(e in a)if(d=b.call(a[e],e,a[e]),d===!1)break;return a},trim:k&&!k.call("\ufeff\xa0")?function(a){return null==a?"":k.call(a)}:function(a){return null==a?"":(a+"").replace(o,"")},makeArray:function(a,b){var c=b||[];return null!=a&&(s(Object(a))?n.merge(c,"string"==typeof a?[a]:a):f.call(c,a)),c},inArray:function(a,b,c){var d;if(b){if(g)return g.call(b,a,c);for(d=b.length,c=c?0>c?Math.max(0,d+c):c:0;d>c;c++)if(c in b&&b[c]===a)return c}return-1},merge:function(a,b){var c=+b.length,d=0,e=a.length;while(c>d)a[e++]=b[d++];if(c!==c)while(void 0!==b[d])a[e++]=b[d++];return a.length=e,a},grep:function(a,b,c){for(var d,e=[],f=0,g=a.length,h=!c;g>f;f++)d=!b(a[f],f),d!==h&&e.push(a[f]);return e},map:function(a,b,c){var d,f=0,g=a.length,h=s(a),i=[];if(h)for(;g>f;f++)d=b(a[f],f,c),null!=d&&i.push(d);else for(f in a)d=b(a[f],f,c),null!=d&&i.push(d);return e.apply([],i)},guid:1,proxy:function(a,b){var c,e,f;return"string"==typeof b&&(f=a[b],b=a,a=f),n.isFunction(a)?(c=d.call(arguments,2),e=function(){return a.apply(b||this,c.concat(d.call(arguments)))},e.guid=a.guid=a.guid||n.guid++,e):void 0},now:function(){return+new Date},support:l}),n.each("Boolean Number String Function Array Date RegExp Object Error".split(" "),function(a,b){h["[object "+b+"]"]=b.toLowerCase()});function s(a){var b=a.length,c=n.type(a);return"function"===c||n.isWindow(a)?!1:1===a.nodeType&&b?!0:"array"===c||0===b||"number"==typeof b&&b>0&&b-1 in a}var t=function(a){var b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s="sizzle"+-new Date,t=a.document,u=0,v=0,w=eb(),x=eb(),y=eb(),z=function(a,b){return a===b&&(j=!0),0},A="undefined",B=1<<31,C={}.hasOwnProperty,D=[],E=D.pop,F=D.push,G=D.push,H=D.slice,I=D.indexOf||function(a){for(var b=0,c=this.length;c>b;b++)if(this[b]===a)return b;return-1},J="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",K="[\\x20\\t\\r\\n\\f]",L="(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",M=L.replace("w","w#"),N="\\["+K+"*("+L+")"+K+"*(?:([*^$|!~]?=)"+K+"*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|("+M+")|)|)"+K+"*\\]",O=":("+L+")(?:\\(((['\"])((?:\\\\.|[^\\\\])*?)\\3|((?:\\\\.|[^\\\\()[\\]]|"+N.replace(3,8)+")*)|.*)\\)|)",P=new RegExp("^"+K+"+|((?:^|[^\\\\])(?:\\\\.)*)"+K+"+$","g"),Q=new RegExp("^"+K+"*,"+K+"*"),R=new RegExp("^"+K+"*([>+~]|"+K+")"+K+"*"),S=new RegExp("="+K+"*([^\\]'\"]*?)"+K+"*\\]","g"),T=new RegExp(O),U=new RegExp("^"+M+"$"),V={ID:new RegExp("^#("+L+")"),CLASS:new RegExp("^\\.("+L+")"),TAG:new RegExp("^("+L.replace("w","w*")+")"),ATTR:new RegExp("^"+N),PSEUDO:new RegExp("^"+O),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+K+"*(even|odd|(([+-]|)(\\d*)n|)"+K+"*(?:([+-]|)"+K+"*(\\d+)|))"+K+"*\\)|)","i"),bool:new RegExp("^(?:"+J+")$","i"),needsContext:new RegExp("^"+K+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+K+"*((?:-\\d)?\\d*)"+K+"*\\)|)(?=[^-]|$)","i")},W=/^(?:input|select|textarea|button)$/i,X=/^h\d$/i,Y=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,$=/[+~]/,_=/'|\\/g,ab=new RegExp("\\\\([\\da-f]{1,6}"+K+"?|("+K+")|.)","ig"),bb=function(a,b,c){var d="0x"+b-65536;return d!==d||c?b:0>d?String.fromCharCode(d+65536):String.fromCharCode(d>>10|55296,1023&d|56320)};try{G.apply(D=H.call(t.childNodes),t.childNodes),D[t.childNodes.length].nodeType}catch(cb){G={apply:D.length?function(a,b){F.apply(a,H.call(b))}:function(a,b){var c=a.length,d=0;while(a[c++]=b[d++]);a.length=c-1}}}function db(a,b,d,e){var f,g,h,i,j,m,p,q,u,v;if((b?b.ownerDocument||b:t)!==l&&k(b),b=b||l,d=d||[],!a||"string"!=typeof a)return d;if(1!==(i=b.nodeType)&&9!==i)return[];if(n&&!e){if(f=Z.exec(a))if(h=f[1]){if(9===i){if(g=b.getElementById(h),!g||!g.parentNode)return d;if(g.id===h)return d.push(g),d}else if(b.ownerDocument&&(g=b.ownerDocument.getElementById(h))&&r(b,g)&&g.id===h)return d.push(g),d}else{if(f[2])return G.apply(d,b.getElementsByTagName(a)),d;if((h=f[3])&&c.getElementsByClassName&&b.getElementsByClassName)return G.apply(d,b.getElementsByClassName(h)),d}if(c.qsa&&(!o||!o.test(a))){if(q=p=s,u=b,v=9===i&&a,1===i&&"object"!==b.nodeName.toLowerCase()){m=ob(a),(p=b.getAttribute("id"))?q=p.replace(_,"\\$&"):b.setAttribute("id",q),q="[id='"+q+"'] ",j=m.length;while(j--)m[j]=q+pb(m[j]);u=$.test(a)&&mb(b.parentNode)||b,v=m.join(",")}if(v)try{return G.apply(d,u.querySelectorAll(v)),d}catch(w){}finally{p||b.removeAttribute("id")}}}return xb(a.replace(P,"$1"),b,d,e)}function eb(){var a=[];function b(c,e){return a.push(c+" ")>d.cacheLength&&delete b[a.shift()],b[c+" "]=e}return b}function fb(a){return a[s]=!0,a}function gb(a){var b=l.createElement("div");try{return!!a(b)}catch(c){return!1}finally{b.parentNode&&b.parentNode.removeChild(b),b=null}}function hb(a,b){var c=a.split("|"),e=a.length;while(e--)d.attrHandle[c[e]]=b}function ib(a,b){var c=b&&a,d=c&&1===a.nodeType&&1===b.nodeType&&(~b.sourceIndex||B)-(~a.sourceIndex||B);if(d)return d;if(c)while(c=c.nextSibling)if(c===b)return-1;return a?1:-1}function jb(a){return function(b){var c=b.nodeName.toLowerCase();return"input"===c&&b.type===a}}function kb(a){return function(b){var c=b.nodeName.toLowerCase();return("input"===c||"button"===c)&&b.type===a}}function lb(a){return fb(function(b){return b=+b,fb(function(c,d){var e,f=a([],c.length,b),g=f.length;while(g--)c[e=f[g]]&&(c[e]=!(d[e]=c[e]))})})}function mb(a){return a&&typeof a.getElementsByTagName!==A&&a}c=db.support={},f=db.isXML=function(a){var b=a&&(a.ownerDocument||a).documentElement;return b?"HTML"!==b.nodeName:!1},k=db.setDocument=function(a){var b,e=a?a.ownerDocument||a:t,g=e.defaultView;return e!==l&&9===e.nodeType&&e.documentElement?(l=e,m=e.documentElement,n=!f(e),g&&g!==g.top&&(g.addEventListener?g.addEventListener("unload",function(){k()},!1):g.attachEvent&&g.attachEvent("onunload",function(){k()})),c.attributes=gb(function(a){return a.className="i",!a.getAttribute("className")}),c.getElementsByTagName=gb(function(a){return a.appendChild(e.createComment("")),!a.getElementsByTagName("*").length}),c.getElementsByClassName=Y.test(e.getElementsByClassName)&&gb(function(a){return a.innerHTML="<div class='a'></div><div class='a i'></div>",a.firstChild.className="i",2===a.getElementsByClassName("i").length}),c.getById=gb(function(a){return m.appendChild(a).id=s,!e.getElementsByName||!e.getElementsByName(s).length}),c.getById?(d.find.ID=function(a,b){if(typeof b.getElementById!==A&&n){var c=b.getElementById(a);return c&&c.parentNode?[c]:[]}},d.filter.ID=function(a){var b=a.replace(ab,bb);return function(a){return a.getAttribute("id")===b}}):(delete d.find.ID,d.filter.ID=function(a){var b=a.replace(ab,bb);return function(a){var c=typeof a.getAttributeNode!==A&&a.getAttributeNode("id");return c&&c.value===b}}),d.find.TAG=c.getElementsByTagName?function(a,b){return typeof b.getElementsByTagName!==A?b.getElementsByTagName(a):void 0}:function(a,b){var c,d=[],e=0,f=b.getElementsByTagName(a);if("*"===a){while(c=f[e++])1===c.nodeType&&d.push(c);return d}return f},d.find.CLASS=c.getElementsByClassName&&function(a,b){return typeof b.getElementsByClassName!==A&&n?b.getElementsByClassName(a):void 0},p=[],o=[],(c.qsa=Y.test(e.querySelectorAll))&&(gb(function(a){a.innerHTML="<select t=''><option selected=''></option></select>",a.querySelectorAll("[t^='']").length&&o.push("[*^$]="+K+"*(?:''|\"\")"),a.querySelectorAll("[selected]").length||o.push("\\["+K+"*(?:value|"+J+")"),a.querySelectorAll(":checked").length||o.push(":checked")}),gb(function(a){var b=e.createElement("input");b.setAttribute("type","hidden"),a.appendChild(b).setAttribute("name","D"),a.querySelectorAll("[name=d]").length&&o.push("name"+K+"*[*^$|!~]?="),a.querySelectorAll(":enabled").length||o.push(":enabled",":disabled"),a.querySelectorAll("*,:x"),o.push(",.*:")})),(c.matchesSelector=Y.test(q=m.webkitMatchesSelector||m.mozMatchesSelector||m.oMatchesSelector||m.msMatchesSelector))&&gb(function(a){c.disconnectedMatch=q.call(a,"div"),q.call(a,"[s!='']:x"),p.push("!=",O)}),o=o.length&&new RegExp(o.join("|")),p=p.length&&new RegExp(p.join("|")),b=Y.test(m.compareDocumentPosition),r=b||Y.test(m.contains)?function(a,b){var c=9===a.nodeType?a.documentElement:a,d=b&&b.parentNode;return a===d||!(!d||1!==d.nodeType||!(c.contains?c.contains(d):a.compareDocumentPosition&&16&a.compareDocumentPosition(d)))}:function(a,b){if(b)while(b=b.parentNode)if(b===a)return!0;return!1},z=b?function(a,b){if(a===b)return j=!0,0;var d=!a.compareDocumentPosition-!b.compareDocumentPosition;return d?d:(d=(a.ownerDocument||a)===(b.ownerDocument||b)?a.compareDocumentPosition(b):1,1&d||!c.sortDetached&&b.compareDocumentPosition(a)===d?a===e||a.ownerDocument===t&&r(t,a)?-1:b===e||b.ownerDocument===t&&r(t,b)?1:i?I.call(i,a)-I.call(i,b):0:4&d?-1:1)}:function(a,b){if(a===b)return j=!0,0;var c,d=0,f=a.parentNode,g=b.parentNode,h=[a],k=[b];if(!f||!g)return a===e?-1:b===e?1:f?-1:g?1:i?I.call(i,a)-I.call(i,b):0;if(f===g)return ib(a,b);c=a;while(c=c.parentNode)h.unshift(c);c=b;while(c=c.parentNode)k.unshift(c);while(h[d]===k[d])d++;return d?ib(h[d],k[d]):h[d]===t?-1:k[d]===t?1:0},e):l},db.matches=function(a,b){return db(a,null,null,b)},db.matchesSelector=function(a,b){if((a.ownerDocument||a)!==l&&k(a),b=b.replace(S,"='$1']"),!(!c.matchesSelector||!n||p&&p.test(b)||o&&o.test(b)))try{var d=q.call(a,b);if(d||c.disconnectedMatch||a.document&&11!==a.document.nodeType)return d}catch(e){}return db(b,l,null,[a]).length>0},db.contains=function(a,b){return(a.ownerDocument||a)!==l&&k(a),r(a,b)},db.attr=function(a,b){(a.ownerDocument||a)!==l&&k(a);var e=d.attrHandle[b.toLowerCase()],f=e&&C.call(d.attrHandle,b.toLowerCase())?e(a,b,!n):void 0;return void 0!==f?f:c.attributes||!n?a.getAttribute(b):(f=a.getAttributeNode(b))&&f.specified?f.value:null},db.error=function(a){throw new Error("Syntax error, unrecognized expression: "+a)},db.uniqueSort=function(a){var b,d=[],e=0,f=0;if(j=!c.detectDuplicates,i=!c.sortStable&&a.slice(0),a.sort(z),j){while(b=a[f++])b===a[f]&&(e=d.push(f));while(e--)a.splice(d[e],1)}return i=null,a},e=db.getText=function(a){var b,c="",d=0,f=a.nodeType;if(f){if(1===f||9===f||11===f){if("string"==typeof a.textContent)return a.textContent;for(a=a.firstChild;a;a=a.nextSibling)c+=e(a)}else if(3===f||4===f)return a.nodeValue}else while(b=a[d++])c+=e(b);return c},d=db.selectors={cacheLength:50,createPseudo:fb,match:V,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(a){return a[1]=a[1].replace(ab,bb),a[3]=(a[4]||a[5]||"").replace(ab,bb),"~="===a[2]&&(a[3]=" "+a[3]+" "),a.slice(0,4)},CHILD:function(a){return a[1]=a[1].toLowerCase(),"nth"===a[1].slice(0,3)?(a[3]||db.error(a[0]),a[4]=+(a[4]?a[5]+(a[6]||1):2*("even"===a[3]||"odd"===a[3])),a[5]=+(a[7]+a[8]||"odd"===a[3])):a[3]&&db.error(a[0]),a},PSEUDO:function(a){var b,c=!a[5]&&a[2];return V.CHILD.test(a[0])?null:(a[3]&&void 0!==a[4]?a[2]=a[4]:c&&T.test(c)&&(b=ob(c,!0))&&(b=c.indexOf(")",c.length-b)-c.length)&&(a[0]=a[0].slice(0,b),a[2]=c.slice(0,b)),a.slice(0,3))}},filter:{TAG:function(a){var b=a.replace(ab,bb).toLowerCase();return"*"===a?function(){return!0}:function(a){return a.nodeName&&a.nodeName.toLowerCase()===b}},CLASS:function(a){var b=w[a+" "];return b||(b=new RegExp("(^|"+K+")"+a+"("+K+"|$)"))&&w(a,function(a){return b.test("string"==typeof a.className&&a.className||typeof a.getAttribute!==A&&a.getAttribute("class")||"")})},ATTR:function(a,b,c){return function(d){var e=db.attr(d,a);return null==e?"!="===b:b?(e+="","="===b?e===c:"!="===b?e!==c:"^="===b?c&&0===e.indexOf(c):"*="===b?c&&e.indexOf(c)>-1:"$="===b?c&&e.slice(-c.length)===c:"~="===b?(" "+e+" ").indexOf(c)>-1:"|="===b?e===c||e.slice(0,c.length+1)===c+"-":!1):!0}},CHILD:function(a,b,c,d,e){var f="nth"!==a.slice(0,3),g="last"!==a.slice(-4),h="of-type"===b;return 1===d&&0===e?function(a){return!!a.parentNode}:function(b,c,i){var j,k,l,m,n,o,p=f!==g?"nextSibling":"previousSibling",q=b.parentNode,r=h&&b.nodeName.toLowerCase(),t=!i&&!h;if(q){if(f){while(p){l=b;while(l=l[p])if(h?l.nodeName.toLowerCase()===r:1===l.nodeType)return!1;o=p="only"===a&&!o&&"nextSibling"}return!0}if(o=[g?q.firstChild:q.lastChild],g&&t){k=q[s]||(q[s]={}),j=k[a]||[],n=j[0]===u&&j[1],m=j[0]===u&&j[2],l=n&&q.childNodes[n];while(l=++n&&l&&l[p]||(m=n=0)||o.pop())if(1===l.nodeType&&++m&&l===b){k[a]=[u,n,m];break}}else if(t&&(j=(b[s]||(b[s]={}))[a])&&j[0]===u)m=j[1];else while(l=++n&&l&&l[p]||(m=n=0)||o.pop())if((h?l.nodeName.toLowerCase()===r:1===l.nodeType)&&++m&&(t&&((l[s]||(l[s]={}))[a]=[u,m]),l===b))break;return m-=e,m===d||m%d===0&&m/d>=0}}},PSEUDO:function(a,b){var c,e=d.pseudos[a]||d.setFilters[a.toLowerCase()]||db.error("unsupported pseudo: "+a);return e[s]?e(b):e.length>1?(c=[a,a,"",b],d.setFilters.hasOwnProperty(a.toLowerCase())?fb(function(a,c){var d,f=e(a,b),g=f.length;while(g--)d=I.call(a,f[g]),a[d]=!(c[d]=f[g])}):function(a){return e(a,0,c)}):e}},pseudos:{not:fb(function(a){var b=[],c=[],d=g(a.replace(P,"$1"));return d[s]?fb(function(a,b,c,e){var f,g=d(a,null,e,[]),h=a.length;while(h--)(f=g[h])&&(a[h]=!(b[h]=f))}):function(a,e,f){return b[0]=a,d(b,null,f,c),!c.pop()}}),has:fb(function(a){return function(b){return db(a,b).length>0}}),contains:fb(function(a){return function(b){return(b.textContent||b.innerText||e(b)).indexOf(a)>-1}}),lang:fb(function(a){return U.test(a||"")||db.error("unsupported lang: "+a),a=a.replace(ab,bb).toLowerCase(),function(b){var c;do if(c=n?b.lang:b.getAttribute("xml:lang")||b.getAttribute("lang"))return c=c.toLowerCase(),c===a||0===c.indexOf(a+"-");while((b=b.parentNode)&&1===b.nodeType);return!1}}),target:function(b){var c=a.location&&a.location.hash;return c&&c.slice(1)===b.id},root:function(a){return a===m},focus:function(a){return a===l.activeElement&&(!l.hasFocus||l.hasFocus())&&!!(a.type||a.href||~a.tabIndex)},enabled:function(a){return a.disabled===!1},disabled:function(a){return a.disabled===!0},checked:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&!!a.checked||"option"===b&&!!a.selected},selected:function(a){return a.parentNode&&a.parentNode.selectedIndex,a.selected===!0},empty:function(a){for(a=a.firstChild;a;a=a.nextSibling)if(a.nodeType<6)return!1;return!0},parent:function(a){return!d.pseudos.empty(a)},header:function(a){return X.test(a.nodeName)},input:function(a){return W.test(a.nodeName)},button:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&"button"===a.type||"button"===b},text:function(a){var b;return"input"===a.nodeName.toLowerCase()&&"text"===a.type&&(null==(b=a.getAttribute("type"))||"text"===b.toLowerCase())},first:lb(function(){return[0]}),last:lb(function(a,b){return[b-1]}),eq:lb(function(a,b,c){return[0>c?c+b:c]}),even:lb(function(a,b){for(var c=0;b>c;c+=2)a.push(c);return a}),odd:lb(function(a,b){for(var c=1;b>c;c+=2)a.push(c);return a}),lt:lb(function(a,b,c){for(var d=0>c?c+b:c;--d>=0;)a.push(d);return a}),gt:lb(function(a,b,c){for(var d=0>c?c+b:c;++d<b;)a.push(d);return a})}},d.pseudos.nth=d.pseudos.eq;for(b in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})d.pseudos[b]=jb(b);for(b in{submit:!0,reset:!0})d.pseudos[b]=kb(b);function nb(){}nb.prototype=d.filters=d.pseudos,d.setFilters=new nb;function ob(a,b){var c,e,f,g,h,i,j,k=x[a+" "];if(k)return b?0:k.slice(0);h=a,i=[],j=d.preFilter;while(h){(!c||(e=Q.exec(h)))&&(e&&(h=h.slice(e[0].length)||h),i.push(f=[])),c=!1,(e=R.exec(h))&&(c=e.shift(),f.push({value:c,type:e[0].replace(P," ")}),h=h.slice(c.length));for(g in d.filter)!(e=V[g].exec(h))||j[g]&&!(e=j[g](e))||(c=e.shift(),f.push({value:c,type:g,matches:e}),h=h.slice(c.length));if(!c)break}return b?h.length:h?db.error(a):x(a,i).slice(0)}function pb(a){for(var b=0,c=a.length,d="";c>b;b++)d+=a[b].value;return d}function qb(a,b,c){var d=b.dir,e=c&&"parentNode"===d,f=v++;return b.first?function(b,c,f){while(b=b[d])if(1===b.nodeType||e)return a(b,c,f)}:function(b,c,g){var h,i,j=[u,f];if(g){while(b=b[d])if((1===b.nodeType||e)&&a(b,c,g))return!0}else while(b=b[d])if(1===b.nodeType||e){if(i=b[s]||(b[s]={}),(h=i[d])&&h[0]===u&&h[1]===f)return j[2]=h[2];if(i[d]=j,j[2]=a(b,c,g))return!0}}}function rb(a){return a.length>1?function(b,c,d){var e=a.length;while(e--)if(!a[e](b,c,d))return!1;return!0}:a[0]}function sb(a,b,c,d,e){for(var f,g=[],h=0,i=a.length,j=null!=b;i>h;h++)(f=a[h])&&(!c||c(f,d,e))&&(g.push(f),j&&b.push(h));return g}function tb(a,b,c,d,e,f){return d&&!d[s]&&(d=tb(d)),e&&!e[s]&&(e=tb(e,f)),fb(function(f,g,h,i){var j,k,l,m=[],n=[],o=g.length,p=f||wb(b||"*",h.nodeType?[h]:h,[]),q=!a||!f&&b?p:sb(p,m,a,h,i),r=c?e||(f?a:o||d)?[]:g:q;if(c&&c(q,r,h,i),d){j=sb(r,n),d(j,[],h,i),k=j.length;while(k--)(l=j[k])&&(r[n[k]]=!(q[n[k]]=l))}if(f){if(e||a){if(e){j=[],k=r.length;while(k--)(l=r[k])&&j.push(q[k]=l);e(null,r=[],j,i)}k=r.length;while(k--)(l=r[k])&&(j=e?I.call(f,l):m[k])>-1&&(f[j]=!(g[j]=l))}}else r=sb(r===g?r.splice(o,r.length):r),e?e(null,g,r,i):G.apply(g,r)})}function ub(a){for(var b,c,e,f=a.length,g=d.relative[a[0].type],i=g||d.relative[" "],j=g?1:0,k=qb(function(a){return a===b},i,!0),l=qb(function(a){return I.call(b,a)>-1},i,!0),m=[function(a,c,d){return!g&&(d||c!==h)||((b=c).nodeType?k(a,c,d):l(a,c,d))}];f>j;j++)if(c=d.relative[a[j].type])m=[qb(rb(m),c)];else{if(c=d.filter[a[j].type].apply(null,a[j].matches),c[s]){for(e=++j;f>e;e++)if(d.relative[a[e].type])break;return tb(j>1&&rb(m),j>1&&pb(a.slice(0,j-1).concat({value:" "===a[j-2].type?"*":""})).replace(P,"$1"),c,e>j&&ub(a.slice(j,e)),f>e&&ub(a=a.slice(e)),f>e&&pb(a))}m.push(c)}return rb(m)}function vb(a,b){var c=b.length>0,e=a.length>0,f=function(f,g,i,j,k){var m,n,o,p=0,q="0",r=f&&[],s=[],t=h,v=f||e&&d.find.TAG("*",k),w=u+=null==t?1:Math.random()||.1,x=v.length;for(k&&(h=g!==l&&g);q!==x&&null!=(m=v[q]);q++){if(e&&m){n=0;while(o=a[n++])if(o(m,g,i)){j.push(m);break}k&&(u=w)}c&&((m=!o&&m)&&p--,f&&r.push(m))}if(p+=q,c&&q!==p){n=0;while(o=b[n++])o(r,s,g,i);if(f){if(p>0)while(q--)r[q]||s[q]||(s[q]=E.call(j));s=sb(s)}G.apply(j,s),k&&!f&&s.length>0&&p+b.length>1&&db.uniqueSort(j)}return k&&(u=w,h=t),r};return c?fb(f):f}g=db.compile=function(a,b){var c,d=[],e=[],f=y[a+" "];if(!f){b||(b=ob(a)),c=b.length;while(c--)f=ub(b[c]),f[s]?d.push(f):e.push(f);f=y(a,vb(e,d))}return f};function wb(a,b,c){for(var d=0,e=b.length;e>d;d++)db(a,b[d],c);return c}function xb(a,b,e,f){var h,i,j,k,l,m=ob(a);if(!f&&1===m.length){if(i=m[0]=m[0].slice(0),i.length>2&&"ID"===(j=i[0]).type&&c.getById&&9===b.nodeType&&n&&d.relative[i[1].type]){if(b=(d.find.ID(j.matches[0].replace(ab,bb),b)||[])[0],!b)return e;a=a.slice(i.shift().value.length)}h=V.needsContext.test(a)?0:i.length;while(h--){if(j=i[h],d.relative[k=j.type])break;if((l=d.find[k])&&(f=l(j.matches[0].replace(ab,bb),$.test(i[0].type)&&mb(b.parentNode)||b))){if(i.splice(h,1),a=f.length&&pb(i),!a)return G.apply(e,f),e;break}}}return g(a,m)(f,b,!n,e,$.test(a)&&mb(b.parentNode)||b),e}return c.sortStable=s.split("").sort(z).join("")===s,c.detectDuplicates=!!j,k(),c.sortDetached=gb(function(a){return 1&a.compareDocumentPosition(l.createElement("div"))}),gb(function(a){return a.innerHTML="<a href='#'></a>","#"===a.firstChild.getAttribute("href")})||hb("type|href|height|width",function(a,b,c){return c?void 0:a.getAttribute(b,"type"===b.toLowerCase()?1:2)}),c.attributes&&gb(function(a){return a.innerHTML="<input/>",a.firstChild.setAttribute("value",""),""===a.firstChild.getAttribute("value")})||hb("value",function(a,b,c){return c||"input"!==a.nodeName.toLowerCase()?void 0:a.defaultValue}),gb(function(a){return null==a.getAttribute("disabled")})||hb(J,function(a,b,c){var d;return c?void 0:a[b]===!0?b.toLowerCase():(d=a.getAttributeNode(b))&&d.specified?d.value:null}),db}(a);n.find=t,n.expr=t.selectors,n.expr[":"]=n.expr.pseudos,n.unique=t.uniqueSort,n.text=t.getText,n.isXMLDoc=t.isXML,n.contains=t.contains;var u=n.expr.match.needsContext,v=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,w=/^.[^:#\[\.,]*$/;function x(a,b,c){if(n.isFunction(b))return n.grep(a,function(a,d){return!!b.call(a,d,a)!==c});if(b.nodeType)return n.grep(a,function(a){return a===b!==c});if("string"==typeof b){if(w.test(b))return n.filter(b,a,c);b=n.filter(b,a)}return n.grep(a,function(a){return n.inArray(a,b)>=0!==c})}n.filter=function(a,b,c){var d=b[0];return c&&(a=":not("+a+")"),1===b.length&&1===d.nodeType?n.find.matchesSelector(d,a)?[d]:[]:n.find.matches(a,n.grep(b,function(a){return 1===a.nodeType}))},n.fn.extend({find:function(a){var b,c=[],d=this,e=d.length;if("string"!=typeof a)return this.pushStack(n(a).filter(function(){for(b=0;e>b;b++)if(n.contains(d[b],this))return!0}));for(b=0;e>b;b++)n.find(a,d[b],c);return c=this.pushStack(e>1?n.unique(c):c),c.selector=this.selector?this.selector+" "+a:a,c},filter:function(a){return this.pushStack(x(this,a||[],!1))},not:function(a){return this.pushStack(x(this,a||[],!0))},is:function(a){return!!x(this,"string"==typeof a&&u.test(a)?n(a):a||[],!1).length}});var y,z=a.document,A=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/,B=n.fn.init=function(a,b){var c,d;if(!a)return this;if("string"==typeof a){if(c="<"===a.charAt(0)&&">"===a.charAt(a.length-1)&&a.length>=3?[null,a,null]:A.exec(a),!c||!c[1]&&b)return!b||b.jquery?(b||y).find(a):this.constructor(b).find(a);if(c[1]){if(b=b instanceof n?b[0]:b,n.merge(this,n.parseHTML(c[1],b&&b.nodeType?b.ownerDocument||b:z,!0)),v.test(c[1])&&n.isPlainObject(b))for(c in b)n.isFunction(this[c])?this[c](b[c]):this.attr(c,b[c]);return this}if(d=z.getElementById(c[2]),d&&d.parentNode){if(d.id!==c[2])return y.find(a);this.length=1,this[0]=d}return this.context=z,this.selector=a,this}return a.nodeType?(this.context=this[0]=a,this.length=1,this):n.isFunction(a)?"undefined"!=typeof y.ready?y.ready(a):a(n):(void 0!==a.selector&&(this.selector=a.selector,this.context=a.context),n.makeArray(a,this))};B.prototype=n.fn,y=n(z);var C=/^(?:parents|prev(?:Until|All))/,D={children:!0,contents:!0,next:!0,prev:!0};n.extend({dir:function(a,b,c){var d=[],e=a[b];while(e&&9!==e.nodeType&&(void 0===c||1!==e.nodeType||!n(e).is(c)))1===e.nodeType&&d.push(e),e=e[b];return d},sibling:function(a,b){for(var c=[];a;a=a.nextSibling)1===a.nodeType&&a!==b&&c.push(a);return c}}),n.fn.extend({has:function(a){var b,c=n(a,this),d=c.length;return this.filter(function(){for(b=0;d>b;b++)if(n.contains(this,c[b]))return!0})},closest:function(a,b){for(var c,d=0,e=this.length,f=[],g=u.test(a)||"string"!=typeof a?n(a,b||this.context):0;e>d;d++)for(c=this[d];c&&c!==b;c=c.parentNode)if(c.nodeType<11&&(g?g.index(c)>-1:1===c.nodeType&&n.find.matchesSelector(c,a))){f.push(c);break}return this.pushStack(f.length>1?n.unique(f):f)},index:function(a){return a?"string"==typeof a?n.inArray(this[0],n(a)):n.inArray(a.jquery?a[0]:a,this):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(a,b){return this.pushStack(n.unique(n.merge(this.get(),n(a,b))))},addBack:function(a){return this.add(null==a?this.prevObject:this.prevObject.filter(a))}});function E(a,b){do a=a[b];while(a&&1!==a.nodeType);return a}n.each({parent:function(a){var b=a.parentNode;return b&&11!==b.nodeType?b:null},parents:function(a){return n.dir(a,"parentNode")},parentsUntil:function(a,b,c){return n.dir(a,"parentNode",c)},next:function(a){return E(a,"nextSibling")},prev:function(a){return E(a,"previousSibling")},nextAll:function(a){return n.dir(a,"nextSibling")},prevAll:function(a){return n.dir(a,"previousSibling")},nextUntil:function(a,b,c){return n.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return n.dir(a,"previousSibling",c)},siblings:function(a){return n.sibling((a.parentNode||{}).firstChild,a)},children:function(a){return n.sibling(a.firstChild)},contents:function(a){return n.nodeName(a,"iframe")?a.contentDocument||a.contentWindow.document:n.merge([],a.childNodes)}},function(a,b){n.fn[a]=function(c,d){var e=n.map(this,b,c);return"Until"!==a.slice(-5)&&(d=c),d&&"string"==typeof d&&(e=n.filter(d,e)),this.length>1&&(D[a]||(e=n.unique(e)),C.test(a)&&(e=e.reverse())),this.pushStack(e)}});var F=/\S+/g,G={};function H(a){var b=G[a]={};return n.each(a.match(F)||[],function(a,c){b[c]=!0}),b}n.Callbacks=function(a){a="string"==typeof a?G[a]||H(a):n.extend({},a);var b,c,d,e,f,g,h=[],i=!a.once&&[],j=function(l){for(c=a.memory&&l,d=!0,f=g||0,g=0,e=h.length,b=!0;h&&e>f;f++)if(h[f].apply(l[0],l[1])===!1&&a.stopOnFalse){c=!1;break}b=!1,h&&(i?i.length&&j(i.shift()):c?h=[]:k.disable())},k={add:function(){if(h){var d=h.length;!function f(b){n.each(b,function(b,c){var d=n.type(c);"function"===d?a.unique&&k.has(c)||h.push(c):c&&c.length&&"string"!==d&&f(c)})}(arguments),b?e=h.length:c&&(g=d,j(c))}return this},remove:function(){return h&&n.each(arguments,function(a,c){var d;while((d=n.inArray(c,h,d))>-1)h.splice(d,1),b&&(e>=d&&e--,f>=d&&f--)}),this},has:function(a){return a?n.inArray(a,h)>-1:!(!h||!h.length)},empty:function(){return h=[],e=0,this},disable:function(){return h=i=c=void 0,this},disabled:function(){return!h},lock:function(){return i=void 0,c||k.disable(),this},locked:function(){return!i},fireWith:function(a,c){return!h||d&&!i||(c=c||[],c=[a,c.slice?c.slice():c],b?i.push(c):j(c)),this},fire:function(){return k.fireWith(this,arguments),this},fired:function(){return!!d}};return k},n.extend({Deferred:function(a){var b=[["resolve","done",n.Callbacks("once memory"),"resolved"],["reject","fail",n.Callbacks("once memory"),"rejected"],["notify","progress",n.Callbacks("memory")]],c="pending",d={state:function(){return c},always:function(){return e.done(arguments).fail(arguments),this},then:function(){var a=arguments;return n.Deferred(function(c){n.each(b,function(b,f){var g=n.isFunction(a[b])&&a[b];e[f[1]](function(){var a=g&&g.apply(this,arguments);a&&n.isFunction(a.promise)?a.promise().done(c.resolve).fail(c.reject).progress(c.notify):c[f[0]+"With"](this===d?c.promise():this,g?[a]:arguments)})}),a=null}).promise()},promise:function(a){return null!=a?n.extend(a,d):d}},e={};return d.pipe=d.then,n.each(b,function(a,f){var g=f[2],h=f[3];d[f[1]]=g.add,h&&g.add(function(){c=h},b[1^a][2].disable,b[2][2].lock),e[f[0]]=function(){return e[f[0]+"With"](this===e?d:this,arguments),this},e[f[0]+"With"]=g.fireWith}),d.promise(e),a&&a.call(e,e),e},when:function(a){var b=0,c=d.call(arguments),e=c.length,f=1!==e||a&&n.isFunction(a.promise)?e:0,g=1===f?a:n.Deferred(),h=function(a,b,c){return function(e){b[a]=this,c[a]=arguments.length>1?d.call(arguments):e,c===i?g.notifyWith(b,c):--f||g.resolveWith(b,c)}},i,j,k;if(e>1)for(i=new Array(e),j=new Array(e),k=new Array(e);e>b;b++)c[b]&&n.isFunction(c[b].promise)?c[b].promise().done(h(b,k,c)).fail(g.reject).progress(h(b,j,i)):--f;return f||g.resolveWith(k,c),g.promise()}});var I;n.fn.ready=function(a){return n.ready.promise().done(a),this},n.extend({isReady:!1,readyWait:1,holdReady:function(a){a?n.readyWait++:n.ready(!0)},ready:function(a){if(a===!0?!--n.readyWait:!n.isReady){if(!z.body)return setTimeout(n.ready);n.isReady=!0,a!==!0&&--n.readyWait>0||(I.resolveWith(z,[n]),n.fn.trigger&&n(z).trigger("ready").off("ready"))}}});function J(){z.addEventListener?(z.removeEventListener("DOMContentLoaded",K,!1),a.removeEventListener("load",K,!1)):(z.detachEvent("onreadystatechange",K),a.detachEvent("onload",K))}function K(){(z.addEventListener||"load"===event.type||"complete"===z.readyState)&&(J(),n.ready())}n.ready.promise=function(b){if(!I)if(I=n.Deferred(),"complete"===z.readyState)setTimeout(n.ready);else if(z.addEventListener)z.addEventListener("DOMContentLoaded",K,!1),a.addEventListener("load",K,!1);else{z.attachEvent("onreadystatechange",K),a.attachEvent("onload",K);var c=!1;try{c=null==a.frameElement&&z.documentElement}catch(d){}c&&c.doScroll&&!function e(){if(!n.isReady){try{c.doScroll("left")}catch(a){return setTimeout(e,50)}J(),n.ready()}}()}return I.promise(b)};var L="undefined",M;for(M in n(l))break;l.ownLast="0"!==M,l.inlineBlockNeedsLayout=!1,n(function(){var a,b,c=z.getElementsByTagName("body")[0];c&&(a=z.createElement("div"),a.style.cssText="border:0;width:0;height:0;position:absolute;top:0;left:-9999px;margin-top:1px",b=z.createElement("div"),c.appendChild(a).appendChild(b),typeof b.style.zoom!==L&&(b.style.cssText="border:0;margin:0;width:1px;padding:1px;display:inline;zoom:1",(l.inlineBlockNeedsLayout=3===b.offsetWidth)&&(c.style.zoom=1)),c.removeChild(a),a=b=null)}),function(){var a=z.createElement("div");if(null==l.deleteExpando){l.deleteExpando=!0;try{delete a.test}catch(b){l.deleteExpando=!1}}a=null}(),n.acceptData=function(a){var b=n.noData[(a.nodeName+" ").toLowerCase()],c=+a.nodeType||1;return 1!==c&&9!==c?!1:!b||b!==!0&&a.getAttribute("classid")===b};var N=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,O=/([A-Z])/g;function P(a,b,c){if(void 0===c&&1===a.nodeType){var d="data-"+b.replace(O,"-$1").toLowerCase();if(c=a.getAttribute(d),"string"==typeof c){try{c="true"===c?!0:"false"===c?!1:"null"===c?null:+c+""===c?+c:N.test(c)?n.parseJSON(c):c}catch(e){}n.data(a,b,c)}else c=void 0}return c}function Q(a){var b;for(b in a)if(("data"!==b||!n.isEmptyObject(a[b]))&&"toJSON"!==b)return!1;return!0}function R(a,b,d,e){if(n.acceptData(a)){var f,g,h=n.expando,i=a.nodeType,j=i?n.cache:a,k=i?a[h]:a[h]&&h;if(k&&j[k]&&(e||j[k].data)||void 0!==d||"string"!=typeof b)return k||(k=i?a[h]=c.pop()||n.guid++:h),j[k]||(j[k]=i?{}:{toJSON:n.noop}),("object"==typeof b||"function"==typeof b)&&(e?j[k]=n.extend(j[k],b):j[k].data=n.extend(j[k].data,b)),g=j[k],e||(g.data||(g.data={}),g=g.data),void 0!==d&&(g[n.camelCase(b)]=d),"string"==typeof b?(f=g[b],null==f&&(f=g[n.camelCase(b)])):f=g,f
+}}function S(a,b,c){if(n.acceptData(a)){var d,e,f=a.nodeType,g=f?n.cache:a,h=f?a[n.expando]:n.expando;if(g[h]){if(b&&(d=c?g[h]:g[h].data)){n.isArray(b)?b=b.concat(n.map(b,n.camelCase)):b in d?b=[b]:(b=n.camelCase(b),b=b in d?[b]:b.split(" ")),e=b.length;while(e--)delete d[b[e]];if(c?!Q(d):!n.isEmptyObject(d))return}(c||(delete g[h].data,Q(g[h])))&&(f?n.cleanData([a],!0):l.deleteExpando||g!=g.window?delete g[h]:g[h]=null)}}}n.extend({cache:{},noData:{"applet ":!0,"embed ":!0,"object ":"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"},hasData:function(a){return a=a.nodeType?n.cache[a[n.expando]]:a[n.expando],!!a&&!Q(a)},data:function(a,b,c){return R(a,b,c)},removeData:function(a,b){return S(a,b)},_data:function(a,b,c){return R(a,b,c,!0)},_removeData:function(a,b){return S(a,b,!0)}}),n.fn.extend({data:function(a,b){var c,d,e,f=this[0],g=f&&f.attributes;if(void 0===a){if(this.length&&(e=n.data(f),1===f.nodeType&&!n._data(f,"parsedAttrs"))){c=g.length;while(c--)d=g[c].name,0===d.indexOf("data-")&&(d=n.camelCase(d.slice(5)),P(f,d,e[d]));n._data(f,"parsedAttrs",!0)}return e}return"object"==typeof a?this.each(function(){n.data(this,a)}):arguments.length>1?this.each(function(){n.data(this,a,b)}):f?P(f,a,n.data(f,a)):void 0},removeData:function(a){return this.each(function(){n.removeData(this,a)})}}),n.extend({queue:function(a,b,c){var d;return a?(b=(b||"fx")+"queue",d=n._data(a,b),c&&(!d||n.isArray(c)?d=n._data(a,b,n.makeArray(c)):d.push(c)),d||[]):void 0},dequeue:function(a,b){b=b||"fx";var c=n.queue(a,b),d=c.length,e=c.shift(),f=n._queueHooks(a,b),g=function(){n.dequeue(a,b)};"inprogress"===e&&(e=c.shift(),d--),e&&("fx"===b&&c.unshift("inprogress"),delete f.stop,e.call(a,g,f)),!d&&f&&f.empty.fire()},_queueHooks:function(a,b){var c=b+"queueHooks";return n._data(a,c)||n._data(a,c,{empty:n.Callbacks("once memory").add(function(){n._removeData(a,b+"queue"),n._removeData(a,c)})})}}),n.fn.extend({queue:function(a,b){var c=2;return"string"!=typeof a&&(b=a,a="fx",c--),arguments.length<c?n.queue(this[0],a):void 0===b?this:this.each(function(){var c=n.queue(this,a,b);n._queueHooks(this,a),"fx"===a&&"inprogress"!==c[0]&&n.dequeue(this,a)})},dequeue:function(a){return this.each(function(){n.dequeue(this,a)})},clearQueue:function(a){return this.queue(a||"fx",[])},promise:function(a,b){var c,d=1,e=n.Deferred(),f=this,g=this.length,h=function(){--d||e.resolveWith(f,[f])};"string"!=typeof a&&(b=a,a=void 0),a=a||"fx";while(g--)c=n._data(f[g],a+"queueHooks"),c&&c.empty&&(d++,c.empty.add(h));return h(),e.promise(b)}});var T=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,U=["Top","Right","Bottom","Left"],V=function(a,b){return a=b||a,"none"===n.css(a,"display")||!n.contains(a.ownerDocument,a)},W=n.access=function(a,b,c,d,e,f,g){var h=0,i=a.length,j=null==c;if("object"===n.type(c)){e=!0;for(h in c)n.access(a,b,h,c[h],!0,f,g)}else if(void 0!==d&&(e=!0,n.isFunction(d)||(g=!0),j&&(g?(b.call(a,d),b=null):(j=b,b=function(a,b,c){return j.call(n(a),c)})),b))for(;i>h;h++)b(a[h],c,g?d:d.call(a[h],h,b(a[h],c)));return e?a:j?b.call(a):i?b(a[0],c):f},X=/^(?:checkbox|radio)$/i;!function(){var a=z.createDocumentFragment(),b=z.createElement("div"),c=z.createElement("input");if(b.setAttribute("className","t"),b.innerHTML="  <link/><table></table><a href='/a'>a</a>",l.leadingWhitespace=3===b.firstChild.nodeType,l.tbody=!b.getElementsByTagName("tbody").length,l.htmlSerialize=!!b.getElementsByTagName("link").length,l.html5Clone="<:nav></:nav>"!==z.createElement("nav").cloneNode(!0).outerHTML,c.type="checkbox",c.checked=!0,a.appendChild(c),l.appendChecked=c.checked,b.innerHTML="<textarea>x</textarea>",l.noCloneChecked=!!b.cloneNode(!0).lastChild.defaultValue,a.appendChild(b),b.innerHTML="<input type='radio' checked='checked' name='t'/>",l.checkClone=b.cloneNode(!0).cloneNode(!0).lastChild.checked,l.noCloneEvent=!0,b.attachEvent&&(b.attachEvent("onclick",function(){l.noCloneEvent=!1}),b.cloneNode(!0).click()),null==l.deleteExpando){l.deleteExpando=!0;try{delete b.test}catch(d){l.deleteExpando=!1}}a=b=c=null}(),function(){var b,c,d=z.createElement("div");for(b in{submit:!0,change:!0,focusin:!0})c="on"+b,(l[b+"Bubbles"]=c in a)||(d.setAttribute(c,"t"),l[b+"Bubbles"]=d.attributes[c].expando===!1);d=null}();var Y=/^(?:input|select|textarea)$/i,Z=/^key/,$=/^(?:mouse|contextmenu)|click/,_=/^(?:focusinfocus|focusoutblur)$/,ab=/^([^.]*)(?:\.(.+)|)$/;function bb(){return!0}function cb(){return!1}function db(){try{return z.activeElement}catch(a){}}n.event={global:{},add:function(a,b,c,d,e){var f,g,h,i,j,k,l,m,o,p,q,r=n._data(a);if(r){c.handler&&(i=c,c=i.handler,e=i.selector),c.guid||(c.guid=n.guid++),(g=r.events)||(g=r.events={}),(k=r.handle)||(k=r.handle=function(a){return typeof n===L||a&&n.event.triggered===a.type?void 0:n.event.dispatch.apply(k.elem,arguments)},k.elem=a),b=(b||"").match(F)||[""],h=b.length;while(h--)f=ab.exec(b[h])||[],o=q=f[1],p=(f[2]||"").split(".").sort(),o&&(j=n.event.special[o]||{},o=(e?j.delegateType:j.bindType)||o,j=n.event.special[o]||{},l=n.extend({type:o,origType:q,data:d,handler:c,guid:c.guid,selector:e,needsContext:e&&n.expr.match.needsContext.test(e),namespace:p.join(".")},i),(m=g[o])||(m=g[o]=[],m.delegateCount=0,j.setup&&j.setup.call(a,d,p,k)!==!1||(a.addEventListener?a.addEventListener(o,k,!1):a.attachEvent&&a.attachEvent("on"+o,k))),j.add&&(j.add.call(a,l),l.handler.guid||(l.handler.guid=c.guid)),e?m.splice(m.delegateCount++,0,l):m.push(l),n.event.global[o]=!0);a=null}},remove:function(a,b,c,d,e){var f,g,h,i,j,k,l,m,o,p,q,r=n.hasData(a)&&n._data(a);if(r&&(k=r.events)){b=(b||"").match(F)||[""],j=b.length;while(j--)if(h=ab.exec(b[j])||[],o=q=h[1],p=(h[2]||"").split(".").sort(),o){l=n.event.special[o]||{},o=(d?l.delegateType:l.bindType)||o,m=k[o]||[],h=h[2]&&new RegExp("(^|\\.)"+p.join("\\.(?:.*\\.|)")+"(\\.|$)"),i=f=m.length;while(f--)g=m[f],!e&&q!==g.origType||c&&c.guid!==g.guid||h&&!h.test(g.namespace)||d&&d!==g.selector&&("**"!==d||!g.selector)||(m.splice(f,1),g.selector&&m.delegateCount--,l.remove&&l.remove.call(a,g));i&&!m.length&&(l.teardown&&l.teardown.call(a,p,r.handle)!==!1||n.removeEvent(a,o,r.handle),delete k[o])}else for(o in k)n.event.remove(a,o+b[j],c,d,!0);n.isEmptyObject(k)&&(delete r.handle,n._removeData(a,"events"))}},trigger:function(b,c,d,e){var f,g,h,i,k,l,m,o=[d||z],p=j.call(b,"type")?b.type:b,q=j.call(b,"namespace")?b.namespace.split("."):[];if(h=l=d=d||z,3!==d.nodeType&&8!==d.nodeType&&!_.test(p+n.event.triggered)&&(p.indexOf(".")>=0&&(q=p.split("."),p=q.shift(),q.sort()),g=p.indexOf(":")<0&&"on"+p,b=b[n.expando]?b:new n.Event(p,"object"==typeof b&&b),b.isTrigger=e?2:3,b.namespace=q.join("."),b.namespace_re=b.namespace?new RegExp("(^|\\.)"+q.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,b.result=void 0,b.target||(b.target=d),c=null==c?[b]:n.makeArray(c,[b]),k=n.event.special[p]||{},e||!k.trigger||k.trigger.apply(d,c)!==!1)){if(!e&&!k.noBubble&&!n.isWindow(d)){for(i=k.delegateType||p,_.test(i+p)||(h=h.parentNode);h;h=h.parentNode)o.push(h),l=h;l===(d.ownerDocument||z)&&o.push(l.defaultView||l.parentWindow||a)}m=0;while((h=o[m++])&&!b.isPropagationStopped())b.type=m>1?i:k.bindType||p,f=(n._data(h,"events")||{})[b.type]&&n._data(h,"handle"),f&&f.apply(h,c),f=g&&h[g],f&&f.apply&&n.acceptData(h)&&(b.result=f.apply(h,c),b.result===!1&&b.preventDefault());if(b.type=p,!e&&!b.isDefaultPrevented()&&(!k._default||k._default.apply(o.pop(),c)===!1)&&n.acceptData(d)&&g&&d[p]&&!n.isWindow(d)){l=d[g],l&&(d[g]=null),n.event.triggered=p;try{d[p]()}catch(r){}n.event.triggered=void 0,l&&(d[g]=l)}return b.result}},dispatch:function(a){a=n.event.fix(a);var b,c,e,f,g,h=[],i=d.call(arguments),j=(n._data(this,"events")||{})[a.type]||[],k=n.event.special[a.type]||{};if(i[0]=a,a.delegateTarget=this,!k.preDispatch||k.preDispatch.call(this,a)!==!1){h=n.event.handlers.call(this,a,j),b=0;while((f=h[b++])&&!a.isPropagationStopped()){a.currentTarget=f.elem,g=0;while((e=f.handlers[g++])&&!a.isImmediatePropagationStopped())(!a.namespace_re||a.namespace_re.test(e.namespace))&&(a.handleObj=e,a.data=e.data,c=((n.event.special[e.origType]||{}).handle||e.handler).apply(f.elem,i),void 0!==c&&(a.result=c)===!1&&(a.preventDefault(),a.stopPropagation()))}return k.postDispatch&&k.postDispatch.call(this,a),a.result}},handlers:function(a,b){var c,d,e,f,g=[],h=b.delegateCount,i=a.target;if(h&&i.nodeType&&(!a.button||"click"!==a.type))for(;i!=this;i=i.parentNode||this)if(1===i.nodeType&&(i.disabled!==!0||"click"!==a.type)){for(e=[],f=0;h>f;f++)d=b[f],c=d.selector+" ",void 0===e[c]&&(e[c]=d.needsContext?n(c,this).index(i)>=0:n.find(c,this,null,[i]).length),e[c]&&e.push(d);e.length&&g.push({elem:i,handlers:e})}return h<b.length&&g.push({elem:this,handlers:b.slice(h)}),g},fix:function(a){if(a[n.expando])return a;var b,c,d,e=a.type,f=a,g=this.fixHooks[e];g||(this.fixHooks[e]=g=$.test(e)?this.mouseHooks:Z.test(e)?this.keyHooks:{}),d=g.props?this.props.concat(g.props):this.props,a=new n.Event(f),b=d.length;while(b--)c=d[b],a[c]=f[c];return a.target||(a.target=f.srcElement||z),3===a.target.nodeType&&(a.target=a.target.parentNode),a.metaKey=!!a.metaKey,g.filter?g.filter(a,f):a},props:"altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char charCode key keyCode".split(" "),filter:function(a,b){return null==a.which&&(a.which=null!=b.charCode?b.charCode:b.keyCode),a}},mouseHooks:{props:"button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "),filter:function(a,b){var c,d,e,f=b.button,g=b.fromElement;return null==a.pageX&&null!=b.clientX&&(d=a.target.ownerDocument||z,e=d.documentElement,c=d.body,a.pageX=b.clientX+(e&&e.scrollLeft||c&&c.scrollLeft||0)-(e&&e.clientLeft||c&&c.clientLeft||0),a.pageY=b.clientY+(e&&e.scrollTop||c&&c.scrollTop||0)-(e&&e.clientTop||c&&c.clientTop||0)),!a.relatedTarget&&g&&(a.relatedTarget=g===a.target?b.toElement:g),a.which||void 0===f||(a.which=1&f?1:2&f?3:4&f?2:0),a}},special:{load:{noBubble:!0},focus:{trigger:function(){if(this!==db()&&this.focus)try{return this.focus(),!1}catch(a){}},delegateType:"focusin"},blur:{trigger:function(){return this===db()&&this.blur?(this.blur(),!1):void 0},delegateType:"focusout"},click:{trigger:function(){return n.nodeName(this,"input")&&"checkbox"===this.type&&this.click?(this.click(),!1):void 0},_default:function(a){return n.nodeName(a.target,"a")}},beforeunload:{postDispatch:function(a){void 0!==a.result&&(a.originalEvent.returnValue=a.result)}}},simulate:function(a,b,c,d){var e=n.extend(new n.Event,c,{type:a,isSimulated:!0,originalEvent:{}});d?n.event.trigger(e,null,b):n.event.dispatch.call(b,e),e.isDefaultPrevented()&&c.preventDefault()}},n.removeEvent=z.removeEventListener?function(a,b,c){a.removeEventListener&&a.removeEventListener(b,c,!1)}:function(a,b,c){var d="on"+b;a.detachEvent&&(typeof a[d]===L&&(a[d]=null),a.detachEvent(d,c))},n.Event=function(a,b){return this instanceof n.Event?(a&&a.type?(this.originalEvent=a,this.type=a.type,this.isDefaultPrevented=a.defaultPrevented||void 0===a.defaultPrevented&&(a.returnValue===!1||a.getPreventDefault&&a.getPreventDefault())?bb:cb):this.type=a,b&&n.extend(this,b),this.timeStamp=a&&a.timeStamp||n.now(),void(this[n.expando]=!0)):new n.Event(a,b)},n.Event.prototype={isDefaultPrevented:cb,isPropagationStopped:cb,isImmediatePropagationStopped:cb,preventDefault:function(){var a=this.originalEvent;this.isDefaultPrevented=bb,a&&(a.preventDefault?a.preventDefault():a.returnValue=!1)},stopPropagation:function(){var a=this.originalEvent;this.isPropagationStopped=bb,a&&(a.stopPropagation&&a.stopPropagation(),a.cancelBubble=!0)},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=bb,this.stopPropagation()}},n.each({mouseenter:"mouseover",mouseleave:"mouseout"},function(a,b){n.event.special[a]={delegateType:b,bindType:b,handle:function(a){var c,d=this,e=a.relatedTarget,f=a.handleObj;return(!e||e!==d&&!n.contains(d,e))&&(a.type=f.origType,c=f.handler.apply(this,arguments),a.type=b),c}}}),l.submitBubbles||(n.event.special.submit={setup:function(){return n.nodeName(this,"form")?!1:void n.event.add(this,"click._submit keypress._submit",function(a){var b=a.target,c=n.nodeName(b,"input")||n.nodeName(b,"button")?b.form:void 0;c&&!n._data(c,"submitBubbles")&&(n.event.add(c,"submit._submit",function(a){a._submit_bubble=!0}),n._data(c,"submitBubbles",!0))})},postDispatch:function(a){a._submit_bubble&&(delete a._submit_bubble,this.parentNode&&!a.isTrigger&&n.event.simulate("submit",this.parentNode,a,!0))},teardown:function(){return n.nodeName(this,"form")?!1:void n.event.remove(this,"._submit")}}),l.changeBubbles||(n.event.special.change={setup:function(){return Y.test(this.nodeName)?(("checkbox"===this.type||"radio"===this.type)&&(n.event.add(this,"propertychange._change",function(a){"checked"===a.originalEvent.propertyName&&(this._just_changed=!0)}),n.event.add(this,"click._change",function(a){this._just_changed&&!a.isTrigger&&(this._just_changed=!1),n.event.simulate("change",this,a,!0)})),!1):void n.event.add(this,"beforeactivate._change",function(a){var b=a.target;Y.test(b.nodeName)&&!n._data(b,"changeBubbles")&&(n.event.add(b,"change._change",function(a){!this.parentNode||a.isSimulated||a.isTrigger||n.event.simulate("change",this.parentNode,a,!0)}),n._data(b,"changeBubbles",!0))})},handle:function(a){var b=a.target;return this!==b||a.isSimulated||a.isTrigger||"radio"!==b.type&&"checkbox"!==b.type?a.handleObj.handler.apply(this,arguments):void 0},teardown:function(){return n.event.remove(this,"._change"),!Y.test(this.nodeName)}}),l.focusinBubbles||n.each({focus:"focusin",blur:"focusout"},function(a,b){var c=function(a){n.event.simulate(b,a.target,n.event.fix(a),!0)};n.event.special[b]={setup:function(){var d=this.ownerDocument||this,e=n._data(d,b);e||d.addEventListener(a,c,!0),n._data(d,b,(e||0)+1)},teardown:function(){var d=this.ownerDocument||this,e=n._data(d,b)-1;e?n._data(d,b,e):(d.removeEventListener(a,c,!0),n._removeData(d,b))}}}),n.fn.extend({on:function(a,b,c,d,e){var f,g;if("object"==typeof a){"string"!=typeof b&&(c=c||b,b=void 0);for(f in a)this.on(f,b,c,a[f],e);return this}if(null==c&&null==d?(d=b,c=b=void 0):null==d&&("string"==typeof b?(d=c,c=void 0):(d=c,c=b,b=void 0)),d===!1)d=cb;else if(!d)return this;return 1===e&&(g=d,d=function(a){return n().off(a),g.apply(this,arguments)},d.guid=g.guid||(g.guid=n.guid++)),this.each(function(){n.event.add(this,a,d,c,b)})},one:function(a,b,c,d){return this.on(a,b,c,d,1)},off:function(a,b,c){var d,e;if(a&&a.preventDefault&&a.handleObj)return d=a.handleObj,n(a.delegateTarget).off(d.namespace?d.origType+"."+d.namespace:d.origType,d.selector,d.handler),this;if("object"==typeof a){for(e in a)this.off(e,b,a[e]);return this}return(b===!1||"function"==typeof b)&&(c=b,b=void 0),c===!1&&(c=cb),this.each(function(){n.event.remove(this,a,c,b)})},trigger:function(a,b){return this.each(function(){n.event.trigger(a,b,this)})},triggerHandler:function(a,b){var c=this[0];return c?n.event.trigger(a,b,c,!0):void 0}});function eb(a){var b=fb.split("|"),c=a.createDocumentFragment();if(c.createElement)while(b.length)c.createElement(b.pop());return c}var fb="abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",gb=/ jQuery\d+="(?:null|\d+)"/g,hb=new RegExp("<(?:"+fb+")[\\s/>]","i"),ib=/^\s+/,jb=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,kb=/<([\w:]+)/,lb=/<tbody/i,mb=/<|&#?\w+;/,nb=/<(?:script|style|link)/i,ob=/checked\s*(?:[^=]|=\s*.checked.)/i,pb=/^$|\/(?:java|ecma)script/i,qb=/^true\/(.*)/,rb=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g,sb={option:[1,"<select multiple='multiple'>","</select>"],legend:[1,"<fieldset>","</fieldset>"],area:[1,"<map>","</map>"],param:[1,"<object>","</object>"],thead:[1,"<table>","</table>"],tr:[2,"<table><tbody>","</tbody></table>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:l.htmlSerialize?[0,"",""]:[1,"X<div>","</div>"]},tb=eb(z),ub=tb.appendChild(z.createElement("div"));sb.optgroup=sb.option,sb.tbody=sb.tfoot=sb.colgroup=sb.caption=sb.thead,sb.th=sb.td;function vb(a,b){var c,d,e=0,f=typeof a.getElementsByTagName!==L?a.getElementsByTagName(b||"*"):typeof a.querySelectorAll!==L?a.querySelectorAll(b||"*"):void 0;if(!f)for(f=[],c=a.childNodes||a;null!=(d=c[e]);e++)!b||n.nodeName(d,b)?f.push(d):n.merge(f,vb(d,b));return void 0===b||b&&n.nodeName(a,b)?n.merge([a],f):f}function wb(a){X.test(a.type)&&(a.defaultChecked=a.checked)}function xb(a,b){return n.nodeName(a,"table")&&n.nodeName(11!==b.nodeType?b:b.firstChild,"tr")?a.getElementsByTagName("tbody")[0]||a.appendChild(a.ownerDocument.createElement("tbody")):a}function yb(a){return a.type=(null!==n.find.attr(a,"type"))+"/"+a.type,a}function zb(a){var b=qb.exec(a.type);return b?a.type=b[1]:a.removeAttribute("type"),a}function Ab(a,b){for(var c,d=0;null!=(c=a[d]);d++)n._data(c,"globalEval",!b||n._data(b[d],"globalEval"))}function Bb(a,b){if(1===b.nodeType&&n.hasData(a)){var c,d,e,f=n._data(a),g=n._data(b,f),h=f.events;if(h){delete g.handle,g.events={};for(c in h)for(d=0,e=h[c].length;e>d;d++)n.event.add(b,c,h[c][d])}g.data&&(g.data=n.extend({},g.data))}}function Cb(a,b){var c,d,e;if(1===b.nodeType){if(c=b.nodeName.toLowerCase(),!l.noCloneEvent&&b[n.expando]){e=n._data(b);for(d in e.events)n.removeEvent(b,d,e.handle);b.removeAttribute(n.expando)}"script"===c&&b.text!==a.text?(yb(b).text=a.text,zb(b)):"object"===c?(b.parentNode&&(b.outerHTML=a.outerHTML),l.html5Clone&&a.innerHTML&&!n.trim(b.innerHTML)&&(b.innerHTML=a.innerHTML)):"input"===c&&X.test(a.type)?(b.defaultChecked=b.checked=a.checked,b.value!==a.value&&(b.value=a.value)):"option"===c?b.defaultSelected=b.selected=a.defaultSelected:("input"===c||"textarea"===c)&&(b.defaultValue=a.defaultValue)}}n.extend({clone:function(a,b,c){var d,e,f,g,h,i=n.contains(a.ownerDocument,a);if(l.html5Clone||n.isXMLDoc(a)||!hb.test("<"+a.nodeName+">")?f=a.cloneNode(!0):(ub.innerHTML=a.outerHTML,ub.removeChild(f=ub.firstChild)),!(l.noCloneEvent&&l.noCloneChecked||1!==a.nodeType&&11!==a.nodeType||n.isXMLDoc(a)))for(d=vb(f),h=vb(a),g=0;null!=(e=h[g]);++g)d[g]&&Cb(e,d[g]);if(b)if(c)for(h=h||vb(a),d=d||vb(f),g=0;null!=(e=h[g]);g++)Bb(e,d[g]);else Bb(a,f);return d=vb(f,"script"),d.length>0&&Ab(d,!i&&vb(a,"script")),d=h=e=null,f},buildFragment:function(a,b,c,d){for(var e,f,g,h,i,j,k,m=a.length,o=eb(b),p=[],q=0;m>q;q++)if(f=a[q],f||0===f)if("object"===n.type(f))n.merge(p,f.nodeType?[f]:f);else if(mb.test(f)){h=h||o.appendChild(b.createElement("div")),i=(kb.exec(f)||["",""])[1].toLowerCase(),k=sb[i]||sb._default,h.innerHTML=k[1]+f.replace(jb,"<$1></$2>")+k[2],e=k[0];while(e--)h=h.lastChild;if(!l.leadingWhitespace&&ib.test(f)&&p.push(b.createTextNode(ib.exec(f)[0])),!l.tbody){f="table"!==i||lb.test(f)?"<table>"!==k[1]||lb.test(f)?0:h:h.firstChild,e=f&&f.childNodes.length;while(e--)n.nodeName(j=f.childNodes[e],"tbody")&&!j.childNodes.length&&f.removeChild(j)}n.merge(p,h.childNodes),h.textContent="";while(h.firstChild)h.removeChild(h.firstChild);h=o.lastChild}else p.push(b.createTextNode(f));h&&o.removeChild(h),l.appendChecked||n.grep(vb(p,"input"),wb),q=0;while(f=p[q++])if((!d||-1===n.inArray(f,d))&&(g=n.contains(f.ownerDocument,f),h=vb(o.appendChild(f),"script"),g&&Ab(h),c)){e=0;while(f=h[e++])pb.test(f.type||"")&&c.push(f)}return h=null,o},cleanData:function(a,b){for(var d,e,f,g,h=0,i=n.expando,j=n.cache,k=l.deleteExpando,m=n.event.special;null!=(d=a[h]);h++)if((b||n.acceptData(d))&&(f=d[i],g=f&&j[f])){if(g.events)for(e in g.events)m[e]?n.event.remove(d,e):n.removeEvent(d,e,g.handle);j[f]&&(delete j[f],k?delete d[i]:typeof d.removeAttribute!==L?d.removeAttribute(i):d[i]=null,c.push(f))}}}),n.fn.extend({text:function(a){return W(this,function(a){return void 0===a?n.text(this):this.empty().append((this[0]&&this[0].ownerDocument||z).createTextNode(a))},null,a,arguments.length)},append:function(){return this.domManip(arguments,function(a){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var b=xb(this,a);b.appendChild(a)}})},prepend:function(){return this.domManip(arguments,function(a){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var b=xb(this,a);b.insertBefore(a,b.firstChild)}})},before:function(){return this.domManip(arguments,function(a){this.parentNode&&this.parentNode.insertBefore(a,this)})},after:function(){return this.domManip(arguments,function(a){this.parentNode&&this.parentNode.insertBefore(a,this.nextSibling)})},remove:function(a,b){for(var c,d=a?n.filter(a,this):this,e=0;null!=(c=d[e]);e++)b||1!==c.nodeType||n.cleanData(vb(c)),c.parentNode&&(b&&n.contains(c.ownerDocument,c)&&Ab(vb(c,"script")),c.parentNode.removeChild(c));return this},empty:function(){for(var a,b=0;null!=(a=this[b]);b++){1===a.nodeType&&n.cleanData(vb(a,!1));while(a.firstChild)a.removeChild(a.firstChild);a.options&&n.nodeName(a,"select")&&(a.options.length=0)}return this},clone:function(a,b){return a=null==a?!1:a,b=null==b?a:b,this.map(function(){return n.clone(this,a,b)})},html:function(a){return W(this,function(a){var b=this[0]||{},c=0,d=this.length;if(void 0===a)return 1===b.nodeType?b.innerHTML.replace(gb,""):void 0;if(!("string"!=typeof a||nb.test(a)||!l.htmlSerialize&&hb.test(a)||!l.leadingWhitespace&&ib.test(a)||sb[(kb.exec(a)||["",""])[1].toLowerCase()])){a=a.replace(jb,"<$1></$2>");try{for(;d>c;c++)b=this[c]||{},1===b.nodeType&&(n.cleanData(vb(b,!1)),b.innerHTML=a);b=0}catch(e){}}b&&this.empty().append(a)},null,a,arguments.length)},replaceWith:function(){var a=arguments[0];return this.domManip(arguments,function(b){a=this.parentNode,n.cleanData(vb(this)),a&&a.replaceChild(b,this)}),a&&(a.length||a.nodeType)?this:this.remove()},detach:function(a){return this.remove(a,!0)},domManip:function(a,b){a=e.apply([],a);var c,d,f,g,h,i,j=0,k=this.length,m=this,o=k-1,p=a[0],q=n.isFunction(p);if(q||k>1&&"string"==typeof p&&!l.checkClone&&ob.test(p))return this.each(function(c){var d=m.eq(c);q&&(a[0]=p.call(this,c,d.html())),d.domManip(a,b)});if(k&&(i=n.buildFragment(a,this[0].ownerDocument,!1,this),c=i.firstChild,1===i.childNodes.length&&(i=c),c)){for(g=n.map(vb(i,"script"),yb),f=g.length;k>j;j++)d=i,j!==o&&(d=n.clone(d,!0,!0),f&&n.merge(g,vb(d,"script"))),b.call(this[j],d,j);if(f)for(h=g[g.length-1].ownerDocument,n.map(g,zb),j=0;f>j;j++)d=g[j],pb.test(d.type||"")&&!n._data(d,"globalEval")&&n.contains(h,d)&&(d.src?n._evalUrl&&n._evalUrl(d.src):n.globalEval((d.text||d.textContent||d.innerHTML||"").replace(rb,"")));i=c=null}return this}}),n.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){n.fn[a]=function(a){for(var c,d=0,e=[],g=n(a),h=g.length-1;h>=d;d++)c=d===h?this:this.clone(!0),n(g[d])[b](c),f.apply(e,c.get());return this.pushStack(e)}});var Db,Eb={};function Fb(b,c){var d=n(c.createElement(b)).appendTo(c.body),e=a.getDefaultComputedStyle?a.getDefaultComputedStyle(d[0]).display:n.css(d[0],"display");return d.detach(),e}function Gb(a){var b=z,c=Eb[a];return c||(c=Fb(a,b),"none"!==c&&c||(Db=(Db||n("<iframe frameborder='0' width='0' height='0'/>")).appendTo(b.documentElement),b=(Db[0].contentWindow||Db[0].contentDocument).document,b.write(),b.close(),c=Fb(a,b),Db.detach()),Eb[a]=c),c}!function(){var a,b,c=z.createElement("div"),d="-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box;display:block;padding:0;margin:0;border:0";c.innerHTML="  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",a=c.getElementsByTagName("a")[0],a.style.cssText="float:left;opacity:.5",l.opacity=/^0.5/.test(a.style.opacity),l.cssFloat=!!a.style.cssFloat,c.style.backgroundClip="content-box",c.cloneNode(!0).style.backgroundClip="",l.clearCloneStyle="content-box"===c.style.backgroundClip,a=c=null,l.shrinkWrapBlocks=function(){var a,c,e,f;if(null==b){if(a=z.getElementsByTagName("body")[0],!a)return;f="border:0;width:0;height:0;position:absolute;top:0;left:-9999px",c=z.createElement("div"),e=z.createElement("div"),a.appendChild(c).appendChild(e),b=!1,typeof e.style.zoom!==L&&(e.style.cssText=d+";width:1px;padding:1px;zoom:1",e.innerHTML="<div></div>",e.firstChild.style.width="5px",b=3!==e.offsetWidth),a.removeChild(c),a=c=e=null}return b}}();var Hb=/^margin/,Ib=new RegExp("^("+T+")(?!px)[a-z%]+$","i"),Jb,Kb,Lb=/^(top|right|bottom|left)$/;a.getComputedStyle?(Jb=function(a){return a.ownerDocument.defaultView.getComputedStyle(a,null)},Kb=function(a,b,c){var d,e,f,g,h=a.style;return c=c||Jb(a),g=c?c.getPropertyValue(b)||c[b]:void 0,c&&(""!==g||n.contains(a.ownerDocument,a)||(g=n.style(a,b)),Ib.test(g)&&Hb.test(b)&&(d=h.width,e=h.minWidth,f=h.maxWidth,h.minWidth=h.maxWidth=h.width=g,g=c.width,h.width=d,h.minWidth=e,h.maxWidth=f)),void 0===g?g:g+""}):z.documentElement.currentStyle&&(Jb=function(a){return a.currentStyle},Kb=function(a,b,c){var d,e,f,g,h=a.style;return c=c||Jb(a),g=c?c[b]:void 0,null==g&&h&&h[b]&&(g=h[b]),Ib.test(g)&&!Lb.test(b)&&(d=h.left,e=a.runtimeStyle,f=e&&e.left,f&&(e.left=a.currentStyle.left),h.left="fontSize"===b?"1em":g,g=h.pixelLeft+"px",h.left=d,f&&(e.left=f)),void 0===g?g:g+""||"auto"});function Mb(a,b){return{get:function(){var c=a();if(null!=c)return c?void delete this.get:(this.get=b).apply(this,arguments)}}}!function(){var b,c,d,e,f,g,h=z.createElement("div"),i="border:0;width:0;height:0;position:absolute;top:0;left:-9999px",j="-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box;display:block;padding:0;margin:0;border:0";h.innerHTML="  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",b=h.getElementsByTagName("a")[0],b.style.cssText="float:left;opacity:.5",l.opacity=/^0.5/.test(b.style.opacity),l.cssFloat=!!b.style.cssFloat,h.style.backgroundClip="content-box",h.cloneNode(!0).style.backgroundClip="",l.clearCloneStyle="content-box"===h.style.backgroundClip,b=h=null,n.extend(l,{reliableHiddenOffsets:function(){if(null!=c)return c;var a,b,d,e=z.createElement("div"),f=z.getElementsByTagName("body")[0];if(f)return e.setAttribute("className","t"),e.innerHTML="  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",a=z.createElement("div"),a.style.cssText=i,f.appendChild(a).appendChild(e),e.innerHTML="<table><tr><td></td><td>t</td></tr></table>",b=e.getElementsByTagName("td"),b[0].style.cssText="padding:0;margin:0;border:0;display:none",d=0===b[0].offsetHeight,b[0].style.display="",b[1].style.display="none",c=d&&0===b[0].offsetHeight,f.removeChild(a),e=f=null,c},boxSizing:function(){return null==d&&k(),d},boxSizingReliable:function(){return null==e&&k(),e},pixelPosition:function(){return null==f&&k(),f},reliableMarginRight:function(){var b,c,d,e;if(null==g&&a.getComputedStyle){if(b=z.getElementsByTagName("body")[0],!b)return;c=z.createElement("div"),d=z.createElement("div"),c.style.cssText=i,b.appendChild(c).appendChild(d),e=d.appendChild(z.createElement("div")),e.style.cssText=d.style.cssText=j,e.style.marginRight=e.style.width="0",d.style.width="1px",g=!parseFloat((a.getComputedStyle(e,null)||{}).marginRight),b.removeChild(c)}return g}});function k(){var b,c,h=z.getElementsByTagName("body")[0];h&&(b=z.createElement("div"),c=z.createElement("div"),b.style.cssText=i,h.appendChild(b).appendChild(c),c.style.cssText="-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;position:absolute;display:block;padding:1px;border:1px;width:4px;margin-top:1%;top:1%",n.swap(h,null!=h.style.zoom?{zoom:1}:{},function(){d=4===c.offsetWidth}),e=!0,f=!1,g=!0,a.getComputedStyle&&(f="1%"!==(a.getComputedStyle(c,null)||{}).top,e="4px"===(a.getComputedStyle(c,null)||{width:"4px"}).width),h.removeChild(b),c=h=null)}}(),n.swap=function(a,b,c,d){var e,f,g={};for(f in b)g[f]=a.style[f],a.style[f]=b[f];e=c.apply(a,d||[]);for(f in b)a.style[f]=g[f];return e};var Nb=/alpha\([^)]*\)/i,Ob=/opacity\s*=\s*([^)]*)/,Pb=/^(none|table(?!-c[ea]).+)/,Qb=new RegExp("^("+T+")(.*)$","i"),Rb=new RegExp("^([+-])=("+T+")","i"),Sb={position:"absolute",visibility:"hidden",display:"block"},Tb={letterSpacing:0,fontWeight:400},Ub=["Webkit","O","Moz","ms"];function Vb(a,b){if(b in a)return b;var c=b.charAt(0).toUpperCase()+b.slice(1),d=b,e=Ub.length;while(e--)if(b=Ub[e]+c,b in a)return b;return d}function Wb(a,b){for(var c,d,e,f=[],g=0,h=a.length;h>g;g++)d=a[g],d.style&&(f[g]=n._data(d,"olddisplay"),c=d.style.display,b?(f[g]||"none"!==c||(d.style.display=""),""===d.style.display&&V(d)&&(f[g]=n._data(d,"olddisplay",Gb(d.nodeName)))):f[g]||(e=V(d),(c&&"none"!==c||!e)&&n._data(d,"olddisplay",e?c:n.css(d,"display"))));for(g=0;h>g;g++)d=a[g],d.style&&(b&&"none"!==d.style.display&&""!==d.style.display||(d.style.display=b?f[g]||"":"none"));return a}function Xb(a,b,c){var d=Qb.exec(b);return d?Math.max(0,d[1]-(c||0))+(d[2]||"px"):b}function Yb(a,b,c,d,e){for(var f=c===(d?"border":"content")?4:"width"===b?1:0,g=0;4>f;f+=2)"margin"===c&&(g+=n.css(a,c+U[f],!0,e)),d?("content"===c&&(g-=n.css(a,"padding"+U[f],!0,e)),"margin"!==c&&(g-=n.css(a,"border"+U[f]+"Width",!0,e))):(g+=n.css(a,"padding"+U[f],!0,e),"padding"!==c&&(g+=n.css(a,"border"+U[f]+"Width",!0,e)));return g}function Zb(a,b,c){var d=!0,e="width"===b?a.offsetWidth:a.offsetHeight,f=Jb(a),g=l.boxSizing()&&"border-box"===n.css(a,"boxSizing",!1,f);if(0>=e||null==e){if(e=Kb(a,b,f),(0>e||null==e)&&(e=a.style[b]),Ib.test(e))return e;d=g&&(l.boxSizingReliable()||e===a.style[b]),e=parseFloat(e)||0}return e+Yb(a,b,c||(g?"border":"content"),d,f)+"px"}n.extend({cssHooks:{opacity:{get:function(a,b){if(b){var c=Kb(a,"opacity");return""===c?"1":c}}}},cssNumber:{columnCount:!0,fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":l.cssFloat?"cssFloat":"styleFloat"},style:function(a,b,c,d){if(a&&3!==a.nodeType&&8!==a.nodeType&&a.style){var e,f,g,h=n.camelCase(b),i=a.style;if(b=n.cssProps[h]||(n.cssProps[h]=Vb(i,h)),g=n.cssHooks[b]||n.cssHooks[h],void 0===c)return g&&"get"in g&&void 0!==(e=g.get(a,!1,d))?e:i[b];if(f=typeof c,"string"===f&&(e=Rb.exec(c))&&(c=(e[1]+1)*e[2]+parseFloat(n.css(a,b)),f="number"),null!=c&&c===c&&("number"!==f||n.cssNumber[h]||(c+="px"),l.clearCloneStyle||""!==c||0!==b.indexOf("background")||(i[b]="inherit"),!(g&&"set"in g&&void 0===(c=g.set(a,c,d)))))try{i[b]="",i[b]=c}catch(j){}}},css:function(a,b,c,d){var e,f,g,h=n.camelCase(b);return b=n.cssProps[h]||(n.cssProps[h]=Vb(a.style,h)),g=n.cssHooks[b]||n.cssHooks[h],g&&"get"in g&&(f=g.get(a,!0,c)),void 0===f&&(f=Kb(a,b,d)),"normal"===f&&b in Tb&&(f=Tb[b]),""===c||c?(e=parseFloat(f),c===!0||n.isNumeric(e)?e||0:f):f}}),n.each(["height","width"],function(a,b){n.cssHooks[b]={get:function(a,c,d){return c?0===a.offsetWidth&&Pb.test(n.css(a,"display"))?n.swap(a,Sb,function(){return Zb(a,b,d)}):Zb(a,b,d):void 0},set:function(a,c,d){var e=d&&Jb(a);return Xb(a,c,d?Yb(a,b,d,l.boxSizing()&&"border-box"===n.css(a,"boxSizing",!1,e),e):0)}}}),l.opacity||(n.cssHooks.opacity={get:function(a,b){return Ob.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)||"")?.01*parseFloat(RegExp.$1)+"":b?"1":""},set:function(a,b){var c=a.style,d=a.currentStyle,e=n.isNumeric(b)?"alpha(opacity="+100*b+")":"",f=d&&d.filter||c.filter||"";c.zoom=1,(b>=1||""===b)&&""===n.trim(f.replace(Nb,""))&&c.removeAttribute&&(c.removeAttribute("filter"),""===b||d&&!d.filter)||(c.filter=Nb.test(f)?f.replace(Nb,e):f+" "+e)}}),n.cssHooks.marginRight=Mb(l.reliableMarginRight,function(a,b){return b?n.swap(a,{display:"inline-block"},Kb,[a,"marginRight"]):void 0}),n.each({margin:"",padding:"",border:"Width"},function(a,b){n.cssHooks[a+b]={expand:function(c){for(var d=0,e={},f="string"==typeof c?c.split(" "):[c];4>d;d++)e[a+U[d]+b]=f[d]||f[d-2]||f[0];return e}},Hb.test(a)||(n.cssHooks[a+b].set=Xb)}),n.fn.extend({css:function(a,b){return W(this,function(a,b,c){var d,e,f={},g=0;if(n.isArray(b)){for(d=Jb(a),e=b.length;e>g;g++)f[b[g]]=n.css(a,b[g],!1,d);return f}return void 0!==c?n.style(a,b,c):n.css(a,b)
+},a,b,arguments.length>1)},show:function(){return Wb(this,!0)},hide:function(){return Wb(this)},toggle:function(a){return"boolean"==typeof a?a?this.show():this.hide():this.each(function(){V(this)?n(this).show():n(this).hide()})}});function $b(a,b,c,d,e){return new $b.prototype.init(a,b,c,d,e)}n.Tween=$b,$b.prototype={constructor:$b,init:function(a,b,c,d,e,f){this.elem=a,this.prop=c,this.easing=e||"swing",this.options=b,this.start=this.now=this.cur(),this.end=d,this.unit=f||(n.cssNumber[c]?"":"px")},cur:function(){var a=$b.propHooks[this.prop];return a&&a.get?a.get(this):$b.propHooks._default.get(this)},run:function(a){var b,c=$b.propHooks[this.prop];return this.pos=b=this.options.duration?n.easing[this.easing](a,this.options.duration*a,0,1,this.options.duration):a,this.now=(this.end-this.start)*b+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),c&&c.set?c.set(this):$b.propHooks._default.set(this),this}},$b.prototype.init.prototype=$b.prototype,$b.propHooks={_default:{get:function(a){var b;return null==a.elem[a.prop]||a.elem.style&&null!=a.elem.style[a.prop]?(b=n.css(a.elem,a.prop,""),b&&"auto"!==b?b:0):a.elem[a.prop]},set:function(a){n.fx.step[a.prop]?n.fx.step[a.prop](a):a.elem.style&&(null!=a.elem.style[n.cssProps[a.prop]]||n.cssHooks[a.prop])?n.style(a.elem,a.prop,a.now+a.unit):a.elem[a.prop]=a.now}}},$b.propHooks.scrollTop=$b.propHooks.scrollLeft={set:function(a){a.elem.nodeType&&a.elem.parentNode&&(a.elem[a.prop]=a.now)}},n.easing={linear:function(a){return a},swing:function(a){return.5-Math.cos(a*Math.PI)/2}},n.fx=$b.prototype.init,n.fx.step={};var _b,ac,bc=/^(?:toggle|show|hide)$/,cc=new RegExp("^(?:([+-])=|)("+T+")([a-z%]*)$","i"),dc=/queueHooks$/,ec=[jc],fc={"*":[function(a,b){var c=this.createTween(a,b),d=c.cur(),e=cc.exec(b),f=e&&e[3]||(n.cssNumber[a]?"":"px"),g=(n.cssNumber[a]||"px"!==f&&+d)&&cc.exec(n.css(c.elem,a)),h=1,i=20;if(g&&g[3]!==f){f=f||g[3],e=e||[],g=+d||1;do h=h||".5",g/=h,n.style(c.elem,a,g+f);while(h!==(h=c.cur()/d)&&1!==h&&--i)}return e&&(g=c.start=+g||+d||0,c.unit=f,c.end=e[1]?g+(e[1]+1)*e[2]:+e[2]),c}]};function gc(){return setTimeout(function(){_b=void 0}),_b=n.now()}function hc(a,b){var c,d={height:a},e=0;for(b=b?1:0;4>e;e+=2-b)c=U[e],d["margin"+c]=d["padding"+c]=a;return b&&(d.opacity=d.width=a),d}function ic(a,b,c){for(var d,e=(fc[b]||[]).concat(fc["*"]),f=0,g=e.length;g>f;f++)if(d=e[f].call(c,b,a))return d}function jc(a,b,c){var d,e,f,g,h,i,j,k,m=this,o={},p=a.style,q=a.nodeType&&V(a),r=n._data(a,"fxshow");c.queue||(h=n._queueHooks(a,"fx"),null==h.unqueued&&(h.unqueued=0,i=h.empty.fire,h.empty.fire=function(){h.unqueued||i()}),h.unqueued++,m.always(function(){m.always(function(){h.unqueued--,n.queue(a,"fx").length||h.empty.fire()})})),1===a.nodeType&&("height"in b||"width"in b)&&(c.overflow=[p.overflow,p.overflowX,p.overflowY],j=n.css(a,"display"),k=Gb(a.nodeName),"none"===j&&(j=k),"inline"===j&&"none"===n.css(a,"float")&&(l.inlineBlockNeedsLayout&&"inline"!==k?p.zoom=1:p.display="inline-block")),c.overflow&&(p.overflow="hidden",l.shrinkWrapBlocks()||m.always(function(){p.overflow=c.overflow[0],p.overflowX=c.overflow[1],p.overflowY=c.overflow[2]}));for(d in b)if(e=b[d],bc.exec(e)){if(delete b[d],f=f||"toggle"===e,e===(q?"hide":"show")){if("show"!==e||!r||void 0===r[d])continue;q=!0}o[d]=r&&r[d]||n.style(a,d)}if(!n.isEmptyObject(o)){r?"hidden"in r&&(q=r.hidden):r=n._data(a,"fxshow",{}),f&&(r.hidden=!q),q?n(a).show():m.done(function(){n(a).hide()}),m.done(function(){var b;n._removeData(a,"fxshow");for(b in o)n.style(a,b,o[b])});for(d in o)g=ic(q?r[d]:0,d,m),d in r||(r[d]=g.start,q&&(g.end=g.start,g.start="width"===d||"height"===d?1:0))}}function kc(a,b){var c,d,e,f,g;for(c in a)if(d=n.camelCase(c),e=b[d],f=a[c],n.isArray(f)&&(e=f[1],f=a[c]=f[0]),c!==d&&(a[d]=f,delete a[c]),g=n.cssHooks[d],g&&"expand"in g){f=g.expand(f),delete a[d];for(c in f)c in a||(a[c]=f[c],b[c]=e)}else b[d]=e}function lc(a,b,c){var d,e,f=0,g=ec.length,h=n.Deferred().always(function(){delete i.elem}),i=function(){if(e)return!1;for(var b=_b||gc(),c=Math.max(0,j.startTime+j.duration-b),d=c/j.duration||0,f=1-d,g=0,i=j.tweens.length;i>g;g++)j.tweens[g].run(f);return h.notifyWith(a,[j,f,c]),1>f&&i?c:(h.resolveWith(a,[j]),!1)},j=h.promise({elem:a,props:n.extend({},b),opts:n.extend(!0,{specialEasing:{}},c),originalProperties:b,originalOptions:c,startTime:_b||gc(),duration:c.duration,tweens:[],createTween:function(b,c){var d=n.Tween(a,j.opts,b,c,j.opts.specialEasing[b]||j.opts.easing);return j.tweens.push(d),d},stop:function(b){var c=0,d=b?j.tweens.length:0;if(e)return this;for(e=!0;d>c;c++)j.tweens[c].run(1);return b?h.resolveWith(a,[j,b]):h.rejectWith(a,[j,b]),this}}),k=j.props;for(kc(k,j.opts.specialEasing);g>f;f++)if(d=ec[f].call(j,a,k,j.opts))return d;return n.map(k,ic,j),n.isFunction(j.opts.start)&&j.opts.start.call(a,j),n.fx.timer(n.extend(i,{elem:a,anim:j,queue:j.opts.queue})),j.progress(j.opts.progress).done(j.opts.done,j.opts.complete).fail(j.opts.fail).always(j.opts.always)}n.Animation=n.extend(lc,{tweener:function(a,b){n.isFunction(a)?(b=a,a=["*"]):a=a.split(" ");for(var c,d=0,e=a.length;e>d;d++)c=a[d],fc[c]=fc[c]||[],fc[c].unshift(b)},prefilter:function(a,b){b?ec.unshift(a):ec.push(a)}}),n.speed=function(a,b,c){var d=a&&"object"==typeof a?n.extend({},a):{complete:c||!c&&b||n.isFunction(a)&&a,duration:a,easing:c&&b||b&&!n.isFunction(b)&&b};return d.duration=n.fx.off?0:"number"==typeof d.duration?d.duration:d.duration in n.fx.speeds?n.fx.speeds[d.duration]:n.fx.speeds._default,(null==d.queue||d.queue===!0)&&(d.queue="fx"),d.old=d.complete,d.complete=function(){n.isFunction(d.old)&&d.old.call(this),d.queue&&n.dequeue(this,d.queue)},d},n.fn.extend({fadeTo:function(a,b,c,d){return this.filter(V).css("opacity",0).show().end().animate({opacity:b},a,c,d)},animate:function(a,b,c,d){var e=n.isEmptyObject(a),f=n.speed(b,c,d),g=function(){var b=lc(this,n.extend({},a),f);(e||n._data(this,"finish"))&&b.stop(!0)};return g.finish=g,e||f.queue===!1?this.each(g):this.queue(f.queue,g)},stop:function(a,b,c){var d=function(a){var b=a.stop;delete a.stop,b(c)};return"string"!=typeof a&&(c=b,b=a,a=void 0),b&&a!==!1&&this.queue(a||"fx",[]),this.each(function(){var b=!0,e=null!=a&&a+"queueHooks",f=n.timers,g=n._data(this);if(e)g[e]&&g[e].stop&&d(g[e]);else for(e in g)g[e]&&g[e].stop&&dc.test(e)&&d(g[e]);for(e=f.length;e--;)f[e].elem!==this||null!=a&&f[e].queue!==a||(f[e].anim.stop(c),b=!1,f.splice(e,1));(b||!c)&&n.dequeue(this,a)})},finish:function(a){return a!==!1&&(a=a||"fx"),this.each(function(){var b,c=n._data(this),d=c[a+"queue"],e=c[a+"queueHooks"],f=n.timers,g=d?d.length:0;for(c.finish=!0,n.queue(this,a,[]),e&&e.stop&&e.stop.call(this,!0),b=f.length;b--;)f[b].elem===this&&f[b].queue===a&&(f[b].anim.stop(!0),f.splice(b,1));for(b=0;g>b;b++)d[b]&&d[b].finish&&d[b].finish.call(this);delete c.finish})}}),n.each(["toggle","show","hide"],function(a,b){var c=n.fn[b];n.fn[b]=function(a,d,e){return null==a||"boolean"==typeof a?c.apply(this,arguments):this.animate(hc(b,!0),a,d,e)}}),n.each({slideDown:hc("show"),slideUp:hc("hide"),slideToggle:hc("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(a,b){n.fn[a]=function(a,c,d){return this.animate(b,a,c,d)}}),n.timers=[],n.fx.tick=function(){var a,b=n.timers,c=0;for(_b=n.now();c<b.length;c++)a=b[c],a()||b[c]!==a||b.splice(c--,1);b.length||n.fx.stop(),_b=void 0},n.fx.timer=function(a){n.timers.push(a),a()?n.fx.start():n.timers.pop()},n.fx.interval=13,n.fx.start=function(){ac||(ac=setInterval(n.fx.tick,n.fx.interval))},n.fx.stop=function(){clearInterval(ac),ac=null},n.fx.speeds={slow:600,fast:200,_default:400},n.fn.delay=function(a,b){return a=n.fx?n.fx.speeds[a]||a:a,b=b||"fx",this.queue(b,function(b,c){var d=setTimeout(b,a);c.stop=function(){clearTimeout(d)}})},function(){var a,b,c,d,e=z.createElement("div");e.setAttribute("className","t"),e.innerHTML="  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",a=e.getElementsByTagName("a")[0],c=z.createElement("select"),d=c.appendChild(z.createElement("option")),b=e.getElementsByTagName("input")[0],a.style.cssText="top:1px",l.getSetAttribute="t"!==e.className,l.style=/top/.test(a.getAttribute("style")),l.hrefNormalized="/a"===a.getAttribute("href"),l.checkOn=!!b.value,l.optSelected=d.selected,l.enctype=!!z.createElement("form").enctype,c.disabled=!0,l.optDisabled=!d.disabled,b=z.createElement("input"),b.setAttribute("value",""),l.input=""===b.getAttribute("value"),b.value="t",b.setAttribute("type","radio"),l.radioValue="t"===b.value,a=b=c=d=e=null}();var mc=/\r/g;n.fn.extend({val:function(a){var b,c,d,e=this[0];{if(arguments.length)return d=n.isFunction(a),this.each(function(c){var e;1===this.nodeType&&(e=d?a.call(this,c,n(this).val()):a,null==e?e="":"number"==typeof e?e+="":n.isArray(e)&&(e=n.map(e,function(a){return null==a?"":a+""})),b=n.valHooks[this.type]||n.valHooks[this.nodeName.toLowerCase()],b&&"set"in b&&void 0!==b.set(this,e,"value")||(this.value=e))});if(e)return b=n.valHooks[e.type]||n.valHooks[e.nodeName.toLowerCase()],b&&"get"in b&&void 0!==(c=b.get(e,"value"))?c:(c=e.value,"string"==typeof c?c.replace(mc,""):null==c?"":c)}}}),n.extend({valHooks:{option:{get:function(a){var b=n.find.attr(a,"value");return null!=b?b:n.text(a)}},select:{get:function(a){for(var b,c,d=a.options,e=a.selectedIndex,f="select-one"===a.type||0>e,g=f?null:[],h=f?e+1:d.length,i=0>e?h:f?e:0;h>i;i++)if(c=d[i],!(!c.selected&&i!==e||(l.optDisabled?c.disabled:null!==c.getAttribute("disabled"))||c.parentNode.disabled&&n.nodeName(c.parentNode,"optgroup"))){if(b=n(c).val(),f)return b;g.push(b)}return g},set:function(a,b){var c,d,e=a.options,f=n.makeArray(b),g=e.length;while(g--)if(d=e[g],n.inArray(n.valHooks.option.get(d),f)>=0)try{d.selected=c=!0}catch(h){d.scrollHeight}else d.selected=!1;return c||(a.selectedIndex=-1),e}}}}),n.each(["radio","checkbox"],function(){n.valHooks[this]={set:function(a,b){return n.isArray(b)?a.checked=n.inArray(n(a).val(),b)>=0:void 0}},l.checkOn||(n.valHooks[this].get=function(a){return null===a.getAttribute("value")?"on":a.value})});var nc,oc,pc=n.expr.attrHandle,qc=/^(?:checked|selected)$/i,rc=l.getSetAttribute,sc=l.input;n.fn.extend({attr:function(a,b){return W(this,n.attr,a,b,arguments.length>1)},removeAttr:function(a){return this.each(function(){n.removeAttr(this,a)})}}),n.extend({attr:function(a,b,c){var d,e,f=a.nodeType;if(a&&3!==f&&8!==f&&2!==f)return typeof a.getAttribute===L?n.prop(a,b,c):(1===f&&n.isXMLDoc(a)||(b=b.toLowerCase(),d=n.attrHooks[b]||(n.expr.match.bool.test(b)?oc:nc)),void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?void 0:e):null!==c?d&&"set"in d&&void 0!==(e=d.set(a,c,b))?e:(a.setAttribute(b,c+""),c):void n.removeAttr(a,b))},removeAttr:function(a,b){var c,d,e=0,f=b&&b.match(F);if(f&&1===a.nodeType)while(c=f[e++])d=n.propFix[c]||c,n.expr.match.bool.test(c)?sc&&rc||!qc.test(c)?a[d]=!1:a[n.camelCase("default-"+c)]=a[d]=!1:n.attr(a,c,""),a.removeAttribute(rc?c:d)},attrHooks:{type:{set:function(a,b){if(!l.radioValue&&"radio"===b&&n.nodeName(a,"input")){var c=a.value;return a.setAttribute("type",b),c&&(a.value=c),b}}}}}),oc={set:function(a,b,c){return b===!1?n.removeAttr(a,c):sc&&rc||!qc.test(c)?a.setAttribute(!rc&&n.propFix[c]||c,c):a[n.camelCase("default-"+c)]=a[c]=!0,c}},n.each(n.expr.match.bool.source.match(/\w+/g),function(a,b){var c=pc[b]||n.find.attr;pc[b]=sc&&rc||!qc.test(b)?function(a,b,d){var e,f;return d||(f=pc[b],pc[b]=e,e=null!=c(a,b,d)?b.toLowerCase():null,pc[b]=f),e}:function(a,b,c){return c?void 0:a[n.camelCase("default-"+b)]?b.toLowerCase():null}}),sc&&rc||(n.attrHooks.value={set:function(a,b,c){return n.nodeName(a,"input")?void(a.defaultValue=b):nc&&nc.set(a,b,c)}}),rc||(nc={set:function(a,b,c){var d=a.getAttributeNode(c);return d||a.setAttributeNode(d=a.ownerDocument.createAttribute(c)),d.value=b+="","value"===c||b===a.getAttribute(c)?b:void 0}},pc.id=pc.name=pc.coords=function(a,b,c){var d;return c?void 0:(d=a.getAttributeNode(b))&&""!==d.value?d.value:null},n.valHooks.button={get:function(a,b){var c=a.getAttributeNode(b);return c&&c.specified?c.value:void 0},set:nc.set},n.attrHooks.contenteditable={set:function(a,b,c){nc.set(a,""===b?!1:b,c)}},n.each(["width","height"],function(a,b){n.attrHooks[b]={set:function(a,c){return""===c?(a.setAttribute(b,"auto"),c):void 0}}})),l.style||(n.attrHooks.style={get:function(a){return a.style.cssText||void 0},set:function(a,b){return a.style.cssText=b+""}});var tc=/^(?:input|select|textarea|button|object)$/i,uc=/^(?:a|area)$/i;n.fn.extend({prop:function(a,b){return W(this,n.prop,a,b,arguments.length>1)},removeProp:function(a){return a=n.propFix[a]||a,this.each(function(){try{this[a]=void 0,delete this[a]}catch(b){}})}}),n.extend({propFix:{"for":"htmlFor","class":"className"},prop:function(a,b,c){var d,e,f,g=a.nodeType;if(a&&3!==g&&8!==g&&2!==g)return f=1!==g||!n.isXMLDoc(a),f&&(b=n.propFix[b]||b,e=n.propHooks[b]),void 0!==c?e&&"set"in e&&void 0!==(d=e.set(a,c,b))?d:a[b]=c:e&&"get"in e&&null!==(d=e.get(a,b))?d:a[b]},propHooks:{tabIndex:{get:function(a){var b=n.find.attr(a,"tabindex");return b?parseInt(b,10):tc.test(a.nodeName)||uc.test(a.nodeName)&&a.href?0:-1}}}}),l.hrefNormalized||n.each(["href","src"],function(a,b){n.propHooks[b]={get:function(a){return a.getAttribute(b,4)}}}),l.optSelected||(n.propHooks.selected={get:function(a){var b=a.parentNode;return b&&(b.selectedIndex,b.parentNode&&b.parentNode.selectedIndex),null}}),n.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){n.propFix[this.toLowerCase()]=this}),l.enctype||(n.propFix.enctype="encoding");var vc=/[\t\r\n\f]/g;n.fn.extend({addClass:function(a){var b,c,d,e,f,g,h=0,i=this.length,j="string"==typeof a&&a;if(n.isFunction(a))return this.each(function(b){n(this).addClass(a.call(this,b,this.className))});if(j)for(b=(a||"").match(F)||[];i>h;h++)if(c=this[h],d=1===c.nodeType&&(c.className?(" "+c.className+" ").replace(vc," "):" ")){f=0;while(e=b[f++])d.indexOf(" "+e+" ")<0&&(d+=e+" ");g=n.trim(d),c.className!==g&&(c.className=g)}return this},removeClass:function(a){var b,c,d,e,f,g,h=0,i=this.length,j=0===arguments.length||"string"==typeof a&&a;if(n.isFunction(a))return this.each(function(b){n(this).removeClass(a.call(this,b,this.className))});if(j)for(b=(a||"").match(F)||[];i>h;h++)if(c=this[h],d=1===c.nodeType&&(c.className?(" "+c.className+" ").replace(vc," "):"")){f=0;while(e=b[f++])while(d.indexOf(" "+e+" ")>=0)d=d.replace(" "+e+" "," ");g=a?n.trim(d):"",c.className!==g&&(c.className=g)}return this},toggleClass:function(a,b){var c=typeof a;return"boolean"==typeof b&&"string"===c?b?this.addClass(a):this.removeClass(a):this.each(n.isFunction(a)?function(c){n(this).toggleClass(a.call(this,c,this.className,b),b)}:function(){if("string"===c){var b,d=0,e=n(this),f=a.match(F)||[];while(b=f[d++])e.hasClass(b)?e.removeClass(b):e.addClass(b)}else(c===L||"boolean"===c)&&(this.className&&n._data(this,"__className__",this.className),this.className=this.className||a===!1?"":n._data(this,"__className__")||"")})},hasClass:function(a){for(var b=" "+a+" ",c=0,d=this.length;d>c;c++)if(1===this[c].nodeType&&(" "+this[c].className+" ").replace(vc," ").indexOf(b)>=0)return!0;return!1}}),n.each("blur focus focusin focusout load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup error contextmenu".split(" "),function(a,b){n.fn[b]=function(a,c){return arguments.length>0?this.on(b,null,a,c):this.trigger(b)}}),n.fn.extend({hover:function(a,b){return this.mouseenter(a).mouseleave(b||a)},bind:function(a,b,c){return this.on(a,null,b,c)},unbind:function(a,b){return this.off(a,null,b)},delegate:function(a,b,c,d){return this.on(b,a,c,d)},undelegate:function(a,b,c){return 1===arguments.length?this.off(a,"**"):this.off(b,a||"**",c)}});var wc=n.now(),xc=/\?/,yc=/(,)|(\[|{)|(}|])|"(?:[^"\\\r\n]|\\["\\\/bfnrt]|\\u[\da-fA-F]{4})*"\s*:?|true|false|null|-?(?!0\d)\d+(?:\.\d+|)(?:[eE][+-]?\d+|)/g;n.parseJSON=function(b){if(a.JSON&&a.JSON.parse)return a.JSON.parse(b+"");var c,d=null,e=n.trim(b+"");return e&&!n.trim(e.replace(yc,function(a,b,e,f){return c&&b&&(d=0),0===d?a:(c=e||b,d+=!f-!e,"")}))?Function("return "+e)():n.error("Invalid JSON: "+b)},n.parseXML=function(b){var c,d;if(!b||"string"!=typeof b)return null;try{a.DOMParser?(d=new DOMParser,c=d.parseFromString(b,"text/xml")):(c=new ActiveXObject("Microsoft.XMLDOM"),c.async="false",c.loadXML(b))}catch(e){c=void 0}return c&&c.documentElement&&!c.getElementsByTagName("parsererror").length||n.error("Invalid XML: "+b),c};var zc,Ac,Bc=/#.*$/,Cc=/([?&])_=[^&]*/,Dc=/^(.*?):[ \t]*([^\r\n]*)\r?$/gm,Ec=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,Fc=/^(?:GET|HEAD)$/,Gc=/^\/\//,Hc=/^([\w.+-]+:)(?:\/\/(?:[^\/?#]*@|)([^\/?#:]*)(?::(\d+)|)|)/,Ic={},Jc={},Kc="*/".concat("*");try{Ac=location.href}catch(Lc){Ac=z.createElement("a"),Ac.href="",Ac=Ac.href}zc=Hc.exec(Ac.toLowerCase())||[];function Mc(a){return function(b,c){"string"!=typeof b&&(c=b,b="*");var d,e=0,f=b.toLowerCase().match(F)||[];if(n.isFunction(c))while(d=f[e++])"+"===d.charAt(0)?(d=d.slice(1)||"*",(a[d]=a[d]||[]).unshift(c)):(a[d]=a[d]||[]).push(c)}}function Nc(a,b,c,d){var e={},f=a===Jc;function g(h){var i;return e[h]=!0,n.each(a[h]||[],function(a,h){var j=h(b,c,d);return"string"!=typeof j||f||e[j]?f?!(i=j):void 0:(b.dataTypes.unshift(j),g(j),!1)}),i}return g(b.dataTypes[0])||!e["*"]&&g("*")}function Oc(a,b){var c,d,e=n.ajaxSettings.flatOptions||{};for(d in b)void 0!==b[d]&&((e[d]?a:c||(c={}))[d]=b[d]);return c&&n.extend(!0,a,c),a}function Pc(a,b,c){var d,e,f,g,h=a.contents,i=a.dataTypes;while("*"===i[0])i.shift(),void 0===e&&(e=a.mimeType||b.getResponseHeader("Content-Type"));if(e)for(g in h)if(h[g]&&h[g].test(e)){i.unshift(g);break}if(i[0]in c)f=i[0];else{for(g in c){if(!i[0]||a.converters[g+" "+i[0]]){f=g;break}d||(d=g)}f=f||d}return f?(f!==i[0]&&i.unshift(f),c[f]):void 0}function Qc(a,b,c,d){var e,f,g,h,i,j={},k=a.dataTypes.slice();if(k[1])for(g in a.converters)j[g.toLowerCase()]=a.converters[g];f=k.shift();while(f)if(a.responseFields[f]&&(c[a.responseFields[f]]=b),!i&&d&&a.dataFilter&&(b=a.dataFilter(b,a.dataType)),i=f,f=k.shift())if("*"===f)f=i;else if("*"!==i&&i!==f){if(g=j[i+" "+f]||j["* "+f],!g)for(e in j)if(h=e.split(" "),h[1]===f&&(g=j[i+" "+h[0]]||j["* "+h[0]])){g===!0?g=j[e]:j[e]!==!0&&(f=h[0],k.unshift(h[1]));break}if(g!==!0)if(g&&a["throws"])b=g(b);else try{b=g(b)}catch(l){return{state:"parsererror",error:g?l:"No conversion from "+i+" to "+f}}}return{state:"success",data:b}}n.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:Ac,type:"GET",isLocal:Ec.test(zc[1]),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Kc,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":n.parseJSON,"text xml":n.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(a,b){return b?Oc(Oc(a,n.ajaxSettings),b):Oc(n.ajaxSettings,a)},ajaxPrefilter:Mc(Ic),ajaxTransport:Mc(Jc),ajax:function(a,b){"object"==typeof a&&(b=a,a=void 0),b=b||{};var c,d,e,f,g,h,i,j,k=n.ajaxSetup({},b),l=k.context||k,m=k.context&&(l.nodeType||l.jquery)?n(l):n.event,o=n.Deferred(),p=n.Callbacks("once memory"),q=k.statusCode||{},r={},s={},t=0,u="canceled",v={readyState:0,getResponseHeader:function(a){var b;if(2===t){if(!j){j={};while(b=Dc.exec(f))j[b[1].toLowerCase()]=b[2]}b=j[a.toLowerCase()]}return null==b?null:b},getAllResponseHeaders:function(){return 2===t?f:null},setRequestHeader:function(a,b){var c=a.toLowerCase();return t||(a=s[c]=s[c]||a,r[a]=b),this},overrideMimeType:function(a){return t||(k.mimeType=a),this},statusCode:function(a){var b;if(a)if(2>t)for(b in a)q[b]=[q[b],a[b]];else v.always(a[v.status]);return this},abort:function(a){var b=a||u;return i&&i.abort(b),x(0,b),this}};if(o.promise(v).complete=p.add,v.success=v.done,v.error=v.fail,k.url=((a||k.url||Ac)+"").replace(Bc,"").replace(Gc,zc[1]+"//"),k.type=b.method||b.type||k.method||k.type,k.dataTypes=n.trim(k.dataType||"*").toLowerCase().match(F)||[""],null==k.crossDomain&&(c=Hc.exec(k.url.toLowerCase()),k.crossDomain=!(!c||c[1]===zc[1]&&c[2]===zc[2]&&(c[3]||("http:"===c[1]?"80":"443"))===(zc[3]||("http:"===zc[1]?"80":"443")))),k.data&&k.processData&&"string"!=typeof k.data&&(k.data=n.param(k.data,k.traditional)),Nc(Ic,k,b,v),2===t)return v;h=k.global,h&&0===n.active++&&n.event.trigger("ajaxStart"),k.type=k.type.toUpperCase(),k.hasContent=!Fc.test(k.type),e=k.url,k.hasContent||(k.data&&(e=k.url+=(xc.test(e)?"&":"?")+k.data,delete k.data),k.cache===!1&&(k.url=Cc.test(e)?e.replace(Cc,"$1_="+wc++):e+(xc.test(e)?"&":"?")+"_="+wc++)),k.ifModified&&(n.lastModified[e]&&v.setRequestHeader("If-Modified-Since",n.lastModified[e]),n.etag[e]&&v.setRequestHeader("If-None-Match",n.etag[e])),(k.data&&k.hasContent&&k.contentType!==!1||b.contentType)&&v.setRequestHeader("Content-Type",k.contentType),v.setRequestHeader("Accept",k.dataTypes[0]&&k.accepts[k.dataTypes[0]]?k.accepts[k.dataTypes[0]]+("*"!==k.dataTypes[0]?", "+Kc+"; q=0.01":""):k.accepts["*"]);for(d in k.headers)v.setRequestHeader(d,k.headers[d]);if(k.beforeSend&&(k.beforeSend.call(l,v,k)===!1||2===t))return v.abort();u="abort";for(d in{success:1,error:1,complete:1})v[d](k[d]);if(i=Nc(Jc,k,b,v)){v.readyState=1,h&&m.trigger("ajaxSend",[v,k]),k.async&&k.timeout>0&&(g=setTimeout(function(){v.abort("timeout")},k.timeout));try{t=1,i.send(r,x)}catch(w){if(!(2>t))throw w;x(-1,w)}}else x(-1,"No Transport");function x(a,b,c,d){var j,r,s,u,w,x=b;2!==t&&(t=2,g&&clearTimeout(g),i=void 0,f=d||"",v.readyState=a>0?4:0,j=a>=200&&300>a||304===a,c&&(u=Pc(k,v,c)),u=Qc(k,u,v,j),j?(k.ifModified&&(w=v.getResponseHeader("Last-Modified"),w&&(n.lastModified[e]=w),w=v.getResponseHeader("etag"),w&&(n.etag[e]=w)),204===a||"HEAD"===k.type?x="nocontent":304===a?x="notmodified":(x=u.state,r=u.data,s=u.error,j=!s)):(s=x,(a||!x)&&(x="error",0>a&&(a=0))),v.status=a,v.statusText=(b||x)+"",j?o.resolveWith(l,[r,x,v]):o.rejectWith(l,[v,x,s]),v.statusCode(q),q=void 0,h&&m.trigger(j?"ajaxSuccess":"ajaxError",[v,k,j?r:s]),p.fireWith(l,[v,x]),h&&(m.trigger("ajaxComplete",[v,k]),--n.active||n.event.trigger("ajaxStop")))}return v},getJSON:function(a,b,c){return n.get(a,b,c,"json")},getScript:function(a,b){return n.get(a,void 0,b,"script")}}),n.each(["get","post"],function(a,b){n[b]=function(a,c,d,e){return n.isFunction(c)&&(e=e||d,d=c,c=void 0),n.ajax({url:a,type:b,dataType:e,data:c,success:d})}}),n.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(a,b){n.fn[b]=function(a){return this.on(b,a)}}),n._evalUrl=function(a){return n.ajax({url:a,type:"GET",dataType:"script",async:!1,global:!1,"throws":!0})},n.fn.extend({wrapAll:function(a){if(n.isFunction(a))return this.each(function(b){n(this).wrapAll(a.call(this,b))});if(this[0]){var b=n(a,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstChild&&1===a.firstChild.nodeType)a=a.firstChild;return a}).append(this)}return this},wrapInner:function(a){return this.each(n.isFunction(a)?function(b){n(this).wrapInner(a.call(this,b))}:function(){var b=n(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var b=n.isFunction(a);return this.each(function(c){n(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(){return this.parent().each(function(){n.nodeName(this,"body")||n(this).replaceWith(this.childNodes)}).end()}}),n.expr.filters.hidden=function(a){return a.offsetWidth<=0&&a.offsetHeight<=0||!l.reliableHiddenOffsets()&&"none"===(a.style&&a.style.display||n.css(a,"display"))},n.expr.filters.visible=function(a){return!n.expr.filters.hidden(a)};var Rc=/%20/g,Sc=/\[\]$/,Tc=/\r?\n/g,Uc=/^(?:submit|button|image|reset|file)$/i,Vc=/^(?:input|select|textarea|keygen)/i;function Wc(a,b,c,d){var e;if(n.isArray(b))n.each(b,function(b,e){c||Sc.test(a)?d(a,e):Wc(a+"["+("object"==typeof e?b:"")+"]",e,c,d)});else if(c||"object"!==n.type(b))d(a,b);else for(e in b)Wc(a+"["+e+"]",b[e],c,d)}n.param=function(a,b){var c,d=[],e=function(a,b){b=n.isFunction(b)?b():null==b?"":b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};if(void 0===b&&(b=n.ajaxSettings&&n.ajaxSettings.traditional),n.isArray(a)||a.jquery&&!n.isPlainObject(a))n.each(a,function(){e(this.name,this.value)});else for(c in a)Wc(c,a[c],b,e);return d.join("&").replace(Rc,"+")},n.fn.extend({serialize:function(){return n.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var a=n.prop(this,"elements");return a?n.makeArray(a):this}).filter(function(){var a=this.type;return this.name&&!n(this).is(":disabled")&&Vc.test(this.nodeName)&&!Uc.test(a)&&(this.checked||!X.test(a))}).map(function(a,b){var c=n(this).val();return null==c?null:n.isArray(c)?n.map(c,function(a){return{name:b.name,value:a.replace(Tc,"\r\n")}}):{name:b.name,value:c.replace(Tc,"\r\n")}}).get()}}),n.ajaxSettings.xhr=void 0!==a.ActiveXObject?function(){return!this.isLocal&&/^(get|post|head|put|delete|options)$/i.test(this.type)&&$c()||_c()}:$c;var Xc=0,Yc={},Zc=n.ajaxSettings.xhr();a.ActiveXObject&&n(a).on("unload",function(){for(var a in Yc)Yc[a](void 0,!0)}),l.cors=!!Zc&&"withCredentials"in Zc,Zc=l.ajax=!!Zc,Zc&&n.ajaxTransport(function(a){if(!a.crossDomain||l.cors){var b;return{send:function(c,d){var e,f=a.xhr(),g=++Xc;if(f.open(a.type,a.url,a.async,a.username,a.password),a.xhrFields)for(e in a.xhrFields)f[e]=a.xhrFields[e];a.mimeType&&f.overrideMimeType&&f.overrideMimeType(a.mimeType),a.crossDomain||c["X-Requested-With"]||(c["X-Requested-With"]="XMLHttpRequest");for(e in c)void 0!==c[e]&&f.setRequestHeader(e,c[e]+"");f.send(a.hasContent&&a.data||null),b=function(c,e){var h,i,j;if(b&&(e||4===f.readyState))if(delete Yc[g],b=void 0,f.onreadystatechange=n.noop,e)4!==f.readyState&&f.abort();else{j={},h=f.status,"string"==typeof f.responseText&&(j.text=f.responseText);try{i=f.statusText}catch(k){i=""}h||!a.isLocal||a.crossDomain?1223===h&&(h=204):h=j.text?200:404}j&&d(h,i,j,f.getAllResponseHeaders())},a.async?4===f.readyState?setTimeout(b):f.onreadystatechange=Yc[g]=b:b()},abort:function(){b&&b(void 0,!0)}}}});function $c(){try{return new a.XMLHttpRequest}catch(b){}}function _c(){try{return new a.ActiveXObject("Microsoft.XMLHTTP")}catch(b){}}n.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/(?:java|ecma)script/},converters:{"text script":function(a){return n.globalEval(a),a}}}),n.ajaxPrefilter("script",function(a){void 0===a.cache&&(a.cache=!1),a.crossDomain&&(a.type="GET",a.global=!1)}),n.ajaxTransport("script",function(a){if(a.crossDomain){var b,c=z.head||n("head")[0]||z.documentElement;return{send:function(d,e){b=z.createElement("script"),b.async=!0,a.scriptCharset&&(b.charset=a.scriptCharset),b.src=a.url,b.onload=b.onreadystatechange=function(a,c){(c||!b.readyState||/loaded|complete/.test(b.readyState))&&(b.onload=b.onreadystatechange=null,b.parentNode&&b.parentNode.removeChild(b),b=null,c||e(200,"success"))},c.insertBefore(b,c.firstChild)},abort:function(){b&&b.onload(void 0,!0)}}}});var ad=[],bd=/(=)\?(?=&|$)|\?\?/;n.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var a=ad.pop()||n.expando+"_"+wc++;return this[a]=!0,a}}),n.ajaxPrefilter("json jsonp",function(b,c,d){var e,f,g,h=b.jsonp!==!1&&(bd.test(b.url)?"url":"string"==typeof b.data&&!(b.contentType||"").indexOf("application/x-www-form-urlencoded")&&bd.test(b.data)&&"data");return h||"jsonp"===b.dataTypes[0]?(e=b.jsonpCallback=n.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,h?b[h]=b[h].replace(bd,"$1"+e):b.jsonp!==!1&&(b.url+=(xc.test(b.url)?"&":"?")+b.jsonp+"="+e),b.converters["script json"]=function(){return g||n.error(e+" was not called"),g[0]},b.dataTypes[0]="json",f=a[e],a[e]=function(){g=arguments},d.always(function(){a[e]=f,b[e]&&(b.jsonpCallback=c.jsonpCallback,ad.push(e)),g&&n.isFunction(f)&&f(g[0]),g=f=void 0}),"script"):void 0}),n.parseHTML=function(a,b,c){if(!a||"string"!=typeof a)return null;"boolean"==typeof b&&(c=b,b=!1),b=b||z;var d=v.exec(a),e=!c&&[];return d?[b.createElement(d[1])]:(d=n.buildFragment([a],b,e),e&&e.length&&n(e).remove(),n.merge([],d.childNodes))};var cd=n.fn.load;n.fn.load=function(a,b,c){if("string"!=typeof a&&cd)return cd.apply(this,arguments);var d,e,f,g=this,h=a.indexOf(" ");return h>=0&&(d=a.slice(h,a.length),a=a.slice(0,h)),n.isFunction(b)?(c=b,b=void 0):b&&"object"==typeof b&&(f="POST"),g.length>0&&n.ajax({url:a,type:f,dataType:"html",data:b}).done(function(a){e=arguments,g.html(d?n("<div>").append(n.parseHTML(a)).find(d):a)}).complete(c&&function(a,b){g.each(c,e||[a.responseText,b,a])}),this},n.expr.filters.animated=function(a){return n.grep(n.timers,function(b){return a===b.elem}).length};var dd=a.document.documentElement;function ed(a){return n.isWindow(a)?a:9===a.nodeType?a.defaultView||a.parentWindow:!1}n.offset={setOffset:function(a,b,c){var d,e,f,g,h,i,j,k=n.css(a,"position"),l=n(a),m={};"static"===k&&(a.style.position="relative"),h=l.offset(),f=n.css(a,"top"),i=n.css(a,"left"),j=("absolute"===k||"fixed"===k)&&n.inArray("auto",[f,i])>-1,j?(d=l.position(),g=d.top,e=d.left):(g=parseFloat(f)||0,e=parseFloat(i)||0),n.isFunction(b)&&(b=b.call(a,c,h)),null!=b.top&&(m.top=b.top-h.top+g),null!=b.left&&(m.left=b.left-h.left+e),"using"in b?b.using.call(a,m):l.css(m)}},n.fn.extend({offset:function(a){if(arguments.length)return void 0===a?this:this.each(function(b){n.offset.setOffset(this,a,b)});var b,c,d={top:0,left:0},e=this[0],f=e&&e.ownerDocument;if(f)return b=f.documentElement,n.contains(b,e)?(typeof e.getBoundingClientRect!==L&&(d=e.getBoundingClientRect()),c=ed(f),{top:d.top+(c.pageYOffset||b.scrollTop)-(b.clientTop||0),left:d.left+(c.pageXOffset||b.scrollLeft)-(b.clientLeft||0)}):d},position:function(){if(this[0]){var a,b,c={top:0,left:0},d=this[0];return"fixed"===n.css(d,"position")?b=d.getBoundingClientRect():(a=this.offsetParent(),b=this.offset(),n.nodeName(a[0],"html")||(c=a.offset()),c.top+=n.css(a[0],"borderTopWidth",!0),c.left+=n.css(a[0],"borderLeftWidth",!0)),{top:b.top-c.top-n.css(d,"marginTop",!0),left:b.left-c.left-n.css(d,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var a=this.offsetParent||dd;while(a&&!n.nodeName(a,"html")&&"static"===n.css(a,"position"))a=a.offsetParent;return a||dd})}}),n.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(a,b){var c=/Y/.test(b);n.fn[a]=function(d){return W(this,function(a,d,e){var f=ed(a);return void 0===e?f?b in f?f[b]:f.document.documentElement[d]:a[d]:void(f?f.scrollTo(c?n(f).scrollLeft():e,c?e:n(f).scrollTop()):a[d]=e)},a,d,arguments.length,null)}}),n.each(["top","left"],function(a,b){n.cssHooks[b]=Mb(l.pixelPosition,function(a,c){return c?(c=Kb(a,b),Ib.test(c)?n(a).position()[b]+"px":c):void 0})}),n.each({Height:"height",Width:"width"},function(a,b){n.each({padding:"inner"+a,content:b,"":"outer"+a},function(c,d){n.fn[d]=function(d,e){var f=arguments.length&&(c||"boolean"!=typeof d),g=c||(d===!0||e===!0?"margin":"border");return W(this,function(b,c,d){var e;return n.isWindow(b)?b.document.documentElement["client"+a]:9===b.nodeType?(e=b.documentElement,Math.max(b.body["scroll"+a],e["scroll"+a],b.body["offset"+a],e["offset"+a],e["client"+a])):void 0===d?n.css(b,c,g):n.style(b,c,d,g)},b,f?d:void 0,f,null)}})}),n.fn.size=function(){return this.length},n.fn.andSelf=n.fn.addBack,"function"==typeof define&&define.amd&&define("jquery",[],function(){return n});var fd=a.jQuery,gd=a.$;return n.noConflict=function(b){return a.$===n&&(a.$=gd),b&&a.jQuery===n&&(a.jQuery=fd),n},typeof b===L&&(a.jQuery=a.$=n),n});
diff --git a/apidocs/js/page_effects.js b/apidocs/js/page_effects.js
new file mode 100644
index 0000000..fdacbf8
--- /dev/null
+++ b/apidocs/js/page_effects.js
@@ -0,0 +1,112 @@
+function visibleInParent(element) {
+    var position = $(element).position().top
+    return position > -50 && position < ($(element).offsetParent().height() - 50)
+}
+
+function hasFragment(link, fragment) {
+    return $(link).attr("href").indexOf("#" + fragment) != -1
+}
+
+function findLinkByFragment(elements, fragment) {
+    return $(elements).filter(function(i, e) { return hasFragment(e, fragment)}).first()
+}
+
+function scrollToCurrentVarLink(elements) {
+    var elements = $(elements);
+    var parent   = elements.offsetParent();
+
+    if (elements.length == 0) return;
+
+    var top    = elements.first().position().top;
+    var bottom = elements.last().position().top + elements.last().height();
+
+    if (top >= 0 && bottom <= parent.height()) return;
+
+    if (top < 0) {
+        parent.scrollTop(parent.scrollTop() + top);
+    }
+    else if (bottom > parent.height()) {
+        parent.scrollTop(parent.scrollTop() + bottom - parent.height());
+    }
+}
+
+function setCurrentVarLink() {
+    $('.secondary a').parent().removeClass('current')
+    $('.anchor').
+        filter(function(index) { return visibleInParent(this) }).
+        each(function(index, element) {
+            findLinkByFragment(".secondary a", element.id).
+                parent().
+                addClass('current')
+        });
+    scrollToCurrentVarLink('.secondary .current');
+}
+
+var hasStorage = (function() { try { return localStorage.getItem } catch(e) {} }())
+
+function scrollPositionId(element) {
+    var directory = window.location.href.replace(/[^\/]+\.html$/, '')
+    return 'scroll::' + $(element).attr('id') + '::' + directory
+}
+
+function storeScrollPosition(element) {
+    if (!hasStorage) return;
+    localStorage.setItem(scrollPositionId(element) + "::x", $(element).scrollLeft())
+    localStorage.setItem(scrollPositionId(element) + "::y", $(element).scrollTop())
+}
+
+function recallScrollPosition(element) {
+    if (!hasStorage) return;
+    $(element).scrollLeft(localStorage.getItem(scrollPositionId(element) + "::x"))
+    $(element).scrollTop(localStorage.getItem(scrollPositionId(element) + "::y"))
+}
+
+function persistScrollPosition(element) {
+    recallScrollPosition(element)
+    $(element).scroll(function() { storeScrollPosition(element) })
+}
+
+function sidebarContentWidth(element) {
+    var widths = $(element).find('.inner').map(function() { return $(this).innerWidth() })
+    return Math.max.apply(Math, widths)
+}
+
+function calculateSize(width, snap, margin, minimum) {
+    if (width == 0) {
+        return 0
+    }
+    else {
+        return Math.max(minimum, (Math.ceil(width / snap) * snap) + (margin * 2))
+    }
+}
+
+function resizeSidebars() {
+    var primaryWidth   = sidebarContentWidth('.primary')
+    var secondaryWidth = 0
+
+    if ($('.secondary').length != 0) {
+        secondaryWidth = sidebarContentWidth('.secondary')
+    }
+
+    // snap to grid
+    primaryWidth   = calculateSize(primaryWidth, 32, 13, 160)
+    secondaryWidth = calculateSize(secondaryWidth, 32, 13, 160)
+
+    $('.primary').css('width', primaryWidth)
+    $('.secondary').css('width', secondaryWidth).css('left', primaryWidth + 1)
+
+    if (secondaryWidth > 0) {
+        $('#content').css('left', primaryWidth + secondaryWidth + 2)
+    }
+    else {
+        $('#content').css('left', primaryWidth + 1)
+    }
+}
+
+$(window).ready(resizeSidebars)
+$(window).ready(setCurrentVarLink)
+$(window).ready(function() { persistScrollPosition('.primary')})
+$(window).ready(function() {
+    $('#content').scroll(setCurrentVarLink)
+    $(window).resize(setCurrentVarLink)
+})

From c0cc70c5d5125f24a57ed5bee5e774dad26a3bf9 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Tue, 21 Jan 2025 12:32:36 -0600
Subject: [PATCH 14/73] move api docs to docs/

---
 deps.edn                                           | 2 +-
 {apidocs => docs}/clojure.core.async.flow.html     | 0
 {apidocs => docs}/clojure.core.async.flow.spi.html | 0
 {apidocs => docs}/clojure.core.async.html          | 0
 {apidocs => docs}/css/default.css                  | 0
 {apidocs => docs}/css/highlight.css                | 0
 {apidocs => docs}/flow.html                        | 0
 {apidocs => docs}/index.html                       | 0
 {apidocs => docs}/intro.html                       | 0
 {apidocs => docs}/js/highlight.min.js              | 0
 {apidocs => docs}/js/jquery.min.js                 | 0
 {apidocs => docs}/js/page_effects.js               | 0
 12 files changed, 1 insertion(+), 1 deletion(-)
 rename {apidocs => docs}/clojure.core.async.flow.html (100%)
 rename {apidocs => docs}/clojure.core.async.flow.spi.html (100%)
 rename {apidocs => docs}/clojure.core.async.html (100%)
 rename {apidocs => docs}/css/default.css (100%)
 rename {apidocs => docs}/css/highlight.css (100%)
 rename {apidocs => docs}/flow.html (100%)
 rename {apidocs => docs}/index.html (100%)
 rename {apidocs => docs}/intro.html (100%)
 rename {apidocs => docs}/js/highlight.min.js (100%)
 rename {apidocs => docs}/js/jquery.min.js (100%)
 rename {apidocs => docs}/js/page_effects.js (100%)

diff --git a/deps.edn b/deps.edn
index ad96f46..5f6ef2a 100644
--- a/deps.edn
+++ b/deps.edn
@@ -29,5 +29,5 @@
          :exec-fn codox.main/generate-docs
          :exec-args {:source-paths ["src/main/clojure"]
                      :namespaces [clojure.core.async clojure.core.async.flow clojure.core.async.flow.spi]
-                     :output-path "apidocs"}}
+                     :output-path "docs"}}
   }}
diff --git a/apidocs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
similarity index 100%
rename from apidocs/clojure.core.async.flow.html
rename to docs/clojure.core.async.flow.html
diff --git a/apidocs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
similarity index 100%
rename from apidocs/clojure.core.async.flow.spi.html
rename to docs/clojure.core.async.flow.spi.html
diff --git a/apidocs/clojure.core.async.html b/docs/clojure.core.async.html
similarity index 100%
rename from apidocs/clojure.core.async.html
rename to docs/clojure.core.async.html
diff --git a/apidocs/css/default.css b/docs/css/default.css
similarity index 100%
rename from apidocs/css/default.css
rename to docs/css/default.css
diff --git a/apidocs/css/highlight.css b/docs/css/highlight.css
similarity index 100%
rename from apidocs/css/highlight.css
rename to docs/css/highlight.css
diff --git a/apidocs/flow.html b/docs/flow.html
similarity index 100%
rename from apidocs/flow.html
rename to docs/flow.html
diff --git a/apidocs/index.html b/docs/index.html
similarity index 100%
rename from apidocs/index.html
rename to docs/index.html
diff --git a/apidocs/intro.html b/docs/intro.html
similarity index 100%
rename from apidocs/intro.html
rename to docs/intro.html
diff --git a/apidocs/js/highlight.min.js b/docs/js/highlight.min.js
similarity index 100%
rename from apidocs/js/highlight.min.js
rename to docs/js/highlight.min.js
diff --git a/apidocs/js/jquery.min.js b/docs/js/jquery.min.js
similarity index 100%
rename from apidocs/js/jquery.min.js
rename to docs/js/jquery.min.js
diff --git a/apidocs/js/page_effects.js b/docs/js/page_effects.js
similarity index 100%
rename from apidocs/js/page_effects.js
rename to docs/js/page_effects.js

From 7552be7aee159b271508faa41a70d956e7633499 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Tue, 21 Jan 2025 12:39:15 -0600
Subject: [PATCH 15/73] revert accidental patch commit in doc changes

---
 src/main/clojure/clojure/core/async.clj      | 2 --
 src/test/clojure/clojure/core/async_test.clj | 7 -------
 2 files changed, 9 deletions(-)

diff --git a/src/main/clojure/clojure/core/async.clj b/src/main/clojure/clojure/core/async.clj
index de90e04..8b40571 100644
--- a/src/main/clojure/clojure/core/async.clj
+++ b/src/main/clojure/clojure/core/async.clj
@@ -277,8 +277,6 @@ to catch and handle."
   "returns derefable [val port] if immediate, nil if enqueued"
   [fret ports opts]
   (assert (pos? (count ports)) "alts must have at least one channel operation")
-  (doseq [port ports :when (vector? port)]
-    (assert (not (nil? (nth port 1))) "alts can't put nil on channel"))
   (let [flag (alt-flag)
         ports (vec ports) ;; ensure vector for indexed nth
         n (count ports)
diff --git a/src/test/clojure/clojure/core/async_test.clj b/src/test/clojure/clojure/core/async_test.clj
index 866808a..017ba7d 100644
--- a/src/test/clojure/clojure/core/async_test.clj
+++ b/src/test/clojure/clojure/core/async_test.clj
@@ -465,10 +465,3 @@
              :ok
              (catch AssertionError e
                :ko))))))
-
-(deftest test-alts-put-nil-invalid
-  (is
-    (thrown? AssertionError
-      (let [c1 (a/chan)
-            c2 (a/chan)]
-        (a/alts!! [c1 [c2 nil]])))))
\ No newline at end of file

From 99e2d44e791421fef7505e33bf925ad49b4651e2 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Tue, 21 Jan 2025 12:43:17 -0600
Subject: [PATCH 16/73] add static flow doc to docs

---
 deps.edn                              | 1 +
 docs/clojure.core.async.flow.html     | 2 +-
 docs/clojure.core.async.flow.spi.html | 2 +-
 docs/clojure.core.async.html          | 2 +-
 docs/flow.html                        | 2 +-
 docs/index.html                       | 2 +-
 6 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/deps.edn b/deps.edn
index 5f6ef2a..4b4c5eb 100644
--- a/deps.edn
+++ b/deps.edn
@@ -29,5 +29,6 @@
          :exec-fn codox.main/generate-docs
          :exec-args {:source-paths ["src/main/clojure"]
                      :namespaces [clojure.core.async clojure.core.async.flow clojure.core.async.flow.spi]
+                     :doc-files ["doc/flow.md"]
                      :output-path "docs"}}
   }}
diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index d7d4900..108872f 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4 current"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-step-process"><div class="inner"><span>step-process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4 current"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-step-process"><div class="inner"><span>step-process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
diff --git a/docs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
index e9048a6..93ff480 100644
--- a/docs/clojure.core.async.flow.spi.html
+++ b/docs/clojure.core.async.flow.spi.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
 be needed for ordinary use of the library. This protocol is for
 creating new types of Processes that are not possible to create
 with ::flow/process.
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index 64fc4ef..bfb521e 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3 current"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3 current"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 go blocks are dispatched over an internal thread pool, which
 defaults to 8 threads. The size of this pool can be modified using
diff --git a/docs/flow.html b/docs/flow.html
index 33a5136..60f5ee1 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>core.async.flow #</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
+<html><head><meta charset="UTF-8" /><title>core.async.flow #</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
 <p>The <a href="https://clojure.org/news/2013/06/28/clojure-clore-async-channels">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
diff --git a/docs/index.html b/docs/index.html
index b7367fc..57ae5ec 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to core.async</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow #</a></li><li><a href="intro.html">Introduction to core.async</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-step-process">step-process</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow #</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-step-process">step-process</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file

From f2f1a0bfe0ddc85608b3916b49e3c0d9d2d786c5 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Tue, 21 Jan 2025 15:44:41 -0600
Subject: [PATCH 17/73] docs - use flat list of namespaces

---
 deps.edn                              | 3 ++-
 docs/clojure.core.async.flow.html     | 2 +-
 docs/clojure.core.async.flow.spi.html | 2 +-
 docs/clojure.core.async.html          | 2 +-
 docs/flow.html                        | 2 +-
 docs/index.html                       | 2 +-
 6 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/deps.edn b/deps.edn
index 4b4c5eb..f538f1a 100644
--- a/deps.edn
+++ b/deps.edn
@@ -30,5 +30,6 @@
          :exec-args {:source-paths ["src/main/clojure"]
                      :namespaces [clojure.core.async clojure.core.async.flow clojure.core.async.flow.spi]
                      :doc-files ["doc/flow.md"]
-                     :output-path "docs"}}
+                     :output-path "docs"
+                     :html {:namespace-list :flat}}}
   }}
diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 108872f..b781e65 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4 current"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-step-process"><div class="inner"><span>step-process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-step-process"><div class="inner"><span>step-process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
diff --git a/docs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
index 93ff480..04fd20a 100644
--- a/docs/clojure.core.async.flow.spi.html
+++ b/docs/clojure.core.async.flow.spi.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
 be needed for ordinary use of the library. This protocol is for
 creating new types of Processes that are not possible to create
 with ::flow/process.
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index bfb521e..795b399 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3 current"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 go blocks are dispatched over an internal thread pool, which
 defaults to 8 threads. The size of this pool can be modified using
diff --git a/docs/flow.html b/docs/flow.html
index 60f5ee1..1d35bc0 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>core.async.flow #</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
+<html><head><meta charset="UTF-8" /><title>core.async.flow #</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
 <p>The <a href="https://clojure.org/news/2013/06/28/clojure-clore-async-channels">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
diff --git a/docs/index.html b/docs/index.html
index 57ae5ec..7e017b3 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>clojure</span></div></div></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>core</span></div></div></li><li class="depth-3"><a href="clojure.core.async.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>async</span></div></a></li><li class="depth-4"><a href="clojure.core.async.flow.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>flow</span></div></a></li><li class="depth-5"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow #</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-step-process">step-process</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow #</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-step-process">step-process</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file

From cfb95731ca27e7eb045f70bd8247e747241de436 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 22 Jan 2025 10:34:45 -0500
Subject: [PATCH 18/73] get rid of trailing '#' s in .md headers

---
 doc/flow.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/flow.md b/doc/flow.md
index c24c697..98942a3 100644
--- a/doc/flow.md
+++ b/doc/flow.md
@@ -1,5 +1,5 @@
-# core.async.flow #
-## Rationale ##
+# core.async.flow
+## Rationale
 
 The [rationale](https://clojure.org/news/2013/06/28/clojure-clore-async-channels) for **core.async** says "There comes a time in all good programs when components or subsystems must stop communicating directly with one another." And core.async provides fundamental tools (channels) for doing that. 
 
@@ -7,7 +7,7 @@ But using core.async well, e.g. keeping your I/O out of your computational logic
 
 The fundamental objective of __core.async.flow__ is to enable a strict separation of your application logic from its topology, execution, communication, lifecycle, monitoring and error handling, all of which are provided by and centralized in, c.a.flow, yielding more consistent, robust, testable, observable and operable systems.
 
-## Overview ##
+## Overview
 
 __core.async.flow__ provides *concrete* implementations of two more abstractions - the '__process__' - a thread of activity, and the '__flow__' - a directed graph of processes communicating via channels. A single data structure describes your flow topology, and has all of the settings for threads, channels etc. A process accepts data from and provides data to channels. The process implementation in c.a.flow handles all channel I/O, thread lifecycle and coordination with the flow graph.
 

From 330d0fa1e346ce78eaac40ca6a62ab80633cd73c Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Wed, 22 Jan 2025 11:18:33 -0600
Subject: [PATCH 19/73] update docs

---
 docs/clojure.core.async.flow.html     | 2 +-
 docs/clojure.core.async.flow.spi.html | 2 +-
 docs/clojure.core.async.html          | 2 +-
 docs/flow.html                        | 2 +-
 docs/index.html                       | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index b781e65..6c99386 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-step-process"><div class="inner"><span>step-process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-step-process"><div class="inner"><span>step-process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
diff --git a/docs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
index 04fd20a..d50b0d7 100644
--- a/docs/clojure.core.async.flow.spi.html
+++ b/docs/clojure.core.async.flow.spi.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
 be needed for ordinary use of the library. This protocol is for
 creating new types of Processes that are not possible to create
 with ::flow/process.
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index 795b399..eeb3221 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 go blocks are dispatched over an internal thread pool, which
 defaults to 8 threads. The size of this pool can be modified using
diff --git a/docs/flow.html b/docs/flow.html
index 1d35bc0..b0d4a29 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>core.async.flow #</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
+<html><head><meta charset="UTF-8" /><title>core.async.flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
 <p>The <a href="https://clojure.org/news/2013/06/28/clojure-clore-async-channels">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
diff --git a/docs/index.html b/docs/index.html
index 7e017b3..eec7c0c 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow #</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow #</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-step-process">step-process</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-step-process">step-process</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file

From 8c695ad57dbb87bffc7f86ee0965ca86d41a7c5a Mon Sep 17 00:00:00 2001
From: JarrodCTaylor <jarrod@fastmail.com>
Date: Wed, 22 Jan 2025 20:28:41 -0600
Subject: [PATCH 20/73] Add GitHub action to build codox docs

---
 .github/workflows/generate-codox-docs.yml | 48 +++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 .github/workflows/generate-codox-docs.yml

diff --git a/.github/workflows/generate-codox-docs.yml b/.github/workflows/generate-codox-docs.yml
new file mode 100644
index 0000000..77bcce0
--- /dev/null
+++ b/.github/workflows/generate-codox-docs.yml
@@ -0,0 +1,48 @@
+name: Build Codox Docs
+
+on:
+  workflow_dispatch:
+
+jobs:
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Set up Java
+        uses: actions/setup-java@v3
+        with:
+          java-version: 8
+          distribution: 'temurin'
+
+      - name: Set up Clojure
+        uses: DeLaGuardo/setup-clojure@11.0
+        with:
+          cli: 'latest'
+
+      - name: Cache clojure dependencies
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.m2/repository
+            ~/.gitlibs
+          key: cljdeps-${{ hashFiles('deps.edn') }}
+          restore-keys: cljdeps-
+
+      - name: Clone the repo
+        uses: actions/checkout@v4
+
+      - name: Install rlwrap
+        run: sudo apt-get install -y rlwrap
+
+      - name: Execute doc build
+        run:  |
+          clj -X:docs
+
+      - name: Commit and push
+        run: |
+          git config --global user.name clojure-build
+          git config --global user.email "clojure-build@users.noreply.github.com"
+          git add -u -v
+          git commit -m "Action doc commit"
+          git push origin master

From d5eba35826de4f0ca9f608495b518779982cd024 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Thu, 23 Jan 2025 12:57:54 -0500
Subject: [PATCH 21/73] removed :introduce, use ports instead for
 sources/sinks, added ::flow/[in-out-]ports support for external I/O, fix
 transitions

---
 src/main/clojure/clojure/core/async/flow.clj  | 48 +++++++------------
 .../clojure/clojure/core/async/flow/impl.clj  | 27 +++++------
 2 files changed, 31 insertions(+), 44 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 38d8943..6ed7f4a 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -86,7 +86,7 @@
   
   :report-chan - a core.async chan for reading.'ping' reponses
   will show up here, as will any explicit ::flow/report outputs
-  from :transform/:introduce
+  from :transform
   
   :error-chan - a core.async chan for reading. Any (and only)
   exceptions thrown anywhere on any thread inside a flow will appear
@@ -141,7 +141,7 @@
   "Given a map of functions (described below), returns a launcher that
   creates a process compliant with the process protocol (see the
   spi/ProcLauncher doc). The possible entries for process-impl-map
-  are :describe, :init, :transition, :transform and :introduce. This is
+  are :describe, :init, :transition and :transform. This is
   the core facility for defining the logic for processes via ordinary
   functions.
 
@@ -167,9 +167,18 @@
 
   :init - optional, (arg-map) -> initial-state
   
-  init will be called once by the process to establish any
-  initial state. The arg-map will be a map of param->val, as supplied
-  in the flow def. init must be provided if 'describe' returns :params.
+  init will be called once by the process to establish any initial
+  state. The arg-map will be a map of param->val, as supplied in the
+  flow def. init must be provided if 'describe' returns :params.
+
+  Optionally, a returned init state may contain the
+  keys ::flow/in-ports and/or ::flow/out-ports. These should be maps
+  of cid -> a core.async.channel. The cids must not conflict with the
+  in/out ids. These channels will become part of the read/write set of
+  the process, but are not otherwise visible/resolvable within the
+  flow. Ports are a way to have data enter or exit the flow from
+  outside. Use :transition to coordinate the lifecycle of these
+  external channels.
 
   :transition - optional, (state transition) -> state'
 
@@ -181,9 +190,7 @@
   process will no longer be used following that. See the SPI for
   details. state' will be the state supplied to subsequent calls.
 
-  Exactly one of either :transform or :introduce are required.
-
-  :transform - (state in-name msg) -> [state' output]
+  :transform - required, (state in-name msg) -> [state' output]
   where output is a map of outid->[msgs*]
 
   The transform fn will be called every time a message arrives at any
@@ -194,21 +201,6 @@
   may never be nil (per core.async channels). state' will be the state
   supplied to subsequent calls.
 
-  :introduce - (state) -> [state' output]
-  where output is a map of outid->[msgs*], per :transform
- 
-  The introduce fn is used for sources - proc-impls that introduce new data
-  into the flow by doing I/O with something external to the flow and
-  feeding that data to its outputs. A proc-impl specifying :introduce may not
-  specify any :ins in its descriptor, as none but the ::flow/control channel
-  will be read. Instead, introduce will be called every time through the
-  process loop, and will presumably do blocking or paced I/O to get
-  new data to return via its outputs. If it does blocking I/O it
-  should do so with a timeout so it can regularly return to the
-  process loop which can then look for control messages - it's fine
-  for introduce to return with no output. Do not spin poll in the introduce
-  fn.
-
   process accepts an option map with keys:
   :workload - one of :mixed, :io or :compute
   :compute-timeout-ms - if :workload is :compute, this timeout (default 5000 msec)
@@ -218,14 +210,11 @@
   any :workload returned by the :describe fn of the process. If neither
   are provded the default is :mixed.
 
-  The :compute workload is not allowed for proc impls that
-  provide :introduce (as I/O is presumed).
-
   In the :workload context of :mixed or :io, this dictates the type of
   thread in which the process loop will run, _including its calls to
-  transform/introduce_. 
+  transform_. 
 
-  When :io is specified transform/introduce should not do extensive computation.
+  When :io is specified, transform should not do extensive computation.
 
   When :compute is specified (only allowed for :transform), each call
   to transform will be run in a separate thread. The process loop will
@@ -281,8 +270,7 @@
   and one output (named :in and :out), and no state."
   [f]
   (fn
-    ([] {:params {}
-         :ins {:in (str "the argument to " f)}
+    ([] {:ins {:in (str "the argument to " f)}
          :outs {:out (str "the return of " f)}})
     ([_] nil)
     ([_ _ msg] [nil {:out (f msg)}])))
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index cc264d0..c1fb62b 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -187,7 +187,10 @@
   "when transition, returns maybe new state"
   [transition status nstatus state]
   (if (and transition (not= status nstatus))
-    (transition state nstatus)
+    (transition state (case nstatus
+                            :exit ::flow/stop
+                            :running ::flow/resume
+                            :paused ::flow/pause))
     state))
 
 (defn send-outputs [status state outputs outs resolver control handle-command transition]
@@ -214,13 +217,11 @@
 
 (defn proc
   "see lib ns for docs"
-  [{:keys [describe init transition transform introduce] :as impl} {:keys [workload compute-timeout-ms]}]
-  (assert (= 1 (count (keep identity [transform introduce]))) "must provide exactly one of :transform or :introduce") 
+  [{:keys [describe init transition transform] :as impl} {:keys [workload compute-timeout-ms]}]
+  (assert transform "must provide :transform") 
   (let [{:keys [params ins] :as desc} (describe)
         workload (or workload (:workload desc) :mixed)]
-    (assert (not (and ins introduce)) "can't specify :ins when :introduce")
     (assert (or (not params) init) "must have :init if :params")
-    (assert (not (and introduce (= workload :compute))) "can't specify :introduce and :compute")
     (reify
      clojure.core.protocols/Datafiable
      (datafy [_]
@@ -229,17 +230,21 @@
      spi/ProcLauncher
      (describe [_] desc)
      (start [_ {:keys [pid args ins outs resolver]}]
+            (assert (or (not params) args) "must provide :args if :params")
             (let [comp? (= workload :compute)
                   transform (cond-> transform (= workload :compute)
                                     #(.get (futurize transform {:exec (spi/get-exec resolver :compute)})
                                            compute-timeout-ms TimeUnit/MILLISECONDS))
                   exs (spi/get-exec resolver (if (= workload :mixed) :mixed :io))
+                  state (when init (init args))
+                  ins (into (or ins {}) (::flow/in-ports state))
+                  outs (into (or outs {}) (::flow/out-ports state))
                   io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
                   control (::flow/control ins)
                   ;;TODO rotate/randomize after control per normal alts?
                   read-chans (into [control] (-> ins (dissoc ::flow/control) vals))
                   run
-                  #(loop [status :paused, state (when init (init args)), count 0]
+                  #(loop [status :paused, state state, count 0]
                      (let [pong (fn []
                                   (let [pins (dissoc ins ::flow/control)
                                         pouts (dissoc outs ::flow/error ::flow/report)]
@@ -256,20 +261,14 @@
                                      nstate (handle-transition transition status nstatus state)]
                                  [nstatus nstate count])
                                ;;:running
-                               (let [[msg c] (if transform
-                                               (async/alts!! read-chans :priority true)
-                                               ;;introduce
-                                               (when-let [msg (async/poll! control)]
-                                                 [msg control]))
+                               (let [[msg c] (async/alts!! read-chans :priority true)
                                      cid (io-id c)]
                                  (if (= c control)
                                    (let [nstatus (handle-command status msg)
                                          nstate (handle-transition transition status nstatus state)]
                                      [nstatus nstate count])
                                    (try
-                                     (let [[nstate outputs] (if transform
-                                                              (transform state cid msg)
-                                                              (introduce state))
+                                     (let [[nstate outputs] (transform state cid msg)
                                            [nstatus nstate]
                                            (send-outputs status nstate outputs outs
                                                          resolver control handle-command transition)]

From 85001430f49854170b5f0af2915319f06d59d4a5 Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Thu, 23 Jan 2025 18:20:20 +0000
Subject: [PATCH 22/73] Action doc commit

---
 docs/clojure.core.async.flow.html | 45 ++++++++++++-------------------
 1 file changed, 17 insertions(+), 28 deletions(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 6c99386..e9d1050 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -81,7 +81,7 @@
 channel returned from start</pre></div></div><div class="public anchor" id="var-process"><h3>process</h3><div class="usage"><code>(process process-impl-map)</code><code>(process process-impl-map {:keys [workload timeout-ms], :or {timeout-ms 5000}, :as opts})</code></div><div class="doc"><pre class="plaintext">Given a map of functions (described below), returns a launcher that
 creates a process compliant with the process protocol (see the
 spi/ProcLauncher doc). The possible entries for process-impl-map
-are :describe, :init, :transition, :transform and :introduce. This is
+are :describe, :init, :transition and :transform. This is
 the core facility for defining the logic for processes via ordinary
 functions.
 
@@ -107,9 +107,18 @@
 
 :init - optional, (arg-map) -&gt; initial-state
 
-init will be called once by the process to establish any
-initial state. The arg-map will be a map of param-&gt;val, as supplied
-in the flow def. init must be provided if 'describe' returns :params.
+init will be called once by the process to establish any initial
+state. The arg-map will be a map of param-&gt;val, as supplied in the
+flow def. init must be provided if 'describe' returns :params.
+
+Optionally, a returned init state may contain the
+keys ::flow/in-ports and/or ::flow/out-ports. These should be maps
+of cid -&gt; a core.async.channel. The cids must not conflict with the
+in/out ids. These channels will become part of the read/write set of
+the process, but are not otherwise visible/resolvable within the
+flow. Ports are a way to have data enter or exit the flow from
+outside. Use :transition to coordinate the lifecycle of these
+external channels.
 
 :transition - optional, (state transition) -&gt; state'
 
@@ -121,9 +130,7 @@
 process will no longer be used following that. See the SPI for
 details. state' will be the state supplied to subsequent calls.
 
-Exactly one of either :transform or :introduce are required.
-
-:transform - (state in-name msg) -&gt; [state' output]
+:transform - required, (state in-name msg) -&gt; [state' output]
 where output is a map of outid-&gt;[msgs*]
 
 The transform fn will be called every time a message arrives at any
@@ -134,21 +141,6 @@
 may never be nil (per core.async channels). state' will be the state
 supplied to subsequent calls.
 
-:introduce - (state) -&gt; [state' output]
-where output is a map of outid-&gt;[msgs*], per :transform
-
-The introduce fn is used for sources - proc-impls that introduce new data
-into the flow by doing I/O with something external to the flow and
-feeding that data to its outputs. A proc-impl specifying :introduce may not
-specify any :ins in its descriptor, as none but the ::flow/control channel
-will be read. Instead, introduce will be called every time through the
-process loop, and will presumably do blocking or paced I/O to get
-new data to return via its outputs. If it does blocking I/O it
-should do so with a timeout so it can regularly return to the
-process loop which can then look for control messages - it's fine
-for introduce to return with no output. Do not spin poll in the introduce
-fn.
-
 process accepts an option map with keys:
 :workload - one of :mixed, :io or :compute
 :compute-timeout-ms - if :workload is :compute, this timeout (default 5000 msec)
@@ -158,14 +150,11 @@
 any :workload returned by the :describe fn of the process. If neither
 are provded the default is :mixed.
 
-The :compute workload is not allowed for proc impls that
-provide :introduce (as I/O is presumed).
-
 In the :workload context of :mixed or :io, this dictates the type of
 thread in which the process loop will run, _including its calls to
-transform/introduce_. 
+transform_. 
 
-When :io is specified transform/introduce should not do extensive computation.
+When :io is specified, transform should not do extensive computation.
 
 When :compute is specified (only allowed for :transform), each call
 to transform will be run in a separate thread. The process loop will
@@ -182,7 +171,7 @@
 
 :report-chan - a core.async chan for reading.'ping' reponses
 will show up here, as will any explicit ::flow/report outputs
-from :transform/:introduce
+from :transform
 
 :error-chan - a core.async chan for reading. Any (and only)
 exceptions thrown anywhere on any thread inside a flow will appear

From 5afc8f8e04a9915bca9ca8abd8ca349146c0d4f2 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Thu, 23 Jan 2025 15:50:01 -0500
Subject: [PATCH 23/73] reads of closed channels (would have to be ports atm)
 send nil to transform exactly once then boot the chan out of the read pool

---
 .../clojure/clojure/core/async/flow/impl.clj  | 24 ++++++++++---------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index c1fb62b..04c32d1 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -242,9 +242,9 @@
                   io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
                   control (::flow/control ins)
                   ;;TODO rotate/randomize after control per normal alts?
-                  read-chans (into [control] (-> ins (dissoc ::flow/control) vals))
+                  read-chans (vec (-> ins (dissoc ::flow/control) vals))
                   run
-                  #(loop [status :paused, state state, count 0]
+                  #(loop [status :paused, state state, count 0, read-chans read-chans]
                      (let [pong (fn []
                                   (let [pins (dissoc ins ::flow/control)
                                         pouts (dissoc outs ::flow/error ::flow/report)]
@@ -254,34 +254,36 @@
                                                        :ins (zipmap (keys pins) (map chan->data (vals pins)))
                                                        :outs (zipmap (keys pouts) (map chan->data (vals pouts)))})))
                            handle-command (partial handle-command pid pong)
-                           [nstatus nstate count]
+                           [nstatus nstate count read-chans]
                            (try
                              (if (= status :paused)
                                (let [nstatus (handle-command status (async/<!! control))
                                      nstate (handle-transition transition status nstatus state)]
-                                 [nstatus nstate count])
+                                 [nstatus nstate count read-chans])
                                ;;:running
-                               (let [[msg c] (async/alts!! read-chans :priority true)
+                               (let [[msg c] (async/alts!! (into [control] read-chans) :priority true)
                                      cid (io-id c)]
                                  (if (= c control)
                                    (let [nstatus (handle-command status msg)
                                          nstate (handle-transition transition status nstatus state)]
-                                     [nstatus nstate count])
+                                     [nstatus nstate count read-chans])
                                    (try
                                      (let [[nstate outputs] (transform state cid msg)
                                            [nstatus nstate]
                                            (send-outputs status nstate outputs outs
                                                          resolver control handle-command transition)]
-                                       [nstatus nstate (inc count)])
+                                       [nstatus nstate (inc count) (if (some? msg)
+                                                                     read-chans
+                                                                     (vec (remove #{c} read-chans)))])
                                      (catch Throwable ex
                                        (async/>!! (outs ::flow/error)
                                                   #::flow{:pid pid, :status status, :state state,
                                                           :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
-                                       [status state count])))))
+                                       [status state count read-chans])))))
                              (catch Throwable ex
                                (async/>!! (outs ::flow/error)
-                                          #::flow{:pid pid, :status status, :state state, :count (inc count), :ex ex})
-                               [status state count]))]
+                                   #::flow{:pid pid, :status status, :state state, :count (inc count), :ex ex})
+                               [status state count read-chans]))]
                        (when-not (= nstatus :exit) ;;fall out
-                         (recur nstatus nstate (long count)))))]
+                         (recur nstatus nstate (long count) read-chans))))]
               ((futurize run {:exec exs})))))))

From 9e761604d91ed03b3ab13132021d714e6b3c3457 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Thu, 23 Jan 2025 16:57:06 -0500
Subject: [PATCH 24/73] support input read subsets with ::flow/input-filter
 pred in state

---
 src/main/clojure/clojure/core/async/flow.clj  | 14 ++++++---
 .../clojure/clojure/core/async/flow/impl.clj  | 30 +++++++++++--------
 2 files changed, 28 insertions(+), 16 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 6ed7f4a..6d9634b 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -174,12 +174,18 @@
   Optionally, a returned init state may contain the
   keys ::flow/in-ports and/or ::flow/out-ports. These should be maps
   of cid -> a core.async.channel. The cids must not conflict with the
-  in/out ids. These channels will become part of the read/write set of
-  the process, but are not otherwise visible/resolvable within the
-  flow. Ports are a way to have data enter or exit the flow from
-  outside. Use :transition to coordinate the lifecycle of these
+  in/out ids. These channels will become part of the input/output set
+  of the process, but are not otherwise visible/resolvable within the
+  flow. Ports are a way to allow data to enter or exit the flow from
+  outside of it. Use :transition to coordinate the lifecycle of these
   external channels.
 
+  Optionally, _any_ returned state, whether from :init, :transition
+  or :transform, may contain the key ::flow/input-filter, a predicate
+  of cid. Only inputs (including in-ports) satisfying the predicate
+  will be part of the next channel read set. In the absence of this
+  predicate all inputs are read.
+
   :transition - optional, (state transition) -> state'
 
   transition will be called when the process makes a state transition,
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 04c32d1..8d8ade7 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -241,10 +241,9 @@
                   outs (into (or outs {}) (::flow/out-ports state))
                   io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
                   control (::flow/control ins)
-                  ;;TODO rotate/randomize after control per normal alts?
-                  read-chans (vec (-> ins (dissoc ::flow/control) vals))
+                  read-ins (dissoc ins ::flow/control)
                   run
-                  #(loop [status :paused, state state, count 0, read-chans read-chans]
+                  #(loop [status :paused, state state, count 0, read-ins read-ins]
                      (let [pong (fn []
                                   (let [pins (dissoc ins ::flow/control)
                                         pouts (dissoc outs ::flow/error ::flow/report)]
@@ -254,36 +253,43 @@
                                                        :ins (zipmap (keys pins) (map chan->data (vals pins)))
                                                        :outs (zipmap (keys pouts) (map chan->data (vals pouts)))})))
                            handle-command (partial handle-command pid pong)
-                           [nstatus nstate count read-chans]
+                           [nstatus nstate count read-ins]
                            (try
                              (if (= status :paused)
                                (let [nstatus (handle-command status (async/<!! control))
                                      nstate (handle-transition transition status nstatus state)]
-                                 [nstatus nstate count read-chans])
+                                 [nstatus nstate count read-ins])
                                ;;:running
-                               (let [[msg c] (async/alts!! (into [control] read-chans) :priority true)
+                               (let [;;TODO rotate/randomize after control per normal alts?
+                                     read-chans (let [ipred (or (::flow/input-filter state) identity)]
+                                                  (reduce-kv (fn [ret cid chan]
+                                                               (if (ipred cid)
+                                                                 (conj ret chan)
+                                                                 ret))
+                                                             [control] read-ins))
+                                     [msg c] (async/alts!! read-chans :priority true)
                                      cid (io-id c)]
                                  (if (= c control)
                                    (let [nstatus (handle-command status msg)
                                          nstate (handle-transition transition status nstatus state)]
-                                     [nstatus nstate count read-chans])
+                                     [nstatus nstate count read-ins])
                                    (try
                                      (let [[nstate outputs] (transform state cid msg)
                                            [nstatus nstate]
                                            (send-outputs status nstate outputs outs
                                                          resolver control handle-command transition)]
                                        [nstatus nstate (inc count) (if (some? msg)
-                                                                     read-chans
-                                                                     (vec (remove #{c} read-chans)))])
+                                                                     read-ins
+                                                                     (dissoc read-ins cid))])
                                      (catch Throwable ex
                                        (async/>!! (outs ::flow/error)
                                                   #::flow{:pid pid, :status status, :state state,
                                                           :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
-                                       [status state count read-chans])))))
+                                       [status state count read-ins])))))
                              (catch Throwable ex
                                (async/>!! (outs ::flow/error)
                                    #::flow{:pid pid, :status status, :state state, :count (inc count), :ex ex})
-                               [status state count read-chans]))]
+                               [status state count read-ins]))]
                        (when-not (= nstatus :exit) ;;fall out
-                         (recur nstatus nstate (long count) read-chans))))]
+                         (recur nstatus nstate (long count) read-ins))))]
               ((futurize run {:exec exs})))))))

From cfb53ac7e48dbcf197b700c62bdd429675fa77b2 Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Thu, 23 Jan 2025 22:15:49 +0000
Subject: [PATCH 25/73] Action doc commit

---
 docs/clojure.core.async.flow.html | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index e9d1050..f479f86 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -114,12 +114,18 @@
 Optionally, a returned init state may contain the
 keys ::flow/in-ports and/or ::flow/out-ports. These should be maps
 of cid -&gt; a core.async.channel. The cids must not conflict with the
-in/out ids. These channels will become part of the read/write set of
-the process, but are not otherwise visible/resolvable within the
-flow. Ports are a way to have data enter or exit the flow from
-outside. Use :transition to coordinate the lifecycle of these
+in/out ids. These channels will become part of the input/output set
+of the process, but are not otherwise visible/resolvable within the
+flow. Ports are a way to allow data to enter or exit the flow from
+outside of it. Use :transition to coordinate the lifecycle of these
 external channels.
 
+Optionally, _any_ returned state, whether from :init, :transition
+or :transform, may contain the key ::flow/input-filter, a predicate
+of cid. Only inputs (including in-ports) satisfying the predicate
+will be part of the next channel read set. In the absence of this
+predicate all inputs are read.
+
 :transition - optional, (state transition) -&gt; state'
 
 transition will be called when the process makes a state transition,

From 0a92d932115d4da390c3a67722ebd8a58d88c2e7 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Mon, 27 Jan 2025 09:38:58 -0500
Subject: [PATCH 26/73] inject is now async, returns future

---
 src/main/clojure/clojure/core/async/flow.clj      | 5 +++--
 src/main/clojure/clojure/core/async/flow/impl.clj | 7 ++++---
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 6d9634b..7562b60 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -133,8 +133,9 @@
   [g pid cmd-id more-kvs] (g/command-proc g pid cmd-id more-kvs))
   
 (defn inject
-  "synchronously puts the messages on the channel corresponding to the
-  input or output of the process"
+  "asynchronously puts the messages on the channel corresponding to the
+  input or output of the process, returning a future that will
+  complete when done."
   [g [pid io-id :as coord] msgs] (g/inject g coord msgs))
 
 (defn process
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 8d8ade7..4e0d5b0 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -79,7 +79,7 @@
                        (let [{:keys [control]} (running-chans)]
                          (async/>!! control #::flow{:command command :to to})))]
     (reify
-     clojure.core.async.flow.impl.graph.Graph
+      clojure.core.async.flow.impl.graph.Graph
       (start [_]
         (.lock lock)
         (try
@@ -170,8 +170,9 @@
       (inject [_ coord msgs]
         (let [{:keys [resolver]} (running-chans)
               chan (spi/get-write-chan resolver coord)]
-          (doseq [m msgs]
-            (async/>!! chan m)))))))
+          ((futurize #(doseq [m msgs]
+                        (async/>!! chan m))
+                     {:exec :io})))))))
 
 (defn handle-command
   [pid pong status cmd]

From 4902545e0f2cb449898facf796824bea9d2fac93 Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Mon, 27 Jan 2025 17:11:08 +0000
Subject: [PATCH 27/73] Action doc commit

---
 docs/clojure.core.async.flow.html | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index f479f86..2d838e7 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -70,8 +70,9 @@
 futurize accepts kwarg options:
 :exec - one of the workloads :mixed, :io, :compute
         or a j.u.c.ExecutorService object,
-        default :mixed</pre></div></div><div class="public anchor" id="var-inject"><h3>inject</h3><div class="usage"><code>(inject g [pid io-id :as coord] msgs)</code></div><div class="doc"><pre class="plaintext">synchronously puts the messages on the channel corresponding to the
-input or output of the process</pre></div></div><div class="public anchor" id="var-lift*-.3Estep"><h3>lift*-&gt;step</h3><div class="usage"><code>(lift*-&gt;step f)</code></div><div class="doc"><pre class="plaintext">given a fn f taking one arg and returning a collection of non-nil
+        default :mixed</pre></div></div><div class="public anchor" id="var-inject"><h3>inject</h3><div class="usage"><code>(inject g [pid io-id :as coord] msgs)</code></div><div class="doc"><pre class="plaintext">asynchronously puts the messages on the channel corresponding to the
+input or output of the process, returning a future that will
+complete when done.</pre></div></div><div class="public anchor" id="var-lift*-.3Estep"><h3>lift*-&gt;step</h3><div class="usage"><code>(lift*-&gt;step f)</code></div><div class="doc"><pre class="plaintext">given a fn f taking one arg and returning a collection of non-nil
 values, create a 'step' fn as needed by step-process, with one input
 and one output (named :in and :out), and no state.</pre></div></div><div class="public anchor" id="var-lift1-.3Estep"><h3>lift1-&gt;step</h3><div class="usage"><code>(lift1-&gt;step f)</code></div><div class="doc"><pre class="plaintext">like lift*-&gt;step except taking a fn returning one value, which, when
 nil, will yield no output.</pre></div></div><div class="public anchor" id="var-pause"><h3>pause</h3><div class="usage"><code>(pause g)</code></div><div class="doc"><pre class="plaintext">pauses a running flow

From a3220fa21e4bf13abfd1d0fd69b387a2953e2af8 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Mon, 27 Jan 2025 15:39:32 -0500
Subject: [PATCH 28/73] pings return data instead of putting on report chan

---
 src/main/clojure/clojure/core/async/flow.clj  | 13 ++++----
 .../clojure/clojure/core/async/flow/impl.clj  | 31 +++++++++++++------
 .../clojure/core/async/flow/impl/graph.clj    |  4 +--
 3 files changed, 31 insertions(+), 17 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 7562b60..a60c53c 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -109,9 +109,10 @@
   [g] (g/resume g))
 
 (defn ping
-  "pings all processes, which will put their status and state on the
-  report channel returned from start"
-  [g] (g/ping g))
+  "pings all processes, returning a map of pid -> proc status and
+  state, for those procs that reply within timeout-ms (default 1000)"
+  [g & {:keys [timeout-ms] :or {timeout-ms 1000}}]
+  (g/ping g timeout-ms))
 
 (defn pause-proc
   "pauses a process"
@@ -122,9 +123,9 @@
   [g pid] (g/resume-proc g pid))
 
 (defn ping-proc
-  "pings the process, which will put its status and state on the report
-  channel returned from start"
-  [g pid] (g/ping-proc g pid))
+  "like ping, but just pings the specified process"
+  [g pid & {:keys [timeout-ms] :or {timeout-ms 1000}}]
+  (g/ping-proc g pid timeout-ms))
 
 (defn command-proc
   "synchronously sends a process-specific command with the given id and
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 4e0d5b0..ee0a9e7 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -75,9 +75,22 @@
                              (throw (ex-info "invalid connection" {:conn conn}))))
                          {} conns)
         running-chans #(or (deref chans) (throw (Exception. "flow not running")))
-        send-command (fn [command to]
-                       (let [{:keys [control]} (running-chans)]
-                         (async/>!! control #::flow{:command command :to to})))]
+        send-command (fn sc
+                       ([cmap]
+                        (let [{:keys [control]} (running-chans)]
+                          (async/>!! control cmap)))
+                       ([command to] (sc #::flow{:command command :to to})))
+        handle-ping (fn [to timeout-ms]
+                      (let [reply-chan (async/chan (count procs))
+                            ret-chan (async/take (if (= to ::flow/all) (count procs) 1) reply-chan)
+                            timeout (async/timeout timeout-ms)
+                            _ (send-command #::flow{:command ::flow/ping, :to to, :reply-chan reply-chan})
+                            ret (loop [ret nil]
+                                  (let [[{::flow/keys [pid] :as m} c] (async/alts!! [ret-chan timeout])]
+                                    (if (some? m)
+                                      (recur (assoc ret pid m))
+                                      ret)))]
+                        (if (= to ::flow/all) ret (-> ret vals first))))]
     (reify
       clojure.core.async.flow.impl.graph.Graph
       (start [_]
@@ -156,11 +169,11 @@
           (finally (.unlock lock))))
       (pause [_] (send-command ::flow/pause ::flow/all))
       (resume [_] (send-command ::flow/resume ::flow/all))
-      (ping [_] (send-command ::flow/ping ::flow/all))
+      (ping [_ timeout-ms] (handle-ping ::flow/all timeout-ms))
 
       (pause-proc [_ pid] (send-command ::flow/pause pid))
       (resume-proc [_ pid] (send-command ::flow/resume pid))
-      (ping-proc [_ pid] (send-command ::flow/ping pid))
+      (ping-proc [_ pid timeout-ms] (handle-ping pid timeout-ms))
       (command-proc [_ pid command kvs]
         (assert (and (namespace command) (not= (namespace ::flow/command) (namespace command)))
                 "extension commands must be in your own namespace")
@@ -177,10 +190,10 @@
 (defn handle-command
   [pid pong status cmd]
   (let [transition #::flow{:stop :exit, :resume :running, :pause :paused}
-        {::flow/keys [to command]} cmd]
+        {::flow/keys [to command reply-chan]} cmd]
     (if (#{::flow/all pid} to)
       (do
-        (when (= command ::flow/ping) (pong))
+        (when (= command ::flow/ping) (pong reply-chan))
         (or (transition command) status))
       status)))
 
@@ -245,10 +258,10 @@
                   read-ins (dissoc ins ::flow/control)
                   run
                   #(loop [status :paused, state state, count 0, read-ins read-ins]
-                     (let [pong (fn []
+                     (let [pong (fn [c]
                                   (let [pins (dissoc ins ::flow/control)
                                         pouts (dissoc outs ::flow/error ::flow/report)]
-                                    (async/>!! (outs ::flow/report)
+                                    (async/>!! c ;;(outs ::flow/report)
                                                #::flow{:report :ping, :pid pid, :status status
                                                        :state state, :count count
                                                        :ins (zipmap (keys pins) (map chan->data (vals pins)))
diff --git a/src/main/clojure/clojure/core/async/flow/impl/graph.clj b/src/main/clojure/clojure/core/async/flow/impl/graph.clj
index 181a392..063661f 100644
--- a/src/main/clojure/clojure/core/async/flow/impl/graph.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl/graph.clj
@@ -16,11 +16,11 @@
   (stop [g] "shuts down the graph, stopping all procs, can be started again")
   (pause [g] "pauses a running graph")
   (resume [g] "resumes a paused graph")
-  (ping [g] "pings all processes, which will put their status and state on the report channel")
+  (ping [g timeout-ms] "pings all processes, which will put their status and state on the report channel")
 
   (pause-proc [g pid] "pauses a process")
   (resume-proc [g pid] "resumes a process")
-  (ping-proc [g pid] "pings the process, which will put its status and state on the report channel")
+  (ping-proc [g pid timeout-ms] "pings the process, which will put its status and state on the report channel")
   (command-proc [g pid cmd-id more-kvs] "synchronously sends a process-specific command with the given id 
                                          and additional kvs to the process")
   

From 0529d79f1b73a4788567f9b571f8b423657bb409 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Mon, 27 Jan 2025 19:46:14 -0500
Subject: [PATCH 29/73] first cut at datafy for flow

---
 .../clojure/clojure/core/async/flow/impl.clj  | 179 ++++++++++--------
 1 file changed, 102 insertions(+), 77 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index ee0a9e7..b2bdf03 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -10,7 +10,9 @@
   (:require [clojure.core.async :as async]
             [clojure.core.async.flow :as-alias flow]
             [clojure.core.async.flow.spi :as spi]
-            [clojure.core.async.flow.impl.graph :as graph])
+            [clojure.core.async.flow.impl.graph :as graph]
+            [clojure.walk :as walk]
+            [clojure.datafy :as datafy])
   (:import [java.util.concurrent Future Executors ExecutorService TimeUnit]
            [java.util.concurrent.locks ReentrantLock]))
 
@@ -21,16 +23,34 @@
 (defonce io-exec clojure.lang.Agent/soloExecutor)
 (defonce compute-exec clojure.lang.Agent/pooledExecutor)
 
+(defn oid [x]
+  (symbol (str (-> x class .getSimpleName) "@" (-> x System/identityHashCode Integer/toHexString))))
+
 (defn chan->data
   [^clojure.core.async.impl.channels.ManyToManyChannel c]
-    (let [b (.buf c)]
-      {:buffer-type (if b
-                      (-> b class .getSimpleName symbol)
-                      :none)
-       :buffer-count (count b)
-       :put-count (count (.puts c))
-       :take-count (count (.takes c))
-       :closed? (clojure.core.async.impl.protocols/closed? c)}))
+  (let [b (.buf c)]
+    {:buffer (if (some? b) (oid b) :none)
+     :buffer-count (count b)
+     :put-count (count (.puts c))
+     :take-count (count (.takes c))
+     :closed? (clojure.core.async.impl.protocols/closed? c)}))
+
+(defn exec->data [exec]
+  (let [ess (as-> (str exec) ^String es
+              (.substring es (inc (.lastIndexOf es "[")) (.lastIndexOf es "]"))
+              (.split es ","))]
+    (merge {:id (oid exec)
+            :status (first ess)} ;;TODO less fragile
+           (zipmap [:pool-size :active-threads :queued-tasks :completed-tasks]
+                   (map #(-> ^String % (.substring (inc (.lastIndexOf ^String % " "))) Long.) (rest ess))))))
+
+(defn datafy [x]
+  (condp instance? x
+    clojure.lang.Fn (-> x str symbol)
+    ExecutorService (exec->data x)
+    clojure.lang.Var (symbol x)
+    clojure.core.async.impl.channels.ManyToManyChannel (chan->data x)
+    (datafy/datafy x)))
 
 (defn futurize ^Future [f {:keys [exec]}]
   (fn [& args]
@@ -92,6 +112,11 @@
                                       ret)))]
                         (if (= to ::flow/all) ret (-> ret vals first))))]
     (reify
+      clojure.core.protocols/Datafiable
+      (datafy [_]
+        (walk/postwalk datafy {:procs procs, :conns conns, :execs execs
+                               :chans (select-keys @chans [:ins :outs :error :report])}))
+
       clojure.core.async.flow.impl.graph.Graph
       (start [_]
         (.lock lock)
@@ -237,73 +262,73 @@
         workload (or workload (:workload desc) :mixed)]
     (assert (or (not params) init) "must have :init if :params")
     (reify
-     clojure.core.protocols/Datafiable
-     (datafy [_]
-             (let [{:keys [params ins outs]} desc]
-               {:impl impl :params (-> params keys vec) :ins (-> ins keys vec) :outs (-> outs keys vec)}))
-     spi/ProcLauncher
-     (describe [_] desc)
-     (start [_ {:keys [pid args ins outs resolver]}]
-            (assert (or (not params) args) "must provide :args if :params")
-            (let [comp? (= workload :compute)
-                  transform (cond-> transform (= workload :compute)
-                                    #(.get (futurize transform {:exec (spi/get-exec resolver :compute)})
-                                           compute-timeout-ms TimeUnit/MILLISECONDS))
-                  exs (spi/get-exec resolver (if (= workload :mixed) :mixed :io))
-                  state (when init (init args))
-                  ins (into (or ins {}) (::flow/in-ports state))
-                  outs (into (or outs {}) (::flow/out-ports state))
-                  io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
-                  control (::flow/control ins)
-                  read-ins (dissoc ins ::flow/control)
-                  run
-                  #(loop [status :paused, state state, count 0, read-ins read-ins]
-                     (let [pong (fn [c]
-                                  (let [pins (dissoc ins ::flow/control)
-                                        pouts (dissoc outs ::flow/error ::flow/report)]
-                                    (async/>!! c ;;(outs ::flow/report)
-                                               #::flow{:report :ping, :pid pid, :status status
-                                                       :state state, :count count
-                                                       :ins (zipmap (keys pins) (map chan->data (vals pins)))
-                                                       :outs (zipmap (keys pouts) (map chan->data (vals pouts)))})))
-                           handle-command (partial handle-command pid pong)
-                           [nstatus nstate count read-ins]
-                           (try
-                             (if (= status :paused)
-                               (let [nstatus (handle-command status (async/<!! control))
+      clojure.core.protocols/Datafiable
+      (datafy [_]
+        (let [{:keys [params ins outs]} desc]
+          (walk/postwalk datafy {:impl impl :params (-> params keys vec)
+                                 :ins (-> ins keys vec) :outs (-> outs keys vec)})))
+      spi/ProcLauncher
+      (describe [_] desc)
+      (start [_ {:keys [pid args ins outs resolver]}]
+        (assert (or (not params) args) "must provide :args if :params")
+        (let [comp? (= workload :compute)
+              transform (cond-> transform (= workload :compute)
+                                #(.get (futurize transform {:exec (spi/get-exec resolver :compute)})
+                                       compute-timeout-ms TimeUnit/MILLISECONDS))
+              exs (spi/get-exec resolver (if (= workload :mixed) :mixed :io))
+              state (when init (init args))
+              ins (into (or ins {}) (::flow/in-ports state))
+              outs (into (or outs {}) (::flow/out-ports state))
+              io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
+              control (::flow/control ins)
+              read-ins (dissoc ins ::flow/control)
+              run
+              #(loop [status :paused, state state, count 0, read-ins read-ins]
+                 (let [pong (fn [c]
+                              (let [pins (dissoc ins ::flow/control)
+                                    pouts (dissoc outs ::flow/error ::flow/report)]
+                                (async/>!! c (walk/postwalk datafy
+                                                #::flow{:pid pid, :status status
+                                                        :state state, :count count
+                                                        :ins pins :outs pouts}))))
+                       handle-command (partial handle-command pid pong)
+                       [nstatus nstate count read-ins]
+                       (try
+                         (if (= status :paused)
+                           (let [nstatus (handle-command status (async/<!! control))
+                                 nstate (handle-transition transition status nstatus state)]
+                             [nstatus nstate count read-ins])
+                           ;;:running
+                           (let [ ;;TODO rotate/randomize after control per normal alts?
+                                 read-chans (let [ipred (or (::flow/input-filter state) identity)]
+                                              (reduce-kv (fn [ret cid chan]
+                                                           (if (ipred cid)
+                                                             (conj ret chan)
+                                                             ret))
+                                                         [control] read-ins))
+                                 [msg c] (async/alts!! read-chans :priority true)
+                                 cid (io-id c)]
+                             (if (= c control)
+                               (let [nstatus (handle-command status msg)
                                      nstate (handle-transition transition status nstatus state)]
                                  [nstatus nstate count read-ins])
-                               ;;:running
-                               (let [;;TODO rotate/randomize after control per normal alts?
-                                     read-chans (let [ipred (or (::flow/input-filter state) identity)]
-                                                  (reduce-kv (fn [ret cid chan]
-                                                               (if (ipred cid)
-                                                                 (conj ret chan)
-                                                                 ret))
-                                                             [control] read-ins))
-                                     [msg c] (async/alts!! read-chans :priority true)
-                                     cid (io-id c)]
-                                 (if (= c control)
-                                   (let [nstatus (handle-command status msg)
-                                         nstate (handle-transition transition status nstatus state)]
-                                     [nstatus nstate count read-ins])
-                                   (try
-                                     (let [[nstate outputs] (transform state cid msg)
-                                           [nstatus nstate]
-                                           (send-outputs status nstate outputs outs
-                                                         resolver control handle-command transition)]
-                                       [nstatus nstate (inc count) (if (some? msg)
-                                                                     read-ins
-                                                                     (dissoc read-ins cid))])
-                                     (catch Throwable ex
-                                       (async/>!! (outs ::flow/error)
-                                                  #::flow{:pid pid, :status status, :state state,
-                                                          :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
-                                       [status state count read-ins])))))
-                             (catch Throwable ex
-                               (async/>!! (outs ::flow/error)
-                                   #::flow{:pid pid, :status status, :state state, :count (inc count), :ex ex})
-                               [status state count read-ins]))]
-                       (when-not (= nstatus :exit) ;;fall out
-                         (recur nstatus nstate (long count) read-ins))))]
-              ((futurize run {:exec exs})))))))
+                               (try
+                                 (let [[nstate outputs] (transform state cid msg)
+                                       [nstatus nstate]
+                                       (send-outputs status nstate outputs outs
+                                                     resolver control handle-command transition)]
+                                   [nstatus nstate (inc count) (if (some? msg)
+                                                                 read-ins
+                                                                 (dissoc read-ins cid))])
+                                 (catch Throwable ex
+                                   (async/>!! (outs ::flow/error)
+                                              #::flow{:pid pid, :status status, :state state,
+                                                      :count (inc count), :cid cid, :msg msg :op :step, :ex ex})
+                                   [status state count read-ins])))))
+                         (catch Throwable ex
+                           (async/>!! (outs ::flow/error)
+                                      #::flow{:pid pid, :status status, :state state, :count (inc count), :ex ex})
+                           [status state count read-ins]))]
+                   (when-not (= nstatus :exit) ;;fall out
+                     (recur nstatus nstate (long count) read-ins))))]
+          ((futurize run {:exec exs})))))))

From 11a55c0a3d9914a9791f249c958298d8503d9c6d Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Mon, 27 Jan 2025 10:21:46 -0600
Subject: [PATCH 30/73] ASYNC-257 Make channels Datafiable

---
 src/main/clojure/clojure/core/async.clj              |  3 ++-
 .../clojure/clojure/core/async/impl/channels.clj     | 12 ++++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/src/main/clojure/clojure/core/async.clj b/src/main/clojure/clojure/core/async.clj
index 8b40571..8286b9e 100644
--- a/src/main/clojure/clojure/core/async.clj
+++ b/src/main/clojure/clojure/core/async.clj
@@ -92,7 +92,8 @@ to catch and handle."
   buffer must be specified. ex-handler must be a fn of one argument -
   if an exception occurs during transformation it will be called with
   the Throwable as an argument, and any non-nil return value will be
-  placed in the channel."
+  placed in the channel. Channels implement Datafiable; use datafy
+  to obtain the state of the channel and its buffer."
   ([] (chan nil))
   ([buf-or-n] (chan buf-or-n nil))
   ([buf-or-n xform] (chan buf-or-n xform nil))
diff --git a/src/main/clojure/clojure/core/async/impl/channels.clj b/src/main/clojure/clojure/core/async/impl/channels.clj
index b3f08ca..6993f37 100644
--- a/src/main/clojure/clojure/core/async/impl/channels.clj
+++ b/src/main/clojure/clojure/core/async/impl/channels.clj
@@ -303,3 +303,15 @@
                (add! buf val)
                (catch Throwable t
                  (handle buf exh t)))))))))
+
+(extend-protocol clojure.core.protocols/Datafiable
+  ManyToManyChannel
+  (datafy [c]
+    (let [b (.buf c)]
+      {:buffer-type (if b
+                      (-> b class .getSimpleName symbol)
+                      :none)
+       :buffer-count (count b)
+       :put-count (count (.puts c))
+       :take-count (count (.takes c))
+       :closed? (impl/closed? c)})))
\ No newline at end of file

From 07de58f49e778b3ff3c47db59972fe547fa431ae Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 29 Jan 2025 09:04:22 -0500
Subject: [PATCH 31/73] rely on chan datafy and alts nil check in main lib

---
 src/main/clojure/clojure/core/async/flow/impl.clj | 15 ++-------------
 1 file changed, 2 insertions(+), 13 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index b2bdf03..e296c83 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -26,15 +26,6 @@
 (defn oid [x]
   (symbol (str (-> x class .getSimpleName) "@" (-> x System/identityHashCode Integer/toHexString))))
 
-(defn chan->data
-  [^clojure.core.async.impl.channels.ManyToManyChannel c]
-  (let [b (.buf c)]
-    {:buffer (if (some? b) (oid b) :none)
-     :buffer-count (count b)
-     :put-count (count (.puts c))
-     :take-count (count (.takes c))
-     :closed? (clojure.core.async.impl.protocols/closed? c)}))
-
 (defn exec->data [exec]
   (let [ess (as-> (str exec) ^String es
               (.substring es (inc (.lastIndexOf es "[")) (.lastIndexOf es "]"))
@@ -49,7 +40,6 @@
     clojure.lang.Fn (-> x str symbol)
     ExecutorService (exec->data x)
     clojure.lang.Var (symbol x)
-    clojure.core.async.impl.channels.ManyToManyChannel (chan->data x)
     (datafy/datafy x)))
 
 (defn futurize ^Future [f {:keys [exec]}]
@@ -242,9 +232,8 @@
                 (loop [nstatus nstatus, nstate nstate, msgs (seq msgs)]
                   (if (or (nil? msgs) (= nstatus :exit))
                     [nstatus nstate]
-                    (let [m (if-some [m (first msgs)] m (throw (Exception.  "messages must be non-nil")))
-                          [v c] (async/alts!!
-                                 [control [outc m]]
+                    (let [[v c] (async/alts!!
+                                 [control [outc (first msgs)]]
                                  :priority true)]
                       (if (= c control)
                         (let [nnstatus (handle-command nstatus v)

From b7466fb13e40eb116c991b414445d35661019438 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 29 Jan 2025 09:07:17 -0500
Subject: [PATCH 32/73] get out of executor datafy biz

---
 src/main/clojure/clojure/core/async/flow/impl.clj | 14 +-------------
 1 file changed, 1 insertion(+), 13 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index e296c83..b1a97a4 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -23,22 +23,10 @@
 (defonce io-exec clojure.lang.Agent/soloExecutor)
 (defonce compute-exec clojure.lang.Agent/pooledExecutor)
 
-(defn oid [x]
-  (symbol (str (-> x class .getSimpleName) "@" (-> x System/identityHashCode Integer/toHexString))))
-
-(defn exec->data [exec]
-  (let [ess (as-> (str exec) ^String es
-              (.substring es (inc (.lastIndexOf es "[")) (.lastIndexOf es "]"))
-              (.split es ","))]
-    (merge {:id (oid exec)
-            :status (first ess)} ;;TODO less fragile
-           (zipmap [:pool-size :active-threads :queued-tasks :completed-tasks]
-                   (map #(-> ^String % (.substring (inc (.lastIndexOf ^String % " "))) Long.) (rest ess))))))
-
 (defn datafy [x]
   (condp instance? x
     clojure.lang.Fn (-> x str symbol)
-    ExecutorService (exec->data x)
+    ExecutorService (str x)
     clojure.lang.Var (symbol x)
     (datafy/datafy x)))
 

From 8bd11b70024a7b092ba324261c905b1ed1b6dcb2 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 29 Jan 2025 10:03:29 -0500
Subject: [PATCH 33/73] return to orig design in that a single fn/var can fully
 specify a proc (thus all 4 arities are required) and accept such fns directly
 in process (so step-process is no longer needed)

---
 src/main/clojure/clojure/core/async/flow.clj  | 88 ++++++++-----------
 .../clojure/clojure/core/async/flow/impl.clj  | 10 ++-
 2 files changed, 44 insertions(+), 54 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index a60c53c..c6242ab 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -140,15 +140,22 @@
   [g [pid io-id :as coord] msgs] (g/inject g coord msgs))
 
 (defn process
-  "Given a map of functions (described below), returns a launcher that
+  "Given a function of four arities (0-3), or a map of functions
+  corresponding thereto (described below), returns a launcher that
   creates a process compliant with the process protocol (see the
-  spi/ProcLauncher doc). The possible entries for process-impl-map
-  are :describe, :init, :transition and :transform. This is
-  the core facility for defining the logic for processes via ordinary
-  functions.
-
-  :describe - required, () -> desc
-  where desc is a map with keys :params :ins and :outs, each of which
+  spi/ProcLauncher doc).
+
+  The possible arities/entries for fn/map are 0 - :describe, 1
+  - :init, 2 - :transition and 3 - :transform. This is the core
+  facility for defining the logic for processes via ordinary
+  functions. Using a var holding a fn as the 'fn' is the preferred
+  method for defining a proc, as it enables hot-code-reloading of the
+  proc logic in a flow, and better names in datafy. You can use the
+  map form to compose the proc logic from disparate functions or to
+  leverage the optionality of some of the entry points.
+
+  arity 0, or :describe - required, () -> description
+  where description is a map with keys :params :ins and :outs, each of which
   in turn is a map of keyword to doc string, and :workload with
   possible values of :mixed :io :compute. All entries in the describe
   return map are optional.
@@ -167,7 +174,7 @@
   the proc. It will also be called by the impl in order to discover
   what channels are needed.
 
-  :init - optional, (arg-map) -> initial-state
+  arity 1, or :init - optional, (arg-map) -> initial-state
   
   init will be called once by the process to establish any initial
   state. The arg-map will be a map of param->val, as supplied in the
@@ -188,7 +195,7 @@
   will be part of the next channel read set. In the absence of this
   predicate all inputs are read.
 
-  :transition - optional, (state transition) -> state'
+  arity 2, or :transition - optional, (state transition) -> state'
 
   transition will be called when the process makes a state transition,
   transition being one of ::flow/resume, ::flow/pause or ::flow/stop
@@ -198,7 +205,7 @@
   process will no longer be used following that. See the SPI for
   details. state' will be the state supplied to subsequent calls.
 
-  :transform - required, (state in-name msg) -> [state' output]
+  arity 3, or :transform - required, (state in-name msg) -> [state' output]
   where output is a map of outid->[msgs*]
 
   The transform fn will be called every time a message arrives at any
@@ -233,30 +240,28 @@
   times out it will be reported on ::flow/error.
 
   When :compute is specified transform must not block!"
-  ([process-impl-map] (process process-impl-map nil))
-  ([process-impl-map {:keys [workload timeout-ms]
-                      :or {timeout-ms 5000} :as opts}]
-   (impl/proc process-impl-map opts)))
-
-(defn step-process
-  "Given a (e.g. communication-free) step function f of three
-  arities (described below), and the same opts as 'process', returns a
-  launcher that creates a process compliant with the process
-  protocol (see 'process').
+  ([fn-or-map] (process fn-or-map nil))
+  ([fn-or-map {:keys [workload timeout-ms]
+               :or {timeout-ms 5000} :as opts}]
+   (impl/proc fn-or-map opts)))
 
-  The arities of f are:
-
-  ()->desc
-  a function matching the semantics of process' :describe
+(defn lift*->step
+  "given a fn f taking one arg and returning a collection of non-nil
+  values, create a 'step' fn as needed by step-process, with one input
+  and one output (named :in and :out), and no state."
+  [f]
+  (fn
+    ([] {:ins {:in (str "the argument to " f)}
+         :outs {:out (str "the return of " f)}})
+    ([_] nil)
+    ([_ _] nil)
+    ([_ _ msg] [nil {:out (f msg)}])))
 
-  (arg-map)->initial-state
-  a function matching the semantics of process' :init
-  
-  (state in-name msg)->[state' output]
-  a function matching the semantics of process' :transform"
-  ([f] (step-process f nil))
-  ([f opts]
-   (process {:describe f, :init f, :transform f} opts)))
+(defn lift1->step
+  "like lift*->step except taking a fn returning one value, which when
+  nil will yield no output."
+  [f]
+  (lift*->step #(when-some [m (f %)] (vector m))))
 
 (defn futurize
   "Takes a fn f and returns a fn that takes the same arguments as f
@@ -271,20 +276,3 @@
   [f & {:keys [exec]
         :or {exec :mixed} :as opts}]
   (impl/futurize f opts))
-
-(defn lift*->step
-  "given a fn f taking one arg and returning a collection of non-nil
-  values, create a 'step' fn as needed by step-process, with one input
-  and one output (named :in and :out), and no state."
-  [f]
-  (fn
-    ([] {:ins {:in (str "the argument to " f)}
-         :outs {:out (str "the return of " f)}})
-    ([_] nil)
-    ([_ _ msg] [nil {:out (f msg)}])))
-
-(defn lift1->step
-  "like lift*->step except taking a fn returning one value, which, when
-  nil, will yield no output."
-  [f]
-  (lift*->step #(when-some [m (f %)] (vector m))))
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index b1a97a4..428246a 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -233,16 +233,18 @@
 
 (defn proc
   "see lib ns for docs"
-  [{:keys [describe init transition transform] :as impl} {:keys [workload compute-timeout-ms]}]
-  (assert transform "must provide :transform") 
-  (let [{:keys [params ins] :as desc} (describe)
+  [fm {:keys [workload compute-timeout-ms]}]
+  (let [{:keys [describe init transition transform] :as impl}
+        (if (map? fm) fm {:describe fm :init fm :transition fm :transform fm})
+        {:keys [params ins] :as desc} (describe)
         workload (or workload (:workload desc) :mixed)]
+    (assert transform "must provide :transform")
     (assert (or (not params) init) "must have :init if :params")
     (reify
       clojure.core.protocols/Datafiable
       (datafy [_]
         (let [{:keys [params ins outs]} desc]
-          (walk/postwalk datafy {:impl impl :params (-> params keys vec)
+          (walk/postwalk datafy {:impl fm :params (-> params keys vec)
                                  :ins (-> ins keys vec) :outs (-> outs keys vec)})))
       spi/ProcLauncher
       (describe [_] desc)

From 400a929e0ea445af8457a66c30b03f61c72abb5f Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Mon, 3 Feb 2025 20:50:57 +0000
Subject: [PATCH 34/73] Action doc commit

---
 docs/clojure.core.async.flow.html | 55 ++++++++++++++-----------------
 docs/clojure.core.async.html      |  3 +-
 docs/index.html                   |  2 +-
 3 files changed, 27 insertions(+), 33 deletions(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 2d838e7..cab3ea5 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-step-process"><div class="inner"><span>step-process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
@@ -74,20 +74,27 @@
 input or output of the process, returning a future that will
 complete when done.</pre></div></div><div class="public anchor" id="var-lift*-.3Estep"><h3>lift*-&gt;step</h3><div class="usage"><code>(lift*-&gt;step f)</code></div><div class="doc"><pre class="plaintext">given a fn f taking one arg and returning a collection of non-nil
 values, create a 'step' fn as needed by step-process, with one input
-and one output (named :in and :out), and no state.</pre></div></div><div class="public anchor" id="var-lift1-.3Estep"><h3>lift1-&gt;step</h3><div class="usage"><code>(lift1-&gt;step f)</code></div><div class="doc"><pre class="plaintext">like lift*-&gt;step except taking a fn returning one value, which, when
-nil, will yield no output.</pre></div></div><div class="public anchor" id="var-pause"><h3>pause</h3><div class="usage"><code>(pause g)</code></div><div class="doc"><pre class="plaintext">pauses a running flow
+and one output (named :in and :out), and no state.</pre></div></div><div class="public anchor" id="var-lift1-.3Estep"><h3>lift1-&gt;step</h3><div class="usage"><code>(lift1-&gt;step f)</code></div><div class="doc"><pre class="plaintext">like lift*-&gt;step except taking a fn returning one value, which when
+nil will yield no output.</pre></div></div><div class="public anchor" id="var-pause"><h3>pause</h3><div class="usage"><code>(pause g)</code></div><div class="doc"><pre class="plaintext">pauses a running flow
 </pre></div></div><div class="public anchor" id="var-pause-proc"><h3>pause-proc</h3><div class="usage"><code>(pause-proc g pid)</code></div><div class="doc"><pre class="plaintext">pauses a process
-</pre></div></div><div class="public anchor" id="var-ping"><h3>ping</h3><div class="usage"><code>(ping g)</code></div><div class="doc"><pre class="plaintext">pings all processes, which will put their status and state on the
-report channel returned from start</pre></div></div><div class="public anchor" id="var-ping-proc"><h3>ping-proc</h3><div class="usage"><code>(ping-proc g pid)</code></div><div class="doc"><pre class="plaintext">pings the process, which will put its status and state on the report
-channel returned from start</pre></div></div><div class="public anchor" id="var-process"><h3>process</h3><div class="usage"><code>(process process-impl-map)</code><code>(process process-impl-map {:keys [workload timeout-ms], :or {timeout-ms 5000}, :as opts})</code></div><div class="doc"><pre class="plaintext">Given a map of functions (described below), returns a launcher that
+</pre></div></div><div class="public anchor" id="var-ping"><h3>ping</h3><div class="usage"><code>(ping g &amp; {:keys [timeout-ms], :or {timeout-ms 1000}})</code></div><div class="doc"><pre class="plaintext">pings all processes, returning a map of pid -&gt; proc status and
+state, for those procs that reply within timeout-ms (default 1000)</pre></div></div><div class="public anchor" id="var-ping-proc"><h3>ping-proc</h3><div class="usage"><code>(ping-proc g pid &amp; {:keys [timeout-ms], :or {timeout-ms 1000}})</code></div><div class="doc"><pre class="plaintext">like ping, but just pings the specified process
+</pre></div></div><div class="public anchor" id="var-process"><h3>process</h3><div class="usage"><code>(process fn-or-map)</code><code>(process fn-or-map {:keys [workload timeout-ms], :or {timeout-ms 5000}, :as opts})</code></div><div class="doc"><pre class="plaintext">Given a function of four arities (0-3), or a map of functions
+corresponding thereto (described below), returns a launcher that
 creates a process compliant with the process protocol (see the
-spi/ProcLauncher doc). The possible entries for process-impl-map
-are :describe, :init, :transition and :transform. This is
-the core facility for defining the logic for processes via ordinary
-functions.
-
-:describe - required, () -&gt; desc
-where desc is a map with keys :params :ins and :outs, each of which
+spi/ProcLauncher doc).
+
+The possible arities/entries for fn/map are 0 - :describe, 1
+- :init, 2 - :transition and 3 - :transform. This is the core
+facility for defining the logic for processes via ordinary
+functions. Using a var holding a fn as the 'fn' is the preferred
+method for defining a proc, as it enables hot-code-reloading of the
+proc logic in a flow, and better names in datafy. You can use the
+map form to compose the proc logic from disparate functions or to
+leverage the optionality of some of the entry points.
+
+arity 0, or :describe - required, () -&gt; description
+where description is a map with keys :params :ins and :outs, each of which
 in turn is a map of keyword to doc string, and :workload with
 possible values of :mixed :io :compute. All entries in the describe
 return map are optional.
@@ -106,7 +113,7 @@
 the proc. It will also be called by the impl in order to discover
 what channels are needed.
 
-:init - optional, (arg-map) -&gt; initial-state
+arity 1, or :init - optional, (arg-map) -&gt; initial-state
 
 init will be called once by the process to establish any initial
 state. The arg-map will be a map of param-&gt;val, as supplied in the
@@ -127,7 +134,7 @@
 will be part of the next channel read set. In the absence of this
 predicate all inputs are read.
 
-:transition - optional, (state transition) -&gt; state'
+arity 2, or :transition - optional, (state transition) -&gt; state'
 
 transition will be called when the process makes a state transition,
 transition being one of ::flow/resume, ::flow/pause or ::flow/stop
@@ -137,7 +144,7 @@
 process will no longer be used following that. See the SPI for
 details. state' will be the state supplied to subsequent calls.
 
-:transform - required, (state in-name msg) -&gt; [state' output]
+arity 3, or :transform - required, (state in-name msg) -&gt; [state' output]
 where output is a map of outid-&gt;[msgs*]
 
 The transform fn will be called every time a message arrives at any
@@ -184,19 +191,5 @@
 exceptions thrown anywhere on any thread inside a flow will appear
 in maps sent here. There will at least be a ::flow/ex entry with the
 exception, and may be additional keys for pid, state, status etc
-depending on the context of the error.</pre></div></div><div class="public anchor" id="var-step-process"><h3>step-process</h3><div class="usage"><code>(step-process f)</code><code>(step-process f opts)</code></div><div class="doc"><pre class="plaintext">Given a (e.g. communication-free) step function f of three
-arities (described below), and the same opts as 'process', returns a
-launcher that creates a process compliant with the process
-protocol (see 'process').
-
-The arities of f are:
-
-()-&gt;desc
-a function matching the semantics of process' :describe
-
-(arg-map)-&gt;initial-state
-a function matching the semantics of process' :init
-
-(state in-name msg)-&gt;[state' output]
-a function matching the semantics of process' :transform</pre></div></div><div class="public anchor" id="var-stop"><h3>stop</h3><div class="usage"><code>(stop g)</code></div><div class="doc"><pre class="plaintext">shuts down the flow, stopping all procsesses and closing the error
+depending on the context of the error.</pre></div></div><div class="public anchor" id="var-stop"><h3>stop</h3><div class="usage"><code>(stop g)</code></div><div class="doc"><pre class="plaintext">shuts down the flow, stopping all procsesses and closing the error
 and report channels. The flow can be started again</pre></div></div></div></body></html>
\ No newline at end of file
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index eeb3221..b7136d7 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -81,7 +81,8 @@
 buffer must be specified. ex-handler must be a fn of one argument -
 if an exception occurs during transformation it will be called with
 the Throwable as an argument, and any non-nil return value will be
-placed in the channel.</pre></div></div><div class="public anchor" id="var-close.21"><h3>close!</h3><div class="usage"><code>(close! chan)</code></div><div class="doc"><pre class="plaintext">Closes a channel. The channel will no longer accept any puts (they
+placed in the channel. Channels implement Datafiable; use datafy
+to obtain the state of the channel and its buffer.</pre></div></div><div class="public anchor" id="var-close.21"><h3>close!</h3><div class="usage"><code>(close! chan)</code></div><div class="doc"><pre class="plaintext">Closes a channel. The channel will no longer accept any puts (they
 will be ignored). Data in the channel remains available for taking, until
 exhausted, after which takes will return nil. If there are any
 pending takes, they will be dispatched with nil. Closing a closed
diff --git a/docs/index.html b/docs/index.html
index eec7c0c..b7935bc 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-step-process">step-process</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file

From 6c77b88e11ceb33451fbb5f06821cee496b1d24a Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 31 Jan 2025 09:56:42 -0600
Subject: [PATCH 35/73] ASYNC-258 Datafy buffers and report capacity

---
 .../clojure/core/async/impl/buffers.clj       | 41 ++++++++++++++++---
 .../clojure/core/async/impl/channels.clj      | 15 ++++---
 .../clojure/core/async/impl/protocols.clj     |  3 ++
 3 files changed, 45 insertions(+), 14 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/impl/buffers.clj b/src/main/clojure/clojure/core/async/impl/buffers.clj
index 1f4948d..98dbe64 100644
--- a/src/main/clojure/clojure/core/async/impl/buffers.clj
+++ b/src/main/clojure/clojure/core/async/impl/buffers.clj
@@ -14,6 +14,7 @@
 
 (set! *warn-on-reflection* true)
 
+
 (deftype FixedBuffer [^LinkedList buf ^long n]
   impl/Buffer
   (full? [_this]
@@ -26,12 +27,14 @@
   (close-buf! [_this])
   Counted
   (count [_this]
-    (.size buf)))
+    (.size buf))
+  impl/Capacity
+  (capacity [_this]
+    n))
 
 (defn fixed-buffer [^long n]
   (FixedBuffer. (LinkedList.) n))
 
-
 (deftype DroppingBuffer [^LinkedList buf ^long n]
   impl/UnblockingBuffer
   impl/Buffer
@@ -46,7 +49,10 @@
   (close-buf! [_this])
   Counted
   (count [_this]
-    (.size buf)))
+    (.size buf))
+  impl/Capacity
+  (capacity [_this]
+    n))
 
 (defn dropping-buffer [n]
   (DroppingBuffer. (LinkedList.) n))
@@ -66,7 +72,10 @@
   (close-buf! [_this])
   Counted
   (count [_this]
-    (.size buf)))
+    (.size buf))
+  impl/Capacity
+  (capacity [_this]
+    n))
 
 (defn sliding-buffer [n]
   (SlidingBuffer. (LinkedList.) n))
@@ -91,7 +100,27 @@
       (set! val nil)))
   Counted
   (count [_]
-    (if (undelivered? val) 0 1)))
+    (if (undelivered? val) 0 1))
+  impl/Capacity
+  (capacity [_this]
+    1))
 
 (defn promise-buffer []
-  (PromiseBuffer. NO-VAL))
\ No newline at end of file
+  (PromiseBuffer. NO-VAL))
+
+(defn datafy-buffer [buffer]
+  {:type (-> buffer class .getSimpleName symbol)
+   :count (count buffer)
+   :capacity (impl/capacity buffer)})
+
+(extend-protocol clojure.core.protocols/Datafiable
+  FixedBuffer
+  (datafy [b] (datafy-buffer b))
+  DroppingBuffer
+  (datafy [b] (datafy-buffer b))
+  SlidingBuffer
+  (datafy [b] (datafy-buffer b))
+  PromiseBuffer
+  (datafy [b] (datafy-buffer b))
+  Object
+  (datafy [b] nil))
\ No newline at end of file
diff --git a/src/main/clojure/clojure/core/async/impl/channels.clj b/src/main/clojure/clojure/core/async/impl/channels.clj
index 6993f37..84a7130 100644
--- a/src/main/clojure/clojure/core/async/impl/channels.clj
+++ b/src/main/clojure/clojure/core/async/impl/channels.clj
@@ -8,7 +8,8 @@
 
 (ns ^{:skip-wiki true}
   clojure.core.async.impl.channels
-  (:require [clojure.core.async.impl.protocols :as impl]
+  (:require [clojure.datafy :as datafy]
+            [clojure.core.async.impl.protocols :as impl]
             [clojure.core.async.impl.dispatch :as dispatch]
             [clojure.core.async.impl.mutex :as mutex])
   (:import [java.util LinkedList Queue]
@@ -308,10 +309,8 @@
   ManyToManyChannel
   (datafy [c]
     (let [b (.buf c)]
-      {:buffer-type (if b
-                      (-> b class .getSimpleName symbol)
-                      :none)
-       :buffer-count (count b)
-       :put-count (count (.puts c))
-       :take-count (count (.takes c))
-       :closed? (impl/closed? c)})))
\ No newline at end of file
+      (cond->
+        {:put-count (count (.puts c))
+         :take-count (count (.takes c))
+         :closed? (impl/closed? c)}
+        b (assoc :buffer (clojure.datafy/datafy b))))))
\ No newline at end of file
diff --git a/src/main/clojure/clojure/core/async/impl/protocols.clj b/src/main/clojure/clojure/core/async/impl/protocols.clj
index f27cddf..e9e88c5 100644
--- a/src/main/clojure/clojure/core/async/impl/protocols.clj
+++ b/src/main/clojure/clojure/core/async/impl/protocols.clj
@@ -34,6 +34,9 @@
   (add!* [b itm] "if room, add item to the buffer, returns b, called under chan mutex")
   (close-buf! [b] "called on chan closed under chan mutex, return ignored"))
 
+(defprotocol Capacity
+  (capacity [b] "The max capacity of the buffer, nil if unknown"))
+
 (defn add!
   ([b] b)
   ([b itm]

From 88a7971196cd41fbc921df3f4c36a004a3f974d6 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Tue, 4 Feb 2025 13:56:44 -0500
Subject: [PATCH 36/73] doc refinement, pass ::flow/pid with args, fix buffer
 datafy to not touch Object datafy

---
 src/main/clojure/clojure/core/async/flow.clj  | 55 ++++++++++++-------
 .../clojure/clojure/core/async/flow/impl.clj  |  2 +-
 .../clojure/core/async/impl/buffers.clj       |  4 +-
 3 files changed, 38 insertions(+), 23 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index c6242ab..54b2c5e 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -21,6 +21,10 @@
   a set of channels for centralized control, reporting, error-handling,
     and execution of the processes
 
+  The flow library itself constructs processes, channels and flows. The
+  user provides configuration data and process logic (step-fns) that
+  specify how the flow should work.
+
   A flow is constructed from flow configuration data which defines a
   directed graph of processes and the connections between
   them. Processes describe their I/O requirements and the
@@ -30,9 +34,9 @@
   policy decisions regarding process settings, threading, buffering etc.
 
   It is expected that applications will rarely define instances of the
-  process protocol but instead use the API functions here, 'process'
-  and 'step-process', that implement the process protocol in terms of
-  calls to ordinary functions that might include no communication or
+  process protocol but instead use the API function 'process' that
+  implements the process protocol in terms of calls to ordinary
+  functions (step-fns) that might include no communication or
   core.async code. In this way the library helps you achieve a strict
   separation of your application logic from its execution,
   communication, lifecycle, error handling and monitoring.
@@ -44,6 +48,10 @@
   the library itself as ::flow/xyz, where ::flow is an alias for
   clojure.core.async.flow
 
+  Flows support the Clojure 'datafy' protocol to support
+  observability. See also the 'ping' and 'ping-proc' fns for a live
+  view of processes.
+
   A process is represented in the flow definition by an implementation
   of spi/ProcLauncher that starts it. See the spi docs for
   details."
@@ -82,7 +90,7 @@
 
 (defn start
   "starts the entire flow from init values. The processes start paused.
-  Call 'resume' or 'resume-proc' to start flow.  returns a map with keys:
+  Call 'resume' or 'resume-proc' to start flow.  Returns a map with keys:
   
   :report-chan - a core.async chan for reading.'ping' reponses
   will show up here, as will any explicit ::flow/report outputs
@@ -140,19 +148,25 @@
   [g [pid io-id :as coord] msgs] (g/inject g coord msgs))
 
 (defn process
-  "Given a function of four arities (0-3), or a map of functions
-  corresponding thereto (described below), returns a launcher that
-  creates a process compliant with the process protocol (see the
-  spi/ProcLauncher doc).
-
-  The possible arities/entries for fn/map are 0 - :describe, 1
-  - :init, 2 - :transition and 3 - :transform. This is the core
-  facility for defining the logic for processes via ordinary
-  functions. Using a var holding a fn as the 'fn' is the preferred
-  method for defining a proc, as it enables hot-code-reloading of the
-  proc logic in a flow, and better names in datafy. You can use the
-  map form to compose the proc logic from disparate functions or to
-  leverage the optionality of some of the entry points.
+  "Given a function of four arities (0-3), aka the 'step-fn', or a map
+  of functions corresponding thereto (described below), returns a
+  launcher that creates a process compliant with the process
+  protocol (see the spi/ProcLauncher doc).
+
+  The possible arities/entries for the step-fn/map are
+
+  0 - :describe,
+  1 - :init,
+  2 - :transition
+  3 - :transform.
+
+  This is the core facility for defining the logic for processes via
+  ordinary functions. Using a var holding a fn as the 'step-fn' is the
+  preferred method for defining a proc, as it enables
+  hot-code-reloading of the proc logic in a flow, and better names in
+  datafy. You can use the map form to compose the proc logic from
+  disparate functions or to leverage the optionality of some of the
+  entry points.
 
   arity 0, or :describe - required, () -> description
   where description is a map with keys :params :ins and :outs, each of which
@@ -178,7 +192,10 @@
   
   init will be called once by the process to establish any initial
   state. The arg-map will be a map of param->val, as supplied in the
-  flow def. init must be provided if 'describe' returns :params.
+  flow def. The key ::flow/pid will be added, mapped to the pid
+  associated with the process (useful e.g. if the process wants to
+  refer to itself in reply-to coordinates). init must be provided if
+  'describe' returns :params.
 
   Optionally, a returned init state may contain the
   keys ::flow/in-ports and/or ::flow/out-ports. These should be maps
@@ -247,7 +264,7 @@
 
 (defn lift*->step
   "given a fn f taking one arg and returning a collection of non-nil
-  values, create a 'step' fn as needed by step-process, with one input
+  values, creates a step fn as needed by process, with one input
   and one output (named :in and :out), and no state."
   [f]
   (fn
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 428246a..a85f7fd 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -143,7 +143,7 @@
                       (let [chan-map (fn [ks coll] (zipmap (keys ks) (map #(coll [pid %]) (keys ks))))
                             control-tap (async/chan 10)]
                         (async/tap control-mult control-tap)
-                        (spi/start proc {:pid pid :args args :resolver resolver
+                        (spi/start proc {:pid pid :args (assoc args ::flow/pid pid) :resolver resolver
                                          :ins (assoc (chan-map ins in-chans)
                                                      ::flow/control control-tap)
                                          :outs (assoc (chan-map outs out-chans)
diff --git a/src/main/clojure/clojure/core/async/impl/buffers.clj b/src/main/clojure/clojure/core/async/impl/buffers.clj
index 98dbe64..ab273c7 100644
--- a/src/main/clojure/clojure/core/async/impl/buffers.clj
+++ b/src/main/clojure/clojure/core/async/impl/buffers.clj
@@ -121,6 +121,4 @@
   SlidingBuffer
   (datafy [b] (datafy-buffer b))
   PromiseBuffer
-  (datafy [b] (datafy-buffer b))
-  Object
-  (datafy [b] nil))
\ No newline at end of file
+  (datafy [b] (datafy-buffer b)))

From d922995579ce50f0760cbfc781f1e4a6ea077ce1 Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Wed, 19 Feb 2025 16:07:16 +0000
Subject: [PATCH 37/73] Action doc commit

---
 docs/clojure.core.async.flow.html | 55 ++++++++++++++++++++-----------
 docs/clojure.core.async.html      | 46 +++++++++++++++++++++++---
 docs/index.html                   |  2 +-
 3 files changed, 78 insertions(+), 25 deletions(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index cab3ea5..b115475 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -13,6 +13,10 @@
 a set of channels for centralized control, reporting, error-handling,
   and execution of the processes
 
+The flow library itself constructs processes, channels and flows. The
+user provides configuration data and process logic (step-fns) that
+specify how the flow should work.
+
 A flow is constructed from flow configuration data which defines a
 directed graph of processes and the connections between
 them. Processes describe their I/O requirements and the
@@ -22,9 +26,9 @@
 policy decisions regarding process settings, threading, buffering etc.
 
 It is expected that applications will rarely define instances of the
-process protocol but instead use the API functions here, 'process'
-and 'step-process', that implement the process protocol in terms of
-calls to ordinary functions that might include no communication or
+process protocol but instead use the API function 'process' that
+implements the process protocol in terms of calls to ordinary
+functions (step-fns) that might include no communication or
 core.async code. In this way the library helps you achieve a strict
 separation of your application logic from its execution,
 communication, lifecycle, error handling and monitoring.
@@ -36,6 +40,10 @@
 the library itself as ::flow/xyz, where ::flow is an alias for
 clojure.core.async.flow
 
+Flows support the Clojure 'datafy' protocol to support
+observability. See also the 'ping' and 'ping-proc' fns for a live
+view of processes.
+
 A process is represented in the flow definition by an implementation
 of spi/ProcLauncher that starts it. See the spi docs for
 details.</pre></div><div class="public anchor" id="var-command-proc"><h3>command-proc</h3><div class="usage"><code>(command-proc g pid cmd-id more-kvs)</code></div><div class="doc"><pre class="plaintext">synchronously sends a process-specific command with the given id and
@@ -73,25 +81,31 @@
         default :mixed</pre></div></div><div class="public anchor" id="var-inject"><h3>inject</h3><div class="usage"><code>(inject g [pid io-id :as coord] msgs)</code></div><div class="doc"><pre class="plaintext">asynchronously puts the messages on the channel corresponding to the
 input or output of the process, returning a future that will
 complete when done.</pre></div></div><div class="public anchor" id="var-lift*-.3Estep"><h3>lift*-&gt;step</h3><div class="usage"><code>(lift*-&gt;step f)</code></div><div class="doc"><pre class="plaintext">given a fn f taking one arg and returning a collection of non-nil
-values, create a 'step' fn as needed by step-process, with one input
+values, creates a step fn as needed by process, with one input
 and one output (named :in and :out), and no state.</pre></div></div><div class="public anchor" id="var-lift1-.3Estep"><h3>lift1-&gt;step</h3><div class="usage"><code>(lift1-&gt;step f)</code></div><div class="doc"><pre class="plaintext">like lift*-&gt;step except taking a fn returning one value, which when
 nil will yield no output.</pre></div></div><div class="public anchor" id="var-pause"><h3>pause</h3><div class="usage"><code>(pause g)</code></div><div class="doc"><pre class="plaintext">pauses a running flow
 </pre></div></div><div class="public anchor" id="var-pause-proc"><h3>pause-proc</h3><div class="usage"><code>(pause-proc g pid)</code></div><div class="doc"><pre class="plaintext">pauses a process
 </pre></div></div><div class="public anchor" id="var-ping"><h3>ping</h3><div class="usage"><code>(ping g &amp; {:keys [timeout-ms], :or {timeout-ms 1000}})</code></div><div class="doc"><pre class="plaintext">pings all processes, returning a map of pid -&gt; proc status and
 state, for those procs that reply within timeout-ms (default 1000)</pre></div></div><div class="public anchor" id="var-ping-proc"><h3>ping-proc</h3><div class="usage"><code>(ping-proc g pid &amp; {:keys [timeout-ms], :or {timeout-ms 1000}})</code></div><div class="doc"><pre class="plaintext">like ping, but just pings the specified process
-</pre></div></div><div class="public anchor" id="var-process"><h3>process</h3><div class="usage"><code>(process fn-or-map)</code><code>(process fn-or-map {:keys [workload timeout-ms], :or {timeout-ms 5000}, :as opts})</code></div><div class="doc"><pre class="plaintext">Given a function of four arities (0-3), or a map of functions
-corresponding thereto (described below), returns a launcher that
-creates a process compliant with the process protocol (see the
-spi/ProcLauncher doc).
-
-The possible arities/entries for fn/map are 0 - :describe, 1
-- :init, 2 - :transition and 3 - :transform. This is the core
-facility for defining the logic for processes via ordinary
-functions. Using a var holding a fn as the 'fn' is the preferred
-method for defining a proc, as it enables hot-code-reloading of the
-proc logic in a flow, and better names in datafy. You can use the
-map form to compose the proc logic from disparate functions or to
-leverage the optionality of some of the entry points.
+</pre></div></div><div class="public anchor" id="var-process"><h3>process</h3><div class="usage"><code>(process fn-or-map)</code><code>(process fn-or-map {:keys [workload timeout-ms], :or {timeout-ms 5000}, :as opts})</code></div><div class="doc"><pre class="plaintext">Given a function of four arities (0-3), aka the 'step-fn', or a map
+of functions corresponding thereto (described below), returns a
+launcher that creates a process compliant with the process
+protocol (see the spi/ProcLauncher doc).
+
+The possible arities/entries for the step-fn/map are
+
+0 - :describe,
+1 - :init,
+2 - :transition
+3 - :transform.
+
+This is the core facility for defining the logic for processes via
+ordinary functions. Using a var holding a fn as the 'step-fn' is the
+preferred method for defining a proc, as it enables
+hot-code-reloading of the proc logic in a flow, and better names in
+datafy. You can use the map form to compose the proc logic from
+disparate functions or to leverage the optionality of some of the
+entry points.
 
 arity 0, or :describe - required, () -&gt; description
 where description is a map with keys :params :ins and :outs, each of which
@@ -117,7 +131,10 @@
 
 init will be called once by the process to establish any initial
 state. The arg-map will be a map of param-&gt;val, as supplied in the
-flow def. init must be provided if 'describe' returns :params.
+flow def. The key ::flow/pid will be added, mapped to the pid
+associated with the process (useful e.g. if the process wants to
+refer to itself in reply-to coordinates). init must be provided if
+'describe' returns :params.
 
 Optionally, a returned init state may contain the
 keys ::flow/in-ports and/or ::flow/out-ports. These should be maps
@@ -181,7 +198,7 @@
 When :compute is specified transform must not block!</pre></div></div><div class="public anchor" id="var-resume"><h3>resume</h3><div class="usage"><code>(resume g)</code></div><div class="doc"><pre class="plaintext">resumes a paused flow
 </pre></div></div><div class="public anchor" id="var-resume-proc"><h3>resume-proc</h3><div class="usage"><code>(resume-proc g pid)</code></div><div class="doc"><pre class="plaintext">resumes a process
 </pre></div></div><div class="public anchor" id="var-start"><h3>start</h3><div class="usage"><code>(start g)</code></div><div class="doc"><pre class="plaintext">starts the entire flow from init values. The processes start paused.
-Call 'resume' or 'resume-proc' to start flow.  returns a map with keys:
+Call 'resume' or 'resume-proc' to start flow.  Returns a map with keys:
 
 :report-chan - a core.async chan for reading.'ping' reponses
 will show up here, as will any explicit ::flow/report outputs
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index b7136d7..50f0d89 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 go blocks are dispatched over an internal thread pool, which
 defaults to 8 threads. The size of this pool can be modified using
@@ -11,7 +11,33 @@
 Property is read once, at namespace load time. Recommended for use
 primarily during development. Invalid blocking calls will throw in
 go block threads - use Thread.setDefaultUncaughtExceptionHandler()
-to catch and handle.</pre></div><div class="public anchor" id="var-.3C.21"><h3>&lt;!</h3><div class="usage"><code>(&lt;! port)</code></div><div class="doc"><pre class="plaintext">takes a val from port. Must be called inside a (go ...) block. Will
+to catch and handle.
+
+Use the Java system property `clojure.core.async.executor-factory`
+to specify a function that will provide ExecutorServices for
+application-wide use by core.async in lieu of its defaults. The
+property value should name a fully qualified var. The function
+will be passed a keyword indicating the context of use of the
+executor, and should return either an ExecutorService, or nil to
+use the default. Results per keyword will be cached and used for
+the remainder of the application. Possible context arguments are:
+
+:io - used in async/io-thread, for :io workloads in flow/process,
+and for dispatch handling if no explicit dispatch handler is
+provided (see below)
+
+:mixed - used by async/thread and for :mixed workloads in
+flow/process
+
+:compute - used for :compute workloads in flow/process
+
+:core-async-dispatch - used for completion fn handling (e.g. in put!
+and take!, as well as go block IOC thunk processing) throughout
+core.async. If not supplied the ExecutorService for :io will be
+used instead.
+
+The set of contexts may grow in the future so the function should
+return nil for unexpected contexts.</pre></div><div class="public anchor" id="var-.3C.21"><h3>&lt;!</h3><div class="usage"><code>(&lt;! port)</code></div><div class="doc"><pre class="plaintext">takes a val from port. Must be called inside a (go ...) block. Will
 return nil if closed. Will park if nothing is available.</pre></div></div><div class="public anchor" id="var-.3C.21.21"><h3>&lt;!!</h3><div class="usage"><code>(&lt;!! port)</code></div><div class="doc"><pre class="plaintext">takes a val from port. Will return nil if closed. Will block
 if nothing is available.
 Not intended for use in direct or transitive calls from (go ...) blocks.
@@ -107,7 +133,10 @@
 completed</pre></div></div><div class="public anchor" id="var-go-loop"><h3>go-loop</h3><h4 class="type">macro</h4><div class="usage"><code>(go-loop bindings &amp; body)</code></div><div class="doc"><pre class="plaintext">Like (go (loop ...))
 </pre></div></div><div class="public anchor" id="var-into"><h3>into</h3><div class="usage"><code>(into coll ch)</code></div><div class="doc"><pre class="plaintext">Returns a channel containing the single (collection) result of the
 items taken from the channel conjoined to the supplied
-collection. ch must close before into produces a result.</pre></div></div><div class="public anchor" id="var-ioc-alts.21"><h3>ioc-alts!</h3><div class="usage"><code>(ioc-alts! state cont-block ports &amp; {:as opts})</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-map"><h3>map</h3><div class="usage"><code>(map f chs)</code><code>(map f chs buf-or-n)</code></div><div class="doc"><pre class="plaintext">Takes a function and a collection of source channels, and returns a
+collection. ch must close before into produces a result.</pre></div></div><div class="public anchor" id="var-io-thread"><h3>io-thread</h3><h4 class="type">macro</h4><div class="usage"><code>(io-thread &amp; body)</code></div><div class="doc"><pre class="plaintext">Executes the body in a thread, returning immediately to the calling
+thread. The body may do blocking I/O but must not do extended computation.
+Returns a channel which will receive the result of the body when completed,
+then close.</pre></div></div><div class="public anchor" id="var-ioc-alts.21"><h3>ioc-alts!</h3><div class="usage"><code>(ioc-alts! state cont-block ports &amp; {:as opts})</code></div><div class="doc"><pre class="plaintext"></pre></div></div><div class="public anchor" id="var-map"><h3>map</h3><div class="usage"><code>(map f chs)</code><code>(map f chs buf-or-n)</code></div><div class="doc"><pre class="plaintext">Takes a function and a collection of source channels, and returns a
 channel which contains the values produced by applying f to the set
 of first items taken from each source channel, followed by applying
 f to the set of second items from each channel, until any one of the
@@ -244,9 +273,16 @@
 By default the channel will be closed when the source closes,
 but can be determined by the close? parameter.</pre></div></div><div class="public anchor" id="var-thread"><h3>thread</h3><h4 class="type">macro</h4><div class="usage"><code>(thread &amp; body)</code></div><div class="doc"><pre class="plaintext">Executes the body in another thread, returning immediately to the
 calling thread. Returns a channel which will receive the result of
-the body when completed, then close.</pre></div></div><div class="public anchor" id="var-thread-call"><h3>thread-call</h3><div class="usage"><code>(thread-call f)</code></div><div class="doc"><pre class="plaintext">Executes f in another thread, returning immediately to the calling
+the body when completed, then close.</pre></div></div><div class="public anchor" id="var-thread-call"><h3>thread-call</h3><div class="usage"><code>(thread-call f)</code><code>(thread-call f workload)</code></div><div class="doc"><pre class="plaintext">Executes f in another thread, returning immediately to the calling
 thread. Returns a channel which will receive the result of calling
-f when completed, then close.</pre></div></div><div class="public anchor" id="var-timeout"><h3>timeout</h3><div class="usage"><code>(timeout msecs)</code></div><div class="doc"><pre class="plaintext">Returns a channel that will close after msecs
+f when completed, then close. workload is a keyword that describes
+the work performed by f, where:
+
+:io - may do blocking I/O but must not do extended computation
+:compute - must not ever block
+:mixed - anything else (default)
+
+when workload not supplied, defaults to :mixed</pre></div></div><div class="public anchor" id="var-timeout"><h3>timeout</h3><div class="usage"><code>(timeout msecs)</code></div><div class="doc"><pre class="plaintext">Returns a channel that will close after msecs
 </pre></div></div><div class="public anchor" id="var-to-chan"><h3>to-chan</h3><h4 class="deprecated">deprecated in 1.2</h4><div class="usage"><code>(to-chan coll)</code></div><div class="doc"><pre class="plaintext">Deprecated - use to-chan! or to-chan!!
 </pre></div></div><div class="public anchor" id="var-to-chan.21"><h3>to-chan!</h3><div class="usage"><code>(to-chan! coll)</code></div><div class="doc"><pre class="plaintext">Creates and returns a channel which contains the contents of coll,
 closing when exhausted.
diff --git a/docs/index.html b/docs/index.html
index b7935bc..6216e08 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file

From c56fd025c8fc016aa821b704ec681233aa46e982 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Tue, 25 Feb 2025 11:12:21 -0500
Subject: [PATCH 38/73] use impl/dispatch executors

---
 src/main/clojure/clojure/core/async/flow.clj  |  2 +-
 .../clojure/clojure/core/async/flow/impl.clj  | 21 +++++++------------
 2 files changed, 8 insertions(+), 15 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 54b2c5e..cfa12b5 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -92,7 +92,7 @@
   "starts the entire flow from init values. The processes start paused.
   Call 'resume' or 'resume-proc' to start flow.  Returns a map with keys:
   
-  :report-chan - a core.async chan for reading.'ping' reponses
+  :report-chan - a core.async chan for reading.'ping' responses
   will show up here, as will any explicit ::flow/report outputs
   from :transform
   
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index a85f7fd..831a735 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -11,6 +11,7 @@
             [clojure.core.async.flow :as-alias flow]
             [clojure.core.async.flow.spi :as spi]
             [clojure.core.async.flow.impl.graph :as graph]
+            [clojure.core.async.impl.dispatch :as disp]
             [clojure.walk :as walk]
             [clojure.datafy :as datafy])
   (:import [java.util.concurrent Future Executors ExecutorService TimeUnit]
@@ -18,11 +19,6 @@
 
 (set! *warn-on-reflection* true)
 
-;;TODO - something specific, e.g. make aware of JDK version and vthreads
-(defonce mixed-exec clojure.lang.Agent/soloExecutor)
-(defonce io-exec clojure.lang.Agent/soloExecutor)
-(defonce compute-exec clojure.lang.Agent/pooledExecutor)
-
 (defn datafy [x]
   (condp instance? x
     clojure.lang.Fn (-> x str symbol)
@@ -32,11 +28,9 @@
 
 (defn futurize ^Future [f {:keys [exec]}]
   (fn [& args]
-    (let [^ExecutorService e (case exec
-                                   :compute compute-exec
-                                   :io io-exec
-                                   :mixed mixed-exec
-                                   exec)]
+    (let [^ExecutorService e (if (instance? ExecutorService exec)
+                               exec
+                               (disp/executor-for exec))]
       (.submit e ^Callable #(apply f args)))))
 
 (defn prep-proc [ret pid {:keys [proc, args, chan-opts] :or {chan-opts {}}}]
@@ -53,12 +47,11 @@
 
 (defn create-flow
   "see lib ns for docs"
-  [{:keys [procs conns mixed-exec io-exec compute-exec]
-    :or {mixed-exec mixed-exec, io-exec io-exec, compute-exec compute-exec}}]
+  [{:keys [procs conns mixed-exec io-exec compute-exec]}]
   (let [lock (ReentrantLock.)
         chans (atom nil)
         execs {:mixed mixed-exec :io io-exec :compute compute-exec}
-        _ (assert (every? #(instance? ExecutorService %) (vals execs))
+        _ (assert (every? #(or (nil? %) (instance? ExecutorService %)) (vals execs))
                   "mixed-exe, io-exec and compute-exec must be ExecutorServices")
         pdescs (reduce-kv prep-proc {} procs)
         allopts (fn [iok] (into {} (mapcat #(map (fn [[k opts]] [[(:pid %) k] opts]) (iok %)) (vals pdescs))))
@@ -136,7 +129,7 @@
                   resolver (reify spi/Resolver
                              (get-write-chan [_ coord]
                                (write-chan coord))
-                             (get-exec [_ context] (execs context)))
+                             (get-exec [_ context] (or (execs context) (disp/executor-for context))))
                   start-proc
                   (fn [{:keys [pid proc args ins outs]}]
                     (try

From 58ccbff2248c4f3775cf794fc92f038acd6cb0d4 Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Thu, 27 Feb 2025 15:30:33 +0000
Subject: [PATCH 39/73] Action doc commit

---
 docs/clojure.core.async.flow.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index b115475..88baf8a 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -200,7 +200,7 @@
 </pre></div></div><div class="public anchor" id="var-start"><h3>start</h3><div class="usage"><code>(start g)</code></div><div class="doc"><pre class="plaintext">starts the entire flow from init values. The processes start paused.
 Call 'resume' or 'resume-proc' to start flow.  Returns a map with keys:
 
-:report-chan - a core.async chan for reading.'ping' reponses
+:report-chan - a core.async chan for reading.'ping' responses
 will show up here, as will any explicit ::flow/report outputs
 from :transform
 

From 7cc715ac25b4a0f232a7fe1049f90f14ef10fd96 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Tue, 4 Mar 2025 10:02:18 -0600
Subject: [PATCH 40/73] In channel datafy, include the chan in meta under
 :clojure.datafy/obj

---
 .../clojure/clojure/core/async/impl/channels.clj     | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/impl/channels.clj b/src/main/clojure/clojure/core/async/impl/channels.clj
index 84a7130..0769532 100644
--- a/src/main/clojure/clojure/core/async/impl/channels.clj
+++ b/src/main/clojure/clojure/core/async/impl/channels.clj
@@ -309,8 +309,10 @@
   ManyToManyChannel
   (datafy [c]
     (let [b (.buf c)]
-      (cond->
-        {:put-count (count (.puts c))
-         :take-count (count (.takes c))
-         :closed? (impl/closed? c)}
-        b (assoc :buffer (clojure.datafy/datafy b))))))
\ No newline at end of file
+      (with-meta
+        (cond->
+          {:put-count (count (.puts c))
+           :take-count (count (.takes c))
+           :closed? (impl/closed? c)}
+          b (assoc :buffer (datafy/datafy b)))
+        {::datafy/obj c}))))
\ No newline at end of file

From 830bc3b3fa293510019e0021c19c1689d6f10216 Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Fri, 14 Mar 2025 18:58:58 +0000
Subject: [PATCH 41/73] Action doc commit

---
 docs/clojure.core.async.html | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index 50f0d89..ac94cc4 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -2,10 +2,6 @@
     "">
 <html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
-go blocks are dispatched over an internal thread pool, which
-defaults to 8 threads. The size of this pool can be modified using
-the Java system property `clojure.core.async.pool-size`.
-
 Set Java system property `clojure.core.async.go-checking` to true
 to validate go blocks do not invoke core.async blocking operations.
 Property is read once, at namespace load time. Recommended for use

From 87f58167ebe40b4c09ece8306aa3ddc781dda1f3 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Mon, 7 Apr 2025 10:01:13 -0400
Subject: [PATCH 42/73] Got rid of (unimplemented) process-specific commands
 (command-proc). Use inputs system instead

---
 src/main/clojure/clojure/core/async/flow.clj      | 6 ------
 src/main/clojure/clojure/core/async/flow/impl.clj | 9 +--------
 2 files changed, 1 insertion(+), 14 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index cfa12b5..88eaa75 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -134,12 +134,6 @@
   "like ping, but just pings the specified process"
   [g pid & {:keys [timeout-ms] :or {timeout-ms 1000}}]
   (g/ping-proc g pid timeout-ms))
-
-(defn command-proc
-  "synchronously sends a process-specific command with the given id and
-  additional kvs to the process. The cmd-id must be ns-qualified with
-  a ns you own."
-  [g pid cmd-id more-kvs] (g/command-proc g pid cmd-id more-kvs))
   
 (defn inject
   "asynchronously puts the messages on the channel corresponding to the
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 831a735..c62ac5c 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -166,16 +166,9 @@
       (pause [_] (send-command ::flow/pause ::flow/all))
       (resume [_] (send-command ::flow/resume ::flow/all))
       (ping [_ timeout-ms] (handle-ping ::flow/all timeout-ms))
-
       (pause-proc [_ pid] (send-command ::flow/pause pid))
       (resume-proc [_ pid] (send-command ::flow/resume pid))
-      (ping-proc [_ pid timeout-ms] (handle-ping pid timeout-ms))
-      (command-proc [_ pid command kvs]
-        (assert (and (namespace command) (not= (namespace ::flow/command) (namespace command)))
-                "extension commands must be in your own namespace")
-        (let [{:keys [control]} (running-chans)]
-          (async/>!! control (merge kvs #::flow{:command command :to pid}))))
-          
+      (ping-proc [_ pid timeout-ms] (handle-ping pid timeout-ms))         
       (inject [_ coord msgs]
         (let [{:keys [resolver]} (running-chans)
               chan (spi/get-write-chan resolver coord)]

From df5605dea4576ff3e93d9e378608b37f74e5cf8b Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Mon, 7 Apr 2025 14:18:56 +0000
Subject: [PATCH 43/73] Action doc commit

---
 docs/clojure.core.async.flow.html | 6 ++----
 docs/index.html                   | 2 +-
 2 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 88baf8a..4b42134 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-command-proc"><div class="inner"><span>command-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
@@ -46,9 +46,7 @@
 
 A process is represented in the flow definition by an implementation
 of spi/ProcLauncher that starts it. See the spi docs for
-details.</pre></div><div class="public anchor" id="var-command-proc"><h3>command-proc</h3><div class="usage"><code>(command-proc g pid cmd-id more-kvs)</code></div><div class="doc"><pre class="plaintext">synchronously sends a process-specific command with the given id and
-additional kvs to the process. The cmd-id must be ns-qualified with
-a ns you own.</pre></div></div><div class="public anchor" id="var-create-flow"><h3>create-flow</h3><div class="usage"><code>(create-flow config)</code></div><div class="doc"><pre class="plaintext">Creates a flow from the supplied configuration: a map containing the
+details.</pre></div><div class="public anchor" id="var-create-flow"><h3>create-flow</h3><div class="usage"><code>(create-flow config)</code></div><div class="doc"><pre class="plaintext">Creates a flow from the supplied configuration: a map containing the
 keys :procs and :conns, and optionally :mixed-exec/:io-exec/:compute-exec
 
 :procs - a map of pid-&gt;proc-def
diff --git a/docs/index.html b/docs/index.html
index 6216e08..cb42101 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-command-proc">command-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file

From 2d60b8ab43d93bad6fbbc699252762ab45cf0a46 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Mon, 7 Apr 2025 15:13:00 -0400
Subject: [PATCH 44/73] fix :workload :compute

---
 src/main/clojure/clojure/core/async/flow.clj      |  3 +--
 src/main/clojure/clojure/core/async/flow/impl.clj | 12 ++++++------
 2 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index 88eaa75..ca9c6d6 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -252,8 +252,7 @@
 
   When :compute is specified transform must not block!"
   ([fn-or-map] (process fn-or-map nil))
-  ([fn-or-map {:keys [workload timeout-ms]
-               :or {timeout-ms 5000} :as opts}]
+  ([fn-or-map {:keys [workload compute-timeout-ms] :as opts}]
    (impl/proc fn-or-map opts)))
 
 (defn lift*->step
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index c62ac5c..7e6f29c 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -26,7 +26,7 @@
     clojure.lang.Var (symbol x)
     (datafy/datafy x)))
 
-(defn futurize ^Future [f {:keys [exec]}]
+(defn futurize [f {:keys [exec]}]
   (fn [& args]
     (let [^ExecutorService e (if (instance? ExecutorService exec)
                                exec
@@ -219,7 +219,7 @@
 
 (defn proc
   "see lib ns for docs"
-  [fm {:keys [workload compute-timeout-ms]}]
+  [fm {:keys [workload compute-timeout-ms] :or {compute-timeout-ms 5000}}]
   (let [{:keys [describe init transition transform] :as impl}
         (if (map? fm) fm {:describe fm :init fm :transition fm :transform fm})
         {:keys [params ins] :as desc} (describe)
@@ -236,10 +236,10 @@
       (describe [_] desc)
       (start [_ {:keys [pid args ins outs resolver]}]
         (assert (or (not params) args) "must provide :args if :params")
-        (let [comp? (= workload :compute)
-              transform (cond-> transform (= workload :compute)
-                                #(.get (futurize transform {:exec (spi/get-exec resolver :compute)})
-                                       compute-timeout-ms TimeUnit/MILLISECONDS))
+        (let [transform (if (= workload :compute)
+                          #(.get ^Future ((futurize transform {:exec (spi/get-exec resolver :compute)}) %1 %2 %3)
+                                 compute-timeout-ms TimeUnit/MILLISECONDS)
+                          transform)
               exs (spi/get-exec resolver (if (= workload :mixed) :mixed :io))
               state (when init (init args))
               ins (into (or ins {}) (::flow/in-ports state))

From 9514a3c52e93a0d596a623590eedcddb33b51f71 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Tue, 8 Apr 2025 12:56:54 -0400
Subject: [PATCH 45/73] remove map arg to process, use map->step to convert map
 first. Put full describe result in process datafy as :desc and remove
 components

---
 deps.edn                                      |   1 +
 src/main/clojure/clojure/core/async/flow.clj  | 100 +++++++++++-------
 .../clojure/clojure/core/async/flow/impl.clj  |  26 ++---
 3 files changed, 73 insertions(+), 54 deletions(-)

diff --git a/deps.edn b/deps.edn
index 1c3303d..ce20f1f 100644
--- a/deps.edn
+++ b/deps.edn
@@ -33,3 +33,4 @@
                      :output-path "docs"
                      :html {:namespace-list :flat}}}
   }}
+
diff --git a/src/main/clojure/clojure/core/async/flow.clj b/src/main/clojure/clojure/core/async/flow.clj
index ca9c6d6..4810bb9 100644
--- a/src/main/clojure/clojure/core/async/flow.clj
+++ b/src/main/clojure/clojure/core/async/flow.clj
@@ -142,27 +142,24 @@
   [g [pid io-id :as coord] msgs] (g/inject g coord msgs))
 
 (defn process
-  "Given a function of four arities (0-3), aka the 'step-fn', or a map
-  of functions corresponding thereto (described below), returns a
-  launcher that creates a process compliant with the process
+  "Given a function of four arities (0-3), aka the 'step-fn',
+  returns a launcher that creates a process compliant with the process
   protocol (see the spi/ProcLauncher doc).
 
-  The possible arities/entries for the step-fn/map are
+  The possible arities for the step-fn are
 
-  0 - :describe,
-  1 - :init,
-  2 - :transition
-  3 - :transform.
+  0 - 'describe',   () -> description
+  1 - 'init',       (arg-map) -> initial-state
+  2 - 'transition', (state transition) -> state'
+  3 - 'transform',  (state input msg) -> [state' output-map]
 
   This is the core facility for defining the logic for processes via
   ordinary functions. Using a var holding a fn as the 'step-fn' is the
   preferred method for defining a proc, as it enables
   hot-code-reloading of the proc logic in a flow, and better names in
-  datafy. You can use the map form to compose the proc logic from
-  disparate functions or to leverage the optionality of some of the
-  entry points.
+  datafy.
 
-  arity 0, or :describe - required, () -> description
+  arity 0 - 'describe', () -> description
   where description is a map with keys :params :ins and :outs, each of which
   in turn is a map of keyword to doc string, and :workload with
   possible values of :mixed :io :compute. All entries in the describe
@@ -182,14 +179,13 @@
   the proc. It will also be called by the impl in order to discover
   what channels are needed.
 
-  arity 1, or :init - optional, (arg-map) -> initial-state
+  arity 1 - 'init', (arg-map) -> initial-state
   
-  init will be called once by the process to establish any initial
+  The init arity will be called once by the process to establish any initial
   state. The arg-map will be a map of param->val, as supplied in the
   flow def. The key ::flow/pid will be added, mapped to the pid
   associated with the process (useful e.g. if the process wants to
-  refer to itself in reply-to coordinates). init must be provided if
-  'describe' returns :params.
+  refer to itself in reply-to coordinates). 
 
   Optionally, a returned init state may contain the
   keys ::flow/in-ports and/or ::flow/out-ports. These should be maps
@@ -200,26 +196,27 @@
   outside of it. Use :transition to coordinate the lifecycle of these
   external channels.
 
-  Optionally, _any_ returned state, whether from :init, :transition
-  or :transform, may contain the key ::flow/input-filter, a predicate
+  Optionally, _any_ returned state, whether from init, transition
+  or transform, may contain the key ::flow/input-filter, a predicate
   of cid. Only inputs (including in-ports) satisfying the predicate
   will be part of the next channel read set. In the absence of this
   predicate all inputs are read.
 
-  arity 2, or :transition - optional, (state transition) -> state'
+  arity 2 - 'transition', (state transition) -> state'
 
-  transition will be called when the process makes a state transition,
-  transition being one of ::flow/resume, ::flow/pause or ::flow/stop
+  The transition arity will be called when the process makes a state
+  transition, transition being one of ::flow/resume, ::flow/pause
+  or ::flow/stop
 
-  With this fn a process impl can track changes and coordinate
+  With this a process impl can track changes and coordinate
   resources, especially cleaning up any resources on :stop, since the
   process will no longer be used following that. See the SPI for
   details. state' will be the state supplied to subsequent calls.
 
-  arity 3, or :transform - required, (state in-name msg) -> [state' output]
+  arity 3 - 'transform', (state in-name msg) -> [state' output]
   where output is a map of outid->[msgs*]
 
-  The transform fn will be called every time a message arrives at any
+  The transform arity will be called every time a message arrives at any
   of the inputs. Output can be sent to none, any or all of the :outs
   enumerated, and/or an input named by a [pid inid] tuple (e.g. for
   reply-to), and/or to the ::flow/report output. A step need not
@@ -227,7 +224,7 @@
   may never be nil (per core.async channels). state' will be the state
   supplied to subsequent calls.
 
-  process accepts an option map with keys:
+  process also accepts an option map with keys:
   :workload - one of :mixed, :io or :compute
   :compute-timeout-ms - if :workload is :compute, this timeout (default 5000 msec)
                 will be used when getting the return from the future - see below
@@ -242,18 +239,38 @@
 
   When :io is specified, transform should not do extensive computation.
 
-  When :compute is specified (only allowed for :transform), each call
-  to transform will be run in a separate thread. The process loop will
-  run in an :io context (since it no longer directly calls transform,
-  all it does is I/O) and it will submit transform to the :compute
-  executor then await (blocking, for compute-timeout-ms) the
-  completion of the future returned by the executor. If the future
-  times out it will be reported on ::flow/error.
+  When :compute is specified, each call to transform will be run in a
+  separate thread. The process loop will run in an :io context (since
+  it no longer directly calls transform, all it does is I/O) and it
+  will submit transform to the :compute executor then await (blocking,
+  for compute-timeout-ms) the completion of the future returned by the
+  executor. If the future times out it will be reported
+  on ::flow/error.
 
   When :compute is specified transform must not block!"
-  ([fn-or-map] (process fn-or-map nil))
-  ([fn-or-map {:keys [workload compute-timeout-ms] :as opts}]
-   (impl/proc fn-or-map opts)))
+  ([step-fn] (process step-fn nil))
+  ([step-fn {:keys [workload compute-timeout-ms] :as opts}]
+   (impl/proc step-fn opts)))
+
+(defn map->step
+  "given a map of functions corresponding to step fn arities (see
+  'process'), returns a step fn suitable for passing to 'process'. You
+  can use this map form to compose the proc logic from disparate
+  functions or to leverage the optionality of some of the entry
+  points.
+
+  The keys in the map are:
+  :describe, arity 0 - required
+  :init, arity 1 - optional, but should be provided if 'describe' returns :params.
+  :transition, arity 2 - optional
+  :transform, arity 3 - required"
+  [{:keys [describe init transition transform]}]
+  (assert (and describe transform) "must provide :describe and :transform")
+  (fn
+    ([] (describe))
+    ([arg-map] (when init (init arg-map)))
+    ([state trans] (if transition (transition state trans) state))
+    ([state input msg] (transform state input msg))))
 
 (defn lift*->step
   "given a fn f taking one arg and returning a collection of non-nil
@@ -263,15 +280,20 @@
   (fn
     ([] {:ins {:in (str "the argument to " f)}
          :outs {:out (str "the return of " f)}})
-    ([_] nil)
-    ([_ _] nil)
-    ([_ _ msg] [nil {:out (f msg)}])))
+    ([arg-map] nil)
+    ([state transition] nil)
+    ([state input msg] [nil {:out (f msg)}])))
 
 (defn lift1->step
   "like lift*->step except taking a fn returning one value, which when
   nil will yield no output."
   [f]
-  (lift*->step #(when-some [m (f %)] (vector m))))
+  (fn
+    ([] {:ins {:in (str "the argument to " f)}
+         :outs {:out (str "the return of " f)}})
+    ([arg-map] nil)
+    ([state transition] nil)
+    ([state input msg] [nil (when-some [m (f msg)] {:out (vector m)})])))
 
 (defn futurize
   "Takes a fn f and returns a fn that takes the same arguments as f
diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index 7e6f29c..eddd439 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -189,7 +189,7 @@
 (defn handle-transition
   "when transition, returns maybe new state"
   [transition status nstatus state]
-  (if (and transition (not= status nstatus))
+  (if (not= status nstatus)
     (transition state (case nstatus
                             :exit ::flow/stop
                             :running ::flow/resume
@@ -219,29 +219,25 @@
 
 (defn proc
   "see lib ns for docs"
-  [fm {:keys [workload compute-timeout-ms] :or {compute-timeout-ms 5000}}]
-  (let [{:keys [describe init transition transform] :as impl}
-        (if (map? fm) fm {:describe fm :init fm :transition fm :transform fm})
-        {:keys [params ins] :as desc} (describe)
+  [step {:keys [workload compute-timeout-ms] :or {compute-timeout-ms 5000}}]
+  (let [{:keys [params ins] :as desc} (step)
         workload (or workload (:workload desc) :mixed)]
-    (assert transform "must provide :transform")
-    (assert (or (not params) init) "must have :init if :params")
+    ;;(assert (or (not params) init) "must have :init if :params")
     (reify
       clojure.core.protocols/Datafiable
       (datafy [_]
         (let [{:keys [params ins outs]} desc]
-          (walk/postwalk datafy {:impl fm :params (-> params keys vec)
-                                 :ins (-> ins keys vec) :outs (-> outs keys vec)})))
+          (walk/postwalk datafy {:step step :desc desc})))
       spi/ProcLauncher
       (describe [_] desc)
       (start [_ {:keys [pid args ins outs resolver]}]
         (assert (or (not params) args) "must provide :args if :params")
         (let [transform (if (= workload :compute)
-                          #(.get ^Future ((futurize transform {:exec (spi/get-exec resolver :compute)}) %1 %2 %3)
+                          #(.get ^Future ((futurize step {:exec (spi/get-exec resolver :compute)}) %1 %2 %3)
                                  compute-timeout-ms TimeUnit/MILLISECONDS)
-                          transform)
+                          step)
               exs (spi/get-exec resolver (if (= workload :mixed) :mixed :io))
-              state (when init (init args))
+              state (step args)
               ins (into (or ins {}) (::flow/in-ports state))
               outs (into (or outs {}) (::flow/out-ports state))
               io-id (zipmap (concat (vals ins) (vals outs)) (concat (keys ins) (keys outs)))
@@ -261,7 +257,7 @@
                        (try
                          (if (= status :paused)
                            (let [nstatus (handle-command status (async/<!! control))
-                                 nstate (handle-transition transition status nstatus state)]
+                                 nstate (handle-transition step status nstatus state)]
                              [nstatus nstate count read-ins])
                            ;;:running
                            (let [ ;;TODO rotate/randomize after control per normal alts?
@@ -275,13 +271,13 @@
                                  cid (io-id c)]
                              (if (= c control)
                                (let [nstatus (handle-command status msg)
-                                     nstate (handle-transition transition status nstatus state)]
+                                     nstate (handle-transition step status nstatus state)]
                                  [nstatus nstate count read-ins])
                                (try
                                  (let [[nstate outputs] (transform state cid msg)
                                        [nstatus nstate]
                                        (send-outputs status nstate outputs outs
-                                                     resolver control handle-command transition)]
+                                                     resolver control handle-command step)]
                                    [nstatus nstate (inc count) (if (some? msg)
                                                                  read-ins
                                                                  (dissoc read-ins cid))])

From eefdb1ce7e6c1dc49b12291011f6fe03d19b66b3 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Tue, 8 Apr 2025 14:50:53 -0500
Subject: [PATCH 46/73] update versions

---
 .github/workflows/cljstest.yml            | 4 ++--
 .github/workflows/generate-codox-docs.yml | 6 +++---
 deps.edn                                  | 6 +++---
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/cljstest.yml b/.github/workflows/cljstest.yml
index 23cb762..1973f6d 100644
--- a/.github/workflows/cljstest.yml
+++ b/.github/workflows/cljstest.yml
@@ -9,9 +9,9 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: DeLaGuardo/setup-clojure@13.1
+      - uses: DeLaGuardo/setup-clojure@13.2
         with:
-          tools-deps: '1.12.0.1488'
+          tools-deps: '1.12.0.1530'
 
       - name: Build tests
         run: clojure -M:cljs-test:adv
diff --git a/.github/workflows/generate-codox-docs.yml b/.github/workflows/generate-codox-docs.yml
index 77bcce0..1032d9d 100644
--- a/.github/workflows/generate-codox-docs.yml
+++ b/.github/workflows/generate-codox-docs.yml
@@ -10,18 +10,18 @@ jobs:
     steps:
 
       - name: Set up Java
-        uses: actions/setup-java@v3
+        uses: actions/setup-java@v4
         with:
           java-version: 8
           distribution: 'temurin'
 
       - name: Set up Clojure
-        uses: DeLaGuardo/setup-clojure@11.0
+        uses: DeLaGuardo/setup-clojure@13.2
         with:
           cli: 'latest'
 
       - name: Cache clojure dependencies
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: |
             ~/.m2/repository
diff --git a/deps.edn b/deps.edn
index ce20f1f..d0c6031 100644
--- a/deps.edn
+++ b/deps.edn
@@ -10,17 +10,17 @@
   ;; For compile test purposes
   ;; clj -T:build compile
   :build
-  {:deps {io.github.clojure/tools.build {:tag "v0.10.6" :sha "52cf7d6"}}
+  {:deps {io.github.clojure/tools.build {:tag "v0.10.8" :sha "2fdfd66"}}
    :ns-default build}
 
   ;; Lint the source
   ;; clj -M:lint
-  :lint {:replace-deps {clj-kondo/clj-kondo {:mvn/version "2024.11.14"}}
+  :lint {:replace-deps {clj-kondo/clj-kondo {:mvn/version "2025.04.07"}}
          :main-opts ["-m" "clj-kondo.main" "--lint" "src"]}
 
   ;; Find outdated deps
   ;; clj -M:outdated
-  :outdated {:extra-deps {com.github.liquidz/antq {:mvn/version "2.11.1250"}}
+  :outdated {:extra-deps {com.github.liquidz/antq {:mvn/version "2.11.1276"}}
              :main-opts ["-m" "antq.core"]}
 
   ;; Regenerate docs in docs/

From 2c7d7a583d5e2aea217236569079df4ed19fe93f Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Tue, 8 Apr 2025 19:52:12 +0000
Subject: [PATCH 47/73] Action doc commit

---
 docs/clojure.core.async.flow.html | 75 +++++++++++++++++--------------
 docs/index.html                   |  2 +-
 2 files changed, 42 insertions(+), 35 deletions(-)

diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 4b42134..9329264 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
@@ -81,31 +81,38 @@
 complete when done.</pre></div></div><div class="public anchor" id="var-lift*-.3Estep"><h3>lift*-&gt;step</h3><div class="usage"><code>(lift*-&gt;step f)</code></div><div class="doc"><pre class="plaintext">given a fn f taking one arg and returning a collection of non-nil
 values, creates a step fn as needed by process, with one input
 and one output (named :in and :out), and no state.</pre></div></div><div class="public anchor" id="var-lift1-.3Estep"><h3>lift1-&gt;step</h3><div class="usage"><code>(lift1-&gt;step f)</code></div><div class="doc"><pre class="plaintext">like lift*-&gt;step except taking a fn returning one value, which when
-nil will yield no output.</pre></div></div><div class="public anchor" id="var-pause"><h3>pause</h3><div class="usage"><code>(pause g)</code></div><div class="doc"><pre class="plaintext">pauses a running flow
+nil will yield no output.</pre></div></div><div class="public anchor" id="var-map-.3Estep"><h3>map-&gt;step</h3><div class="usage"><code>(map-&gt;step {:keys [describe init transition transform]})</code></div><div class="doc"><pre class="plaintext">given a map of functions corresponding to step fn arities (see
+'process'), returns a step fn suitable for passing to 'process'. You
+can use this map form to compose the proc logic from disparate
+functions or to leverage the optionality of some of the entry
+points.
+
+The keys in the map are:
+:describe, arity 0 - required
+:init, arity 1 - optional, but should be provided if 'describe' returns :params.
+:transition, arity 2 - optional
+:transform, arity 3 - required</pre></div></div><div class="public anchor" id="var-pause"><h3>pause</h3><div class="usage"><code>(pause g)</code></div><div class="doc"><pre class="plaintext">pauses a running flow
 </pre></div></div><div class="public anchor" id="var-pause-proc"><h3>pause-proc</h3><div class="usage"><code>(pause-proc g pid)</code></div><div class="doc"><pre class="plaintext">pauses a process
 </pre></div></div><div class="public anchor" id="var-ping"><h3>ping</h3><div class="usage"><code>(ping g &amp; {:keys [timeout-ms], :or {timeout-ms 1000}})</code></div><div class="doc"><pre class="plaintext">pings all processes, returning a map of pid -&gt; proc status and
 state, for those procs that reply within timeout-ms (default 1000)</pre></div></div><div class="public anchor" id="var-ping-proc"><h3>ping-proc</h3><div class="usage"><code>(ping-proc g pid &amp; {:keys [timeout-ms], :or {timeout-ms 1000}})</code></div><div class="doc"><pre class="plaintext">like ping, but just pings the specified process
-</pre></div></div><div class="public anchor" id="var-process"><h3>process</h3><div class="usage"><code>(process fn-or-map)</code><code>(process fn-or-map {:keys [workload timeout-ms], :or {timeout-ms 5000}, :as opts})</code></div><div class="doc"><pre class="plaintext">Given a function of four arities (0-3), aka the 'step-fn', or a map
-of functions corresponding thereto (described below), returns a
-launcher that creates a process compliant with the process
+</pre></div></div><div class="public anchor" id="var-process"><h3>process</h3><div class="usage"><code>(process step-fn)</code><code>(process step-fn {:keys [workload compute-timeout-ms], :as opts})</code></div><div class="doc"><pre class="plaintext">Given a function of four arities (0-3), aka the 'step-fn',
+returns a launcher that creates a process compliant with the process
 protocol (see the spi/ProcLauncher doc).
 
-The possible arities/entries for the step-fn/map are
+The possible arities for the step-fn are
 
-0 - :describe,
-1 - :init,
-2 - :transition
-3 - :transform.
+0 - 'describe',   () -&gt; description
+1 - 'init',       (arg-map) -&gt; initial-state
+2 - 'transition', (state transition) -&gt; state'
+3 - 'transform',  (state input msg) -&gt; [state' output-map]
 
 This is the core facility for defining the logic for processes via
 ordinary functions. Using a var holding a fn as the 'step-fn' is the
 preferred method for defining a proc, as it enables
 hot-code-reloading of the proc logic in a flow, and better names in
-datafy. You can use the map form to compose the proc logic from
-disparate functions or to leverage the optionality of some of the
-entry points.
+datafy.
 
-arity 0, or :describe - required, () -&gt; description
+arity 0 - 'describe', () -&gt; description
 where description is a map with keys :params :ins and :outs, each of which
 in turn is a map of keyword to doc string, and :workload with
 possible values of :mixed :io :compute. All entries in the describe
@@ -125,14 +132,13 @@
 the proc. It will also be called by the impl in order to discover
 what channels are needed.
 
-arity 1, or :init - optional, (arg-map) -&gt; initial-state
+arity 1 - 'init', (arg-map) -&gt; initial-state
 
-init will be called once by the process to establish any initial
+The init arity will be called once by the process to establish any initial
 state. The arg-map will be a map of param-&gt;val, as supplied in the
 flow def. The key ::flow/pid will be added, mapped to the pid
 associated with the process (useful e.g. if the process wants to
-refer to itself in reply-to coordinates). init must be provided if
-'describe' returns :params.
+refer to itself in reply-to coordinates). 
 
 Optionally, a returned init state may contain the
 keys ::flow/in-ports and/or ::flow/out-ports. These should be maps
@@ -143,26 +149,27 @@
 outside of it. Use :transition to coordinate the lifecycle of these
 external channels.
 
-Optionally, _any_ returned state, whether from :init, :transition
-or :transform, may contain the key ::flow/input-filter, a predicate
+Optionally, _any_ returned state, whether from init, transition
+or transform, may contain the key ::flow/input-filter, a predicate
 of cid. Only inputs (including in-ports) satisfying the predicate
 will be part of the next channel read set. In the absence of this
 predicate all inputs are read.
 
-arity 2, or :transition - optional, (state transition) -&gt; state'
+arity 2 - 'transition', (state transition) -&gt; state'
 
-transition will be called when the process makes a state transition,
-transition being one of ::flow/resume, ::flow/pause or ::flow/stop
+The transition arity will be called when the process makes a state
+transition, transition being one of ::flow/resume, ::flow/pause
+or ::flow/stop
 
-With this fn a process impl can track changes and coordinate
+With this a process impl can track changes and coordinate
 resources, especially cleaning up any resources on :stop, since the
 process will no longer be used following that. See the SPI for
 details. state' will be the state supplied to subsequent calls.
 
-arity 3, or :transform - required, (state in-name msg) -&gt; [state' output]
+arity 3 - 'transform', (state in-name msg) -&gt; [state' output]
 where output is a map of outid-&gt;[msgs*]
 
-The transform fn will be called every time a message arrives at any
+The transform arity will be called every time a message arrives at any
 of the inputs. Output can be sent to none, any or all of the :outs
 enumerated, and/or an input named by a [pid inid] tuple (e.g. for
 reply-to), and/or to the ::flow/report output. A step need not
@@ -170,7 +177,7 @@
 may never be nil (per core.async channels). state' will be the state
 supplied to subsequent calls.
 
-process accepts an option map with keys:
+process also accepts an option map with keys:
 :workload - one of :mixed, :io or :compute
 :compute-timeout-ms - if :workload is :compute, this timeout (default 5000 msec)
               will be used when getting the return from the future - see below
@@ -185,13 +192,13 @@
 
 When :io is specified, transform should not do extensive computation.
 
-When :compute is specified (only allowed for :transform), each call
-to transform will be run in a separate thread. The process loop will
-run in an :io context (since it no longer directly calls transform,
-all it does is I/O) and it will submit transform to the :compute
-executor then await (blocking, for compute-timeout-ms) the
-completion of the future returned by the executor. If the future
-times out it will be reported on ::flow/error.
+When :compute is specified, each call to transform will be run in a
+separate thread. The process loop will run in an :io context (since
+it no longer directly calls transform, all it does is I/O) and it
+will submit transform to the :compute executor then await (blocking,
+for compute-timeout-ms) the completion of the future returned by the
+executor. If the future times out it will be reported
+on ::flow/error.
 
 When :compute is specified transform must not block!</pre></div></div><div class="public anchor" id="var-resume"><h3>resume</h3><div class="usage"><code>(resume g)</code></div><div class="doc"><pre class="plaintext">resumes a paused flow
 </pre></div></div><div class="public anchor" id="var-resume-proc"><h3>resume-proc</h3><div class="usage"><code>(resume-proc g pid)</code></div><div class="doc"><pre class="plaintext">resumes a process
diff --git a/docs/index.html b/docs/index.html
index cb42101..7d96d06 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file

From ceaa94bfe1158d4c2f1013d2bf77309bf81edb17 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Wed, 9 Apr 2025 08:59:47 -0400
Subject: [PATCH 48/73] don't direct connect 1:1 feedback conns

---
 src/main/clojure/clojure/core/async/flow/impl.clj | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/main/clojure/clojure/core/async/flow/impl.clj b/src/main/clojure/clojure/core/async/flow/impl.clj
index eddd439..74fa651 100644
--- a/src/main/clojure/clojure/core/async/flow/impl.clj
+++ b/src/main/clojure/clojure/core/async/flow/impl.clj
@@ -108,18 +108,21 @@
                                    nil))
                                 (async/chan (or buf-or-n 10))))
                   in-chans (zipmap (keys inopts) (map make-chan inopts))
+                  needs-mult? (fn [out ins]
+                                (or (< 1 (count ins))
+                                    (= (first out) (ffirst ins))))
                   out-chans (zipmap (keys outopts)
                                     (map (fn [[coord opts :as co]]
                                            (let [conns (conn-map coord)]
                                              (cond
                                                (empty? conns) nil
+                                               (needs-mult? coord conns) (make-chan co)
                                                ;;direct connect 1:1
-                                               (= 1 (count conns)) (in-chans (first conns))
-                                               :else (make-chan co)))) 
+                                               :else (in-chans (first conns))))) 
                                          outopts))
                   ;;mults
                   _  (doseq [[out ins] conn-map]
-                       (when (< 1 (count ins))
+                       (when (needs-mult? out ins)
                          (let [m (async/mult (out-chans out))]
                            (doseq [in ins]
                              (async/tap m (in-chans in))))))

From a378f3d0190381d33be454673489a8d0a793c664 Mon Sep 17 00:00:00 2001
From: Fogus <fogus@users.noreply.github.com>
Date: Tue, 22 Apr 2025 09:13:10 -0400
Subject: [PATCH 49/73] Create vthreads.yml

---
 .github/workflows/vthreads.yml | 35 ++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 .github/workflows/vthreads.yml

diff --git a/.github/workflows/vthreads.yml b/.github/workflows/vthreads.yml
new file mode 100644
index 0000000..3f1d333
--- /dev/null
+++ b/.github/workflows/vthreads.yml
@@ -0,0 +1,35 @@
+name: Test VThreads
+
+on:
+  workflow_dispatch:
+    inputs:
+      asyncRef:
+        description: "The branch, tag or SHA to checkout"
+        required: true
+        default: 'master'
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        os: [ubuntu-latest] # macOS-latest, windows-latest]
+        java-version: ["8", "11", "17", "21"]
+        clojure-version: ["1.10.3", "1.11.4", "1.12.0"]
+    runs-on: ${{ matrix.os }}
+    steps:
+    - name: Set up Clojure
+      uses: DeLaGuardo/setup-clojure@13.1
+      with:
+          cli: 'latest'    
+    - name: Checkout Clojure Source Code
+      uses: actions/checkout@v4
+      with:
+          ref: ${{ github.event.inputs.asyncRef }}
+    - name: Set up Java
+      uses: actions/setup-java@v4
+      with:
+          java-version: ${{ matrix.java-version }}
+          distribution: 'temurin'
+          cache: 'maven'
+    - name: test with test-runner
+      run: clj -X:dev:test -Sdeps '{:deps {org.clojure/clojure {:mvn/version ${{ matrix.clojure-version }} }}}' :dirs '["src/test/clojure"]'

From 55bb8a8e83c2804fbc726b32a09a1314fc627411 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Wed, 23 Apr 2025 14:23:30 -0500
Subject: [PATCH 50/73] Add rationale page to docs

---
 deps.edn                              |   2 +-
 doc/flow.md                           |   3 +-
 doc/rationale.md                      | 107 ++++++++++++++++++++++++++
 docs/clojure.core.async.flow.html     |   2 +-
 docs/clojure.core.async.flow.spi.html |   2 +-
 docs/clojure.core.async.html          |   2 +-
 docs/flow.html                        |   4 +-
 docs/index.html                       |   2 +-
 docs/rationale.html                   |  67 ++++++++++++++++
 9 files changed, 183 insertions(+), 8 deletions(-)
 create mode 100644 doc/rationale.md
 create mode 100644 docs/rationale.html

diff --git a/deps.edn b/deps.edn
index d0c6031..78e7817 100644
--- a/deps.edn
+++ b/deps.edn
@@ -29,7 +29,7 @@
          :exec-fn codox.main/generate-docs
          :exec-args {:source-paths ["src/main/clojure"]
                      :namespaces [clojure.core.async clojure.core.async.flow clojure.core.async.flow.spi]
-                     :doc-files ["doc/flow.md"]
+                     :doc-files ["doc/rationale.md" "doc/flow.md"] 
                      :output-path "docs"
                      :html {:namespace-list :flat}}}
   }}
diff --git a/doc/flow.md b/doc/flow.md
index 98942a3..9493a21 100644
--- a/doc/flow.md
+++ b/doc/flow.md
@@ -1,7 +1,8 @@
 # core.async.flow
+
 ## Rationale
 
-The [rationale](https://clojure.org/news/2013/06/28/clojure-clore-async-channels) for **core.async** says "There comes a time in all good programs when components or subsystems must stop communicating directly with one another." And core.async provides fundamental tools (channels) for doing that. 
+The [rationale](rationale.html) for **core.async** says "There comes a time in all good programs when components or subsystems must stop communicating directly with one another." And core.async provides fundamental tools (channels) for doing that. 
 
 But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes *emerges* out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.
 
diff --git a/doc/rationale.md b/doc/rationale.md
new file mode 100644
index 0000000..7e11108
--- /dev/null
+++ b/doc/rationale.md
@@ -0,0 +1,107 @@
+# Rationale
+
+*June 28, 2013*
+
+[core.async](https://github.com/clojure/core.async) is a new contrib library for Clojure that adds support for asynchronous programming using channels.
+
+There comes a time in all good programs when components or subsystems must stop communicating directly with one another. This is often achieved via the introduction of queues between the producers of data and the consumers/processors of that data. This architectural indirection ensures that important decisions can be made with some degree of independence, and leads to systems that are easier to understand, manage, monitor and change, and make better use of computational resources, etc.
+
+On the JVM, the [java.util.concurrent](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/package-summary.html) package provides some good concurrent blocking queues, and they are a viable and popular choice for Clojure programs. However, in order to use the queues one must dedicate one or more actual threads to their consumption. Per-thread stack allocation and task-switching overheads limit the number of threads that can be used in practice. Another limitation of j.u.c. queues is there is no way to block waiting on a set of alternatives.
+
+On JavaScript engines, there are no threads and no queues.
+
+Thread overheads or lack of threads often cause people to move to systems based upon events/callbacks, in the pursuit of greater efficiency (often under the misnomer 'scalability', which doesn't apply since you can't scale a single machine). Events complect communication and flow of control. While there are various mechanisms to make events/callbacks cleaner (FRP, Rx/Observables) they don't change their fundamental nature, which is that upon an event an arbitrary amount of other code is run, possibly on the same thread, leading to admonitions such as "don't do too much work in your handler", and phrases like "callback hell".
+
+The objectives of core.async are:
+
+* To provide facilities for independent threads of activity, communicating via queue-like _channels_
+* To support both real threads and shared use of thread pools (in any combination), as well as ClojureScript on JS engines
+* To build upon the work done on CSP and its derivatives
+
+It is our hope that async channels will greatly simplify efficient server-side Clojure programs, and offer simpler and more robust techniques for front-end programming in ClojureScript.
+
+## History
+
+The roots of this style go back at least as far as [Hoare's Communicating Sequential Processes (CSP)](https://en.wikipedia.org/wiki/Communicating_sequential_processes), followed by realizations and extensions in e.g. [occam](https://en.wikipedia.org/wiki/Occam_programming_language), [Java CSP](https://www.cs.kent.ac.uk/projects/ofa/jcsp/) and the [Go programming language](https://golang.org/).
+
+In modern incarnations, the notion of a channel becomes first class, and in doing so provides us the indirection and independence we seek.
+
+A key characteristic of channels is that they are blocking. In the most primitive form, an unbuffered channel acts as a rendezvous, any reader will await a writer and vice-versa. Buffering can be introduced, but unbounded buffering is discouraged, as bounded buffering with blocking can be an important tool coordinating pacing and back pressure, ensuring a system doesn't take on more work than it can achieve.
+
+## Details
+
+### Just a library
+
+*core.async* is a library. It doesn't modify Clojure. It is designed to support Clojure 1.5+.
+
+### Creating channels
+
+You can create a channel with the [chan](https://clojure.github.io/core.async/clojure.core.async.html#var-chan) function. This will return a channel that supports multiple writers and readers. By default, the channel is unbuffered, but you can supply a number to indicate a buffer size, or supply a buffer object created via [buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-buffer), [dropping-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer) or [sliding-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer).
+
+The fundamental operations on channels are putting and taking values. Both of those operations potentially block, but the nature of the blocking depends on the nature of the thread of control in which the operation is performed. core.async supports two kinds of threads of control - ordinary threads and IOC (inversion of control) 'threads'. Ordinary threads can be created in any manner, but IOC threads are created via [go blocks](https://clojure.github.io/core.async/clojure.core.async.html#var-go). Because JS does not have threads, only `go` blocks and IOC threads are supported in ClojureScript.
+
+### go blocks and IOC 'threads'
+
+`go` is a macro that takes its body and examines it for any channel operations. It will turn the body into a state machine. Upon reaching any blocking operation, the state machine will be 'parked' and the actual thread of control will be released. This approach is similar to that used in [C# async](https://msdn.microsoft.com/en-us/library/vstudio/hh191443.aspx). When the blocking operation completes, the code will be resumed (on a thread-pool thread, or the sole thread in a JS VM). In this way the inversion of control that normally leaks into the program itself with event/callback systems is encapsulated by the mechanism, and you are left with straightforward sequential code. It will also provide the illusion of threads, and more important, separable sequential subsystems, to ClojureScript.
+
+The primary channel operations within go blocks are [>!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21) (_put_) and [<!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21) (_take_). The go block itself immediately returns a channel, on which it will eventually put the value of the last expression of the body (if non-nil), and then close.
+
+### Channel on ordinary threads
+
+There are analogous operations for use on ordinary threads - [>!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21) (_put blocking_) and [<!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21) (_take blocking_), which will block the thread on which they are called, until complete. While you can use these operations on threads created with e.g. future, there is also a macro, [thread](https://clojure.github.io/core.async/clojure.core.async.html#var-thread), analogous to `go`, that will launch a first-class thread and similarly return a channel, and should be preferred over `future` for channel work.
+
+### Mixing modes
+
+You can put on a channel from either flavor of `>!`/`>!!` and similarly take with either of `<!`/`<!!` in any combination, i.e. the channel is oblivious to the nature of the threads which use it.
+
+### alt
+
+It is often desirable to be able to wait for any one (and only one) of a set of channel operations to complete. This powerful facility is made available through the [alts!](https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21) function (for use in `go` blocks), and the analogous [alts!!](https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21.21) (_alts blocking_). If more than one operation is available to complete, one can be chosen at random or by priority (i.e. in the order they are supplied). There are corresponding [alt!](https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21) and [alt!!](https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21.21) macros that combine the choice with conditional evaluation of expressions.
+
+### Timeouts
+
+Timeouts are just channels that automatically close after a period of time. You can create one with the [timeout](https://clojure.github.io/core.async/clojure.core.async.html#var-timeout) function, then just include the timeout in an `alt` variant. A nice aspect of this is that timeouts can be shared between threads of control, e.g. in order to have a set of activities share a bound.
+
+### The value of values
+
+As with STM, the pervasive use of persistent data structures offers particular benefits for CSP-style channels. In particular, it is always safe and efficient to put a Clojure data structure on a channel, without fear of its subsequent use by either the producer or consumer.
+
+### Contrasting Go language channels
+
+core.async has obvious similarities to Go channels. Some differences with Go are:
+
+* All of the operations are expressions (not statements)
+* This is a library, not syntax
+* `alts!` is a function (and supports a runtime-variable number of operations)
+* Priority is supported in `alt`
+
+Finally, Clojure is hosted, i.e. we are bringing these facilities to existing platforms, not needing a custom runtime. The flip-side is we don't have the underpinnings we would with a custom runtime. Reaching existing platforms remains a core Clojure value proposition.
+
+### Whither actors?
+
+I remain unenthusiastic about actors. They still couple the producer with the consumer. Yes, one can emulate or implement certain kinds of queues with actors (and, notably, people often do), but since any actor mechanism already incorporates a queue, it seems evident that queues are more primitive. It should be noted that Clojure's mechanisms for concurrent use of state remain viable, and channels are oriented towards the flow aspects of a system.
+
+### Deadlocks
+
+Note that, unlike other Clojure concurrency constructs, channels, like all communications, are subject to deadlocks, the simplest being waiting for a message that will never arrive, which must be dealt with manually via timeouts etc. CSP proper is amenable to certain kinds of automated correctness analysis. No work has been done on that front for core.async as yet.
+
+Also note that async channels are not intended for fine-grained computational parallelism, though you might see examples in that vein.
+
+## Future directions
+
+Networks channels and distribution are interesting areas for attention. We will also being doing performance tuning and refining the APIs.
+
+### Team
+
+I'd like to thank the original team that helped bring core.async to life:
+
+* Timothy Baldridge
+* Ghadi Shayban
+* Alex Miller
+* Alex Redington
+* Sam Umbach
+
+I hope that these async channels will help you build simpler and more robust programs.
+
+Rich
+
diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 9329264..89b0872 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
diff --git a/docs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
index d50b0d7..2430b58 100644
--- a/docs/clojure.core.async.flow.spi.html
+++ b/docs/clojure.core.async.flow.spi.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
 be needed for ordinary use of the library. This protocol is for
 creating new types of Processes that are not possible to create
 with ::flow/process.
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index ac94cc4..d9e9da9 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 Set Java system property `clojure.core.async.go-checking` to true
 to validate go blocks do not invoke core.async blocking operations.
diff --git a/docs/flow.html b/docs/flow.html
index b0d4a29..60bd7ca 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -1,8 +1,8 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>core.async.flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
+<html><head><meta charset="UTF-8" /><title>core.async.flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
-<p>The <a href="https://clojure.org/news/2013/06/28/clojure-clore-async-channels">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
+<p>The <a href="rationale.html">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
 <p>The fundamental objective of <strong>core.async.flow</strong> is to enable a strict separation of your application logic from its topology, execution, communication, lifecycle, monitoring and error handling, all of which are provided by and centralized in, c.a.flow, yielding more consistent, robust, testable, observable and operable systems.</p>
 <h2><a href="#overview" id="overview"></a>Overview</h2>
diff --git a/docs/index.html b/docs/index.html
index 7d96d06..358d8bc 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
diff --git a/docs/rationale.html b/docs/rationale.html
new file mode 100644
index 0000000..c8d380f
--- /dev/null
+++ b/docs/rationale.html
@@ -0,0 +1,67 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
+<p><em>June 28, 2013</em></p>
+<p><a href="https://github.com/clojure/core.async">core.async</a> is a new contrib library for Clojure that adds support for asynchronous programming using channels.</p>
+<p>There comes a time in all good programs when components or subsystems must stop communicating directly with one another. This is often achieved via the introduction of queues between the producers of data and the consumers/processors of that data. This architectural indirection ensures that important decisions can be made with some degree of independence, and leads to systems that are easier to understand, manage, monitor and change, and make better use of computational resources, etc.</p>
+<p>On the JVM, the <a href="https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/package-summary.html">java.util.concurrent</a> package provides some good concurrent blocking queues, and they are a viable and popular choice for Clojure programs. However, in order to use the queues one must dedicate one or more actual threads to their consumption. Per-thread stack allocation and task-switching overheads limit the number of threads that can be used in practice. Another limitation of j.u.c. queues is there is no way to block waiting on a set of alternatives.</p>
+<p>On JavaScript engines, there are no threads and no queues.</p>
+<p>Thread overheads or lack of threads often cause people to move to systems based upon events/callbacks, in the pursuit of greater efficiency (often under the misnomer ‘scalability’, which doesn’t apply since you can’t scale a single machine). Events complect communication and flow of control. While there are various mechanisms to make events/callbacks cleaner (FRP, Rx/Observables) they don’t change their fundamental nature, which is that upon an event an arbitrary amount of other code is run, possibly on the same thread, leading to admonitions such as “don’t do too much work in your handler”, and phrases like “callback hell”.</p>
+<p>The objectives of core.async are:</p>
+<ul>
+<li>To provide facilities for independent threads of activity, communicating via queue-like <em>channels</em></li>
+<li>To support both real threads and shared use of thread pools (in any combination), as well as ClojureScript on JS engines</li>
+<li>To build upon the work done on CSP and its derivatives</li>
+</ul>
+<p>It is our hope that async channels will greatly simplify efficient server-side Clojure programs, and offer simpler and more robust techniques for front-end programming in ClojureScript.</p>
+<h2><a href="#history" id="history"></a>History</h2>
+<p>The roots of this style go back at least as far as <a href="https://en.wikipedia.org/wiki/Communicating_sequential_processes">Hoare’s Communicating Sequential Processes (CSP)</a>, followed by realizations and extensions in e.g. <a href="https://en.wikipedia.org/wiki/Occam_programming_language">occam</a>, <a href="https://www.cs.kent.ac.uk/projects/ofa/jcsp/">Java CSP</a> and the <a href="https://golang.org/">Go programming language</a>.</p>
+<p>In modern incarnations, the notion of a channel becomes first class, and in doing so provides us the indirection and independence we seek.</p>
+<p>A key characteristic of channels is that they are blocking. In the most primitive form, an unbuffered channel acts as a rendezvous, any reader will await a writer and vice-versa. Buffering can be introduced, but unbounded buffering is discouraged, as bounded buffering with blocking can be an important tool coordinating pacing and back pressure, ensuring a system doesn’t take on more work than it can achieve.</p>
+<h2><a href="#details" id="details"></a>Details</h2>
+<h3><a href="#just-a-library" id="just-a-library"></a>Just a library</h3>
+<p><em>core.async</em> is a library. It doesn’t modify Clojure. It is designed to support Clojure 1.5+.</p>
+<h3><a href="#creating-channels" id="creating-channels"></a>Creating channels</h3>
+<p>You can create a channel with the <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-chan">chan</a> function. This will return a channel that supports multiple writers and readers. By default, the channel is unbuffered, but you can supply a number to indicate a buffer size, or supply a buffer object created via <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-buffer">buffer</a>, <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> or <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer">sliding-buffer</a>.</p>
+<p>The fundamental operations on channels are putting and taking values. Both of those operations potentially block, but the nature of the blocking depends on the nature of the thread of control in which the operation is performed. core.async supports two kinds of threads of control - ordinary threads and IOC (inversion of control) ‘threads’. Ordinary threads can be created in any manner, but IOC threads are created via <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-go">go blocks</a>. Because JS does not have threads, only <code>go</code> blocks and IOC threads are supported in ClojureScript.</p>
+<h3><a href="#go-blocks-and-ioc-threads" id="go-blocks-and-ioc-threads"></a>go blocks and IOC ‘threads’</h3>
+<p><code>go</code> is a macro that takes its body and examines it for any channel operations. It will turn the body into a state machine. Upon reaching any blocking operation, the state machine will be ‘parked’ and the actual thread of control will be released. This approach is similar to that used in <a href="https://msdn.microsoft.com/en-us/library/vstudio/hh191443.aspx">C# async</a>. When the blocking operation completes, the code will be resumed (on a thread-pool thread, or the sole thread in a JS VM). In this way the inversion of control that normally leaks into the program itself with event/callback systems is encapsulated by the mechanism, and you are left with straightforward sequential code. It will also provide the illusion of threads, and more important, separable sequential subsystems, to ClojureScript.</p>
+<p>The primary channel operations within go blocks are <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21">&gt;!</a> (<em>put</em>) and <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21">&lt;!</a> (<em>take</em>). The go block itself immediately returns a channel, on which it will eventually put the value of the last expression of the body (if non-nil), and then close.</p>
+<h3><a href="#channel-on-ordinary-threads" id="channel-on-ordinary-threads"></a>Channel on ordinary threads</h3>
+<p>There are analogous operations for use on ordinary threads - <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21">&gt;!!</a> (<em>put blocking</em>) and <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21">&lt;!!</a> (<em>take blocking</em>), which will block the thread on which they are called, until complete. While you can use these operations on threads created with e.g. future, there is also a macro, <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-thread">thread</a>, analogous to <code>go</code>, that will launch a first-class thread and similarly return a channel, and should be preferred over <code>future</code> for channel work.</p>
+<h3><a href="#mixing-modes" id="mixing-modes"></a>Mixing modes</h3>
+<p>You can put on a channel from either flavor of <code>&gt;!</code>/<code>&gt;!!</code> and similarly take with either of <code>&lt;!</code>/<code>&lt;!!</code> in any combination, i.e. the channel is oblivious to the nature of the threads which use it.</p>
+<h3><a href="#alt" id="alt"></a>alt</h3>
+<p>It is often desirable to be able to wait for any one (and only one) of a set of channel operations to complete. This powerful facility is made available through the <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21">alts!</a> function (for use in <code>go</code> blocks), and the analogous <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21.21">alts!!</a> (<em>alts blocking</em>). If more than one operation is available to complete, one can be chosen at random or by priority (i.e. in the order they are supplied). There are corresponding <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21">alt!</a> and <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21.21">alt!!</a> macros that combine the choice with conditional evaluation of expressions.</p>
+<h3><a href="#timeouts" id="timeouts"></a>Timeouts</h3>
+<p>Timeouts are just channels that automatically close after a period of time. You can create one with the <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-timeout">timeout</a> function, then just include the timeout in an <code>alt</code> variant. A nice aspect of this is that timeouts can be shared between threads of control, e.g. in order to have a set of activities share a bound.</p>
+<h3><a href="#the-value-of-values" id="the-value-of-values"></a>The value of values</h3>
+<p>As with STM, the pervasive use of persistent data structures offers particular benefits for CSP-style channels. In particular, it is always safe and efficient to put a Clojure data structure on a channel, without fear of its subsequent use by either the producer or consumer.</p>
+<h3><a href="#contrasting-go-language-channels" id="contrasting-go-language-channels"></a>Contrasting Go language channels</h3>
+<p>core.async has obvious similarities to Go channels. Some differences with Go are:</p>
+<ul>
+<li>All of the operations are expressions (not statements)</li>
+<li>This is a library, not syntax</li>
+<li><code>alts!</code> is a function (and supports a runtime-variable number of operations)</li>
+<li>Priority is supported in <code>alt</code></li>
+</ul>
+<p>Finally, Clojure is hosted, i.e. we are bringing these facilities to existing platforms, not needing a custom runtime. The flip-side is we don’t have the underpinnings we would with a custom runtime. Reaching existing platforms remains a core Clojure value proposition.</p>
+<h3><a href="#whither-actors" id="whither-actors"></a>Whither actors?</h3>
+<p>I remain unenthusiastic about actors. They still couple the producer with the consumer. Yes, one can emulate or implement certain kinds of queues with actors (and, notably, people often do), but since any actor mechanism already incorporates a queue, it seems evident that queues are more primitive. It should be noted that Clojure’s mechanisms for concurrent use of state remain viable, and channels are oriented towards the flow aspects of a system.</p>
+<h3><a href="#deadlocks" id="deadlocks"></a>Deadlocks</h3>
+<p>Note that, unlike other Clojure concurrency constructs, channels, like all communications, are subject to deadlocks, the simplest being waiting for a message that will never arrive, which must be dealt with manually via timeouts etc. CSP proper is amenable to certain kinds of automated correctness analysis. No work has been done on that front for core.async as yet.</p>
+<p>Also note that async channels are not intended for fine-grained computational parallelism, though you might see examples in that vein.</p>
+<h2><a href="#future-directions" id="future-directions"></a>Future directions</h2>
+<p>Networks channels and distribution are interesting areas for attention. We will also being doing performance tuning and refining the APIs.</p>
+<h3><a href="#team" id="team"></a>Team</h3>
+<p>I’d like to thank the original team that helped bring core.async to life:</p>
+<ul>
+<li>Timothy Baldridge</li>
+<li>Ghadi Shayban</li>
+<li>Alex Miller</li>
+<li>Alex Redington</li>
+<li>Sam Umbach</li>
+</ul>
+<p>I hope that these async channels will help you build simpler and more robust programs.</p>
+<p>Rich</p>
+</div></div></div></body></html>
\ No newline at end of file

From efce617ed841df738dd230494c846a0b87936478 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Wed, 23 Apr 2025 14:25:20 -0500
Subject: [PATCH 51/73] reorder readme

---
 README.md | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index a678a37..2044a17 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,17 @@
 
 A Clojure library providing facilities for async programming and communication.
 
+## Documentation
+
+* [Rationale](https://clojure.github.io/core.async/rationale.html)
+* [API docs](https://clojure.github.io/core.async/)
+* [Code walkthrough](https://github.com/clojure/core.async/blob/master/examples/walkthrough.clj)
+
+## Presentations
+
+* [Rich Hickey on core.async](https://www.youtube.com/watch?v=yJxFPoxqzWE)
+* [Tim Baldridge on core.async](https://www.youtube.com/watch?v=enwIIGzhahw) from Clojure/conj 2013 ([code](https://github.com/halgari/clojure-conj-2013-core.async-examples)).
+* Tim Baldridge on go macro internals - [part 1](https://www.youtube.com/watch?v=R3PZMIwXN_g) [part 2](https://www.youtube.com/watch?v=SI7qtuuahhU)
 
 ## Releases and Dependency Information
 
@@ -33,18 +44,6 @@ Latest release: 1.8.741
 </dependency>
 ```
 
-## Documentation
-
-* [Rationale](https://clojure.org/news/2013/06/28/clojure-clore-async-channels)
-* [API docs](https://clojure.github.io/core.async/)
-* [Code walkthrough](https://github.com/clojure/core.async/blob/master/examples/walkthrough.clj)
-
-## Presentations
-
-* [Rich Hickey on core.async](https://www.youtube.com/watch?v=yJxFPoxqzWE)
-* [Tim Baldridge on core.async](https://www.youtube.com/watch?v=enwIIGzhahw) from Clojure/conj 2013 ([code](https://github.com/halgari/clojure-conj-2013-core.async-examples)).
-* Tim Baldridge on go macro internals - [part 1](https://www.youtube.com/watch?v=R3PZMIwXN_g) [part 2](https://www.youtube.com/watch?v=SI7qtuuahhU)
-
 ## Contributing 
 
 [Contributing to Clojure projects](https://clojure.org/community/contributing) requires a signed Contributor Agreement. Pull requests and GitHub issues are not accepted; please use the [core.async JIRA project](https://clojure.atlassian.net/browse/ASYNC) to report problems or enhancements.

From 20c4354edba87549aceb834ce89e36c73d8a80fa Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Wed, 23 Apr 2025 15:21:32 -0500
Subject: [PATCH 52/73] update version template

---
 VERSION_TEMPLATE | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/VERSION_TEMPLATE b/VERSION_TEMPLATE
index c01b2c0..879be46 100755
--- a/VERSION_TEMPLATE
+++ b/VERSION_TEMPLATE
@@ -1 +1 @@
-1.8.GENERATED_VERSION
+1.9.GENERATED_VERSION-alpha1

From a38f938db954622232e4f42ba53b1158037da573 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Thu, 24 Apr 2025 09:24:45 -0500
Subject: [PATCH 53/73] remove unused doc file

---
 doc/intro.md | 2 --
 1 file changed, 2 deletions(-)
 delete mode 100644 doc/intro.md

diff --git a/doc/intro.md b/doc/intro.md
deleted file mode 100644
index 3bccf64..0000000
--- a/doc/intro.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# Introduction to core.async
-

From a19205ab5368b706692ca557ecd0e24534218cb1 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 25 Apr 2025 13:16:21 -0500
Subject: [PATCH 54/73] add image

---
 doc/flow.md               |   4 +++-
 doc/img/flow-concerns.png | Bin 0 -> 202575 bytes
 docs/flow.html            |   3 ++-
 3 files changed, 5 insertions(+), 2 deletions(-)
 create mode 100644 doc/img/flow-concerns.png

diff --git a/doc/flow.md b/doc/flow.md
index 9493a21..b2550f8 100644
--- a/doc/flow.md
+++ b/doc/flow.md
@@ -12,12 +12,14 @@ The fundamental objective of __core.async.flow__ is to enable a strict separatio
 
 __core.async.flow__ provides *concrete* implementations of two more abstractions - the '__process__' - a thread of activity, and the '__flow__' - a directed graph of processes communicating via channels. A single data structure describes your flow topology, and has all of the settings for threads, channels etc. A process accepts data from and provides data to channels. The process implementation in c.a.flow handles all channel I/O, thread lifecycle and coordination with the flow graph.
 
-All you need to do in you application is:
+All you need to do in your application is:
 
 1. Define ordinary, often pure, data->data functions that the processes will run in their inner loop to do the *computational* part of processing messages. These functions do not handle channels or threads or lifecycle, and do not even know they are running in a flow. They can be tested in isolation, and hot-reloaded. If they encounter a problem they can, and should, just throw an exception. The process will take care of it from there.
 
 2. Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.
 
+![core.async.flow concerns](https://github.com/clojure/core.async/blob/master/doc/img/flow-concerns.png?raw=true)
+
 With these application inputs, c.a.flow does the rest. It inquires of the processes what channels they require, creates those channels, then instantiates the processes making all of the channel connections between them. The processes in turn start threads (in fully user-configurable thread pools), await inputs, monitor the admin control channel, and when inputs arrive make data->data calls to your application logic, taking the return from that and sending it to the designated output channels. The processes follow a protocol used by the flow to do lifecycle management and error handling.
 
 Once you've created a flow, the API provides functions to start/stop(shutdown) the flow, and to pause/resume both the flow and individual processes, to ping processes to get their state and that of their connected channels, to inject data into any point in the graph etc. The flow provides channels containing the ordinary monitoring/reporting stream and, separately, the error stream. 
diff --git a/doc/img/flow-concerns.png b/doc/img/flow-concerns.png
new file mode 100644
index 0000000000000000000000000000000000000000..d3fcbf8f41714ef6c7411ac9c8cef40b53e551c0
GIT binary patch
literal 202575
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%0D?h9)5C;5zF^G??mKYSJ|eo@7U!%$_-l;
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

literal 0
HcmV?d00001

diff --git a/docs/flow.html b/docs/flow.html
index 60bd7ca..cfd4db9 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -7,7 +7,7 @@ <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
 <p>The fundamental objective of <strong>core.async.flow</strong> is to enable a strict separation of your application logic from its topology, execution, communication, lifecycle, monitoring and error handling, all of which are provided by and centralized in, c.a.flow, yielding more consistent, robust, testable, observable and operable systems.</p>
 <h2><a href="#overview" id="overview"></a>Overview</h2>
 <p><strong>core.async.flow</strong> provides <em>concrete</em> implementations of two more abstractions - the ‘<strong>process</strong>’ - a thread of activity, and the ‘<strong>flow</strong>’ - a directed graph of processes communicating via channels. A single data structure describes your flow topology, and has all of the settings for threads, channels etc. A process accepts data from and provides data to channels. The process implementation in c.a.flow handles all channel I/O, thread lifecycle and coordination with the flow graph.</p>
-<p>All you need to do in you application is:</p>
+<p>All you need to do in your application is:</p>
 <ol>
 <li>
 <p>Define ordinary, often pure, data-&gt;data functions that the processes will run in their inner loop to do the <em>computational</em> part of processing messages. These functions do not handle channels or threads or lifecycle, and do not even know they are running in a flow. They can be tested in isolation, and hot-reloaded. If they encounter a problem they can, and should, just throw an exception. The process will take care of it from there.</p>
@@ -16,6 +16,7 @@ <h2><a href="#overview" id="overview"></a>Overview</h2>
 <p>Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.</p>
 </li>
 </ol>
+<p><img src="https://github.com/clojure/core.async/blob/master/doc/img/flow-concerns.png?raw=true" alt="core.async.flow concerns" /></p>
 <p>With these application inputs, c.a.flow does the rest. It inquires of the processes what channels they require, creates those channels, then instantiates the processes making all of the channel connections between them. The processes in turn start threads (in fully user-configurable thread pools), await inputs, monitor the admin control channel, and when inputs arrive make data-&gt;data calls to your application logic, taking the return from that and sending it to the designated output channels. The processes follow a protocol used by the flow to do lifecycle management and error handling.</p>
 <p>Once you’ve created a flow, the API provides functions to start/stop(shutdown) the flow, and to pause/resume both the flow and individual processes, to ping processes to get their state and that of their connected channels, to inject data into any point in the graph etc. The flow provides channels containing the ordinary monitoring/reporting stream and, separately, the error stream.</p>
 <p>The library provides many more details and features, including the ability to create, via ordinary functions, processes that act as <strong>sources</strong> (of data from outside the flow) or <strong>sinks</strong> (to recipients outside the flow) so you can situate your flow in a broader context while still coordinating resource management with the flow lifecycle.</p>

From 657c9e36874aec1c711a9f33b8806f2f94460602 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 25 Apr 2025 13:25:58 -0500
Subject: [PATCH 55/73] update image

---
 doc/flow.md               |   2 +-
 doc/img/flow-concerns.png | Bin 202575 -> 216671 bytes
 docs/flow.html            |   2 +-
 3 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/flow.md b/doc/flow.md
index b2550f8..c04b6a4 100644
--- a/doc/flow.md
+++ b/doc/flow.md
@@ -18,7 +18,7 @@ All you need to do in your application is:
 
 2. Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.
 
-![core.async.flow concerns](https://github.com/clojure/core.async/blob/master/doc/img/flow-concerns.png?raw=true)
+<a href="https://github.com/clojure/core.async/blob/master/doc/img/flow-concerns.png?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/flow-concerns.png?raw=true" alt="core.async.flow concerns" width="700"/></a>
 
 With these application inputs, c.a.flow does the rest. It inquires of the processes what channels they require, creates those channels, then instantiates the processes making all of the channel connections between them. The processes in turn start threads (in fully user-configurable thread pools), await inputs, monitor the admin control channel, and when inputs arrive make data->data calls to your application logic, taking the return from that and sending it to the designated output channels. The processes follow a protocol used by the flow to do lifecycle management and error handling.
 
diff --git a/doc/img/flow-concerns.png b/doc/img/flow-concerns.png
index d3fcbf8f41714ef6c7411ac9c8cef40b53e551c0..46bcdb33e9d683e03aaafb0ed359680a9c665ff1 100644
GIT binary patch
literal 216671
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

literal 202575
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%0D?h9)5C;5zF^G??mKYSJ|eo@7U!%$_-l;
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

diff --git a/docs/flow.html b/docs/flow.html
index cfd4db9..42a8ddc 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -16,7 +16,7 @@ <h2><a href="#overview" id="overview"></a>Overview</h2>
 <p>Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.</p>
 </li>
 </ol>
-<p><img src="https://github.com/clojure/core.async/blob/master/doc/img/flow-concerns.png?raw=true" alt="core.async.flow concerns" /></p>
+<p><a href="https://github.com/clojure/core.async/blob/master/doc/img/flow-concerns.png?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/flow-concerns.png?raw=true" alt="core.async.flow concerns" width="700" /></a></p>
 <p>With these application inputs, c.a.flow does the rest. It inquires of the processes what channels they require, creates those channels, then instantiates the processes making all of the channel connections between them. The processes in turn start threads (in fully user-configurable thread pools), await inputs, monitor the admin control channel, and when inputs arrive make data-&gt;data calls to your application logic, taking the return from that and sending it to the designated output channels. The processes follow a protocol used by the flow to do lifecycle management and error handling.</p>
 <p>Once you’ve created a flow, the API provides functions to start/stop(shutdown) the flow, and to pause/resume both the flow and individual processes, to ping processes to get their state and that of their connected channels, to inject data into any point in the graph etc. The flow provides channels containing the ordinary monitoring/reporting stream and, separately, the error stream.</p>
 <p>The library provides many more details and features, including the ability to create, via ordinary functions, processes that act as <strong>sources</strong> (of data from outside the flow) or <strong>sinks</strong> (to recipients outside the flow) so you can situate your flow in a broader context while still coordinating resource management with the flow lifecycle.</p>

From 8555042ead54a3ab8fe176e2d669f9ea34394a63 Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Mon, 28 Apr 2025 14:19:32 +0000
Subject: [PATCH 56/73] [maven-release-plugin] prepare release v1.9.808-alpha1

---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index 06d9a11..a9bc644 100644
--- a/pom.xml
+++ b/pom.xml
@@ -3,7 +3,7 @@
   <groupId>org.clojure</groupId>
   <artifactId>core.async</artifactId>
   <!-- Don't set this manually! Call script/build/update_version -->
-  <version>1.8.742-SNAPSHOT</version>
+  <version>1.9.808-alpha1</version>
   <packaging>jar</packaging>
   <name>core.async</name>
   <description>Facilities for async programming and communication in Clojure</description>
@@ -27,7 +27,7 @@
     <connection>scm:git:git://github.com/clojure/core.async.git</connection>
     <developerConnection>scm:git:git@github.com:clojure/core.async.git</developerConnection>
     <url>https://github.com/clojure/core.async</url>
-    <tag>HEAD</tag>
+    <tag>v1.9.808-alpha1</tag>
   </scm>
 
   <properties>

From 01864073899c5264393bd139e73ee517925ce15a Mon Sep 17 00:00:00 2001
From: clojure-build <clojure-build@users.noreply.github.com>
Date: Mon, 28 Apr 2025 14:19:32 +0000
Subject: [PATCH 57/73] [maven-release-plugin] prepare for next development
 iteration

---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index a9bc644..5ab7ec0 100644
--- a/pom.xml
+++ b/pom.xml
@@ -3,7 +3,7 @@
   <groupId>org.clojure</groupId>
   <artifactId>core.async</artifactId>
   <!-- Don't set this manually! Call script/build/update_version -->
-  <version>1.9.808-alpha1</version>
+  <version>1.9.809-SNAPSHOT</version>
   <packaging>jar</packaging>
   <name>core.async</name>
   <description>Facilities for async programming and communication in Clojure</description>
@@ -27,7 +27,7 @@
     <connection>scm:git:git://github.com/clojure/core.async.git</connection>
     <developerConnection>scm:git:git@github.com:clojure/core.async.git</developerConnection>
     <url>https://github.com/clojure/core.async</url>
-    <tag>v1.9.808-alpha1</tag>
+    <tag>HEAD</tag>
   </scm>
 
   <properties>

From 82f823b61b2ea06b659c2dc81529a64ea1cb4fdc Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Mon, 28 Apr 2025 10:30:53 -0500
Subject: [PATCH 58/73] update for release

---
 README.md        | 3 +++
 VERSION_TEMPLATE | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2044a17..5c69ad1 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,9 @@ Copyright © Rich Hickey and contributors
 
 ## Changelog
 
+* Release 1.9.808-alpha1 on 2025-04-28
+  * First alpha release of core.async.flow - all APIs subject to change
+  * Added datafy support for channels and buffers
 * Release 1.8.741 on 2025-04-07
   * [ASYNC-234](https://clojure.atlassian.net/browse/ASYNC-234) (CLJ) Inactive alt handlers hold strong references to (potentially large) caller state after the alt completes
 * Release 1.8.735 on 2025.04.02
diff --git a/VERSION_TEMPLATE b/VERSION_TEMPLATE
index 879be46..59b13e5 100755
--- a/VERSION_TEMPLATE
+++ b/VERSION_TEMPLATE
@@ -1 +1 @@
-1.9.GENERATED_VERSION-alpha1
+1.9.GENERATED_VERSION-alpha2

From 17e1193c6dd53e88cb083cfc0c7db0e3bb944283 Mon Sep 17 00:00:00 2001
From: Rich Hickey <richhickey@gmail.com>
Date: Tue, 29 Apr 2025 11:38:55 -0400
Subject: [PATCH 59/73] added 'step' to description of process callees

---
 doc/flow.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/flow.md b/doc/flow.md
index c04b6a4..4b388a8 100644
--- a/doc/flow.md
+++ b/doc/flow.md
@@ -14,7 +14,7 @@ __core.async.flow__ provides *concrete* implementations of two more abstractions
 
 All you need to do in your application is:
 
-1. Define ordinary, often pure, data->data functions that the processes will run in their inner loop to do the *computational* part of processing messages. These functions do not handle channels or threads or lifecycle, and do not even know they are running in a flow. They can be tested in isolation, and hot-reloaded. If they encounter a problem they can, and should, just throw an exception. The process will take care of it from there.
+1. Define ordinary, often pure, data->data functions that the processes will run in their inner loop to do the *computational* part of processing messages (aka 'step' functions). These functions do not handle channels or threads or lifecycle, and do not even know they are running in a flow. They can be tested in isolation, and hot-reloaded. If they encounter a problem they can, and should, just throw an exception. The process will take care of it from there.
 
 2. Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.
 

From d3b05bd4e3e1e2722adbd2e7ca85116a668980af Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Wed, 30 Apr 2025 21:46:08 -0500
Subject: [PATCH 60/73] doc link fix

---
 doc/flow.md    | 2 +-
 docs/flow.html | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/flow.md b/doc/flow.md
index 4b388a8..3c8eb1b 100644
--- a/doc/flow.md
+++ b/doc/flow.md
@@ -2,7 +2,7 @@
 
 ## Rationale
 
-The [rationale](rationale.html) for **core.async** says "There comes a time in all good programs when components or subsystems must stop communicating directly with one another." And core.async provides fundamental tools (channels) for doing that. 
+The [rationale](https://clojure.github.io/core.async/rationale.html) for **core.async** says "There comes a time in all good programs when components or subsystems must stop communicating directly with one another." And core.async provides fundamental tools (channels) for doing that.
 
 But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes *emerges* out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.
 
diff --git a/docs/flow.html b/docs/flow.html
index 42a8ddc..d4687e8 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -2,7 +2,7 @@
     "">
 <html><head><meta charset="UTF-8" /><title>core.async.flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
-<p>The <a href="rationale.html">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
+<p>The <a href="https://clojure.github.io/core.async/rationale.html">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
 <p>The fundamental objective of <strong>core.async.flow</strong> is to enable a strict separation of your application logic from its topology, execution, communication, lifecycle, monitoring and error handling, all of which are provided by and centralized in, c.a.flow, yielding more consistent, robust, testable, observable and operable systems.</p>
 <h2><a href="#overview" id="overview"></a>Overview</h2>
@@ -10,7 +10,7 @@ <h2><a href="#overview" id="overview"></a>Overview</h2>
 <p>All you need to do in your application is:</p>
 <ol>
 <li>
-<p>Define ordinary, often pure, data-&gt;data functions that the processes will run in their inner loop to do the <em>computational</em> part of processing messages. These functions do not handle channels or threads or lifecycle, and do not even know they are running in a flow. They can be tested in isolation, and hot-reloaded. If they encounter a problem they can, and should, just throw an exception. The process will take care of it from there.</p>
+<p>Define ordinary, often pure, data-&gt;data functions that the processes will run in their inner loop to do the <em>computational</em> part of processing messages (aka ‘step’ functions). These functions do not handle channels or threads or lifecycle, and do not even know they are running in a flow. They can be tested in isolation, and hot-reloaded. If they encounter a problem they can, and should, just throw an exception. The process will take care of it from there.</p>
 </li>
 <li>
 <p>Define a flow by creating a data structure that enumerates the processes and the connections between their inputs and outputs, as well as various configuration settings for both.</p>

From 3f7882a7f85d6e9df7ec9cd9fe0d744f39b2d75d Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Thu, 1 May 2025 12:53:03 -0500
Subject: [PATCH 61/73] add reference

---
 deps.edn                              |   2 +-
 doc/async-reference.md                | 132 ++++++++++++++++++++++++++
 doc/flow.md                           |   2 +-
 doc/reference.md                      | 132 ++++++++++++++++++++++++++
 docs/clojure.core.async.flow.html     |   2 +-
 docs/clojure.core.async.flow.spi.html |   2 +-
 docs/clojure.core.async.html          |   2 +-
 docs/flow.html                        |   2 +-
 docs/index.html                       |   2 +-
 docs/rationale.html                   |   2 +-
 docs/reference.html                   | 106 +++++++++++++++++++++
 11 files changed, 378 insertions(+), 8 deletions(-)
 create mode 100644 doc/async-reference.md
 create mode 100644 doc/reference.md
 create mode 100644 docs/reference.html

diff --git a/deps.edn b/deps.edn
index 78e7817..5ede84b 100644
--- a/deps.edn
+++ b/deps.edn
@@ -29,7 +29,7 @@
          :exec-fn codox.main/generate-docs
          :exec-args {:source-paths ["src/main/clojure"]
                      :namespaces [clojure.core.async clojure.core.async.flow clojure.core.async.flow.spi]
-                     :doc-files ["doc/rationale.md" "doc/flow.md"] 
+                     :doc-files ["doc/rationale.md" "doc/reference.md" "doc/flow.md"] 
                      :output-path "docs"
                      :html {:namespace-list :flat}}}
   }}
diff --git a/doc/async-reference.md b/doc/async-reference.md
new file mode 100644
index 0000000..7f5c7ba
--- /dev/null
+++ b/doc/async-reference.md
@@ -0,0 +1,132 @@
+# API Reference
+
+## Channels
+
+Channels are queues that carry values and support multiple writers and readers. Channels are created with [chan](https://clojure.github.io/core.async/clojure.core.async.html#var-chan). Values in a channel are stored in a buffer. Buffers are never unbounded and there are several provided buffer types:
+
+* Unbuffered - `(chan)` - no buffer is used, and a rendezvous is required to pass a value through the channel from writer to reader
+* Fixed size - `(chan 10)`
+* Dropping - `(chan (dropping-buffer 10))` - fixed size, and when full drop newest value
+* Sliding - `(chan (sliding-buffer 10))` - fixed size, and when full drop oldest value
+
+Channels are first-class values that can be passed around like any other value.
+
+Channels may optionally be supplied with a [transducer](https://clojure.org/reference/transducers) and an exception handler. The transducer will be applied to values that pass through the channel. If a transducer is supplied, the channel *must* be buffered (transducers can create intermediate values that must be stored somewhere). Channel transducers must not block, whether by issuing i/o operations or by externally synchronizing, else risk impeding or deadlocking go blocks.
+
+The `ex-handler` is a function of one argument (a Throwable). If an exception occurs while applying the transducer, the `ex-handler` will be invoked, and any non-nil return value will be placed in the channel. If no `ex-handler` is supplied, exceptions will flow and be handled where they occur (note that this may in either the writer or reader thread depending on the operation and the state of the buffer).
+
+* Creating channels: [chan](https://clojure.github.io/core.async/clojure.core.async.html#var-chan)
+* Buffers: [buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-buffer) [dropping-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer) [sliding-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer) [unblocking-buffer?](https://clojure.github.io/core.async/clojure.core.async.html#var-unblocking-buffer.3F)
+
+### Put and take
+
+Any value can be placed on a channel, except `nil`. The primary operations on channels are _put_ and _take_, which are provided in several variants:
+
+* Blocking: [>!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21), [<!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21)
+* Parking: [>!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21), [<!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21)
+* Async: [put!](https://clojure.github.io/core.async/clojure.core.async.html#var-put.21), [take!](https://clojure.github.io/core.async/clojure.core.async.html#var-take.21)
+* Non-blocking: [offer!](https://clojure.github.io/core.async/clojure.core.async.html#var-offer.21), [poll!](https://clojure.github.io/core.async/clojure.core.async.html#var-poll.21)
+
+NOTE: As a mnemonic, the `<` or `>` points in the direction the value travels relative to the channel arg. For example, in `(>!! chan val)` the `>` points into the channel (_put_) and `(<!! chan)` points out of the channel (_take_).
+
+The use case dictates the variant to use. Parking operations are only valid in `go` blocks (see below for more) and never valid outside the lexical scope of a `go`. Conversely, blocking operations should only be used outside `go` blocks.
+
+The async and non-blocking forms are less common but may be used in either context. Use the async variants to specify a channel and a function that is called when the take or put succeeds. The `take!` and `put!` functions also take an optional flag `on-caller?` to indicate whether the fn can be called on the current thread. The non-blocking `offer!` and `poll!` will either complete or return immediately.
+
+Channels are closed with [close!](https://clojure.github.io/core.async/clojure.core.async.html#var-close.21). When a channel is closed, no values may be added, but values already in the channel may be taken. When all values are drained from a closed channel, take operations will return `nil` (these are not valid values and serve as a marker).
+
+
+* Closing channels:  [close!](https://clojure.github.io/core.async/clojure.core.async.html#var-close.21)
+* Buffers: [buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-buffer) [dropping-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer) [sliding-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer) [unblocking-buffer?](https://clojure.github.io/core.async/clojure.core.async.html#var-unblocking-buffer.3F)
+* Blocking ops: [>!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21) [<!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21)
+* Parking ops: [>!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21) [<!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21)
+* Async ops: [put!](https://clojure.github.io/core.async/clojure.core.async.html#var-put.21) [take!](https://clojure.github.io/core.async/clojure.core.async.html#var-take.21)
+* Non-blocking ops: [offer!](https://clojure.github.io/core.async/clojure.core.async.html#var-offer.21) [poll!](https://clojure.github.io/core.async/clojure.core.async.html#var-poll.21)
+
+### alts
+
+`alts!` (parking) and `alts!!` (blocking) can be used to wait on a set of channel operations until one succeeds. Channel operations can be either a put (with a value) or a take. By default, if more than one operation becomes available, they are chosen in random order, but set `:priority true` to order a preference. Only one of the operations will occur. If no operation is available and a `:default val` is specified, the default value will be returned instead.
+
+Since it is common to combine an `alts` with a conditional return based on the action chosen, `alt!` (parking) and `alt!!` (blocking) combine an `alts!` select with destructuring of the channel and value and a result expression.
+
+
+* Blocking: [alt!!](https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21.21) [alts!!](https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21.21)
+* Parking: [alt!](https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21) [alts!](https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21)
+* Timeouts: [timeout](https://clojure.github.io/core.async/clojure.core.async.html#var-timeout)
+
+### Promise channels
+
+Promise channels are special channels that will accept only a single value. Once a value is put to a promise channel, all pending and future consumers will receive only that value. Future puts complete but drop the value. When the channel is closed, consumers will receive either the value (if a put occurred) or nil (if no put occurred) forever.
+
+Promise channels: [promise-chan](https://clojure.github.io/core.async/clojure.core.async.html#var-promise-chan)
+
+## Managing processes
+
+### go blocks and threads
+
+"Processes", in the most general sense, are represented either as go blocks or threads. Go blocks model a lightweight computation that can be "parked" (paused) without consuming a thread. Go blocks communicate externally via channels. Any core.async parking operation (`>!`, `<!`, `alt!`, `alts!`) that cannot be immediately completed will cause the block to park and it will be automatically resumed when the operation can complete (when data has arrived on a channel to allow it).
+
+Note that go blocks are multiplexed over a finite number of threads and should never be blocked, either by the use of a core.async blocking operation (like `<!!`) or by calling a blockable I/O operation like a network call. Doing so may effectively block all of the threads in the go block pool and prevent further progress.
+
+core.async provides the helper functions `thread` and `thread-call` (analogous to `future` and `future-call`) to execute a process asynchronously in a separate thread. As these threads are not limited, they are suitable for blocking operations and can communicate with other processes via channels. However, note that these threads are not special - you can create and manage your own threads in any way you like and use core.async channels from those threads to communicate.
+
+
+* Go blocks: [go](https://clojure.github.io/core.async/clojure.core.async.html#var-go) [go-loop](https://clojure.github.io/core.async/clojure.core.async.html#var-go-loop)
+* Threads: [thread](https://clojure.github.io/core.async/clojure.core.async.html#var-thread)
+[thread-call](https://clojure.github.io/core.async/clojure.core.async.html#var-thread-call)
+
+### Multi-threaded pipelines
+
+The `pipeline` function (and variants) are designed for modeling your work as a pipeline of multi-threaded processing stages. The stages are connected by channels and each stage has N threads performing transducer xf as values flow from the from channel to the to channel. The variants are:
+
+* `pipeline` - the work performed in the xf must not block (designed for computational parallelism). The transducer will be applied independently to each value, in parallel, so stateful transducer functions will likely not be useful.
+* `pipeline-blocking` - the work performed in the xf may block, for example on network operations.
+* `pipeline-async` - this variant triggers asynchronous work in another system or thread and expects another thread to place the results on a return channel.
+
+
+* Pipeline ops: [pipeline](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline) [pipeline-blocking](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline-blocking) [pipeline-async](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline-async)
+
+## Working with channels
+
+### Operations on channels
+
+
+* Collections: [into](https://clojure.github.io/core.async/clojure.core.async.html#var-into) [onto-chan!](https://clojure.github.io/core.async/clojure.core.async.html#var-onto-chan.21) [onto-chan!!](https://clojure.github.io/core.async/clojure.core.async.html#var-onto-chan.21.21)  [to-chan](https://clojure.github.io/core.async/clojure.core.async.html#var-to-chan)
+* Functions: [map](https://clojure.github.io/core.async/clojure.core.async.html#var-map) [take](https://clojure.github.io/core.async/clojure.core.async.html#var-take)
+* Reducing: [reduce](https://clojure.github.io/core.async/clojure.core.async.html#var-reduce) [transduce](https://clojure.github.io/core.async/clojure.core.async.html#var-transduce)
+
+### Channel connectors
+
+* Connecting channels: [pipe](https://clojure.github.io/core.async/clojure.core.async.html#var-pipe)
+* Merging channels: [merge](https://clojure.github.io/core.async/clojure.core.async.html#var-merge)
+* Splitting channels: [split](https://clojure.github.io/core.async/clojure.core.async.html#var-split)
+
+### Mults
+
+* Mults: [mult](https://clojure.github.io/core.async/clojure.core.async.html#var-mult) [tap](https://clojure.github.io/core.async/clojure.core.async.html#var-tap) [untap](https://clojure.github.io/core.async/clojure.core.async.html#var-untap) [untap-all](https://clojure.github.io/core.async/clojure.core.async.html#var-untap-all)
+
+### Pub/sub
+
+* Pub/sub: [pub](https://clojure.github.io/core.async/clojure.core.async.html#var-pub) [sub](https://clojure.github.io/core.async/clojure.core.async.html#var-sub) [unsub](https://clojure.github.io/core.async/clojure.core.async.html#var-unsub) [unsub-all](https://clojure.github.io/core.async/clojure.core.async.html#var-unsub-all)
+
+### Mixes
+
+* Mixes: [mix](https://clojure.github.io/core.async/clojure.core.async.html#var-mix) [admix](https://clojure.github.io/core.async/clojure.core.async.html#var-admix) [toggle](https://clojure.github.io/core.async/clojure.core.async.html#var-toggle) [unmix](https://clojure.github.io/core.async/clojure.core.async.html#var-unmix) [unmix-all](https://clojure.github.io/core.async/clojure.core.async.html#var-unmix-all) [solo-mode](https://clojure.github.io/core.async/clojure.core.async.html#var-solo-mode)
+
+## Configuration
+
+### `go` checking
+
+Because the core.async go block thread pool is fixed size, blocking IO operations should never be done in go blocks. If all go threads are blocked on blocking operations, you may experience either deadlock or lack of progress. 
+
+One common issue is the use of core.async blocking operations inside go blocks. core.async includes a debugging facility to detect this situation (other kinds of blocking operation cannot be detected so this covers only part of the problem). To enable go checking, set the Java system property `clojure.core.async.go-checking=true`. This property is read once, at namespace load time, and should be used in development or testing, not in production.
+
+When go checking is active, invalid blocking calls in a go block will throw in go block threads. By default, these will likely throw to the go block thread's uncaught exception handler and be printed, but you can use `Thread/setDefaultUncaughtExceptionHandler` to change the default behavior (or depending on your system, you may have one already that routes to logging).
+
+## More information
+
+See the following for more information:
+
+* [Rationale](https://clojure.github.io/core.async/rationale.html)
+* [API](https://clojure.github.io/core.async)
+* [Source](https://github.com/clojure/core.async)
diff --git a/doc/flow.md b/doc/flow.md
index 3c8eb1b..0cadb4a 100644
--- a/doc/flow.md
+++ b/doc/flow.md
@@ -1,4 +1,4 @@
-# core.async.flow
+# Flow
 
 ## Rationale
 
diff --git a/doc/reference.md b/doc/reference.md
new file mode 100644
index 0000000..717efed
--- /dev/null
+++ b/doc/reference.md
@@ -0,0 +1,132 @@
+# API overview
+
+## Channels
+
+Channels are queues that carry values and support multiple writers and readers. Channels are created with [chan](https://clojure.github.io/core.async/clojure.core.async.html#var-chan). Values in a channel are stored in a buffer. Buffers are never unbounded and there are several provided buffer types:
+
+* Unbuffered - `(chan)` - no buffer is used, and a rendezvous is required to pass a value through the channel from writer to reader
+* Fixed size - `(chan 10)`
+* Dropping - `(chan (dropping-buffer 10))` - fixed size, and when full drop newest value
+* Sliding - `(chan (sliding-buffer 10))` - fixed size, and when full drop oldest value
+
+Channels are first-class values that can be passed around like any other value.
+
+Channels may optionally be supplied with a [transducer](https://clojure.org/reference/transducers) and an exception handler. The transducer will be applied to values that pass through the channel. If a transducer is supplied, the channel *must* be buffered (transducers can create intermediate values that must be stored somewhere). Channel transducers must not block, whether by issuing i/o operations or by externally synchronizing, else risk impeding or deadlocking go blocks.
+
+The `ex-handler` is a function of one argument (a Throwable). If an exception occurs while applying the transducer, the `ex-handler` will be invoked, and any non-nil return value will be placed in the channel. If no `ex-handler` is supplied, exceptions will flow and be handled where they occur (note that this may in either the writer or reader thread depending on the operation and the state of the buffer).
+
+* Creating channels: [chan](https://clojure.github.io/core.async/clojure.core.async.html#var-chan)
+* Buffers: [buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-buffer) [dropping-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer) [sliding-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer) [unblocking-buffer?](https://clojure.github.io/core.async/clojure.core.async.html#var-unblocking-buffer.3F)
+
+### Put and take
+
+Any value can be placed on a channel, except `nil`. The primary operations on channels are _put_ and _take_, which are provided in several variants:
+
+* Blocking: [>!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21), [<!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21)
+* Parking: [>!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21), [<!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21)
+* Async: [put!](https://clojure.github.io/core.async/clojure.core.async.html#var-put.21), [take!](https://clojure.github.io/core.async/clojure.core.async.html#var-take.21)
+* Non-blocking: [offer!](https://clojure.github.io/core.async/clojure.core.async.html#var-offer.21), [poll!](https://clojure.github.io/core.async/clojure.core.async.html#var-poll.21)
+
+NOTE: As a mnemonic, the `<` or `>` points in the direction the value travels relative to the channel arg. For example, in `(>!! chan val)` the `>` points into the channel (_put_) and `(<!! chan)` points out of the channel (_take_).
+
+The use case dictates the variant to use. Parking operations are only valid in `go` blocks (see below for more) and never valid outside the lexical scope of a `go`. Conversely, blocking operations should only be used outside `go` blocks.
+
+The async and non-blocking forms are less common but may be used in either context. Use the async variants to specify a channel and a function that is called when the take or put succeeds. The `take!` and `put!` functions also take an optional flag `on-caller?` to indicate whether the fn can be called on the current thread. The non-blocking `offer!` and `poll!` will either complete or return immediately.
+
+Channels are closed with [close!](https://clojure.github.io/core.async/clojure.core.async.html#var-close.21). When a channel is closed, no values may be added, but values already in the channel may be taken. When all values are drained from a closed channel, take operations will return `nil` (these are not valid values and serve as a marker).
+
+
+* Closing channels:  [close!](https://clojure.github.io/core.async/clojure.core.async.html#var-close.21)
+* Buffers: [buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-buffer) [dropping-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer) [sliding-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer) [unblocking-buffer?](https://clojure.github.io/core.async/clojure.core.async.html#var-unblocking-buffer.3F)
+* Blocking ops: [>!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21) [<!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21)
+* Parking ops: [>!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21) [<!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21)
+* Async ops: [put!](https://clojure.github.io/core.async/clojure.core.async.html#var-put.21) [take!](https://clojure.github.io/core.async/clojure.core.async.html#var-take.21)
+* Non-blocking ops: [offer!](https://clojure.github.io/core.async/clojure.core.async.html#var-offer.21) [poll!](https://clojure.github.io/core.async/clojure.core.async.html#var-poll.21)
+
+### alts
+
+`alts!` (parking) and `alts!!` (blocking) can be used to wait on a set of channel operations until one succeeds. Channel operations can be either a put (with a value) or a take. By default, if more than one operation becomes available, they are chosen in random order, but set `:priority true` to order a preference. Only one of the operations will occur. If no operation is available and a `:default val` is specified, the default value will be returned instead.
+
+Since it is common to combine an `alts` with a conditional return based on the action chosen, `alt!` (parking) and `alt!!` (blocking) combine an `alts!` select with destructuring of the channel and value and a result expression.
+
+
+* Blocking: [alt!!](https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21.21) [alts!!](https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21.21)
+* Parking: [alt!](https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21) [alts!](https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21)
+* Timeouts: [timeout](https://clojure.github.io/core.async/clojure.core.async.html#var-timeout)
+
+### Promise channels
+
+Promise channels are special channels that will accept only a single value. Once a value is put to a promise channel, all pending and future consumers will receive only that value. Future puts complete but drop the value. When the channel is closed, consumers will receive either the value (if a put occurred) or nil (if no put occurred) forever.
+
+Promise channels: [promise-chan](https://clojure.github.io/core.async/clojure.core.async.html#var-promise-chan)
+
+## Managing processes
+
+### go blocks and threads
+
+"Processes", in the most general sense, are represented either as go blocks or threads. Go blocks model a lightweight computation that can be "parked" (paused) without consuming a thread. Go blocks communicate externally via channels. Any core.async parking operation (`>!`, `<!`, `alt!`, `alts!`) that cannot be immediately completed will cause the block to park and it will be automatically resumed when the operation can complete (when data has arrived on a channel to allow it).
+
+Note that go blocks are multiplexed over a finite number of threads and should never be blocked, either by the use of a core.async blocking operation (like `<!!`) or by calling a blockable I/O operation like a network call. Doing so may effectively block all of the threads in the go block pool and prevent further progress.
+
+core.async provides the helper functions `thread` and `thread-call` (analogous to `future` and `future-call`) to execute a process asynchronously in a separate thread. As these threads are not limited, they are suitable for blocking operations and can communicate with other processes via channels. However, note that these threads are not special - you can create and manage your own threads in any way you like and use core.async channels from those threads to communicate.
+
+
+* Go blocks: [go](https://clojure.github.io/core.async/clojure.core.async.html#var-go) [go-loop](https://clojure.github.io/core.async/clojure.core.async.html#var-go-loop)
+* Threads: [thread](https://clojure.github.io/core.async/clojure.core.async.html#var-thread)
+[thread-call](https://clojure.github.io/core.async/clojure.core.async.html#var-thread-call)
+
+### Multi-threaded pipelines
+
+The `pipeline` function (and variants) are designed for modeling your work as a pipeline of multi-threaded processing stages. The stages are connected by channels and each stage has N threads performing transducer xf as values flow from the from channel to the to channel. The variants are:
+
+* `pipeline` - the work performed in the xf must not block (designed for computational parallelism). The transducer will be applied independently to each value, in parallel, so stateful transducer functions will likely not be useful.
+* `pipeline-blocking` - the work performed in the xf may block, for example on network operations.
+* `pipeline-async` - this variant triggers asynchronous work in another system or thread and expects another thread to place the results on a return channel.
+
+
+* Pipeline ops: [pipeline](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline) [pipeline-blocking](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline-blocking) [pipeline-async](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline-async)
+
+## Working with channels
+
+### Operations on channels
+
+
+* Collections: [into](https://clojure.github.io/core.async/clojure.core.async.html#var-into) [onto-chan!](https://clojure.github.io/core.async/clojure.core.async.html#var-onto-chan.21) [onto-chan!!](https://clojure.github.io/core.async/clojure.core.async.html#var-onto-chan.21.21)  [to-chan](https://clojure.github.io/core.async/clojure.core.async.html#var-to-chan)
+* Functions: [map](https://clojure.github.io/core.async/clojure.core.async.html#var-map) [take](https://clojure.github.io/core.async/clojure.core.async.html#var-take)
+* Reducing: [reduce](https://clojure.github.io/core.async/clojure.core.async.html#var-reduce) [transduce](https://clojure.github.io/core.async/clojure.core.async.html#var-transduce)
+
+### Channel connectors
+
+* Connecting channels: [pipe](https://clojure.github.io/core.async/clojure.core.async.html#var-pipe)
+* Merging channels: [merge](https://clojure.github.io/core.async/clojure.core.async.html#var-merge)
+* Splitting channels: [split](https://clojure.github.io/core.async/clojure.core.async.html#var-split)
+
+### Mults
+
+* Mults: [mult](https://clojure.github.io/core.async/clojure.core.async.html#var-mult) [tap](https://clojure.github.io/core.async/clojure.core.async.html#var-tap) [untap](https://clojure.github.io/core.async/clojure.core.async.html#var-untap) [untap-all](https://clojure.github.io/core.async/clojure.core.async.html#var-untap-all)
+
+### Pub/sub
+
+* Pub/sub: [pub](https://clojure.github.io/core.async/clojure.core.async.html#var-pub) [sub](https://clojure.github.io/core.async/clojure.core.async.html#var-sub) [unsub](https://clojure.github.io/core.async/clojure.core.async.html#var-unsub) [unsub-all](https://clojure.github.io/core.async/clojure.core.async.html#var-unsub-all)
+
+### Mixes
+
+* Mixes: [mix](https://clojure.github.io/core.async/clojure.core.async.html#var-mix) [admix](https://clojure.github.io/core.async/clojure.core.async.html#var-admix) [toggle](https://clojure.github.io/core.async/clojure.core.async.html#var-toggle) [unmix](https://clojure.github.io/core.async/clojure.core.async.html#var-unmix) [unmix-all](https://clojure.github.io/core.async/clojure.core.async.html#var-unmix-all) [solo-mode](https://clojure.github.io/core.async/clojure.core.async.html#var-solo-mode)
+
+## Configuration
+
+### `go` checking
+
+Because the core.async go block thread pool is fixed size, blocking IO operations should never be done in go blocks. If all go threads are blocked on blocking operations, you may experience either deadlock or lack of progress. 
+
+One common issue is the use of core.async blocking operations inside go blocks. core.async includes a debugging facility to detect this situation (other kinds of blocking operation cannot be detected so this covers only part of the problem). To enable go checking, set the Java system property `clojure.core.async.go-checking=true`. This property is read once, at namespace load time, and should be used in development or testing, not in production.
+
+When go checking is active, invalid blocking calls in a go block will throw in go block threads. By default, these will likely throw to the go block thread's uncaught exception handler and be printed, but you can use `Thread/setDefaultUncaughtExceptionHandler` to change the default behavior (or depending on your system, you may have one already that routes to logging).
+
+## More information
+
+See the following for more information:
+
+* [Rationale](https://clojure.github.io/core.async/rationale.html)
+* [API](https://clojure.github.io/core.async)
+* [Source](https://github.com/clojure/core.async)
diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 89b0872..35ca515 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
diff --git a/docs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
index 2430b58..0d2cbf6 100644
--- a/docs/clojure.core.async.flow.spi.html
+++ b/docs/clojure.core.async.flow.spi.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
 be needed for ordinary use of the library. This protocol is for
 creating new types of Processes that are not possible to create
 with ::flow/process.
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index d9e9da9..93c0332 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 Set Java system property `clojure.core.async.go-checking` to true
 to validate go blocks do not invoke core.async blocking operations.
diff --git a/docs/flow.html b/docs/flow.html
index d4687e8..51ff8d6 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>core.async.flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#coreasyncflow" id="coreasyncflow"></a>core.async.flow</h1>
+<html><head><meta charset="UTF-8" /><title>Flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow" id="flow"></a>Flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
 <p>The <a href="https://clojure.github.io/core.async/rationale.html">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
diff --git a/docs/index.html b/docs/index.html
index 358d8bc..77beae3 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="flow.html">core.async.flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="reference.html">API overview</a></li><li><a href="flow.html">Flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
diff --git a/docs/rationale.html b/docs/rationale.html
index c8d380f..58a5c04 100644
--- a/docs/rationale.html
+++ b/docs/rationale.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>core.async.flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
+<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
 <p><em>June 28, 2013</em></p>
 <p><a href="https://github.com/clojure/core.async">core.async</a> is a new contrib library for Clojure that adds support for asynchronous programming using channels.</p>
 <p>There comes a time in all good programs when components or subsystems must stop communicating directly with one another. This is often achieved via the introduction of queues between the producers of data and the consumers/processors of that data. This architectural indirection ensures that important decisions can be made with some degree of independence, and leads to systems that are easier to understand, manage, monitor and change, and make better use of computational resources, etc.</p>
diff --git a/docs/reference.html b/docs/reference.html
new file mode 100644
index 0000000..c858330
--- /dev/null
+++ b/docs/reference.html
@@ -0,0 +1,106 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>API overview</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#api-overview" id="api-overview"></a>API overview</h1>
+<h2><a href="#channels" id="channels"></a>Channels</h2>
+<p>Channels are queues that carry values and support multiple writers and readers. Channels are created with <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-chan">chan</a>. Values in a channel are stored in a buffer. Buffers are never unbounded and there are several provided buffer types:</p>
+<ul>
+<li>Unbuffered - <code>(chan)</code> - no buffer is used, and a rendezvous is required to pass a value through the channel from writer to reader</li>
+<li>Fixed size - <code>(chan 10)</code></li>
+<li>Dropping - <code>(chan (dropping-buffer 10))</code> - fixed size, and when full drop newest value</li>
+<li>Sliding - <code>(chan (sliding-buffer 10))</code> - fixed size, and when full drop oldest value</li>
+</ul>
+<p>Channels are first-class values that can be passed around like any other value.</p>
+<p>Channels may optionally be supplied with a <a href="https://clojure.org/reference/transducers">transducer</a> and an exception handler. The transducer will be applied to values that pass through the channel. If a transducer is supplied, the channel <em>must</em> be buffered (transducers can create intermediate values that must be stored somewhere). Channel transducers must not block, whether by issuing i/o operations or by externally synchronizing, else risk impeding or deadlocking go blocks.</p>
+<p>The <code>ex-handler</code> is a function of one argument (a Throwable). If an exception occurs while applying the transducer, the <code>ex-handler</code> will be invoked, and any non-nil return value will be placed in the channel. If no <code>ex-handler</code> is supplied, exceptions will flow and be handled where they occur (note that this may in either the writer or reader thread depending on the operation and the state of the buffer).</p>
+<ul>
+<li>Creating channels: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-chan">chan</a></li>
+<li>Buffers: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-buffer">buffer</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a></li>
+</ul>
+<h3><a href="#put-and-take" id="put-and-take"></a>Put and take</h3>
+<p>Any value can be placed on a channel, except <code>nil</code>. The primary operations on channels are <em>put</em> and <em>take</em>, which are provided in several variants:</p>
+<ul>
+<li>Blocking: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21">&gt;!!</a>, <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21">&lt;!!</a></li>
+<li>Parking: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21">&gt;!</a>, <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21">&lt;!</a></li>
+<li>Async: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-put.21">put!</a>, <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-take.21">take!</a></li>
+<li>Non-blocking: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-offer.21">offer!</a>, <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-poll.21">poll!</a></li>
+</ul>
+<p>NOTE: As a mnemonic, the <code>&lt;</code> or <code>&gt;</code> points in the direction the value travels relative to the channel arg. For example, in <code>(&gt;!! chan val)</code> the <code>&gt;</code> points into the channel (<em>put</em>) and <code>(&lt;!! chan)</code> points out of the channel (<em>take</em>).</p>
+<p>The use case dictates the variant to use. Parking operations are only valid in <code>go</code> blocks (see below for more) and never valid outside the lexical scope of a <code>go</code>. Conversely, blocking operations should only be used outside <code>go</code> blocks.</p>
+<p>The async and non-blocking forms are less common but may be used in either context. Use the async variants to specify a channel and a function that is called when the take or put succeeds. The <code>take!</code> and <code>put!</code> functions also take an optional flag <code>on-caller?</code> to indicate whether the fn can be called on the current thread. The non-blocking <code>offer!</code> and <code>poll!</code> will either complete or return immediately.</p>
+<p>Channels are closed with <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-close.21">close!</a>. When a channel is closed, no values may be added, but values already in the channel may be taken. When all values are drained from a closed channel, take operations will return <code>nil</code> (these are not valid values and serve as a marker).</p>
+<ul>
+<li>Closing channels:  <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-close.21">close!</a></li>
+<li>Buffers: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-buffer">buffer</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a></li>
+<li>Blocking ops: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21">&gt;!!</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21">&lt;!!</a></li>
+<li>Parking ops: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21">&gt;!</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21">&lt;!</a></li>
+<li>Async ops: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-put.21">put!</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-take.21">take!</a></li>
+<li>Non-blocking ops: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-offer.21">offer!</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-poll.21">poll!</a></li>
+</ul>
+<h3><a href="#alts" id="alts"></a>alts</h3>
+<p><code>alts!</code> (parking) and <code>alts!!</code> (blocking) can be used to wait on a set of channel operations until one succeeds. Channel operations can be either a put (with a value) or a take. By default, if more than one operation becomes available, they are chosen in random order, but set <code>:priority true</code> to order a preference. Only one of the operations will occur. If no operation is available and a <code>:default val</code> is specified, the default value will be returned instead.</p>
+<p>Since it is common to combine an <code>alts</code> with a conditional return based on the action chosen, <code>alt!</code> (parking) and <code>alt!!</code> (blocking) combine an <code>alts!</code> select with destructuring of the channel and value and a result expression.</p>
+<ul>
+<li>Blocking: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21.21">alt!!</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21.21">alts!!</a></li>
+<li>Parking: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21">alt!</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21">alts!</a></li>
+<li>Timeouts: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-timeout">timeout</a></li>
+</ul>
+<h3><a href="#promise-channels" id="promise-channels"></a>Promise channels</h3>
+<p>Promise channels are special channels that will accept only a single value. Once a value is put to a promise channel, all pending and future consumers will receive only that value. Future puts complete but drop the value. When the channel is closed, consumers will receive either the value (if a put occurred) or nil (if no put occurred) forever.</p>
+<p>Promise channels: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-promise-chan">promise-chan</a></p>
+<h2><a href="#managing-processes" id="managing-processes"></a>Managing processes</h2>
+<h3><a href="#go-blocks-and-threads" id="go-blocks-and-threads"></a>go blocks and threads</h3>
+<p>“Processes”, in the most general sense, are represented either as go blocks or threads. Go blocks model a lightweight computation that can be “parked” (paused) without consuming a thread. Go blocks communicate externally via channels. Any core.async parking operation (<code>&gt;!</code>, <code>&lt;!</code>, <code>alt!</code>, <code>alts!</code>) that cannot be immediately completed will cause the block to park and it will be automatically resumed when the operation can complete (when data has arrived on a channel to allow it).</p>
+<p>Note that go blocks are multiplexed over a finite number of threads and should never be blocked, either by the use of a core.async blocking operation (like <code>&lt;!!</code>) or by calling a blockable I/O operation like a network call. Doing so may effectively block all of the threads in the go block pool and prevent further progress.</p>
+<p>core.async provides the helper functions <code>thread</code> and <code>thread-call</code> (analogous to <code>future</code> and <code>future-call</code>) to execute a process asynchronously in a separate thread. As these threads are not limited, they are suitable for blocking operations and can communicate with other processes via channels. However, note that these threads are not special - you can create and manage your own threads in any way you like and use core.async channels from those threads to communicate.</p>
+<ul>
+<li>Go blocks: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-go">go</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-go-loop">go-loop</a></li>
+<li>Threads: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-thread">thread</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-thread-call">thread-call</a></li>
+</ul>
+<h3><a href="#multi-threaded-pipelines" id="multi-threaded-pipelines"></a>Multi-threaded pipelines</h3>
+<p>The <code>pipeline</code> function (and variants) are designed for modeling your work as a pipeline of multi-threaded processing stages. The stages are connected by channels and each stage has N threads performing transducer xf as values flow from the from channel to the to channel. The variants are:</p>
+<ul>
+<li><code>pipeline</code> - the work performed in the xf must not block (designed for computational parallelism). The transducer will be applied independently to each value, in parallel, so stateful transducer functions will likely not be useful.</li>
+<li><code>pipeline-blocking</code> - the work performed in the xf may block, for example on network operations.</li>
+<li><code>pipeline-async</code> - this variant triggers asynchronous work in another system or thread and expects another thread to place the results on a return channel.</li>
+<li>
+<p>Pipeline ops: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline">pipeline</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline-async">pipeline-async</a></p>
+</li>
+</ul>
+<h2><a href="#working-with-channels" id="working-with-channels"></a>Working with channels</h2>
+<h3><a href="#operations-on-channels" id="operations-on-channels"></a>Operations on channels</h3>
+<ul>
+<li>Collections: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-into">into</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-onto-chan.21">onto-chan!</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a>  <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-to-chan">to-chan</a></li>
+<li>Functions: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-map">map</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-take">take</a></li>
+<li>Reducing: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-reduce">reduce</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-transduce">transduce</a></li>
+</ul>
+<h3><a href="#channel-connectors" id="channel-connectors"></a>Channel connectors</h3>
+<ul>
+<li>Connecting channels: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-pipe">pipe</a></li>
+<li>Merging channels: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-merge">merge</a></li>
+<li>Splitting channels: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-split">split</a></li>
+</ul>
+<h3><a href="#mults" id="mults"></a>Mults</h3>
+<ul>
+<li>Mults: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-mult">mult</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-tap">tap</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-untap">untap</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-untap-all">untap-all</a></li>
+</ul>
+<h3><a href="#pubsub" id="pubsub"></a>Pub/sub</h3>
+<ul>
+<li>Pub/sub: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-pub">pub</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-sub">sub</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-unsub">unsub</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-unsub-all">unsub-all</a></li>
+</ul>
+<h3><a href="#mixes" id="mixes"></a>Mixes</h3>
+<ul>
+<li>Mixes: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-mix">mix</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-admix">admix</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-toggle">toggle</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-unmix">unmix</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-unmix-all">unmix-all</a> <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-solo-mode">solo-mode</a></li>
+</ul>
+<h2><a href="#configuration" id="configuration"></a>Configuration</h2>
+<h3><a href="#go-checking" id="go-checking"></a><code>go</code> checking</h3>
+<p>Because the core.async go block thread pool is fixed size, blocking IO operations should never be done in go blocks. If all go threads are blocked on blocking operations, you may experience either deadlock or lack of progress.</p>
+<p>One common issue is the use of core.async blocking operations inside go blocks. core.async includes a debugging facility to detect this situation (other kinds of blocking operation cannot be detected so this covers only part of the problem). To enable go checking, set the Java system property <code>clojure.core.async.go-checking=true</code>. This property is read once, at namespace load time, and should be used in development or testing, not in production.</p>
+<p>When go checking is active, invalid blocking calls in a go block will throw in go block threads. By default, these will likely throw to the go block thread’s uncaught exception handler and be printed, but you can use <code>Thread/setDefaultUncaughtExceptionHandler</code> to change the default behavior (or depending on your system, you may have one already that routes to logging).</p>
+<h2><a href="#more-information" id="more-information"></a>More information</h2>
+<p>See the following for more information:</p>
+<ul>
+<li><a href="https://clojure.github.io/core.async/rationale.html">Rationale</a></li>
+<li><a href="https://clojure.github.io/core.async">API</a></li>
+<li><a href="https://github.com/clojure/core.async">Source</a></li>
+</ul>
+</div></div></div></body></html>
\ No newline at end of file

From 8e8d57f4c16af5f83dd3b03d9775b96c778501bb Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Thu, 1 May 2025 12:59:30 -0500
Subject: [PATCH 62/73] doc updates

---
 doc/async-reference.md                | 132 --------------------------
 doc/reference.md                      |   4 +-
 docs/clojure.core.async.flow.html     |   2 +-
 docs/clojure.core.async.flow.spi.html |   2 +-
 docs/clojure.core.async.html          |   2 +-
 docs/flow.html                        |   2 +-
 docs/index.html                       |   2 +-
 docs/rationale.html                   |   2 +-
 docs/reference.html                   |   6 +-
 9 files changed, 12 insertions(+), 142 deletions(-)
 delete mode 100644 doc/async-reference.md

diff --git a/doc/async-reference.md b/doc/async-reference.md
deleted file mode 100644
index 7f5c7ba..0000000
--- a/doc/async-reference.md
+++ /dev/null
@@ -1,132 +0,0 @@
-# API Reference
-
-## Channels
-
-Channels are queues that carry values and support multiple writers and readers. Channels are created with [chan](https://clojure.github.io/core.async/clojure.core.async.html#var-chan). Values in a channel are stored in a buffer. Buffers are never unbounded and there are several provided buffer types:
-
-* Unbuffered - `(chan)` - no buffer is used, and a rendezvous is required to pass a value through the channel from writer to reader
-* Fixed size - `(chan 10)`
-* Dropping - `(chan (dropping-buffer 10))` - fixed size, and when full drop newest value
-* Sliding - `(chan (sliding-buffer 10))` - fixed size, and when full drop oldest value
-
-Channels are first-class values that can be passed around like any other value.
-
-Channels may optionally be supplied with a [transducer](https://clojure.org/reference/transducers) and an exception handler. The transducer will be applied to values that pass through the channel. If a transducer is supplied, the channel *must* be buffered (transducers can create intermediate values that must be stored somewhere). Channel transducers must not block, whether by issuing i/o operations or by externally synchronizing, else risk impeding or deadlocking go blocks.
-
-The `ex-handler` is a function of one argument (a Throwable). If an exception occurs while applying the transducer, the `ex-handler` will be invoked, and any non-nil return value will be placed in the channel. If no `ex-handler` is supplied, exceptions will flow and be handled where they occur (note that this may in either the writer or reader thread depending on the operation and the state of the buffer).
-
-* Creating channels: [chan](https://clojure.github.io/core.async/clojure.core.async.html#var-chan)
-* Buffers: [buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-buffer) [dropping-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer) [sliding-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer) [unblocking-buffer?](https://clojure.github.io/core.async/clojure.core.async.html#var-unblocking-buffer.3F)
-
-### Put and take
-
-Any value can be placed on a channel, except `nil`. The primary operations on channels are _put_ and _take_, which are provided in several variants:
-
-* Blocking: [>!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21), [<!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21)
-* Parking: [>!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21), [<!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21)
-* Async: [put!](https://clojure.github.io/core.async/clojure.core.async.html#var-put.21), [take!](https://clojure.github.io/core.async/clojure.core.async.html#var-take.21)
-* Non-blocking: [offer!](https://clojure.github.io/core.async/clojure.core.async.html#var-offer.21), [poll!](https://clojure.github.io/core.async/clojure.core.async.html#var-poll.21)
-
-NOTE: As a mnemonic, the `<` or `>` points in the direction the value travels relative to the channel arg. For example, in `(>!! chan val)` the `>` points into the channel (_put_) and `(<!! chan)` points out of the channel (_take_).
-
-The use case dictates the variant to use. Parking operations are only valid in `go` blocks (see below for more) and never valid outside the lexical scope of a `go`. Conversely, blocking operations should only be used outside `go` blocks.
-
-The async and non-blocking forms are less common but may be used in either context. Use the async variants to specify a channel and a function that is called when the take or put succeeds. The `take!` and `put!` functions also take an optional flag `on-caller?` to indicate whether the fn can be called on the current thread. The non-blocking `offer!` and `poll!` will either complete or return immediately.
-
-Channels are closed with [close!](https://clojure.github.io/core.async/clojure.core.async.html#var-close.21). When a channel is closed, no values may be added, but values already in the channel may be taken. When all values are drained from a closed channel, take operations will return `nil` (these are not valid values and serve as a marker).
-
-
-* Closing channels:  [close!](https://clojure.github.io/core.async/clojure.core.async.html#var-close.21)
-* Buffers: [buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-buffer) [dropping-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-dropping-buffer) [sliding-buffer](https://clojure.github.io/core.async/clojure.core.async.html#var-sliding-buffer) [unblocking-buffer?](https://clojure.github.io/core.async/clojure.core.async.html#var-unblocking-buffer.3F)
-* Blocking ops: [>!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21.21) [<!!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21.21)
-* Parking ops: [>!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3E.21) [<!](https://clojure.github.io/core.async/clojure.core.async.html#var-.3C.21)
-* Async ops: [put!](https://clojure.github.io/core.async/clojure.core.async.html#var-put.21) [take!](https://clojure.github.io/core.async/clojure.core.async.html#var-take.21)
-* Non-blocking ops: [offer!](https://clojure.github.io/core.async/clojure.core.async.html#var-offer.21) [poll!](https://clojure.github.io/core.async/clojure.core.async.html#var-poll.21)
-
-### alts
-
-`alts!` (parking) and `alts!!` (blocking) can be used to wait on a set of channel operations until one succeeds. Channel operations can be either a put (with a value) or a take. By default, if more than one operation becomes available, they are chosen in random order, but set `:priority true` to order a preference. Only one of the operations will occur. If no operation is available and a `:default val` is specified, the default value will be returned instead.
-
-Since it is common to combine an `alts` with a conditional return based on the action chosen, `alt!` (parking) and `alt!!` (blocking) combine an `alts!` select with destructuring of the channel and value and a result expression.
-
-
-* Blocking: [alt!!](https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21.21) [alts!!](https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21.21)
-* Parking: [alt!](https://clojure.github.io/core.async/clojure.core.async.html#var-alt.21) [alts!](https://clojure.github.io/core.async/clojure.core.async.html#var-alts.21)
-* Timeouts: [timeout](https://clojure.github.io/core.async/clojure.core.async.html#var-timeout)
-
-### Promise channels
-
-Promise channels are special channels that will accept only a single value. Once a value is put to a promise channel, all pending and future consumers will receive only that value. Future puts complete but drop the value. When the channel is closed, consumers will receive either the value (if a put occurred) or nil (if no put occurred) forever.
-
-Promise channels: [promise-chan](https://clojure.github.io/core.async/clojure.core.async.html#var-promise-chan)
-
-## Managing processes
-
-### go blocks and threads
-
-"Processes", in the most general sense, are represented either as go blocks or threads. Go blocks model a lightweight computation that can be "parked" (paused) without consuming a thread. Go blocks communicate externally via channels. Any core.async parking operation (`>!`, `<!`, `alt!`, `alts!`) that cannot be immediately completed will cause the block to park and it will be automatically resumed when the operation can complete (when data has arrived on a channel to allow it).
-
-Note that go blocks are multiplexed over a finite number of threads and should never be blocked, either by the use of a core.async blocking operation (like `<!!`) or by calling a blockable I/O operation like a network call. Doing so may effectively block all of the threads in the go block pool and prevent further progress.
-
-core.async provides the helper functions `thread` and `thread-call` (analogous to `future` and `future-call`) to execute a process asynchronously in a separate thread. As these threads are not limited, they are suitable for blocking operations and can communicate with other processes via channels. However, note that these threads are not special - you can create and manage your own threads in any way you like and use core.async channels from those threads to communicate.
-
-
-* Go blocks: [go](https://clojure.github.io/core.async/clojure.core.async.html#var-go) [go-loop](https://clojure.github.io/core.async/clojure.core.async.html#var-go-loop)
-* Threads: [thread](https://clojure.github.io/core.async/clojure.core.async.html#var-thread)
-[thread-call](https://clojure.github.io/core.async/clojure.core.async.html#var-thread-call)
-
-### Multi-threaded pipelines
-
-The `pipeline` function (and variants) are designed for modeling your work as a pipeline of multi-threaded processing stages. The stages are connected by channels and each stage has N threads performing transducer xf as values flow from the from channel to the to channel. The variants are:
-
-* `pipeline` - the work performed in the xf must not block (designed for computational parallelism). The transducer will be applied independently to each value, in parallel, so stateful transducer functions will likely not be useful.
-* `pipeline-blocking` - the work performed in the xf may block, for example on network operations.
-* `pipeline-async` - this variant triggers asynchronous work in another system or thread and expects another thread to place the results on a return channel.
-
-
-* Pipeline ops: [pipeline](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline) [pipeline-blocking](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline-blocking) [pipeline-async](https://clojure.github.io/core.async/clojure.core.async.html#var-pipeline-async)
-
-## Working with channels
-
-### Operations on channels
-
-
-* Collections: [into](https://clojure.github.io/core.async/clojure.core.async.html#var-into) [onto-chan!](https://clojure.github.io/core.async/clojure.core.async.html#var-onto-chan.21) [onto-chan!!](https://clojure.github.io/core.async/clojure.core.async.html#var-onto-chan.21.21)  [to-chan](https://clojure.github.io/core.async/clojure.core.async.html#var-to-chan)
-* Functions: [map](https://clojure.github.io/core.async/clojure.core.async.html#var-map) [take](https://clojure.github.io/core.async/clojure.core.async.html#var-take)
-* Reducing: [reduce](https://clojure.github.io/core.async/clojure.core.async.html#var-reduce) [transduce](https://clojure.github.io/core.async/clojure.core.async.html#var-transduce)
-
-### Channel connectors
-
-* Connecting channels: [pipe](https://clojure.github.io/core.async/clojure.core.async.html#var-pipe)
-* Merging channels: [merge](https://clojure.github.io/core.async/clojure.core.async.html#var-merge)
-* Splitting channels: [split](https://clojure.github.io/core.async/clojure.core.async.html#var-split)
-
-### Mults
-
-* Mults: [mult](https://clojure.github.io/core.async/clojure.core.async.html#var-mult) [tap](https://clojure.github.io/core.async/clojure.core.async.html#var-tap) [untap](https://clojure.github.io/core.async/clojure.core.async.html#var-untap) [untap-all](https://clojure.github.io/core.async/clojure.core.async.html#var-untap-all)
-
-### Pub/sub
-
-* Pub/sub: [pub](https://clojure.github.io/core.async/clojure.core.async.html#var-pub) [sub](https://clojure.github.io/core.async/clojure.core.async.html#var-sub) [unsub](https://clojure.github.io/core.async/clojure.core.async.html#var-unsub) [unsub-all](https://clojure.github.io/core.async/clojure.core.async.html#var-unsub-all)
-
-### Mixes
-
-* Mixes: [mix](https://clojure.github.io/core.async/clojure.core.async.html#var-mix) [admix](https://clojure.github.io/core.async/clojure.core.async.html#var-admix) [toggle](https://clojure.github.io/core.async/clojure.core.async.html#var-toggle) [unmix](https://clojure.github.io/core.async/clojure.core.async.html#var-unmix) [unmix-all](https://clojure.github.io/core.async/clojure.core.async.html#var-unmix-all) [solo-mode](https://clojure.github.io/core.async/clojure.core.async.html#var-solo-mode)
-
-## Configuration
-
-### `go` checking
-
-Because the core.async go block thread pool is fixed size, blocking IO operations should never be done in go blocks. If all go threads are blocked on blocking operations, you may experience either deadlock or lack of progress. 
-
-One common issue is the use of core.async blocking operations inside go blocks. core.async includes a debugging facility to detect this situation (other kinds of blocking operation cannot be detected so this covers only part of the problem). To enable go checking, set the Java system property `clojure.core.async.go-checking=true`. This property is read once, at namespace load time, and should be used in development or testing, not in production.
-
-When go checking is active, invalid blocking calls in a go block will throw in go block threads. By default, these will likely throw to the go block thread's uncaught exception handler and be printed, but you can use `Thread/setDefaultUncaughtExceptionHandler` to change the default behavior (or depending on your system, you may have one already that routes to logging).
-
-## More information
-
-See the following for more information:
-
-* [Rationale](https://clojure.github.io/core.async/rationale.html)
-* [API](https://clojure.github.io/core.async)
-* [Source](https://github.com/clojure/core.async)
diff --git a/doc/reference.md b/doc/reference.md
index 717efed..43edd64 100644
--- a/doc/reference.md
+++ b/doc/reference.md
@@ -1,4 +1,4 @@
-# API overview
+# Reference
 
 ## Channels
 
@@ -58,7 +58,7 @@ Since it is common to combine an `alts` with a conditional return based on the a
 
 Promise channels are special channels that will accept only a single value. Once a value is put to a promise channel, all pending and future consumers will receive only that value. Future puts complete but drop the value. When the channel is closed, consumers will receive either the value (if a put occurred) or nil (if no put occurred) forever.
 
-Promise channels: [promise-chan](https://clojure.github.io/core.async/clojure.core.async.html#var-promise-chan)
+* Promise channels: [promise-chan](https://clojure.github.io/core.async/clojure.core.async.html#var-promise-chan)
 
 ## Managing processes
 
diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 35ca515..c0c2feb 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
diff --git a/docs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
index 0d2cbf6..50bbdae 100644
--- a/docs/clojure.core.async.flow.spi.html
+++ b/docs/clojure.core.async.flow.spi.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
 be needed for ordinary use of the library. This protocol is for
 creating new types of Processes that are not possible to create
 with ::flow/process.
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index 93c0332..674af31 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 Set Java system property `clojure.core.async.go-checking` to true
 to validate go blocks do not invoke core.async blocking operations.
diff --git a/docs/flow.html b/docs/flow.html
index 51ff8d6..ec4e10e 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow" id="flow"></a>Flow</h1>
+<html><head><meta charset="UTF-8" /><title>Flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow" id="flow"></a>Flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
 <p>The <a href="https://clojure.github.io/core.async/rationale.html">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
diff --git a/docs/index.html b/docs/index.html
index 77beae3..f2166a7 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="reference.html">API overview</a></li><li><a href="flow.html">Flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="reference.html">Reference</a></li><li><a href="flow.html">Flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
diff --git a/docs/rationale.html b/docs/rationale.html
index 58a5c04..d2d8a6e 100644
--- a/docs/rationale.html
+++ b/docs/rationale.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
+<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
 <p><em>June 28, 2013</em></p>
 <p><a href="https://github.com/clojure/core.async">core.async</a> is a new contrib library for Clojure that adds support for asynchronous programming using channels.</p>
 <p>There comes a time in all good programs when components or subsystems must stop communicating directly with one another. This is often achieved via the introduction of queues between the producers of data and the consumers/processors of that data. This architectural indirection ensures that important decisions can be made with some degree of independence, and leads to systems that are easier to understand, manage, monitor and change, and make better use of computational resources, etc.</p>
diff --git a/docs/reference.html b/docs/reference.html
index c858330..ce80769 100644
--- a/docs/reference.html
+++ b/docs/reference.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>API overview</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="reference.html"><div class="inner"><span>API overview</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#api-overview" id="api-overview"></a>API overview</h1>
+<html><head><meta charset="UTF-8" /><title>Reference</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#reference" id="reference"></a>Reference</h1>
 <h2><a href="#channels" id="channels"></a>Channels</h2>
 <p>Channels are queues that carry values and support multiple writers and readers. Channels are created with <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-chan">chan</a>. Values in a channel are stored in a buffer. Buffers are never unbounded and there are several provided buffer types:</p>
 <ul>
@@ -46,7 +46,9 @@ <h3><a href="#alts" id="alts"></a>alts</h3>
 </ul>
 <h3><a href="#promise-channels" id="promise-channels"></a>Promise channels</h3>
 <p>Promise channels are special channels that will accept only a single value. Once a value is put to a promise channel, all pending and future consumers will receive only that value. Future puts complete but drop the value. When the channel is closed, consumers will receive either the value (if a put occurred) or nil (if no put occurred) forever.</p>
-<p>Promise channels: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-promise-chan">promise-chan</a></p>
+<ul>
+<li>Promise channels: <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-promise-chan">promise-chan</a></li>
+</ul>
 <h2><a href="#managing-processes" id="managing-processes"></a>Managing processes</h2>
 <h3><a href="#go-blocks-and-threads" id="go-blocks-and-threads"></a>go blocks and threads</h3>
 <p>“Processes”, in the most general sense, are represented either as go blocks or threads. Go blocks model a lightweight computation that can be “parked” (paused) without consuming a thread. Go blocks communicate externally via channels. Any core.async parking operation (<code>&gt;!</code>, <code>&lt;!</code>, <code>alt!</code>, <code>alts!</code>) that cannot be immediately completed will cause the block to park and it will be automatically resumed when the operation can complete (when data has arrived on a channel to allow it).</p>

From f0addbf203fdcb50004d9b8d1477b3c114616788 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Thu, 1 May 2025 13:08:16 -0500
Subject: [PATCH 63/73] add walkthrough

---
 doc/walkthrough.md    | 160 ++++++++++++++++++++++++++++++++++++++++++
 docs/walkthrough.html | 105 +++++++++++++++++++++++++++
 2 files changed, 265 insertions(+)
 create mode 100644 doc/walkthrough.md
 create mode 100644 docs/walkthrough.html

diff --git a/doc/walkthrough.md b/doc/walkthrough.md
new file mode 100644
index 0000000..f593adc
--- /dev/null
+++ b/doc/walkthrough.md
@@ -0,0 +1,160 @@
+# Walkthrough
+
+## Getting started
+
+The core.async library supports asynchronous programming through the use of channels.
+
+To use core.async, declare a dependency on Clojure 1.10.0 or higher and the latest core.async library:
+
+```clojure
+{:deps
+ {org.clojure/clojure {:mvn/version "1.12.0"}
+  org.clojure/core.async {:mvn/version "1.6.673"}}}
+```
+
+To start working with core.async, require the `clojure.core.async` namespace at the REPL:
+
+```clojure
+(require '[clojure.core.async :as a :refer [<!! >!! <! >!]])
+```
+
+Or include it in your namespace:
+
+```clojure
+(ns my.ns
+  (:require [clojure.core.async :as a :refer [<!! >!! <! >!]]))
+```
+
+## Channels
+
+Values are conveyed on queue-like channels. By default channels are unbuffered (0-length) - they require producer and consumer to rendezvous for the transfer of a value through the channel.
+
+Use `chan` to make an unbuffered channel:
+
+```clojure
+(a/chan)
+```
+
+Pass a number to create a channel with a fixed buffer size:
+
+```clojure
+(a/chan 10)
+```
+
+`close!` a channel to stop accepting puts. Remaining values are still available to take. Drained channels return nil on take. Nils may not be sent over a channel explicitly!
+
+```clojure
+(let [c (a/chan)]
+  (a/close! c))
+```
+
+Channels can also use custom buffers that have different policies for the "full" case.  Two useful examples are provided in the API.
+
+```clojure
+;; Use `dropping-buffer` to drop newest values when the buffer is full:
+(a/chan (a/dropping-buffer 10))
+
+;; Use `sliding-buffer` to drop oldest values when the buffer is full:
+(a/chan (a/sliding-buffer 10))
+```
+
+## Threads
+
+In ordinary threads, we use `>!!` (blocking put) and `<!!` (blocking take) to communicate via channels.
+
+```clojure
+(let [c (a/chan 10)]
+  (>!! c "hello")
+  (assert (= "hello" (<!! c)))
+  (a/close! c))
+```
+
+Because these are blocking calls, if we try to put on an unbuffered channel, we will block the main thread. We can use `thread` (like `future`) to execute a body in a pool thread and return a channel with the result. Here we launch a background task to put "hello" on a channel, then read that value in the current thread.
+
+```clojure
+(let [c (a/chan)]
+  (a/thread (>!! c "hello"))
+  (assert (= "hello" (<!! c)))
+  (a/close! c))
+```
+
+## Go Blocks and IOC Threads
+
+The `go` macro asynchronously executes its body in a special pool of threads. Channel operations that would block will pause execution instead, blocking no threads. This mechanism encapsulates the inversion of control that is external in event/callback systems. Inside `go` blocks, we use `>!` (put) and `<!` (take).
+
+Here we convert our prior channel example to use go blocks:
+
+```clojure
+(let [c (a/chan)]
+  (a/go (>! c "hello"))
+  (assert (= "hello" (<!! (a/go (<! c)))))
+  (a/close! c))
+```
+
+Instead of the explicit thread and blocking call, we use a go block for the producer. The consumer uses a go block to take, then returns a result channel, from which we do a blocking take.
+
+== Alts
+
+One killer feature for channels over queues is the ability to wait on many channels at the same time (like a socket select). This is done with `alts!!` (ordinary threads) or `alts!` in go blocks.
+
+We can create a background thread with alts that combines inputs on either of two channels. `alts!!` takes a set of operations to perform - either a channel to take from or a [channel value] to put and returns the value (nil for put) and channel that succeeded:
+
+```clojure
+(let [c1 (a/chan)
+      c2 (a/chan)]
+  (a/thread (while true
+              (let [[v ch] (a/alts!! [c1 c2])]
+                (println "Read" v "from" ch))))
+  (>!! c1 "hi")
+  (>!! c2 "there"))
+```
+
+Prints (on stdout, possibly not visible at your repl):
+
+```
+Read hi from #object[clojure.core.async.impl.channels.ManyToManyChannel ...]
+Read there from #object[clojure.core.async.impl.channels.ManyToManyChannel ...]
+```
+
+We can use alts! to do the same thing with go blocks:
+
+```clojure
+(let [c1 (a/chan)
+      c2 (a/chan)]
+  (a/go (while true
+          (let [[v ch] (a/alts! [c1 c2])]
+            (println "Read" v "from" ch))))
+  (a/go (>! c1 "hi"))
+  (a/go (>! c2 "there")))
+```
+
+Since go blocks are lightweight processes not bound to threads, we can have LOTS of them! Here we create 1000 go blocks that say hi on 1000 channels. We use alts!! to read them as they're ready.
+
+```clojure
+(let [n 1000
+      cs (repeatedly n a/chan)
+      begin (System/currentTimeMillis)]
+  (doseq [c cs] (a/go (>! c "hi")))
+  (dotimes [i n]
+    (let [[v c] (a/alts!! cs)]
+      (assert (= "hi" v))))
+  (println "Read" n "msgs in" (- (System/currentTimeMillis) begin) "ms"))
+```
+
+`timeout` creates a channel that waits for a specified ms, then closes:
+
+```clojure
+(let [t (a/timeout 100)
+      begin (System/currentTimeMillis)]
+  (<!! t)
+  (println "Waited" (- (System/currentTimeMillis) begin)))
+```
+
+We can combine timeout with `alts!` to do timed channel waits.  Here we wait for 100 ms for a value to arrive on the channel, then give up:
+
+```clojure
+(let [c (a/chan)
+      begin (System/currentTimeMillis)]
+  (a/alts!! [c (a/timeout 100)])
+  (println "Gave up after" (- (System/currentTimeMillis) begin)))
+```
\ No newline at end of file
diff --git a/docs/walkthrough.html b/docs/walkthrough.html
new file mode 100644
index 0000000..699d7ec
--- /dev/null
+++ b/docs/walkthrough.html
@@ -0,0 +1,105 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>Walkthrough</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1  current"><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#walkthrough" id="walkthrough"></a>Walkthrough</h1>
+<h2><a href="#getting-started" id="getting-started"></a>Getting started</h2>
+<p>The core.async library supports asynchronous programming through the use of channels.</p>
+<p>To use core.async, declare a dependency on Clojure 1.10.0 or higher and the latest core.async library:</p>
+<pre><code class="language-clojure">{:deps
+ {org.clojure/clojure {:mvn/version "1.12.0"}
+  org.clojure/core.async {:mvn/version "1.6.673"}}}
+</code></pre>
+<p>To start working with core.async, require the <code>clojure.core.async</code> namespace at the REPL:</p>
+<pre><code class="language-clojure">(require '[clojure.core.async :as a :refer [&lt;!! &gt;!! &lt;! &gt;!]])
+</code></pre>
+<p>Or include it in your namespace:</p>
+<pre><code class="language-clojure">(ns my.ns
+  (:require [clojure.core.async :as a :refer [&lt;!! &gt;!! &lt;! &gt;!]]))
+</code></pre>
+<h2><a href="#channels" id="channels"></a>Channels</h2>
+<p>Values are conveyed on queue-like channels. By default channels are unbuffered (0-length) - they require producer and consumer to rendezvous for the transfer of a value through the channel.</p>
+<p>Use <code>chan</code> to make an unbuffered channel:</p>
+<pre><code class="language-clojure">(a/chan)
+</code></pre>
+<p>Pass a number to create a channel with a fixed buffer size:</p>
+<pre><code class="language-clojure">(a/chan 10)
+</code></pre>
+<p><code>close!</code> a channel to stop accepting puts. Remaining values are still available to take. Drained channels return nil on take. Nils may not be sent over a channel explicitly!</p>
+<pre><code class="language-clojure">(let [c (a/chan)]
+  (a/close! c))
+</code></pre>
+<p>Channels can also use custom buffers that have different policies for the “full” case.  Two useful examples are provided in the API.</p>
+<pre><code class="language-clojure">;; Use `dropping-buffer` to drop newest values when the buffer is full:
+(a/chan (a/dropping-buffer 10))
+
+;; Use `sliding-buffer` to drop oldest values when the buffer is full:
+(a/chan (a/sliding-buffer 10))
+</code></pre>
+<h2><a href="#threads" id="threads"></a>Threads</h2>
+<p>In ordinary threads, we use <code>&gt;!!</code> (blocking put) and <code>&lt;!!</code> (blocking take) to communicate via channels.</p>
+<pre><code class="language-clojure">(let [c (a/chan 10)]
+  (&gt;!! c "hello")
+  (assert (= "hello" (&lt;!! c)))
+  (a/close! c))
+</code></pre>
+<p>Because these are blocking calls, if we try to put on an unbuffered channel, we will block the main thread. We can use <code>thread</code> (like <code>future</code>) to execute a body in a pool thread and return a channel with the result. Here we launch a background task to put “hello” on a channel, then read that value in the current thread.</p>
+<pre><code class="language-clojure">(let [c (a/chan)]
+  (a/thread (&gt;!! c "hello"))
+  (assert (= "hello" (&lt;!! c)))
+  (a/close! c))
+</code></pre>
+<h2><a href="#go-blocks-and-ioc-threads" id="go-blocks-and-ioc-threads"></a>Go Blocks and IOC Threads</h2>
+<p>The <code>go</code> macro asynchronously executes its body in a special pool of threads. Channel operations that would block will pause execution instead, blocking no threads. This mechanism encapsulates the inversion of control that is external in event/callback systems. Inside <code>go</code> blocks, we use <code>&gt;!</code> (put) and <code>&lt;!</code> (take).</p>
+<p>Here we convert our prior channel example to use go blocks:</p>
+<pre><code class="language-clojure">(let [c (a/chan)]
+  (a/go (&gt;! c "hello"))
+  (assert (= "hello" (&lt;!! (a/go (&lt;! c)))))
+  (a/close! c))
+</code></pre>
+<p>Instead of the explicit thread and blocking call, we use a go block for the producer. The consumer uses a go block to take, then returns a result channel, from which we do a blocking take.</p>
+<p>== Alts</p>
+<p>One killer feature for channels over queues is the ability to wait on many channels at the same time (like a socket select). This is done with <code>alts!!</code> (ordinary threads) or <code>alts!</code> in go blocks.</p>
+<p>We can create a background thread with alts that combines inputs on either of two channels. <code>alts!!</code> takes a set of operations to perform - either a channel to take from or a <a href="channel value">channel value</a> to put and returns the value (nil for put) and channel that succeeded:</p>
+<pre><code class="language-clojure">(let [c1 (a/chan)
+      c2 (a/chan)]
+  (a/thread (while true
+              (let [[v ch] (a/alts!! [c1 c2])]
+                (println "Read" v "from" ch))))
+  (&gt;!! c1 "hi")
+  (&gt;!! c2 "there"))
+</code></pre>
+<p>Prints (on stdout, possibly not visible at your repl):</p>
+<pre><code>Read hi from #object[clojure.core.async.impl.channels.ManyToManyChannel ...]
+Read there from #object[clojure.core.async.impl.channels.ManyToManyChannel ...]
+</code></pre>
+<p>We can use alts! to do the same thing with go blocks:</p>
+<pre><code class="language-clojure">(let [c1 (a/chan)
+      c2 (a/chan)]
+  (a/go (while true
+          (let [[v ch] (a/alts! [c1 c2])]
+            (println "Read" v "from" ch))))
+  (a/go (&gt;! c1 "hi"))
+  (a/go (&gt;! c2 "there")))
+</code></pre>
+<p>Since go blocks are lightweight processes not bound to threads, we can have LOTS of them! Here we create 1000 go blocks that say hi on 1000 channels. We use alts!! to read them as they’re ready.</p>
+<pre><code class="language-clojure">(let [n 1000
+      cs (repeatedly n a/chan)
+      begin (System/currentTimeMillis)]
+  (doseq [c cs] (a/go (&gt;! c "hi")))
+  (dotimes [i n]
+    (let [[v c] (a/alts!! cs)]
+      (assert (= "hi" v))))
+  (println "Read" n "msgs in" (- (System/currentTimeMillis) begin) "ms"))
+</code></pre>
+<p><code>timeout</code> creates a channel that waits for a specified ms, then closes:</p>
+<pre><code class="language-clojure">(let [t (a/timeout 100)
+      begin (System/currentTimeMillis)]
+  (&lt;!! t)
+  (println "Waited" (- (System/currentTimeMillis) begin)))
+</code></pre>
+<p>We can combine timeout with <code>alts!</code> to do timed channel waits.  Here we wait for 100 ms for a value to arrive on the channel, then give up:</p>
+<pre><code class="language-clojure">(let [c (a/chan)
+      begin (System/currentTimeMillis)]
+  (a/alts!! [c (a/timeout 100)])
+  (println "Gave up after" (- (System/currentTimeMillis) begin)))
+</code></pre>
+</div></div></div></body></html>
\ No newline at end of file

From 6b7f72339e864895de24b56c6d09efbf567b501b Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Thu, 1 May 2025 13:08:32 -0500
Subject: [PATCH 64/73] add walkthrough

---
 deps.edn                              | 2 +-
 doc/reference.md                      | 8 --------
 docs/clojure.core.async.flow.html     | 2 +-
 docs/clojure.core.async.flow.spi.html | 2 +-
 docs/clojure.core.async.html          | 2 +-
 docs/flow.html                        | 2 +-
 docs/index.html                       | 2 +-
 docs/rationale.html                   | 2 +-
 docs/reference.html                   | 9 +--------
 9 files changed, 8 insertions(+), 23 deletions(-)

diff --git a/deps.edn b/deps.edn
index 5ede84b..b0289f5 100644
--- a/deps.edn
+++ b/deps.edn
@@ -29,7 +29,7 @@
          :exec-fn codox.main/generate-docs
          :exec-args {:source-paths ["src/main/clojure"]
                      :namespaces [clojure.core.async clojure.core.async.flow clojure.core.async.flow.spi]
-                     :doc-files ["doc/rationale.md" "doc/reference.md" "doc/flow.md"] 
+                     :doc-files ["doc/rationale.md" "doc/reference.md" "doc/walkthrough.md" "doc/flow.md"] 
                      :output-path "docs"
                      :html {:namespace-list :flat}}}
   }}
diff --git a/doc/reference.md b/doc/reference.md
index 43edd64..e5e0a1f 100644
--- a/doc/reference.md
+++ b/doc/reference.md
@@ -122,11 +122,3 @@ Because the core.async go block thread pool is fixed size, blocking IO operation
 One common issue is the use of core.async blocking operations inside go blocks. core.async includes a debugging facility to detect this situation (other kinds of blocking operation cannot be detected so this covers only part of the problem). To enable go checking, set the Java system property `clojure.core.async.go-checking=true`. This property is read once, at namespace load time, and should be used in development or testing, not in production.
 
 When go checking is active, invalid blocking calls in a go block will throw in go block threads. By default, these will likely throw to the go block thread's uncaught exception handler and be printed, but you can use `Thread/setDefaultUncaughtExceptionHandler` to change the default behavior (or depending on your system, you may have one already that routes to logging).
-
-## More information
-
-See the following for more information:
-
-* [Rationale](https://clojure.github.io/core.async/rationale.html)
-* [API](https://clojure.github.io/core.async)
-* [Source](https://github.com/clojure/core.async)
diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index c0c2feb..9b4cd16 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
diff --git a/docs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
index 50bbdae..102b199 100644
--- a/docs/clojure.core.async.flow.spi.html
+++ b/docs/clojure.core.async.flow.spi.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
 be needed for ordinary use of the library. This protocol is for
 creating new types of Processes that are not possible to create
 with ::flow/process.
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index 674af31..0ece047 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 Set Java system property `clojure.core.async.go-checking` to true
 to validate go blocks do not invoke core.async blocking operations.
diff --git a/docs/flow.html b/docs/flow.html
index ec4e10e..e11b598 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow" id="flow"></a>Flow</h1>
+<html><head><meta charset="UTF-8" /><title>Flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow" id="flow"></a>Flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
 <p>The <a href="https://clojure.github.io/core.async/rationale.html">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
diff --git a/docs/index.html b/docs/index.html
index f2166a7..dafa63f 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="reference.html">Reference</a></li><li><a href="flow.html">Flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="reference.html">Reference</a></li><li><a href="walkthrough.html">Walkthrough</a></li><li><a href="flow.html">Flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
diff --git a/docs/rationale.html b/docs/rationale.html
index d2d8a6e..42ece61 100644
--- a/docs/rationale.html
+++ b/docs/rationale.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
+<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
 <p><em>June 28, 2013</em></p>
 <p><a href="https://github.com/clojure/core.async">core.async</a> is a new contrib library for Clojure that adds support for asynchronous programming using channels.</p>
 <p>There comes a time in all good programs when components or subsystems must stop communicating directly with one another. This is often achieved via the introduction of queues between the producers of data and the consumers/processors of that data. This architectural indirection ensures that important decisions can be made with some degree of independence, and leads to systems that are easier to understand, manage, monitor and change, and make better use of computational resources, etc.</p>
diff --git a/docs/reference.html b/docs/reference.html
index ce80769..bbd5bf8 100644
--- a/docs/reference.html
+++ b/docs/reference.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Reference</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#reference" id="reference"></a>Reference</h1>
+<html><head><meta charset="UTF-8" /><title>Reference</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#reference" id="reference"></a>Reference</h1>
 <h2><a href="#channels" id="channels"></a>Channels</h2>
 <p>Channels are queues that carry values and support multiple writers and readers. Channels are created with <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-chan">chan</a>. Values in a channel are stored in a buffer. Buffers are never unbounded and there are several provided buffer types:</p>
 <ul>
@@ -98,11 +98,4 @@ <h3><a href="#go-checking" id="go-checking"></a><code>go</code> checking</h3>
 <p>Because the core.async go block thread pool is fixed size, blocking IO operations should never be done in go blocks. If all go threads are blocked on blocking operations, you may experience either deadlock or lack of progress.</p>
 <p>One common issue is the use of core.async blocking operations inside go blocks. core.async includes a debugging facility to detect this situation (other kinds of blocking operation cannot be detected so this covers only part of the problem). To enable go checking, set the Java system property <code>clojure.core.async.go-checking=true</code>. This property is read once, at namespace load time, and should be used in development or testing, not in production.</p>
 <p>When go checking is active, invalid blocking calls in a go block will throw in go block threads. By default, these will likely throw to the go block thread’s uncaught exception handler and be printed, but you can use <code>Thread/setDefaultUncaughtExceptionHandler</code> to change the default behavior (or depending on your system, you may have one already that routes to logging).</p>
-<h2><a href="#more-information" id="more-information"></a>More information</h2>
-<p>See the following for more information:</p>
-<ul>
-<li><a href="https://clojure.github.io/core.async/rationale.html">Rationale</a></li>
-<li><a href="https://clojure.github.io/core.async">API</a></li>
-<li><a href="https://github.com/clojure/core.async">Source</a></li>
-</ul>
 </div></div></div></body></html>
\ No newline at end of file

From feacaaa15c3abc7e4113afe31a3353bbfcbeb622 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 2 May 2025 11:31:02 -0500
Subject: [PATCH 65/73] change version in walkthrough

---
 doc/walkthrough.md    | 4 ++--
 docs/walkthrough.html | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/walkthrough.md b/doc/walkthrough.md
index f593adc..831c4f4 100644
--- a/doc/walkthrough.md
+++ b/doc/walkthrough.md
@@ -9,7 +9,7 @@ To use core.async, declare a dependency on Clojure 1.10.0 or higher and the late
 ```clojure
 {:deps
  {org.clojure/clojure {:mvn/version "1.12.0"}
-  org.clojure/core.async {:mvn/version "1.6.673"}}}
+  org.clojure/core.async {:mvn/version "1.8.741"}}}
 ```
 
 To start working with core.async, require the `clojure.core.async` namespace at the REPL:
@@ -157,4 +157,4 @@ We can combine timeout with `alts!` to do timed channel waits.  Here we wait for
       begin (System/currentTimeMillis)]
   (a/alts!! [c (a/timeout 100)])
   (println "Gave up after" (- (System/currentTimeMillis) begin)))
-```
\ No newline at end of file
+```
diff --git a/docs/walkthrough.html b/docs/walkthrough.html
index 699d7ec..b210263 100644
--- a/docs/walkthrough.html
+++ b/docs/walkthrough.html
@@ -6,7 +6,7 @@ <h2><a href="#getting-started" id="getting-started"></a>Getting started</h2>
 <p>To use core.async, declare a dependency on Clojure 1.10.0 or higher and the latest core.async library:</p>
 <pre><code class="language-clojure">{:deps
  {org.clojure/clojure {:mvn/version "1.12.0"}
-  org.clojure/core.async {:mvn/version "1.6.673"}}}
+  org.clojure/core.async {:mvn/version "1.8.741"}}}
 </code></pre>
 <p>To start working with core.async, require the <code>clojure.core.async</code> namespace at the REPL:</p>
 <pre><code class="language-clojure">(require '[clojure.core.async :as a :refer [&lt;!! &gt;!! &lt;! &gt;!]])

From 7c178a92510481bceecea91e7fc862b32955fe15 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 9 May 2025 15:08:19 -0500
Subject: [PATCH 66/73] add step fn arities image

---
 doc/img/step-fn-arities.png | Bin 0 -> 246267 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 doc/img/step-fn-arities.png

diff --git a/doc/img/step-fn-arities.png b/doc/img/step-fn-arities.png
new file mode 100644
index 0000000000000000000000000000000000000000..325031ba339b79610a2b7ab48f8747da459fae25
GIT binary patch
literal 246267
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%0AJOvQ+`1
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

literal 0
HcmV?d00001


From 060289f5a41f206c2fae111588b57555ee936a72 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 9 May 2025 16:50:07 -0500
Subject: [PATCH 67/73] add flow guide

---
 deps.edn                              |   2 +-
 doc/flow-guide.md                     | 132 ++++++++++++++++++++++++++
 docs/clojure.core.async.flow.html     |   2 +-
 docs/clojure.core.async.flow.spi.html |   2 +-
 docs/clojure.core.async.html          |   2 +-
 docs/flow-guide.html                  |  87 +++++++++++++++++
 docs/flow.html                        |   2 +-
 docs/index.html                       |   2 +-
 docs/rationale.html                   |   2 +-
 docs/reference.html                   |   2 +-
 docs/walkthrough.html                 |   2 +-
 11 files changed, 228 insertions(+), 9 deletions(-)
 create mode 100644 doc/flow-guide.md
 create mode 100644 docs/flow-guide.html

diff --git a/deps.edn b/deps.edn
index b0289f5..fe03f46 100644
--- a/deps.edn
+++ b/deps.edn
@@ -29,7 +29,7 @@
          :exec-fn codox.main/generate-docs
          :exec-args {:source-paths ["src/main/clojure"]
                      :namespaces [clojure.core.async clojure.core.async.flow clojure.core.async.flow.spi]
-                     :doc-files ["doc/rationale.md" "doc/reference.md" "doc/walkthrough.md" "doc/flow.md"] 
+                     :doc-files ["doc/rationale.md" "doc/reference.md" "doc/walkthrough.md" "doc/flow.md" "doc/flow-guide.md"] 
                      :output-path "docs"
                      :html {:namespace-list :flat}}}
   }}
diff --git a/doc/flow-guide.md b/doc/flow-guide.md
new file mode 100644
index 0000000..f90463b
--- /dev/null
+++ b/doc/flow-guide.md
@@ -0,0 +1,132 @@
+# Flow Guide
+
+## Getting started
+
+The [flow](https://clojure.github.io/core.async/flow.html) library enables a strict separation application logic from the deployment concerns of topology, execution, communication, lifecycle, monitoring and error handling.
+
+## Step fns and processes
+
+You provide logic to flow in the form of _step-fns_, which are wrapped into running processes, executing in a loop. Flow manages the life cycle of the process and handles incoming and outgoing messages by putting or taking them on channels. Step-fns do not access channels directly or hold state, making them easy to test in isolation and reuse.
+
+Step functions have four arities:
+
+<a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities?raw=true" alt="step-fn arities" width="700"/></a>
+
+### describe (0 arity)
+
+The describe arity must return a static description of the step-fn's :params, :ins, and :outs. Each of these is a map of name (a keyword) to docstring.
+
+For example, the describe arity might return this description for a simple step-fn:
+
+```clojure
+{:params {:size "Max size"}       ;; step-fn params
+ :ins {:in "Input channel"}       ;; input channels
+ :outs {:out "Output channel"}}   ;; output channels
+```
+
+The names used for input and output channels should be distinct (no overlap).
+
+### init (1 arity)
+
+The init arity is called once by the process to takes a set of args from the flow def (corresponding to the params returned from the describe arity) and returns the init state of the process.
+
+### Process state
+
+The process state is a map. It can contain any keys needed by the step-fn transition and transform arities. In addition, there are some flow-specific keys, described here. 
+
+`::flow/pid` is added to the state by the process based on the name supplied in the flow def.
+
+`::flow/in-ports` and `::flow/out-ports` are maps of cid to external channel, optionally returned in the initial state from the init arity. The in-ports and out-ports are used to connect source and sink processes to external channels. These channels must be provided by the step-fn and returned in the init arity map, either by creating the channel or using a channel passed in via the flow def init args for the process. The flow does not manage the lifecycle of these channels.
+
+`::flow/input-filter`, a predicate of cid, can be returned in the state from any arity to indicate a filter on the process input channel read set. For example, a step-fn that is waiting for a response from multiple inputs might remove the channels that have already responded from the read-set until responses have been received from all.
+
+### transition (2 arity)
+
+The transition arity is called any time the flow or process undergoes a lifecycle transition (::flow/start, ::flow/stop, ::flow/pause, ::flow/resume). The description arity takes the current state and returns an updated state to be used for subsequent calls.
+
+The step-fn should use the transition arity to coordinate the creation, pausing, and shutdown of external resources in a process.
+
+### transform (3 arity)
+
+The transform arity is called in a loop by the process for every message received on an input channel and returns a new state and a map of output cids to messages to return. The process will take care of sending these messages to the output channels. Output can be sent to none, any or all of the :outsenumerated, and/or an input named by a [pid inid] tuple (e.g. for reply-to), and/or to the ::flow/report output. A step need not output at all (output or msgs can be empyt/nil), however an output _message_ may never be nil (per core.async channels).
+
+The step-fn may throw excepitons from any arity and they will be handled by flow. Exceptions thrown from the transition or transform arities, the exception will be logged on the flow's :error-chan.
+
+### step-fn helpers
+
+Some additional helpers exist to create step-fns from other forms:
+
+* `lift*->step` - given a fn f taking one arg and returning a collection of non-nil values, creates a step-fn as needed by a process, with one input and one output (named :in and :out), and no state
+* `lift1->step` - like `lift*->step` but for functions that return a single value (when `nil`, yield no output)
+* `map->step` - given a map with keys `:describe`, `:init`, `:transition`, `:transform` corresponding to the arities above, create a step-fn.
+
+### Creating a process
+
+Processes can be created using the [process](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-process) function, which takes a step-fn, and an option map with keys:
+
+* `::workload` - one of `:mixed`, `:io` or `:compute`
+* `:compute-timeout-ms` - if :workload is :compute, this timeout (default 5000 msec) will be used when getting the return from the future - see below
+
+A :workload supplied as an option to process will override any :workload returned by the :describe fn of the process. If neither are provded the default is :mixed.
+
+In the :workload context of :mixed or :io, this dictates the type of thread in which the process loop will run, _including its calls to transform_. 
+
+When :io is specified, transform should not do extensive computation.
+
+When :compute is specified, each call to transform will be run in a separate thread. The process loop will run in an :io context (since it no longer directly calls transform, all it does is I/O) and it will submit transform to the :compute executor then await (blocking, for compute-timeout-ms) the completion of the future returned by the executor. If the future times out it will be reported on ::flow/error.
+
+When :compute is specified transform must not block!
+
+### Reloading
+
+Because the step-fn is called in a loop, it is a good practice to define the step-fn in a var and use the var (`#'the-fn`) instead of the function value itself (`the-fn`). This practice supports interactive development by allowing the var to be rebound from the repl while the flow is running.
+
+## Flow def
+
+The step-fns are how you supply code for each process in the flow. The other thing you must supply is the flow configuration that ties together the procs and the connections between them.
+
+This flow definition is supplied to the [create-flow](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-create-flow) function and consists of a map with `:procs`, `:conns`, and optionally some workflow executors.
+
+The `:procs` is a map of pid -> proc-def. The proc-def is a map with `:proc` (the process function), the `:args` (passed to the init arity of the step-fn), and the `:chan-opts` which can be used to specify channel properties.
+
+The `:conns` is a collection of `[[from-pid outid] [to-pid inid]]` tuples. Inputs and outputs support multiple connections. When an output is connected multiple times, every connection will get every message, per `core.async/mult`.
+
+An example flow definition might look like this for a flow with two procs where the in-chan and out-chan are being passed through the source and sink args:
+
+```clojure
+{:procs {:source-proc {:proc (process #'source-fn)
+                       :args {:source-chan in-chan}}
+         :sink-proc   {:proc (process #'sink-fn)
+                       :args {:sink-chan out-chan}}}
+ :conns [ [[:source-proc :out] [:sink-proc :in]] ]}
+````
+
+The flow is created by passing the flow definition to [create-flow](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-create-flow).
+
+The returned flow object can be passed to the lifecycle methods (see next). In addition the flow can be used with [datafy](https://clojure.github.io/clojure/clojure.datafy-api.html#clojure.datafy/datafy) to get a datafied description of the flow. This is a static view - see `ping` described later for a dynamic view.
+
+## Flow lifecycle
+
+When a flow is created, it starts in the resumed state. The following flow functions can be used to change the flow lifecycle state:
+
+* [start](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-start) - Starts all procs in the flow, return a map of with `:report-chan` and `:error-chan`
+* [stop](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-stop) - Stops all procs in the flow
+* [pause](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-pause) - Pauses all procs in the flow
+* [resume](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-resume) - Resumes all procs in the flow
+* [pause-proc](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-pause-proc) - Pauses a single proc
+* [resume-proc](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-resume-proc) - Resumes a single proc
+
+You can also use these functions to ping the running processes are return their current state and status:
+
+* [ping](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-ping) - Pings all procs and returns a map of their status
+* [ping-proc](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-ping-proc) - Pings a single proce by pid and returns a map of status
+
+This function can be used to inject a message to an arbitrary `[pid cid]` channel:
+
+* [inject](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-inject) - Inject messages to any coord in the flow
+
+The map returned from `start` has the flow's report and error channels. Procs can output messages to the `:report-chan` for unified logging across the flow. Exceptions thrown by a step-fn or procs in the flow are all logged to the `:error-chan`.
+
+## Flow monitor
+
+See [core.async.flow-monitor](https://github.com/clojure/core.async.flow-monitor/) for how to use the flow-monitor tool.
\ No newline at end of file
diff --git a/docs/clojure.core.async.flow.html b/docs/clojure.core.async.flow.html
index 9b4cd16..efc7e2d 100644
--- a/docs/clojure.core.async.flow.html
+++ b/docs/clojure.core.async.flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1 "><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.html#var-create-flow"><div class="inner"><span>create-flow</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-futurize"><div class="inner"><span>futurize</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-inject"><div class="inner"><span>inject</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift*-.3Estep"><div class="inner"><span>lift*-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-lift1-.3Estep"><div class="inner"><span>lift1-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-map-.3Estep"><div class="inner"><span>map-&gt;step</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause"><div class="inner"><span>pause</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-pause-proc"><div class="inner"><span>pause-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping"><div class="inner"><span>ping</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-ping-proc"><div class="inner"><span>ping-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-process"><div class="inner"><span>process</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume"><div class="inner"><span>resume</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-resume-proc"><div class="inner"><span>resume-proc</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-start"><div class="inner"><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.html#var-stop"><div class="inner"><span>stop</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow</h1><div class="doc"><pre class="plaintext">
 Note - Alpha, work-in-progress, names and other details are in flux 
 
 A library for building concurrent, event driven data processing
diff --git a/docs/clojure.core.async.flow.spi.html b/docs/clojure.core.async.flow.spi.html
index 102b199..12eeba3 100644
--- a/docs/clojure.core.async.flow.spi.html
+++ b/docs/clojure.core.async.flow.spi.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
+<html><head><meta charset="UTF-8" /><title>clojure.core.async.flow.spi documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1 "><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 current"><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-ProcLauncher"><div class="inner"><span>ProcLauncher</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-describe"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>describe</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-start"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>start</span></div></a></li><li class="depth-1"><a href="clojure.core.async.flow.spi.html#var-Resolver"><div class="inner"><span>Resolver</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.flow.spi.html#var-get-exec"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-exec</span></div></a></li><li class="depth-2"><a href="clojure.core.async.flow.spi.html#var-get-write-chan"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>get-write-chan</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async.flow.spi</h1><div class="doc"><pre class="plaintext"></pre></div><div class="public anchor" id="var-ProcLauncher"><h3>ProcLauncher</h3><h4 class="type">protocol</h4><div class="usage"></div><div class="doc"><pre class="plaintext">Note - defining a ProcLauncher is an advanced feature and should not
 be needed for ordinary use of the library. This protocol is for
 creating new types of Processes that are not possible to create
 with ::flow/process.
diff --git a/docs/clojure.core.async.html b/docs/clojure.core.async.html
index 0ece047..f74d1d7 100644
--- a/docs/clojure.core.async.html
+++ b/docs/clojure.core.async.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
+<html><head><meta charset="UTF-8" /><title>clojure.core.async documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1 "><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 current"><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21"><div class="inner"><span>&lt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3C.21.21"><div class="inner"><span>&lt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21"><div class="inner"><span>&gt;!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-.3E.21.21"><div class="inner"><span>&gt;!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-admix"><div class="inner"><span>admix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21"><div class="inner"><span>alt!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alt.21.21"><div class="inner"><span>alt!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21"><div class="inner"><span>alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-alts.21.21"><div class="inner"><span>alts!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-buffer"><div class="inner"><span>buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-chan"><div class="inner"><span>chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-close.21"><div class="inner"><span>close!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-defblockingop"><div class="inner"><span>defblockingop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alt"><div class="inner"><span>do-alt</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-do-alts"><div class="inner"><span>do-alts</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-dropping-buffer"><div class="inner"><span>dropping-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-fn-handler"><div class="inner"><span>fn-handler</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go"><div class="inner"><span>go</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-go-loop"><div class="inner"><span>go-loop</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-into"><div class="inner"><span>into</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-io-thread"><div class="inner"><span>io-thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-ioc-alts.21"><div class="inner"><span>ioc-alts!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-map"><div class="inner"><span>map</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-merge"><div class="inner"><span>merge</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mix"><div class="inner"><span>Mix</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-admix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>admix*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-solo-mode*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>solo-mode*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-toggle*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>toggle*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unmix*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unmix-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unmix-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mix"><div class="inner"><span>mix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mult"><div class="inner"><span>Mult</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-tap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>tap*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-untap*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-untap-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>untap-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-mult"><div class="inner"><span>mult</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Mux"><div class="inner"><span>Mux</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-muxch*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>muxch*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-offer.21"><div class="inner"><span>offer!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan"><div class="inner"><span>onto-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21"><div class="inner"><span>onto-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-onto-chan.21.21"><div class="inner"><span>onto-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipe"><div class="inner"><span>pipe</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline"><div class="inner"><span>pipeline</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-async"><div class="inner"><span>pipeline-async</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pipeline-blocking"><div class="inner"><span>pipeline-blocking</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-poll.21"><div class="inner"><span>poll!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-promise-chan"><div class="inner"><span>promise-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-Pub"><div class="inner"><span>Pub</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-sub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>sub*</span></div></a></li><li class="depth-2 branch"><a href="clojure.core.async.html#var-unsub*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub*</span></div></a></li><li class="depth-2"><a href="clojure.core.async.html#var-unsub-all*"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>unsub-all*</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-pub"><div class="inner"><span>pub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-put.21"><div class="inner"><span>put!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-reduce"><div class="inner"><span>reduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sliding-buffer"><div class="inner"><span>sliding-buffer</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-solo-mode"><div class="inner"><span>solo-mode</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-split"><div class="inner"><span>split</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-sub"><div class="inner"><span>sub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take"><div class="inner"><span>take</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-take.21"><div class="inner"><span>take!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-tap"><div class="inner"><span>tap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread"><div class="inner"><span>thread</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-thread-call"><div class="inner"><span>thread-call</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-timeout"><div class="inner"><span>timeout</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan"><div class="inner"><span>to-chan</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21"><div class="inner"><span>to-chan!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-to-chan.21.21"><div class="inner"><span>to-chan!!</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-toggle"><div class="inner"><span>toggle</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-transduce"><div class="inner"><span>transduce</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unblocking-buffer.3F"><div class="inner"><span>unblocking-buffer?</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix"><div class="inner"><span>unmix</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unmix-all"><div class="inner"><span>unmix-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub"><div class="inner"><span>unsub</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-unsub-all"><div class="inner"><span>unsub-all</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap"><div class="inner"><span>untap</span></div></a></li><li class="depth-1"><a href="clojure.core.async.html#var-untap-all"><div class="inner"><span>untap-all</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">clojure.core.async</h1><div class="doc"><pre class="plaintext">Facilities for async programming and communication.
 
 Set Java system property `clojure.core.async.go-checking` to true
 to validate go blocks do not invoke core.async blocking operations.
diff --git a/docs/flow-guide.html b/docs/flow-guide.html
new file mode 100644
index 0000000..78e306e
--- /dev/null
+++ b/docs/flow-guide.html
@@ -0,0 +1,87 @@
+<!DOCTYPE html PUBLIC ""
+    "">
+<html><head><meta charset="UTF-8" /><title>Flow Guide</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1  current"><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow-guide" id="flow-guide"></a>Flow Guide</h1>
+<h2><a href="#getting-started" id="getting-started"></a>Getting started</h2>
+<p>The <a href="https://clojure.github.io/core.async/flow.html">flow</a> library enables a strict separation application logic from the deployment concerns of topology, execution, communication, lifecycle, monitoring and error handling.</p>
+<h2><a href="#step-fns-and-processes" id="step-fns-and-processes"></a>Step fns and processes</h2>
+<p>You provide logic to flow in the form of <em>step-fns</em>, which are wrapped into running processes, executing in a loop. Flow manages the life cycle of the process and handles incoming and outgoing messages by putting or taking them on channels. Step-fns do not access channels directly or hold state, making them easy to test in isolation and reuse.</p>
+<p>Step functions have four arities:</p>
+<p><a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities?raw=true" alt="step-fn arities" width="700" /></a></p>
+<h3><a href="#describe-0-arity" id="describe-0-arity"></a>describe (0 arity)</h3>
+<p>The describe arity must return a static description of the step-fn’s :params, :ins, and :outs. Each of these is a map of name (a keyword) to docstring.</p>
+<p>For example, the describe arity might return this description for a simple step-fn:</p>
+<pre><code class="language-clojure">{:params {:size "Max size"}       ;; step-fn params
+ :ins {:in "Input channel"}       ;; input channels
+ :outs {:out "Output channel"}}   ;; output channels
+</code></pre>
+<p>The names used for input and output channels should be distinct (no overlap).</p>
+<h3><a href="#init-1-arity" id="init-1-arity"></a>init (1 arity)</h3>
+<p>The init arity is called once by the process to takes a set of args from the flow def (corresponding to the params returned from the describe arity) and returns the init state of the process.</p>
+<h3><a href="#process-state" id="process-state"></a>Process state</h3>
+<p>The process state is a map. It can contain any keys needed by the step-fn transition and transform arities. In addition, there are some flow-specific keys, described here.</p>
+<p><code>::flow/pid</code> is added to the state by the process based on the name supplied in the flow def.</p>
+<p><code>::flow/in-ports</code> and <code>::flow/out-ports</code> are maps of cid to external channel, optionally returned in the initial state from the init arity. The in-ports and out-ports are used to connect source and sink processes to external channels. These channels must be provided by the step-fn and returned in the init arity map, either by creating the channel or using a channel passed in via the flow def init args for the process. The flow does not manage the lifecycle of these channels.</p>
+<p><code>::flow/input-filter</code>, a predicate of cid, can be returned in the state from any arity to indicate a filter on the process input channel read set. For example, a step-fn that is waiting for a response from multiple inputs might remove the channels that have already responded from the read-set until responses have been received from all.</p>
+<h3><a href="#transition-2-arity" id="transition-2-arity"></a>transition (2 arity)</h3>
+<p>The transition arity is called any time the flow or process undergoes a lifecycle transition (::flow/start, ::flow/stop, ::flow/pause, ::flow/resume). The description arity takes the current state and returns an updated state to be used for subsequent calls.</p>
+<p>The step-fn should use the transition arity to coordinate the creation, pausing, and shutdown of external resources in a process.</p>
+<h3><a href="#transform-3-arity" id="transform-3-arity"></a>transform (3 arity)</h3>
+<p>The transform arity is called in a loop by the process for every message received on an input channel and returns a new state and a map of output cids to messages to return. The process will take care of sending these messages to the output channels. Output can be sent to none, any or all of the :outsenumerated, and/or an input named by a <a href="pid inid">pid inid</a> tuple (e.g. for reply-to), and/or to the ::flow/report output. A step need not output at all (output or msgs can be empyt/nil), however an output <em>message</em> may never be nil (per core.async channels).</p>
+<p>The step-fn may throw excepitons from any arity and they will be handled by flow. Exceptions thrown from the transition or transform arities, the exception will be logged on the flow’s :error-chan.</p>
+<h3><a href="#step-fn-helpers" id="step-fn-helpers"></a>step-fn helpers</h3>
+<p>Some additional helpers exist to create step-fns from other forms:</p>
+<ul>
+<li><code>lift*-&gt;step</code> - given a fn f taking one arg and returning a collection of non-nil values, creates a step-fn as needed by a process, with one input and one output (named :in and :out), and no state</li>
+<li><code>lift1-&gt;step</code> - like <code>lift*-&gt;step</code> but for functions that return a single value (when <code>nil</code>, yield no output)</li>
+<li><code>map-&gt;step</code> - given a map with keys <code>:describe</code>, <code>:init</code>, <code>:transition</code>, <code>:transform</code> corresponding to the arities above, create a step-fn.</li>
+</ul>
+<h3><a href="#creating-a-process" id="creating-a-process"></a>Creating a process</h3>
+<p>Processes can be created using the <a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-process">process</a> function, which takes a step-fn, and an option map with keys:</p>
+<ul>
+<li><code>::workload</code> - one of <code>:mixed</code>, <code>:io</code> or <code>:compute</code></li>
+<li><code>:compute-timeout-ms</code> - if :workload is :compute, this timeout (default 5000 msec) will be used when getting the return from the future - see below</li>
+</ul>
+<p>A :workload supplied as an option to process will override any :workload returned by the :describe fn of the process. If neither are provded the default is :mixed.</p>
+<p>In the :workload context of :mixed or :io, this dictates the type of thread in which the process loop will run, <em>including its calls to transform</em>.</p>
+<p>When :io is specified, transform should not do extensive computation.</p>
+<p>When :compute is specified, each call to transform will be run in a separate thread. The process loop will run in an :io context (since it no longer directly calls transform, all it does is I/O) and it will submit transform to the :compute executor then await (blocking, for compute-timeout-ms) the completion of the future returned by the executor. If the future times out it will be reported on ::flow/error.</p>
+<p>When :compute is specified transform must not block!</p>
+<h3><a href="#reloading" id="reloading"></a>Reloading</h3>
+<p>Because the step-fn is called in a loop, it is a good practice to define the step-fn in a var and use the var (<code>#'the-fn</code>) instead of the function value itself (<code>the-fn</code>). This practice supports interactive development by allowing the var to be rebound from the repl while the flow is running.</p>
+<h2><a href="#flow-def" id="flow-def"></a>Flow def</h2>
+<p>The step-fns are how you supply code for each process in the flow. The other thing you must supply is the flow configuration that ties together the procs and the connections between them.</p>
+<p>This flow definition is supplied to the <a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-create-flow">create-flow</a> function and consists of a map with <code>:procs</code>, <code>:conns</code>, and optionally some workflow executors.</p>
+<p>The <code>:procs</code> is a map of pid -&gt; proc-def. The proc-def is a map with <code>:proc</code> (the process function), the <code>:args</code> (passed to the init arity of the step-fn), and the <code>:chan-opts</code> which can be used to specify channel properties.</p>
+<p>The <code>:conns</code> is a collection of <code>[[from-pid outid] [to-pid inid]]</code> tuples. Inputs and outputs support multiple connections. When an output is connected multiple times, every connection will get every message, per <code>core.async/mult</code>.</p>
+<p>An example flow definition might look like this for a flow with two procs where the in-chan and out-chan are being passed through the source and sink args:</p>
+<pre><code class="language-clojure">{:procs {:source-proc {:proc (process #'source-fn)
+                       :args {:source-chan in-chan}}
+         :sink-proc   {:proc (process #'sink-fn)
+                       :args {:sink-chan out-chan}}}
+ :conns [ [[:source-proc :out] [:sink-proc :in]] ]}
+</code></pre>
+<p>The flow is created by passing the flow definition to <a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-create-flow">create-flow</a>.</p>
+<p>The returned flow object can be passed to the lifecycle methods (see next). In addition the flow can be used with <a href="https://clojure.github.io/clojure/clojure.datafy-api.html#clojure.datafy/datafy">datafy</a> to get a datafied description of the flow. This is a static view - see <code>ping</code> described later for a dynamic view.</p>
+<h2><a href="#flow-lifecycle" id="flow-lifecycle"></a>Flow lifecycle</h2>
+<p>When a flow is created, it starts in the resumed state. The following flow functions can be used to change the flow lifecycle state:</p>
+<ul>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-start">start</a> - Starts all procs in the flow, return a map of with <code>:report-chan</code> and <code>:error-chan</code></li>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-stop">stop</a> - Stops all procs in the flow</li>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-pause">pause</a> - Pauses all procs in the flow</li>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-resume">resume</a> - Resumes all procs in the flow</li>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-pause-proc">pause-proc</a> - Pauses a single proc</li>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-resume-proc">resume-proc</a> - Resumes a single proc</li>
+</ul>
+<p>You can also use these functions to ping the running processes are return their current state and status:</p>
+<ul>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-ping">ping</a> - Pings all procs and returns a map of their status</li>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-ping-proc">ping-proc</a> - Pings a single proce by pid and returns a map of status</li>
+</ul>
+<p>This function can be used to inject a message to an arbitrary <code>[pid cid]</code> channel:</p>
+<ul>
+<li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-inject">inject</a> - Inject messages to any coord in the flow</li>
+</ul>
+<p>The map returned from <code>start</code> has the flow’s report and error channels. Procs can output messages to the <code>:report-chan</code> for unified logging across the flow. Exceptions thrown by a step-fn or procs in the flow are all logged to the <code>:error-chan</code>.</p>
+<h2><a href="#flow-monitor" id="flow-monitor"></a>Flow monitor</h2>
+<p>See <a href="https://github.com/clojure/core.async.flow-monitor/">core.async.flow-monitor</a> for how to use the flow-monitor tool.</p>
+</div></div></div></body></html>
\ No newline at end of file
diff --git a/docs/flow.html b/docs/flow.html
index e11b598..085227c 100644
--- a/docs/flow.html
+++ b/docs/flow.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow" id="flow"></a>Flow</h1>
+<html><head><meta charset="UTF-8" /><title>Flow</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1  current"><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1 "><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow" id="flow"></a>Flow</h1>
 <h2><a href="#rationale" id="rationale"></a>Rationale</h2>
 <p>The <a href="https://clojure.github.io/core.async/rationale.html">rationale</a> for <strong>core.async</strong> says “There comes a time in all good programs when components or subsystems must stop communicating directly with one another.” And core.async provides fundamental tools (channels) for doing that.</p>
 <p>But using core.async well, e.g. keeping your I/O out of your computational logic, requires discipline and architectural savvy, and to do so consistently throughout an application or organization, conventions. Given channels, many architectural decisions remain regarding thread execution, backpressure, error handling etc. And often the topology of your network of communicating processes <em>emerges</em> out of the flow of control of your program as various pieces of code create threads and wire channels together, interleaved with computation, making it difficult to see the topology or administer it in one place.</p>
diff --git a/docs/index.html b/docs/index.html
index dafa63f..e678e34 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="reference.html">Reference</a></li><li><a href="walkthrough.html">Walkthrough</a></li><li><a href="flow.html">Flow</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
+<html><head><meta charset="UTF-8" /><title> </title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 current"><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1 "><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="namespace-index" id="content"><h1><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></h1><h2>Topics</h2><ul class="topics"><li><a href="rationale.html">Rationale</a></li><li><a href="reference.html">Reference</a></li><li><a href="walkthrough.html">Walkthrough</a></li><li><a href="flow.html">Flow</a></li><li><a href="flow-guide.html">Flow Guide</a></li></ul><h2>Namespaces</h2><div class="namespace"><h3><a href="clojure.core.async.html">clojure.core.async</a></h3><div class="doc"><pre class="plaintext">Facilities for async programming and communication.</pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.html#var-.3C.21">&lt;!</a> </li><li> <a href="clojure.core.async.html#var-.3C.21.21">&lt;!!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21">&gt;!</a> </li><li> <a href="clojure.core.async.html#var-.3E.21.21">&gt;!!</a> </li><li> <a href="clojure.core.async.html#var-admix">admix</a> </li><li> <a href="clojure.core.async.html#var-alt.21">alt!</a> </li><li> <a href="clojure.core.async.html#var-alt.21.21">alt!!</a> </li><li> <a href="clojure.core.async.html#var-alts.21">alts!</a> </li><li> <a href="clojure.core.async.html#var-alts.21.21">alts!!</a> </li><li> <a href="clojure.core.async.html#var-buffer">buffer</a> </li><li> <a href="clojure.core.async.html#var-chan">chan</a> </li><li> <a href="clojure.core.async.html#var-close.21">close!</a> </li><li> <a href="clojure.core.async.html#var-defblockingop">defblockingop</a> </li><li> <a href="clojure.core.async.html#var-do-alt">do-alt</a> </li><li> <a href="clojure.core.async.html#var-do-alts">do-alts</a> </li><li> <a href="clojure.core.async.html#var-dropping-buffer">dropping-buffer</a> </li><li> <a href="clojure.core.async.html#var-fn-handler">fn-handler</a> </li><li> <a href="clojure.core.async.html#var-go">go</a> </li><li> <a href="clojure.core.async.html#var-go-loop">go-loop</a> </li><li> <a href="clojure.core.async.html#var-into">into</a> </li><li> <a href="clojure.core.async.html#var-io-thread">io-thread</a> </li><li> <a href="clojure.core.async.html#var-ioc-alts.21">ioc-alts!</a> </li><li> <a href="clojure.core.async.html#var-map">map</a> </li><li> <a href="clojure.core.async.html#var-merge">merge</a> </li><li> <a href="clojure.core.async.html#var-Mix">Mix</a> </li><li> <a href="clojure.core.async.html#var-mix">mix</a> </li><li> <a href="clojure.core.async.html#var-Mult">Mult</a> </li><li> <a href="clojure.core.async.html#var-mult">mult</a> </li><li> <a href="clojure.core.async.html#var-Mux">Mux</a> </li><li> <a href="clojure.core.async.html#var-offer.21">offer!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan">onto-chan</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21">onto-chan!</a> </li><li> <a href="clojure.core.async.html#var-onto-chan.21.21">onto-chan!!</a> </li><li> <a href="clojure.core.async.html#var-pipe">pipe</a> </li><li> <a href="clojure.core.async.html#var-pipeline">pipeline</a> </li><li> <a href="clojure.core.async.html#var-pipeline-async">pipeline-async</a> </li><li> <a href="clojure.core.async.html#var-pipeline-blocking">pipeline-blocking</a> </li><li> <a href="clojure.core.async.html#var-poll.21">poll!</a> </li><li> <a href="clojure.core.async.html#var-promise-chan">promise-chan</a> </li><li> <a href="clojure.core.async.html#var-Pub">Pub</a> </li><li> <a href="clojure.core.async.html#var-pub">pub</a> </li><li> <a href="clojure.core.async.html#var-put.21">put!</a> </li><li> <a href="clojure.core.async.html#var-reduce">reduce</a> </li><li> <a href="clojure.core.async.html#var-sliding-buffer">sliding-buffer</a> </li><li> <a href="clojure.core.async.html#var-solo-mode">solo-mode</a> </li><li> <a href="clojure.core.async.html#var-split">split</a> </li><li> <a href="clojure.core.async.html#var-sub">sub</a> </li><li> <a href="clojure.core.async.html#var-take">take</a> </li><li> <a href="clojure.core.async.html#var-take.21">take!</a> </li><li> <a href="clojure.core.async.html#var-tap">tap</a> </li><li> <a href="clojure.core.async.html#var-thread">thread</a> </li><li> <a href="clojure.core.async.html#var-thread-call">thread-call</a> </li><li> <a href="clojure.core.async.html#var-timeout">timeout</a> </li><li> <a href="clojure.core.async.html#var-to-chan">to-chan</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21">to-chan!</a> </li><li> <a href="clojure.core.async.html#var-to-chan.21.21">to-chan!!</a> </li><li> <a href="clojure.core.async.html#var-toggle">toggle</a> </li><li> <a href="clojure.core.async.html#var-transduce">transduce</a> </li><li> <a href="clojure.core.async.html#var-unblocking-buffer.3F">unblocking-buffer?</a> </li><li> <a href="clojure.core.async.html#var-unmix">unmix</a> </li><li> <a href="clojure.core.async.html#var-unmix-all">unmix-all</a> </li><li> <a href="clojure.core.async.html#var-unsub">unsub</a> </li><li> <a href="clojure.core.async.html#var-unsub-all">unsub-all</a> </li><li> <a href="clojure.core.async.html#var-untap">untap</a> </li><li> <a href="clojure.core.async.html#var-untap-all">untap-all</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.html">clojure.core.async.flow</a></h3><div class="doc"><pre class="plaintext">Note - Alpha, work-in-progress, names and other details are in flux </pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.html#var-create-flow">create-flow</a> </li><li> <a href="clojure.core.async.flow.html#var-futurize">futurize</a> </li><li> <a href="clojure.core.async.flow.html#var-inject">inject</a> </li><li> <a href="clojure.core.async.flow.html#var-lift*-.3Estep">lift*-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-lift1-.3Estep">lift1-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-map-.3Estep">map-&gt;step</a> </li><li> <a href="clojure.core.async.flow.html#var-pause">pause</a> </li><li> <a href="clojure.core.async.flow.html#var-pause-proc">pause-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-ping">ping</a> </li><li> <a href="clojure.core.async.flow.html#var-ping-proc">ping-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-process">process</a> </li><li> <a href="clojure.core.async.flow.html#var-resume">resume</a> </li><li> <a href="clojure.core.async.flow.html#var-resume-proc">resume-proc</a> </li><li> <a href="clojure.core.async.flow.html#var-start">start</a> </li><li> <a href="clojure.core.async.flow.html#var-stop">stop</a> </li></ul></div></div><div class="namespace"><h3><a href="clojure.core.async.flow.spi.html">clojure.core.async.flow.spi</a></h3><div class="doc"><pre class="plaintext"></pre></div><div class="index"><p>Public variables and functions:</p><ul><li> <a href="clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> </li><li> <a href="clojure.core.async.flow.spi.html#var-Resolver">Resolver</a> </li></ul></div></div></div></body></html>
\ No newline at end of file
diff --git a/docs/rationale.html b/docs/rationale.html
index 42ece61..da15430 100644
--- a/docs/rationale.html
+++ b/docs/rationale.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
+<html><head><meta charset="UTF-8" /><title>Rationale</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1  current"><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1 "><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#rationale" id="rationale"></a>Rationale</h1>
 <p><em>June 28, 2013</em></p>
 <p><a href="https://github.com/clojure/core.async">core.async</a> is a new contrib library for Clojure that adds support for asynchronous programming using channels.</p>
 <p>There comes a time in all good programs when components or subsystems must stop communicating directly with one another. This is often achieved via the introduction of queues between the producers of data and the consumers/processors of that data. This architectural indirection ensures that important decisions can be made with some degree of independence, and leads to systems that are easier to understand, manage, monitor and change, and make better use of computational resources, etc.</p>
diff --git a/docs/reference.html b/docs/reference.html
index bbd5bf8..ff64e8d 100644
--- a/docs/reference.html
+++ b/docs/reference.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Reference</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#reference" id="reference"></a>Reference</h1>
+<html><head><meta charset="UTF-8" /><title>Reference</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1  current"><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1 "><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#reference" id="reference"></a>Reference</h1>
 <h2><a href="#channels" id="channels"></a>Channels</h2>
 <p>Channels are queues that carry values and support multiple writers and readers. Channels are created with <a href="https://clojure.github.io/core.async/clojure.core.async.html#var-chan">chan</a>. Values in a channel are stored in a buffer. Buffers are never unbounded and there are several provided buffer types:</p>
 <ul>
diff --git a/docs/walkthrough.html b/docs/walkthrough.html
index b210263..8ebdcd5 100644
--- a/docs/walkthrough.html
+++ b/docs/walkthrough.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC ""
     "">
-<html><head><meta charset="UTF-8" /><title>Walkthrough</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1  current"><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#walkthrough" id="walkthrough"></a>Walkthrough</h1>
+<html><head><meta charset="UTF-8" /><title>Walkthrough</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1  current"><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1 "><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#walkthrough" id="walkthrough"></a>Walkthrough</h1>
 <h2><a href="#getting-started" id="getting-started"></a>Getting started</h2>
 <p>The core.async library supports asynchronous programming through the use of channels.</p>
 <p>To use core.async, declare a dependency on Clojure 1.10.0 or higher and the latest core.async library:</p>

From 48ee75ee2a3c57524a6246ac9140a6e60e584406 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 9 May 2025 16:51:49 -0500
Subject: [PATCH 68/73] fix image link

---
 doc/flow-guide.md    | 2 +-
 docs/flow-guide.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/flow-guide.md b/doc/flow-guide.md
index f90463b..ff5654b 100644
--- a/doc/flow-guide.md
+++ b/doc/flow-guide.md
@@ -10,7 +10,7 @@ You provide logic to flow in the form of _step-fns_, which are wrapped into runn
 
 Step functions have four arities:
 
-<a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities?raw=true" alt="step-fn arities" width="700"/></a>
+<a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true" alt="step-fn arities" width="700"/></a>
 
 ### describe (0 arity)
 
diff --git a/docs/flow-guide.html b/docs/flow-guide.html
index 78e306e..cefcc08 100644
--- a/docs/flow-guide.html
+++ b/docs/flow-guide.html
@@ -6,7 +6,7 @@ <h2><a href="#getting-started" id="getting-started"></a>Getting started</h2>
 <h2><a href="#step-fns-and-processes" id="step-fns-and-processes"></a>Step fns and processes</h2>
 <p>You provide logic to flow in the form of <em>step-fns</em>, which are wrapped into running processes, executing in a loop. Flow manages the life cycle of the process and handles incoming and outgoing messages by putting or taking them on channels. Step-fns do not access channels directly or hold state, making them easy to test in isolation and reuse.</p>
 <p>Step functions have four arities:</p>
-<p><a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities?raw=true" alt="step-fn arities" width="700" /></a></p>
+<p><a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true" alt="step-fn arities" width="700" /></a></p>
 <h3><a href="#describe-0-arity" id="describe-0-arity"></a>describe (0 arity)</h3>
 <p>The describe arity must return a static description of the step-fn’s :params, :ins, and :outs. Each of these is a map of name (a keyword) to docstring.</p>
 <p>For example, the describe arity might return this description for a simple step-fn:</p>

From 576cfb51f994039df6c42142cde23576b9106f7c Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Mon, 12 May 2025 10:22:26 -0500
Subject: [PATCH 69/73] doc updates

---
 doc/flow-guide.md           |  44 +++++++++++++++++++-----------------
 doc/img/step-fn-arities.png | Bin 246267 -> 83980 bytes
 2 files changed, 23 insertions(+), 21 deletions(-)

diff --git a/doc/flow-guide.md b/doc/flow-guide.md
index ff5654b..0b23fa2 100644
--- a/doc/flow-guide.md
+++ b/doc/flow-guide.md
@@ -4,7 +4,7 @@
 
 The [flow](https://clojure.github.io/core.async/flow.html) library enables a strict separation application logic from the deployment concerns of topology, execution, communication, lifecycle, monitoring and error handling.
 
-## Step fns and processes
+## Step fns and process launchers
 
 You provide logic to flow in the form of _step-fns_, which are wrapped into running processes, executing in a loop. Flow manages the life cycle of the process and handles incoming and outgoing messages by putting or taking them on channels. Step-fns do not access channels directly or hold state, making them easy to test in isolation and reuse.
 
@@ -12,7 +12,7 @@ Step functions have four arities:
 
 <a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true" alt="step-fn arities" width="700"/></a>
 
-### describe (0 arity)
+### describe:  (step-fn) -> descriptor
 
 The describe arity must return a static description of the step-fn's :params, :ins, and :outs. Each of these is a map of name (a keyword) to docstring.
 
@@ -26,48 +26,48 @@ For example, the describe arity might return this description for a simple step-
 
 The names used for input and output channels should be distinct (no overlap).
 
-### init (1 arity)
+### init: (step-fn arg-map) -> init-state
 
 The init arity is called once by the process to takes a set of args from the flow def (corresponding to the params returned from the describe arity) and returns the init state of the process.
 
-### Process state
+### transition: (step-fn state transition) -> state'
 
-The process state is a map. It can contain any keys needed by the step-fn transition and transform arities. In addition, there are some flow-specific keys, described here. 
+The transition arity is called any time the flow or process undergoes a lifecycle transition (::flow/start, ::flow/stop, ::flow/pause, ::flow/resume). The description arity takes the current state and returns an updated state to be used for subsequent calls.
 
-`::flow/pid` is added to the state by the process based on the name supplied in the flow def.
+The step-fn should use the transition arity to coordinate the creation, pausing, and shutdown of external resources in a process.
 
-`::flow/in-ports` and `::flow/out-ports` are maps of cid to external channel, optionally returned in the initial state from the init arity. The in-ports and out-ports are used to connect source and sink processes to external channels. These channels must be provided by the step-fn and returned in the init arity map, either by creating the channel or using a channel passed in via the flow def init args for the process. The flow does not manage the lifecycle of these channels.
+### transform: (step-fn state input msg) -> [state' {out-id [msgs]}]
 
-`::flow/input-filter`, a predicate of cid, can be returned in the state from any arity to indicate a filter on the process input channel read set. For example, a step-fn that is waiting for a response from multiple inputs might remove the channels that have already responded from the read-set until responses have been received from all.
+The transform arity is called in a loop by the process for every message received on an input channel and returns a new state and a map of output cids to messages to return. The process will take care of sending these messages to the output channels. Output can be sent to none, any or all of the :outsenumerated, and/or an input named by a [pid inid] tuple (e.g. for reply-to), and/or to the ::flow/report output. A step need not output at all (output or msgs can be empyt/nil), however an output _message_ may never be nil (per core.async channels).
 
-### transition (2 arity)
+The step-fn may throw excepitons from any arity and they will be handled by flow. Exceptions thrown from the transition or transform arities, the exception will be logged on the flow's :error-chan.
 
-The transition arity is called any time the flow or process undergoes a lifecycle transition (::flow/start, ::flow/stop, ::flow/pause, ::flow/resume). The description arity takes the current state and returns an updated state to be used for subsequent calls.
+### Process state
 
-The step-fn should use the transition arity to coordinate the creation, pausing, and shutdown of external resources in a process.
+The process state is a map. It can contain any keys needed by the step-fn transition and transform arities. In addition, there are some flow-specific keys, described here. 
 
-### transform (3 arity)
+`::flow/pid` is added to the state by the process based on the name supplied in the flow def.
 
-The transform arity is called in a loop by the process for every message received on an input channel and returns a new state and a map of output cids to messages to return. The process will take care of sending these messages to the output channels. Output can be sent to none, any or all of the :outsenumerated, and/or an input named by a [pid inid] tuple (e.g. for reply-to), and/or to the ::flow/report output. A step need not output at all (output or msgs can be empyt/nil), however an output _message_ may never be nil (per core.async channels).
+`::flow/in-ports` and `::flow/out-ports` are maps of cid to external channel, optionally returned in the initial state from the init arity. The in-ports and out-ports are used to connect source and sink processes to external channels. These channels must be provided by the step-fn and returned in the init arity map, either by creating the channel or using a channel passed in via the flow def init args for the process. The flow does not manage the lifecycle of these channels.
 
-The step-fn may throw excepitons from any arity and they will be handled by flow. Exceptions thrown from the transition or transform arities, the exception will be logged on the flow's :error-chan.
+`::flow/input-filter`, a predicate of cid, can be returned in the state from any arity to indicate a filter on the process input channel read set. For example, a step-fn that is waiting for a response from multiple inputs might remove the channels that have already responded from the read-set until responses have been received from all.
 
 ### step-fn helpers
 
 Some additional helpers exist to create step-fns from other forms:
 
-* `lift*->step` - given a fn f taking one arg and returning a collection of non-nil values, creates a step-fn as needed by a process, with one input and one output (named :in and :out), and no state
+* `lift*->step` - given a fn f taking one arg and returning a collection of non-nil values, creates a step-fn as needed by a process launcher, with one input and one output (named :in and :out), and no state
 * `lift1->step` - like `lift*->step` but for functions that return a single value (when `nil`, yield no output)
 * `map->step` - given a map with keys `:describe`, `:init`, `:transition`, `:transform` corresponding to the arities above, create a step-fn.
 
-### Creating a process
+### Creating a process launcher
 
-Processes can be created using the [process](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-process) function, which takes a step-fn, and an option map with keys:
+Process launchers can be created using the [process](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-process) function, which takes a step-fn, and an option map with keys:
 
 * `::workload` - one of `:mixed`, `:io` or `:compute`
 * `:compute-timeout-ms` - if :workload is :compute, this timeout (default 5000 msec) will be used when getting the return from the future - see below
 
-A :workload supplied as an option to process will override any :workload returned by the :describe fn of the process. If neither are provded the default is :mixed.
+A :workload supplied as an option to `process` will override any :workload returned by the :describe fn of the process launcher. If neither are provded the default is :mixed.
 
 In the :workload context of :mixed or :io, this dictates the type of thread in which the process loop will run, _including its calls to transform_. 
 
@@ -77,17 +77,19 @@ When :compute is specified, each call to transform will be run in a separate thr
 
 When :compute is specified transform must not block!
 
+Note that process launchers are defined by the [ProcLauncher](https://clojure.github.io/core.async/clojure.core.async.flow.spi.html#var-ProcLauncher) protocol. While you will typically use `process` to create a process launcher, advanced uses may also implement the protocol directly.
+
 ### Reloading
 
 Because the step-fn is called in a loop, it is a good practice to define the step-fn in a var and use the var (`#'the-fn`) instead of the function value itself (`the-fn`). This practice supports interactive development by allowing the var to be rebound from the repl while the flow is running.
 
 ## Flow def
 
-The step-fns are how you supply code for each process in the flow. The other thing you must supply is the flow configuration that ties together the procs and the connections between them.
+The step-fns are how you supply code for each process in the flow. The other thing you must supply is the flow configuration that ties together the proc launchers and the connections between them.
 
 This flow definition is supplied to the [create-flow](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-create-flow) function and consists of a map with `:procs`, `:conns`, and optionally some workflow executors.
 
-The `:procs` is a map of pid -> proc-def. The proc-def is a map with `:proc` (the process function), the `:args` (passed to the init arity of the step-fn), and the `:chan-opts` which can be used to specify channel properties.
+The `:procs` is a map of pid -> proc-def. The proc-def is a map with `:proc` (the process launcher), the `:args` (passed to the init arity of the step-fn), and the `:chan-opts` which can be used to specify channel properties.
 
 The `:conns` is a collection of `[[from-pid outid] [to-pid inid]]` tuples. Inputs and outputs support multiple connections. When an output is connected multiple times, every connection will get every message, per `core.async/mult`.
 
@@ -116,7 +118,7 @@ When a flow is created, it starts in the resumed state. The following flow funct
 * [pause-proc](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-pause-proc) - Pauses a single proc
 * [resume-proc](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-resume-proc) - Resumes a single proc
 
-You can also use these functions to ping the running processes are return their current state and status:
+You can also use these functions to ping the running processes and return their current state and status:
 
 * [ping](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-ping) - Pings all procs and returns a map of their status
 * [ping-proc](https://clojure.github.io/core.async/clojure.core.async.flow.html#var-ping-proc) - Pings a single proce by pid and returns a map of status
diff --git a/doc/img/step-fn-arities.png b/doc/img/step-fn-arities.png
index 325031ba339b79610a2b7ab48f8747da459fae25..16f81fa75dc40d100e801ca3f005e4b23f9eb984 100644
GIT binary patch
literal 83980
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

literal 246267
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%0AJOvQ+`1
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


From 55580a49d9ab3d1c732fdee78fe52bd632ab51f2 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Mon, 12 May 2025 11:12:32 -0500
Subject: [PATCH 70/73] update docs for publishing

---
 docs/flow-guide.html | 33 +++++++++++++++++----------------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/docs/flow-guide.html b/docs/flow-guide.html
index cefcc08..ea0b1dc 100644
--- a/docs/flow-guide.html
+++ b/docs/flow-guide.html
@@ -3,11 +3,11 @@
 <html><head><meta charset="UTF-8" /><title>Flow Guide</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name"></span> <span class="project-version"></span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="rationale.html"><div class="inner"><span>Rationale</span></div></a></li><li class="depth-1 "><a href="reference.html"><div class="inner"><span>Reference</span></div></a></li><li class="depth-1 "><a href="walkthrough.html"><div class="inner"><span>Walkthrough</span></div></a></li><li class="depth-1 "><a href="flow.html"><div class="inner"><span>Flow</span></div></a></li><li class="depth-1  current"><a href="flow-guide.html"><div class="inner"><span>Flow Guide</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="clojure.core.async.html"><div class="inner"><span>clojure.core.async</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.html"><div class="inner"><span>clojure.core.async.flow</span></div></a></li><li class="depth-1 "><a href="clojure.core.async.flow.spi.html"><div class="inner"><span>clojure.core.async.flow.spi</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#flow-guide" id="flow-guide"></a>Flow Guide</h1>
 <h2><a href="#getting-started" id="getting-started"></a>Getting started</h2>
 <p>The <a href="https://clojure.github.io/core.async/flow.html">flow</a> library enables a strict separation application logic from the deployment concerns of topology, execution, communication, lifecycle, monitoring and error handling.</p>
-<h2><a href="#step-fns-and-processes" id="step-fns-and-processes"></a>Step fns and processes</h2>
+<h2><a href="#step-fns-and-process-launchers" id="step-fns-and-process-launchers"></a>Step fns and process launchers</h2>
 <p>You provide logic to flow in the form of <em>step-fns</em>, which are wrapped into running processes, executing in a loop. Flow manages the life cycle of the process and handles incoming and outgoing messages by putting or taking them on channels. Step-fns do not access channels directly or hold state, making them easy to test in isolation and reuse.</p>
 <p>Step functions have four arities:</p>
 <p><a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true" alt="step-fn arities" width="700" /></a></p>
-<h3><a href="#describe-0-arity" id="describe-0-arity"></a>describe (0 arity)</h3>
+<h3><a href="#describe-step-fn-descriptor" id="describe-step-fn-descriptor"></a>describe:  (step-fn) -&gt; descriptor</h3>
 <p>The describe arity must return a static description of the step-fn’s :params, :ins, and :outs. Each of these is a map of name (a keyword) to docstring.</p>
 <p>For example, the describe arity might return this description for a simple step-fn:</p>
 <pre><code class="language-clojure">{:params {:size "Max size"}       ;; step-fn params
@@ -15,43 +15,44 @@ <h3><a href="#describe-0-arity" id="describe-0-arity"></a>describe (0 arity)</h3
  :outs {:out "Output channel"}}   ;; output channels
 </code></pre>
 <p>The names used for input and output channels should be distinct (no overlap).</p>
-<h3><a href="#init-1-arity" id="init-1-arity"></a>init (1 arity)</h3>
+<h3><a href="#init-step-fn-arg-map-init-state" id="init-step-fn-arg-map-init-state"></a>init: (step-fn arg-map) -&gt; init-state</h3>
 <p>The init arity is called once by the process to takes a set of args from the flow def (corresponding to the params returned from the describe arity) and returns the init state of the process.</p>
+<h3><a href="#transition-step-fn-state-transition-state" id="transition-step-fn-state-transition-state"></a>transition: (step-fn state transition) -&gt; state’</h3>
+<p>The transition arity is called any time the flow or process undergoes a lifecycle transition (::flow/start, ::flow/stop, ::flow/pause, ::flow/resume). The description arity takes the current state and returns an updated state to be used for subsequent calls.</p>
+<p>The step-fn should use the transition arity to coordinate the creation, pausing, and shutdown of external resources in a process.</p>
+<h3><a href="#transform-step-fn-state-input-msg-state-out-id-msgs" id="transform-step-fn-state-input-msg-state-out-id-msgs"></a>transform: (step-fn state input msg) -&gt; [state’ {out-id <a href="msgs">msgs</a>}]</h3>
+<p>The transform arity is called in a loop by the process for every message received on an input channel and returns a new state and a map of output cids to messages to return. The process will take care of sending these messages to the output channels. Output can be sent to none, any or all of the :outsenumerated, and/or an input named by a <a href="pid inid">pid inid</a> tuple (e.g. for reply-to), and/or to the ::flow/report output. A step need not output at all (output or msgs can be empyt/nil), however an output <em>message</em> may never be nil (per core.async channels).</p>
+<p>The step-fn may throw excepitons from any arity and they will be handled by flow. Exceptions thrown from the transition or transform arities, the exception will be logged on the flow’s :error-chan.</p>
 <h3><a href="#process-state" id="process-state"></a>Process state</h3>
 <p>The process state is a map. It can contain any keys needed by the step-fn transition and transform arities. In addition, there are some flow-specific keys, described here.</p>
 <p><code>::flow/pid</code> is added to the state by the process based on the name supplied in the flow def.</p>
 <p><code>::flow/in-ports</code> and <code>::flow/out-ports</code> are maps of cid to external channel, optionally returned in the initial state from the init arity. The in-ports and out-ports are used to connect source and sink processes to external channels. These channels must be provided by the step-fn and returned in the init arity map, either by creating the channel or using a channel passed in via the flow def init args for the process. The flow does not manage the lifecycle of these channels.</p>
 <p><code>::flow/input-filter</code>, a predicate of cid, can be returned in the state from any arity to indicate a filter on the process input channel read set. For example, a step-fn that is waiting for a response from multiple inputs might remove the channels that have already responded from the read-set until responses have been received from all.</p>
-<h3><a href="#transition-2-arity" id="transition-2-arity"></a>transition (2 arity)</h3>
-<p>The transition arity is called any time the flow or process undergoes a lifecycle transition (::flow/start, ::flow/stop, ::flow/pause, ::flow/resume). The description arity takes the current state and returns an updated state to be used for subsequent calls.</p>
-<p>The step-fn should use the transition arity to coordinate the creation, pausing, and shutdown of external resources in a process.</p>
-<h3><a href="#transform-3-arity" id="transform-3-arity"></a>transform (3 arity)</h3>
-<p>The transform arity is called in a loop by the process for every message received on an input channel and returns a new state and a map of output cids to messages to return. The process will take care of sending these messages to the output channels. Output can be sent to none, any or all of the :outsenumerated, and/or an input named by a <a href="pid inid">pid inid</a> tuple (e.g. for reply-to), and/or to the ::flow/report output. A step need not output at all (output or msgs can be empyt/nil), however an output <em>message</em> may never be nil (per core.async channels).</p>
-<p>The step-fn may throw excepitons from any arity and they will be handled by flow. Exceptions thrown from the transition or transform arities, the exception will be logged on the flow’s :error-chan.</p>
 <h3><a href="#step-fn-helpers" id="step-fn-helpers"></a>step-fn helpers</h3>
 <p>Some additional helpers exist to create step-fns from other forms:</p>
 <ul>
-<li><code>lift*-&gt;step</code> - given a fn f taking one arg and returning a collection of non-nil values, creates a step-fn as needed by a process, with one input and one output (named :in and :out), and no state</li>
+<li><code>lift*-&gt;step</code> - given a fn f taking one arg and returning a collection of non-nil values, creates a step-fn as needed by a process launcher, with one input and one output (named :in and :out), and no state</li>
 <li><code>lift1-&gt;step</code> - like <code>lift*-&gt;step</code> but for functions that return a single value (when <code>nil</code>, yield no output)</li>
 <li><code>map-&gt;step</code> - given a map with keys <code>:describe</code>, <code>:init</code>, <code>:transition</code>, <code>:transform</code> corresponding to the arities above, create a step-fn.</li>
 </ul>
-<h3><a href="#creating-a-process" id="creating-a-process"></a>Creating a process</h3>
-<p>Processes can be created using the <a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-process">process</a> function, which takes a step-fn, and an option map with keys:</p>
+<h3><a href="#creating-a-process-launcher" id="creating-a-process-launcher"></a>Creating a process launcher</h3>
+<p>Process launchers can be created using the <a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-process">process</a> function, which takes a step-fn, and an option map with keys:</p>
 <ul>
 <li><code>::workload</code> - one of <code>:mixed</code>, <code>:io</code> or <code>:compute</code></li>
 <li><code>:compute-timeout-ms</code> - if :workload is :compute, this timeout (default 5000 msec) will be used when getting the return from the future - see below</li>
 </ul>
-<p>A :workload supplied as an option to process will override any :workload returned by the :describe fn of the process. If neither are provded the default is :mixed.</p>
+<p>A :workload supplied as an option to <code>process</code> will override any :workload returned by the :describe fn of the process launcher. If neither are provded the default is :mixed.</p>
 <p>In the :workload context of :mixed or :io, this dictates the type of thread in which the process loop will run, <em>including its calls to transform</em>.</p>
 <p>When :io is specified, transform should not do extensive computation.</p>
 <p>When :compute is specified, each call to transform will be run in a separate thread. The process loop will run in an :io context (since it no longer directly calls transform, all it does is I/O) and it will submit transform to the :compute executor then await (blocking, for compute-timeout-ms) the completion of the future returned by the executor. If the future times out it will be reported on ::flow/error.</p>
 <p>When :compute is specified transform must not block!</p>
+<p>Note that process launchers are defined by the <a href="https://clojure.github.io/core.async/clojure.core.async.flow.spi.html#var-ProcLauncher">ProcLauncher</a> protocol. While you will typically use <code>process</code> to create a process launcher, advanced uses may also implement the protocol directly.</p>
 <h3><a href="#reloading" id="reloading"></a>Reloading</h3>
 <p>Because the step-fn is called in a loop, it is a good practice to define the step-fn in a var and use the var (<code>#'the-fn</code>) instead of the function value itself (<code>the-fn</code>). This practice supports interactive development by allowing the var to be rebound from the repl while the flow is running.</p>
 <h2><a href="#flow-def" id="flow-def"></a>Flow def</h2>
-<p>The step-fns are how you supply code for each process in the flow. The other thing you must supply is the flow configuration that ties together the procs and the connections between them.</p>
+<p>The step-fns are how you supply code for each process in the flow. The other thing you must supply is the flow configuration that ties together the proc launchers and the connections between them.</p>
 <p>This flow definition is supplied to the <a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-create-flow">create-flow</a> function and consists of a map with <code>:procs</code>, <code>:conns</code>, and optionally some workflow executors.</p>
-<p>The <code>:procs</code> is a map of pid -&gt; proc-def. The proc-def is a map with <code>:proc</code> (the process function), the <code>:args</code> (passed to the init arity of the step-fn), and the <code>:chan-opts</code> which can be used to specify channel properties.</p>
+<p>The <code>:procs</code> is a map of pid -&gt; proc-def. The proc-def is a map with <code>:proc</code> (the process launcher), the <code>:args</code> (passed to the init arity of the step-fn), and the <code>:chan-opts</code> which can be used to specify channel properties.</p>
 <p>The <code>:conns</code> is a collection of <code>[[from-pid outid] [to-pid inid]]</code> tuples. Inputs and outputs support multiple connections. When an output is connected multiple times, every connection will get every message, per <code>core.async/mult</code>.</p>
 <p>An example flow definition might look like this for a flow with two procs where the in-chan and out-chan are being passed through the source and sink args:</p>
 <pre><code class="language-clojure">{:procs {:source-proc {:proc (process #'source-fn)
@@ -72,7 +73,7 @@ <h2><a href="#flow-lifecycle" id="flow-lifecycle"></a>Flow lifecycle</h2>
 <li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-pause-proc">pause-proc</a> - Pauses a single proc</li>
 <li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-resume-proc">resume-proc</a> - Resumes a single proc</li>
 </ul>
-<p>You can also use these functions to ping the running processes are return their current state and status:</p>
+<p>You can also use these functions to ping the running processes and return their current state and status:</p>
 <ul>
 <li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-ping">ping</a> - Pings all procs and returns a map of their status</li>
 <li><a href="https://clojure.github.io/core.async/clojure.core.async.flow.html#var-ping-proc">ping-proc</a> - Pings a single proce by pid and returns a map of status</li>

From 0a49c7a02bdc8ad107c24ddef6d3eaae15fa378b Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Mon, 12 May 2025 11:38:05 -0500
Subject: [PATCH 71/73] formatting

---
 doc/flow-guide.md    | 8 ++++----
 docs/flow-guide.html | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/doc/flow-guide.md b/doc/flow-guide.md
index 0b23fa2..f316163 100644
--- a/doc/flow-guide.md
+++ b/doc/flow-guide.md
@@ -12,7 +12,7 @@ Step functions have four arities:
 
 <a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true" alt="step-fn arities" width="700"/></a>
 
-### describe:  (step-fn) -> descriptor
+### describe:  `(step-fn) -> descriptor`
 
 The describe arity must return a static description of the step-fn's :params, :ins, and :outs. Each of these is a map of name (a keyword) to docstring.
 
@@ -26,17 +26,17 @@ For example, the describe arity might return this description for a simple step-
 
 The names used for input and output channels should be distinct (no overlap).
 
-### init: (step-fn arg-map) -> init-state
+### init: `(step-fn arg-map) -> init-state`
 
 The init arity is called once by the process to takes a set of args from the flow def (corresponding to the params returned from the describe arity) and returns the init state of the process.
 
-### transition: (step-fn state transition) -> state'
+### transition: `(step-fn state transition) -> state'`
 
 The transition arity is called any time the flow or process undergoes a lifecycle transition (::flow/start, ::flow/stop, ::flow/pause, ::flow/resume). The description arity takes the current state and returns an updated state to be used for subsequent calls.
 
 The step-fn should use the transition arity to coordinate the creation, pausing, and shutdown of external resources in a process.
 
-### transform: (step-fn state input msg) -> [state' {out-id [msgs]}]
+### transform: `(step-fn state input msg) -> [state' {out-id [msgs]}]`
 
 The transform arity is called in a loop by the process for every message received on an input channel and returns a new state and a map of output cids to messages to return. The process will take care of sending these messages to the output channels. Output can be sent to none, any or all of the :outsenumerated, and/or an input named by a [pid inid] tuple (e.g. for reply-to), and/or to the ::flow/report output. A step need not output at all (output or msgs can be empyt/nil), however an output _message_ may never be nil (per core.async channels).
 
diff --git a/docs/flow-guide.html b/docs/flow-guide.html
index ea0b1dc..1833f97 100644
--- a/docs/flow-guide.html
+++ b/docs/flow-guide.html
@@ -7,7 +7,7 @@ <h2><a href="#step-fns-and-process-launchers" id="step-fns-and-process-launchers
 <p>You provide logic to flow in the form of <em>step-fns</em>, which are wrapped into running processes, executing in a loop. Flow manages the life cycle of the process and handles incoming and outgoing messages by putting or taking them on channels. Step-fns do not access channels directly or hold state, making them easy to test in isolation and reuse.</p>
 <p>Step functions have four arities:</p>
 <p><a href="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true"><img src="https://github.com/clojure/core.async/blob/master/doc/img/step-fn-arities.png?raw=true" alt="step-fn arities" width="700" /></a></p>
-<h3><a href="#describe-step-fn-descriptor" id="describe-step-fn-descriptor"></a>describe:  (step-fn) -&gt; descriptor</h3>
+<h3><a href="#describe-step-fn-descriptor" id="describe-step-fn-descriptor"></a>describe:  <code>(step-fn) -&gt; descriptor</code></h3>
 <p>The describe arity must return a static description of the step-fn’s :params, :ins, and :outs. Each of these is a map of name (a keyword) to docstring.</p>
 <p>For example, the describe arity might return this description for a simple step-fn:</p>
 <pre><code class="language-clojure">{:params {:size "Max size"}       ;; step-fn params
@@ -15,12 +15,12 @@ <h3><a href="#describe-step-fn-descriptor" id="describe-step-fn-descriptor"></a>
  :outs {:out "Output channel"}}   ;; output channels
 </code></pre>
 <p>The names used for input and output channels should be distinct (no overlap).</p>
-<h3><a href="#init-step-fn-arg-map-init-state" id="init-step-fn-arg-map-init-state"></a>init: (step-fn arg-map) -&gt; init-state</h3>
+<h3><a href="#init-step-fn-arg-map-init-state" id="init-step-fn-arg-map-init-state"></a>init: <code>(step-fn arg-map) -&gt; init-state</code></h3>
 <p>The init arity is called once by the process to takes a set of args from the flow def (corresponding to the params returned from the describe arity) and returns the init state of the process.</p>
-<h3><a href="#transition-step-fn-state-transition-state" id="transition-step-fn-state-transition-state"></a>transition: (step-fn state transition) -&gt; state’</h3>
+<h3><a href="#transition-step-fn-state-transition-state" id="transition-step-fn-state-transition-state"></a>transition: <code>(step-fn state transition) -&gt; state'</code></h3>
 <p>The transition arity is called any time the flow or process undergoes a lifecycle transition (::flow/start, ::flow/stop, ::flow/pause, ::flow/resume). The description arity takes the current state and returns an updated state to be used for subsequent calls.</p>
 <p>The step-fn should use the transition arity to coordinate the creation, pausing, and shutdown of external resources in a process.</p>
-<h3><a href="#transform-step-fn-state-input-msg-state-out-id-msgs" id="transform-step-fn-state-input-msg-state-out-id-msgs"></a>transform: (step-fn state input msg) -&gt; [state’ {out-id <a href="msgs">msgs</a>}]</h3>
+<h3><a href="#transform-step-fn-state-input-msg-state-out-id-msgs" id="transform-step-fn-state-input-msg-state-out-id-msgs"></a>transform: <code>(step-fn state input msg) -&gt; [state' {out-id [msgs]}]</code></h3>
 <p>The transform arity is called in a loop by the process for every message received on an input channel and returns a new state and a map of output cids to messages to return. The process will take care of sending these messages to the output channels. Output can be sent to none, any or all of the :outsenumerated, and/or an input named by a <a href="pid inid">pid inid</a> tuple (e.g. for reply-to), and/or to the ::flow/report output. A step need not output at all (output or msgs can be empyt/nil), however an output <em>message</em> may never be nil (per core.async channels).</p>
 <p>The step-fn may throw excepitons from any arity and they will be handled by flow. Exceptions thrown from the transition or transform arities, the exception will be logged on the flow’s :error-chan.</p>
 <h3><a href="#process-state" id="process-state"></a>Process state</h3>

From 109bcce683d154e3dd1dbb02820844e769593b99 Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Mon, 19 May 2025 23:40:44 -0500
Subject: [PATCH 72/73] remove bad link in walkthrough

---
 doc/walkthrough.md    | 2 +-
 docs/walkthrough.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/walkthrough.md b/doc/walkthrough.md
index 831c4f4..530205b 100644
--- a/doc/walkthrough.md
+++ b/doc/walkthrough.md
@@ -97,7 +97,7 @@ Instead of the explicit thread and blocking call, we use a go block for the prod
 
 One killer feature for channels over queues is the ability to wait on many channels at the same time (like a socket select). This is done with `alts!!` (ordinary threads) or `alts!` in go blocks.
 
-We can create a background thread with alts that combines inputs on either of two channels. `alts!!` takes a set of operations to perform - either a channel to take from or a [channel value] to put and returns the value (nil for put) and channel that succeeded:
+We can create a background thread with alts that combines inputs on either of two channels. `alts!!` takes a set of operations to perform - either a channel to take from or a channel value to put and returns the value (nil for put) and channel that succeeded:
 
 ```clojure
 (let [c1 (a/chan)
diff --git a/docs/walkthrough.html b/docs/walkthrough.html
index 8ebdcd5..45cc9a3 100644
--- a/docs/walkthrough.html
+++ b/docs/walkthrough.html
@@ -58,7 +58,7 @@ <h2><a href="#go-blocks-and-ioc-threads" id="go-blocks-and-ioc-threads"></a>Go B
 <p>Instead of the explicit thread and blocking call, we use a go block for the producer. The consumer uses a go block to take, then returns a result channel, from which we do a blocking take.</p>
 <p>== Alts</p>
 <p>One killer feature for channels over queues is the ability to wait on many channels at the same time (like a socket select). This is done with <code>alts!!</code> (ordinary threads) or <code>alts!</code> in go blocks.</p>
-<p>We can create a background thread with alts that combines inputs on either of two channels. <code>alts!!</code> takes a set of operations to perform - either a channel to take from or a <a href="channel value">channel value</a> to put and returns the value (nil for put) and channel that succeeded:</p>
+<p>We can create a background thread with alts that combines inputs on either of two channels. <code>alts!!</code> takes a set of operations to perform - either a channel to take from or a channel value to put and returns the value (nil for put) and channel that succeeded:</p>
 <pre><code class="language-clojure">(let [c1 (a/chan)
       c2 (a/chan)]
   (a/thread (while true

From 254cdb6938256679c300d69ee1fac163020690ba Mon Sep 17 00:00:00 2001
From: Alex Miller <alex.miller@cognitect.com>
Date: Fri, 30 May 2025 14:22:17 -0500
Subject: [PATCH 73/73] update to new parent pom

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 5ab7ec0..d93b5b0 100644
--- a/pom.xml
+++ b/pom.xml
@@ -20,7 +20,7 @@
   <parent>
     <groupId>org.clojure</groupId>
     <artifactId>pom.contrib</artifactId>
-    <version>1.2.0</version>
+    <version>1.3.0</version>
   </parent>
 
   <scm>