diff --git a/README.md b/README.md
index 8ca9dd3..e2035d6 100644
--- a/README.md
+++ b/README.md
@@ -482,10 +482,10 @@
 
 ### db.list([params], [callback])
 
-list all the docs in the database with optional query string additions `params`.
+list all the docs in the database with optional query string additions `params`. This is useful for searching.
 
 ``` js
-alice.list(function(err, body) {
+alice.list({startkey:'cat', limit:3}, function(err, body) {
   if (!err) {
     body.rows.forEach(function(doc) {
       console.log(doc);
@@ -493,6 +493,7 @@
   }
 });
 ```
+For a full list of params, see [couchdb doc](https://wiki.apache.org/couchdb/HTTP_view_API#Querying_Options).
 
 ### db.fetch(docnames, [params], [callback])