Start updating pagination docs.
Update the pagination docs to match changes done in 3.0.
Merge pull request #1002 from cakephp/3.0-paginator

3.0 paginator docs