Use $this for @return on fluent interfaces
CS
Renamed the $key property to $urlParameter
Added full docblocks
Removed separator config

If one really needs that (and I can't se a reason for it), one can still use getPagination()->generate(...)
Simpler boolean comparison
Pagination must be compiled to retrieve it
Pagination now works with perPage=0

Also restructured the methods
isOutOfRange must generate the pagination
Extended the documentation