Fix problem with pagination and document some functions - refs BT#7763