* common.mk (rdoc-bench): add a benchmark rule

using RDoc. Generate all rdoc related files
  (same as `make rdoc') in temporary directory
  and remove them. Excecution time, GC::Profiler
  and results of GC.stat are printed.
* tool/rdocbench.rb: added for `rdoc-bench'.



git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@40872 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

ChangeLog

@@ -1,3 +1,13 @@
+Tue May 21 16:29:09 2013  Koichi Sasada  <ko1@atdot.net>
+
+	* common.mk (rdoc-bench): add a benchmark rule
+	  using RDoc. Generate all rdoc related files 
+	  (same as `make rdoc') in temporary directory
+	  and remove them. Excecution time, GC::Profiler
+	  and results of GC.stat are printed.
+
+	* tool/rdocbench.rb: added for `rdoc-bench'.
+
 Tue May 21 16:25:05 2013  Koichi Sasada  <ko1@atdot.net>
 
 	* gc.c (gc_profile_dump_on): `count' should be (int) because it

common.mk

@@ -424,6 +424,12 @@ rdoc-coverage: PHONY main
 	@echo Generating RDoc coverage report
 	$(Q) $(XRUBY) "$(srcdir)/bin/rdoc" --root "$(srcdir)" --encoding=UTF-8 --all --quiet -C $(RDOCFLAGS) "$(srcdir)"
 
+RDOCBENCHOUT=/tmp/rdocbench
+
+rdoc-bench: PHONY ruby
+	@echo Benchmark with Generating RDoc documentation
+	$(Q) $(XRUBY) "$(srcdir)/tool/rdocbench.rb" --root "$(srcdir)" --page-dir "$(srcdir)/doc" --encoding=UTF-8 --no-force-update --all --ri  --debug $(RDOCFLAGS) --quiet "$(srcdir)"
+
 nodoc: PHONY
 
 what-where-doc: no-install-doc

tool/rdocbench.rb

@@ -0,0 +1,21 @@
+
+require 'rdoc/rdoc'
+require 'tmpdir'
+require 'benchmark'
+require 'pp'
+
+Dir.mktmpdir('rdocbench-'){|d|
+  dir = File.join(d, 'rdocbench')
+  args = ARGV.dup
+  args << '--op' << dir
+
+  GC::Profiler.enable
+  Benchmark.bm{|x|
+    x.report('rdoc'){
+      r = RDoc::RDoc.new
+      r.document args
+      GC::Profiler.report
+      pp GC.stat
+    }
+  }
+}