README.rdoc in streambot-1.0.0.rc3 vs README.rdoc in streambot-1.0.0.rc4

@@ -51,14 +51,56 @@
 I wrote this stuff into my config.yml and load the params with 
 
 	require 'yaml'
 	@params = YAML.load_file('config.yml')
 
-= Callbacks
+= Events / Callbacks
 
-*on_error*:: this callback is fired when an error occures
+To receive something from an event, you need to call the receive method on the event and pass a block into this method
 
+	tracker.event_name.receive do |params|
+		# ...
+	end
+
+== on_error
+
+is fired when an error occures
+
+	tracker.on_error.receive do |message, trace|
+		# print the error message and the stacktrace to STDOUT
+		puts message
+		puts trace
+		# and stop the tracker
+		tracker.stop
+	end
+
+== on_match
+
+is fired wenn an filter matched on an status
+
+	tracker.on_match.receive do |status, filter_path, filter_value|
+		puts "filter matched on #{filter_path} with #{filter_value} in status ##{status['id']}"
+	end
+
+== before_retweet
+
+is fired before the tracker retweets a status
+
+	tracker.before_retweet.receive do |status|
+		# print the status to STDOUT
+		puts status
+	end
+
+== after_retweet
+
+is fired after the tracker has retweeted a status
+
+	tracker.after_retweet.receive do |status|
+		# save the status with active record
+		Retweet.new(status)
+	end
+
 = Filters
 
 You need to configure the *filters_config* in the params and set the path to the YAML file. At the moment this needs to be an YAML file, cause the tracker is reading this file, every time a new status comes in via the client. I decided to read it on each status, cause I don't wanted to restart the Tracker every time I made a change to the filters.
 
 For example we want to filter all tweets with the source "web", we need to define the following line in our *filters.yml*
@@ -74,19 +116,9 @@
 	"user/screen_name": "gr4y"
 
 You can even filter all tweets of users with an evil background color.
 
 	"user/profile_background_color": "666666"
-
-= Example
-
-	@params = YAML.load_file('config.yml')
-	@client = StreamBot::Tracker.new(@params)
-	
-	@client.on_error do |msg, stacktrace|
-		puts msg
-		puts stacktrace
-	end
 
 = Contribution
 == Testing
 
 All Tests should inherit from StreamBot::BaseTest