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:07 -0400 |
| commit | e9609fb7a1758e5de10360d4f181a6e602658406 (patch) | |
| tree | a330ba5d4941fe50e5109898518ffabb41ea748b /docs | |
| parent | 0dbf366d90bb2e1403aede815e96d85ba989953f (diff) | |
[1.7.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 160237f4e2..e52ddfc5cb 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 39f0516669..5a0542eea2 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 fccda88772..f1573f8446 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.authors.all()``, ``Person.editors.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 |