Switching to Yardoc by default for documentation.

tasks/rdoc.rake

@@ -23,7 +23,4 @@ namespace :doc do
   end
 end
 
-desc "Alias to doc:rdoc"
-task "doc" => "doc:rdoc"
-
 task "clobber" => ["doc:clobber_rdoc", "doc:clobber_ri"]

tasks/rubyforge.rake

@@ -26,7 +26,7 @@ end
 
 namespace :doc do
   desc "Publish RDoc to RubyForge"
-  task :release => ["doc:rdoc"] do
+  task :release => ["doc"] do
     require "rake/contrib/sshpublisher"
     require "yaml"
 

tasks/yard.rake

@@ -0,0 +1,26 @@
+require "rake"
+
+begin
+  require "yard"
+  require "yard/rake/yardoc_task"
+
+  namespace :doc do
+    desc "Generate Yardoc documentation"
+    YARD::Rake::YardocTask.new do |yardoc|
+      yardoc.name = "yard"
+      yardoc.options = ["--verbose"]
+      yardoc.files = [
+        "lib/**/*.rb", "ext/**/*.c", "README", "CHANGELOG", "LICENSE"
+      ]
+    end
+  end
+
+  task "clobber" => ["doc:clobber_yard"]
+
+  desc "Alias to doc:yard"
+  task "doc" => "doc:yard"
+rescue LoadError
+  # If yard isn't available, it's not the end of the world
+  desc "Alias to doc:rdoc"
+  task "doc" => "doc:rdoc"
+end