more README.md

README.md

@@ -1,9 +1,42 @@
+Motivation
+==========
+
+Connecting to hostnames from EventMachine?  Dissatisfied from the
+Dnsruby experience?  Disappointed by the lack of EventMachine support
+in Dnsruby trunk?  Then you want this.
+
+
+Usage
+=====
+
+        require 'em/resolver'
+        
+        EM.run {
+          res = EventMachine::Resolver.new
+          q = res.getaddrinfo("localhost")
+          q.callback do |addresses|
+            addresses.each { |address|
+              spam! address
+            }
+          end
+          q.errback do |error|
+            puts "Oh noes: #{error}"
+          end
+        }
+
+
+ext/asyncns.h
+=========
+
+...is included in a slightly modified form because the original one
+had parameter names like `class' which prevents compiling as C++.
+
+
 TODO
 ====
 
 - Dnsruby compat
-- remove C++ cruft
 - Rakefile
 - Gem
-- resolve many times
+- implement timeouts
 - check for space-leaks