How about something like this:
```ruby
    # This method transparently allows you to get all results across all pages.
    # Compare this with #each or #results which allow only the current page.
    # 
    #   list_response.with_subsequent_pages.each do |result|
    #     ...
    #   end
    # 
    #  or:
    # 
    #   list_response.with_subsequent_pages.count
    # 
    # Pages of results are fetched on demand. When iterating, that means 
    # fetching pages as results from the current page are exhausted. If you 
    # invoke a method such as #count, this method will fetch all pages at that 
    # point. Note that the responses are cached.
    def with_subsequent_pages
    ...
```