Fixed #17159 -- Validated returned number of next|previous_page_number

Thanks mehta.apurva at gmail.com for the report and the initial patch
and neaf for the complete patch.

1 files changed, 10 insertions, 4 deletions

diff --git a/docs/topics/pagination.txt b/docs/topics/pagination.txt
index 566319ff0a..72560469a8 100644
--- a/docs/topics/pagination.txt
+++ b/docs/topics/pagination.txt
@@ -253,13 +253,19 @@ Methods
 
 .. method:: Page.next_page_number()
 
-    Returns the next page number. Note that this is "dumb" and will return the
-    next page number regardless of whether a subsequent page exists.
+    Returns the next page number.
+
+    .. versionchanged:: 1.5
+
+    Raises :exc:`InvalidPage` if next page doesn't exist.
 
 .. method:: Page.previous_page_number()
 
-    Returns the previous page number. Note that this is "dumb" and will return
-    the previous page number regardless of whether a previous page exists.
+    Returns the previous page number.
+
+    .. versionchanged:: 1.5
+
+    Raises :exc:`InvalidPage` if previous page doesn't exist.
 
 .. method:: Page.start_index()