Multiple changes.

- Remove the runtime dependency on rake-compiler.
 - Use #rb_str_new instead of #rb_str_new2, the hash character array
   isn't null terminated.
 - Add various safeguards for object instantiations.
 - Remove the 'threaded' options for messages, folding them into
   'archived'.  If archiving is enabled, so is threading.
 - Return nil for lookups from the list object instead of raising
   exceptions.
 - Open subject indexes with the proper encodings (thanks Michael
   Granger!)
 - Allow touching and unlinking files to operate on multiple paths
   at once, within a single safety() wrap.

lib/ezmlm.rb

@@ -1,8 +1,15 @@
-#!/usr/bin/ruby
 # vim: set nosta noet ts=4 sw=4:
-#
+
+
 # A Ruby interface to the ezmlm-idx mailing list system.
 #
+#   Ezmlm.find_directories( '/lists' ) #=> [ Ezmlm::List, Ezmlm::List ]
+#
+#   Ezmlm.each_list( '/lists' ) do |list|
+#       puts "\"%s\" <%s>" % [ list.name, list.address ]
+#   end
+#
+#
 # == Version
 #
 #  $Id$