Merge pull request #23 from oscardelben/master

Add basic usage

README.rdoc

@@ -7,6 +7,23 @@ A Ruby client for {StatsD}[https://github.com/etsy/statsd]
 Bundler:
   gem "statsd-ruby", :require => "statsd"
 
+= Basic Usage
+
+  # Set up a global Statsd client for a server on localhost:9125
+  $statsd = Statsd.new 'localhost', 8125
+
+  # Send some stats
+  $statsd.increment 'garets'
+  $statsd.timing 'glork', 320
+  $statsd.gauge 'bork', 100
+
+  # Use {#time} to time the execution of a block
+  $statsd.time('account.activate') { @account.activate! }
+
+  # Create a namespaced statsd client and increment 'account.activate'
+  statsd = Statsd.new('localhost').tap{|sd| sd.namespace = 'account'}
+  statsd.increment 'activate'
+
 = Testing
 
 Run the specs with <tt>rake spec</tt>