Add number of records per request as second (optional) argument to Client::records(), update README

Author: danmichaelo

README.md

@@ -1,4 +1,3 @@
-
 [![Build Status](https://img.shields.io/travis/scriptotek/php-sru-client.svg)](https://travis-ci.org/scriptotek/php-sru-client)
 [![Coverage Status](https://img.shields.io/coveralls/scriptotek/php-sru-client.svg)](https://coveralls.io/r/scriptotek/php-sru-client?branch=master)
 
@@ -39,7 +38,12 @@ $client = new SruClient($url, array(
     'version' => '1.1',
     'user-agent' => 'OpenKat/0.1'
 ));
+```
 
+To iterate over all the results from a `searchRetrieve` query, use the [Records](//scriptotek.github.io/php-sru-client/api_docs/Scriptotek/Sru/Records.html) class returned from `Client::records()`. It abstracts away the process of actually making the requests. The first argument is
+the CQL query, and the second optional argument is the number of records to fetch for each request (defaults to 10).
+
+```php
 $records = $client->records('dc.title="Hello world"');
 foreach ($records as $record) {
 	echo "Got record " . $record->position . " of " . $records->numberOfRecords() . "\n";

src/Client.php

@@ -144,11 +144,12 @@ public function search($cql, $start = 1, $count = 10) {
      * Perform a searchRetrieve request and return an iterator over the records
      *
      * @param string $cql
+     * @param int $count Number of records to request per request
      * @return Records
      */
-    public function records($cql)
+    public function records($cql, $count = 10)
     {
-        return new Records($cql, $this);
+        return new Records($cql, $this, $count);
     }
 
     /**