diff --git a/src/main/clojure/cljs/core/async.cljs b/src/main/clojure/cljs/core/async.cljs
index 2e5664f..7d40104 100644
--- a/src/main/clojure/cljs/core/async.cljs
+++ b/src/main/clojure/cljs/core/async.cljs
@@ -78,7 +78,8 @@
   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. See chan for the semantics of xform and ex-handler."
+  channel is closed, then return the value (or nil) forever. See chan for the
+  semantics of xform and ex-handler."
   ([] (promise-chan nil))
   ([xform] (promise-chan xform nil))
   ([xform ex-handler]