From 5b185ecc68c04c0ee63cf44de43d831623daa263 Mon Sep 17 00:00:00 2001
From: Aliaksandr Semianiuk <a_semianiuk@wargaming.net>
Date: Fri, 16 May 2014 23:40:00 +0300
Subject: Fixed #22019 -- Added Model.objects reference documentation.

---
 docs/ref/models/class.txt | 35 +++++++++++++++++++++++++++++++++++
 docs/ref/models/index.txt |  1 +
 2 files changed, 36 insertions(+)
 create mode 100644 docs/ref/models/class.txt

(limited to 'docs/ref')

diff --git a/docs/ref/models/class.txt b/docs/ref/models/class.txt
new file mode 100644
index 0000000000..0183a82093
--- /dev/null
+++ b/docs/ref/models/class.txt
@@ -0,0 +1,35 @@
+=====================
+Model class reference
+=====================
+
+.. currentmodule:: django.db.models
+
+This document covers features of the :class:`~django.db.models.Model` class.
+For more information about models, see :doc:`the complete list of Model
+reference guides </ref/models/index>`.
+
+Attributes
+==========
+
+``objects``
+-----------
+
+.. attribute:: Model.objects
+
+    Each non-abstract :class:`~django.db.models.Model` class must have a
+    :class:`~django.db.models.Manager` instance added to it.
+    Django ensures that in your model class you have  at least a
+    default ``Manager`` specified. If you don't add your own ``Manager``,
+    Django will add an attribute ``objects`` containing default
+    :class:`~django.db.models.Manager` instance. If you add your own
+    :class:`~django.db.models.Manager` instance attribute, the default one does
+    not appear. Consider the following example::
+
+        from django.db import models
+
+        class Person(models.Model):
+            # Add manager with another name
+            people = models.Manager()
+
+    For more details on model managers see :doc:`Managers </topics/db/managers>`
+    and :ref:`Retrieving objects <retrieving-objects>`.
diff --git a/docs/ref/models/index.txt b/docs/ref/models/index.txt
index 4716c03f95..3462420a00 100644
--- a/docs/ref/models/index.txt
+++ b/docs/ref/models/index.txt
@@ -9,6 +9,7 @@ Model API reference. For introductory material, see :doc:`/topics/db/models`.
 
    fields
    relations
+   class
    options
    instances
    querysets
-- 
cgit v1.3