rbt 0.10.215

data/lib/rbt/compile/misc.rb

@@ -0,0 +1,4636 @@
+#!/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