Fixed #12519 -- Corrected documentation on .raw() queries. Thanks to boralyl...

.. method:: Manager.raw(raw_query, params=None, translations=None)

This method method takes a raw SQL query, executes it, and returns model

instances.

This method method takes a raw SQL query, executes it, and returns a

:class:`~django.db.models.query.RawQuerySet` instance. This

:class:`~django.db.models.query.RawQuerySet` instance can be iterated

over just like an normal QuerySet to provide object instances.

This is best illustrated with an example. Suppose you've got the following model::

You could then execute custom SQL like so::

    >>> Person.objects.raw('SELECT * from myapp_person')

    [<Person: John Doe>, <Person: Jane Doe>, ...]

    >>> for p in Person.objects.raw('SELECT * FROM myapp_person'):

    ...     print p

    John Smith

    Jane Jones

.. admonition:: Model table names

Fields may also be left out::

    >>> people = Person.objects.raw('SELECT id, first_name FROM myapp_person'):

    >>> people = Person.objects.raw('SELECT id, first_name FROM myapp_person')

The ``Person`` objects returned by this query will be :ref:`deferred

<queryset-defer>` model instances. This means that the fields that are omitted