From e1d2a0bd046258100f1dff9ef3718829c36b5850 Mon Sep 17 00:00:00 2001 From: Nicolaas Heyning Date: Sun, 23 Feb 2014 17:00:52 +0100 Subject: [PATCH] added documentation on Model attributes --- docs/topics/db/models.txt | 13 +++++++++++++ docs/topics/db/queries.txt | 2 ++ 2 files changed, 15 insertions(+) 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 `. +.. _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 ` 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 ==================