Update API descriptions and usage.
Remove soon-to-be-obsolete method references, and re-organize a teensy bit of the usage for collections.
Merge pull request #146 from google/fixpages

Update API descriptions and usage.