dirPagination: Add range API to pagination controls

The dirPaginationControls directive now exposes a `range` object which
can be used in the template to allow things like "displaying x - y of z
items".

Also updated the docs to include an example of usage.