Ticket #6842: r8472.diff

docs/exceptions.txt

@@ +1 @@
+=================
+Django Exceptions
+=================
+
+This document describes the exceptions thrown by Django.
+
+Django uses many standard Python exceptions as well as some Django specific 
+exceptions.
+
+Django Specific Exceptions
+==========================
+
+Most of the Django specific exceptions are in the ``django.core.exceptions`` module.  For example, ``django.core.exceptions.ViewDoesNotExist``.
+
+ObjectDoesNotExist and DoesNotExist
+-----------------------------------
+The ``DoesNotExist`` exception is raised when an object is not for the given parameters of a query.  The ``DoesNotExist`` exception is not in ``django.core.exceptions``.  Instead, it is an attribute of the model class and inherits from ``ObjectDoesNotExist`` which is in ``django.core.exceptions``.  See `get`_ for further information on ``ObjectDoesNotExist`` and ``DoesNotExist``.
+
+.. _`get`: ../db-api/#get-kwargs
+
+MultipleObjectsReturned
+-----------------------
+The ``MultipleObjectsReturned`` exception is raised by a query if only one object is expected, but multiple objects are returned.  See `get`_ for further information.  The ``MultipleObjectsReturned`` exception is an attribute of a model class and it is in ``django.core.exceptions``.
+
+.. _`get`: ../db-api/#get-kwargs
+
+SuspiciousOperation
+-------------------
+
+PermissionDenied
+----------------
+
+ViewDoesNotExist
+----------------
+
+MiddlewareNotUsed
+-----------------
+
+ImproperlyConfigured
+--------------------
+
+FieldError
+----------