mirror of
https://github.com/ruby/ruby.git
synced 2025-08-24 13:34:17 +02:00

(https://github.com/ruby/irb/pull/567) * Give show_doc its own command class * Print deprecation warning for `help` command
48 lines
1.1 KiB
Ruby
48 lines
1.1 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
require_relative "nop"
|
|
|
|
module IRB
|
|
module ExtendCommand
|
|
class ShowDoc < Nop
|
|
class << self
|
|
def transform_args(args)
|
|
# Return a string literal as is for backward compatibility
|
|
if args.empty? || string_literal?(args)
|
|
args
|
|
else # Otherwise, consider the input as a String for convenience
|
|
args.strip.dump
|
|
end
|
|
end
|
|
end
|
|
|
|
category "Context"
|
|
description "Enter the mode to look up RI documents."
|
|
|
|
def execute(*names)
|
|
require 'rdoc/ri/driver'
|
|
|
|
unless ShowDoc.const_defined?(:Ri)
|
|
opts = RDoc::RI::Driver.process_args([])
|
|
ShowDoc.const_set(:Ri, RDoc::RI::Driver.new(opts))
|
|
end
|
|
|
|
if names.empty?
|
|
Ri.interactive
|
|
else
|
|
names.each do |name|
|
|
begin
|
|
Ri.display_name(name.to_s)
|
|
rescue RDoc::RI::Error
|
|
puts $!.message
|
|
end
|
|
end
|
|
end
|
|
|
|
nil
|
|
rescue LoadError, SystemExit
|
|
warn "Can't display document because `rdoc` is not installed."
|
|
end
|
|
end
|
|
end
|
|
end
|