rdoc 2.4.3 → 2.5

data/test/test_rdoc_parser_simple.rb

@@ -0,0 +1,48 @@
+require 'tempfile'
+require 'rubygems'
+require 'minitest/autorun'
+require 'rdoc/options'
+require 'rdoc/parser'
+
+class TestRDocParserSimple < MiniTest::Unit::TestCase
+
+  def setup
+    @tempfile = Tempfile.new self.class.name
+    filename = @tempfile.path
+
+    @top_level = RDoc::TopLevel.new filename
+    @fn = filename
+    @options = RDoc::Options.new
+    @stats = RDoc::Stats.new 0
+
+    RDoc::TopLevel.reset
+  end
+
+  def teardown
+    @tempfile.close
+  end
+
+  def test_remove_private_comments
+    parser = util_parser ''
+    text = "foo\n\n--\nbar\n++\n\nbaz\n"
+
+    expected = "foo\n\n\n\nbaz\n"
+
+    assert_equal expected, parser.remove_private_comments(text)
+  end
+
+  def test_remove_private_comments_star
+    parser = util_parser ''
+
+    text = "* foo\n* bar\n"
+    expected = text.dup
+
+    assert_equal expected, parser.remove_private_comments(text)
+  end
+
+  def util_parser(content)
+    RDoc::Parser::Simple.new @top_level, @fn, content, @options, @stats
+  end
+
+end
+

data/test/test_rdoc_rdoc.rb

@@ -0,0 +1,66 @@
+require 'tempfile'
+require 'rubygems'
+require 'minitest/autorun'
+require 'rdoc/rdoc'
+
+class TestRDocRDoc < MiniTest::Unit::TestCase
+
+  def setup
+    @rdoc = RDoc::RDoc.new
+    @tempfile = Tempfile.new 'test_rdoc_rdoc'
+  end
+
+  def teardown
+    @tempfile.close
+  end
+
+  def test_gather_files
+    assert_equal(%w[lib/rdoc.rb],
+                 @rdoc.gather_files(%w[lib/rdoc.rb lib/rdoc.rb]))
+  end
+
+  def test_read_file_contents
+    @tempfile.write "hi everybody"
+    @tempfile.flush
+
+    assert_equal "hi everybody", @rdoc.read_file_contents(@tempfile.path)
+  end
+
+  def test_read_file_contents_encoding
+    skip "Encoding not implemented" unless defined? ::Encoding
+
+    @tempfile.write "# coding: utf-8\nhi everybody"
+    @tempfile.flush
+
+    contents = @rdoc.read_file_contents @tempfile.path
+    assert_equal "# coding: utf-8\nhi everybody", contents
+    assert_equal Encoding::UTF_8, contents.encoding
+  end
+
+  def test_read_file_contents_encoding_fancy
+    skip "Encoding not implemented" unless defined? ::Encoding
+
+    @tempfile.write "# -*- coding: utf-8; fill-column: 74 -*-\nhi everybody"
+    @tempfile.flush
+
+    contents = @rdoc.read_file_contents @tempfile.path
+    assert_equal("# -*- coding: utf-8; fill-column: 74 -*-\nhi everybody",
+                 contents)
+    assert_equal Encoding::UTF_8, contents.encoding
+  end
+
+  def test_remove_unparsable
+    file_list = %w[
+      blah.class
+      blah.eps
+      blah.erb
+      blah.scpt.txt
+      blah.ttf
+      blah.yml
+    ]
+
+    assert_empty @rdoc.remove_unparseable file_list
+  end
+
+end
+

data/test/test_rdoc_ri_driver.rb

@@ -1,94 +1,808 @@
+require 'pp'
 require 'rubygems'
-require 'minitest/unit'
+require 'minitest/autorun'
 require 'tmpdir'
+require 'fileutils'
 require 'rdoc/ri/driver'
 
 class TestRDocRIDriver < MiniTest::Unit::TestCase
 
   def setup
+    @RM = RDoc::Markup
+
     @tmpdir = File.join Dir.tmpdir, "test_rdoc_ri_driver_#{$$}"
     @home_ri = File.join @tmpdir, 'dot_ri'
-    @cache_dir = File.join @home_ri, 'cache'
-    @class_cache = File.join @cache_dir, 'classes'
 
     FileUtils.mkdir_p @tmpdir
     FileUtils.mkdir_p @home_ri
-    FileUtils.mkdir_p @cache_dir
 
-    @driver = RDoc::RI::Driver.new(RDoc::RI::Driver.process_args([]))
-    @driver.homepath = @home_ri
+    @orig_ri = ENV['RI']
+    @orig_home = ENV['HOME']
+    ENV['HOME'] = @tmpdir
+    ENV.delete 'RI'
+
+    options = RDoc::RI::Driver.process_args []
+    options[:home] = @tmpdir
+    options[:use_stdout] = true
+    options[:formatter] = @RM::ToRdoc
+    @driver = RDoc::RI::Driver.new options
   end
 
   def teardown
+    ENV['HOME'] = @orig_home
+    ENV['RI'] = @orig_ri
     FileUtils.rm_rf @tmpdir
   end
 
-  def test_lookup_method
-    def @driver.load_cache_for(klassname)
-      { 'Foo#bar' => :found }
+  def mu_pp(obj)
+    s = ''
+    s = PP.pp obj, s
+    s = s.force_encoding(Encoding.default_external) if defined? Encoding
+    s.chomp
+  end
+
+  def test_self_dump
+    util_store
+
+    out, err = capture_io do
+      RDoc::RI::Driver.dump @store.cache_path
     end
 
-    assert @driver.lookup_method('Foo#bar',  'Foo')
+    assert_match %r%:class_methods%,    out
+    assert_match %r%:modules%,          out
+    assert_match %r%:instance_methods%, out
+    assert_match %r%:ancestors%,        out
+  end
+
+  def test_add_also_in_empty
+    out = @RM::Document.new
+
+    @driver.add_also_in out, []
+
+    assert_empty out
+  end
+
+  def test_add_also_in
+    util_multi_store
+    @store1.type = :system
+    @store2.type = :home
+
+    out = @RM::Document.new
+
+    @driver.add_also_in out, [@store1, @store2]
+
+    expected = @RM::Document.new(
+      @RM::Rule.new(1),
+      @RM::Paragraph.new('Also found in:'),
+      @RM::Verbatim.new('  ', 'ruby core', "\n",
+                        '  ', '~/.ri', "\n"))
+
+    assert_equal expected, out
+  end
+
+  def test_add_class
+    util_multi_store
+
+    out = @RM::Document.new
+
+    @driver.add_class out, 'Bar', [@cBar]
+
+    expected = @RM::Document.new(
+      @RM::Heading.new(1, 'Bar < Foo'),
+      @RM::BlankLine.new)
+
+    assert_equal expected, out
+  end
+
+  def test_add_from
+    util_store
+    @store.type = :system
+
+    out = @RM::Document.new
+
+    @driver.add_from out, @store
+
+    expected = @RM::Document.new @RM::Paragraph.new("(from ruby core)")
+
+    assert_equal expected, out
+  end
+
+  def test_add_includes_empty
+    out = @RM::Document.new
+
+    @driver.add_includes out, []
+
+    assert_empty out
+  end
+
+  def test_add_includes_many
+    util_store
+
+    out = @RM::Document.new
+
+    enum = RDoc::Include.new 'Enumerable', nil
+    @cFoo.add_include enum
+
+    @driver.add_includes out, [[[@cFooInc, enum], @store]]
+
+    expected = @RM::Document.new(
+      @RM::Rule.new(1),
+      @RM::Heading.new(1, "Includes:"),
+      @RM::Paragraph.new("(from #{@store.friendly_path})"),
+      @RM::BlankLine.new,
+      @RM::Paragraph.new("Inc"),
+      @RM::BlankLine.new,
+      @RM::Paragraph.new("Include thingy"),
+      @RM::BlankLine.new,
+      @RM::Verbatim.new('  ', 'Enumerable', "\n"))
+
+    assert_equal expected, out
   end
 
-  def test_lookup_method_class_method
-    def @driver.load_cache_for(klassname)
-      { 'Foo::Bar' => :found }
+  def test_add_includes_many_no_doc
+    util_store
+
+    out = @RM::Document.new
+
+    enum = RDoc::Include.new 'Enumerable', nil
+    @cFoo.add_include enum
+    @cFooInc.instance_variable_set :@comment, ''
+
+    @driver.add_includes out, [[[@cFooInc, enum], @store]]
+
+    expected = @RM::Document.new(
+      @RM::Rule.new(1),
+      @RM::Heading.new(1, "Includes:"),
+      @RM::Paragraph.new("(from #{@store.friendly_path})"),
+      @RM::Verbatim.new('  ', 'Inc', "\n",
+                        '  ', 'Enumerable', "\n"))
+
+    assert_equal expected, out
+  end
+
+  def test_add_includes_one
+    util_store
+
+    out = @RM::Document.new
+
+    @driver.add_includes out, [[[@cFooInc], @store]]
+
+    expected = @RM::Document.new(
+      @RM::Rule.new(1),
+      @RM::Heading.new(1, "Includes:"),
+      @RM::Paragraph.new("Inc (from #{@store.friendly_path})"),
+      @RM::BlankLine.new,
+      @RM::Paragraph.new("Include thingy"),
+      @RM::BlankLine.new)
+
+    assert_equal expected, out
+  end
+
+  def test_add_method_list
+    out = @RM::Document.new
+
+    @driver.add_method_list out, %w[new], 'Class methods'
+
+    expected = @RM::Document.new(
+      @RM::Heading.new(1, 'Class methods:'),
+      @RM::BlankLine.new,
+      @RM::Verbatim.new('  ', 'new'),
+      @RM::BlankLine.new)
+
+    assert_equal expected, out
+  end
+
+  def test_add_method_list_none
+    out = @RM::Document.new
+
+    @driver.add_method_list out, nil, 'Class'
+
+    assert_equal @RM::Document.new, out
+  end
+
+  def test_ancestors_of
+    util_ancestors_store
+
+    assert_equal %w[X Mixin Object Foo], @driver.ancestors_of('Foo::Bar')
+  end
+
+  def test_classes
+    util_multi_store
+
+    expected = {
+      'Ambiguous' => [@store1, @store2],
+      'Bar'       => [@store2],
+      'Foo'       => [@store1],
+      'Foo::Bar'  => [@store1],
+      'Foo::Baz'  => [@store1, @store2],
+      'Inc'       => [@store1],
+    }
+
+    assert_equal expected, @driver.classes
+  end
+
+  def test_complete
+    store = RDoc::RI::Store.new @home_ri
+    store.cache[:ancestors] = {
+      'Foo'      => %w[Object],
+      'Foo::Bar' => %w[Object],
+    }
+    store.cache[:class_methods] = {
+      'Foo' => %w[bar]
+    }
+    store.cache[:instance_methods] = {
+      'Foo' => %w[Bar]
+    }
+    store.cache[:modules] = %w[
+      Foo
+      Foo::Bar
+    ]
+
+    @driver.stores = [store]
+
+    assert_equal %w[Foo Foo::Bar], @driver.complete('F')
+    assert_equal %w[    Foo::Bar], @driver.complete('Foo::B')
+
+    assert_equal %w[Foo#Bar],           @driver.complete('Foo#'),  'Foo#'
+    assert_equal %w[Foo#Bar  Foo::bar], @driver.complete('Foo.'),  'Foo.'
+    assert_equal %w[Foo::Bar Foo::bar], @driver.complete('Foo::'), 'Foo::'
+  end
+
+  def test_complete_ancestor
+    util_ancestors_store
+
+    assert_equal %w[Foo::Bar#i_method], @driver.complete('Foo::Bar#')
+
+    assert_equal %w[Foo::Bar#i_method Foo::Bar::c_method Foo::Bar::new],
+                 @driver.complete('Foo::Bar.')
+  end
+
+  def test_complete_classes
+    util_store
+
+    assert_equal %w[Foo   Foo::Bar Foo::Baz], @driver.complete('F')
+    assert_equal %w[Foo:: Foo::Bar Foo::Baz], @driver.complete('Foo::')
+    assert_equal %w[      Foo::Bar Foo::Baz], @driver.complete('Foo::B')
+  end
+
+  def test_complete_multistore
+    util_multi_store
+
+    assert_equal %w[Bar], @driver.complete('B')
+    assert_equal %w[Foo Foo::Bar Foo::Baz], @driver.complete('F')
+  end
+
+  def test_display
+    doc = @RM::Document.new(
+            @RM::Paragraph.new('hi'))
+
+    out, err = capture_io do
+      @driver.display doc
     end
 
-    assert @driver.lookup_method('Foo::Bar', 'Foo::Bar')
+    assert_equal "hi\n", out
   end
 
-  def test_lookup_method_class_missing
-    def @driver.load_cache_for(klassname) end
+  def test_display_class
+    util_store
 
-    assert_nil @driver.lookup_method('Foo#bar', 'Foo')
+    out, err = capture_io do
+      @driver.display_class 'Foo::Bar'
+    end
+
+    assert_match %r%^= Foo::Bar%, out
+    assert_match %r%^\(from%, out # )
+
+    assert_match %r%^= Class methods:%, out
+    assert_match %r%^  new%, out
+    assert_match %r%^= Instance methods:%, out
+    assert_match %r%^  blah%, out
+    assert_match %r%^= Attributes:%, out
+    assert_match %r%^  attr_accessor attr%, out
+
+    assert_equal 1, out.scan(/-\n/).length
   end
 
-  def test_lookup_method_dot_instance
-    def @driver.load_cache_for(klassname)
-      { 'Foo#bar' => :instance, 'Foo::bar' => :klass }
+  def test_display_class_ambiguous
+    util_multi_store
+
+    out, err = capture_io do
+      @driver.display_class 'Ambiguous'
     end
 
-    assert_equal :instance, @driver.lookup_method('Foo.bar', 'Foo')
+    assert_match %r%^= Ambiguous < Object$%, out
   end
 
-  def test_lookup_method_dot_class
-    def @driver.load_cache_for(klassname)
-      { 'Foo::bar' => :found }
+  def test_display_class_multi_no_doc
+    util_multi_store
+
+    out, err = capture_io do
+      @driver.display_class 'Foo::Baz'
     end
 
-    assert @driver.lookup_method('Foo.bar', 'Foo')
+    assert_match %r%^= Foo::Baz%, out
+    assert_match %r%-\n%, out
+    assert_match %r%Also found in:%, out
+    assert_match %r%#{Regexp.escape @home_ri}%, out
+    assert_match %r%#{Regexp.escape @home_ri2}%, out
   end
 
-  def test_lookup_method_method_missing
-    def @driver.load_cache_for(klassname) {} end
+  def test_display_class_superclass
+    util_multi_store
+
+    out, err = capture_io do
+      @driver.display_class 'Bar'
+    end
 
-    assert_nil @driver.lookup_method('Foo#bar', 'Foo')
+    assert_match %r%^= Bar < Foo%, out
   end
 
-  def test_parse_name
-    klass, meth = @driver.parse_name 'Foo::Bar'
+  def test_display_class_module
+    util_store
 
-    assert_equal 'Foo::Bar', klass, 'Foo::Bar class'
-    assert_equal nil,        meth,  'Foo::Bar method'
+    out, err = capture_io do
+      @driver.display_class 'Inc'
+    end
+
+    assert_match %r%^= Inc$%, out
+  end
 
-    klass, meth = @driver.parse_name 'Foo#Bar'
+  def test_display_method
+    util_store
 
-    assert_equal 'Foo', klass, 'Foo#Bar class'
-    assert_equal 'Bar', meth,  'Foo#Bar method'
+    out, err = capture_io do
+      @driver.display_method 'Foo::Bar#blah'
+    end
+
+    assert_match %r%Foo::Bar#blah%, out
+    assert_match %r%blah.5%,        out
+    assert_match %r%blah.6%,        out
+    assert_match %r%yields: stuff%, out
+  end
+
+  def test_display_method_attribute
+    util_store
+
+    out, err = capture_io do
+      @driver.display_method 'Foo::Bar#attr'
+    end
+
+    assert_match %r%Foo::Bar#attr%, out
+    refute_match %r%Implementation from%, out
+  end
+
+  def test_display_method_inherited
+    util_multi_store
+
+    out, err = capture_io do
+      @driver.display_method 'Bar#inherit'
+    end
+
+    assert_match %r%^= Bar#inherit%, out
+    assert_match %r%^=== Implementation from Foo%, out
+  end
+
+  def test_display_name_not_found_class
+    util_store
+
+    out, err = capture_io do
+      assert_equal false, @driver.display_name('Foo::B')
+    end
+
+    expected = <<-EXPECTED
+Foo::B not found, maybe you meant:
+
+Foo::Bar
+Foo::Baz
+    EXPECTED
+
+    assert_equal expected, out
+  end
+
+  def test_display_name_not_found_method
+    util_store
+
+    out, err = capture_io do
+      assert_equal false, @driver.display_name('Foo::Bar#b')
+    end
+
+    expected = <<-EXPECTED
+Foo::Bar#b not found, maybe you meant:
+
+Foo::Bar#blah
+Foo::Bar#bother
+    EXPECTED
+
+    assert_equal expected, out
+  end
+
+  def test_expand_class
+    util_store
+
+    assert_equal 'Foo',       @driver.expand_class('F')
+    assert_equal 'Foo::Bar',  @driver.expand_class('F::Bar')
+
+    assert_raises RDoc::RI::Driver::NotFoundError do
+      @driver.expand_class 'F::B'
+    end
+  end
+
+  def test_expand_name
+    util_store
 
-    klass, meth = @driver.parse_name 'Foo.Bar'
+    assert_equal '.b',        @driver.expand_name('b')
+    assert_equal 'Foo',       @driver.expand_name('F')
+    assert_equal 'Foo::Bar#', @driver.expand_name('F::Bar#')
+
+    e = assert_raises RDoc::RI::Driver::NotFoundError do
+      @driver.expand_name 'Z'
+    end
+
+    assert_equal 'Z', e.name
+  end
+
+  def test_find_methods
+    util_store
+
+    items = []
+
+    @driver.find_methods 'Foo::Bar.' do |store, klass, ancestor, types, method|
+      items << [store, klass, ancestor, types, method]
+    end
+
+    expected = [
+      [@store, 'Foo::Bar', 'Foo::Bar', :both, nil],
+    ]
+
+    assert_equal expected, items
+  end
+
+  def test_find_methods_method
+    util_store
+
+    items = []
+
+    @driver.find_methods '.blah' do |store, klass, ancestor, types, method|
+      items << [store, klass, ancestor, types, method]
+    end
+
+    expected = [
+      [@store, 'Ambiguous', 'Ambiguous', :both, 'blah'],
+      [@store, 'Foo',       'Foo',       :both, 'blah'],
+      [@store, 'Foo::Bar',  'Foo::Bar',  :both, 'blah'],
+      [@store, 'Foo::Baz',  'Foo::Baz',  :both, 'blah'],
+      [@store, 'Inc',       'Inc',       :both, 'blah'],
+    ]
+
+    assert_equal expected, items
+  end
+
+  def test_formatter
+    driver = RDoc::RI::Driver.new
+
+    assert_instance_of @RM::ToAnsi, driver.formatter
+
+    driver.instance_variable_set :@paging, true
+
+    assert_instance_of @RM::ToBs, driver.formatter
+
+    driver.instance_variable_set :@formatter_klass, @RM::ToHtml
+
+    assert_instance_of @RM::ToHtml, driver.formatter
+  end
+
+  def test_method_type
+    assert_equal :both,     @driver.method_type(nil)
+    assert_equal :both,     @driver.method_type('.')
+    assert_equal :instance, @driver.method_type('#')
+    assert_equal :class,    @driver.method_type('::')
+  end
+
+  def test_list_known_classes
+    util_store
+
+    out, err = capture_io do
+      @driver.list_known_classes 
+    end
+
+    assert_equal "Ambiguous\nFoo\nFoo::Bar\nFoo::Baz\nInc\n", out
+  end
+
+  def test_list_methods_matching
+    util_store
+
+    assert_equal %w[Foo::Bar#attr Foo::Bar#blah Foo::Bar#bother Foo::Bar::new],
+                 @driver.list_methods_matching('Foo::Bar.')
+  end
+
+  def test_load_method
+    util_store
+
+    method = @driver.load_method(@store, :instance_methods, 'Foo', '#',
+                                 'inherit')
+
+    assert_equal @inherit, method
+  end
+
+  def test_load_method_inherited
+    util_multi_store
+
+    method = @driver.load_method(@store2, :instance_methods, 'Bar', '#',
+                                 'inherit')
+
+    assert_equal nil, method
+  end
+
+  def test_load_methods_matching
+    util_store
+
+    expected = [[@store, [@inherit]]]
+
+    assert_equal expected, @driver.load_methods_matching('Foo#inherit')
+
+    expected = [[@store, [@blah]]]
+
+    assert_equal expected, @driver.load_methods_matching('.blah')
+
+    assert_empty @driver.load_methods_matching('.b')
+  end
+
+  def test_load_methods_matching_inherited
+    util_multi_store
+
+    expected = [[@store1, [@inherit]]]
+
+    assert_equal expected, @driver.load_methods_matching('Bar#inherit')
+  end
+
+  def test_page
+    @driver.use_stdout = false
+
+    @driver.page do |io|
+      skip "couldn't find a standard pager" if io == $stdout
+
+      assert @driver.paging?
+    end
+
+    refute @driver.paging?
+  end
+
+  def test_page_stdout
+    @driver.use_stdout = true
+
+    @driver.page do |io|
+      assert_equal $stdout, io
+    end
+
+    refute @driver.paging?
+  end
+
+  def test_parse_name_method
+    klass, type, meth = @driver.parse_name 'foo'
+
+    assert_equal '',    klass, 'foo class'
+    assert_equal '.',   type,  'foo type'
+    assert_equal 'foo', meth,  'foo method'
+
+    klass, type, meth = @driver.parse_name '#foo'
+
+    assert_equal '',    klass, '#foo class'
+    assert_equal '#',   type,  '#foo type'
+    assert_equal 'foo', meth,  '#foo method'
+
+    klass, type, meth = @driver.parse_name '::foo'
+
+    assert_equal '',    klass, '::foo class'
+    assert_equal '::',  type,  '::foo type'
+    assert_equal 'foo', meth,  '::foo method'
+  end
+
+  def test_parse_name_single_class
+    klass, type, meth = @driver.parse_name 'Foo'
+
+    assert_equal 'Foo', klass, 'Foo class'
+    assert_equal nil,   type,  'Foo type'
+    assert_equal nil,   meth,  'Foo method'
+
+    klass, type, meth = @driver.parse_name 'Foo#'
+
+    assert_equal 'Foo', klass, 'Foo# class'
+    assert_equal '#',   type,  'Foo# type'
+    assert_equal nil,   meth,  'Foo# method'
+
+    klass, type, meth = @driver.parse_name 'Foo::'
+
+    assert_equal 'Foo', klass, 'Foo:: class'
+    assert_equal '::',  type,  'Foo:: type'
+    assert_equal nil,   meth,  'Foo:: method'
+
+    klass, type, meth = @driver.parse_name 'Foo.'
+
+    assert_equal 'Foo', klass, 'Foo. class'
+    assert_equal '.',   type,  'Foo. type'
+    assert_equal nil,   meth,  'Foo. method'
+
+    klass, type, meth = @driver.parse_name 'Foo#Bar'
 
     assert_equal 'Foo', klass, 'Foo#Bar class'
+    assert_equal '#',   type,  'Foo#Bar type'
     assert_equal 'Bar', meth,  'Foo#Bar method'
 
-    klass, meth = @driver.parse_name 'Foo::bar'
+    klass, type, meth = @driver.parse_name 'Foo.Bar'
+
+    assert_equal 'Foo', klass, 'Foo.Bar class'
+    assert_equal '.',   type,  'Foo.Bar type'
+    assert_equal 'Bar', meth,  'Foo.Bar method'
+
+    klass, type, meth = @driver.parse_name 'Foo::bar'
 
     assert_equal 'Foo', klass, 'Foo::bar class'
+    assert_equal '::',  type,  'Foo::bar type'
     assert_equal 'bar', meth,  'Foo::bar method'
   end
 
+  def test_parse_name_namespace
+    klass, type, meth = @driver.parse_name 'Foo::Bar'
+
+    assert_equal 'Foo::Bar', klass, 'Foo::Bar class'
+    assert_equal nil,        type,  'Foo::Bar type'
+    assert_equal nil,        meth,  'Foo::Bar method'
+
+    klass, type, meth = @driver.parse_name 'Foo::Bar#'
+
+    assert_equal 'Foo::Bar', klass, 'Foo::Bar# class'
+    assert_equal '#',        type,  'Foo::Bar# type'
+    assert_equal nil,        meth,  'Foo::Bar# method'
+
+    klass, type, meth = @driver.parse_name 'Foo::Bar#baz'
+
+    assert_equal 'Foo::Bar', klass, 'Foo::Bar#baz class'
+    assert_equal '#',        type,  'Foo::Bar#baz type'
+    assert_equal 'baz',      meth,  'Foo::Bar#baz method'
+  end
+
+  def test_setup_pager
+    @driver.use_stdout = false
+
+    pager = @driver.setup_pager
+
+    skip "couldn't find a standard pager" unless pager
+
+    assert @driver.paging?
+  ensure
+    pager.close if pager
+  end
+
+  def util_ancestors_store
+    store1 = RDoc::RI::Store.new @home_ri
+    store1.cache[:ancestors] = {
+      'Foo'      => %w[Object],
+      'Foo::Bar' => %w[Foo],
+    }
+    store1.cache[:class_methods] = {
+      'Foo'      => %w[c_method new],
+      'Foo::Bar' => %w[new],
+    }
+    store1.cache[:instance_methods] = {
+      'Foo' => %w[i_method],
+    }
+    store1.cache[:modules] = %w[
+      Foo
+      Foo::Bar
+    ]
+
+    store2 = RDoc::RI::Store.new @home_ri
+    store2.cache[:ancestors] = {
+      'Foo'    => %w[Mixin Object],
+      'Mixin'  => %w[],
+      'Object' => %w[X Object],
+      'X'      => %w[Object],
+    }
+    store2.cache[:class_methods] = {
+      'Foo'    => %w[c_method new],
+      'Mixin'  => %w[],
+      'X'      => %w[],
+      'Object' => %w[],
+    }
+    store2.cache[:instance_methods] = {
+      'Foo'   => %w[i_method],
+      'Mixin' => %w[],
+    }
+    store2.cache[:modules] = %w[
+      Foo
+      Mixin
+      Object
+      X
+    ]
+
+    @driver.stores = store1, store2
+  end
+
+  def util_multi_store
+    util_store
+    @store1 = @store
+
+    @home_ri2 = "#{@home_ri}2"
+    @store2 = RDoc::RI::Store.new @home_ri2
+
+    # as if seen in a namespace like class Ambiguous::Other
+    @mAmbiguous = RDoc::NormalModule.new 'Ambiguous'
+
+    @cFoo = RDoc::NormalClass.new 'Foo'
+    @cBar = RDoc::NormalClass.new 'Bar'
+    @cBar.superclass = 'Foo'
+    @cFoo_Baz = RDoc::NormalClass.new 'Baz'
+    @cFoo_Baz.parent = @cFoo
+
+    @baz = RDoc::AnyMethod.new nil, 'baz'
+    @cBar.add_method @baz
+
+    @store2.save_class @mAmbiguous
+    @store2.save_class @cBar
+    @store2.save_class @cFoo_Baz
+
+    @store2.save_method @cBar, @baz
+
+    @store2.save_cache
+
+    @driver.stores = [@store1, @store2]
+  end
+
+  def util_store
+    @store = RDoc::RI::Store.new @home_ri
+
+    @cFoo       = RDoc::NormalClass.new 'Foo'
+    @mInc       = RDoc::NormalModule.new 'Inc'
+    @cAmbiguous = RDoc::NormalClass.new 'Ambiguous'
+
+    doc = @RM::Document.new @RM::Paragraph.new('Include thingy')
+
+    @cFooInc = RDoc::Include.new 'Inc', doc
+    @cFoo.add_include @cFooInc
+
+    @cFoo_Bar = RDoc::NormalClass.new 'Bar'
+    @cFoo_Bar.parent = @cFoo
+
+    @blah = RDoc::AnyMethod.new nil, 'blah'
+    @blah.call_seq = "blah(5) => 5\nblah(6) => 6\n"
+    @blah.block_params = "stuff"
+
+    @bother = RDoc::AnyMethod.new nil, 'bother'
+
+    @new  = RDoc::AnyMethod.new nil, 'new'
+    @new.singleton = true
+
+    @cFoo_Bar.add_method @blah
+    @cFoo_Bar.add_method @bother
+    @cFoo_Bar.add_method @new
+
+    @attr = RDoc::Attr.new nil, 'attr', 'RW', ''
+
+    @cFoo_Bar.add_attribute @attr
+
+    @cFoo_Baz = RDoc::NormalClass.new 'Baz'
+    @cFoo_Baz.parent = @cFoo
+
+    @inherit = RDoc::AnyMethod.new nil, 'inherit'
+    @cFoo.add_method @inherit
+
+    @store.save_class @cFoo
+    @store.save_class @cFoo_Bar
+    @store.save_class @cFoo_Baz
+    @store.save_class @mInc
+    @store.save_class @cAmbiguous
+
+    @store.save_method @cFoo_Bar, @blah
+    @store.save_method @cFoo_Bar, @bother
+    @store.save_method @cFoo_Bar, @new
+    @store.save_method @cFoo_Bar, @attr
+
+    @store.save_method @cFoo, @inherit
+
+    @store.save_cache
+
+    @driver.stores = [@store]
+  end
+
 end
 
-MiniTest::Unit.autorun