diff options
| author | Ismail Badawi <ismail@badawi.io> | 2014-10-04 21:09:32 -0400 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2014-10-06 08:24:10 -0400 |
| commit | 0aad1f1ea912e1c855c1ff9c0b89fa28d2035ca3 (patch) | |
| tree | d5e6dfffa99c749ff7e9e3cb349724f9e2c18039 /docs | |
| parent | e71ef9b6f2d91b5863d7039cfefcea076611d552 (diff) | |
[1.6.x] Fixed #23597 -- Clarified the manager that {Single,Multiple}ObjectMixin.model uses.
Backport of e501d4c505 from master
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/class-based-views/mixins-multiple-object.txt | 3 | ||||
| -rw-r--r-- | docs/ref/class-based-views/mixins-single-object.txt | 3 | ||||
| -rw-r--r-- | docs/topics/db/managers.txt | 5 |
3 files changed, 9 insertions, 2 deletions
diff --git a/docs/ref/class-based-views/mixins-multiple-object.txt b/docs/ref/class-based-views/mixins-multiple-object.txt index 6a283817f5..a4954a0c26 100644 --- a/docs/ref/class-based-views/mixins-multiple-object.txt +++ b/docs/ref/class-based-views/mixins-multiple-object.txt @@ -56,7 +56,8 @@ MultipleObjectMixin The model that this view will display data for. Specifying ``model = Foo`` is effectively the same as specifying ``queryset = - Foo.objects.all()``. + Foo.objects.all()``, where ``objects`` stands for ``Foo``’s + :ref:`default manager <default-managers>`. .. attribute:: queryset diff --git a/docs/ref/class-based-views/mixins-single-object.txt b/docs/ref/class-based-views/mixins-single-object.txt index a28690afce..5fa69d74f9 100644 --- a/docs/ref/class-based-views/mixins-single-object.txt +++ b/docs/ref/class-based-views/mixins-single-object.txt @@ -16,7 +16,8 @@ SingleObjectMixin The model that this view will display data for. Specifying ``model = Foo`` is effectively the same as specifying ``queryset = - Foo.objects.all()``. + Foo.objects.all()``, where ``objects`` stands for ``Foo``’s + :ref:`default manager <default-managers>`. .. attribute:: queryset diff --git a/docs/topics/db/managers.txt b/docs/topics/db/managers.txt index 93602d7666..f8aab4b705 100644 --- a/docs/topics/db/managers.txt +++ b/docs/topics/db/managers.txt @@ -169,6 +169,11 @@ For example:: This example allows you to request ``Person.men.all()``, ``Person.women.all()``, and ``Person.people.all()``, yielding predictable results. +.. _default-managers: + +Default managers +~~~~~~~~~~~~~~~~ + If you use custom ``Manager`` objects, take note that the first ``Manager`` Django encounters (in the order in which they're defined in the model) has a special status. Django interprets the first ``Manager`` defined in a class as |