summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorNicolaas Heyning <nheyning@gmail.com>2014-02-23 17:00:52 +0100
committerNicolaas Heyning <nheyning@gmail.com>2014-02-23 17:16:12 +0100
commite1d2a0bd046258100f1dff9ef3718829c36b5850 (patch)
treef715f99699d055a4cb3cbd53165b6c9759af30fe /docs
parent173aa5199737c60ab883a0469684e83c01604ce8 (diff)
added documentation on Model attributes
Diffstat (limited to 'docs')
-rw-r--r--docs/topics/db/models.txt13
-rw-r--r--docs/topics/db/queries.txt2
2 files changed, 15 insertions, 0 deletions
diff --git a/docs/topics/db/models.txt b/docs/topics/db/models.txt
index 5039bbd2d1..a8445a2cf5 100644
--- a/docs/topics/db/models.txt
+++ b/docs/topics/db/models.txt
@@ -663,6 +663,19 @@ Meta`` to a model is completely optional.
A complete list of all possible ``Meta`` options can be found in the :doc:`model
option reference </ref/models/options>`.
+.. _model-attributes:
+
+Model attributes
+================
+
+:attr:`~objects`
+ The most important attribute of a model is the
+ :class:`~django.db.models.Manager`, which is the interface through which
+ database query operations are provided to Django models and is used to
+ :ref:`retrieve the instances <retrieving-objects>` from the database. If no
+ custom Manager is defined, the default name is ``objects``. Managers are
+ only accessible via model classes, not the model instances.
+
.. _model-methods:
Model methods
diff --git a/docs/topics/db/queries.txt b/docs/topics/db/queries.txt
index f53d1a9998..66118631e0 100644
--- a/docs/topics/db/queries.txt
+++ b/docs/topics/db/queries.txt
@@ -129,6 +129,8 @@ go, include multiple arguments in the call to
Django will complain if you try to assign or add an object of the wrong type.
+.. _retrieving-objects:
+
Retrieving objects
==================