Add a documentation and also improve some comments.

system/Pager/PagerRenderer.php

@@ -83,17 +83,17 @@ class PagerRenderer
     protected $pageSelector;
 
     /**
-     * The maximum number of items displayed per page.
+     * Returns the number of results per page that should be shown.
      */
     protected ?int $perPage;
 
     /**
-     * The index of the first item on the current page.
+     * The number of items the page starts with.
      */
     protected ?int $perPageStart;
 
     /**
-     * The index of the last item on the current page.s
+     * The number of items the page ends with.
      */
     protected ?int $perPageEnd;
 

user_guide_src/source/libraries/pagination.rst

@@ -340,3 +340,28 @@ getPageCount()
 --------------
 
 This method returns total number of pages.
+
+Displaying the Number of Items on the Page
+==========================================
+
+.. warning:: The methods `getTotal()`, `getPerPage()`, `getPerPageStart()`, and `getPerPageEnd()` were introduced in v4.6.0.
+
+When paginating items, it’s often helpful to display the total number of items and the range of items shown on the current page. To simplify this task, new methods have been added. These methods make it easier to manage and display pagination details. Here's an example:
+
+.. literalinclude:: pagination/019.php
+
+getTotal()
+----------
+Returns the total items of the page.
+
+getPerPage()
+------------
+Returns the number of items to be displayed on the page.
+
+getPerPageStart()
+-----------------
+Returns the number of items the page starts with.
+
+getPerPageEnd()
+---------------
+Returns the number of items the page ends with.

user_guide_src/source/libraries/pagination/019.php

@@ -0,0 +1,7 @@
+<?php $pager->setSurroundCount(1) ?>
+
+<p>
+    Showing <span class="font-medium"><?= $pager->getPerPageStart() ?></span>
+    to <span class="font-medium"><?= $pager->getPerPageEnd() ?></span>
+    of <span class="font-medium"><?= $pager->getTotal() ?></span> results
+</p>