Added documentation for how to enable logging via the library

Author: librarywebchic

docs/enablingLogging.rst

@@ -0,0 +1,74 @@
+Logging
+============
+
+The library allows logging to be added via Guzzle's Log Plugin [http://guzzle3.readthedocs.org/plugins/log-plugin.html] which supports logs via a variety of adapters.
+
+Example: 
+==================================================
+
+This example adds basic logging using the Zend Framework 2 Logging [http://framework.zend.com/manual/2.3/en/modules/zend.log.overview.html] and sending output to the buffer
+
+.. code:: php
+
+   require_once('vendor/autoload.php');
+
+   use OCLC\Auth\WSKey;
+   use OCLC\Auth\AccessToken;
+   use WorldCat\Discovery\Bib;
+   
+   use Guzzle\Plugin\Log\LogPlugin;
+   use Guzzle\Log\MessageFormatter;
+   use Guzzle\Log\Zf2LogAdapter;
+   use Zend\Log\Logger;
+   use Zend\Log\Writer\Stream
+   
+   $key = 'api-key';
+   $secret = 'api-key-secret';
+   $options = array('services' => array('WorldCatDiscoveryAPI', 'refresh_token'));
+   $wskey = new WSKey($key, $secret, $options);
+   $accessToken = $wskey->getAccessTokenWithClientCredentials('128807', '128807'));
+   
+   $logwriter = new Stream('php://output');
+   $logger = new Logger();
+   $logger->addWriter($logwriter);
+   $adapter = new Zf2LogAdapter($logger);
+   $logPlugin = new LogPlugin($adapter, MessageFormatter::DEBUG_FORMAT);
+   $options = array(
+    'logger' => $logPlugin
+   );
+   $bib = Bib::find(7977212, $accessToken, $options);
+   
+Example: 
+==================================================
+
+This example adds basic logging using the Zend Framework 2 Logging [http://framework.zend.com/manual/2.3/en/modules/zend.log.overview.html] and sending output to the filesystem
+
+.. code:: php
+
+   require_once('vendor/autoload.php');
+
+   use OCLC\Auth\WSKey;
+   use OCLC\Auth\AccessToken;
+   use WorldCat\Discovery\Bib;
+   
+   use Guzzle\Plugin\Log\LogPlugin;
+   use Guzzle\Log\MessageFormatter;
+   use Guzzle\Log\Zf2LogAdapter;
+   use Zend\Log\Logger;
+   use Zend\Log\Writer\Stream
+   
+   $key = 'api-key';
+   $secret = 'api-key-secret';
+   $options = array('services' => array('WorldCatDiscoveryAPI', 'refresh_token'));
+   $wskey = new WSKey($key, $secret, $options);
+   $accessToken = $wskey->getAccessTokenWithClientCredentials('128807', '128807'));
+   
+   $logwriter = new Stream('/path/to/logfile');
+   $logger = new Logger();
+   $logger->addWriter($logwriter);
+   $adapter = new Zf2LogAdapter($logger);
+   $logPlugin = new LogPlugin($adapter, MessageFormatter::DEBUG_FORMAT);
+   $options = array(
+    'logger' => $logPlugin
+   );
+   $bib = Bib::find(7977212, $accessToken, $options);