Clarified example code

Author: Bess Sadler

lib/oai/client/response.rb

@@ -2,22 +2,17 @@ module OAI
 
   # An OAI::Response contains entries and a resumption token. If a resumption token is present, 
   # then you must use it to fetch the rest of the entries for your query. For example:
-  #   # List all records
-  #   i = 1
-  #   begin 
-  #     response = client.list_records
-  #     while response.entries.size > 0    
-  #       response.entries.each { |entry|
-  #         puts "<b>#{i}</b> #{entry.header.identifier}<br/>"
-  #         i +=1
-  #       }
-  #       token = response.resumption_token
-  #       response = client.list_records :resumption_token => token if token
-  #     end
-  #   rescue OAI::Exception => e
-  #     puts 'No records to process'
-  #   end
-  #   puts "Done processing #{i} records"
+  #  # List all records in a given set
+  #  client = OAI::Client.new 'http://my-oai-provider.example.com/oai'
+  #  response = client.list_records :set => 'my_set_name'
+  #  while response.entries.count > 0
+  #    response.entries.each { |entry|
+  #      puts entry.header.identifier
+  #    }
+  #    token = response.resumption_token
+  #    # Note: You do not need to pass the options hash again, just the verb and the resumption token
+  #    response = client.list_records :resumption_token => token if token
+  #  end
 
   class Response
     include OAI::XPath