From 2ce4f7324193e3110af83a53e9d2f744b6d9166c Mon Sep 17 00:00:00 2001 From: Adam Johnson Date: Mon, 8 Feb 2021 23:38:55 +0000 Subject: [PATCH] [3.2.x] Improved pagination documentation * Link to the topic guide * Document that page() can raise PageNotAnInteger. Backport of a57e91adeeef4fe97db3e589b20bf2a30c907e21 from master --- docs/ref/paginator.txt | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/ref/paginator.txt b/docs/ref/paginator.txt index 4cc5483828..cd6df42eae 100644 --- a/docs/ref/paginator.txt +++ b/docs/ref/paginator.txt @@ -6,6 +6,8 @@ Django provides a few classes that help you manage paginated data -- that is, data that's split across several pages, with "Previous/Next" links. These classes live in :source:`django/core/paginator.py`. +For examples, see the :doc:`Pagination topic guide `. + .. module:: django.core.paginator :synopsis: Classes to help you easily manage paginated data. @@ -76,7 +78,9 @@ Methods .. method:: Paginator.page(number) Returns a :class:`Page` object with the given 1-based index. Raises - :exc:`InvalidPage` if the given page number doesn't exist. + :exc:`PageNotAnInteger` if the ``number`` cannot be converted to an integer + by calling ``int()``. Raises :exc:`InvalidPage` if the given page number + doesn't exist. .. method:: Paginator.get_elided_page_range(number, *, on_each_side=3, on_ends=2)