dev: add rake task to build rdoc for all 3 repos in one

.gitignore

@@ -3,9 +3,11 @@
 coverage
 rdoc
 pkg
-repos
 tags
 .bundle
 Gemfile.lock
 .bundle
 bin
+repos/*
+!repos/.gitkeep
+!repos/.yardopts

Rakefile

@@ -180,6 +180,38 @@ task :default do
   run_command 'rake'
 end
 
+namespace :doc do
+  desc "generate docs"
+  task :generate do
+    Dir.chdir("repos") do
+      sh "ln -s rspec-core/README.md RSpecCore.md" unless test ?f, "RSpecCore.md"
+      sh "ln -s rspec-expectations/README.md RSpecExpectations.md" unless test ?f, "RSpecExpectations.md"
+      sh "ln -s rspec-mocks/README.md RSpecMocks.md" unless test ?f, "RSpecMocks.md"
+      sh "yardoc"
+      sh "rm RSpecCore.md"
+      sh "rm RSpecExpectations.md"
+      sh "rm RSpecMocks.md"
+    end
+  end
+
+  desc "clobber generated docs"
+  task :clobber do
+    Dir.chdir("repos") do
+      sh "rm -rf .yardoc"
+      sh "rm -rf doc"
+    end
+  end
+
+  desc "publish generated docs"
+  task :publish do
+    Dir.chdir("repos") do
+      `rsync -av --delete doc david@davidchelimsky.net:/www/api.rspec.info`
+    end
+  end
+end
+
+task :rdoc => ["doc:clobber", "doc:generate"]
+
 task :authors do
   logs = Projects.inject("") do |logs, dir|
     path = ReposPath.join(dir)

repos/.yardopts

@@ -0,0 +1,9 @@
+--no-private
+--markup markdown
+rspec-core/lib/**/*.rb
+rspec-expectations/lib/**/*.rb
+rspec-mocks/lib/**/*.rb
+-
+RSpecCore.md
+RSpecExpectations.md
+RSpecMocks.md