Changeset 7309

Timestamp:

03/18/08 16:58:31 (4 months ago)

Author:

adrian

Message:

Improved docs/generic_views.txt to note the new template context for the object_list generic view

Files:

• django/trunk/docs/generic_views.txt (modified) (2 diffs)

django/trunk/docs/generic_views.txt

@@ -752 +752 @@
-If the results are paginated, the context will contain these extra variables:
-
+    * **New in Django development version:** ``paginator``: An instance of
+      ``django.core.paginator.Paginator``.
+
+    * **New in Django development version:** ``page_obj``: An instance of
+      ``django.core.paginator.Page``.
+
+In older versions of Django, before ``paginator`` and ``page_obj`` were added
+to this template's context, the template included several other variables
+related to pagination. Note that you should *NOT* use these variables anymore;
+use ``paginator`` and ``page_obj`` instead, because they let you do everything
+these old variables let you do (and more!). But for legacy installations,
+here's a list of those old template variables:
+
-    * ``results_per_page``: The number of objects per page. (Same as the
-      ``paginate_by`` parameter.)
@@ -778 +791 @@
-      page.
-
-**New in Django development version:** ``page_range``: A list of the 
-page numbers that are available. This is 
+``page_range``: A list of the page numbers that are available. This is
+
-
-Notes on pagination