README.rdoc in google_search-1.0.0 vs README.rdoc in google_search-1.1.0

@@ -14,8 +14,26 @@
 
 You can also search videos, images, books etc. by calling <tt>GoogleSearch.[SEARCH TYPE]</tt> (e.g. GoogleSearch.images :q => "apple pie")
 
 For documention on options and response formats see http://code.google.com/intl/hr/apis/ajaxsearch/documentation/reference.html#_intro_fonje
 
+=== Default options
+
+You may specify default options that go into every request. Usually you'll put your API key here.
+
+  GoogleSearch.default_options = { :key => "my-key", :hl => "hr" }
+
+=== Paginated search
+
+  GoogleSearch.with_pages(1..5) do |search|
+    search.images(:q => "moon") 
+  end
+
+This will do search 5 times, each time given a different page (1..5). Useful for getting more results at once.
+
+=== Handling errors
+
+On invalid response a GoogleSearchError is raised, describing the error.
+
 == Copyright
 
 Copyright (c) 2010 Sasa Brankovic. See LICENSE for details.