When calling the connect! function with an known host name, it throws an exception. I guess I shouldn't have been surprised.
For each function in the API would you mind adding the possible exceptions that may occur, so that clients know what to trap?
The problem is that there is half a dozen of I/O exceptions that may occur, some having multiple causes. We will see.
Not every possible exception type that can be thrown from a function needs to be documented. Just the causes that make sense from treating the function as a black box. For instance connect! throws an exception when it fails to connect to the server. It might even be good enough to indicate which functions throws any exception.
Overall, the library has great documentation. It is one the best documented clojure projects I've seen. Thanks.