From: Kevin Burke Date: Wed, 12 Jun 2013 22:53:09 +0000 (-0700) Subject: Link to the actual exception references X-Git-Tag: 2.0~19^2~7^2~1 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=a6415cf8956cce8a07b8821b9a4dbb703cd1750c;p=services%2Fpython-requests.git Link to the actual exception references Sphinx has a neat cross-referencing feature where if you include the tilde character in front of a :py: class, it'll link to the full object but provide only the last part of class name in the text. For more info see http://sphinx-doc.org/domains.html#cross-referencing-syntax --- diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst index 1e36587..59d75cc 100644 --- a/docs/user/quickstart.rst +++ b/docs/user/quickstart.rst @@ -399,15 +399,16 @@ Errors and Exceptions --------------------- In the event of a network problem (e.g. DNS failure, refused connection, etc), -Requests will raise a :class:`ConnectionError` exception. +Requests will raise a :class:`~requests.exceptions.ConnectionError` exception. -In the event of the rare invalid HTTP response, Requests will raise -an :class:`HTTPError` exception. +In the event of the rare invalid HTTP response, Requests will raise an +:class:`~requests.exceptions.HTTPError` exception. -If a request times out, a :class:`Timeout` exception is raised. +If a request times out, a :class:`~requests.exceptions.Timeout` exception is +raised. If a request exceeds the configured number of maximum redirections, a -:class:`TooManyRedirects` exception is raised. +:class:`~requests.exceptions.TooManyRedirects` exception is raised. All exceptions that Requests explicitly raises inherit from :class:`requests.exceptions.RequestException`.