Commit 6f2a8440 authored by Russell Keith-Magee's avatar Russell Keith-Magee
Browse files

[1.1.X] Fixed #12997 -- Corrected the module markup for QuerySet methods....

[1.1.X] Fixed #12997 -- Corrected the module markup for QuerySet methods. Thanks to timo for the report.

Backport of r13235 from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.1.X@13236 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent 08de7a32
Loading
Loading
Loading
Loading
+1 −1
Original line number Diff line number Diff line
@@ -4,7 +4,7 @@
QuerySet API reference
======================

.. currentmodule:: django.db.models
.. currentmodule:: django.db.models.QuerySet

This document describes the details of the ``QuerySet`` API. It builds on the
material presented in the :ref:`model <topics-db-models>` and :ref:`database
+19 −19
Original line number Diff line number Diff line
@@ -4,7 +4,7 @@
Related objects reference
=========================

.. currentmodule:: django.db.models
.. currentmodule:: django.db.models.fields.related

This document describes extra methods available on managers when used in a one-to-many or many-to-many related context. This happens in two cases:

@@ -30,7 +30,7 @@ This document describes extra methods available on managers when used in a one-t
      In this example, the methods below will be available both on
      ``topping.pizza_set`` and on ``pizza.toppings``.

.. method:: QuerySet.add(obj1, [obj2, ...])
.. method:: add(obj1, [obj2, ...])

    Adds the specified model objects to the related object set.

@@ -40,7 +40,7 @@ This document describes extra methods available on managers when used in a one-t
        >>> e = Entry.objects.get(id=234)
        >>> b.entry_set.add(e) # Associates Entry e with Blog b.

.. method:: QuerySet.create(**kwargs)
.. method:: create(**kwargs)

    Creates a new object, saves it and puts it in the related object set.
    Returns the newly created object::
@@ -70,7 +70,7 @@ This document describes extra methods available on managers when used in a one-t
    ``blog`` to ``create()``. Django figures out that the new ``Entry`` object's
    ``blog`` field should be set to ``b``.

.. method:: QuerySet.remove(obj1, [obj2, ...])
.. method:: remove(obj1, [obj2, ...])

    Removes the specified model objects from the related object set::

@@ -85,7 +85,7 @@ This document describes extra methods available on managers when used in a one-t
    ``b.entry_set()`` is equivalent to doing ``e.blog = None``, and because the
    ``blog`` ``ForeignKey`` doesn't have ``null=True``, this is invalid.

.. method:: QuerySet.clear()
.. method:: clear()

    Removes all objects from the related object set::