Updated Javadoc for PagedIterable. Removed example that was out-of-date. Changed example to something that actually returns PagedIterable.
Merge pull request #1387 from rackspace/pagediterable-javadoc

Updated Javadoc for PagedIterable.