added proposed new api to readme
updated tests to reflect the new spec
fixed pageToPdf()
fixed #paginate()
Merge branch 'new-api'