Sync net/http RBS docs with RDoc

Author: sferik

Gemfile

@@ -3,6 +3,7 @@ source "https://rubygems.org"
 gemspec
 
 gem "rake"
+gem "rdoc"
 gem "rbs"
 gem "steep"
 gem "test-unit"

Rakefile

@@ -1,5 +1,6 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
+require "tmpdir"
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test/lib"
@@ -12,4 +13,15 @@ task :steep do
   sh "steep check"
 end
 
+namespace :rbs do
+  desc "Update public RBS comments from local RDoc"
+  task :annotate do
+    Dir.mktmpdir do |tmpdir|
+      sh "rdoc", "--ri", "--output", "#{tmpdir}/doc", "--root=.", "lib", "doc"
+      sh "rbs", "annotate", "--no-system", "--no-gems", "--no-site", "--no-home",
+         "-d", "#{tmpdir}/doc", "sig/net-http.rbs"
+    end
+  end
+end
+
 task :default => :test