fix
[django-pagination.git] / doc / usage.rst
index 3c66a78..199e6a3 100644 (file)
@@ -61,6 +61,10 @@ installation, which is covered in :ref:`installation`.)
    Note that this replaces ``object_list`` with the list for the current page, so
    you can iterate over the ``object_list`` like you normally would.
 
    Note that this replaces ``object_list`` with the list for the current page, so
    you can iterate over the ``object_list`` like you normally would.
 
+   If you are using template ``{% block %}`` tags, the autopaginate tag must
+   exist in the same ``{% block %}`` where you access the paginated
+   ``object_list``.
+
    In general the full syntax is::
 
         autopaginate QUERYSET [PAGINATE_BY] [ORPHANS] [as NAME]
    In general the full syntax is::
 
         autopaginate QUERYSET [PAGINATE_BY] [ORPHANS] [as NAME]
@@ -164,3 +168,7 @@ behavior of the pagination tags.  Here's an overview:
 ``PAGINATION_DISPLAY_DISABLED_NEXT_LINK``
     If set to ``False``, the next page link will not be displayed if there's no 
     next page. Defaults to False.
 ``PAGINATION_DISPLAY_DISABLED_NEXT_LINK``
     If set to ``False``, the next page link will not be displayed if there's no 
     next page. Defaults to False.
+
+``PAGINATION_DISABLE_LINK_FOR_FIRST_PAGE``
+    if set to ``False``, the first page will have ``?page=1`` link suffix in pagination displayed, otherwise is omitted.
+    Defaults to True.