ric 0.12.0 → 0.12.2

data/vendor/bundle/ruby/2.5.0/gems/rdoc-6.1.1/lib/rdoc/parser/ruby_tools.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+##
+# Collection of methods for writing parsers
+
+module RDoc::Parser::RubyTools
+
+  ##
+  # Adds a token listener +obj+, but you should probably use token_listener
+
+  def add_token_listener(obj)
+    @token_listeners ||= []
+    @token_listeners << obj
+  end
+
+  ##
+  # Fetches the next token from the scanner
+
+  def get_tk
+    tk = nil
+
+    if @tokens.empty? then
+      if @scanner_point >= @scanner.size
+        return nil
+      else
+        tk = @scanner[@scanner_point]
+        @scanner_point += 1
+        @read.push tk[:text]
+      end
+    else
+      @read.push @unget_read.shift
+      tk = @tokens.shift
+    end
+
+    if tk == nil || :on___end__ == tk[:kind]
+      tk = nil
+    end
+
+    return nil unless tk
+
+    # inform any listeners of our shiny new token
+    @token_listeners.each do |obj|
+      obj.add_token(tk)
+    end if @token_listeners
+
+    tk
+  end
+
+  ##
+  # Reads and returns all tokens up to one of +tokens+.  Leaves the matched
+  # token in the token list.
+
+  def get_tk_until(*tokens)
+    read = []
+
+    loop do
+      tk = get_tk
+
+      case tk
+      when *tokens then
+        unget_tk tk
+        break
+      end
+
+      read << tk
+    end
+
+    read
+  end
+
+  ##
+  # Retrieves a String representation of the read tokens
+
+  def get_tkread
+    read = @read.join("")
+    @read = []
+    read
+  end
+
+  ##
+  # Peek equivalent for get_tkread
+
+  def peek_read
+    @read.join('')
+  end
+
+  ##
+  # Peek at the next token, but don't remove it from the stream
+
+  def peek_tk
+    unget_tk(tk = get_tk)
+    tk
+  end
+
+  ##
+  # Removes the token listener +obj+
+
+  def remove_token_listener(obj)
+    @token_listeners.delete(obj)
+  end
+
+  ##
+  # Resets the tools
+
+  def reset
+    @read       = []
+    @tokens     = []
+    @unget_read = []
+    @nest = 0
+    @scanner_point = 0
+  end
+
+  ##
+  # Skips whitespace tokens including newlines
+
+  def skip_tkspace
+    tokens = []
+
+    while (tk = get_tk) and (:on_sp == tk[:kind] or :on_nl == tk[:kind] or :on_ignored_nl == tk[:kind]) do
+      tokens.push(tk)
+    end
+
+    unget_tk(tk)
+    tokens
+  end
+
+  ##
+  # Skips whitespace tokens excluding newlines
+
+  def skip_tkspace_without_nl
+    tokens = []
+
+    while (tk = get_tk) and :on_sp == tk[:kind] do
+      tokens.push(tk)
+    end
+
+    unget_tk(tk)
+    tokens
+  end
+
+  ##
+  # Has +obj+ listen to tokens
+
+  def token_listener(obj)
+    add_token_listener obj
+    yield
+  ensure
+    remove_token_listener obj
+  end
+
+  ##
+  # Returns +tk+ to the scanner
+
+  def unget_tk(tk)
+    @tokens.unshift tk
+    @unget_read.unshift @read.pop
+
+    # Remove this token from any listeners
+    @token_listeners.each do |obj|
+      obj.pop_token
+    end if @token_listeners
+
+    nil
+  end
+
+end
+
+

data/vendor/bundle/ruby/2.5.0/gems/rdoc-6.1.1/lib/rdoc/parser/simple.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+##
+# Parse a non-source file. We basically take the whole thing as one big
+# comment.
+
+class RDoc::Parser::Simple < RDoc::Parser
+
+  include RDoc::Parser::Text
+
+  parse_files_matching(//)
+
+  attr_reader :content # :nodoc:
+
+  ##
+  # Prepare to parse a plain file
+
+  def initialize(top_level, file_name, content, options, stats)
+    super
+
+    preprocess = RDoc::Markup::PreProcess.new @file_name, @options.rdoc_include
+
+    @content = preprocess.handle @content, @top_level
+  end
+
+  ##
+  # Extract the file contents and attach them to the TopLevel as a comment
+
+  def scan
+    comment = remove_coding_comment @content
+    comment = remove_private_comment comment
+
+    comment = RDoc::Comment.new comment, @top_level
+
+    @top_level.comment = comment
+    @top_level
+  end
+
+  ##
+  # Removes the encoding magic comment from +text+
+
+  def remove_coding_comment text
+    text.sub(/\A# .*coding[=:].*$/, '')
+  end
+
+  ##
+  # Removes private comments.
+  #
+  # Unlike RDoc::Comment#remove_private this implementation only looks for two
+  # dashes at the beginning of the line.  Three or more dashes are considered
+  # to be a rule and ignored.
+
+  def remove_private_comment comment
+    # Workaround for gsub encoding for Ruby 1.9.2 and earlier
+    empty = ''
+    empty = RDoc::Encoding.change_encoding empty, comment.encoding
+
+    comment = comment.gsub(%r%^--\n.*?^\+\+\n?%m, empty)
+    comment.sub(%r%^--\n.*%m, empty)
+  end
+
+end

data/vendor/bundle/ruby/2.5.0/gems/rdoc-6.1.1/lib/rdoc/parser/text.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+##
+# Indicates this parser is text and doesn't contain code constructs.
+#
+# Include this module in a RDoc::Parser subclass to make it show up as a file,
+# not as part of a class or module.
+#--
+# This is not named File to avoid overriding ::File
+
+module RDoc::Parser::Text
+end
+

data/vendor/bundle/ruby/2.5.0/gems/rdoc-6.1.1/lib/rdoc/rd.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+##
+# RDoc::RD implements the RD format from the rdtool gem.
+#
+# To choose RD as your only default format see
+# RDoc::Options@Saved+Options for instructions on setting up a
+# <code>.doc_options</code> file to store your project default.
+#
+# == LICENSE
+#
+# The grammar that produces RDoc::RD::BlockParser and RDoc::RD::InlineParser
+# is included in RDoc under the Ruby License.
+#
+# You can find the original source for rdtool at
+# https://github.com/uwabami/rdtool/
+#
+# You can use, re-distribute or change these files under Ruby's License or GPL.
+#
+# 1. You may make and give away verbatim copies of the source form of the
+#    software without restriction, provided that you duplicate all of the
+#    original copyright notices and associated disclaimers.
+#
+# 2. You may modify your copy of the software in any way, provided that
+#    you do at least ONE of the following:
+#
+#    a. place your modifications in the Public Domain or otherwise
+#       make them Freely Available, such as by posting said
+#       modifications to Usenet or an equivalent medium, or by allowing
+#       the author to include your modifications in the software.
+#
+#    b. use the modified software only within your corporation or
+#       organization.
+#
+#    c. give non-standard binaries non-standard names, with
+#       instructions on where to get the original software distribution.
+#
+#    d. make other distribution arrangements with the author.
+#
+# 3. You may distribute the software in object code or binary form,
+#    provided that you do at least ONE of the following:
+#
+#    a. distribute the binaries and library files of the software,
+#       together with instructions (in the manual page or equivalent)
+#       on where to get the original distribution.
+#
+#    b. accompany the distribution with the machine-readable source of
+#       the software.
+#
+#    c. give non-standard binaries non-standard names, with
+#       instructions on where to get the original software distribution.
+#
+#    d. make other distribution arrangements with the author.
+#
+# 4. You may modify and include the part of the software into any other
+#    software (possibly commercial).  But some files in the distribution
+#    are not written by the author, so that they are not under these terms.
+#
+#    For the list of those files and their copying conditions, see the
+#    file LEGAL.
+#
+# 5. The scripts and library files supplied as input to or produced as
+#    output from the software do not automatically fall under the
+#    copyright of the software, but belong to whomever generated them,
+#    and may be sold commercially, and may be aggregated with this
+#    software.
+#
+# 6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+#    IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+#    WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+#    PURPOSE.
+
+class RDoc::RD
+
+  ##
+  # Parses +rd+ source and returns an RDoc::Markup::Document.  If the
+  # <tt>=begin</tt> or <tt>=end</tt> lines are missing they will be added.
+
+  def self.parse rd
+    rd = rd.lines.to_a
+
+    if rd.find { |i| /\S/ === i } and !rd.find{|i| /^=begin\b/ === i } then
+      rd.unshift("=begin\n").push("=end\n")
+    end
+
+    parser = RDoc::RD::BlockParser.new
+    document = parser.parse rd
+
+    # isn't this always true?
+    document.parts.shift if RDoc::Markup::BlankLine === document.parts.first
+    document.parts.pop   if RDoc::Markup::BlankLine === document.parts.last
+
+    document
+  end
+
+  autoload :BlockParser,  'rdoc/rd/block_parser'
+  autoload :InlineParser, 'rdoc/rd/inline_parser'
+  autoload :Inline,       'rdoc/rd/inline'
+
+end
+

data/vendor/bundle/ruby/2.5.0/gems/rdoc-6.1.1/lib/rdoc/rd/block_parser.ry

@@ -0,0 +1,639 @@
+class BlockParser
+
+  preclow
+    nonassoc DUMMY
+    left     ITEMLISTLINE
+             ENUMLISTLINE
+             DESCLISTLINE
+             METHODLISTLINE
+             STRINGLINE
+  prechigh
+
+  token STRINGLINE
+        ITEMLISTLINE
+        ENUMLISTLINE
+        DESCLISTLINE
+        METHODLISTLINE
+        WHITELINE
+        SUBTREE
+        HEADLINE
+        INCLUDE
+        INDENT
+        DEDENT
+        DUMMY
+
+  rule
+    document : blocks { result = RDoc::Markup::Document.new(*val[0]) }
+             |        { raise ParseError, "file empty" }
+             ;
+
+    blocks : blocks block { result = val[0].concat val[1] }
+           | block        { result = val[0] }
+           ;
+
+    block : textblock { result = val }
+          | verbatim  { result = val }
+          | lists
+          | headline  { result = val }
+          | include   { result = val }
+          | WHITELINE { result = [RDoc::Markup::BlankLine.new] }
+          | SUBTREE   { result = val[0].parts }
+          ;
+
+    headline : HEADLINE {
+      # val[0] is like [level, title]
+      title = @inline_parser.parse(val[0][1])
+      result = RDoc::Markup::Heading.new(val[0][0], title)
+    }
+    ;
+
+    include : INCLUDE {
+      result = RDoc::Markup::Include.new val[0], @include_path
+    }
+    ;
+
+    textblock : textblockcontent = DUMMY {
+      # val[0] is Array of String
+      result = paragraph val[0]
+    }
+    ;
+
+    textblockcontent : textblockcontent STRINGLINE { result << val[1].rstrip }
+                     | STRINGLINE { result = [val[0].rstrip] }
+                     ;
+
+    verbatim : INDENT verbatimcontent DEDENT {
+      # val[1] is Array of String
+      content = cut_off val[1]
+      result = RDoc::Markup::Verbatim.new(*content)
+
+      # imform to lexer.
+      @in_verbatim = false
+    }
+    ;
+
+    verbatim_after_lists : verbatimcontent {
+      # val[0] is Array of String
+      content = cut_off val[0]
+      result = RDoc::Markup::Verbatim.new(*content)
+
+      # imform to lexer.
+      @in_verbatim = false
+    }
+    ;
+
+    verbatimcontent : verbatimcontent STRINGLINE {
+      result << val[1]
+    } | verbatimcontent INDENT verbatimcontent DEDENT {
+      result.concat val[2]
+    } | verbatimcontent WHITELINE {
+      result << "\n"
+    } | STRINGLINE {
+      result = val
+      # inform to lexer.
+      @in_verbatim = true
+    }
+    ;
+
+    list : itemlist
+         | enumlist
+         | desclist
+         | methodlist
+         ;
+
+    lists : lists2 = DUMMY {
+      result = val[0]
+    } | INDENT lists2 DEDENT {
+      result = val[1]
+    } | INDENT lists2 verbatim_after_lists DEDENT {
+      result = val[1].push(val[2])
+    }
+    ;
+
+    lists2 : lists2 list { result = val[0] << val[1] }
+           | list { result = [val[0]] }
+           ;
+
+    itemlist : itemlistitems  = DUMMY {
+      result = RDoc::Markup::List.new :BULLET, *val[0]
+    }
+    ;
+
+    itemlistitems : itemlistitems itemlistitem { result.push(val[1]) }
+                  | itemlistitem { result = val }
+                  ;
+
+    itemlistitem : first_textblock_in_itemlist other_blocks_in_list DEDENT {
+      result = RDoc::Markup::ListItem.new nil, val[0], *val[1]
+    }
+    ;
+
+    enumlist :  enumlistitems  = DUMMY {
+      result = RDoc::Markup::List.new :NUMBER, *val[0]
+    }
+    ;
+
+    enumlistitems : enumlistitems enumlistitem { result.push(val[1]) }
+                  | enumlistitem { result = val }
+                  ;
+
+    enumlistitem : first_textblock_in_enumlist other_blocks_in_list DEDENT {
+      result = RDoc::Markup::ListItem.new nil, val[0], *val[1]
+    }
+    ;
+
+    desclist : desclistitems  = DUMMY {
+      result = RDoc::Markup::List.new :NOTE, *val[0]
+    }
+    ;
+
+    desclistitems : desclistitems desclistitem { result.push(val[1]) }
+                  | desclistitem { result = val }
+                  ;
+
+    desclistitem : DESCLISTLINE description_part DEDENT {
+      term = @inline_parser.parse val[0].strip
+
+      result = RDoc::Markup::ListItem.new term, *val[1]
+    }
+    ;
+
+    methodlist : methodlistitems  = DUMMY {
+      result = RDoc::Markup::List.new :LABEL, *val[0]
+    }
+    ;
+
+    methodlistitems : methodlistitems methodlistitem { result.push(val[1]) }
+                    | methodlistitem { result = val }
+                    ;
+
+    methodlistitem : METHODLISTLINE description_part DEDENT {
+      result = RDoc::Markup::ListItem.new "<tt>#{val[0].strip}</tt>", *val[1]
+    }
+    ;
+
+    description_part : whitelines textblock blocks_in_list {
+      result = [val[1]].concat(val[2])
+    } | whitelines textblock {
+      result = [val[1]]
+    } | whitelines INDENT blocks_in_list DEDENT {
+      result = val[2]
+    } | whitelines {
+      result = []
+    }
+    ;
+
+    blocks_in_list : blocks_in_list block_in_list { result.concat val[1] }
+                   | block_in_list
+                   ;
+
+    block_in_list : textblock { result = val }
+                  | verbatim  { result = val }
+                  | lists
+                  | WHITELINE { result = [] }
+                  ;
+
+    whitelines  : whitelines2
+                |
+                ;
+
+    whitelines2 : WHITELINE whitelines2
+                | WHITELINE
+                ;
+
+    first_textblock_in_itemlist : ITEMLISTLINE textblockcontent {
+      result = paragraph [val[0]].concat(val[1])
+    } | ITEMLISTLINE {
+      result = paragraph [val[0]]
+    }
+    ;
+
+    first_textblock_in_enumlist : ENUMLISTLINE textblockcontent {
+      result = paragraph [val[0]].concat(val[1])
+    } | ENUMLISTLINE {
+      result = paragraph [val[0]]
+    }
+    ;
+
+    other_blocks_in_list : verbatim blocks_in_list {
+      result = [val[0]].concat(val[1])
+    } | lists blocks_in_list     { result.concat val[1] }
+      | WHITELINE blocks_in_list { result = val[1] }
+      | verbatim                 { result = val }
+      | lists
+      | WHITELINE                { result = [] }
+      |                          { result = [] }
+      ;
+end
+
+---- inner
+
+# :stopdoc:
+
+TMPFILE = ["rdtmp", $$, 0]
+
+MARK_TO_LEVEL = {
+  '='    => 1,
+  '=='   => 2,
+  '==='  => 3,
+  '====' => 4,
+  '+'    => 5,
+  '++'   => 6,
+}
+
+# :startdoc:
+
+##
+# Footnotes for this document
+
+attr_reader :footnotes
+
+##
+# Labels for items in this document
+
+attr_reader :labels
+
+##
+# Path to find included files in
+
+attr_accessor :include_path
+
+##
+# Creates a new RDoc::RD::BlockParser.  Use #parse to parse an rd-format
+# document.
+
+def initialize
+  @inline_parser = RDoc::RD::InlineParser.new self
+  @include_path = []
+
+  # for testing
+  @footnotes = []
+  @labels    = {}
+end
+
+##
+# Parses +src+ and returns an RDoc::Markup::Document.
+
+def parse src
+  @src = src
+  @src.push false
+
+  @footnotes = []
+  @labels    = {}
+
+  # @i: index(line no.) of src
+  @i = 0
+
+  # stack for current indentation
+  @indent_stack = []
+
+  # how indented.
+  @current_indent = @indent_stack.join("")
+
+  # RDoc::RD::BlockParser for tmp src
+  @subparser = nil
+
+  # which part is in now
+  @in_part = nil
+  @part_content = []
+
+  @in_verbatim = false
+
+  @yydebug = true
+
+  document = do_parse
+
+  unless @footnotes.empty? then
+    blankline = document.parts.pop
+
+    document.parts << RDoc::Markup::Rule.new(1)
+    document.parts.concat @footnotes
+
+    document.parts.push blankline
+  end
+
+  document
+end
+
+##
+# Returns the next token from the document
+
+def next_token # :nodoc:
+  # preprocessing
+  # if it is not in RD part
+  # => method
+  while @in_part != "rd"
+    line = @src[@i]
+    @i += 1 # next line
+
+    case line
+    # src end
+    when false
+      return [false, false]
+    # RD part begin
+    when /^=begin\s*(?:\bRD\b.*)?\s*$/
+      if @in_part # if in non-RD part
+        @part_content.push(line)
+      else
+        @in_part = "rd"
+        return [:WHITELINE, "=begin\n"] # <= for textblockand
+      end
+    # non-RD part begin
+    when /^=begin\s+(\w+)/
+      part = $1
+      if @in_part # if in non-RD part
+        @part_content.push(line)
+      else
+        @in_part = part if @tree.filter[part] # if filter exists
+#  p "BEGIN_PART: #{@in_part}" # DEBUG
+      end
+    # non-RD part end
+    when /^=end/
+      if @in_part # if in non-RD part
+#  p "END_PART: #{@in_part}" # DEBUG
+        # make Part-in object
+        part = RDoc::RD::Part.new(@part_content.join(""), @tree, "r")
+        @part_content.clear
+        # call filter, part_out is output(Part object)
+        part_out = @tree.filter[@in_part].call(part)
+
+        if @tree.filter[@in_part].mode == :rd # if output is RD formatted
+          subtree = parse_subtree(part_out.to_a)
+        else # if output is target formatted
+          basename = TMPFILE.join('.')
+          TMPFILE[-1] += 1
+          tmpfile = open(@tree.tmp_dir + "/" + basename + ".#{@in_part}", "w")
+          tmpfile.print(part_out)
+          tmpfile.close
+          subtree = parse_subtree(["=begin\n", "<<< #{basename}\n", "=end\n"])
+        end
+        @in_part = nil
+        return [:SUBTREE, subtree]
+      end
+    else
+      if @in_part # if in non-RD part
+        @part_content.push(line)
+      end
+    end
+  end
+
+  @current_indent = @indent_stack.join("")
+  line = @src[@i]
+  case line
+  when false
+    if_current_indent_equal("") do
+      [false, false]
+    end
+  when /^=end/
+    if_current_indent_equal("") do
+      @in_part = nil
+      [:WHITELINE, "=end"] # MUST CHANGE??
+    end
+  when /^\s*$/
+    @i += 1 # next line
+    return [:WHITELINE, ':WHITELINE']
+  when /^\#/  # comment line
+    @i += 1 # next line
+    self.next_token()
+  when /^(={1,4})(?!=)\s*(?=\S)/, /^(\+{1,2})(?!\+)\s*(?=\S)/
+    rest = $'                    # '
+    rest.strip!
+    mark = $1
+    if_current_indent_equal("") do
+      return [:HEADLINE, [MARK_TO_LEVEL[mark], rest]]
+    end
+  when /^<<<\s*(\S+)/
+    file = $1
+    if_current_indent_equal("") do
+      suffix = file[-3 .. -1]
+      if suffix == ".rd" or suffix == ".rb"
+        subtree = parse_subtree(get_included(file))
+        [:SUBTREE, subtree]
+      else
+        [:INCLUDE, file]
+      end
+    end
+  when /^(\s*)\*(\s*)/
+    rest = $'                   # '
+    newIndent = $2
+    if_current_indent_equal($1) do
+      if @in_verbatim
+        [:STRINGLINE, line]
+      else
+        @indent_stack.push("\s" + newIndent)
+        [:ITEMLISTLINE, rest]
+      end
+    end
+  when /^(\s*)(\(\d+\))(\s*)/
+    rest = $'                     # '
+    mark = $2
+    newIndent = $3
+    if_current_indent_equal($1) do
+      if @in_verbatim
+        [:STRINGLINE, line]
+      else
+        @indent_stack.push("\s" * mark.size + newIndent)
+        [:ENUMLISTLINE, rest]
+      end
+    end
+  when /^(\s*):(\s*)/
+    rest = $'                    # '
+    newIndent = $2
+    if_current_indent_equal($1) do
+      if @in_verbatim
+        [:STRINGLINE, line]
+      else
+        @indent_stack.push("\s#{$2}")
+        [:DESCLISTLINE, rest]
+      end
+    end
+  when /^(\s*)---(?!-|\s*$)/
+    indent = $1
+    rest = $'
+    /\s*/ === rest
+    term = $'
+    new_indent = $&
+    if_current_indent_equal(indent) do
+      if @in_verbatim
+        [:STRINGLINE, line]
+      else
+        @indent_stack.push("\s\s\s" + new_indent)
+        [:METHODLISTLINE, term]
+      end
+    end
+  when /^(\s*)/
+    if_current_indent_equal($1) do
+      [:STRINGLINE, line]
+    end
+  else
+    raise "[BUG] parsing error may occurred."
+  end
+end
+
+##
+# Yields to the given block if +indent+ matches the current indent, otherwise
+# an indentation token is processed.
+
+def if_current_indent_equal(indent)
+  indent = indent.sub(/\t/, "\s" * 8)
+  if @current_indent == indent
+    @i += 1 # next line
+    yield
+  elsif indent.index(@current_indent) == 0
+    @indent_stack.push(indent[@current_indent.size .. -1])
+    [:INDENT, ":INDENT"]
+  else
+    @indent_stack.pop
+    [:DEDENT, ":DEDENT"]
+  end
+end
+private :if_current_indent_equal
+
+##
+# Cuts off excess whitespace in +src+
+
+def cut_off(src)
+  ret = []
+  whiteline_buf = []
+
+  line = src.shift
+  /^\s*/ =~ line
+
+  indent = Regexp.quote($&)
+  ret.push($')
+
+  while line = src.shift
+    if /^(\s*)$/ =~ line
+      whiteline_buf.push(line)
+    elsif /^#{indent}/ =~ line
+      unless whiteline_buf.empty?
+        ret.concat(whiteline_buf)
+        whiteline_buf.clear
+      end
+      ret.push($')
+    else
+      raise "[BUG]: probably Parser Error while cutting off.\n"
+    end
+  end
+  ret
+end
+private :cut_off
+
+def set_term_to_element(parent, term)
+#  parent.set_term_under_document_struct(term, @tree.document_struct)
+  parent.set_term_without_document_struct(term)
+end
+private :set_term_to_element
+
+##
+# Raises a ParseError when invalid formatting is found
+
+def on_error(et, ev, _values)
+  prv, cur, nxt = format_line_num(@i, @i+1, @i+2)
+
+  raise ParseError, <<Msg
+
+RD syntax error: line #{@i+1}:
+  #{prv}  |#{@src[@i-1].chomp}
+  #{cur}=>|#{@src[@i].chomp}
+  #{nxt}  |#{@src[@i+1].chomp}
+
+Msg
+end
+
+##
+# Current line number
+
+def line_index
+  @i
+end
+
+##
+# Parses subtree +src+
+
+def parse_subtree src
+  @subparser ||= RDoc::RD::BlockParser.new
+
+  @subparser.parse src
+end
+private :parse_subtree
+
+##
+# Retrieves the content for +file+ from the include_path
+
+def get_included(file)
+  included = []
+
+  @include_path.each do |dir|
+    file_name = File.join dir, file
+
+    if File.exist? file_name then
+      included = IO.readlines file_name
+      break
+    end
+  end
+
+  included
+end
+private :get_included
+
+##
+# Formats line numbers +line_numbers+ prettily
+
+def format_line_num(*line_numbers)
+  width = line_numbers.collect{|i| i.to_s.length }.max
+  line_numbers.collect{|i| sprintf("%#{width}d", i) }
+end
+private :format_line_num
+
+##
+# Retrieves the content of +values+ as a single String
+
+def content values
+ values.map { |value| value.content }.join
+end
+
+##
+# Creates a paragraph for +value+
+
+def paragraph value
+  content = cut_off(value).join(' ').rstrip
+  contents = @inline_parser.parse content
+
+  RDoc::Markup::Paragraph.new(*contents)
+end
+
+##
+# Adds footnote +content+ to the document
+
+def add_footnote content
+  index = @footnotes.length / 2 + 1
+
+  footmark_link = "{^#{index}}[rdoc-label:footmark-#{index}:foottext-#{index}]"
+
+  @footnotes << RDoc::Markup::Paragraph.new(footmark_link, ' ', *content)
+  @footnotes << RDoc::Markup::BlankLine.new
+
+  index
+end
+
+##
+# Adds label +label+ to the document
+
+def add_label label
+  @labels[label] = true
+
+  label
+end
+
+# :stopdoc:
+
+---- header
+class RDoc::RD
+
+##
+# RD format parser for headings, paragraphs, lists, verbatim sections that
+# exist as blocks.
+
+---- footer
+end