From a6415cf8956cce8a07b8821b9a4dbb703cd1750c Mon Sep 17 00:00:00 2001 From: Kevin Burke Date: Wed, 12 Jun 2013 15:53:09 -0700 Subject: [PATCH] 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 --- docs/user/quickstart.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) 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`. -- 2.34.1