Merge pull request #93 from php-http/exceptions

Add exception explanation, fixes #87

Author: sagikazarmark

src/HttpAsyncClient.php

@@ -15,9 +15,13 @@ interface HttpAsyncClient
     /**
      * Sends a PSR-7 request in an asynchronous way.
      *
+     * Exceptions related to processing the request are available from the returned Promise.
+     *
      * @param RequestInterface $request
      *
      * @return Promise
+     *
+     * @throws \Exception If processing the request is impossible (eg. bad configuration).
      */
     public function sendAsyncRequest(RequestInterface $request);
 }

src/HttpClient.php

@@ -21,7 +21,8 @@ interface HttpClient
      *
      * @return ResponseInterface
      *
-     * @throws Exception
+     * @throws \Http\Client\Exception If an error happens during processing the request.
+     * @throws \Exception             If processing the request is impossible (eg. bad configuration).
      */
     public function sendRequest(RequestInterface $request);
 }