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

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

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:

      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.

        >>> 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::

    ``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::

    ``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::