summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorJames Bennett <james@b-list.org>2013-06-20 01:36:13 -0500
committerTim Graham <timograham@gmail.com>2013-06-21 13:16:51 -0400
commit9b0604e5149e20fc98f07256af60eac87421a346 (patch)
treeab1f52f8074cc47d76349799ad8aaaa1d6b292de /docs/ref
parentee8996d8a6f8fc462a6e912bcf0cf80530704ab4 (diff)
[1.5.x] Fixed #19881 -- Documented that get_next/previous_by_FOO uses default manager.
Backport of ba610cb319 from master
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/models/instances.txt7
1 files changed, 5 insertions, 2 deletions
diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt
index 92071b8d3f..3d4c1fcadd 100644
--- a/docs/ref/models/instances.txt
+++ b/docs/ref/models/instances.txt
@@ -661,8 +661,11 @@ For every :class:`~django.db.models.DateField` and
returns the next and previous object with respect to the date field, raising
a :exc:`~django.core.exceptions.DoesNotExist` exception when appropriate.
-Both methods accept optional keyword arguments, which should be in the format
-described in :ref:`Field lookups <field-lookups>`.
+Both of these methods will perform their queries using the default
+manager for the model. If you need to emulate filtering used by a
+custom manager, or want to perform one-off custom filtering, both
+methods also accept optional keyword arguments, which should be in the
+format described in :ref:`Field lookups <field-lookups>`.
Note that in the case of identical date values, these methods will use the
primary key as a tie-breaker. This guarantees that no records are skipped or