[ci skip] Updating user guide for extra pagination values.

Author: lonnieezell

user_guide_src/source/libraries/pagination.rst

@@ -90,6 +90,32 @@ methods to keep the data separate::
     <?= $pager->links('group1') ?>
     <?= $pager->simpleLinks('group2') ?>
 
+Setting Page Manually
+=====================
+
+If you need to specify which page of results to return you can specify the page as the 3rd argument. This can be
+handy when you have a different manner than the default $_GET varibable to control which page to show.
+
+::
+
+     $userModel = new \App\Models\UserModel();
+     $page = 3;
+
+     $users = $userModel->paginate(10, 'group1', $page);
+
+Specifying the URI Segment for Page
+===================================
+
+It is also possible to use a URI segment for the page number, instead of the page query parameter. Simply specify the
+segment number to use as the fourth argument. URIs generated by the pager would then look
+like *https://domain.tld/model/[pageNumber]* instead of *https://domain.tld/model?page=[pageNumber]*.::
+
+::
+
+    $users = $userModel->paginate(10, 'group1', null, 3);
+
+Please note: ``$segment`` value cannot be greater than the number of URI segments plus 1.
+
 Manual Pagination
 =================
 
@@ -102,13 +128,17 @@ the total number of items as the first, second, and third parameters, respective
 This will, by default, display the links in the normal manner, as a series of links, but you can change the display
 template used by passing in the name of the template as the fourth parameter. More details can be found in the following
 sections.
+
 ::
 
     <?= $pager->makeLinks($page, $perPage, $total, 'template_name') ?>
 
-It is also possible to use a URI segment for the page number, instead of the page query parameter. Simply specify the segment number to use as the fifth parameter to ``makeLinks()``. URIs generated by the pager would then look like *https://domain.tld/model/[pageNumber]* instead of *https://domain.tld/model?page=[pageNumber]*.::
+It is also possible to use a URI segment for the page number, instead of the page query parameter, as described in
+the previous section. Specify the segment number to use as the fifth parameter to ``makeLinks()``.
+
+::
 
-<?= $pager->makeLinks($page, $perPage, $total, 'template_name', $segment) ?>
+    <?= $pager->makeLinks($page, $perPage, $total, 'template_name', $segment) ?>
 
 Please note: ``$segment`` value cannot be greater than the number of URI segments plus 1.
 
@@ -118,7 +148,7 @@ If you in need to show many pagers on one page then additional parameter which w
 	$pager->setPath('path/for/my-group', 'my-group'); // Additionally you could define path for every group.
 	$pager->makeLinks($page, $perPage, $total, 'template_name', $segment, 'my-group');
 
-Pagination library uses *page* query parameter for HTTP queries by default (if no group or *default* group name given) or *page_[groupName]* for custom group names. 
+Pagination library uses *page* query parameter for HTTP queries by default (if no group or *default* group name given) or *page_[groupName]* for custom group names.
 
 Paginating with Only Expected Queries
 =====================================