rbt 0.10.215 → 0.11.97

data/lib/rbt/compile/misc.rb

@@ -1,4636 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'rbt/compile/misc.rb'
-# =========================================================================== #
-require 'rbt/compile_base/compile_base.rb'
-
-module RBT
-
-class Compile < ::RBT::CompileBase # === RBT::Compile
-
-  require 'rbt/requires/require_the_cookbook_class.rb'
-  require 'rbt/aliases/aliases.rb'
-  require 'rbt/actions/actions.rb'
-  require 'rbt/compile/handle_this_program.rb'
-
-  # ========================================================================= #
-  # === copy_expanded_directory
-  #
-  # Invocation example:
-  #
-  #   rbt --copy-expanded-directory
-  #
-  # ========================================================================= #
-  def copy_expanded_directory
-    source_directory = project_yaml_dir?+'expanded_cookbooks/'
-    target_directory = expanded_cookbooks? # This will be e. g. '/home/Temp/rbt/expanded_cookbooks/'.
-    if File.directory? source_directory
-      opne 'Now copying from '+sdir(source_directory)
-      opne 'onto '+sdir(target_directory)+'.'
-      mkdir(target_directory) unless File.directory? target_directory
-      Dir[source_directory+'*.yml'].each {|this_yaml_file|
-        copy_file(this_yaml_file, target_directory) { :be_verbose }
-      }
-    else
-      opne 'No directory exists at `'+sdir(source_directory)+'`.'
-    end
-  end
-
-  # ========================================================================= #
-  # === download_the_remote_documentation_of_the_RBT_project
-  #
-  # This method will download the documentation of the RBT project
-  # for local use.
-  #
-  # Usage example:
-  #
-  #   rbt --download-docu
-  #
-  # ========================================================================= #
-  def download_the_remote_documentation_of_the_RBT_project
-    remote_URL = 'https://www.rubydoc.info/gems/rbt/'
-    opne 'Now downlading from the remote URL at '+steelblue(remote_URL)+'.'
-    dataset = URI.open(remote_URL).read
-    into = File.absolute_path('rbt_documentation.html')
-    write_what_into(dataset, into)
-    if File.exist? into
-      opne 'Storing into the local file at '+sfile(into)+'.'
-    end
-  end
-
-  # ========================================================================= #
-  # === do_these_logic_steps                                      (logic tag)
-  #
-  # This is a "meta"-method - it bundles different logic-steps together.
-  # ========================================================================= #
-  def do_these_logic_steps(*array)
-    flattened = array.flatten
-    flattened.each {|this_entry|
-      case this_entry
-      # ===================================================================== #
-      # === :consider_applying_a_patch
-      # ===================================================================== #
-      when :consider_applying_a_patch
-        consider_applying_a_patch
-      # ===================================================================== #
-      # === :consider_creating_the_appdir
-      # ===================================================================== #
-      when :consider_creating_the_appdir
-        consider_creating_the_appdir_skeleton
-      else # else assume a method-call as-is.
-        send(this_entry.to_sym)
-      end
-    }
-  end; alias do_this_logic_step do_these_logic_steps # === do_this_logic_step
-
-  # ========================================================================= #
-  # === use_a_random_extracted_directory
-  #
-  # Use a random name for the extracted directory. That way we can
-  # compile the same program concurrently, for whatever the reason
-  # (such as when you want to use different options for the
-  # compile-run as such).
-  #
-  # Usage example:
-  #
-  #   ry htop --random-extracted-dir
-  # 
-  # ========================================================================= #
-  def use_a_random_extracted_directory
-    # ======================================================================= #
-    # First build up the gibberish name.
-    # ======================================================================= #
-    gibberish_name = ''.dup
-    possibilities = ('A'..'Z').to_a+
-                    ('a'..'z').to_a+
-                    ('0'..'9').to_a
-    10.times {
-      gibberish_name << possibilities.sample
-    }
-    gibberish_name << '_' # And the last one is a separator-character.
-    # ======================================================================= #
-    # Next, create that directory - it must end with the assumed
-    # extracted-directory name:
-    # ======================================================================= #
-    target = rbt_log_directory?+
-             gibberish_name+
-             program_name_and_program_version?+
-             '/'
-    set_extract_to_this_directory_as_specified_by_the_user(target)
-    do_show_the_infobox
-    cd(target)
-    extract_what_to(program_path?, target) {{ append_to_the_commandline: '--strip-components=1' }}
-    cd(target)
-    do_these_logic_steps(
-      :consider_creating_the_appdir,
-      :consider_applying_a_patch,
-      :check_for_sed_action,
-      :run_preinstall_actions,
-      :register_that_this_program_is_currently_being_compiled,
-      :run_pre_configure_steps_if_requested_to_do_so,
-      :decide_whether_to_build_statically,
-      :decide_whether_to_invoke_autogen,
-      :decide_whether_to_invoke_the_autoconf_command,
-      :run_configure_like_stage,
-      :check_for_common_problems_and_common_errors,
-      :consider_symlinking_glib_schema_files_into_the_usr_share_hierarchy,
-      :prepare_symlink_program_instance,
-      :consider_removing_empty_subdirectories,
-      :store_time_snapshot,
-      :consider_reporting_the_time_it_took_to_compile_this_program,
-      :consider_performing_postinstallation_actions,
-      :do_strip_the_compiled_binaries,
-      :consider_creating_and_populating_the_pkgconfig_directory,
-      :register_configure_line_into_configure_database,
-      :consider_symlinking_the_pkgconfig_files,
-      :consider_checking_whether_the_compiled_binaries_are_already_registered,
-      :consider_running_ldconfig
-    )
-  end
-
-  # ========================================================================= #
-  # === operating_system_in_use?
-  # ========================================================================= #
-  def operating_system_in_use?(
-      i = RUBY_PLATFORM
-    )
-    case i
-    # ======================================================================= #
-    # === linux
-    # ======================================================================= #
-    when /linux$/ # e. g. "x86_64-linux"
-      'Linux'
-    # ======================================================================= #
-    # === win
-    # ======================================================================= #
-    when /win/,
-         /mingw/
-      'Windows'
-    else
-      'Undetermined (as of yet - please report it upstream)'
-    end
-  end
-
-  # ========================================================================= #
-  # === rnsymc
-  # ========================================================================= #
-  def rnsymc(i = return_pwd)
-    RBT::SymlinkFromToCurrent.new(i)
-  end
-
-  # ========================================================================= #
-  # === create_standalone_yaml_file
-  #
-  # This will create standalone yaml files.
-  #
-  # Usage example:
-  #
-  #   ry htop --csyf
-  #
-  # ========================================================================= #
-  def create_standalone_yaml_file
-    require 'rbt/cookbooks/create_cookbook_yaml_file/create_cookbook_yaml_file.rb'
-    cliner {
-      opne 'Dumping all available recipes next.'
-    }
-    store_here = RBT.configuration?.recipes_directory
-    all_programs.each { |this_program|
-      e sfancy("This program is: `")+simp(this_program)+sfancy('`.')
-      initialize_cookbook_dataset_for(this_program)
-      _ = RBT::Cookbooks::CreateCookbookYamlFile.new(this_program, :do_not_run_yet)
-      _.store_where(store_here)
-      _.run
-    }
-    cliner {
-      opne sfancy('Finished dumping all Recipes into ')+sdir(store_here)
-      opne "#{N}There were: #{sfancy(all_programs.size.to_s)} of them.#{N}"
-    }
-  end
-
-  # ========================================================================= #
-  # === return_possible_abbreviation_to_this_input
-  #
-  # This method will return an abbreviation to a given input.
-  # ========================================================================= #
-  def return_possible_abbreviation_to_this_input(i)
-    if will_we_make_use_of_abbreviations?
-      # ===================================================================== #
-      # If the cookbooks-project already includes the given input at hand
-      # then we do not have to do anything else.
-      # ===================================================================== #
-      is_the_program_included = cookbooks_include_this_program? i
-      unless is_the_program_included
-        # =================================================================== #
-        # We have to do another check, this time including the abbreviations.
-        # =================================================================== #
-        is_the_program_included = cookbooks_include_this_program?(
-          i, :with_abbreviations
-        )
-        if is_the_program_included
-          abbreviation_points_to = abbreviations?[i]
-          unless abbreviation_points_to == i
-            # =============================================================== #
-            # Notify the user that we will "re-write" the original input
-            # in this case.
-            # =============================================================== #
-            opne "#{rev}The given input #{sfancy(i)} could not be "\
-                 "found, but an abbreviation"
-            opne "was found, which is now used as the new name: "\
-                 "#{mediumspringgreen(abbreviation_points_to)}"
-            i = abbreviation_points_to.to_s.delete('_').dup
-            set_is_an_abbreviation
-            # =============================================================== #
-            # We must also set the Hash to sync-back our findings, so that
-            # we change input like "ry macro" to "ry marco". We avoid
-            # using the setter method because the setter method does a
-            # few additional checks as-is.
-            # =============================================================== #
-            set_handle_this_program(i)
-          end
-        end
-      end
-    end
-    return i
-  end
-
-  # ========================================================================= #
-  # === compile_xcb_components
-  #
-  # To invoke this method, issue:
-  #
-  #   ry --compile-xcb-components
-  #
-  # ========================================================================= #
-  def compile_xcb_components
-    opne "#{rev}Now compiling the various #{steelblue('xcb components')}."
-    array = %i(
-      xcbproto
-      libxcb
-      xcbutil
-      xcbutilcursor
-      xcbutilerrors
-      xcbutilimage
-      xcbutilkeysyms
-      xcbutilrenderutil
-      xcbutilwm
-      xcbutilxrm
-    )
-    set_array_compile_these_programs(array)
-  end
-
-  # ========================================================================= #
-  # === return_n_programs_available
-  # ========================================================================= # 
-  def return_n_programs_available
-    '  → '+sfancy(n_programs_available?.to_s)+' programs '\
-    'registered as of '+simp(today?)+'.'
-  end
-
-  # ========================================================================= #
-  # === colourize_this_important_system_command
-  # ========================================================================= #
-  def colourize_this_important_system_command(i)
-    # ===================================================================== #
-    # Next, modify this command if it includes "--prefix=".
-    # In that event we will colourize it a bit; the prefix will be
-    # colourized in another colour.
-    # ===================================================================== #
-    if i and i.include?('--prefix=') and use_colours?
-      i = i.dup
-      # ================================================================= #
-      # === Colourize the prefix, in cornflowerblue().
-      # ================================================================= #
-      i.sub!(/(--prefix=)(\/.+?)\s/, # See: http://rubular.com/r/Df8OzLqXGd
-        '\1'+
-        cornflowerblue('\2 ')+
-        ::Colours.remove_escape_sequences(
-          teal('')
-        )
-      )
-    end
-    teal(i)
-  end
-
-  # ========================================================================= #
-  # === use_a_specific_program_version
-  #
-  # Use this method to set to a specific program version.
-  #
-  # Currently we will act on --version= and on --use-version=.
-  #
-  # To check the regex, look here:
-  #
-  #   http://rubular.com/r/Wnq91wy8Nx
-  #
-  # To test this, try any of the following:
-  #
-  #   ry gcc --version=4.5.3.tar.xz
-  #   ry gcc --use-version=4.5.3.tar.xz
-  #   ry nano --v=2.4.3
-  #   ry mesa --use-this-version=mesa-18.2.6
-  # 
-  # ========================================================================= #
-  def use_a_specific_program_version(i)
-    i = i.dup
-    # ======================================================================= #
-    # We don't want file-extensions here.
-    # ======================================================================= #
-    i = remove_file_extension(i)
-    if i.include?('=')
-      splitted = i.split('=')
-      i = splitted.last
-    end
-    # ======================================================================= #
-    # Now we have e. g. input such as"mesa-18.2.6".
-    # ======================================================================= #
-    if i.include?('-') or i.include?('_')
-      set_program_name(
-        program_information_return_program_name(i)
-      )
-      set_program_short_name(
-        program_information_return_program_name(i)
-      )
-      i = program_information_return_version(i).dup
-    else
-      # Else we will just use it directly as version.
-    end
-    # ======================================================================= #
-    # In the past we used a regex, like shown here:
-    #
-    #   https://rubular.com/r/Z6LP2FCENzPj
-    #
-    # But we probably don't have to do so since January 2019.
-    # ======================================================================= #
-    set_program_version(i)
-    opne "Setting to the specific version `#{royalblue(i)}` "\
-         "now (for the program #{orange(compile_which_program?)})."
-    # ======================================================================= #
-    # Set it in the internal Hash - it will be synced lateron, see the
-    # file sync.rb for this.
-    # ======================================================================= #
-    new_target_prefix = rds(
-      "#{programs_directory?}/#{compile_which_program?.capitalize}/#{i}/"
-    )
-    # ======================================================================= #
-    # We will also modify the original program_path.
-    # ======================================================================= #
-    set_user_prefix(
-      new_target_prefix
-    )
-    unless archive_type?.empty?
-      empty_archive_type
-    end
-    update_program_name
-    set_program_full_name(
-      cookbooks_program_name?
-    )
-    update_program_path
-    cookbook_dataset?.rebuild_program_path
-  end
-
-  # ========================================================================= #
-  # === determine_the_configure_base_directory_to_use
-  #
-  # This method can be used to determine the full path to the configure
-  # base directory to be used.
-  # ========================================================================= #
-  def determine_the_configure_base_directory_to_use(
-      target = extract_to_this_dir?.dup+
-               yaml_dataset?.program_name_and_program_version?+
-               '/'+
-               cookbook_dataset_configure_base_directory?.to_s
-    )
-    set_configure_base_directory(target)
-  end
-
-  # ========================================================================= #
-  # === show_available_aliases
-  #
-  # To invoke this method, do:
-  #
-  #   rbt --aliases?
-  #
-  # ========================================================================= #
-  def show_available_aliases
-    _ = RBT.cookbook_aliases?
-    opnn; e "The available #{sfancy(_.size.to_s)} aliases are:"
-    index = 0
-    _.each_pair {|key, value| index += 1
-      colourized_index = slateblue((index.to_s+')').rjust(5))
-      e colourized_index+' '+sfancy(key.ljust(18))+
-        mediumseagreen(' →  ')+simp(value)
-    }
-  end
-
-  # ========================================================================= #
-  # === colourize_this_important_system_command
-  # ========================================================================= #
-  def ecolourize_this_important_system_command(i)
-    e colourize_this_important_system_command(i)
-  end
-
-  # ========================================================================= #
-  # === return_meson_configure_options
-  # ========================================================================= #
-  def return_meson_configure_options
-    return_the_appropriate_configure_options(:meson)
-  end
-
-  # ========================================================================= #
-  # === return_the_appropriate_configure_options
-  #
-  # This will return the configure options or meson option or cmake
-  # options. The guarantee is that we will return whatever is
-  # appropriate.
-  #
-  # For now, the method will only consider configure options.
-  # ========================================================================= #
-  def return_the_appropriate_configure_options(
-      build_type = return_build_type.to_s
-    )
-    _ = nil # Tiny safeguard.
-    build_type = build_type.to_sym unless build_type.is_a? Symbol
-    case build_type
-    # ======================================================================= #
-    # === :meson
-    #
-    # This is for the meson-configure-options.
-    # ======================================================================= #
-    when :meson
-      _ = @cookbook.meson_configure_options?.to_s
-    # ======================================================================= #
-    # === :configure
-    # ======================================================================= #
-    when :configure
-      _ = @cookbook.configure_options?.to_s.dup
-    # ======================================================================= #
-    # === :unknown
-    #
-    # We currently don't handle this.
-    # ======================================================================= #
-    when :unknown, :infer, :infer_automatically
-      return
-    else
-      return nil
-      #   opne 'Not yet handled: :'+build_type.to_s+'.'
-    end
-    if _ and !_.empty?
-      splitted = _.split("\n").reject {|entry| entry.strip.empty? }
-      first = splitted.first
-      unless first.start_with?('--')
-        splitted.map! {|entry|
-          unless entry.start_with? '-'
-            entry = "--#{entry}"
-          end
-          entry
-        }
-      end
-      _ = splitted.join(' ')
-    end
-    _ = " #{_}" if _
-    return _
-  end
-
-  # ========================================================================= #
-  # === extract_program_and_cd_to_the_configure_base_directory
-  # ========================================================================= #
-  def extract_program_and_cd_to_the_configure_base_directory
-    do_extract
-    cd_to_the_configure_base_directory
-  end
-
-  # ========================================================================= #
-  # === append_these_options_to_the_commandline
-  #
-  # Simply append to the commandline options through this method here.
-  # ========================================================================= #
-  def append_these_options_to_the_commandline(i)
-    # ======================================================================= #
-    # First check whether the input is a Hash:
-    # ======================================================================= #
-    if i.is_a? Hash
-      if i.has_key? :commandline_arguments
-        i = i.delete(:commandline_arguments)
-      end
-    end
-    @internal_hash[:commandline_arguments] << i
-    @internal_hash[:commandline_arguments].flatten!
-  end; alias append_to_the_commandline append_these_options_to_the_commandline # === append_to_the_commandline
-
-  # ========================================================================= #
-  # === purge_all_man_files_in_the_programs_hierarchy
-  #
-  # Invoke this method by issuing something like this:
-  #
-  #   ry --nomanpage
-  #
-  # ========================================================================= #
-  def purge_all_man_files_in_the_programs_hierarchy
-    target = programs_directory?
-    opne "Now purging all man-pages in `#{sdir(target)}`."
-    opne '(Note that we will only work on entries pointed at '\
-         'with a Current symlink.)'
-    Dir[target+'*'].each {|entry|
-      entry << '/' unless entry.end_with? '/'
-      current = entry + 'Current'
-      if File.symlink? current
-        # =================================================================== #
-        # Ok, the Current → symlink exists, thus we can continue.
-        # =================================================================== #
-        manpage = "#{File.readlink(current)}/share/man/"
-        manpage = rds(manpage)
-        if File.exist? manpage and File.directory? manpage
-           opne "Now #{tomato('removing')} the directory `#{sdir(manpage)}`."
-           remove_directory(manpage) unless manpage.squeeze('/') == '/' # Trivial "safeguard".
-        end
-      end
-    }
-  end
-
-  # ========================================================================= #
-  # === scan_source_archive
-  #
-  # Scan the complete source archive.
-  #
-  # Invocation example:
-  #
-  #   ry --scan_source_archive
-  #
-  # ========================================================================= #
-  def scan_source_archive(
-      shall_we_exit = true
-    )
-    require 'rbt/cookbooks/scan_source_archive.rb'
-    opne 'Scanning for source Archives now.'
-    RBT::Cookbooks::ScanSourceArchive.new # bl ScanSourceArchive
-    exit_program if shall_we_exit
-  end
-
-  # ========================================================================= #
-  # === prepend_dot_to_configure_string
-  # ========================================================================= #
-  def prepend_dot_to_configure_string
-    full_configure_command?.prepend('.')
-  end
-
-  # ========================================================================= #
-  # === enable_simulation
-  #
-  # Enable to run in simulation mode. The first argument is an optional 
-  # message we give, in which case we will output that message.
-  # ========================================================================= #
-  def enable_simulation(
-      optional_message = ''
-    )
-    unless optional_message.empty?
-      opne optional_message
-    end
-    do_run_simulation
-  end
-
-  # ========================================================================= #
-  # === be_completely_quiet
-  # ========================================================================= #
-  def be_completely_quiet
-    @original_stdout = $stdout
-    # $stdout = StringIO.new # This is the redirection.
-    $stdout = File.open(IO::NULL, 'w') # This one works better, according to drbrain.
-  end
-
-  # ========================================================================= #
-  # === do_not_compile
-  #
-  # This method can be invoked to set the :continue_after_configure_step
-  # entry in the internal hash to false.
-  #
-  # If set to false then we will NOT compile a program. Instead, we will
-  # run the configure script and quit after having done so.
-  # ========================================================================= # 
-  def do_not_compile(
-      be_verbose = true
-    )
-    case be_verbose
-    when :be_quiet
-      be_verbose = false
-    end
-    if be_verbose
-      opne 'We will not continue after configure phase.'
-    end
-    @internal_hash[:continue_after_configure_step] = false
-    @internal_hash[:do_not_compile] = true
-    set_do_not_symlink(:be_verbose) # So we don't run advanced symlink.
-  end
-
-  # ========================================================================= #
-  # === cd_to_the_configure_base_directory
-  #
-  # This method can be used to cd into the configure base directory.
-  #
-  # It can report what it is doing to, in the verbose variant.
-  # ========================================================================= #
-  def cd_to_the_configure_base_directory(
-      be_verbose_or_be_quiet = :be_quiet
-    )
-    target = @internal_hash[:configure_base_directory].dup
-    case be_verbose_or_be_quiet
-    when :be_quiet
-      cd target, :be_quiet
-    else
-      opnn; cd target, :be_verbose
-    end
-  end; alias cd_to_the_configure_base_directory_to_be_used cd_to_the_configure_base_directory # === cd_to_the_configure_base_directory_to_be_used
-
-  # ======================================================================= #
-  # === notify_the_user_as_to_which_program_will_be_compiled_or_installed_next
-  #
-  # Notify the user which program will be compiled/installed next
-  # through this method.
-  # ======================================================================= #
-  def notify_the_user_as_to_which_program_will_be_compiled_or_installed_next(
-      i = compile_which_program?,
-      _ = program_path?
-    )
-    opne "#{rev}The program `#{steelblue(i)}` "\
-         "will be #{compile_or_install_string?} next, in "\
-         "#{lightgreen(mode?.to_s)} mode."
-    opne 'The assumed path is:'
-    opne "  #{sfile(_)}"
-  end
-
-  # ========================================================================= #
-  # === do_not_check_whether_the_program_exists
-  # ========================================================================= #
-  def do_not_check_whether_the_program_exists
-    @internal_hash[:check_whether_the_given_input_is_a_file_and_does_exist] = false
-  end; alias do_not_honour_check_to_ensure_that_the_program_exists do_not_check_whether_the_program_exists # === do_not_honour_check_to_ensure_that_the_program_exists 
-
-  # ========================================================================= #
-  # === reset_the_status_file
-  #
-  # This method will clear the status.yml file, aka re-set it to zero.
-  #
-  # To invoke this method, do:
-  #
-  #   rbt --reset-the-status-file
-  #
-  # ========================================================================= #
-  def reset_the_status_file
-    this_file = FILE_STATUS
-    dataset = {}
-    dataset['currently_compiling_these_programs'] = []
-    write_what_into(YAML.dump(dataset), this_file)
-  end
-
-  # ========================================================================= #
-  # === determine_which_compiler_will_be_used
-  #
-  # This method currently will only check if the clang-compiler is used.
-  # ========================================================================= #
-  def determine_which_compiler_will_be_used
-    case use_which_compiler?
-    when 'clang'
-      do_use_clang_compiler(:be_quiet)
-    end
-  end
-
-  # ========================================================================= #
-  # === compile_all_programs
-  #
-  # This method is a direct approach to compile every program that we have
-  # registered, in our database.
-  #
-  # This method accepts one argument, which decides whether we will quit
-  # afterwards or whether we will not.
-  #
-  # Invocation example:
-  #
-  #   ry --compile_all_programs
-  #
-  # ========================================================================= #
-  def compile_all_programs(
-      shall_we_exit = true
-    )
-    case shall_we_exit
-    when :do_exit_afterwards
-      shall_we_exit = true
-    end
-    _ = return_available_programs.shuffle # We shuffle for more "randomness".
-    n_programs = _.size.to_s
-    clear_commandline_options
-    opne sfancy('Compiling all available programs next (by a brute'\
-         'force approach - we found ')+
-         simp(n_programs)+sfancy(' programs):')
-    compile_every_program(_)
-    exit_program if shall_we_exit
-  end
-
-  # ========================================================================= #
-  # === run_configure_make_and_make_install_with_this_configure_line
-  # ========================================================================= #
-  def run_configure_make_and_make_install_with_this_configure_line(i)
-    run_configure_via_system(i)
-    run_make
-    run_make_install
-  end
-
-  # ========================================================================= #
-  # === increment_compiled_this_program_n_times_counter
-  #
-  # By default this method will increment by +1.
-  # ========================================================================= #
-  def increment_compiled_this_program_n_times_counter(
-      by_plus_n = 1
-    )
-    @internal_hash[:we_tried_to_compile_this_program_n_times] += by_plus_n
-  end; alias increment_compiled_counter increment_compiled_this_program_n_times_counter # === increment_compiled_counter
-
-  # ========================================================================= #
-  # === update_binaries_of_this_program
-  #
-  # Invocation examples:
-  #
-  #   rbt --update-binaries-of=poppler
-  #   rbt --update-binaries-of=htop
-  #   rbt --update-binaries-of=xinelib
-  #
-  # ========================================================================= #
-  def update_binaries_of_this_program(i)
-    these_binaries = RBT.infer_these_binaries_will_be_installed_by(i)
-    # ======================================================================= #
-    # Now that we have obtained the binaries we can add it to our
-    # .yml file. Note that this will always overwrite any other existing
-    # entry, so the first step is to get rid of any old entries, before
-    # adding the new entries.
-    # ======================================================================= #
-    path   = find_this_yaml_file(i)
-    string = read_file_in_default_encoding(path)
-    if is_on_roebe?
-      opne 'Creating a backup of the file first.'
-      backup_directory_at = log_dir?+'backup/'
-      mkdir(backup_directory_at) unless File.directory?(backup_directory_at)
-      # ===================================================================== #
-      # We will copy the old file, so that we could re-use it if we need to.
-      # ===================================================================== #
-      opnn; copy_file(
-              path,
-              backup_directory_at+File.basename(path),
-              :be_verbose
-            )
-    end
-    if string.include? ' binaries:'
-      if is_on_roebe?
-        # =================================================================== #
-        # Notify only me on my home system in this case, as most users
-        # won't need this information here really.
-        # =================================================================== #
-        opne "#{tomato('Removing')} the old #{slateblue('binaries:')} "\
-             "entries first."
-        new_string = ''.dup
-        state_is_open = false
-        string.split(N).each {|line|
-          if line.include? ' binaries:'
-            state_is_open = true
-          else
-            # =============================================================== #
-            # Toggle it unless the next line starts with a ' - '.
-            # =============================================================== #
-            unless line.start_with?(' - ')
-              state_is_open = false
-            end
-          end
-          unless state_is_open
-            new_string << line << N
-          end
-        }
-        string = new_string # And re-assign it here.
-      end
-    end
-    # ======================================================================= #
-    # Ok, now we can find the proper position and simply add the binaries.
-    # We will first check for a "homepage:" String; then "url2:" and
-    # then "url1:". These are our "anchors".
-    # ======================================================================= #
-    if these_binaries.empty?
-      opne 'Can not store anything because no binaries could be found.'
-    else
-      append_this_string = ' binaries:'+N+' - '+these_binaries.join(N+' - ')+N
-      splitted = string.split(N)
-      array = []
-      if string.include? ' blfs: '
-        splitted.each {|line|
-          if line.include? ' blfs: '
-            array << line+N+append_this_string
-          else
-            array << "#{line}#{N}"
-          end
-        }
-      elsif string.include? 'configure_options: '
-        splitted.each {|line|
-          if line.include? ' configure_options: '
-            array << line+N+append_this_string
-          else
-            array << "#{line}#{N}"
-          end
-        }
-      elsif string.include? 'url2: '
-        splitted.each {|line|
-          if line.include? ' url2: '
-            array << line+N+append_this_string
-          else
-            array << "#{line}#{N}"
-          end
-        }
-      else
-        opne 'Can not anchor it as no string '\
-             'called '+slateblue('blfs:')+
-             ':, '+slateblue('configure_options:')
-        opne 'or '+slateblue('url2:')+' could be found.'
-      end
-      what = array.join.chomp
-      # ===================================================================== #
-      # Next update the old content.
-      # ===================================================================== #
-      into = path
-      opne 'Next overwriting the file `'+sfile(into)+'`.'
-      write_what_into(what, into)
-      if is_on_roebe?
-        # =================================================================== #
-        # Also auto-updating the rbt project.
-        # =================================================================== #
-        opne 'Since we are on roebe we will also auto-update the '\
-             'rbt project next.'
-        cd RUBY_SRC_DIR_AT_HOME+'rbt/'
-        require 'roebe/toplevel_methods/rinstall2.rb'
-        Roebe.rinstall2
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === load_last_compiled_program
-  #
-  # This essentially does the following:
-  #
-  #   x = load_yaml('/Depot/Temp/rbt_logs/last_compiled_programs.yml')
-  #
-  # To obtain this information from the commandline, try:
-  #
-  #   rbt --last-compiled-program?
-  #
-  # ========================================================================= #
-  def load_last_compiled_program
-    _ = RBT.file_compiled_programs
-    if File.exist? _
-      @last_compiled_program = load_yaml(_)
-      result = @last_compiled_program
-      # ===================================================================== #
-      # If we store it as an Array, the last compiled program is the
-      # one that comes last in that Array, too.
-      # ===================================================================== #
-      result = result.last if result.is_a? Array
-      # ===================================================================== #
-      # It may include a '#' character, in which case we will treat this
-      # as a comment:
-      # ===================================================================== #
-      if result.include? '#'
-        result = result[0, result.index('#')].strip
-      end
-      return result # ← And return the result here.
-    else
-      opne "No file exists at `#{sfile(_)}`."
-      opne 'Thus, we can not load anything.'
-      exit_program
-    end
-  end; alias last_compiled_program? load_last_compiled_program # === last_compiled_program?
-
-  # ========================================================================= #
-  # === verbose_enable_glib_schema
-  # ========================================================================= #
-  def verbose_enable_glib_schema
-    opne "Enabling #{slateblue('glib-schemata')} next."
-    do_use_glib_schema # Enable the glib-schemata here.
-  end
-
-  # ========================================================================= #
-  # === do_use_glib_schema
-  #
-  # Use this method to enable the use of a glib-schema.
-  # ========================================================================= #
-  def do_use_glib_schema
-    @internal_hash[:use_glib_schema] = true
-  end
-
-  # ========================================================================= #
-  # === consider_removing_empty_subdirectories
-  #
-  # We will remove empty subdirectories but only from AppDir-like prefixes.
-  # ========================================================================= #
-  def consider_removing_empty_subdirectories
-    if uses_an_appdir_prefix?
-      prefix = prefix?.to_s # ← This will be like "/Programs/Gcide/0.52/".
-      subdirectories = Dir[prefix+'*'].select {|entry|
-        File.directory?(entry) and Dir.empty?(entry)
-      }
-      remove_directories(
-        subdirectories
-      )
-      consider_removing_the_current_symlink_if_the_directory_is_empty
-      consider_removing_the_settings_directory_if_it_is_empty
-      consider_removing_the_empty_versioned_directory
-      consider_removing_the_empty_base_directory_of_the_program
-    end
-  end; alias consider_running_cleanup_actions consider_removing_empty_subdirectories # === consider_running_cleanup_actions
-
-  # ========================================================================= #
-  # === consider_removing_the_empty_base_directory_of_the_program
-  # ========================================================================= #
-  def consider_removing_the_empty_base_directory_of_the_program
-    if uses_an_appdir_prefix? and !is_a_gem_file?
-      target = rds(
-        programs_dir?+program_name?.capitalize.delete('-_')+'/'
-      )
-      if File.directory?(target) and
-         Dir.empty?(target)
-        opne tomato('Removing')+' the empty directory at `'+sdir(target)+'` next.'
-        remove_this_directory(target)
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === linux_from_scratch                                          (lfs tag)
-  #
-  # We simply delegate this task to the class LFS.
-  # ========================================================================= #
-  def linux_from_scratch
-    RBT::LFS.new
-  end
-
-  # ========================================================================= #
-  # === register_all_protos_for_compilation
-  #
-  # Invoke this method like so:
-  #
-  #   ry --protos
-  #
-  # ========================================================================= #
-  def register_all_protos_for_compilation
-    proto_programs = available_programs?.select {|entry|
-      entry.include?('proto')
-    }
-    proto_programs.reject! {|line|
-      line.include? 'protobuf'
-    }
-    # ======================================================================= #
-    # Reject those that are .gem files next - but this will only work if
-    # the directory with expanded cookbooks is available:
-    # ======================================================================= #
-    if directory_expanded_cookbooks_exists?
-      proto_programs.reject! {|name_of_the_program|
-        this_file = directory_expanded_cookbooks+name_of_the_program+'.yml'
-        if File.exist? this_file
-          dataset = load_yaml(this_file)
-          dataset['program_path'].end_with? '.gem'
-        else
-          e 'No file called '+sfile(this_file)+' was found.'
-          nil
-        end
-      }
-    end
-    opne "We will next compile all "\
-         "#{sfancy(proto_programs.size.to_s)}"\
-         " proto-programs."
-    set_compile_these_programs(proto_programs)
-  end
-
-  # ========================================================================= #
-  # === do_not_initialize_a_new_cookbook_dataset
-  # ========================================================================= #
-  def do_not_initialize_a_new_cookbook_dataset
-    @internal_hash[:may_we_initialize_a_new_cookbook_dataset] = false
-  end
-
-  # ========================================================================= #
-  # === we_can_not_continue
-  # ========================================================================= #
-  def we_can_not_continue(be_verbose = false)
-    case be_verbose
-    when :be_quiet
-      be_verbose = false
-    end
-    if be_verbose
-      opne 'The RBT scripts can not continue.'
-    end
-    @internal_hash[:can_we_continue] = false
-  end; alias can_not_continue we_can_not_continue # === can_not_continue
-       alias do_not_continue  we_can_not_continue # === do_not_continue
-
-  # ========================================================================= #
-  # === opnewarn
-  # ========================================================================= #
-  def opnewarn(i)
-    opne swarn(i)
-  end
-
-  # ========================================================================= #
-  # === we_can_not_continue_and_we_will_not_run_make_install
-  # ========================================================================= #
-  def we_can_not_continue_and_we_will_not_run_make_install
-    we_can_not_continue
-    do_not_run_make_install
-  end
-
-  # ========================================================================= #
-  # === verbose_disable_maximum_speed_for_compilation
-  # ========================================================================= #
-  def verbose_disable_maximum_speed_for_compilation
-    opne 'We will not be using maximum speed.'
-    configuration?.use_maximum_speed_for_compilation = false
-  end
-
-  # ========================================================================= #
-  # === convert_to_non_traditional
-  #
-  # Use this method to convert a program to non-traditional (Gobolinux style)
-  # again.
-  # ========================================================================= #
-  def convert_to_non_traditional(i = program?)
-    RBT::ConvertToNonTraditional.new(i)
-  end
-
-  # ========================================================================= #
-  # === backup_program
-  #
-  # Backup an existingp rogram under the /Programs/ hierarchy.
-  # ========================================================================= #
-  def backup_program(
-      i = compile_which_program?
-    )
-    require 'rbt/utility_scripts/backup_program.rb'
-    RBT::BackupProgram.new(i)
-  end
-
-  # ========================================================================= #
-  # === do_not_use_any_compile_time_flags
-  #
-  # If you do not want to use any compile-time flags, aka CFLAGS, then
-  # you can use this method here.
-  # ========================================================================= #
-  def do_not_use_any_compile_time_flags
-    opne 'Setting compile-time flags ('+
-         royalblue('CFLAGS')+', '+
-         royalblue('LDFLAGS')+
-         ') to empty.'
-    set_cflags('')
-  end
-
-  # ========================================================================= #
-  # === reuse_old_configure_options
-  #
-  # This method currently works only with the target program being GCC.
-  #
-  # Perhaps it may be extended for other programs one day.
-  #
-  # Invocation examples:
-  #
-  #   ry gcc --copy-old-version
-  #   ry gcc --use-this-version=7.1.0 --use-old-configure-options
-  #
-  # ========================================================================= #
-  def reuse_old_configure_options(
-      use_this_program = compile_which_program?
-    )
-    _ = `#{use_this_program} -v #{SHELL_ERROR_CODE}`
-    options = _.scan(/^Configured .+/).first.
-                sub(/^Configured with:/,'').
-                sub(/\.\.\/configure /,''). 
-                strip
-    opne "Re-using the old configure option, which "\
-         "was `#{sfancy(options)}`."
-    if options.include? programs_directory?
-      # ===================================================================== #
-      # Next, replace the oldprefix.
-      # ===================================================================== #
-      programs_dir = Regexp.quote(programs_directory?)
-      if dataset?.nil?
-        ensure_that_the_default_dataset_exists_for_this_program(use_this_program)
-      end
-      if @internal_hash[:use_this_specific_program_version]
-        dataset?.set_program_version(@internal_hash[:use_this_specific_program_version])
-        dataset?.reassemble_program_path
-      end
-      regex_to_use = /(--prefix=#{programs_dir}Gcc\/\d{1,2}\.\d{1,2}\.\d{1,2})/
-      options.sub!(regex_to_use, '--prefix='+return_appdir_prefix)
-      options.squeeze!('/')
-      # ===================================================================== #
-      # Now, simply use that as configure version.
-      # ===================================================================== #
-      extract_to_default_directory
-      set_configure_base_directory
-      cd_to_the_configure_base_directory
-      run_preinstall_sed_and_currently_being_compiled
-      consider_creating_the_build_directory
-      e "These are the #{orange('options')} that will be used:"
-      e
-      e "  #{simp(options)}"
-      e
-      set_configure_options(options)
-      run_configure_make_and_make_install_with_this_configure_line(options)
-      run_all_actions_after_the_make_install_step
-      exit_program
-    end
-  end; alias use_old_configure_options reuse_old_configure_options # === use_old_configure_options
-
-  # ========================================================================= #
-  # === consider_running_autoconf_then_run_configure_then_make_then_make_install
-  # ========================================================================= #
-  def consider_running_autoconf_then_run_configure_then_make_then_make_install
-    consider_running_the_pre_configure_steps
-    decide_whether_to_invoke_the_autoconf_command
-    run_configure_then_make_then_make_install
-  end
-
-  # ========================================================================= #
-  # === install_palemoon
-  #
-  # To invoke this ad-hoc method, try:
-  #
-  #   rbt --install-palemoon
-  #
-  # ========================================================================= #
-  def install_palemoon(
-      path = '/home/x/src/palemoon/palemoon-'\
-             '28.5.2-64bit.tar.xz'
-    )
-    if File.exist? path
-      _ = remove_archive_from_the_end(
-        File.basename(path)
-      ).sub(/-64bit$/, '')
-      program_name    = program_information_return_name(_)
-      program_version = program_information_return_version(_)
-      target = program_dir?+program_name.capitalize+'/'+program_version+'/'
-      create_app_skeleton(target)
-      cd target
-      extract_to = target
-      extract_what_to(path, extract_to)
-      e 'Done!'
-    else
-      opnn; no_file_at(path)
-    end
-  end
-
-  # ========================================================================= #
-  # === automatically_infer_program_name_and_program_version_from_this_input
-  #
-  # This method will try to automatically set the program_name and
-  # @program_version variables.
-  # ========================================================================= #
-  def automatically_infer_program_name_and_program_version_from_this_input(
-      i,
-      optional_arguments = nil
-    )
-    if compile_which_program?.nil?
-      set_program_name(
-        program_information_return_program_real_name(i)
-      )
-    end
-    if program_version?.nil?
-      set_program_version(
-        program_information_return_program_version(i)
-      )
-    end
-    case optional_arguments
-    when :overwrite_old_values_should_they_exist
-      set_program_name    program_information_return_program_real_name(i)
-      set_program_version program_information_return_program_version(i)
-    end
-    set_program_name_and_program_version(
-      compile_which_program?+'-'+program_version?
-    )
-  end
-
-  # ========================================================================= #
-  # === consider_sanitizing_the_program_path
-  #
-  # This method will only be used when 
-  # @internal_hash[:use_this_specific_program_version] has been set. 
-  # ========================================================================= #
-  def consider_sanitizing_the_program_path
-    if @internal_hash[:use_this_specific_program_version]
-      # ===================================================================== #
-      # The above variable is nil by default, so if it has another value
-      # we can use this.
-      # ===================================================================== #
-      splitted    = @internal_hash[:use_this_specific_program_version].split('/')
-      last        = splitted.last # ← This will hold the new program version.
-      old_value   = cookbook_dataset_program_path?.dup
-      old_version = program_information_return_version(old_value)
-      set_cookbook_dataset_program_version(
-        last
-      )
-      old_value.sub!(/#{old_version}/, last)
-      set_cookbook_dataset_program(
-        remove_extension(
-          File.basename(old_value)
-        )
-      )
-      set_cookbook_dataset_program_path(old_value)
-    end
-  end
-
-  # ========================================================================= #
-  # === use_maximum_speed_for_compilation?
-  # ========================================================================= #
-  def use_maximum_speed_for_compilation?(
-      use_maximum_speed_for_compilation = config?.use_maximum_speed_for_compilation
-    )
-    result = false
-    if use_maximum_speed_for_compilation
-      result = use_maximum_speed_for_compilation
-    end
-    return result
-  end
-
-  # ========================================================================= #
-  # === try_to_output_how_many_processors_this_computer_has
-  #
-  # To try this method on the commandline, do:
-  #
-  #   rbt --n-cores?
-  #
-  # ========================================================================= #
-  def try_to_output_how_many_processors_this_computer_has(
-      file_cpuinfo = FILE_CPUINFO
-    )
-    if File.exist? file_cpuinfo
-      opne 'This computer has '+
-           lightseagreen(
-             return_n_processors_of_this_computer.to_s+' processors'
-           )+'.'
-    else
-      opne 'Can not determine the number of processors as '
-      opne "there is no file at #{sfile(file_cpuinfo)}."
-    end
-  end
-
-  # ========================================================================= #
-  # === return_n_processors_of_this_computer
-  #
-  # This method will return how many processors this computer has. This
-  # can then be used to automatically determine the maximum option
-  # given to the "make" binary.
-  # ========================================================================= #
-  def return_n_processors_of_this_computer(
-      file_cpuinfo = FILE_CPUINFO
-    )
-    if file_cpuinfo.is_a?(String) and File.exist?(file_cpuinfo)
-      selected_dataset = File.readlines(file_cpuinfo).select {|line|
-        line.start_with? 'processor'
-      }
-      selected_dataset.size
-    else
-      1 # 1 is the minimum number.
-    end
-  end; alias return_n_processors return_n_processors_of_this_computer # === return_n_processors
-
-  # ========================================================================= #
-  # === consider_using_maximum_speed_for_compilation
-  #
-  # This method also has to check whether we will compile the given
-  # program at all or whether we will not.
-  # ========================================================================= #
-  def consider_using_maximum_speed_for_compilation
-    if use_maximum_speed_for_compilation? and
-       the_program_has_to_be_compiled? and
-       can_we_continue?
-      opne "The configuration file "\
-           "#{sfile('use_maximum_speed_for_compilation.yml')}"\
-           " specified"
-      opne 'that maximum speed should be used for compilation.'
-      opne "This means to pass the #{orange('-j')} option "\
-           "to the program #{slateblue('make')},"
-      opne 'with the number of processors this computer has.'
-      speed_up_the_compilation
-    end
-  end
-
-  # ======================================================================= #
-  # === compile_all_games
-  #
-  # This method can be used to compile all registered games.
-  # ======================================================================= #
-  def compile_all_games
-    compile_all_programs_that_belong_to_this_tag(:game)
-  end
-
-  # ========================================================================= #
-  # === try_to_fix_all_shebangs
-  #
-  # Use this to fix shebangs of the RBT project.
-  # ========================================================================= #
-  def try_to_fix_all_shebangs
-    begin
-      require 'roebe/classes/shebang_fixer.rb'
-      cliner {
-        opne 'Trying to fix all Shebangs now:'
-        entries = Dir["#{base_directory?}**/**.rb"]
-        entries.each { |file|
-          file = ENV['RBT_DIR'].to_s+'/'+file
-          Roebe::ShebangFixer.new(file)
-        }
-      }
-    rescue LoadError
-      e 'class Roebe::ShebangFixer is not available.'
-    end
-  end
-
-  # ========================================================================= #
-  # === initialize_cookbook_dataset_for
-  #
-  # This method is different to load_yaml_dataset_for_this_program()
-  # in that we will also assign to the main internal Hash.
-  # ========================================================================= #
-  def initialize_cookbook_dataset_for(
-      this_program       = @handle_this_program,
-      optional_arguments = nil
-    )
-    yaml_dataset = load_yaml_dataset_for_this_program(
-      this_program, optional_arguments
-    )
-    # ======================================================================= #
-    # Next, assign to the internal Hash:
-    # ======================================================================= #
-    assign_to_the_main_dataset(
-      yaml_dataset
-    )
-  end
-
-  # ========================================================================= #
-  # === consider_removing_the_settings_directory_if_it_is_empty
-  #
-  # This method will attempt to remove the /Settings subdirectory, if
-  # it is empty.
-  # ========================================================================= #
-  def consider_removing_the_settings_directory_if_it_is_empty
-    if uses_an_appdir_prefix?
-      prefix = prefix?.to_s
-      settings_directory = File.dirname(prefix)+'/Settings'
-      if File.directory?(settings_directory) and
-         Dir.empty?(settings_directory)
-        remove_this_directory(settings_directory)
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === consider_removing_the_empty_versioned_directory
-  # ========================================================================= #
-  def consider_removing_the_empty_versioned_directory
-    if uses_an_appdir_prefix?
-      prefix = prefix?.to_s
-      if File.directory?(prefix) and
-        Dir.empty?(prefix)
-        remove_this_directory(prefix)
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === consider_removing_the_current_symlink_if_the_directory_is_empty
-  # ========================================================================= #
-  def consider_removing_the_current_symlink_if_the_directory_is_empty
-    if uses_an_appdir_prefix?
-      prefix = prefix?.to_s
-      symlink_current = rds(
-        File.dirname(prefix)+'/Current'
-      )
-      if File.symlink?(symlink_current) and 
-         File.directory?(File.readlink(symlink_current)) and
-         Dir.empty?(File.readlink(symlink_current))
-        delete_this_symlink(symlink_current)
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === consider_creating_appdir_skeleton_then_consider_running_autoconf_then_run_configure_then_make_then_make_install
-  # ========================================================================= #
-  def consider_creating_appdir_skeleton_then_consider_running_autoconf_then_run_configure_then_make_then_make_install
-    consider_creating_appdir_skeleton
-    consider_running_autoconf_then_run_configure_then_make_then_make_install
-  end
-
-  # ========================================================================= #
-  # === determine_the_program_path
-  #
-  # This method will determine the (internal) program path that is to
-  # be used, that is - the path to finding the program on the local
-  # harddisc.
-  #
-  # A word about the variable use_this_as_short_name:
-  #
-  # Since as of September 2019 we will also remove '.' characters,
-  # so that programs such as "ruamel.yaml" can reside in a directory
-  # called "ruamelyaml".
-  # ========================================================================= #
-  def determine_the_program_path
-    use_this_as_short_name = yaml_dataset?.program_short_name?.dup.downcase.
-                             delete('-.')
-    use_this_as_short_name.delete!('_')
-    value = source_directory?+
-            use_this_as_short_name+
-            '/'+
-            yaml_dataset?.program_name_and_program_version?+
-            yaml_dataset?.archive_type?
-    set_program_path(value)
-  end
-
-  # ========================================================================= #
-  # === do_not_use_any_configure_option
-  #
-  # This option allows us to avoid using any configure option.
-  #
-  # Invocation example from the commandline:
-  #
-  #   ry htop --dont-use-configure-options
-  #
-  # ========================================================================= #
-  def do_not_use_any_configure_option
-    if block_given? and yield == :be_verbose
-      # ===================================================================== #
-      # Be verbose in this case.
-      # ===================================================================== #
-      opne 'No configure options will be used '\
-           'for this run.'
-    end
-    @internal_hash[:try_to_use_configure_options] = false
-  end
-
-  # ========================================================================= #
-  # === install_this_flatpak
-  #
-  # This method can be used to install a flatpak from the official
-  # flatpak-URL.
-  # ========================================================================= #
-  def install_this_flatpak(
-      this_program
-    )
-    # ======================================================================= #
-    # We must first check whether this program has a flatpak-entry. But
-    # before that, we must initialize the dataset for the given program
-    # at hand.
-    # ======================================================================= #
-    initialize_dataset_for(this_program)
-    if has_flatpak_url?
-      cmd = "flatpak install --user #{flatpak_url?}"
-      e
-      esystem cmd
-      e
-    else
-      opnn; e "The program #{sfancy(this_program)} does not "\
-              "have a registered flatpak-URL."
-    end
-  end
-
-  # ========================================================================= #
-  # === return_dataset_for_this_program
-  #
-  # This method will be used to return the dataset, that is a new
-  # cookbook instance, from the given program at hand.
-  # ========================================================================= #
-  def return_dataset_for_this_program(
-      i = compile_which_program?
-    )
-    load_yaml_dataset_for_this_program(i)
-  end
-
-  # ========================================================================= #
-  # === do_use_the_gcc_compiler
-  #
-  # Use this method if you wish to make use of the GCC compiler.
-  #
-  # Invocation example:
-  #
-  #   ry htop --use-gcc
-  #
-  # ========================================================================= #
-  def do_use_the_gcc_compiler(
-      shall_we_notify_the_user = :notify_the_user
-    )
-    case shall_we_notify_the_user
-    # ======================================================================= #
-    # === :notify_the_user
-    # ======================================================================= #
-    when :notify_the_user,
-         :and_notify_the_user
-      opne "We will attempt to use #{teal('gcc')} to compile the "\
-           "code at hand."
-    end
-    set_this_env_variable 'CC=gcc',    :be_quiet
-    set_this_env_variable 'CXX=g++', :be_quiet
-    @internal_hash[:compiler_to_use] = :gcc # Keep track of the compiler here.
-  end; alias do_use_gcc_compiler do_use_the_gcc_compiler # === do_use_gcc_compiler
-
-  # ========================================================================= #
-  # === delete
-  #
-  # This method is similar to the method .delete() for class Hash.
-  # The method here will only return the value, though, and NOT delete
-  # anything - while this behaviour is, strictly speaking, not the same
-  # as for class Hash, there does not seem to be a big reason as to
-  # why the information should be deleted from an instance of class 
-  # RBT::Compile.
-  #
-  # In other words: .delete() here is mostly a compatibility method,
-  # in order to "fake-simulate" behaviour that a Hash would normally
-  # show.
-  # ========================================================================= #
-  def delete(this_key)
-    case this_key
-    # ======================================================================= #
-    # === :prefix
-    # ======================================================================= #
-    when :prefix
-      prefix?.to_s
-    # ======================================================================= #
-    # === :program_version
-    # ======================================================================= #
-    when :program_version
-      program_version?.to_s
-    # ======================================================================= #
-    # === :description
-    #
-    # This is actually a pointer towards the short description, since
-    # it is used primarily for autogenerating pkgconfig files.
-    # ======================================================================= #
-    when :description
-      short_description?.to_s
-    end
-  end
-
-  # ========================================================================= #
-  # === has_key?
-  #
-  # This is a substitute method, to enable hash-like behaviour for
-  # some keys. Right now (December 2019) this is a hardcoded Array,
-  # but in the future the code may be changed - let's see.
-  #
-  # Do note that this method is specifically synced (closely) with
-  # class RBT::CreatePkgconfigFile.new. 
-  # ========================================================================= #
-  def has_key?(i)
-    %i(
-      description
-      prefix
-      program_version
-    ).include? i
-  end
-
-  # ========================================================================= #
-  # === return_path_to_the_archive_of_this_program
-  #
-  # This functionality depends on the expanded cookbooks dataset.
-  # ========================================================================= #
-  def return_path_to_the_archive_of_this_program(i)
-    dataset_from_expanded_cookbook = return_dataset_from_expanded_cookbook(i)
-    dataset_from_expanded_cookbook[:program_path]
-  end
-
-  # ========================================================================= #
-  # === install_the_linux_kernel_header_files_via_this_prefix
-  #
-  # The argument to this method is the prefix to be used. For example,
-  # the default AppDir prefix on my system for the linux kernel is
-  # "/home/Programs/Linux/5.7/".
-  #
-  # This method can also be used to specify a prefix for "home" which
-  # refers to the "home directory".
-  # ========================================================================= #
-  def install_the_linux_kernel_header_files_via_this_prefix(
-      use_this_prefix = :appdir_prefix
-      )
-    _ = initialize_cookbook_dataset_for(:linux)
-    # ======================================================================= #
-    # Get the local path to the latest linux kernel next.
-    # ======================================================================= #
-    program_path = _.program_path?
-    # ======================================================================= #
-    # Designate which prefix is to be used next:
-    # ======================================================================= #
-    case use_this_prefix
-    when :appdir_prefix,
-         :default
-      use_this_prefix = _.prefix?
-    end
-    extract_to = _.extract_to?
-    extract_what_to(program_path, extract_to) { :keep_the_old_directory_if_it_exists }
-    rcp _.program_name_and_program_version?
-    target = extract_to+_.program_name_and_program_version?
-    opne 'Now changing into '+sdir(target)+'.'
-    cd target
-    esystem 'make mrproper'
-    esystem 'make headers'
-    if File.exist? 'usr/include/Makefile'
-      remove_file 'usr/include/Makefile'
-    end
-    opne 'We are in the directory '+sdir(target)+'.'
-    opne 'Doing a '+steelblue('recursive copy action')+rev+' next.'
-    cpr('usr/include/', use_this_prefix)
-    opne 'Done! The target was at '+sdir(use_this_prefix+'include/')
-  end
-
-  # ========================================================================= #
-  # === package_this_appdir
-  #
-  # Invocation example:
-  #
-  #   ry --package-appdir=htop
-  #
-  # ========================================================================= #
-  def package_this_appdir(i)
-    target = programs_dir?+i.capitalize+'/Current'
-    if File.exist?(target) and File.symlink?(target)
-      old_pwd = return_pwd
-      initialize_dataset_for(i)
-      cd target
-      use_this_as_the_archive_name = i.downcase+'-'+program_version?
-      to_tar_xz("#{target}*") {{
-        use_this_archive_name: use_this_as_the_archive_name
-      }}
-      full_target = target+use_this_as_the_archive_name
-      if File.exist? full_target
-        mv(full_target, old_pwd)
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === package_rbt_scripts                        (package tag, release tag)
-  #
-  # You can use this method to package the RBT scripts.
-  #
-  # A specialized class will do this for us, class PackageRbtScripts.
-  #
-  # Invocation examples:
-  #
-  #   ry --package_rbt_scripts
-  #   ry --release
-  #
-  # ========================================================================= #
-  def package_rbt_scripts(
-      also_exit = false
-    )
-    unless RBT.const_defined? :PackageRbtScripts
-      require 'rbt/utility_scripts/package_rbt_scripts.rb'
-    end
-    RBT::PackageRbtScripts.new
-    also_exit = true if also_exit == :then_exit
-    exit_program if also_exit
-  end
-
-  # ========================================================================= #
-  # === add_package_user
-  #
-  # This allows you to add a package-user.
-  #
-  # Usage example:
-  #
-  #   ry htop add_package_user
-  #
-  # ========================================================================= #
-  def add_package_user(
-      name = compile_which_program?
-    )
-    _ = '/Users/Packages/'
-    cmd_to_run = 'useradd -m -d '+_+name.capitalize+' '+name
-    create_directory _ unless File.directory? _
-    opne "Adding a new user called `#{simp(name)}`:"
-    custom_system cmd_to_run
-  end
-
-  # ========================================================================= #
-  # === get_packages
-  #
-  # Get all packages from the directory /Depot/Packages and compare
-  # them to our given request.
-  #
-  # I am no longer making heavy use of Packages but perhaps one day
-  # I may extend it, so this is one reason why it is kept.
-  # 
-  # Invoke it like so:
-  #
-  #   ry php pgk?
-  #
-  # ========================================================================= #
-  def get_packages(
-      this_program = compile_which_program?
-    )
-    this_program = this_program.first if this_program.is_a? Array
-    packages_dir = packages_directory? # This constant is defined in Configuration.rb
-    opnn
-    e "Searching packages for `#{simp(this_program)}` matches now inside "\
-      "#{sdir(packages_dir)}."
-    _ = get_files_from(packages_dir, true)
-    if _
-      result = _.grep(/#{this_program}/i)
-      pp result
-      return result
-    else
-      opnn
-      e "Unfortunately we did not find any match in `#{sdir(packages_dir)}`."
-    end
-  end
-
-  # ========================================================================= #
-  # === automatically_create_package?
-  # ========================================================================= #
-  def automatically_create_package?
-    RBT.automatically_create_package?
-  end
-
-  # ========================================================================= #
-  # === return_build_systems_priorities
-  # ========================================================================= #
-  def return_build_systems_priorities
-    load_yaml(FILE_BUILD_SYSTEMS_PRIORITIES)
-  end
-
-  # ========================================================================= #
-  # === update_libraries_of_this_program
-  #
-  # Invocation examples:
-  #
-  #   rbt --update-libraries-of=poppler
-  #   rbt --update-libraries-of=htop
-  #   rbt --update-libraries-of=xinelib
-  #
-  # ========================================================================= #
-  def update_libraries_of_this_program(i)
-    these_libraries = RBT.infer_these_libraries_will_be_installed_by(i)
-    # ======================================================================= #
-    # Now that we have obtained the libraries we can add it to our
-    # .yml file. Note that this will always overwrite any other existing
-    # entry, so the first step is to get rid of any old entries, before
-    # adding the new entries.
-    # ======================================================================= #
-    path   = find_this_yaml_file(i)
-    string = read_file_in_default_encoding(path)
-    if is_on_roebe?
-      opne 'Creating a backup of the file first.'
-      backup_directory_at = log_dir?+'backup/'
-      mkdir(backup_directory_at) unless File.directory?(backup_directory_at)
-      # ===================================================================== #
-      # We will copy the old file, so that we could re-use it if we need to.
-      # ===================================================================== #
-      opnn; copy_file(
-              path,
-              backup_directory_at+File.basename(path),
-              :be_verbose
-            )
-    end
-    if string.include? ' libraries:'
-      if is_on_roebe?
-        # =================================================================== #
-        # Notify only me on my home system in this case, as most users
-        # won't need this information here really.
-        # =================================================================== #
-        opne "#{tomato('Removing')} the old #{slateblue('libraries:')} entries first."
-        new_string = ''.dup
-        state_is_open = false
-        string.split(N).each {|line|
-          if line.include? ' libraries:'
-            state_is_open = true
-          else
-            # =============================================================== #
-            # Toggle it unless the next line starts with a ' - '.
-            # =============================================================== #
-            unless line.start_with?(' - ')
-              state_is_open = false
-            end
-          end
-          unless state_is_open
-            new_string << line << N
-          end
-        }
-        string = new_string # And re-assign it here.
-      end
-    end
-    # ======================================================================= #
-    # Ok, now we can find the proper position and simply add the libraries.
-    # We will first check for a "homepage:" String; then "url2:" and
-    # then "url1:". These are our "anchors".
-    # ======================================================================= #
-    if these_libraries.empty?
-      opne 'Can not store anything because no libraries could be found.'
-    else
-      append_this_string = ' libraries:'+N+' - '+these_libraries.join(N+' - ')+N
-      splitted = string.split(N)
-      array = []
-      if string.include? ' homepage: '
-        splitted.each {|line|
-          if line.include? ' homepage: '
-            array << line+N+append_this_string
-          else
-            array << "#{line}#{N}"
-          end
-        }
-      elsif string.include? 'url2: '
-        splitted.each {|line|
-          if line.include? ' url2: '
-            array << line+N+append_this_string
-          else
-            array << "#{line}#{N}"
-          end
-        }
-      elsif string.include? 'url1: '
-        splitted.each {|line|
-          if line.include? ' url1: '
-            array << line+N+append_this_string
-          else
-            array << "#{line}#{N}"
-          end
-        }
-      else
-        opne 'Can not anchor it as no string '\
-             'called '+slateblue('homepage:')+
-             ':, '+slateblue('url2:')
-        opne 'or '+slateblue('url1:')+' could be found.'
-      end
-      what = array.join.chomp
-      # ===================================================================== #
-      # Next update the old content.
-      # ===================================================================== #
-      into = path
-      opne 'Next overwriting the file `'+sfile(into)+'`.'
-      write_what_into(what, into)
-      if is_on_roebe?
-        # =================================================================== #
-        # Also auto-updating the rbt project.
-        # =================================================================== #
-        opne 'Since we are on roebe we will also auto-update the '\
-             'rbt project next.'
-        cd RUBY_SRC_DIR_AT_HOME+'rbt/'
-        require 'roebe/toplevel_methods/rinstall2.rb'
-        Roebe.rinstall2
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === verbose_md5_checking
-  #
-  # Use this method to do md5-checksum checking.
-  # ========================================================================= #
-  def verbose_md5_checking
-    _ = program_path?
-    opne sfancy('The md5sum of `')+simp(program_name?)+
-         sfancy('` in `')+sfile(_)+sfancy('` is:')
-    opne simp('  '+return_md5(_)) # This method is defined here.
-  end
-
-  # ========================================================================= #
-  # === disable_md5sum_calculation
-  #
-  # This method here can be used to disable the md5sum calculation
-  # altogether.
-  #
-  # Invocation example:
-  #
-  #   ry htop --no-md5sum
-  #
-  # ========================================================================= #
-  def disable_md5sum_calculation
-    opne 'We will not calculate the md5sum of an archive. This '\
-         'should speed up'
-    opne 'things a little bit, in particular for very large files.'
-    RBT::Cookbooks::SanitizeCookbook.disable_md5sum_calculation # Cookbooks::Cookbook must provide this method.
-  end
-
-  # ========================================================================= #
-  # === use_url
-  #
-  # Usage example:
-  #
-  #   ry ffmpeg use_url
-  #
-  # ========================================================================= #
-  def use_url
-    dataset?.program_name = 'USE_URL' # RBT::Cookbooks::SanitizeCookbook will handle this call.
-  end
-
-  # ========================================================================= #
-  # === do_not_compile?
-  # ========================================================================= #
-  def do_not_compile?
-    @internal_hash[:do_not_compile]
-  end
-
-  # ========================================================================= #
-  # === update_this_entry
-  # ========================================================================= #
-  def update_this_entry(i)
-    require 'rbt/requires/require_class_update_entry.rb'
-    RBT::UpdateEntry.new(i)
-  end
-
-  # ========================================================================= #
-  # === consider_making_use_of_cookbook_aliases
-  # ========================================================================= #
-  def consider_making_use_of_cookbook_aliases
-    unless make_use_of_cookbook_aliases? == :user_disabled_this_setting_via_the_commandline
-      @internal_hash[:make_use_of_cookbook_aliases] = true
-    end
-  end
-
-  # ========================================================================= #
-  # === honour_check_to_ensure_that_the_program_exists?
-  # ========================================================================= #
-  def honour_check_to_ensure_that_the_program_exists?
-    @internal_hash[:honour_check_to_ensure_that_the_program_exists] # This is true by default.
-  end
-
-
-  # ========================================================================= #
-  # === run_preinstall_sed_and_currently_being_compiled
-  # ========================================================================= #
-  def run_preinstall_sed_and_currently_being_compiled
-    run_preinstall_actions
-    check_for_sed_action
-    register_that_this_program_is_currently_being_compiled
-  end
-
-  require 'rbt/misc/create_and_populate_pkgconfig_directory.rb'
-  # ========================================================================= #
-  # === consider_creating_and_populating_the_pkgconfig_directory
-  # ========================================================================= #
-  def consider_creating_and_populating_the_pkgconfig_directory
-    if uses_an_appdir_prefix?
-      CreateAndPopulatePkgconfigDirectory.new(appdir_prefix?)
-    end
-  end
-
-  # ========================================================================= #
-  # === do_compile_libstdc_plus_plus
-  #
-  # This method will compile/install libstdc++, which is part of GCC.
-  #
-  # To invoke this method try:
-  #
-  #   ry --install-libstdc++
-  #
-  # ========================================================================= #
-  def do_compile_libstdc_plus_plus
-    set_compile_these_programs :gcc
-    opne steelblue('libstdc++')+', from GCC, will be installed next.'
-    opne royalblue('1')+') The GCC-archive of GCC will be extracted first.'
-    dataset = return_dataset_for_this_program(compile_which_program?)
-    path = dataset.path?
-    gcc_version = dataset.program_version?
-    if File.exist? path
-      opne 'Extracting '+sfile(path)+' to '+sdir(log_dir?)+'.'
-      extract_what_to(path, log_dir?)
-      # ===================================================================== #
-      # cd into the right target:
-      # ===================================================================== #
-      target = log_dir?+cookbook_dataset_program_name_and_program_version?+'/libstdc++-v3/'
-      opne royalblue('2')+') cd to the target directory at '+sdir(target)+' next.'
-      cd(target)
-      opne royalblue('3')+') create the build directory, then cd into it next.'
-      mkdir 'BUILD_DIRECTORY'
-      cd 'BUILD_DIRECTORY'
-      opne royalblue('4')+') Running configure, then "make", then "make install" next.'
-      # ===================================================================== #
-      # Find out the prefix that we wish to use (required for a cd-action
-      # lateron.
-      # ===================================================================== #
-      use_this_prefix = rds(
-        programs_dir?+'Libstdc++/'+gcc_version+'/'
-      )
-      cmd = (
-        '../configure '\
-        '--prefix='+use_this_prefix+'
-        --disable-multilib 
-        --disable-nls 
-        --disable-libstdcxx-threads 
-        --disable-libstdcxx-pch'
-      ).squeeze(' ').gsub(/\n/,' ').squeeze(' ')
-      e
-      e steelblue(cmd)
-      e
-      esystem cmd
-      run_make_then_make_install
-      RBT.to_current(use_this_prefix)
-      cd use_this_prefix
-      rnsymc
-    end
-  end
-
-  # ========================================================================= #
-  # === consider_using_this_file_for_the_configure_options_that_are_to_be_used
-  #
-  # The argument to this method should be the file that contains the
-  # configure-options.
-  # ========================================================================= #
-  def consider_using_this_file_for_the_configure_options_that_are_to_be_used(
-      this_file
-    )
-    if File.exist? this_file
-      opne 'Making use of the file '+sfile(this_file)+' for configure-options.'
-      dataset = File.read(this_file).strip.tr("\n", ' ').squeeze(' ')
-      opne 'The options are:'
-      e
-      e sfancy("  #{dataset}")
-      e
-      clear_configure_options
-      @internal_hash[:configure_options] = dataset
-    else
-      opnn; no_file_exists_at(this_file)
-    end
-  end
-
-  # ========================================================================= #
-  # === do_upgrade_from_this_file
-  #
-  # This method can be used to read input from a file, in order to
-  # determine which programs are to be compiled.
-  # ========================================================================= #
-  def do_upgrade_from_this_file(i)
-    case i # case tag
-    when :default, :def
-      i = 'these_programs_can_be_upgraded.yml'
-    end
-    if File.exist? i
-      if i.end_with? '.yml'
-        dataset_to_use = load_yaml(i)
-      else
-        dataset_to_use = File.readlines(i).map {|line| line.strip }
-      end
-      _ = dataset_to_use
-      _ = _.join(', ') if _.is_a? Array
-      opne "We will use this dataset: #{slateblue(_)}"
-      set_compile_these_programs(dataset_to_use)
-    else
-      opne "No file called #{sfile(i)} appears to exists."
-    end
-  end
-
-  # ========================================================================= #
-  # === cd_to_the_extracted_archive
-  #
-  # This method can be used to quickly cd to the extracted archive.
-  #
-  # This assumes that:
-  #
-  #   (a) the archive exists
-  #   (b) the archive has been extracted to its designated target
-  #
-  # ========================================================================= #
-  def cd_to_the_extracted_archive
-    target = "#{extract_to_this_directory?}#{program_name_and_program_version?}"
-    cd target
-  end
-
-  # ========================================================================= #
-  # === enable_everything_for_the_current_compilation_run
-  #
-  # Note that currently we will only work on the "--enable*" entries.
-  #
-  # Invocation example:
-  #
-  #   ry ncurses ntrad --enable-everything --dontsymlink
-  #
-  # ========================================================================= #
-  def enable_everything_for_the_current_compilation_run
-    default_extract_step(
-      use_this_local_path: cookbook_dataset?.program_path?
-    )
-    cd_to_the_extracted_archive
-    e 'running ./configure help ...'
-    cmd = './configure --help'
-    result = `#{cmd}`
-    array = result.split(N)
-    # ======================================================================= #
-    # Entries may look like this:
-    #
-    #    --enable-symlinks       make tic use symbolic links not hard links\n" +
-    #    --with-x11-rgb=FILE   file containing X11 rgb information (EPREFIX/lib/X11/rgb.txt)\n" +
-    #
-    # ======================================================================= #
-    selection = array.select {|line|
-      splitted = line.split(' ')
-      line.start_with?('  --enable-') and
-      (splitted[0].downcase == splitted[0]) # <- This checks for all-downcase.
-      # ^^^ exclude entries such as "--enable-FEATURE[=ARG]"
-    }
-    selection = selection.map {|entry|
-      entry.split(' ').first.to_s
-    }.join(' ').strip
-    clear_configure_options
-    append_this_to_the_configure_options(selection)
-  end
-
-  # ========================================================================= #
-  # === install_the_dependencies_of_this_program
-  #
-  # Invocation example:
-  #
-  #   ry rails --install-its-dependencies
-  #
-  # ========================================================================= #
-  def install_the_dependencies_of_this_program(
-      this_program = compile_which_program?
-    )
-    # ======================================================================= #
-    # First obtain the direct-dependencies of the given program at hand.
-    # ======================================================================= #
-    dependencies = required_deps_on?
-    e
-    opne 'Next, installing the '+orange(dependencies.size.to_s)+
-         ' dependencies of the program `'+
-          sfancy(this_program)+'`.'
-    e
-    opne 'These programs are:'
-    e
-    dependencies.each {|this_entry|
-      e slateblue(" #{this_entry}")
-    }
-    e
-    dependencies.each {|this_entry|
-      install_that_program = true
-      # ===================================================================== #
-      # Consider skipping a few of these programs.
-      # ===================================================================== #
-      case this_entry
-      when 'python'
-        target = "#{programs_directory?}Python/Current/bin/python"
-        if File.exist? target
-          install_that_program = false
-          e "Skipping python as it is already installed at #{sfancy(target)}."
-        end
-      when 'ruby'
-        target = "#{programs_directory?}Ruby/Current/bin/ruby"
-        if File.exist? target
-          install_that_program = false
-          e "Skipping ruby as it is already installed at #{sfancy(target)}."
-        end
-      end
-      if install_that_program
-        # =================================================================== #
-        # We ought to not quit after a rubygem has been installed.
-        # =================================================================== #
-        _ = RBT::Compile.new(this_entry, :do_not_run_yet)
-        _.do_not_exit_after_a_rubygem_has_been_installed
-        _.run
-      end
-    }
-  end
-
-  # ========================================================================= #
-  # === compile_all_of_gstreamer
-  #
-  # This entry point allows us to compile all of gstreamer.
-  #
-  # To invoke this, try something like:
-  #
-  #    ry --gstreamer1
-  #
-  # ========================================================================= #
-  def compile_all_of_gstreamer
-    e 'Now compiling the various '+steelblue('gstreamer components')+'.'
-    array = %i(
-      gstreamer
-      gstreamerpluginsbase
-      gstpluginsgood
-      gstpluginsbad
-    )
-    do_compile_these_programs(array)  
-  end
-
-  # ========================================================================= #
-  # === return_program_based_on_this_binary
-  # ========================================================================= #
-  def return_program_based_on_this_binary(i)
-    RBT::Cookbooks::RegisteredBinaries.search_for_this_program(i) { :be_quiet }
-  end
-
-  # ========================================================================= #
-  # === is_this_a_registered_binary?
-  # ========================================================================= #
-  def is_this_a_registered_binary?(i)
-    i != return_program_based_on_this_binary(i)
-  end
-
-  # ========================================================================= #
-  # === save_into_compiled_programs
-  #
-  # This method will try to save a lot of useful data into a file
-  # called "compiled_programs.yml".
-  #
-  # That way we can try to figure out what happened at any moment
-  # in time (hopefully).
-  #
-  # The variable full_configure_command will store the full configure
-  # command, whereas configure_options only shows the part afterwards,
-  # such as which parts to enable or disable and so forth.
-  #
-  # This should also store ARCH info and such.
-  # ========================================================================= #
-  def save_into_compiled_programs(
-      store_into = FILE_COMPILED_PROGRAMS
-    )
-    what  = ''.dup # Need a non-frozen String.
-    what << '# --- '+program_name?+N
-    what << program_name?+':'+N
-    what << ' CFLAGS: '+cflags?.to_s+N
-    what << ' compiled_at: '+today?.to_s+', '+current_hour?+N
-    what << ' prefix: '+real_prefix?.to_s+N
-    what << ' full_configure_command: '+
-            full_configure_command?.to_s+N
-    what << ' configure_options: '+configure_options?.to_s+N
-    what << ' successfully_compiled: true/false'+N # This line here is obviously a stub.
-    what << N # Extra newline - makes reading this file easier.
-    append_what_into(what, store_into)
-  end
-
-  # ========================================================================= #
-  # === rebuild_path
-  # ========================================================================= #
-  def rebuild_path
-    cookbook_dataset?.reassemble_program_path
-  end
-
-  # ========================================================================= #
-  # === attach_program_name_and_program_version
-  # ========================================================================= #
-  def attach_program_name_and_program_version
-    cookbook_dataset?.attach_program_name_and_program_version
-  end
-
-  # ========================================================================= #
-  # === assemble_program_path
-  # ========================================================================= #
-  def assemble_program_path
-    cookbook_dataset?.assemble_program_path
-  end
-
-  # ========================================================================= #
-  # === cookbook_dataset_set_this_archive
-  # ========================================================================= #
-  def cookbook_dataset_set_this_archive(i)
-    cookbook_dataset?.set_this_archive(i)
-  end
-
-  # ========================================================================= #
-  # === chop_off_revision_number
-  # ========================================================================= #
-  def chop_off_revision_number
-    cookbook_dataset?.chop_off_revision_number
-  end
-
-  # ========================================================================= #
-  # === empty_archive_type
-  #
-  # This will clear the archive type.
-  # ========================================================================= #
-  def empty_archive_type
-    cookbook_dataset?.archive_type = ''
-  end
-
-  # ========================================================================= #
-  # === determine_program_full_name
-  # ========================================================================= #
-  def determine_program_full_name
-    cookbook_dataset?.determine_program_full_name
-  end
-
-  # ========================================================================= #
-  # === assume_default_archive_type
-  # ========================================================================= #
-  def assume_default_archive_type
-    cookbook_dataset?.assume_default_archive_type
-  end
-
-  # ========================================================================= #
-  # === update_program_path
-  # ========================================================================= #
-  def update_program_path
-    cookbook_dataset?.update_program_path
-  end; alias assemble_full_path update_program_path # === assemble_full_path
-
-  # ======================================================================= #
-  # === compile_gcc_with_only_c_and_cpp
-  #
-  # To invoke this method, try:
-  #
-  #   ry gcc --only-c-and-cpp
-  #
-  # ======================================================================= #
-  def compile_gcc_with_only_c_and_cpp
-    initialize_dataset_for(:gcc)
-    clear_configure_options
-    # ===================================================================== #
-    # --disable-multilib is necessary as otherwise it won't work.
-    # ===================================================================== #
-    append_this_to_the_configure_options(
-      '--enable-languages=c,c++ --disable-multilib'
-    )
-  end
-
-  # ========================================================================= #
-  # === do_include_clang_for_the_llvm_compilation
-  #
-  # Here we have to do four steps in particular - extract two
-  # programs into the extracted directory of LLVM.
-  #
-  # The code below is not very elegant and quite hackish; I simply wanted
-  # to finish this on the same day as I had this idea, which was on
-  # 09.09.2020. At a later point this should be cleaned up. 
-  #
-  # Invocation examples:
-  #
-  #   ry llvm --include-clang-for-compilation
-  #   ry llvm --compile-clang
-  #
-  # ========================================================================= #
-  def do_include_clang_for_the_llvm_compilation
-    # ======================================================================= #
-    # First, we must extract LLVM.
-    # ======================================================================= #
-    initialize_dataset_for(:llvm)
-    extracted_to = extract(cookbook_dataset_program_path?)+
-                   cookbook_dataset_program_name_and_program_version?
-    cd extracted_to # cd into that directory.
-    initialize_dataset_for(:clang)
-    extract_what_to(cookbook_dataset_program_path?, return_pwd+'tools')
-    rename(
-      'tools/'+cookbook_dataset_program_name_and_program_version?,
-      'tools/clang'
-    )
-    initialize_dataset_for(:compilerrt)
-    extract_what_to(cookbook_dataset_program_path?, return_pwd+'compiler-rt')
-    # ======================================================================= #
-    # First, we must extract LLVM.
-    # ======================================================================= #
-    initialize_dataset_for(:llvm)
-    create_build_directory_then_cd_into_it
-    set_this_env_variable 'CC=gcc'
-    set_this_env_variable 'CXX=g++'
-    # ======================================================================= #
-    # The next cmake-line is a hack - at a later point we should clean this
-    # up.
-    # ======================================================================= #
-    cmd = 'cmake -DCMAKE_INSTALL_PREFIX='+appdir_prefix?(:llvm)+'
-           -DLLVM_ENABLE_FFI=ON
-           -DCMAKE_BUILD_TYPE=Release
-           -DLLVM_BUILD_LLVM_DYLIB=ON
-           -DLLVM_LINK_LLVM_DYLIB=ON
-           -DLLVM_ENABLE_RTTI=ON
-           -DLLVM_TARGETS_TO_BUILD="host;AMDGPU;BPF"
-           -DLLVM_BUILD_TESTS=ON
-           -Wno-dev -G Ninja ..'.delete(N).
-                                 squeeze(' ')
-    esystem cmd
-    do_run_ninja
-    do_run_ninja_install
-    rnsymc(appdir_prefix?(:llvm))
-    exit_program
-  end
-
-  # ========================================================================= #
-  # === create_the_build_directory
-  # ========================================================================= #
-  def create_the_build_directory(
-      i = DEFAULT_NAME_FOR_THE_BUILD_DIRECTORY
-    )
-    mkdir i
-  end
-
-  # ========================================================================= #
-  # === create_the_build_directory_then_cd_into_it
-  #
-  # Note that we will only cd into the directory if we actually use a
-  # build directory.
-  # ========================================================================= #
-  def create_the_build_directory_then_cd_into_it(
-      i = DEFAULT_NAME_FOR_THE_BUILD_DIRECTORY
-    )
-    if use_build_directory?
-      create_the_build_directory
-      cd i
-    end
-  end; alias create_build_directory_then_cd_into_it create_the_build_directory_then_cd_into_it # === create_build_directory_then_cd_into_it
-
-  # ========================================================================= #
-  # === determine_the_build_system_in_use_and_consider_syncing_this_back_onto_the_cookbook_dataset
-  # ========================================================================= #
-  def determine_the_build_system_in_use_and_consider_syncing_this_back_onto_the_cookbook_dataset
-    _ = build_system?
-    case _
-    when :infer_automatically
-      _ = RBT.infer_build_system
-    end
-    cookbook_dataset?.set_build_system(_)
-  end
-
-  # ========================================================================= #
-  # === return_absolute_path_if_in_build_directory
-  # ========================================================================= #
-  def return_absolute_path_if_in_build_directory
-    if use_build_directory? and 
-       return_pwd.include?(File.basename(use_this_build_directory?))
-      " #{File.absolute_path(return_pwd)}"
-    else
-      ''
-    end
-  end
-
-  # ========================================================================= #
-  # === return_relative_path_if_in_build_directory
-  # ========================================================================= #
-  def return_relative_path_if_in_build_directory
-    if use_build_directory? and return_pwd.include?(File.basename(use_this_build_directory?))
-      ' ..'
-    else
-      ''
-    end
-  end
-
-  # ========================================================================= #
-  # === do_permanently_use_psych
-  #
-  # Use this method if you wish to permanently use psych, rather than
-  # syck.
-  # ========================================================================= #
-  def do_permanently_use_psych
-    opnn; e 'We will use the psych module for yaml-datasets from now on.'
-    opnn; e 'This will be stored in the file '+sfile(FILE_USE_PSYCH_OR_SYCK)
-    write_what_into(YAML.dump(:psych), FILE_USE_PSYCH_OR_SYCK)
-    if is_on_roebe?
-      write_what_into(YAML.dump(:psych),
-        ROEBE_PATH_TO_COOKBOOKS+'yaml/configuration/'+
-        File.basename(FILE_USE_PSYCH_OR_SYCK)
-      )
-    end
-  end
-
-  # ========================================================================= #
-  # === do_permanently_use_syck
-  #
-  # Use this method if you wish to permanently use syck, rather
-  # than psych.
-  # ========================================================================= #
-  def do_permanently_use_syck
-    opnn; e 'We will use the syck module for yaml-datasets from now on.'
-    opnn; e 'This will be stored in the file '+sfile(FILE_USE_PSYCH_OR_SYCK)
-    write_what_into(YAML.dump(:syck), FILE_USE_PSYCH_OR_SYCK)
-    if is_on_roebe?
-      write_what_into(YAML.dump(:syck),
-        ROEBE_PATH_TO_COOKBOOKS+'yaml/configuration/'+
-        File.basename(FILE_USE_PSYCH_OR_SYCK)
-      )
-    end
-  end
-
-  # ========================================================================= #
-  # === batch_validate_the_cookbooks
-  # ========================================================================= #
-  def batch_validate_the_cookbooks
-    unless RBT::Cookbooks.const_defined? :BatchValidateTheCookbookRecipes
-      require 'rbt/checks_and_validations/batch_validate_the_cookbook_recipes.rb'
-    end
-    BatchValidateTheCookbookRecipes.new
-  end
-
-  # ========================================================================= #
-  # === load_and_display_the_allowed_tags
-  # ========================================================================= #
-  def load_and_display_the_allowed_tags(
-      from_this_file = RBT.file_allowed_tags
-    )
-    dataset = YAML.load_file(from_this_file).sort
-    opnn; e 'The following tags are allowed/registered/valid:'
-    dataset.each {|entry|
-      e "  #{simp(entry)}"
-    }
-  end
-
-  # ========================================================================= #
-  # === remove_empty_directories
-  # ========================================================================= #
-  def remove_empty_directories(
-      i = return_pwd
-    )
-    opne "Now trying to remove all empty directories from the directory "\
-         "#{sdir(i)}."
-    require 'rbt/utility_scripts/remove_empty_directories.rb'
-    RBT.remove_empty_directories(i)
-  end
-
-  # ========================================================================= #
-  # === remove_all_temp_directories
-  #
-  # This method will remove all directories in the /Depot/Temp
-  # hierarchy. It was added since it is sometimes easier to just
-  # remove all extracted archives via batch-process.
-  # ========================================================================= #
-  def remove_all_temp_directories
-    _ = rbt_log_dir?
-    # ======================================================================= #
-    # Select all directories in that directory next:
-    # ======================================================================= #
-    all_directories_there = Dir["#{_}*"].select {|entry| File.directory? entry }
-    opne "All #{sfancy(all_directories_there.size.to_s)}"\
-         " directories in the #{sdir(_)} hierarchy will be removed."
-    remove_these_directories(all_directories_there)
-  end
-
-  # ========================================================================= #
-  # === do_use_libdir64
-  #
-  # This method essentially equals to passing the configure 
-  # flag --libdir64 to ./configure.
-  # ========================================================================= #
-  def do_use_libdir64
-    append_this_to_the_configure_options(:libdir64)
-  end
-
-  # ========================================================================= #
-  # === do_use_libdir
-  # ========================================================================= #
-  def do_use_libdir
-    append_this_to_the_configure_options(:libdir)
-  end
-
-  # ========================================================================= #
-  # === configure_has_a_higher_priority_than_meson?
-  #
-  # This method will return true if "configure" has a higher priority
-  # than "meson". A yaml file keeps track of these priorities.
-  # ========================================================================= #
-  def configure_has_a_higher_priority_than_meson?
-    ::RBT.configure_has_a_higher_priority_than_meson?
-  end
-
-  # ========================================================================= #
-  # === do_start_the_sinatra_interface
-  # ========================================================================= #
-  def do_start_the_sinatra_interface
-    require 'rbt/sinatra/app.rb'
-    RBT.run_app
-  end
-
-  # ========================================================================= #
-  # === prepare_for_gcc
-  #
-  # This method can be used to aid in the preparation of compiling a
-  # new GCC from source.
-  # ========================================================================= #
-  def prepare_for_gcc
-    # ======================================================================= #
-    # === gmp
-    # ======================================================================= #
-    initialize_cookbook_dataset_for(:gmp)
-    cp(cookbook_dataset_program_path?, return_pwd) { :be_verbose }
-    extract_what_to(File.basename(cookbook_dataset_program_path?), return_pwd, :keep_the_old_directory_if_it_exists)
-    rename(
-      remove_archive_at_the_end(
-        File.basename(cookbook_dataset_program_path?)
-      ), 'gmp'
-    )
-    # ======================================================================= #
-    # === mpc
-    # ======================================================================= #
-    initialize_cookbook_dataset_for(:mpc)
-    cp(cookbook_dataset_program_path?, return_pwd) { :be_verbose }
-    extract_what_to(File.basename(cookbook_dataset_program_path?), return_pwd, :keep_the_old_directory_if_it_exists)
-    rename(
-      remove_archive_at_the_end(
-        File.basename(cookbook_dataset_program_path?)
-      ), 'mpc'
-    )
-    # ======================================================================= #
-    # === mpfr
-    # ======================================================================= #
-    initialize_cookbook_dataset_for(:mpfr)
-    cp(cookbook_dataset_program_path?, return_pwd) { :be_verbose }
-    extract_what_to(File.basename(cookbook_dataset_program_path?), return_pwd, :keep_the_old_directory_if_it_exists)
-    rename(
-      remove_archive_at_the_end(
-        File.basename(cookbook_dataset_program_path?)
-      ), 'mpfr'
-    )
-  end
-
-  # ========================================================================= #
-  # === copy_source_archive_of_this_program_into_the_current_directory
-  #
-  # This method can be used to copy the source archive of the given
-  # input program at hand, into the current working directory.
-  #
-  # Invocation examples:
-  #
-  #   ry --copy-source=php
-  #   ry --copy-source=ruby
-  #
-  # ========================================================================= #
-  def copy_source_archive_of_this_program_into_the_current_directory(i)
-    _ = load_yaml_dataset_for_this_program(i)
-    stored_where = _.program_path?
-    opne "#{steelblue('=>')} Copying "\
-         "#{sfile(stored_where)} to "\
-         "#{sdir(return_pwd)}#{mediumpurple(File.basename(stored_where))}"
-    copy_file(stored_where, return_pwd)
-  end; alias copy_source copy_source_archive_of_this_program_into_the_current_directory # === copy_source
-
-  # ========================================================================= #
-  # === clear_old_configure_options
-  # ========================================================================= #
-  def clear_old_configure_options
-    set_configure_options('')
-  end
-
-  # ========================================================================= #
-  # === disallow_changing_the_cookbook_dataset
-  # ========================================================================= #
-  def disallow_changing_the_cookbook_dataset
-    cookbook_dataset?.freeze
-  end
-
-  # ========================================================================= #
-  # === update_program_full_name
-  # ========================================================================= #
-  def update_program_full_name
-    cookbook_dataset?.update_program_full_name
-  end
-
-  # ========================================================================= #
-  # === use_default_configure_command
-  #
-  # This method will hard-set the configure command.
-  # ========================================================================= #
-  def use_default_configure_command(
-      i = 'configure'
-    )
-    cookbook_dataset?.configure_command_to_use = i
-  end
-
-  # ========================================================================= #
-  # === return_cmake_configure_options_while_considering_GNU_configure_options
-  #
-  # This method will return the cmake_configure_options, or configure
-  # options. One day this should be changed to ONLY return the
-  # cmake_configure_options, but for the time being we need to
-  # retain compatibility to GNU configure options.
-  # ========================================================================= #
-  def return_cmake_configure_options_while_considering_GNU_configure_options
-    _ = cmake_configure_options?
-    unless _
-      # ===================================================================== #
-      # We default to the configure options for legacy reasons. At
-      # some later point we may have to change all cookbook files,
-      # but for now we won't.
-      # ===================================================================== #
-      _ = configure_options?
-    end
-    _ << return_append_this_to_the_configure_options
-    return _.strip.squeeze(' ')
-  end
-
-  # ========================================================================= #
-  # === return_append_this_to_the_configure_options
-  #
-  # This method will always at the least return an empty String.
-  # ========================================================================= #
-  def return_append_this_to_the_configure_options
-    _ = ''
-    if @internal_hash[:append_this_to_the_configure_options]
-      _ = _.dup if _.frozen?
-      _ << @internal_hash[:append_this_to_the_configure_options]
-    end
-    return _
-  end
-
-  require 'rbt/toplevel_methods/check_for_binary_duplicates.rb'
-  # ========================================================================= #
-  # === do_check_for_binary_duplicates
-  #
-  # If you wish to check for binary-duplicates under /usr/bin/, then
-  # this method may be helpful to you.
-  # ========================================================================= #
-  def do_check_for_binary_duplicates
-    target_dir = :default
-    # ======================================================================= #
-    # The next line of code handles the situation when we are in the
-    # directory /usr/sbin/, and when we are on a roebe-system (aka at home).
-    # ======================================================================= #
-    if is_on_roebe? and (return_pwd == '/usr/sbin/')
-      target_dir = '/usr/sbin/'
-    end
-    array = RBT.array_binary_duplicates(:default, target_dir)
-    if array.empty?
-      target_dir = '/usr/bin/' if target_dir == :default
-      opne "No duplicates appear to exist under the "\
-           "#{sdir(target_dir)} hierarchy."
-    else
-      opne 'The following duplicates were found:'
-      e
-      array.each {|entry|
-        e "  #{sfile(entry.ljust(40))}"
-      }
-    end
-  end
-
-  require 'rbt/toplevel_methods/return_blfs_page_of_this_program.rb'
-  # ========================================================================= #
-  # === return_blfs_page_of_this_program
-  # ========================================================================= #
-  def return_blfs_page_of_this_program(i)
-    RBT.return_blfs_page_of_this_program(i)
-  end
-
-  # ========================================================================= #
-  # === verbose_purge_fhs_libraries_of_this_program
-  #
-  # This method will notify the user as to what will be done, then
-  # delegate towards purge_fhs_libraries_of_this_program().
-  # ========================================================================= #
-  def verbose_purge_fhs_libraries_of_this_program(i)
-    i = RBT.return_alias_program_name_for(i)
-    opne "Now purging all #{mediumspringgreen('lib/')} programs "\
-         "of `#{sfancy(i)}` at the #{sdir('/usr/lib/')}"\
-         " hierarchy."
-    purge_fhs_libraries_of_this_program(i)
-  end
-
-  require 'rbt/utility_scripts/purge_libraries_of_this_program.rb'
-  # ========================================================================= #
-  # === purge_fhs_libraries_of_this_program
-  #
-  # Get rid of all /usr/lib/ libraries of the respective program at
-  # hand.
-  #
-  # Invocation example:
-  #
-  #   ry --fhs-purge-libraries=libgc
-  #
-  # ========================================================================= #
-  def purge_fhs_libraries_of_this_program(
-      i = compile_which_program?
-    )
-    if i.nil?
-      opne 'Please provide a valid program name to this method.'
-      return
-    end
-    PurgeLibrariesOfThisProgram.new(i)
-  end
-
-  # ========================================================================= #
-  # === return_default_hash_to_be_passed_into_colour_make
-  #
-  # This method will return a static hash. This can be overruled,
-  # though, by providing an argument (another hash) to this
-  # method.
-  # ========================================================================= #
-  def return_default_hash_to_be_passed_into_colour_make(
-      optional_input = nil
-    )
-    hash = {
-      use_this_make_command:            use_which_make_command?,
-      append_these_options:             parameters_to_make?,
-      run_make:                         run_make?,
-      run_make_install:                 run_make_install?,
-      use_porg:                         use_porg?,
-      program_name_and_program_version: program_name_and_program_version?
-    }
-    if optional_input
-      hash.update(optional_input)
-    end
-    hash 
-  end
-
-  # ========================================================================= ##
-  # === set_is_an_abbreviation
-  # ========================================================================= #
-  def set_is_an_abbreviation(i = true)
-    @internal_hash[:is_an_abbreviation] = i
-  end
-
-  # ========================================================================= #
-  # === do_install_only_binaries
-  # ========================================================================= #
-  def do_install_only_binaries
-    @internal_hash[:install_only_binaries] = true
-  end
-
-  # ========================================================================= #
-  # === do_not_use_cookbook_aliases
-  # ========================================================================= #
-  def do_not_use_cookbook_aliases(
-      be_verbose = :be_verbose
-    )
-    case be_verbose
-    when true, :be_verbose
-      opne 'Disabling cookbook aliases for this run.'
-    end
-    @internal_hash[:make_use_of_the_cookbook_aliases] = false
-  end
-
-  # ========================================================================= #
-  # === assign_to_the_main_dataset
-  #
-  # This method should be used when we wish to assign to the main
-  # dataset at hand. The expected input should be class
-  # ::RBT::Cookbooks::SanitizeCookbook. If it is not then this will
-  # cause an argument error.
-  #
-  # The second argument to this method can be used to control how
-  # strict the method shall behave.
-  # ========================================================================= #
-  def assign_to_the_main_dataset(
-      i, check_for_stringent_input = true
-    )
-    if check_for_stringent_input
-      unless i.is_a? ::RBT::Cookbooks::SanitizeCookbook
-        raise ArgumentError,
-              'The method assign_to_the_main_dataset() expects input as '\
-              'class RBT::Cookbooks::SanitizeCookbook'
-      end
-      set_on_ihash(:cookbook_dataset, i)
-    end
-  end; alias use_this_as_cookbook  assign_to_the_main_dataset # === use_this_as_cookbook
-       alias use_this_as_cookbook= assign_to_the_main_dataset # === use_this_as_cookbook=
-
-  # ========================================================================= #
-  # === consider_comparing_the_installed_libraries_versus_the_assumed_libraries
-  #
-  # This method will try to compare the installed libraries in an AppDir
-  # with the ones that are registered in the various cookbook .yml files.
-  #
-  # This will happen ONLY if we are on a roebe-system; and ONLY if we
-  # use an AppDir approach.
-  # ========================================================================= #
-  def consider_comparing_the_installed_libraries_versus_the_assumed_libraries
-    if is_on_roebe? and is_an_appdir_installation? and
-      has_been_installed_successfully?
-      assumed_libraries = RBT.infer_these_libraries_will_be_installed_by(
-        compile_which_program?
-      )
-      if assumed_libraries
-        libraries?.each {|this_already_registered_library|
-          # ================================================================= #
-          # The variable this_already_registered_library may be something
-          # like 'libgmodule-2.0.so'.
-          # ================================================================= #
-          if assumed_libraries.any? {|entry|
-              entry.include? this_already_registered_library
-            }
-          else
-            opne "The library "\
-                 "#{orange(this_already_registered_library)}"\
-                 " is not registered."
-            opne 'Consider '+crimson('updating')+' it (file: '+
-                 sfile(compile_which_program?+'.yml')+
-                 ').'
-          end
-        }
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === purge_these_binaries
-  #
-  # This method can be used to purge binaries.
-  # ========================================================================= #
-  def purge_these_binaries(
-      i = binaries?
-    )
-    removed_n_binaries = 0
-    opne "Now attempting to remove #{sfancy(i.size.to_s)} binaries:"
-    e
-    i.each {|this_binary|
-      target = "/usr/bin/#{this_binary}"
-      ftype = nil
-      begin
-        ftype = File.ftype(target)
-      rescue Errno::ENOENT; end
-      if File.exist? target
-        e "Deleting the file `#{sfile(target)}` next."
-        remove_file(target)
-        removed_n_binaries += 1
-      else
-        if ftype == 'link'
-          e "Deleting the stray symlink at `#{sfile(target)}` next."
-          remove_symlink(target)
-        end
-      end
-    }
-    e
-    if removed_n_binaries == 0
-      opne 'None of these binaries could be '\
-           'found at '+sdir('/usr/bin/')+'.'
-    end
-  end
-
-  # ========================================================================= #
-  # === try_to_batch_compile_this_stack
-  #
-  # This method can be used to batch-compile several applications.
-  #
-  # Invocation examples:
-  #
-  #   rbt --batch-compile=autotools
-  #   rbt --batch-compile=vid_suite
-  #   rbt --batch-compile=mate
-  #   rbt --batch-compile=kde5_porting_aids
-  # ========================================================================= #
-  def try_to_batch_compile_this_stack(i)
-    # ======================================================================= #
-    # === Do some sanitizing of the input first.
-    # ======================================================================= #
-    case i
-    # ======================================================================= #
-    # === rbt --batch-compile=phonon
-    # ======================================================================= #
-    when 'phonon',
-         /^kde(_|-)?plasma/
-      i = 'kde5_plasma'
-    # ======================================================================= #
-    # === rbt --batch-compile=kde_apps
-    # ======================================================================= #
-    when /^kde(_|-)?apps/
-      i = 'kde5_applications'
-    # ======================================================================= #
-    # === rbt --batch-compile=protos
-    # ======================================================================= #
-    when 'protos'
-      i = 'xorg_protos'
-    end
-    case i # case tag
-    # ======================================================================= #
-    # === rbt --batch-compile=kde5_porting_aids
-    # ======================================================================= #
-    when /^kde5?(_|-)?porting(_|-)?aids?$/i,
-         /^porting(_|-)?aids?$/i
-      i = return_kde5_porting_aids
-    # ======================================================================= #
-    # === rbt --batch-compile=mate
-    # ======================================================================= #
-    when 'mate',
-         /^mate(-|_)?desktop$/
-      i = RBT.returned_chained_programs_of_the_mate_desktop
-      opne "We will compile all #{sfancy(i.size.to_s)} programs "\
-           "of the mate-desktop."
-      opne 'These include:'
-      e; i.each {|entry|
-        e '  - '+sfancy(entry)
-      }; e
-    else
-      hash = return_chained_programs
-      i = hash[i]
-    end
-    if i.is_a? String and i.include? ','
-      i = i.split(',').map(&:strip).flatten # Now it should be an Array.
-    end
-    if i.is_a? Array
-      i.map! {|entry| entry.delete('-') }
-    end
-    return i
-  end
-
-  # ========================================================================= #
-  # === do_not_try_to_autofix
-  #
-  # This method will specifically disable any attempts to try to autofix
-  # libtool-related problems. It is currently silent, all of the time.
-  # ========================================================================= #
-  def do_not_try_to_autofix
-    @internal_hash[:try_to_autofix] = false
-  end
-
-  # ========================================================================= #
-  # === ensure_that_the_cookbook_dataset_is_there
-  # ========================================================================= #
-  def ensure_that_the_cookbook_dataset_is_there(
-      i = compile_which_program?
-    )
-    if cookbook_dataset?.nil?
-      initialize_dataset_for(i)
-    end
-  end
-
-  # ========================================================================= #
-  # === do_create_a_slackware_package
-  # ========================================================================= #
-  def do_create_a_slackware_package(i = return_pwd)
-    require 'rbt/linux/slackware/create_slackware_package.rb'
-    this_program = File.basename(i)
-    if this_program.include? '-'
-      this_program = program_information_return_name(this_program)
-    end
-    RBT::CreateSlackwarePackage.new(this_program) { :do_not_autoinstall }
-  end
-
-  # ========================================================================= #
-  # === verbose_generate_the_pdf_tutorial
-  # ========================================================================= #
-  def verbose_generate_the_pdf_tutorial
-    opne 'We will generate a .pdf file next which will contain the'
-    opne 'instructions on how to use the RBT project.'
-    RBT.generate_pdf_tutorial
-  end
-
-  # ========================================================================= #
-  # === update_binary_names
-  #
-  # To invoke this method, try:
-  #
-  #   ry htop update_binary_names
-  #   ry --update-binary-names
-  #
-  # ========================================================================= #
-  def update_binary_names(
-      also_exit = false
-    )
-    also_exit = true if also_exit == :then_exit
-    require 'rbt/registered/registered_binaries.rb'
-    RBT::Cookbooks::RegisteredBinaries.new
-    exit_program if also_exit
-  end
-
-  # ========================================================================= #
-  # === return_random_program
-  # ========================================================================= #
-  def return_random_program
-    return_available_programs.sample
-  end
-
-  # ========================================================================= #
-  # === create_description_file
-  #
-  # Creates a Description file, for use in Gobolinux systems.
-  # ========================================================================= #
-  def create_description_file(create_where)
-    if create_where.include? programs_directory?
-      create_where = create_where.delete('-')
-    end
-    file_location = create_where+'Resources/Description'
-    remove_file(file_location) if File.exist? file_location # Remove it if it already exists.
-    append_what_into(
-      dataset?.description?,
-      file_location
-    )
-  end
-
-  # ========================================================================= #
-  # === check_for_inclusion
-  #
-  # We will check the source directory for program-inclusion.
-  #
-  # To invoke this method, try something like this:
-  #
-  #    ry htop --check_for_inclusion
-  #
-  # ========================================================================= #
-  def check_for_inclusion
-    RBT::Cookbooks::CheckForInclusion.new # bl $RUBY_COOKBOOKS/lib/cookbooks/check_for_inclusion.rb
-  end
-
-  # ========================================================================= #
-  # === verbose_enable_porg
-  # ========================================================================= #
-  def verbose_enable_porg
-    opne 'We will use the program "'+plum('porg')+
-         '" for the "make install" step.'
-    enable_porg
-  end
-
-  require 'rbt/linux/slackware/generate_slack_desc_file.rb'
-  # ========================================================================= #
-  # === generate_slack_desc_file_for_this_program
-  #
-  # Trigger like so:
-  #
-  #   rbt htop --gsc
-  #
-  # ========================================================================= #
-  def generate_slack_desc_file_for_this_program(
-      i = compile_which_program?
-    )
-    path_to_this_file = RBT.generate_slackware_description_file(i)
-    return path_to_this_file
-  end; alias create_slackware_description_file generate_slack_desc_file_for_this_program # ===  create_slackware_description_file
-
-  # ========================================================================= #
-  # === enable_stow
-  #
-  # This method will enable stow.
-  # ========================================================================= #
-  def enable_stow
-    configuration?.use_stow = true
-    opne 'Enabling stow next.'
-    configuration?.save # And store this.
-  end
-
-  # ========================================================================= #
-  # === disable_stow
-  # ========================================================================= #
-  def disable_stow
-    configuration?.use_stow = false
-    opne 'Disabling stow next.'
-    configuration?.save
-  end
-
-  # ========================================================================= #
-  # === set_delay_before_continuing                               (sleep tag)
-  #
-  # Ensure that the argument passed to us is correct.
-  # ========================================================================= #
-  def set_delay_before_continuing(n_seconds)
-    sleep(n_seconds.to_i)
-  end
-
-  # ========================================================================= #
-  # === generate_slack_desc_files_for_every_program
-  # ========================================================================= #
-  def generate_slack_desc_files_for_every_program
-    target = "#{rbt_log_directory?}slackware_desc_files/"
-    opnn; mkdir target, :be_verbose
-    cd target
-    all_programs?.each {|entry|
-      generate_slack_desc_file_for_this_program(entry)
-    }
-  end
-
-  # ========================================================================= #
-  # === consider_checking_whether_the_compiled_binaries_are_already_registered
-  # ========================================================================= #
-  def consider_checking_whether_the_compiled_binaries_are_already_registered
-    if is_on_roebe? and # ← Only allow this on roebe-systems.
-       is_app_dir? and
-       has_to_be_compiled? and
-       compiled_successfully? and
-       !prefix?.include?('Toolchain') # Make /home/Programs/Toolchain exempt from this.
-      locally_existing_executables = Dir["#{prefix?}bin/*"].map {|entry|
-        File.basename(entry)
-      }
-      locally_existing_executables << Dir["#{prefix?}sbin/*"].map {|entry|
-        File.basename(entry)
-      }
-      locally_existing_executables.flatten!
-      locally_existing_executables.uniq!
-      registered_binaries = cookbooks_binaries?
-      # ===================================================================== #
-      # Next compare these entries:
-      # ===================================================================== #
-      locally_existing_executables.each {|entry|
-        if registered_binaries.include? entry
-          # In this case all is fine.
-        else
-          compile_this_program = compile_which_program?
-          # ================================================================= #
-          # Else it is a not-registered binary, so report it.
-          # ================================================================= #
-          cliner
-          opne crimson('The entry ')+steelblue(entry)+
-               crimson(' is not a registered')
-          opne crimson('binary for the program ')+
-               royalblue(compile_this_program)+
-               crimson('.')
-          opne olivedrab('^^^ Consider changing this. ^^^')
-          cliner
-          # ================================================================= #
-          # Since as of 09.12.2019 we will also store this result into a
-          # log file.
-          # ================================================================= #
-          what = "#{entry} belongs to the program called "\
-                 "#{rarrow?} #{compile_this_program}"
-          into = "#{log_dir?}these_binaries.yml"
-          opne 'Storing '+steelblue(entry)+' into the file '+sfile(into)+
-               ' as well.'
-          append_what_into("#{what}#{N}", into)
-        end
-      }
-    end
-  end
-
-  # ========================================================================= #
-  # === generate_machomebrew_formula
-  #
-  # This method will generate a (hopefully valid) Homebrew script.
-  #
-  # Commandline-invocation example:
-  #
-  #   ry htop --generate_homebrew_script
-  #
-  # ========================================================================= #
-  def generate_machomebrew_formula(
-      i = compile_which_program?
-    )
-    RBT::GenerateMachomebrewFormula.new(i)
-  end; alias generate_homebrew_script generate_machomebrew_formula # === generate_homebrew_script
-
-  # ========================================================================= #
-  # === show_registered_keys
-  #
-  # This delegates towards the Register class.
-  # ========================================================================= #
-  def show_registered_keys
-    RBT::RegisterProgramFilesIntoYamlDatabase.show_registered_keys
-  end
-
-  # ========================================================================= #
-  # === do_not_create_the_appdir_skeleton
-  # ========================================================================= #
-  def do_not_create_the_appdir_skeleton
-    @internal_hash[:create_appdir_skeleton] = false
-  end
-
-  require 'rbt/utility_scripts/expand_cookbooks.rb'
-  # ========================================================================= #
-  # === do_expand_the_cookbooks
-  # ========================================================================= #
-  def do_expand_the_cookbooks
-    ::RBT.expand_cookbooks(:all_of_them)
-  end
-
-  require 'rbt/cookbooks/check_for_existing_source_directories.rb'
-  # ========================================================================= #
-  # === check_if_source_directories_exist
-  # ========================================================================= #
-  def check_if_source_directories_exist
-    RBT.check_if_source_directories_exist
-  end
-
-  # ========================================================================= #
-  # === update_program_name
-  # ========================================================================= #
-  def update_program_name
-    cookbook_dataset?.update_program_name
-  end
-
-  # ========================================================================= #
-  # === last_error_line?
-  # ========================================================================= #
-  def last_error_line?
-    sys_command_string?.last
-  end
-
-  # ========================================================================= #
-  # === run_through_the_registered_problems
-  #
-  # Sync the problems towards class RBT::Compile next.
-  # ========================================================================= #
-  def run_through_the_registered_problems
-    RBT::Errors::MapLineToASpecificError.registered_problems?.each {|do_this_action|
-      problem_is do_this_action
-    }
-  end
-
-  # ========================================================================= #
-  # === run_through_the_behaviour_changes
-  #
-  # We run through the module that keeps track of the behaviour
-  # changes that out to be run in class RBT::Compile.
-  # ========================================================================= #
-  def run_through_the_behaviour_changes
-    RBT::Errors::MapLineToASpecificError.behaviour_changes?.each {|do_this_action|
-      self.send(do_this_action)
-    }
-  end
-
-  # ========================================================================= #
-  # === run_through_the_required_dependencies
-  #
-  # We have to sync the dependencies back into class RBT::Compile.
-  # ========================================================================= #
-  def run_through_the_required_dependencies
-    RBT::Errors::MapLineToASpecificError.required_dependency?.each {|this_array|
-      register_required_dependency(this_array.first, this_array.last)
-    }
-  end
-
-  # ========================================================================= #
-  # === run_through_the_registered_problems_registered_errors_and_behaviour_changes
-  # ========================================================================= #
-  def run_through_the_registered_problems_registered_errors_and_behaviour_changes
-    run_through_the_registered_problems
-    run_through_the_registered_errors
-    run_through_the_behaviour_changes
-    run_through_the_erroneous_libtool_entries
-    run_through_the_required_dependencies
-  end
-
-  # ========================================================================= #
-  # === check_for_latest
-  #
-  # Method-Wrapper over class LocalCheckForLatest.
-  #
-  # Invocation example:
-  #
-  #   ry --checkforlatest
-  #
-  # ========================================================================= #
-  def check_for_latest
-    require 'rbt/cookbooks/local_check_for_latest.rb'
-    RBT::Cookbooks::LocalCheckForLatest.new # bl $RUBY_COOKBOOKS/lib/cookbooks/local_check_for_latest.rb
-  end
-
-  # ========================================================================= #
-  # === a_or_an?
-  #
-  # For proper english titles, we can use "a" or "an".
-  # ========================================================================= #
-  def a_or_an?(i)
-    if i.start_with?('a','i','o','u')
-      'an'
-    else
-      'a'
-    end
-  end
-
-  # ========================================================================= #
-  # === symlink_the_available_gir_files_into_this_target_directory
-  #
-  # This is the "action" method, that is the method that will symlink
-  # all .gir files into the given target directory at hand.
-  # ========================================================================= #
-  def symlink_the_available_gir_files_into_this_target_directory(
-      target_directory = :default_target
-    )
-    case target_directory
-    when :default_target
-      target_directory = '/usr/share/gir-1.0/'
-    end
-    gir_files?.each {|this_file|
-      original_and_existing_gir_file = "#{prefix?}share/gir-1.0/#{this_file}"
-      target_file = "#{target_directory}#{this_file}"
-      if File.exist?(target_file) and target_file.end_with?('.gir')
-        delete_file(target_file)
-      end
-      symlink(original_and_existing_gir_file, target_file)
-    }
-  end
-
-  # ========================================================================= #
-  # === generate_new_cookbook
-  #
-  # This method can be used to generate a new cookbook file. It is no
-  # longer that useful, but retained mostly for legacy reasons.
-  #
-  # To generate a new cookbook, do:
-  #
-  #   ry htop ---generate_new_cookbook
-  #
-  # ========================================================================= #
-  def generate_new_cookbook(
-      shall_we_exit = true
-    )
-    opne 'Will generate a new cookbook file, as instructed.'
-    RBT::Cookbooks::CreateNewCookbook.new # bl $RUBY_COOKBOOKS/new_cook*
-    exit_program if shall_we_exit
-  end
-
-  # ========================================================================= #
-  # === create_yaml_file_for_this_program
-  # ========================================================================= #
-  def create_yaml_file_for_this_program(
-      i = compile_which_program?
-    )
-    require 'rbt/utility_scripts/expand_cookbooks.rb'
-    e
-    opnn; RBT.expand_this_cookbook(i)
-    e
-  end; alias expand_this_cookbook create_yaml_file_for_this_program # === expand_this_cookbook
-
-  # ========================================================================= #
-  # === copy_headers_from
-  #
-  # This method will copy the registered headers from the given program
-  # at hand.
-  #
-  # The first argument to this method is the path to the header files.
-  #
-  # Invocation examples:
-  #
-  #   ry glibc --copy-headers-from=/usr/include
-  #   ry glibc --copy-headers-to-pwd
-  #
-  # ========================================================================= #
-  def copy_headers_from(i)
-    unless i.end_with? '/'
-      i = i.dup if i.frozen?
-      i << '/'
-    end
-    to = return_pwd 
-    headers = headers?
-    unless headers.empty?
-      headers.each {|this_header|
-        from = "#{i}#{this_header}"
-        if this_header.include? '/'
-          # ================================================================= #
-          # In this case we must create such a subdirectory.
-          # ================================================================= #
-          dirname = File.dirname(this_header)
-          unless File.directory? File.dirname(dirname)
-            mkdir(dirname)
-          end
-        end
-        e 'Now trying to copy `'+sfile(from)+'` to `'+
-          sfile(to+this_header)+'`.'
-        copy_file(from, to+this_header)
-      }
-    end
-  end
-
-  # ========================================================================= #
-  # === copy_these_archives
-  #
-  # This method will copy the selected applications into the current
-  # working directory.
-  #
-  # To invoke this method from the commandline, try:
-  #
-  #   rbt --copy-archives=kde5_plasma
-  #   rbt --copy-archives=ruby
-  #
-  # ========================================================================= #
-  def copy_these_archives(
-      i = :kde5_plasma
-    )
-    if i.is_a? String
-      i = i.split(',') if i.include? ','
-    end
-    case i
-    when :kde5_plasma, 'kde5_plasma'
-      i = return_kde_plasma_components
-    end
-    i = [i].flatten.compact.reject {|entry| entry.strip.empty? }.map {|entry|
-      try_to_find_an_alias_to_this_input_unless_the_program_exists(entry)
-    }
-    if i.empty?
-      opne 'Please provide at the least one argument - the '\
-           'directory that is to be copied.'
-    else
-      opne "Now copying #{i.size.to_s} entries into the local "\
-           "working directory:"
-      i.each {|this_program|
-        target_directory = source_dir?+this_program.downcase+'/'
-        if File.directory? target_directory
-          copy_directory(target_directory, :be_verbose)
-        else
-          opne "No directory exists at `#{sdir(target_directory)}`."
-        end
-      }
-    end
-  end
-
-  # ========================================================================= #
-  # === highest_priority
-  #
-  # This method will return the main build system to use in general,
-  # if possible.
-  # ========================================================================= #
-  def highest_priority?
-    return_build_systems_priorities.first
-  end
-
-  # ========================================================================= #
-  # === symlink_gir_files?
-  # ========================================================================= #
-  def symlink_gir_files?
-    @internal_hash[:symlink_gir_files]
-  end
-
-  # ========================================================================= #
-  # === configuration_setting_for_symlink_gir_files?
-  # ========================================================================= #
-  def configuration_setting_for_symlink_gir_files?
-    RBT.configuration? and 
-    RBT.configuration?.symlink_gir_files
-  end
-
-  # ========================================================================= #
-  # === array_compile_these_programs?
-  # ========================================================================= #
-  def array_compile_these_programs?
-    @array_compile_these_programs
-  end; alias array? array_compile_these_programs? # === array?
-
-  # ========================================================================= #
-  # === configure_command_to_use?
-  # ========================================================================= #
-  def configure_command_to_use?
-    @cookbook.configure_command_to_use?
-  end
-
-  # ========================================================================= #
-  # === returned_the_assumed_program_path
-  # ========================================================================= #
-  def returned_the_assumed_program_path(
-      i = first_argument?
-    )
-    return RBT::Cookbooks::SanitizeCookbook.new(i) { @simple_or_complex }.program_path?
-  end
-
-  # ========================================================================= #
-  # === create_log_directory
-  # ========================================================================= #
-  def create_log_directory
-    ::RBT.action(:create_log_directory)
-  end
-
-  # ========================================================================= #
-  # === mode?
-  # ========================================================================= #
-  def mode?
-    cookbook?.mode?
-  end
-
-  # ========================================================================= #
-  # === enable_non_traditional_compilation
-  #
-  # This will essentially switch to app-dir prefix.
-  # ========================================================================= #
-  def enable_non_traditional_compilation(
-      optional_use_this_as_program_name_and_program_version = 
-        program_name_and_program_version?
-    )
-    if optional_use_this_as_program_name_and_program_version
-      @internal_hash[:prefix].set_program(
-        optional_use_this_as_program_name_and_program_version
-      )
-    end
-    @internal_hash[:prefix].enable_non_traditional_compilation
-  end; alias do_run_via_nontraditional_way enable_non_traditional_compilation # === do_run_via_nontraditional_way
-
-  # ========================================================================= #
-  # === hash?
-  # ========================================================================= #
-  def hash?
-    @cookbook.hash?
-  end
-
-  # ========================================================================= #
-  # === check_for_binary_duplicates_in_this_directory
-  #
-  # This method can be used to check for binary duplicates, aka binaries
-  # that exist more than once on the given system, in the given (passed)
-  # directory.
-  # ========================================================================= #
-  def check_for_binary_duplicates_in_this_directory(
-      i = Dir.pwd
-    )
-    require 'rbt/utility_scripts/check_for_duplicate_binaries.rb'
-    RBT::CheckForDuplicateBinaries.new(Dir.pwd)
-  end
-
-  # ========================================================================= #
-  # === try_to_show_all_binary_duplicates_of_this_program
-  #
-  # Use this method to show which binary duplicates exist for the given
-  # input program.
-  # ========================================================================= #
-  def try_to_show_all_binary_duplicates_of_this_program(
-      i = compile_which_program?
-    )
-    program_name = i
-    if i.nil?
-      opne 'A nil value has been found in '+orange(__method__.to_s)+'.'
-      pp caller()
-    end
-    capitalized_program_name = program_name.capitalize
-    target = programs_directory?+
-             capitalized_program_name+
-             program_name.capitalize+'/Current/bin/*'
-    opne 'Obtaining all files at `'+sdir(target)+'`.'
-    all_binaries = Dir[target]
-    all_binaries.select! {|entry|
-      File.exist? '/usr/bin/'+File.basename(entry)
-    }
-    if all_binaries.empty?
-      opne 'The '+sdir('/usr/bin/')+' hierarchy does not contain '\
-           'any of the binaries'
-      opne "belonging to #{sfancy(program_name)}."
-    else
-      n_duplicates = all_binaries.size.to_s
-      opne "Found #{sfancy(n_duplicates)} binary duplicates."
-      all_binaries.each {|file|
-        e "/usr/bin/#{File.basename(file)}"
-      }
-    end
-  end
-
-  # ========================================================================= #
-  # === generate_homepage
-  #
-  # Generate a LFS-like homepage, which is part of the RBT project,
-  # within the Cookbooks namespace.
-  #
-  # Invocation example:
-  #
-  #   ry --generate-homepage
-  #
-  # ========================================================================= #
-  def generate_homepage
-    require 'rbt/cookbooks/generate_homepage/generate_homepage.rb'
-    RBT::Cookbooks::GenerateHomepage[]
-  end
-
-  # ========================================================================= #
-  # === purge_all_settings_directories
-  # ========================================================================= #
-  def purge_all_settings_directories
-    # ======================================================================= #
-    # We need to avoid entries such as:
-    #
-    #   /home/Programs/Qt/5.14.0/qml/QtQuick/VirtualKeyboard/Settings
-    #
-    # This explains the .count('/') action in the code below.
-    # ======================================================================= #
-    all_settings_directories = Dir[programs_dir?+'**/Settings'].select {|entry|
-      File.directory?(entry) and
-      entry.end_with?('Settings') and
-      (entry.count('/') == 4)
-    }.sort
-    opne 'Next removing '+sfancy(all_settings_directories.size)+' directories.'
-    remove_these_directories(all_settings_directories) { :be_verbose }
-  end
-
-  require 'rbt/toplevel_methods/pin_and_unpin.rb'
-  # ========================================================================= #
-  # === pin_this_program
-  # ========================================================================= #
-  def pin_this_program(i)
-    ::RBT.pin_this_program(i)
-  end
-
-  # ========================================================================= #
-  # === unpin_this_program
-  # ========================================================================= #
-  def unpin_this_program(i)
-    ::RBT.unpin_this_program(i)
-  end
-
-  # ========================================================================= #
-  # === verbose_purge_fhs_binaries_of_this_program
-  #
-  # This method will notify the user as to what will be done, then
-  # delegate towards purge_fhs_binaries_of_this_program().
-  # ========================================================================= #
-  def verbose_purge_fhs_binaries_of_this_program(i)
-    i = [i].flatten.compact
-    i.each {|entry|
-      entry.downcase!
-      opne "Now purging all #{mediumspringgreen('binaries')} of "\
-           "the program `#{sfancy(entry)}`, at the #{sdir('/usr/bin/')}"\
-           " hierarchy."
-      purge_fhs_binaries_of_this_program(entry)
-    }
-  end
-
-  # ========================================================================= #
-  # === purge_fhs_binaries_of_this_program
-  #
-  # This method will purge binaries that may reside at the /usr/bin/
-  # hierarchy. Be careful when using this - only use it when you are
-  # sure that you want this functionality.
-  #
-  # Invocation examples:
-  #
-  #   ry littleutils --purge-fhs-binaries
-  #   ry --purge-traditional-binaries-from=xscreensaver
-  #
-  # ========================================================================= #
-  def purge_fhs_binaries_of_this_program(
-      i = compile_which_program?
-    )
-    if i.nil?
-      opne 'Please provide a valid program name to this method.'
-      return
-    end
-    PurgeBinariesOfThisProgram.new(i.downcase)
-  end
-
-  # ========================================================================= #
-  # === verbose_guess_the_build_type
-  # ========================================================================= #
-  def verbose_guess_the_build_type
-    opne 'The (guessed) build type is `'+slateblue(guess_build_type.to_s)+'`.'
-  end
-
-  # ========================================================================= #
-  # === guess_build_type
-  # ========================================================================= #
-  def guess_build_type
-    RBT.build_type?
-  end; alias do_guess_the_build_type guess_build_type # === do_guess_the_build_type
-
-  # ========================================================================= #
-  # === try_to_find_an_alias_to_this_input_unless_the_program_exists
-  #
-  # This method will either return the original input unmodified;
-  # or it will modify the input in such a way that it points to
-  # a valid, registered program.
-  #
-  # For example, the String "ph" may become "php". 
-  # ========================================================================= #
-  def try_to_find_an_alias_to_this_input_unless_the_program_exists(i)
-    unless cookbooks_include_this_program? i.downcase
-      is_the_program_included = cookbooks_include_this_program?(
-        i.downcase, :with_abbreviations
-      )
-      if is_the_program_included
-        i = abbreviations?[i.downcase]
-      end
-    end
-    i
-  end
-
-  require 'rbt/information/create_program_version_url_file.rb'
-  # ========================================================================= #
-  # === create_programs_url_file
-  # ========================================================================= #
-  def create_programs_url_file
-    RBT.create_programs_url_file
-  end
-
-  # ========================================================================= #
-  # === return_chained_programs
-  # ========================================================================= #
-  def return_chained_programs 
-    RBT.return_chained_programs
-  end
-
-  # ========================================================================= #
-  # === feedback_format_specification_of
-  # ========================================================================= #
-  def feedback_format_specification_of(i)
-    RBT::Cookbooks::SanitizeCookbook.feedback_format_specification_of(i)
-  end
-
-  # ========================================================================= #
-  # === update_mate_desktop_components
-  #
-  # Update mate-desktop via this method.
-  #
-  # Invocation example:
-  #
-  #   rbt --update-mate
-  #
-  # ========================================================================= #
-  def update_mate_desktop_components
-    unless RBT::Cookbooks.const_defined? :CheckForMateDesktopUpdates
-      require 'rbt/check_for_updates/check_for_mate_desktop_updates.rb'
-    end
-    RBT::Cookbooks::CheckForMateDesktopUpdates.new
-  end
-
-  # ========================================================================= #
-  # === show_downloadable_programs
-  # ========================================================================= #
-  def show_downloadable_programs(
-      i = available_programs?.sort
-    )
-    chunked = i.each_slice(5)
-    opne 'The following programs can be downloaded:'
-    e
-    chunked.each {|this_chunk|
-      e "  #{slateblue(this_chunk.join(', ').strip.chop)}"
-    }
-    e
-  end
-
-  require 'rbt/checks_and_validations/validate_cookbook_aliases.rb'
-  # ========================================================================= #
-  # === validate_the_cookbook_aliases
-  # ========================================================================= #
-  def validate_the_cookbook_aliases
-    RBT::Cookbooks::ValidateCookbookAliases.new # bl $RUBY_COOKBOOKS/lib/cookbooks/validate_cookbook_aliases.rb
-  end
-
-  # ========================================================================= #
-  # === install_the_linux_kernel_header_files_via_appdir_prefix
-  #
-  # This method essentially does what is described here:
-  #
-  #   http://www.linuxfromscratch.org/lfs/view/development/chapter05/linux-headers.html
-  #
-  # The main difference is that we will use a proper appdir prefix.
-  #
-  # Invocation examples:
-  #
-  #   ry --install-kernel-headers
-  #   ry --install-linux-headers
-  #
-  # ========================================================================= #
-  def install_the_linux_kernel_header_files_via_appdir_prefix
-    install_the_linux_kernel_header_files_via_this_prefix(:appdir_prefix)
-  end
-
-  # ========================================================================= #
-  # === extract_the_linux_kernel_archive
-  #
-  # To tap into this method from the commandline, do:
-  #
-  #   ry --extract-linux
-  #
-  # ========================================================================= #
-  def extract_the_linux_kernel_archive
-    result = initialize_cookbook_dataset_for(:linux)
-    target = result.extract_to?
-    if File.symlink? '/usr/src/linux'
-      delete_symlink('/usr/src/linux')
-    end
-    extract_what_to(
-      result.path?, target, :do_keep_the_old_directory_if_it_exists
-    )
-    e "Finished extracting the linux kernel to #{sdir(target)}."
-  end
-
-  # ========================================================================= #
-  # === show_and_store_json_for
-  #
-  # This method will load the expanded cookbook dataset (a yaml file),
-  # and convert this into json, via the .to_json method.
-  #
-  # Invocation example:
-  #
-  #   rbt htop --json
-  #
-  # ========================================================================= #
-  def show_and_store_json_for(
-      this_program = compile_which_program?
-    )
-    require 'json'
-    hash = {}
-    opne 'The json dataset for '+steelblue(this_program)+' is:'
-    dataset = load_dataset_from_this_expanded_cookbook(this_program)
-    hash[this_program.to_sym] = dataset
-    e
-    pp hash
-    e
-    opne 'This will be stored into the current directory as well.'
-    what = hash.to_json
-    # ======================================================================= #
-    # Decide where to store the json-file.
-    # ======================================================================= #
-    into = "#{this_program}.json"
-    opne 'Storing into the file `'+sfile(into)+'`.'
-    write_what_into(what, into)
-  end
-
-  # ========================================================================= #
-  # === output_all_urls_then_exit
-  # ========================================================================= #
-  def output_all_urls_then_exit
-    output_all_urls
-    exit_program
-  end
-
-  require 'rbt/cookbooks/all_urls.rb'
-  # ========================================================================= #
-  # === output_all_urls
-  #
-  # This method will output all URLs of every registered program.
-  #
-  # Invocation example:
-  #
-  #   ry --output_all_urls
-  #
-  # ========================================================================= #
-  def output_all_urls
-    dataset = RBT.all_urls(:no_opn).result? # Tap into this method here, without outputting the namespace.
-    dataset = dataset.map {|entry|
-      entry[0] = '  '+(entry[0]+' ').ljust(30)
-      entry.join
-    }.join("\n")
-    store_where = rbt_log_dir?+'all_program_urls.md'
-    File.delete(store_where) if File.exist? store_where # Let's get rid of the old file first.
-    opne "Storing into #{sfile(store_where)}"
-    save_file(dataset, store_where)
-  end
-
-  # ========================================================================= #
-  # === decide_whether_to_build_statically
-  # ========================================================================= #
-  def decide_whether_to_build_statically
-    if build_static?
-      append_static_onto_the_cflags
-    end
-  end
-
-  require 'rbt/utility_scripts/to_current.rb'
-  # ========================================================================= #
-  # === handle_the_postinstallation_step
-  #
-  # This will delegate towards class RBT::ToCurrent, to set the Current
-  # symlink.
-  # ========================================================================= #
-  def handle_the_postinstallation_step
-    if uses_appdir_prefix?
-      _ = prefix?
-      opne "Setting a symlink next, for #{steelblue(_)}:"
-      # ===================================================================== #
-      # Delegate onto class RBT::ToCurrent next.
-      # ===================================================================== #
-      RBT::ToCurrent.new(_)
-    end
-  end
-
-  # ========================================================================= #
-  # === append_these_configure_options
-  #
-  # This method will only append non-nil entries to the extra configure
-  # options.
-  # ========================================================================= #
-  def append_these_configure_options(
-      i = nil
-    )
-    case i
-    # ======================================================================= #
-    # === :release
-    # ======================================================================= #
-    when :release
-      i = '-DCMAKE_BUILD_TYPE=Release'
-    end
-    if i
-      if @internal_hash[:append_this_to_the_configure_options].nil?
-        # =================================================================== #
-        # In this case we must turn it into a String.
-        # =================================================================== #
-        @internal_hash[:append_this_to_the_configure_options] = ''.dup
-      end
-      @internal_hash[:append_this_to_the_configure_options] << " #{i}"
-    end
-  end
-
-  # ========================================================================= #
-  # === infer_information_from_this_archive
-  # ========================================================================= #
-  def infer_information_from_this_archive(i)
-    _ = remove_archive_at_the_end(
-      File.basename(i)
-    )
-    _ = ProgramInformation.new(_)
-    use_this_as_program_name    = _.program_name?
-    use_this_as_program_version = _.program_version?
-    # ======================================================================= #
-    # Obtain a dummy-cookbook dataset first.
-    # ======================================================================= #
-    cookbook_dataset = load_yaml_dataset_for_this_program(
-      use_this_as_program_name
-    )
-    # ======================================================================= #
-    # Update the program_path next:
-    # ======================================================================= #
-    cookbook_dataset.program_path = i
-    set_compile_this_program(use_this_as_program_name)
-    cookbook_dataset.set_program_version(use_this_as_program_version)
-    set_on_ihash(cookbook_dataset)
-    cd :log_dir
-    invoke_extracter(
-      cookbook_dataset.program_path,
-      log_dir?,
-      true
-    )
-    cd log_dir?+remove_archive_stuff_from_the_end(File.basename(i))
-    run_configure_like_stage    
-    exit_program
-  end
-
-
-  # ========================================================================= #
-  # === disable_logging
-  #
-  # We no longer log here.
-  # ========================================================================= #
-  def disable_logging(
-      be_verbose = true
-    )
-    if be_verbose
-      opne 'We will not log.'
-    end
-    @internal_hash[:may_we_log] = false
-  end
-
-  # ========================================================================= #
-  # === convert_to_traditional
-  #
-  # Convert to traditional format via this method here.
-  #
-  # Invoke this by doing something like:
-  #
-  #   ry php ctotrad
-  #
-  # ========================================================================= #    
-  def convert_to_traditional(
-      i = compile_which_program?
-    )
-    RBT::ConvertToTraditional.new(i) # bl ConvertToTraditional
-  end
-
-  # ========================================================================= #
-  # === find_all_archive_types
-  # ========================================================================= #
-  def find_all_archive_types
-    RBT::Cookbooks::FindAllArchiveTypes.new.show_results
-  end
-
-  # ========================================================================= #
-  # === update_library_names
-  #
-  # To invoke this method, do something like:
-  #
-  #   ry htop uln
-  #
-  # ========================================================================= #
-  def update_library_names
-    RBT::Cookbooks::RegisteredLibraries.new
-  end
-
-  # ========================================================================= #
-  # === zero_this_global_flag_file
-  # ========================================================================= #
-  def zero_this_global_flag_file(i)
-    opne "Now resetting all global flags to "\
-         "zero again. (File: #{sfile(i)})"
-    remove_file(i)
-    touch_file(i)
-  end
-
-  # ========================================================================= #
-  # === clear_global_flags
-  #
-  # Clear the global files in use that may be stored in the file
-  # global_flags.yml.
-  # ========================================================================= #
-  def clear_global_flags
-    _ = RBT.file_global_flags
-    if File.exist?(_) and !File.empty?(_)
-      zero_this_global_flag_file(_)
-    end
-    if is_on_roebe? # And on my home system as well.
-      _ = ROEBE_FILE_GLOBAL_FLAGS
-      zero_this_global_flag_file(_)
-    end
-  end
-
-  # ========================================================================= #
-  # === return_md5
-  #
-  # md5sum support via this method. It will make use of the class Md5sum.
-  # ========================================================================= #
-  def return_md5(this_file)
-    _ = Md5sum.new(this_file, :dont_run_yet) # bl $RUBY_SRC/md5sum/lib/md5sum/md5sum.rb
-    return _.return_md5sum(this_file)
-  end
-
-  # ========================================================================= #
-  # === use_utf8_encoding_in_env
-  # ========================================================================= #
-  def use_utf8_encoding_in_env
-    ENV['LC_ALL'] = 'en_US.utf8'
-  end
-
-  # ========================================================================= #
-  # === uninstall_this_appdir
-  #
-  # Invocation example:
-  #
-  #   rbt evince --uninstall-appdir
-  #
-  # ========================================================================= #
-  def uninstall_this_appdir(
-      i = compile_which_program?
-    )
-    opne "Now trying to uninstall the program called `#{teal(i)}`."
-    ::RBT::RemoveProgram.new(i)
-  end
-
-  # ========================================================================= #
-  # === is_on_32_bit_system?
-  # ========================================================================= #
-  def is_on_32_bit_system?
-    TARGET_CPU == 'i686'
-  end
-
-  # ========================================================================= #
-  # === do_not_store_the_compile_time
-  # ========================================================================= #
-  def do_not_store_the_compile_time
-    @internal_hash[:time_compilation] = false
-  end
-
-  # ========================================================================= #
-  # === compile_the_initial_lfs_toolchain
-  # ========================================================================= #
-  def compile_the_initial_lfs_toolchain
-    ENV['PATH'] = '/tools/bin:/bin:/usr/bin'
-    opne 'We will next try to install a LFS-like toolchain - aka, similar to'
-    opne 'How the Linux from Scratch system is bootstrapped.'
-    e
-    e 'In order to do so, certain '+steelblue('assumptions')+' will have to be made.'
-    e
-    # ======================================================================= #
-    # Next comes the general LFS prefix to use.
-    # ======================================================================= #
-    use_this_prefix    = '/home/LFS/'
-    prefix_for_tools   = use_this_prefix+'tools'
-    # ======================================================================= #
-    # === tools_lib_path
-    # ======================================================================= #
-    tools_lib_path     = prefix_for_tools+'/lib'
-    prefix_for_sources = use_this_prefix+'sources'
-    opne 'The target directory for this boostrapped toolchain will be at:'
-    e
-    e "  #{steelblue(use_this_prefix)}"
-    e
-    mkdir(use_this_prefix)
-    mkdir(prefix_for_tools)
-    mkdir(prefix_for_sources)
-    mkdir(tools_lib_path)
-    unless File.symlink? '/tools'
-      esystem('ln -sv '+prefix_for_tools+' /')
-    end
-    # ======================================================================= #
-    # === Create .bash_profile next:
-    # ======================================================================= #
-    this_file = File.expand_path('~/.bash_profile')
-    unless File.exist? this_file
-      what = <<-EOF
-exec env -i HOME=$HOME TERM=$TERM PS1=' ' /bin/bash
-EOF
-      opne 'Next storing into the file `'+sfile(this_file)+'`.'
-      write_what_into(what, this_file)
-    end
-    # ======================================================================= #
-    # === Create .bashrc next:
-    # ======================================================================= #
-    this_file = File.expand_path('~/.bashrc')
-    # ======================================================================= #
-    # Overrule for the LFS user:
-    # ======================================================================= #
-    this_file = File.expand_path('/home/lfs/.bashrc')
-    architecture = `uname -m`.strip
-    # ======================================================================= #
-    # === lfs_target_architecture
-    #
-    # Specify which target architecture is to be used. Oddly enough GCC
-    # seems to be picky about the name chosen here.
-    # ======================================================================= #
-    lfs_target_architecture = "#{architecture}-pc-linux-gnu"
-    unless File.exist? this_file
-      what = "set +h
-umask 022
-LFS=#{use_this_prefix}
-LC_ALL=POSIX
-LFS_TGT=#{lfs_target_architecture}
-PATH=/tools/bin:/bin:/usr/bin
-export LFS LC_ALL LFS_TGT PATH
-"
-      opne 'Next storing into the file `'+sfile(this_file)+'`.'
-      write_what_into(what, this_file)
-    end
-    # ======================================================================= #
-    # Next compile binutils, first pass - see also this URL:
-    #
-    #   http://www.linuxfromscratch.org/lfs/view/development/chapter05/binutils-pass1.html
-    #
-    # ======================================================================= #
-    _ = RBT::Compile.new(:binutils) { :do_not_run_yet }
-    _.clear_configure_options
-    _.set_prefix_to_use('/tools')
-    _.do_not_store_the_compile_time
-    use_these_configure_options = <<-EOF
---with-sysroot=#{use_this_prefix}
---with-lib-path=/tools/lib
---target=#{lfs_target_architecture}
---disable-nls
---disable-werror
-EOF
-    _.set_internal_hash_configure_options use_these_configure_options.tr("\n", ' ')
-    _.skip_postinstallation_step
-    _.do_not_register_the_last_compiled_program
-    _.run
-    if is_on_64_bit?
-      cd prefix_for_tools
-      esystem 'ln -sv lib /tools/lib64'
-    end
-    # ======================================================================= #
-    # Next prepare GCC
-    # ======================================================================= #
-    cd log_dir?
-    _ = RBT::Compile.new(:gcc) { :do_not_run_yet }
-    extract_what_to(
-      _.cookbook_dataset_program_path?,
-      _.extracted_path?
-    )
-    target_dir = _.extracted_path?+
-                 remove_archive_from_the_end(
-                   File.basename(_.cookbook_dataset_program_path?)
-                 )
-    opne 'Changing directory into '+sdir(target_dir)+' next.'
-    cd target_dir
-    path_to_mpfr = return_path_to_the_archive_of_this_program(:mpfr)
-    path_to_gmp  = return_path_to_the_archive_of_this_program(:gmp)
-    path_to_mpc  = return_path_to_the_archive_of_this_program(:mpc)
-    extract_what_to(
-      path_to_mpfr,
-      return_pwd
-    )
-    unless File.directory? 'mpfr'
-      opnn; mv remove_archive_from_the_end(File.basename(path_to_mpfr)),'mpfr'
-    end
-    extract_what_to(
-      path_to_gmp,
-      return_pwd
-    )
-    unless File.directory? 'gmp'
-      opnn; mv remove_archive_from_the_end(File.basename(path_to_gmp)),'gmp'
-    end
-    extract_what_to(
-      path_to_mpc,
-      return_pwd
-    )
-    unless File.directory? 'mpc'
-      opnn; mv remove_archive_from_the_end(File.basename(path_to_mpc)),'mpc'
-    end
-    what = <<-EOF
-for file in gcc/config/{linux,i386/linux{,64}}.h
-do
-  cp -uv $file{,.orig}
-  sed -e 's@/lib\(64\)\?\(32\)\?/ld@/tools&@g' -e 's@/usr@/tools@g' $file.orig > $file
-  echo '
-#undef STANDARD_STARTFILE_PREFIX_1
-#undef STANDARD_STARTFILE_PREFIX_2
-#define STANDARD_STARTFILE_PREFIX_1 "/tools/lib/"
-#define STANDARD_STARTFILE_PREFIX_2 ""' >> $file
-  touch $file.orig
-done
-
-EOF
-    esystem what
-    adhoc_fix_gcc
-    _.clear_configure_options
-    _.set_prefix_to_use(prefix_for_tools)
-    _.do_not_store_the_compile_time
-    use_these_configure_options = <<-EOF
---target=#{lfs_target_architecture}
---with-glibc-version=2.11
---with-sysroot=#{use_this_prefix}
---with-newlib
---without-headers
---with-local-prefix=/tools
---with-native-system-header-dir=/tools/include
---enable-languages=c,c++
---disable-nls
---disable-shared
---disable-multilib
---disable-decimal-float
---disable-threads
---disable-libatomic
---disable-libgomp
---disable-libquadmath
---disable-libssp
---disable-libvtv
---disable-libstdcxx
-
-EOF
-    _.set_internal_hash_configure_options use_these_configure_options.tr("\n", ' ').squeeze(' ')
-    _.skip_postinstallation_step
-    _.do_not_register_the_last_compiled_program
-    _.run
-    # ======================================================================= #
-    # Next install the linux kernel header files:
-    # ======================================================================= #
-    path_to_linux = return_path_to_the_archive_of_this_program(:linux)
-    extract_what_to(
-      path_to_linux,
-      return_pwd
-    )
-    cd remove_archive_at_the_end(File.basename(path_to_linux))
-    e 'We are in the directory '+sdir(return_pwd)+' and will '\
-      'run three commands:'
-    esystem 'make mrproper'
-    esystem 'make headers'
-    esystem 'cp -rv usr/include/* /tools/include'
-    # ======================================================================= #
-    # Next glibc:
-    # ======================================================================= #
-    cd log_dir?
-    _ = RBT::Compile.new(:glibc) { :do_not_run_yet }
-    extract_what_to(
-      _.cookbook_dataset_program_path?,
-      _.extracted_path?
-    )
-    target_dir = _.extracted_path?+
-                 remove_archive_from_the_end(
-                   File.basename(_.cookbook_dataset_program_path?)
-                 )
-    opne 'Changing directory into '+sdir(target_dir)+' next.'
-    _.clear_configure_options
-    _.set_prefix_to_use(prefix_for_tools)
-    _.do_not_store_the_compile_time
-    use_these_configure_options = <<-EOF
---host=#{lfs_target_architecture}
---build=$(../scripts/config.guess)
---enable-kernel=3.2
---with-headers=/tools/include
-EOF
-    _.set_internal_hash_configure_options use_these_configure_options.tr("\n", ' ').squeeze(' ')
-    _.skip_postinstallation_step
-    _.do_not_register_the_last_compiled_program
-    _.run
-    # ======================================================================= #
-    # Next install Libstdc++
-    # ======================================================================= #
-    cd log_dir?
-    _ = RBT::Compile.new(:gcc) { :do_not_run_yet }
-    extract_what_to(
-      _.cookbook_dataset_program_path?,
-      _.extracted_path?
-    )
-    target_dir = _.extracted_path?+
-                 remove_archive_from_the_end(
-                   File.basename(_.cookbook_dataset_program_path?)
-                 )
-    opne 'Changing directory into '+sdir(target_dir)+' next.'
-    cd target_dir
-    mkdir 'build'
-    cd 'build'
-    opne 'We are now in the directory '+sdir(target_dir)+'.'
-    ENV['LD_CONFIG_PATH'] = tools_lib_path
-    esystem "../libstdc++-v3/configure
-    --host=#{lfs_target_architecture}
-    --prefix=/tools
-    --disable-bootstrap
-    --disable-multilib
-    --disable-nls
-    --disable-libstdcxx-threads
-    --disable-libstdcxx-pch
-    --with-system-zlib
-    --with-newlib
-    --disable-libquadmath
-    --with-gxx-include-dir=/tools/#{lfs_target_architecture}/include/c++/9.2.0".squeeze(' ').tr("\n",' ').squeeze(' ')
-    # ======================================================================= #
-    # This here may lead to problems - in that event, have a look at the
-    # config.log file, as it should show why, for example, link tests
-    # were disabled. --disable-libquadmath should help in that case,
-    # by the way.
-    # ======================================================================= #
-    esystem 'make'
-    esystem 'make install'
-  end
-
-  # ========================================================================= #
-  # === adhoc_fix_gcc
-  # ========================================================================= #
-  def adhoc_fix_gcc
-    require 'rbt/misc/classes_for_individual_programs/change_lib64_to_lib.rb'
-    RBT::ClassesForIndividualPrograms::Gcc::ChangeLib64ToLib.new
-  end
-
-  # ========================================================================= #
-  # === verbose_find_all_keys_starting_with
-  #
-  # This method will feedback all programs that start with a given
-  # (input) letter.
-  # ========================================================================= #
-  def verbose_find_all_keys_starting_with(i)
-    opne 'Finding all matches starting with the letter `'+
-          sfancy(i.delete('*'))+'` now:'
-    e
-    find_all_keys_starting_with(i)
-    e
-  end
-
-  require 'rbt/cookbooks/suggest_cookbook_for.rb'
-  # ========================================================================= #
-  # === suggest_cookbook_for
-  # ========================================================================= #
-  def suggest_cookbook_for(i)
-    RBT.suggest_cookbook_for(i)
-  end
-
-  # ========================================================================= #
-  # === try_to_automatically_setup_the_rbt_project
-  #
-  # This method could be used to automatically try and setup the
-  # project on a default GoboLinux system.
-  # ========================================================================= #
-  def try_to_automatically_setup_the_rbt_project
-    if RBT.is_this_a_real_gobolinux_system?
-      opne 'Found a local GoboLinux system.'
-      opne 'Setting up some settings to make use of this as our host system.'
-      target_file = log_dir?+'is_on_gobolinux.md'
-      write_what_into('1', target_file)
-      opne 'This will be stored into the file `'+sfile(target_file)+'`.'
-    end
-  end
-
-  # ========================================================================= #
-  # === consider_displaying_the_start_message
-  # ========================================================================= #  
-  def consider_displaying_the_start_message
-    _ = cookbook_dataset?.optional_start_message
-    if _
-      unless _.empty? 
-        opne sfancy(_)
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === create_a_slackdesc_file_for_this_program
-  # ========================================================================= #
-  def create_a_slackdesc_file_for_this_program(i)
-    require 'rbt/linux/slackware/generate_slack_desc_file.rb'
-    RBT::Linux::Slackware::GenerateSlackDescFile.new(i)
-  end
-
-  # ========================================================================= #
-  # === use_this_as_programs_dir
-  # ========================================================================= #
-  def use_this_as_programs_dir(
-      i = programs_directory?
-    )
-    i = convert_end_variable # Sanitize it.
-    i << '/' unless i.end_with? '/'
-    opne "Assigning a new Programs directory at: #{simp(i)}"
-    RBT.configuration?.programs_directory = i
-    # ======================================================================= #
-    # Next we also must sync towards the main dataset.
-    # ======================================================================= #
-    cookbook_dataset?.programs_directory = i
-    cookbook_dataset?.sanitize_prefix :appdir_path
-  end
-
-  # ========================================================================= #
-  # === notify_the_user_that_something_failed_at_configure_stage
-  # ========================================================================= #
-  def notify_the_user_that_something_failed_at_configure_stage
-    opne swarn('Something appears to have failed at the configure stage.')
-    report_status
-  end
-
-  # ========================================================================= #
-  # === do_not_continue_after_make_step
-  # ========================================================================= #
-  def do_not_continue_after_make_step
-    @internal_hash[:continue_after_make_step] = false
-  end
-
-  # ========================================================================= #
-  # === do_run_simulation
-  # ========================================================================= #
-  def do_run_simulation
-    @internal_hash[:run_simulation] = true
-  end
-
-  require 'rbt/utility_scripts/build_detector.rb'
-  # ========================================================================= #
-  # === return_build_type
-  # ========================================================================= #
-  def return_build_type
-    return ::RBT.build_type?
-  end
-
-  # ========================================================================= #
-  # === update_tags
-  #
-  # This will simply update the tags, by tapping into the Cookbooks project.
-  # ========================================================================= #
-  def update_tags
-    require 'rbt/registered/registered_tags.rb'
-    RBT::RegisteredTags.new
-  end
-
-  # ========================================================================= #
-  # === run_through_the_registered_errors
-  #
-  # Sync the errors towards class RBT::Compile next.
-  # ========================================================================= #
-  def run_through_the_registered_errors
-    RBT::Errors::MapLineToASpecificError.registered_errors?.each {|do_this_action|
-      error_is do_this_action
-    }
-  end
-
-  # ========================================================================= #
-  # === do_perform_an_intelligent_bootstrap
-  #
-  # Usage example:
-  #
-  #   rbt --intelligent-bootstrap
-  #
-  # ========================================================================= #
-  def do_perform_an_intelligent_bootstrap
-    begin
-      require 'environment_information'
-    rescue LoadError; end
-    opne 'Attempting to perform an '+
-         steelblue('intelligent bootstrap operation next')+'.'
-    if Object.const_defined? :EnvironmentInformation
-      EnvironmentInformation.initialize
-      array_of_outdated_programs = EnvironmentInformation.return_array_of_outdated_programs
-      # ===================================================================== #
-      # Now that we have these programs, we must sort them based on
-      # filesize.
-      # ===================================================================== #
-      array_of_outdated_programs = array_of_outdated_programs.sort_by {|this_program|
-        result = 1_000_000 # Use a bogus entry here, to sort it towards the bottom.
-        target_yaml_file = ::RBT.path_to_expanded_directory?+this_program.to_s+'.yml'
-        if File.exist? target_yaml_file
-          dataset = YAML.load_file(target_yaml_file)
-          if dataset.has_key? 'archive_size'
-            result = dataset['archive_size']
-          end
-        end
-        result
-      }
-      array_of_outdated_programs.each {|this_program|
-        opnn; e 'Now compiling '+steelblue(this_program)+'.'
-        ::RBT::Compile.new(this_program)
-      }
-    end
-  end
-
-  # ========================================================================= #
-  # === generate_global_yaml_database
-  # ========================================================================= #
-  def generate_global_yaml_database
-    require 'rbt/generate_files/create_global_yaml_database.rb'
-    RBT.generate_global_yaml_database
-  end
-
-  # ========================================================================= #
-  # === consider_applying_a_patch
-  #
-  # Check whether we should apply a patch_set or not.
-  #
-  # This should happen before we make use of preinstall, and after
-  # displaying an optional start message.
-  # ========================================================================= #
-  def consider_applying_a_patch
-    apply_patch = apply_patch?
-    if apply_patch
-      patchset = apply_patch
-      patchset = [patchset] unless patchset.is_a? Array
-      patchset.flatten.each {|this_patchset|
-        cliner {
-          this_dir = configure_base_directory?
-          opne simp('Trying to ')+
-               orange('apply a patch')+
-               simp(' next:')+
-               simp(' (in ')+
-               sdir(this_dir)+
-               simp(')')
-          opne "  #{this_patchset}"
-        }
-        # =================================================================== #
-        # (1) Download the patch unless it exists locally.
-        # =================================================================== #
-        unless File.exist? File.basename(this_patchset)
-          opne 'Next trying to download '+steelblue(this_patchset)+'.'
-          do_download_this_program(this_patchset)
-        end
-        this_command = "patch -Np1 -i #{File.basename(this_patchset)}"
-        opne "Running this command next (from the directory "\
-             "#{sdir(return_pwd)}):"
-        e
-        e "#{sfancy(this_command)}"
-        e
-        # =================================================================== #
-        # (2) Run the patchset.
-        # =================================================================== #
-        custom_system(this_command) # Delegate to Kernel#system.
-      }
-    end
-  end
-
-  # ========================================================================= #
-  # === speed_up_the_compilation
-  #
-  # We can speed up compilation via the -j option to "make". Keep in mind
-  # that we have to avoid the number "0", though, as make would complain
-  # when this is used.
-  #
-  # See:
-  #
-  #   https://www.math-linux.com/linux/tip-of-the-day/article/speedup-gnu-make-build-and-compilation-process
-  #
-  # ========================================================================= #
-  def speed_up_the_compilation
-    use_n_processors = return_n_processors
-    if use_n_processors <= 0
-      use_n_processors = 1 # ← 1 is always the minimum. "make -j0" would lead to errors.
-    end
-    append_parameters_to_make(
-      " -j#{use_n_processors}"
-    )
-  end
-
-end; end