1 When searching through large amounts of data, it is often the case that a
2 result set is returned that is larger than we want to display on one page. This
3 results in wanting to page through various pages of data. The maths behind this
4 is unfortunately fiddly, hence this module.
6 The main concept is that you pass in the number of total entries, the number of
7 entries per page, and the current page number. You can then call methods to
8 find out how many pages of information there are, and what number the first and
9 last entries on the current page really are.