add documentation for the iter_pages function

README.md

@@ -86,6 +86,24 @@ profile picture, you can use the `graph_url` function:
     profile_pic = graph_url('/zuck/picture')
     urlretrieve(profile_pic, 'zuck.jpg')
 
+
+### Advanced Graph API ###
+
+fbconsole also provides access and utilities around some more advanced graph api
+features.
+
+
+__iter_pages__
+
+If you are trying to fetch a lot of data, you may be required to make multiple
+requests to the graph api via the "paging" values that are sent back.  You can
+use `iter_pages` to automatically iterate through multiple requests.  For
+example, you can iterate through all your wall posts:
+
+    for post in iter_pages(fbconsole.get('/me/posts')):
+        print post['message']
+
+
 ### More Authentication Options ###
 
 By default, fbconsole will make all it's requests as the fbconsole facebook app.

src/fbconsole.py

@@ -244,10 +244,11 @@ def get(path, params=None):
 def iter_pages(json_response):
     """Iterate over multiple pages of data.
 
-    The graph api can return a lot of data, but will only return so much data in
-    a single request.  To get more data, you must query for it explicitly using
-    paging.  This function will do automatic paging in the form of an iterator.
-    For example to print the id of every photo tagged with the logged in user:
+    The graph api can return a lot of data, but will only return a limited
+    amount of data in a single request.  To get more data, you must query for it
+    explicitly using paging.  This function will do automatic paging in the form
+    of an iterator.  For example to print the id of every photo tagged with the
+    logged in user:
 
       >>> total = 0
       >>> for photo in iter_pages(get('/19292868552/feed', {'limit':2})):