FM / rdoc

/opt/cpanel/ea-ruby27/root/usr/share/ruby/ruby-2.7.8/rdoc/

/opt/cpanel/ea-ruby27/root/usr/share/ruby/ruby-2.7.8/rdoc

Name	Size	Mode	Actions
context/	-	0755	rm
generator/	-	0755	rm
i18n/	-	0755	rm
markdown/	-	0755	rm
markup/	-	0755	rm
parser/	-	0755	rm
rd/	-	0755	rm
ri/	-	0755	rm
stats/	-	0755	rm
alias.rb	2173	0644	edit dl rm
anon_class.rb	172	0644	edit dl rm
any_method.rb	7206	0644	edit dl rm
attr.rb	3849	0644	edit dl rm
class_module.rb	20292	0644	edit dl rm
code_object.rb	9483	0644	edit dl rm
code_objects.rb	151	0644	edit dl rm
comment.rb	5874	0644	edit dl rm
constant.rb	3677	0644	edit dl rm
context.rb	30816	0644	edit dl rm
cross_reference.rb	6678	0644	edit dl rm
encoding.rb	3838	0644	edit dl rm
erbio.rb	934	0644	edit dl rm
erb_partial.rb	400	0644	edit dl rm
extend.rb	170	0644	edit dl rm
generator.rb	1837	0644	edit dl rm
ghost_method.rb	144	0644	edit dl rm
i18n.rb	170	0644	edit dl rm
include.rb	172	0644	edit dl rm
known_classes.rb	2685	0644	edit dl rm
markdown.rb	386117	0644	edit dl rm
markup.rb	28755	0644	edit dl rm
meta_method.rb	129	0644	edit dl rm
method_attr.rb	9251	0644	edit dl rm
mixin.rb	2818	0644	edit dl rm
normal_class.rb	2183	0644	edit dl rm
normal_module.rb	1467	0644	edit dl rm
options.rb	31601	0644	edit dl rm
parser.rb	7219	0644	edit dl rm
rd.rb	3653	0644	edit dl rm
rdoc.rb	13866	0644	edit dl rm
require.rb	965	0644	edit dl rm
ri.rb	345	0644	edit dl rm
rubygems_hook.rb	5265	0644	edit dl rm
servlet.rb	12401	0644	edit dl rm
single_class.rb	408	0644	edit dl rm
stats.rb	10729	0644	edit dl rm
store.rb	22976	0644	edit dl rm
task.rb	7856	0644	edit dl rm
text.rb	7577	0644	edit dl rm
token_stream.rb	3232	0644	edit dl rm
tom_doc.rb	6614	0644	edit dl rm
top_level.rb	5677	0644	edit dl rm
version.rb	77	0644	edit dl rm

Edit: /opt/cpanel/ea-ruby27/root/usr/share/ruby/ruby-2.7.8/rdoc/task.rb (7856B)

# frozen_string_literal: true
#--
# Copyright (c) 2003, 2004 Jim Weirich, 2009 Eric Hodel
#
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files (the
# "Software"), to deal in the Software without restriction, including
# without limitation the rights to use, copy, modify, merge, publish,
# distribute, sublicense, and/or sell copies of the Software, and to
# permit persons to whom the Software is furnished to do so, subject to
# the following conditions:
#
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
#++

begin
  gem 'rdoc'
rescue Gem::LoadError
end unless defined?(RDoc)

begin
  gem 'rake'
rescue Gem::LoadError
end unless defined?(Rake)

require 'rdoc'
require 'rake'
require 'rake/tasklib'

##
# RDoc::Task creates the following rake tasks to generate and clean up RDoc
# output:
#
# [rdoc]
#   Main task for this RDoc task.
#
# [clobber_rdoc]
#   Delete all the rdoc files.  This target is automatically added to the main
#   clobber target.
#
# [rerdoc]
#   Rebuild the rdoc files from scratch, even if they are not out of date.
#
# Simple Example:
#
#   require 'rdoc/task'
#
#   RDoc::Task.new do |rdoc|
#     rdoc.main = "README.rdoc"
#     rdoc.rdoc_files.include("README.rdoc", "lib/**/*.rb")
#   end
#
# The +rdoc+ object passed to the block is an RDoc::Task object. See the
# attributes list for the RDoc::Task class for available customization options.
#
# == Specifying different task names
#
# You may wish to give the task a different name, such as if you are
# generating two sets of documentation.  For instance, if you want to have a
# development set of documentation including private methods:
#
#   require 'rdoc/task'
#
#   RDoc::Task.new :rdoc_dev do |rdoc|
#     rdoc.main = "README.doc"
#     rdoc.rdoc_files.include("README.rdoc", "lib/**/*.rb")
#     rdoc.options << "--all"
#   end
#
# The tasks would then be named :<em>rdoc_dev</em>,
# :clobber_<em>rdoc_dev</em>, and :re<em>rdoc_dev</em>.
#
# If you wish to have completely different task names, then pass a Hash as
# first argument. With the <tt>:rdoc</tt>, <tt>:clobber_rdoc</tt> and
# <tt>:rerdoc</tt> options, you can customize the task names to your liking.
#
# For example:
#
#   require 'rdoc/task'
#
#   RDoc::Task.new(:rdoc => "rdoc", :clobber_rdoc => "rdoc:clean",
#                  :rerdoc => "rdoc:force")
#
# This will create the tasks <tt>:rdoc</tt>, <tt>:rdoc:clean</tt> and
# <tt>:rdoc:force</tt>.

class RDoc::Task < Rake::TaskLib

##
  # Name of the main, top level task.  (default is :rdoc)

attr_accessor :name

##
  # Comment markup format.  rdoc, rd and tomdoc are supported.  (default is
  # 'rdoc')

attr_accessor :markup

##
  # Name of directory to receive the html output files. (default is "html")

attr_accessor :rdoc_dir

##
  # Title of RDoc documentation. (defaults to rdoc's default)

attr_accessor :title

##
  # Name of file to be used as the main, top level file of the RDoc. (default
  # is none)

attr_accessor :main

##
  # Name of template to be used by rdoc. (defaults to rdoc's default)

attr_accessor :template

##
  # Name of format generator (<tt>--format</tt>) used by rdoc. (defaults to
  # rdoc's default)

attr_accessor :generator

##
  # List of files to be included in the rdoc generation. (default is [])

attr_accessor :rdoc_files

##
  # Additional list of options to be passed rdoc.  (default is [])

attr_accessor :options

##
  # Whether to run the rdoc process as an external shell (default is false)

attr_accessor :external

##
  # Create an RDoc task with the given name. See the RDoc::Task class overview
  # for documentation.

def initialize name = :rdoc # :yield: self
    defaults

check_names name

@name = name

yield self if block_given?

define
  end

##
  # Ensures that +names+ only includes names for the :rdoc, :clobber_rdoc and
  # :rerdoc.  If other names are given an ArgumentError is raised.

def check_names names
    return unless Hash === names

invalid_options =
      names.keys.map { |k| k.to_sym } - [:rdoc, :clobber_rdoc, :rerdoc]

unless invalid_options.empty? then
      raise ArgumentError, "invalid options: #{invalid_options.join ', '}"
    end
  end

##
  # Task description for the clobber rdoc task or its renamed equivalent

def clobber_task_description
    "Remove RDoc HTML files"
  end

##
  # Sets default task values

def defaults
    @name = :rdoc
    @rdoc_files = Rake::FileList.new
    @rdoc_dir = 'html'
    @main = nil
    @title = nil
    @template = nil
    @generator = nil
    @options = []
  end

##
  # All source is inline now.  This method is deprecated

def inline_source # :nodoc:
    warn "RDoc::Task#inline_source is deprecated"
    true
  end

##
  # All source is inline now.  This method is deprecated

def inline_source=(value) # :nodoc:
    warn "RDoc::Task#inline_source is deprecated"
  end

##
  # Create the tasks defined by this task lib.

def define
    desc rdoc_task_description
    task rdoc_task_name

desc rerdoc_task_description
    task rerdoc_task_name => [clobber_task_name, rdoc_task_name]

desc clobber_task_description
    task clobber_task_name do
      rm_r @rdoc_dir rescue nil
    end

task :clobber => [clobber_task_name]

directory @rdoc_dir

rdoc_target_deps = [
      @rdoc_files,
      Rake.application.rakefile
    ].flatten.compact

task rdoc_task_name => [rdoc_target]
    file rdoc_target => rdoc_target_deps do
      @before_running_rdoc.call if @before_running_rdoc
      args = option_list + @rdoc_files

$stderr.puts "rdoc #{args.join ' '}" if Rake.application.options.trace
      RDoc::RDoc.new.document args
    end

self
  end

##
  # List of options that will be supplied to RDoc

def option_list
    result = @options.dup
    result << "-o"       << @rdoc_dir
    result << "--main"   << main      if main
    result << "--markup" << markup    if markup
    result << "--title"  << title     if title
    result << "-T"       << template  if template
    result << '-f'       << generator if generator
    result
  end

##
  # The block passed to this method will be called just before running the
  # RDoc generator. It is allowed to modify RDoc::Task attributes inside the
  # block.

def before_running_rdoc(&block)
    @before_running_rdoc = block
  end

##
  # Task description for the rdoc task or its renamed equivalent

def rdoc_task_description
    'Build RDoc HTML files'
  end

##
  # Task description for the rerdoc task or its renamed description

def rerdoc_task_description
    "Rebuild RDoc HTML files"
  end

private

def rdoc_target
    "#{rdoc_dir}/created.rid"
  end

def rdoc_task_name
    case name
    when Hash then (name[:rdoc] || "rdoc").to_s
    else           name.to_s
    end
  end

def clobber_task_name
    case name
    when Hash then (name[:clobber_rdoc] || "clobber_rdoc").to_s
    else           "clobber_#{name}"
    end
  end

def rerdoc_task_name
    case name
    when Hash then (name[:rerdoc] || "rerdoc").to_s
    else           "re#{name}"
    end
  end

end

# :stopdoc:
module Rake

##
  # For backwards compatibility

RDocTask = RDoc::Task

end
# :startdoc:

cmd: