Fixes doc strings and readme

Author: jtkDvlp

README.md

@@ -75,8 +75,8 @@ Add the following dependency to your `project.clj`:<br>
       (->> (?do-some-more-stuff)
            (a/<!)
            (println "success"))
-      (catch #?(:clj clojure.lang.ExceptionInfo
-                :cljs ExceptionInfo) e
+      (catch #?(:clj Throwable
+                :cljs :default) e
         (println "there is an error" e)))))
 ```
 

src/jtk_dvlp/async.cljc

@@ -23,7 +23,6 @@
 
 
 (defn chan?
-  "Checks `x` of type channel (`clojure.core.async.impl.channels/ManyToManyChannel` / `cljs.core.async.impl.channels/ManyToManyChannel`)."
   [x]
   (instance? ManyToManyChannel x))
 
@@ -39,7 +38,7 @@
 
 #?(:clj
    (defmacro go
-     "Like `core.async/go` but carries thrown exception as result."
+     "Like `core.async/go` but carries thrown error / exception as result."
      [& body]
      (if (:ns &env)
        `(cljs.core.async/go
@@ -59,15 +58,15 @@
 
 #?(:clj
    (defmacro go-loop
-     "Like `core.async/go-loop` but carries thrown exception as result."
+     "Like `core.async/go-loop` but carries thrown error / exception as result."
      [bindings & body]
      `(jtk-dvlp.async/go
         (loop ~bindings
           ~@body))))
 
 #?(:clj
    (defmacro <!
-     "Like `core.async/<!` but tests taken val instance of exception, if so throws it."
+     "Like `core.async/<!` but tests taken val of error / exception, if so throws it."
      [?exp]
      (if (:ns &env)
        `(let [v# (cljs.core.async/<! ~?exp)]
@@ -89,7 +88,7 @@
           v#))))
 
 (defn map
-  "Like `core.async/map` but carries thrown exception as result."
+  "Like `core.async/map` but carries thrown error / exception as result."
   [f chs]
   (async/map
    (fn [& args]
@@ -114,7 +113,7 @@
    chs))
 
 (defn reduce
-  "Like `core.async/reduce` but carries thrown exception as result."
+  "Like `core.async/reduce` but carries thrown error / exception as result."
   [f init ch]
   (async/reduce
    (fn [accu v]
@@ -139,6 +138,6 @@
    init ch))
 
 (defn into
-  "Like `core.async/into` but carries thrown exception as result."
+  "Like `core.async/into` but carries thrown error / exception as result."
   [coll ch]
   (reduce conj coll ch))

src/jtk_dvlp/async/interop/callback.cljc

@@ -36,7 +36,7 @@
       closing the channel! Otherwise channel will be closed after first put
       (resolve or reject).
 
-      If calling `exp` fails an `ExceptionInfo` will be put onto the
+      If calling `exp` fails an error / exception will be put onto the
       new created channel with fail information. The channel will be
       closed then.
 
@@ -64,7 +64,7 @@
                (<cb!)
                (println))
 
-           (catch clojure.lang.ExceptionInfo e
+           (catch Throwable e
          (println e)))))
       ```"
 

src/jtk_dvlp/async/interop/promise.cljc

@@ -11,11 +11,7 @@
      :cljs
      (:require
       [cljs.core.async :as async]
-      [jtk-dvlp.async]))
-
-  #?(:clj
-     (:import
-      [clojure.lang ExceptionInfo])))
+      [jtk-dvlp.async])))
 
 
 (defn p->c
@@ -60,8 +56,7 @@
 
 (defn c->p
   "Creates a promise and resolves it with the val of channel `c`
-   taken by `<!`, excepted val is an instance of `ExceptionInfo` rejects the
-   promise. Closes the channel after took val."
+   taken by `<!` or rejects it on error / exception. Closes the channel after took val."
   [c]
   (create-promise
    (fn [resolve reject]
@@ -97,9 +92,9 @@
      c)))
 
 (defn ->promise-chan
-  "Ensure given channel `c` to be a `promise-chan` via
-   `pipe` it into a new `promise-chan`. See `core.async/promise-chan`
-   for more infos. Auto close channel `c`."
+  "Ensure given channel `c` to be a `promise-chan`.
+   See `core.async/promise-chan` for more infos.
+   Auto closes channel `c`."
   [c]
   (let [p (async/promise-chan)]
     (async/take!