RubyGems - rdoc - Versions diffs - 4.3.0 → 5.0.0.beta1 - Mend

rdoc 4.3.0 → 5.0.0.beta1

Potentially problematic release.

This version of rdoc might be problematic. Click here for more details.

Files changed (248) hide show

checksums.yaml +4 -4
data/.gitignore +13 -0
data/.travis.yml +23 -0
data/CONTRIBUTING.rdoc +4 -3
data/Gemfile +3 -0
data/History.rdoc +15 -4
data/LEGAL.rdoc +2 -2
data/README.rdoc +1 -0
data/Rakefile +41 -79
data/bin/console +7 -0
data/bin/setup +6 -0
data/{bin → exe}/rdoc +0 -0
data/{bin → exe}/ri +0 -0
data/lib/rdoc.rb +2 -1
data/lib/rdoc/alias.rb +1 -0
data/lib/rdoc/anon_class.rb +1 -0
data/lib/rdoc/any_method.rb +1 -0
data/lib/rdoc/attr.rb +1 -0
data/lib/rdoc/class_module.rb +1 -0
data/lib/rdoc/code_object.rb +1 -0
data/lib/rdoc/code_objects.rb +1 -0
data/lib/rdoc/comment.rb +1 -0
data/lib/rdoc/constant.rb +1 -0
data/lib/rdoc/context.rb +4 -1
data/lib/rdoc/context/section.rb +7 -0
data/lib/rdoc/cross_reference.rb +1 -0
data/lib/rdoc/encoding.rb +14 -0
data/lib/rdoc/erb_partial.rb +1 -0
data/lib/rdoc/erbio.rb +1 -0
data/lib/rdoc/extend.rb +1 -0
data/lib/rdoc/generator.rb +1 -0
data/lib/rdoc/generator/darkfish.rb +1 -0
data/lib/rdoc/generator/json_index.rb +1 -0
data/lib/rdoc/generator/markup.rb +1 -0
data/lib/rdoc/generator/pot.rb +1 -0
data/lib/rdoc/generator/pot/message_extractor.rb +1 -0
data/lib/rdoc/generator/pot/po.rb +1 -0
data/lib/rdoc/generator/pot/po_entry.rb +1 -0
data/lib/rdoc/generator/ri.rb +1 -0
data/lib/rdoc/generator/template/darkfish/_head.rhtml +2 -1
data/lib/rdoc/generator/template/darkfish/css/fonts.css +6 -6
data/lib/rdoc/generator/template/darkfish/js/darkfish.js +7 -7
data/lib/rdoc/generator/template/json_index/js/searcher.js +1 -0
data/lib/rdoc/ghost_method.rb +1 -0
data/lib/rdoc/i18n.rb +1 -0
data/lib/rdoc/i18n/locale.rb +1 -0
data/lib/rdoc/i18n/text.rb +1 -0
data/lib/rdoc/include.rb +1 -0
data/lib/rdoc/known_classes.rb +1 -0
data/lib/rdoc/markdown.kpeg +2 -6
data/lib/rdoc/markdown.rb +2 -6
data/lib/rdoc/markdown/entities.rb +1 -0
data/lib/rdoc/markdown/{literals_1_9.kpeg → literals.kpeg} +0 -0
data/lib/rdoc/markdown/{literals_1_9.rb → literals.rb} +1 -4
data/lib/rdoc/markup.rb +1 -0
data/lib/rdoc/markup/attr_changer.rb +1 -0
data/lib/rdoc/markup/attr_span.rb +1 -0
data/lib/rdoc/markup/attribute_manager.rb +1 -0
data/lib/rdoc/markup/attributes.rb +1 -0
data/lib/rdoc/markup/blank_line.rb +1 -0
data/lib/rdoc/markup/block_quote.rb +1 -0
data/lib/rdoc/markup/document.rb +1 -0
data/lib/rdoc/markup/formatter.rb +1 -0
data/lib/rdoc/markup/formatter_test_case.rb +1 -4
data/lib/rdoc/markup/hard_break.rb +1 -0
data/lib/rdoc/markup/heading.rb +1 -0
data/lib/rdoc/markup/include.rb +1 -0
data/lib/rdoc/markup/indented_paragraph.rb +1 -0
data/lib/rdoc/markup/inline.rb +1 -0
data/lib/rdoc/markup/list.rb +1 -0
data/lib/rdoc/markup/list_item.rb +1 -0
data/lib/rdoc/markup/paragraph.rb +1 -0
data/lib/rdoc/markup/parser.rb +1 -0
data/lib/rdoc/markup/pre_process.rb +1 -0
data/lib/rdoc/markup/raw.rb +1 -0
data/lib/rdoc/markup/rule.rb +1 -0
data/lib/rdoc/markup/special.rb +1 -0
data/lib/rdoc/markup/text_formatter_test_case.rb +1 -0
data/lib/rdoc/markup/to_ansi.rb +1 -0
data/lib/rdoc/markup/to_bs.rb +1 -0
data/lib/rdoc/markup/to_html.rb +1 -0
data/lib/rdoc/markup/to_html_crossref.rb +1 -0
data/lib/rdoc/markup/to_html_snippet.rb +1 -0
data/lib/rdoc/markup/to_joined_paragraph.rb +1 -0
data/lib/rdoc/markup/to_label.rb +1 -0
data/lib/rdoc/markup/to_markdown.rb +1 -0
data/lib/rdoc/markup/to_rdoc.rb +1 -0
data/lib/rdoc/markup/to_table_of_contents.rb +1 -0
data/lib/rdoc/markup/to_test.rb +1 -0
data/lib/rdoc/markup/to_tt_only.rb +1 -0
data/lib/rdoc/markup/verbatim.rb +1 -0
data/lib/rdoc/meta_method.rb +1 -0
data/lib/rdoc/method_attr.rb +1 -0
data/lib/rdoc/mixin.rb +1 -0
data/lib/rdoc/normal_class.rb +1 -0
data/lib/rdoc/normal_module.rb +1 -0
data/lib/rdoc/options.rb +1 -0
data/lib/rdoc/parser.rb +1 -0
data/lib/rdoc/parser/c.rb +76 -33
data/lib/rdoc/parser/changelog.rb +7 -1
data/lib/rdoc/parser/markdown.rb +1 -0
data/lib/rdoc/parser/rd.rb +1 -0
data/lib/rdoc/parser/ruby.rb +1 -0
data/lib/rdoc/parser/ruby_tools.rb +1 -0
data/lib/rdoc/parser/simple.rb +1 -0
data/lib/rdoc/parser/text.rb +1 -0
data/lib/rdoc/rd.rb +1 -0
data/lib/rdoc/rd/inline.rb +1 -0
data/lib/rdoc/rdoc.rb +2 -1
data/lib/rdoc/require.rb +1 -0
data/lib/rdoc/ri.rb +1 -0
data/lib/rdoc/ri/driver.rb +5 -19
data/lib/rdoc/ri/formatter.rb +1 -0
data/lib/rdoc/ri/paths.rb +1 -0
data/lib/rdoc/ri/store.rb +1 -0
data/lib/rdoc/ri/task.rb +72 -0
data/lib/rdoc/ruby_lex.rb +11 -17
data/lib/rdoc/ruby_token.rb +1 -0
data/lib/rdoc/rubygems_hook.rb +1 -0
data/lib/rdoc/servlet.rb +4 -3
data/lib/rdoc/single_class.rb +1 -0
data/lib/rdoc/stats.rb +1 -0
data/lib/rdoc/stats/normal.rb +1 -0
data/lib/rdoc/stats/quiet.rb +1 -0
data/lib/rdoc/stats/verbose.rb +1 -0
data/lib/rdoc/store.rb +3 -9
data/lib/rdoc/task.rb +1 -0
data/lib/rdoc/test_case.rb +1 -10
data/lib/rdoc/text.rb +1 -0
data/lib/rdoc/token_stream.rb +1 -0
data/lib/rdoc/tom_doc.rb +1 -0
data/lib/rdoc/top_level.rb +1 -0
data/rdoc.gemspec +60 -0
metadata +32 -155
data/Manifest.txt +0 -309
data/lib/rdoc/markdown/literals_1_8.kpeg +0 -18
data/lib/rdoc/markdown/literals_1_8.rb +0 -416
data/test/MarkdownTest_1.0.3/Amps and angle encoding.text +0 -21
data/test/MarkdownTest_1.0.3/Auto links.text +0 -13
data/test/MarkdownTest_1.0.3/Backslash escapes.text +0 -120
data/test/MarkdownTest_1.0.3/Blockquotes with code blocks.text +0 -11
data/test/MarkdownTest_1.0.3/Code Blocks.text +0 -14
data/test/MarkdownTest_1.0.3/Code Spans.text +0 -6
data/test/MarkdownTest_1.0.3/Hard-wrapped paragraphs with list-like lines.text +0 -8
data/test/MarkdownTest_1.0.3/Horizontal rules.text +0 -67
data/test/MarkdownTest_1.0.3/Inline HTML (Advanced).text +0 -15
data/test/MarkdownTest_1.0.3/Inline HTML (Simple).text +0 -69
data/test/MarkdownTest_1.0.3/Inline HTML comments.text +0 -13
data/test/MarkdownTest_1.0.3/Links, inline style.text +0 -12
data/test/MarkdownTest_1.0.3/Links, reference style.text +0 -71
data/test/MarkdownTest_1.0.3/Links, shortcut references.text +0 -20
data/test/MarkdownTest_1.0.3/Literal quotes in titles.text +0 -7
data/test/MarkdownTest_1.0.3/Markdown Documentation - Basics.text +0 -306
data/test/MarkdownTest_1.0.3/Markdown Documentation - Syntax.text +0 -888
data/test/MarkdownTest_1.0.3/Nested blockquotes.text +0 -5
data/test/MarkdownTest_1.0.3/Ordered and unordered lists.text +0 -131
data/test/MarkdownTest_1.0.3/Strong and em together.text +0 -7
data/test/MarkdownTest_1.0.3/Tabs.text +0 -21
data/test/MarkdownTest_1.0.3/Tidyness.text +0 -5
data/test/README +0 -1
data/test/binary.dat +0 -0
data/test/hidden.zip.txt +0 -1
data/test/test.ja.largedoc +0 -3
data/test/test.ja.rdoc +0 -10
data/test/test.ja.txt +0 -8
data/test/test.txt +0 -1
data/test/test_rdoc_alias.rb +0 -13
data/test/test_rdoc_any_method.rb +0 -460
data/test/test_rdoc_attr.rb +0 -190
data/test/test_rdoc_class_module.rb +0 -1492
data/test/test_rdoc_code_object.rb +0 -450
data/test/test_rdoc_comment.rb +0 -504
data/test/test_rdoc_constant.rb +0 -181
data/test/test_rdoc_context.rb +0 -901
data/test/test_rdoc_context_section.rb +0 -130
data/test/test_rdoc_cross_reference.rb +0 -192
data/test/test_rdoc_encoding.rb +0 -227
data/test/test_rdoc_extend.rb +0 -94
data/test/test_rdoc_generator_darkfish.rb +0 -229
data/test/test_rdoc_generator_json_index.rb +0 -324
data/test/test_rdoc_generator_markup.rb +0 -59
data/test/test_rdoc_generator_pot.rb +0 -91
data/test/test_rdoc_generator_pot_po.rb +0 -51
data/test/test_rdoc_generator_pot_po_entry.rb +0 -139
data/test/test_rdoc_generator_ri.rb +0 -78
data/test/test_rdoc_i18n_locale.rb +0 -73
data/test/test_rdoc_i18n_text.rb +0 -123
data/test/test_rdoc_include.rb +0 -108
data/test/test_rdoc_markdown.rb +0 -980
data/test/test_rdoc_markdown_test.rb +0 -1884
data/test/test_rdoc_markup.rb +0 -95
data/test/test_rdoc_markup_attribute_manager.rb +0 -364
data/test/test_rdoc_markup_attributes.rb +0 -39
data/test/test_rdoc_markup_document.rb +0 -207
data/test/test_rdoc_markup_formatter.rb +0 -175
data/test/test_rdoc_markup_hard_break.rb +0 -31
data/test/test_rdoc_markup_heading.rb +0 -29
data/test/test_rdoc_markup_include.rb +0 -19
data/test/test_rdoc_markup_indented_paragraph.rb +0 -53
data/test/test_rdoc_markup_paragraph.rb +0 -32
data/test/test_rdoc_markup_parser.rb +0 -1680
data/test/test_rdoc_markup_pre_process.rb +0 -473
data/test/test_rdoc_markup_raw.rb +0 -22
data/test/test_rdoc_markup_to_ansi.rb +0 -369
data/test/test_rdoc_markup_to_bs.rb +0 -366
data/test/test_rdoc_markup_to_html.rb +0 -662
data/test/test_rdoc_markup_to_html_crossref.rb +0 -225
data/test/test_rdoc_markup_to_html_snippet.rb +0 -711
data/test/test_rdoc_markup_to_joined_paragraph.rb +0 -32
data/test/test_rdoc_markup_to_label.rb +0 -112
data/test/test_rdoc_markup_to_markdown.rb +0 -389
data/test/test_rdoc_markup_to_rdoc.rb +0 -377
data/test/test_rdoc_markup_to_table_of_contents.rb +0 -126
data/test/test_rdoc_markup_to_tt_only.rb +0 -246
data/test/test_rdoc_markup_verbatim.rb +0 -29
data/test/test_rdoc_method_attr.rb +0 -193
data/test/test_rdoc_normal_class.rb +0 -47
data/test/test_rdoc_normal_module.rb +0 -42
data/test/test_rdoc_options.rb +0 -766
data/test/test_rdoc_parser.rb +0 -327
data/test/test_rdoc_parser_c.rb +0 -1896
data/test/test_rdoc_parser_changelog.rb +0 -315
data/test/test_rdoc_parser_markdown.rb +0 -61
data/test/test_rdoc_parser_rd.rb +0 -55
data/test/test_rdoc_parser_ruby.rb +0 -3322
data/test/test_rdoc_parser_simple.rb +0 -115
data/test/test_rdoc_rd.rb +0 -30
data/test/test_rdoc_rd_block_parser.rb +0 -535
data/test/test_rdoc_rd_inline.rb +0 -63
data/test/test_rdoc_rd_inline_parser.rb +0 -177
data/test/test_rdoc_rdoc.rb +0 -455
data/test/test_rdoc_require.rb +0 -25
data/test/test_rdoc_ri_driver.rb +0 -1436
data/test/test_rdoc_ri_paths.rb +0 -155
data/test/test_rdoc_ruby_lex.rb +0 -421
data/test/test_rdoc_ruby_token.rb +0 -19
data/test/test_rdoc_rubygems_hook.rb +0 -251
data/test/test_rdoc_servlet.rb +0 -534
data/test/test_rdoc_single_class.rb +0 -20
data/test/test_rdoc_stats.rb +0 -722
data/test/test_rdoc_store.rb +0 -993
data/test/test_rdoc_task.rb +0 -173
data/test/test_rdoc_text.rb +0 -557
data/test/test_rdoc_token_stream.rb +0 -42
data/test/test_rdoc_tom_doc.rb +0 -520
data/test/test_rdoc_top_level.rb +0 -287
data/test/xref_data.rb +0 -76
data/test/xref_test_case.rb +0 -67

data/test/test_rdoc_code_object.rb DELETED

@@ -1,450 +0,0 @@
-# coding: US-ASCII
-require File.expand_path '../xref_test_case', __FILE__
-class TestRDocCodeObject < XrefTestCase
-  def setup
-    super
-    @co = RDoc::CodeObject.new
-  end
-  def test_initialize
-    assert @co.document_self, 'document_self'
-    assert @co.document_children, 'document_children'
-    refute @co.force_documentation, 'force_documentation'
-    refute @co.done_documenting, 'done_documenting'
-    refute @co.received_nodoc, 'received_nodoc'
-    assert_equal '', @co.comment, 'comment is empty'
-  end
-  def test_comment_equals
-    @co.comment = ''
-    assert_equal '', @co.comment
-    @co.comment = 'I am a comment'
-    assert_equal 'I am a comment', @co.comment
-  end
-  def test_comment_equals_comment
-    @co.comment = comment ''
-    assert_equal '', @co.comment.text
-    @co.comment = comment 'I am a comment'
-    assert_equal 'I am a comment', @co.comment.text
-  end
-  def test_comment_equals_document
-    doc = RDoc::Markup::Document.new
-    @co.comment = doc
-    @co.comment = ''
-    assert_equal doc, @co.comment
-  end
-  def test_comment_equals_encoding
-    skip "Encoding not implemented" unless Object.const_defined? :Encoding
-    refute_equal Encoding::UTF_8, ''.encoding, 'Encoding sanity check'
-    input = 'text'
-    input.force_encoding Encoding::UTF_8
-    @co.comment = input
-    assert_equal 'text', @co.comment
-    assert_equal Encoding::UTF_8, @co.comment.encoding
-  end
-  def test_comment_equals_encoding_blank
-    skip "Encoding not implemented" unless Object.const_defined? :Encoding
-    refute_equal Encoding::UTF_8, ''.encoding, 'Encoding sanity check'
-    input = ''
-    input.force_encoding Encoding::UTF_8
-    @co.comment = input
-    assert_equal '', @co.comment
-    assert_equal Encoding::UTF_8, @co.comment.encoding
-  end
-  def test_display_eh_document_self
-    assert @co.display?
-    @co.document_self = false
-    refute @co.display?
-  end
-  def test_display_eh_ignore
-    assert @co.display?
-    @co.ignore
-    refute @co.display?
-    @co.stop_doc
-    refute @co.display?
-    @co.done_documenting = false
-    refute @co.display?
-  end
-  def test_display_eh_suppress
-    assert @co.display?
-    @co.suppress
-    refute @co.display?
-    @co.comment = comment('hi')
-    refute @co.display?
-    @co.done_documenting = false
-    assert @co.display?
-    @co.ignore
-    @co.done_documenting = false
-    refute @co.display?
-  end
-  def test_document_children_equals
-    @co.document_children = false
-    refute @co.document_children
-    @store.rdoc.options.visibility = :nodoc
-    @co.store = @store
-    assert @co.document_children
-    @co.document_children = false
-    assert @co.document_children
-  end
-  def test_document_self_equals
-    @co.document_self = false
-    refute @co.document_self
-    @store.rdoc.options.visibility = :nodoc
-    @co.store = @store
-    assert @co.document_self
-    @co.document_self = false
-    assert @co.document_self
-  end
-  def test_documented_eh
-    refute @co.documented?
-    @co.comment = 'hi'
-    assert @co.documented?
-    @co.comment.replace ''
-    refute @co.documented?
-    @co.document_self = nil # notify :nodoc:
-    assert @co.documented?
-  end
-  def test_done_documenting
-    # once done_documenting is set, other properties refuse to go to "true"
-    @co.done_documenting = true
-    @co.document_self = true
-    refute @co.document_self
-    @co.document_children = true
-    refute @co.document_children
-    @co.force_documentation = true
-    refute @co.force_documentation
-    @co.start_doc
-    refute @co.document_self
-    refute @co.document_children
-    # turning done_documenting on
-    # resets others to true
-    @co.done_documenting = false
-    assert @co.document_self
-    assert @co.document_children
-    @co.done_documenting = true
-    @store.rdoc.options.visibility = :nodoc
-    @co.store = @store
-    refute @co.done_documenting
-    @co.done_documenting = true
-    refute @co.done_documenting
-  end
-  def test_each_parent
-    parents = []
-    @parent_m.each_parent do |code_object|
-      parents << code_object
-    end
-    assert_equal [@parent, @xref_data], parents
-  end
-  def test_file_name
-    assert_equal nil, @co.file_name
-    @co.record_location @store.add_file 'lib/file.rb'
-    assert_equal 'lib/file.rb', @co.file_name
-  end
-  def test_full_name_equals
-    @co.full_name = 'hi'
-    assert_equal 'hi', @co.instance_variable_get(:@full_name)
-    @co.full_name = nil
-    assert_nil @co.instance_variable_get(:@full_name)
-  end
-  def test_ignore
-    @co.ignore
-    refute @co.document_self
-    refute @co.document_children
-    assert @co.ignored?
-    @store.rdoc.options.visibility = :nodoc
-    @co.store = @store
-    assert @co.document_self
-    assert @co.document_children
-    refute @co.ignored?
-    @co.ignore
-    refute @co.ignored?
-  end
-  def test_ignore_eh
-    refute @co.ignored?
-    @co.ignore
-    assert @co.ignored?
-  end
-  def test_line
-    @c1_m.line = 5
-    assert_equal 5, @c1_m.line
-  end
-  def test_metadata
-    assert_empty @co.metadata
-    @co.metadata['markup'] = 'not_rdoc'
-    expected = { 'markup' => 'not_rdoc' }
-    assert_equal expected, @co.metadata
-    assert_equal 'not_rdoc', @co.metadata['markup']
-  end
-  def test_offset
-    @c1_m.offset = 5
-    assert_equal 5, @c1_m.offset
-  end
-  def test_options
-    assert_kind_of RDoc::Options, @co.options
-    @co.store = @store
-    assert_same @options, @co.options
-  end
-  def test_parent_file_name
-    assert_equal '(unknown)', @co.parent_file_name
-    assert_equal 'xref_data.rb', @c1.parent_file_name
-  end
-  def test_parent_name
-    assert_equal '(unknown)', @co.parent_name
-    assert_equal 'xref_data.rb', @c1.parent_name
-    assert_equal 'C2', @c2_c3.parent_name
-  end
-  def test_received_ndoc
-    @co.document_self = false
-    refute @co.received_nodoc
-    @co.document_self = nil
-    assert @co.received_nodoc
-    @co.document_self = true
-  end
-  def test_record_location
-    @co.record_location @xref_data
-    assert_equal 'xref_data.rb', @co.file.relative_name
-  end
-  def test_record_location_ignored
-    @co.ignore
-    @co.record_location @xref_data
-    refute @co.ignored?
-  end
-  def test_record_location_suppressed
-    @co.suppress
-    @co.record_location @xref_data
-    refute @co.suppressed?
-  end
-  def test_section
-    parent = RDoc::Context.new
-    section = parent.sections.first
-    @co.parent = parent
-    @co.instance_variable_set :@section, section
-    assert_equal section, @co.section
-    @co.instance_variable_set :@section, nil
-    @co.instance_variable_set :@section_title, nil
-    assert_equal section, @co.section
-    @co.instance_variable_set :@section, nil
-    @co.instance_variable_set :@section_title, 'new title'
-    assert_equal 'new title', @co.section.title
-  end
-  def test_start_doc
-    @co.document_self = false
-    @co.document_children = false
-    @co.start_doc
-    assert @co.document_self
-    assert @co.document_children
-  end
-  def test_start_doc_ignored
-    @co.ignore
-    @co.start_doc
-    assert @co.document_self
-    assert @co.document_children
-    refute @co.ignored?
-  end
-  def test_start_doc_suppressed
-    @co.suppress
-    @co.start_doc
-    assert @co.document_self
-    assert @co.document_children
-    refute @co.suppressed?
-  end
-  def test_store_equals
-    @co.document_self = false
-    @co.store = @store
-    refute @co.document_self
-    @store.rdoc.options.visibility = :nodoc
-    @co.store = @store
-    assert @co.document_self
-  end
-  def test_stop_doc
-    @co.document_self = true
-    @co.document_children = true
-    @co.stop_doc
-    refute @co.document_self
-    refute @co.document_children
-    @store.rdoc.options.visibility = :nodoc
-    @co.store = @store
-    assert @co.document_self
-    assert @co.document_children
-    @co.stop_doc
-    assert @co.document_self
-    assert @co.document_children
-  end
-  def test_suppress
-    @co.suppress
-    refute @co.document_self
-    refute @co.document_children
-    assert @co.suppressed?
-    @store.rdoc.options.visibility = :nodoc
-    @co.store = @store
-    refute @co.suppressed?
-    @co.suppress
-    refute @co.suppressed?
-  end
-  def test_suppress_eh
-    refute @co.suppressed?
-    @co.suppress
-    assert @co.suppressed?
-  end
-end

data/test/test_rdoc_comment.rb DELETED

@@ -1,504 +0,0 @@
-# coding: us-ascii
-require 'rdoc/test_case'
-class TestRDocComment < RDoc::TestCase
-  def setup
-    super
-    @top_level = @store.add_file 'file.rb'
-    @comment = RDoc::Comment.new
-    @comment.location = @top_level
-    @comment.text = 'this is a comment'
-  end
-  def test_empty_eh
-    refute_empty @comment
-    @comment = ''
-    assert_empty @comment
-  end
-  def test_equals2
-    assert_equal @comment, @comment.dup
-    c2 = @comment.dup
-    c2.text = nil
-    refute_equal @comment, c2
-    c3 = @comment.dup
-    c3.location = nil
-    refute_equal @comment, c3
-  end
-  def test_extract_call_seq
-    m = RDoc::AnyMethod.new nil, 'm'
-    comment = RDoc::Comment.new <<-COMMENT, @top_level
-call-seq:
-  bla => true or false
-moar comment
-    COMMENT
-    comment.extract_call_seq m
-    assert_equal "bla => true or false\n", m.call_seq
-  end
-  def test_extract_call_seq_blank
-    m = RDoc::AnyMethod.new nil, 'm'
-    comment = RDoc::Comment.new <<-COMMENT, @top_level
-call-seq:
-  bla => true or false
-    COMMENT
-    comment.extract_call_seq m
-    assert_equal "bla => true or false\n", m.call_seq
-  end
-  def test_extract_call_seq_commented
-    m = RDoc::AnyMethod.new nil, 'm'
-    comment = RDoc::Comment.new <<-COMMENT, @top_level
-# call-seq:
-#   bla => true or false
-#
-# moar comment
-    COMMENT
-    comment.extract_call_seq m
-    assert_equal nil, m.call_seq
-  end
-  def test_extract_call_seq_no_blank
-    m = RDoc::AnyMethod.new nil, 'm'
-    comment = RDoc::Comment.new <<-COMMENT, @top_level
-call-seq:
-  bla => true or false
-    COMMENT
-    comment.extract_call_seq m
-    assert_equal "bla => true or false\n", m.call_seq
-  end
-  def test_extract_call_seq_undent
-    m = RDoc::AnyMethod.new nil, 'm'
-    comment = RDoc::Comment.new <<-COMMENT, @top_level
-call-seq:
-  bla => true or false
-moar comment
-    COMMENT
-    comment.extract_call_seq m
-    assert_equal "bla => true or false\nmoar comment\n", m.call_seq
-  end
-  def test_extract_call_seq_c
-    comment = RDoc::Comment.new <<-COMMENT
-call-seq:
-  commercial() -> Date <br />
-  commercial(cwyear, cweek=41, cwday=5, sg=nil) -> Date [ruby 1.8] <br />
-  commercial(cwyear, cweek=1, cwday=1, sg=nil) -> Date [ruby 1.9]
-If no arguments are given:
-* ruby 1.8: returns a +Date+ for 1582-10-15 (the Day of Calendar Reform in
-  Italy)
-* ruby 1.9: returns a +Date+ for julian day 0
-Otherwise, returns a +Date+ for the commercial week year, commercial week,
-and commercial week day given. Ignores the 4th argument.
-    COMMENT
-    method_obj = RDoc::AnyMethod.new nil, 'blah'
-    comment.extract_call_seq method_obj
-    expected = <<-CALL_SEQ.chomp
-commercial() -> Date <br />
-commercial(cwyear, cweek=41, cwday=5, sg=nil) -> Date [ruby 1.8] <br />
-commercial(cwyear, cweek=1, cwday=1, sg=nil) -> Date [ruby 1.9]
-    CALL_SEQ
-    assert_equal expected, method_obj.call_seq
-  end
-  def test_extract_call_seq_c_no_blank
-    comment = RDoc::Comment.new <<-COMMENT
-call-seq:
-  commercial() -> Date <br />
-  commercial(cwyear, cweek=41, cwday=5, sg=nil) -> Date [ruby 1.8] <br />
-  commercial(cwyear, cweek=1, cwday=1, sg=nil) -> Date [ruby 1.9]
-    COMMENT
-    method_obj = RDoc::AnyMethod.new nil, 'blah'
-    comment.extract_call_seq method_obj
-    expected = <<-CALL_SEQ.chomp
-commercial() -> Date <br />
-commercial(cwyear, cweek=41, cwday=5, sg=nil) -> Date [ruby 1.8] <br />
-commercial(cwyear, cweek=1, cwday=1, sg=nil) -> Date [ruby 1.9]
-    CALL_SEQ
-    assert_equal expected, method_obj.call_seq
-  end
-  def test_extract_call_seq_c_separator
-    comment = RDoc::Comment.new <<-'COMMENT'
-call-seq:
-   ARGF.readlines(sep=$/)     -> array
-   ARGF.readlines(limit)      -> array
-   ARGF.readlines(sep, limit) -> array
-   ARGF.to_a(sep=$/)     -> array
-   ARGF.to_a(limit)      -> array
-   ARGF.to_a(sep, limit) -> array
-Reads +ARGF+'s current file in its entirety, returning an +Array+ of its
-lines, one line per element. Lines are assumed to be separated by _sep_.
-   lines = ARGF.readlines
-   lines[0]                #=> "This is line one\n"
-    COMMENT
-    method_obj = RDoc::AnyMethod.new nil, 'blah'
-    comment.extract_call_seq method_obj
-    expected = <<-CALL_SEQ
-ARGF.readlines(sep=$/)     -> array
-ARGF.readlines(limit)      -> array
-ARGF.readlines(sep, limit) -> array
-ARGF.to_a(sep=$/)     -> array
-ARGF.to_a(limit)      -> array
-ARGF.to_a(sep, limit) -> array
-    CALL_SEQ
-    assert_equal expected, method_obj.call_seq
-    expected = <<-'COMMENT'
-Reads +ARGF+'s current file in its entirety, returning an +Array+ of its
-lines, one line per element. Lines are assumed to be separated by _sep_.
-   lines = ARGF.readlines
-   lines[0]                #=> "This is line one\n"
-    COMMENT
-    assert_equal expected, comment.text
-  end
-  def test_force_encoding
-    skip "Encoding not implemented" unless Object.const_defined? :Encoding
-    @comment.force_encoding Encoding::UTF_8
-    assert_equal Encoding::UTF_8, @comment.text.encoding
-  end
-  def test_format
-    assert_equal 'rdoc', @comment.format
-  end
-  def test_format_equals
-    c = comment 'content'
-    document = c.parse
-    c.format = RDoc::RD
-    assert_equal RDoc::RD, c.format
-    refute_same document, c.parse
-  end
-  def test_initialize_copy
-    copy = @comment.dup
-    refute_same @comment.text, copy.text
-    assert_same @comment.location, copy.location
-  end
-  def test_location
-    assert_equal @top_level, @comment.location
-  end
-  def test_normalize
-    @comment.text = <<-TEXT
-  # comment
-    TEXT
-    assert_same @comment, @comment.normalize
-    assert_equal 'comment', @comment.text
-  end
-  def test_normalize_twice
-    @comment.text = <<-TEXT
-  # comment
-    TEXT
-    @comment.normalize
-    text = @comment.text
-    @comment.normalize
-    assert_same text, @comment.text, 'normalize not cached'
-  end
-  def test_normalize_document
-    @comment.text = nil
-    @comment.document = @RM::Document.new
-    assert_same @comment, @comment.normalize
-    assert_nil @comment.text
-  end
-  def test_normalize_eh
-    refute @comment.normalized?
-    @comment.normalize
-    assert @comment.normalized?
-  end
-  def test_text
-    assert_equal 'this is a comment', @comment.text
-  end
-  def test_text_equals
-    @comment.text = 'other'
-    assert_equal 'other', @comment.text
-    refute @comment.normalized?
-  end
-  def test_text_equals_no_text
-    c = RDoc::Comment.new nil, @top_level
-    c.document = @RM::Document.new
-    e = assert_raises RDoc::Error do
-      c.text = 'other'
-    end
-    assert_equal 'replacing document-only comment is not allowed', e.message
-  end
-  def test_text_equals_parsed
-    document = @comment.parse
-    @comment.text = 'other'
-    refute_equal document, @comment.parse
-  end
-  def test_tomdoc_eh
-    refute @comment.tomdoc?
-    @comment.format = 'tomdoc'
-    assert @comment.tomdoc?
-  end
-  def test_parse
-    parsed = @comment.parse
-    expected = @RM::Document.new(
-      @RM::Paragraph.new('this is a comment'))
-    expected.file = @top_level
-    assert_equal expected, parsed
-    assert_same  parsed, @comment.parse
-  end
-  def test_parse_rd
-    c = comment 'it ((*works*))'
-    c.format = 'rd'
-    expected =
-      @RM::Document.new(
-        @RM::Paragraph.new('it <em>works</em>'))
-    expected.file = @top_level
-    assert_equal expected, c.parse
-  end
-  def test_remove_private_encoding
-    skip "Encoding not implemented" unless Object.const_defined? :Encoding
-    comment = RDoc::Comment.new <<-EOS, @top_level
-# This is text
-#--
-# this is private
-    EOS
-    comment.force_encoding Encoding::IBM437
-    comment.remove_private
-    assert_equal Encoding::IBM437, comment.text.encoding
-  end
-  def test_remove_private_hash
-    @comment.text = <<-TEXT
-#--
-# private
-#++
-# public
-    TEXT
-    @comment.remove_private
-    assert_equal "# public\n", @comment.text
-  end
-  def test_remove_private_hash_trail
-    comment = RDoc::Comment.new <<-EOS, @top_level
-# This is text
-#--
-# this is private
-    EOS
-    expected = RDoc::Comment.new <<-EOS, @top_level
-# This is text
-    EOS
-    comment.remove_private
-    assert_equal expected, comment
-  end
-  def test_remove_private_long
-    comment = RDoc::Comment.new <<-EOS, @top_level
-#-----
-#++
-# this is text
-#-----
-    EOS
-    expected = RDoc::Comment.new <<-EOS, @top_level
-# this is text
-    EOS
-    comment.remove_private
-    assert_equal expected, comment
-  end
-  def test_remove_private_rule
-    comment = RDoc::Comment.new <<-EOS, @top_level
-# This is text with a rule:
-# ---
-# this is also text
-    EOS
-    expected = comment.dup
-    comment.remove_private
-    assert_equal expected, comment
-  end
-  def test_remove_private_star
-    @comment.text = <<-TEXT
-/*
- *--
- * private
- *++
- * public
- */
-    TEXT
-    @comment.remove_private
-    assert_equal "/*\n * public\n */\n", @comment.text
-  end
-  def test_remove_private_star2
-    @comment.text = <<-TEXT
-/*--
- * private
- *++
- * public
- */
-    TEXT
-    @comment.remove_private
-    assert_equal "/*--\n * private\n *++\n * public\n */\n", @comment.text
-  end
-  def test_remove_private_toggle
-    comment = RDoc::Comment.new <<-EOS, @top_level
-# This is text
-#--
-# this is private
-#++
-# This is text again.
-    EOS
-    expected = RDoc::Comment.new <<-EOS, @top_level
-# This is text
-# This is text again.
-    EOS
-    comment.remove_private
-    assert_equal expected, comment
-  end
-  def test_remove_private_toggle_encoding
-    skip "Encoding not implemented" unless Object.const_defined? :Encoding
-    comment = RDoc::Comment.new <<-EOS, @top_level
-# This is text
-#--
-# this is private
-#++
-# This is text again.
-    EOS
-    comment.force_encoding Encoding::IBM437
-    comment.remove_private
-    assert_equal Encoding::IBM437, comment.text.encoding
-  end
-  def test_remove_private_toggle_encoding_ruby_bug?
-    skip "Encoding not implemented" unless Object.const_defined? :Encoding
-    comment = RDoc::Comment.new <<-EOS, @top_level
-#--
-# this is private
-#++
-# This is text again.
-    EOS
-    comment.force_encoding Encoding::IBM437
-    comment.remove_private
-    assert_equal Encoding::IBM437, comment.text.encoding
-  end
-end