more pagination features added

+ usage level override allowed now
+ documentation cleanup
+ code cleanup