From ec08d62a20f55cfdfb9fbd21d8bc5627c54337c7 Mon Sep 17 00:00:00 2001
From: Adam Kaliński <adamkalinski@gmail.com>
Date: Sat, 22 Feb 2014 20:29:55 +0100
Subject: Fixed #22048 - Enhanced docs to cover nonexistent one-to-one
 relationships.

Thanks EvilDMP for the suggestion.
---
 docs/ref/models/fields.txt | 9 +++++++++
 1 file changed, 9 insertions(+)

(limited to 'docs/ref')

diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index feaf846b24..3a43d51560 100644
--- a/docs/ref/models/fields.txt
+++ b/docs/ref/models/fields.txt
@@ -1469,6 +1469,15 @@ your resulting ``User`` model will have the following attributes::
     >>> hasattr(user, 'supervisor_of')
     True
 
+A ``DoesNotExist`` exception is raised when accessing the reverse relationship
+if an entry in the related table doesn't exist. For example, if a user doesn't
+have a supervisor designated by ``MySpecialUser``::
+
+    >>> user.supervisor_of
+    Traceback (most recent call last):
+        ...
+    DoesNotExist: User matching query does not exist.
+
 .. _onetoone-arguments:
 
 Additionally, ``OneToOneField`` accepts all of the extra arguments
-- 
cgit v1.3