ruby/lib/irb/cmd/show_doc.rb
Stan Lo b695f58d52 [ruby/irb] Print deprecation warning for help command
(https://github.com/ruby/irb/pull/567)

* Give show_doc its own command class

* Print deprecation warning for `help` command
2023-05-18 03:28:31 +00:00

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