RDoc::Generator::

RI

class

Generates ri data files

Constants

DESCRIPTION

Description of this generator

Public Class Methods

new(options)

Set up a new ri generator

# File lib/rdoc/generator/ri.rb, line 16
def initialize options #:not-new:
  @options     = options
  @old_siginfo = nil
  @current     = nil

  @store          = RDoc::RI::Store.new '.'
  @store.dry_run  = @options.dry_run
  @store.encoding = @options.encoding if @options.respond_to? :encoding
end

Public Instance Methods

generate(top_levels)

Build the initial indices and output objects based on an array of TopLevel objects containing the extracted information.

# File lib/rdoc/generator/ri.rb, line 30
def generate top_levels
  install_siginfo_handler

  @store.load_cache

  RDoc::TopLevel.all_classes_and_modules.each do |klass|
    @current = "#{klass.class}: #{klass.full_name}"

    @store.save_class klass

    klass.each_method do |method|
      @current = "#{method.class}: #{method.full_name}"
      @store.save_method klass, method
    end

    klass.each_attribute do |attribute|
      @store.save_method klass, attribute
    end
  end

  @current = 'saving cache'

  @store.save_cache

ensure
  @current = nil

  remove_siginfo_handler
end
install_siginfo_handler()

Installs a siginfo handler that prints the current filename.

# File lib/rdoc/generator/ri.rb, line 63
def install_siginfo_handler
  return unless Signal.list.key? 'INFO'

  @old_siginfo = trap 'INFO' do
    puts @current if @current
  end
end
remove_siginfo_handler()

Removes a siginfo handler and replaces the previous

# File lib/rdoc/generator/ri.rb, line 74
def remove_siginfo_handler
  return unless Signal.list.key? 'INFO'

  handler = @old_siginfo || 'DEFAULT'

  trap 'INFO', handler
end