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

Clarified some documentation on the use of the aggregate() query modifier,... 

Clarified some documentation on the use of the aggregate() query modifier, following suggestions on IRC. Thanks to Tai Lee for the report.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@9844 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent fd28d04c

docs/ref/models/querysets.txt

+2 −2
Original line number Diff line number Diff line
@@ -991,7 +991,7 @@ generated for them based upon the name of the aggregate function and 
the model field that is being aggregated.



For example, if you were manipulating blog entries, you may want to know

the average number of authors contributing to blog entries::

the number of authors that have contributed blog entries::



    >>> q = Blog.objects.aggregate(Count('entry'))

    {'entry__count': 16}
@@ -1000,7 +1000,7 @@ By using a keyword argument to specify the aggregate function, you can 
control the name of the aggregation value that is returned::



    >>> q = Blog.objects.aggregate(number_of_entries=Count('entry'))

    {'number_of_entries': 2.34}

    {'number_of_entries': 16}



For an in-depth discussion of aggregation, see :ref:`the topic guide on

Aggregation <topics-db-aggregation>`.