readme update, call on_error if @code != 200

README.markdown

@@ -5,20 +5,32 @@ Uses [EventMachine](http://rubyeventmachine.com/) for connection handling. Adher
 
 JSON format only.
 
+## Install
+
+    sudo gem install twitter-stream -s http://gemcutter.org
+
 ## Usage
 
+    require 'rubygems'
+    require 'twitter/json_stream'
+
     EventMachine::run {
       stream = Twitter::JSONStream.connect(
         :path    => '/1/statuses/filter.json?track=football',
-        :auth    => 'LOGIN:PASSWORD',
+        :auth    => 'LOGIN:PASSWORD'
       )
 
       stream.each_item do |item|
-        # do someting with unparsed JSON item
+        # Do someting with unparsed JSON item.
       end
 
       stream.on_error do |message|
-        # log or something
+        # No need to worry here. It might be an issue with Twitter. 
+        # Log message for future reference. JSONStream will try to reconnect after a timeout.
+      end
+      
+      stream.on_max_reconnects do |timeout, retries|
+        # Something is wrong on your side. Send yourself an email.
       end
     }
 

lib/twitter/json_stream.rb

@@ -186,6 +186,7 @@ def parse_response_line ln
       if ln =~ /\AHTTP\/1\.[01] ([\d]{3})/
         @code = $1.to_i
         @state = :headers
+        receive_error("invalid status code: #{@code}. #{ln}") unless @code == 200
       else
         receive_error('invalid response')
         close_connection