Merge branch 'patch-1' of https://github.com/shtaft/nano into shtaft-patch-1
diff --git a/README.md b/README.md
index 3bfbe57..ef52571 100644
--- a/README.md
+++ b/README.md
@@ -493,10 +493,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);
@@ -504,6 +504,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])