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"
@@ -18,6 +19,15 @@ namespace :rbs do
     t.ruby_opts << "-rtest_helper"
     t.test_files = FileList["test_sig/test_*.rb"]
   end
+
+  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