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

[1.2.X] Fixed #14232 -- Clarified the data type of date_list in date-based... 

[1.2.X] Fixed #14232 -- Clarified the data type of date_list in date-based generic views. Thanks to clelland for the report and patch.

Backport of r14020 from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@14028 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent de3669d2

docs/ref/generic-views.txt

+10 −10
Original line number Diff line number Diff line
@@ -197,10 +197,10 @@ If ``template_name`` isn't specified, this view will use the template 


In addition to ``extra_context``, the template's context will be:



    * ``date_list``: A list of ``datetime.date`` objects representing all

      years that have objects available according to ``queryset``. These are

      ordered in reverse. This is equivalent to

      ``queryset.dates(date_field, 'year')[::-1]``.

    * ``date_list``: A ``DateQuerySet`` object containing all years that have

      have objects available according to ``queryset``, represented as

      ``datetime.datetime`` objects. These are ordered in reverse. This is

      equivalent to ``queryset.dates(date_field, 'year')[::-1]``.



    .. versionchanged:: 1.0

       The behaviour depending on ``template_object_name`` is new in this version.
@@ -282,9 +282,9 @@ If ``template_name`` isn't specified, this view will use the template 


In addition to ``extra_context``, the template's context will be:



    * ``date_list``: A list of ``datetime.date`` objects representing all

      months that have objects available in the given year, according to

      ``queryset``, in ascending order.

    * ``date_list``: A ``DateQuerySet`` object containing all months that have

      have objects available according to ``queryset``, represented as

      ``datetime.datetime`` objects, in ascending order.



    * ``year``: The given year, as a four-character string.
@@ -372,9 +372,9 @@ If ``template_name`` isn't specified, this view will use the template 


In addition to ``extra_context``, the template's context will be:



    * ``date_list``: A list of ``datetime.date`` objects representing all

      days that have objects available in the given month, according to

      ``queryset``, in ascending order.    

    * ``date_list``: A ``DateQuerySet`` object containing all days that have

      have objects available in the given month, according to ``queryset``,

      represented as ``datetime.datetime`` objects, in ascending order.



    * ``month``: A ``datetime.date`` object representing the given month.