Document exceptions

Author: ddeboer

httplug/exceptions.rst

@@ -0,0 +1,20 @@
+Exceptions
+==========
+
+HTTPlug defines one Exception interface: ``Http\Client\Exception``. All HTTP
+client exceptions must implement this interface.
+
+``HttpClient::sendRequest()`` can throw one of the following exceptions.
+
+================================== ====================== ===================
+Exception                          Thrown when            Methods available
+================================== ====================== ===================
+TransferException                  ???
+└ RequestException                 the request is invalid ``getRequest()``
+ |nbsp| |nbsp| └ NetworkException  no response received
+                                   due to network issues  ``getRequest()``
+ |nbsp| |nbsp| └ HttpException     error response         ``getRequest()``
+                                                          ``getResponse()``
+================================== ====================== ===================
+
+.. |nbsp| unicode:: U+00A0 .. non-breaking space

index.rst

@@ -65,6 +65,7 @@ for discussion around a future HTTP client PSR.
 
    Introduction <httplug/introduction>
    Usage <httplug/usage>
+   Exceptions <httplug/exceptions>
    Tutorial <httplug/tutorial>
    Migrating <httplug/migrating>