summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorDavid Sanders <shang.xiao.sanders@gmail.com>2022-10-02 00:42:10 +1000
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2022-10-01 16:43:11 +0200
commitf78314875fee68e4f10aca2a89bd9914d5be5bfb (patch)
tree024cc9714c01b006dfb5b594fef477caa45668bb /docs/ref
parent96c541ecef98e2b93db8eba144be2d8c48e6c2cf (diff)
[4.1.x] Clarified how to reference RelatedObjectDoesNotExist exceptions.
Backport of da02cbd1effc951b14c981925d0e26a39566649e from main
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/models/fields.txt13
1 files changed, 7 insertions, 6 deletions
diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index 57c018f4b3..227b3ee229 100644
--- a/docs/ref/models/fields.txt
+++ b/docs/ref/models/fields.txt
@@ -2012,13 +2012,14 @@ your resulting ``User`` model will have the following attributes::
A ``RelatedObjectDoesNotExist`` exception is raised when accessing the reverse
relationship if an entry in the related table doesn't exist. This is a subclass
of the target model's :exc:`Model.DoesNotExist
-<django.db.models.Model.DoesNotExist>` exception. For example, if a user
-doesn't have a supervisor designated by ``MySpecialUser``::
+<django.db.models.Model.DoesNotExist>` exception and can be accessed as an
+attribute of the reverse accessor. For example, if a user doesn't have a
+supervisor designated by ``MySpecialUser``::
- >>> user.supervisor_of
- Traceback (most recent call last):
- ...
- RelatedObjectDoesNotExist: User has no supervisor_of.
+ try:
+ user.supervisor_of
+ except User.supervisor_of.RelatedObjectDoesNotExist:
+ pass
.. _onetoone-arguments: