rbt 0.10.215 → 0.11.89

data/lib/rbt/compile/handle_this_program.rb

@@ -1,1289 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# This file is quite important: it contains most of the logic for
-# RBT::Compile in how it will handle the programs that are to be
-# compiled or installed.
-# =========================================================================== #
-# require 'rbt/compile/handle_this_program.rb'
-# =========================================================================== #
-module RBT
-
-class Compile < ::RBT::CompileBase # === RBT::Compile
-
-  require 'rbt/toplevel_methods/compile_these_programs.rb'
-  require 'rbt/misc/map_this_input_to_that_registered_program.rb'
-
-  # ========================================================================= #
-  # === do_initiate_batch_compilation        (compile tag, main tag, run tag)
-  #
-  # This method is the general entry-point in order to batch-compile the
-  # programs. The programs are typically stored as an Array, in the
-  # variable called @array_compile_these_programs.
-  #
-  # The logic for this task will be handled internally, on a per-program
-  # basis.
-  #
-  # The argument to this method should be an Array which holds the
-  # programs that we wish to compile. This is normally set elsewhere
-  # in class RBT::Compile.
-  # ========================================================================= #
-  def do_initiate_batch_compilation(
-      i = @array_compile_these_programs
-    )
-    i.each {|this_program|
-      # reset_the_internal_hash # ← This must come before the update-method.
-      do_compile_this_program(this_program)
-    }
-  end; alias do_compile_these_programs     do_initiate_batch_compilation # === do_compile_these_programs
-       alias start_to_compile_the_programs do_initiate_batch_compilation # === start_to_compile_the_programs
-       alias start_to_compile              do_initiate_batch_compilation # === start_to_compile
-       alias compile_every_program         do_initiate_batch_compilation # === compile_every_program
-       alias batch_compile_these_programs  do_initiate_batch_compilation # === batch_compile_these_programs
-       alias batch_compile_the_programs    do_initiate_batch_compilation # === batch_compile_the_programs
-
-  # ========================================================================= #
-  # === set_array_compile_these_programs
-  #
-  # This method will designate which programs are to be compiled, as an
-  # Array. It may look like this: ['htop','ruby','php']
-  #
-  # Note that this method will remove all '-' tokens from the given input
-  # at hand, if the second option allows this method to do so.
-  # ========================================================================= #
-  def set_array_compile_these_programs(
-      i,
-      consider_replacing_the_given_input = :honour_user_configuration_setting
-    )
-    case consider_replacing_the_given_input
-    # ======================================================================= #
-    # === :default
-    # ======================================================================= #
-    when :default
-      consider_replacing_the_given_input = true
-    # ======================================================================= #
-    # === :do_not_replace
-    #
-    # In this case we may not replace the given input.
-    # ======================================================================= #
-    when :do_not_replace
-      consider_replacing_the_given_input = false
-    # ======================================================================= #
-    # === :honour_user_configuration_setting
-    # ======================================================================= #
-    when :honour_user_configuration_setting,
-         :honour_user_settings
-      if will_we_make_use_of_abbreviations?
-        consider_replacing_the_given_input = 
-          @internal_hash[:make_use_of_the_cookbook_aliases]
-      else
-        consider_replacing_the_given_input = false
-      end
-    end
-    i = [i].flatten.compact.reject {|entry| entry.start_with? '--' }
-    i.map! {|entry|
-      entry = entry.to_s.dup
-      # ===================================================================== #
-      # === Handle the possibility of replacing the given input at hand
-      #
-      # This clause is triggered when the user wishes to replace
-      # the given input at hand.
-      #
-      # Invocation example:
-      #
-      #   trad libx
-      #
-      # ===================================================================== #
-      if consider_replacing_the_given_input
-        # =================================================================== #
-        # First, check for .pc files directly. That way we can find the
-        # real program at hand; and if not then the .pc suffix will be
-        # dropped anyway.
-        # =================================================================== #
-        if entry.end_with? '.pc'
-          _ = RBT.return_the_associated_program_of_this_pkgconfig_file(entry)
-          unless _ == entry
-            opne 'This .pc file is registered and points to '\
-                 'the program called '+steelblue(_)+'.'
-            opne 'It will be used as input next.'
-            entry = _
-          end
-          entry.delete_suffix!('.pc') if entry.end_with? '.pc'
-        end
-        entry.delete_suffix!('.yml') if entry.end_with? '.yml'
-        entry.chop! if entry.end_with? ':','#' # Get rid of trailing ':' and '#'.
-        entry = entry.delete('-').downcase # All gets downcased. \o/
-        unless File.exist? entry
-          if is_an_archive?(entry)
-            entry = remove_archive_at_the_end(entry)
-            if entry.include?('-') and (entry =~ /\d+/)
-              # ============================================================= #
-              # Assume entries such as this one here:
-              #   mate-panel-1.21.3
-              # ============================================================= #
-              program_name    = ProgramInformation.return_name(entry)
-              _program_version = ProgramInformation.return_version(entry)
-              entry = program_name
-            end
-          end
-        end
-        entry = File.basename(entry) if entry.include? '/'
-        unless RBT.is_this_program_registered?(entry)
-          _ = RBT::MapThisInputToThatRegisteredProgram.new(entry) { :be_quiet }
-          new_entry = _.return_possible_match
-          if new_entry and
-            (new_entry.to_s != entry.to_s)
-            type = _.type?
-            a_or_an = a_or_an?(type)
-            opne 'Replacing '+steelblue(entry)+
-                 ' with '+mediumslateblue(new_entry)+', as '\
-                 'input. It is '+a_or_an+' '+
-                 mediumorchid(type.tr('_',' '))+'.'
-            entry = new_entry
-          end
-        end unless entry.to_s.start_with? '--' # Exclude "--flag" options here.
-      end
-      entry
-    }
-    @array_compile_these_programs = i
-    # ======================================================================= #
-    # This will always be an Array, set on the toplevel:
-    # ======================================================================= #
-    RBT.set_compile_these_programs(i)
-    # ======================================================================= #
-    # We will also initialize the cookbook_dataset for the first program,
-    # if possible. We will also delete '.' characters since as of September
-    # 2019, as some programs may be called e. g. "ruamel.yaml".
-    # ======================================================================= #
-    original_first_program = RBT.compile_these_programs?.first.to_s
-    first_program = File.basename(
-      original_first_program.downcase.delete('/.')
-    )
-    if first_program and RBT.is_this_program_included?(first_program)
-      # ===================================================================== #
-      # Set the initial seeds for the programs at hand.
-      # ===================================================================== #
-      set_compile_this_program(first_program)
-      initialize_cookbook_dataset_for(first_program)
-    end
-  end; alias set_compile_these_programs set_array_compile_these_programs # === set_compile_these_programs
-       alias compile_this=              set_array_compile_these_programs # === compile_this=
-
-  # ========================================================================= #
-  # === determine_which_programs_to_compile
-  # ========================================================================= #
-  def determine_which_programs_to_compile(
-      first_argument = first_argument?
-    )
-    if first_argument
-      set_handle_this_program(first_argument)
-      # ===================================================================== #
-      # We may not replace anything in this case, as otherwise
-      # "--lxqt" may become "--lxqtconfig" or just "lxqtconfig"
-      # which is not desirable. But sometimes this is useful,
-      # so ...
-      # ===================================================================== #
-      replace_or_dont_replace = :honour_user_settings
-      if first_argument.start_with? '--'
-        replace_or_dont_replace = :do_not_replace
-      end
-      set_array_compile_these_programs(first_argument, replace_or_dont_replace)
-    end
-    # ======================================================================= #
-    # Next, look for chained-programs.
-    # ======================================================================= #
-    _ = dataset_from_the_file_cookbook_chained_programs?
-    if _.has_key?(first_argument) and
-      !does_include?(first_argument)
-      set_compile_these_programs(_[first_argument])
-    end
-  end
-
-  # ========================================================================= #
-  # === do_run_GNU_configure_then_make_then_make_install
-  # ========================================================================= #
-  def do_run_GNU_configure_then_make_then_make_install(
-      use_this_configure_command = use_this_build_system?
-    )
-    run_the_configure_command
-    run_premake_make_then_make_install if run_make?
-  end; alias run_configure_then_make_then_make_install do_run_GNU_configure_then_make_then_make_install # === run_configure_then_make_then_make_install
-
-  # ========================================================================= #
-  # === run_the_configure_command
-  #
-  # This method will ultimately run the "./configure" command, with an
-  # appropriate prefix to be used.
-  # ========================================================================= #
-  def run_the_configure_command(
-      use_this_configure_command = use_this_build_system?
-    )
-    return unless run_configure_script?
-    # ===================================================================== #
-    # === configure_command_to_use
-    #
-    # Add the configure-command that is to be used next, if this is
-    # specified in the cookbook .yml file at hand. For example,
-    # 'bc' requires the command './configure.sh' rather than
-    # 'configure'. 
-    # ===================================================================== #
-    if cookbook_dataset_configure_command?
-      use_this_configure_command = cookbook_dataset_configure_command?.dup
-    else # This else-clause is the default.
-      case use_this_configure_command
-      when :infer_automatically
-        use_this_configure_command = return_build_type
-      else
-        use_this_configure_command = 'configure'
-      end
-    end
-    create_the_build_directory_then_cd_into_it
-    _ = ''.dup # ← We will start with this here.
-    # ======================================================================= #
-    # === Honour ccache
-    #
-    # Honour the CCACHE setting, if it has been provided.
-    # ======================================================================= #
-    if use_ccache?
-      # ===================================================================== #
-      # Find out whether ccache is available or whether it is not. If
-      # it is we will use it, while also specifying which compiler
-      # to use.
-      # ===================================================================== #
-      if ccache_is_available?
-        if will_gcc_be_used_for_compilation?
-          _.prepend 'CC="ccache gcc" ' # In this case prepend it.
-        end
-      else # It must be available.
-        notify_the_user_that_ccache_is_not_available
-      end
-    end
-    _ << '.' if use_build_directory?
-    # ======================================================================= #
-    # The next line exists due to programs such as discount.yml needing
-    # a configure-command like: ./configure.sh
-    # ======================================================================= #
-    _ << "." # unless use_this_configure_command.start_with?('./')
-    # ======================================================================= #
-    # Append the configure-base-directory value next. However had, I am
-    # not sure whether this is correct in April 2021. We'll comment it
-    # out for now; once we know more, we may re-add this again.
-    # ======================================================================= #
-    # _ << configure_base_directory?.dup
-    _ << '/'
-    _ << "#{use_this_configure_command}"
-    # ======================================================================= #
-    # The following _.include? check is valid for e. g. applications
-    # such as "lsof".
-    # ======================================================================= #
-    if do_we_use_any_prefix?
-      use_this_prefix = prefix?.to_s
-      RBT.set_last_prefix_used(use_this_prefix)
-      _ << " --prefix=#{use_this_prefix}" unless _.include? './Configure -n linux'
-    end
-    # ======================================================================= #
-    # The following two checks are necessary, due to two reasons:
-    #
-    # - The user may not want to append any configure-options in
-    #   the first place. Hence, we must check for this via
-    #   use_configure_options?.
-    #
-    # - Second the user may also input a command such as "ry sed-4.5",
-    #   and in this case we have to work on an existing file, rather
-    #   than on the dataset in the cookbook-yaml file.
-    #
-    # ======================================================================= #
-    if use_configure_options? and cookbooks_dataset?
-      configure_options_to_use = return_the_appropriate_configure_options(
-        use_this_configure_command
-      ).to_s.dup.rstrip
-      if configure_options_to_use and !configure_options_to_use.empty?
-        # =================================================================== #
-        # Finally, append these additional commands to the
-        # configure-string:
-        # =================================================================== #
-        _ << " #{configure_options_to_use}"
-      end
-    end
-    # ======================================================================= #
-    # === Handle strange configuration options involving sysconfdir next
-    #
-    # This must come after we have appended the configure options in use.
-    # ======================================================================= #
-    if use_appdir_prefix? and _.include?('--sysconfdir=/etc')
-      regexp_quoted_old_sysconfdir_prefix = Regexp.quote('--sysconfdir=/etc')
-      rewritten_sysconfdir = '--sysconfdir='+rds(use_which_prefix?.to_s+'/etc')
-      opne 'An '+salmon('AppDir prefix')+' is used, but also "'+
-           royalblue('--sysconfdir=/etc')+'". '\
-           'This is not logical.'
-      opne 'It is now assumed that the --sysconfdir=/etc is meant to target'
-      opne "that #{salmon('AppDir prefix')}, so it will be rewritten to"
-      opne "`#{royalblue(rewritten_sysconfdir)}`."
-      _.sub!(/#{regexp_quoted_old_sysconfdir_prefix}/, rewritten_sysconfdir)
-    end
-    _ << " #{return_append_this_to_the_configure_options}"
-    _.strip! # Just ensure that there are no trailing ' ' characters.
-    # ======================================================================= #
-    # === Handle the ERROR_LINE next
-    #
-    # Next, we will append the ERROR_LINE, but only if the user has
-    # not overruled this on the commandline.
-    # ======================================================================= #
-    if @internal_hash[:append_shell_error_code] and !_.include?(ERROR_LINE)
-      _ << ERROR_LINE
-    end
-    # ======================================================================= #
-    # The next line is used to turn something like:
-    #
-    #   "/Depot/Temp/rbt/discount-2.2.3a/./configure.sh"
-    #
-    # into:
-    #
-    #   "/Depot/Temp/rbt/discount-2.2.3a/configure.sh"
-    #
-    # ======================================================================= #
-    if _.include?('/./')
-      _.sub!(/\/\.\//, '/')
-    end
-    set_full_configure_command(_.dup.squeeze(' ')) # ← Keep a copy too.
-    use_this_colour = :konsole_dodgerblue # ← dodgerblue
-    if use_colours?
-      cliner(use_colour: use_this_colour)
-    else
-      cliner
-    end
-    e
-    ecolourize_this_important_system_command(full_configure_command?)
-    e
-    if use_colours?
-      cliner(use_colour: use_this_colour)
-    else
-      cliner
-    end
-    reset_error_map_line_to_a_specific_error # ← Must come before the sys-command.
-    run_this_sys_command(full_configure_command?) # ← Run the sys-command here.
-    run_through_the_registered_problems_registered_errors_and_behaviour_changes
-    reset_error_map_line_to_a_specific_error
-  end; alias run_configure            run_the_configure_command # === run_configure
-       alias run_configure_via_system run_the_configure_command # === run_configure_via_system
-
-  # ========================================================================= #
-  # === do_compile_this_program                            (real compile tag)
-  #
-  # This method can be used to compile a given program. It is the main
-  # "workhorse" for class RBT::Compile.
-  #
-  # To not initialize the dataset, use :do_not_initialize_the_dataset
-  # as block-argument.
-  # ========================================================================= #
-  def do_compile_this_program(i)
-    return unless can_we_continue?
-    i = i.to_s.dup # We need a String.
-    i.delete!('_') if i.include? '_'
-    # ======================================================================= #
-    # Handle the * argument. We will show to the user what programs
-    # exist that start with this name.
-    #
-    # To trigger this method, do:
-    #
-    #   ry a*
-    #   ry e*
-    #
-    # ======================================================================= #
-    if i.respond_to?(:include?) and
-       i.include?('*')
-      verbose_find_all_keys_starting_with(i)
-      exit_program
-    end
-    # ======================================================================= #
-    # === Check whether ccache exists
-    #
-    # Query for the use and availability of ccache. This should come
-    # after any special environment was set.
-    # ======================================================================= #
-    if use_ccache? and !is_ccache_available?
-      notify_the_user_that_ccache_is_not_available
-    end
-    # ======================================================================= #
-    # Note that the next clause will return and thus break from this
-    # method. Subsequent method calls will not be triggered.
-    # ======================================================================= #
-    if !is_this_program_included?(i)
-      opne 'The program '+steelblue(i)+' is '+tomato('not')+' registered '\
-           'as part of the RBT project.'
-      opne 'Thus, it could not be found and, subsequently, it can not '\
-           'be'
-      opne 'compiled or installed.'
-      return :the_program_is_not_registered_in_the_rbt_project
-    end
-    # ======================================================================= #
-    # cd into the main log directory:
-    # ======================================================================= #
-    if cd_into_the_rbt_log_directory?
-      cd rbt_log_directory?, :be_quiet
-    end
-    # ======================================================================= #
-    # === Register the program for compilation
-    #
-    # Next, we have to register the name of the program somewhere,
-    # which is to be done through a method-call. But first we will
-    # try to sanitize it a little bit, if it includes at the least
-    # one '/' character.
-    # ======================================================================= #
-    i = i.to_s unless i.is_a? String
-    i = File.basename(i) if i.include? '/'
-    i = set_handle_this_program(i)
-    # ======================================================================= #
-    # Next, we will typically initialize a new cookbok instance.
-    # ======================================================================= #
-    if block_given?
-      if yield == :do_not_initialize_the_dataset
-      else
-        initialize_a_new_cookbook_instance(i) # ← Instantiate a new cookbook instance here.
-      end
-    end
-    determine_which_compiler_will_be_used
-    program_path = program_path?
-    if program_path.nil?
-      # ===================================================================== #
-      # This is a safeguard - but it is also the default, actually. The
-      # cookbook-dataset is much more likely to contain the local "URL"
-      # to the program at hand.
-      # ===================================================================== #
-      program_path = cookbook_dataset_program_path?
-    end
-    # ======================================================================= #
-    # Sometimes we must re-write the program path, e. g. if we take
-    # another program version. The following method does that for us.
-    # ======================================================================= #
-    # consider_sanitizing_the_program_path
-    # determine_the_configure_base_directory_to_use
-    unless File.exist? program_path
-      # ===================================================================== #
-      # === Download the program if it does not yet exist locally
-      #
-      # Download the program if it does not exist here. This functionality
-      # must come before we try to extract the program.
-      #
-      # Obtain the program path first, though.
-      # ===================================================================== #
-      download_program
-      unicode_middle_cliner # Looks better with cliner, I think.
-    end
-    # ======================================================================= #
-    # === Set special environment variables
-    #
-    # Next, ensure that if the cookbooks file at hand is using any special
-    # environment variable, that this will also be used. For example,
-    # the program called "htop" will use these LDFLAGS: -ltinfow,
-    # so this has to be enabled.
-    # This should come before we will check for ccache.
-    # ======================================================================= #
-    considering_setting_any_special_environment_variable
-    # ======================================================================= #
-    # === (1) Consider changing the tab title:
-    #
-    # Changing the name of the tab title should happen only after the
-    # program name was set. The method will check whether we will actually
-    # do any tab-change action or not. Note that when we refer to "tab",
-    # we really mean KDE konsole tabs primarily.
-    # 
-    # The variable called `use_this_as_tab_title` will keep track of the
-    # tab-title that is to be used for the KDE konsole tab title.
-    # ======================================================================= #
-    use_this_as_tab_title = :default
-    if check_whether_the_given_input_is_a_file_and_does_exist? and
-       does_this_file_exist_and_is_it_a_file?(i) # This may be the case when the user supplied a path.
-       use_this_as_tab_title = remove_archive_at_the_end(File.basename(i))
-    end
-    # ======================================================================= #
-    # === Honour the "do_not_download" settings if it exists.
-    # ======================================================================= #
-    do_not_download if cookbook_dataset?.do_not_download?
-    consider_changing_the_tab_title(use_this_as_tab_title)
-    # ======================================================================= #
-    # Keep track of the base-directory onto which we will extract.
-    # ======================================================================= #
-    set_extract_to_this_directory(
-      TEMP_DIR_FOR_RBT+
-      program_name_and_program_version?.to_s
-    )
-    # ======================================================================= #
-    # Also reset the compiled n-times counter next.
-    # ======================================================================= #
-    reset_compiled_n_times_counter
-    program_path = program_path?
-    # ======================================================================= #
-    # Notify the user which program will be compiled/installed next. This
-    # requires the name of the program, as well as the assumed program
-    # path.
-    # ======================================================================= #
-    notify_the_user_as_to_which_program_will_be_compiled_or_installed_next(
-      i, program_path
-    )
-    # ======================================================================= #
-    # === Consider showing the Flexbox next      (flexbox tag, infobox tag)
-    #
-    # Consider showing the fluxbox next. The flexbox may also show
-    # the required dependencies of the given program at hand, which
-    # should always come before the archive at hand is extracted.
-    #
-    # A configuration showing the dependencies, within the file called 
-    # "always_show_dependencies.yml".
-    #
-    # Note that since as of Nov 2017, the default is to not always show 
-    # the dependencies, so the user has to specifically enable this 
-    # option if he/she wants to have that.
-    #
-    # In the old code, we used to call the method
-    # feedback_dependencies_of_the_program() rather than
-    # show the flexbox at hand.
-    # ======================================================================= #
-    consider_showing_the_flexbox
-    # ======================================================================= #
-    # First, check whether we have to extract the archive at hand. We do
-    # not have to extract .gem files, since "gem" does this for us.
-    # ======================================================================= #
-    skip_extracting_if_it_is_a_gem_file
-    we_can_not_continue if an_error_has_occurred?
-    if is_a_gem_file?(program_path)
-      install_ruby_gem(program_path) # Install this rubygem.
-    else
-      # ===================================================================== #
-      # Check whether the archive exists. If not then notify the user about
-      # it. This has to happen before we consider removing the old
-      # extracted archive directory.
-      # ===================================================================== #
-      unless File.exist? program_path
-        opne "No archive exists at `#{sfile(program_path)}`."
-        opne 'As it was specified to extract the archive in this '\
-             'case, yet this'
-        opne 'archive could not be found at the above reported path, '\
-             'we will exit'
-        opne 'now. You may consider downloading the source archive, '\
-             'should'
-        opne 'it exist.' 
-        exit_program
-      end
-      unless skip_extracting?
-        consider_removing_the_old_extracted_directory_if_it_exists
-      end
-      # ===================================================================== #
-      # === (2) Set the CFLAGS next.
-      #
-      # This should come before we extract the program. We will also
-      # honour the build_static variable.
-      #
-      # We will do this only for programs that have to be compiled, though.
-      # ===================================================================== #
-      if has_to_be_compiled?
-        if build_static?
-          # ================================================================= #
-          # Honour static compilation settings in the ymal file.
-          # ================================================================= #
-          opne 'The yaml file specifies that this program is to '\
-               'be '+steelblue('compiled statically')+'.'
-          opne "Thus, we will use these CFLAGS: "\
-               "#{lightblue(default_cflags?)}"
-          # ================================================================= #
-          # We also have to scan the configure command string. If that string
-          # contains an instruction such as "--disable-static", then we will
-          # get rid of it, and notify the user. The reason is that, quite
-          # obviously, we can not have conflicting options passed.
-          # Note that this may be changed at a later time in the future, if
-          # we decide that only user-supplied options to RBT may change this
-          # behaviour. For now, we simply add a way to check the logic on
-          # it, which is an improvement over the old code which did not
-          # do any logic-checking at all whatsoever.
-          # ================================================================= #
-          configure_options = configure_options?
-          if configure_options.include? '--disable-static'
-            opne 'The configure option to '+sfancy(compile_which_program?)+
-                 ' is using the option called '+simp('--disable-static')+'.'
-            opne "As this #{steelblue('would contradict')} with our goal "\
-                 "to enable static compilation,"
-            opne 'this option was replaced with --enable-static, from '\
-                 'the configure command string.'
-            cookbook_dataset?.configure_options = configure_options?.sub(
-              /-?-?disable-?static/, '--enable-static'
-            )
-          end
-          set_cflags(:build_static)
-        end
-      end
-      return unless can_we_continue? # This should come before we extract anything.
-      if File.exist? program_path
-        extract_the_program(program_path?)
-      end
-      # ======================================================================= #
-      # Next, exit if this was specified that way.
-      # ======================================================================= #
-      exit_program if extract_only?
-      ensure_that_the_configure_options_are_consistent_in_regards_to_static_compilation
-      if program_path and File.exist?(program_path)
-        consider_creating_the_appdir_skeleton
-        # =================================================================== #
-        # Next, change to the extracted directory. We will also have to
-        # honour the configure_base_dir setting.
-        # =================================================================== #
-        cd_into_this_directory = rds(
-          TEMP_DIR_FOR_RBT+
-          program_name_and_program_version?+'/'+
-          configure_base_dir?.to_s
-        )
-        cd cd_into_this_directory
-        opne "We are in the directory #{sdir(return_pwd)}."
-        # =================================================================== #
-        # === Handle patches
-        #
-        # Consider applying a patch next - this should come before the
-        # preinstall action and before the sed-action, but after the
-        # optional start message.
-        # =================================================================== #
-        consider_applying_a_patch
-        # =================================================================== #
-        # === Optional start messages
-        #
-        # Display optional start message here, right before we continue
-        # to the preinstall? stage and other stages.
-        # =================================================================== #
-        consider_displaying_the_start_message
-        # =================================================================== #
-        # (4) Reset any possible error message at this point.
-        # =================================================================== #
-        RBT.reset_error_message
-        # =================================================================== #
-        # === Check for sed-action
-        #
-        # Next, we check whether we must apply sed. It must come before any
-        # preinstall-action, and after we have cd-ed to the correct directory.
-        # This also means after we have extracted the archive at hand.
-        # =================================================================== #
-        check_for_sed_action
-        # =================================================================== #
-        # === Pre-install actions
-        #
-        # Next, handle pre-install actions first, should they exist. These
-        # should come after we have checked for sed-related actions.
-        # =================================================================== #
-        run_preinstall_actions
-        # =================================================================== #
-        # Next register that we are compiling a program.
-        # =================================================================== #
-        register_that_this_program_is_currently_being_compiled
-        run_pre_configure_steps_if_requested_to_do_so
-        decide_whether_to_build_statically
-        # =================================================================== #
-        # === The (optional) autogen-step
-        #
-        # Consider running "autogen" next.
-        #
-        # This should come after the archive was already extracted, and
-        # after pre-installation steps were performed - but it should come
-        # BEFORE we invoke "autoconf" (the latter one is an optional step
-        # as well, though).
-        # =================================================================== #
-        decide_whether_to_invoke_autogen # (autogen tag)
-        decide_whether_to_invoke_the_autoconf_command # This must occur after the pre-installation step.
-        run_configure_like_stage
-        check_for_common_problems_and_common_errors
-        # =================================================================== #
-        # Consider symlinking glib-schema files into the /usr/ hierarchy.
-        # =================================================================== #
-        consider_symlinking_glib_schema_files_into_the_usr_share_hierarchy
-        # =================================================================== #
-        # Make our instance of SymlinkProgram behave properly - this should
-        # come before we perform postinstallation actions, and after the
-        # glib schema files were symlinked.
-        # =================================================================== #
-        prepare_symlink_program_instance
-      else
-        opne 'No file was found at `'+program_path?.to_s+'`.'
-      end
-    end
-    if has_an_error_occurred?
-      opne swarn('An error has occurred in the directory ')+
-           sdir(return_pwd)+
-           swarn('.')
-      opne swarn('We will most likely not be able to continue.')
-      we_can_not_continue
-    end
-    # ======================================================================= #
-    # === Handle empty subdirectories
-    #
-    # Next we will consider removing empty subdirectories. This has to
-    # happen here again, after the postinstall step, because the installation
-    # may have failed. The method will also do a more general clean-up
-    # step in the respective AppDir prefix.
-    # ======================================================================= #
-    consider_removing_empty_subdirectories
-    store_time_snapshot
-    # ======================================================================= #
-    # Report to the user how long it took us to compile/install the program
-    # at hand.
-    # ======================================================================= #
-    consider_reporting_the_time_it_took_to_compile_this_program
-    # ======================================================================= #
-    # Next, compare the installed libraries versus the assumed
-    # libraries. This can then be used to updated the dataset.
-    # ======================================================================= #
-    if ignore_errors_anyway? or successfully_compiled?
-      # ===================================================================== #
-      # Next, consider performing postinstallation steps:
-      # ===================================================================== #
-      consider_performing_postinstallation_actions # ← Postinstallation step
-      # ===================================================================== #
-      # Consider stripping the compiled binaries.
-      # ===================================================================== #
-      if had_to_be_compiled?
-        # =================================================================== #
-        # Next check whether we have to strip the compiled binaries or
-        # whether we do not have to strip them. The checks are done
-        # with the method itself, so we don't have to do any conditional
-        # checks here at this point.
-        # =================================================================== #
-        do_strip_the_compiled_binaries
-        # =================================================================== #
-        # Next, we will consider creating and populating the subdirectory
-        # called "lib/pkgconfig/". This may be necessary for programs that
-        # install into "share/pkgconfig/" rather than "lib/pkgconfig".
-        #
-        # This step has to be done before we call the method
-        # consider_symlinking_the_pkgconfig_files().
-        # =================================================================== #
-        consider_creating_and_populating_the_pkgconfig_directory
-        # =================================================================== #
-        # Next register the configure-line into the configure "database",
-        # unless a problem or error has occurred.
-        # =================================================================== #
-        if no_problem_was_encountered? and
-           no_error_was_encountered?
-          # ================================================================= #
-          # Register the configure-line that was used into the "global"
-          # configure database next:
-          # ================================================================= #
-          register_configure_line_into_configure_database
-          # ================================================================= #
-          # If the cookbook file at hand has symlinking_pkgconfig_files
-          # enabled, and if the program is compiled, as AppDir, then we
-          # will symlink .pc iles into /usr/lib/pkgconfig/, if the
-          # latter one exists.
-          #
-          # This should actually be part of the post-installation actions,
-          # but before running ldconfig.
-          # ================================================================= #
-          consider_symlinking_the_pkgconfig_files
-          if did_we_use_an_appdir_prefix?
-            # ============================================================= #
-            # And store this into the app-dir prefix.
-            # ============================================================= #
-            do_store_the_configure_options_that_were_used_into_a_markdown_file
-            # ============================================================= #
-            # === Handle .gir files since as of 22.02.2020.
-            # ============================================================= #
-            if has_gir_files? and symlink_gir_files?
-              target_directory = '/usr/share/gir-1.0/'
-              symlink_the_available_gir_files_into_this_target_directory(target_directory)
-            end
-          end
-          # ================================================================= #
-          # Also register it to the file that keeps track of which
-          # programs were compiled successfully.
-          # ================================================================= #
-          register_last_compiled_program
-        end
-      end
-      # ===================================================================== #
-      # Make sure that the registered binaries are already registered, if
-      # the program has been compiled successfully. This will only be run
-      # on my home setup, though.
-      # ===================================================================== #
-      consider_checking_whether_the_compiled_binaries_are_already_registered
-      # ===================================================================== #
-      # Consider running "ldconfig" next.
-      # ===================================================================== #
-      consider_running_ldconfig
-    else
-      # ===================================================================== #
-      # Else a problem or an error may have occurred. We will thus check
-      # for that. The error will be re-set more on the beginning of
-      # this method rather than its end.
-      # ===================================================================== #
-      check_for_common_problems_and_common_errors
-    end
-    consider_comparing_the_installed_libraries_versus_the_assumed_libraries
-    # ======================================================================= #
-    # === Go back to the temp-directory again
-    #
-    # Return to the temp-directory as start again. This has to happen
-    # because the underlying directory may have been removed, so we
-    # need to go to a "stable" directory instead.
-    #
-    # The second argument exists so that we are silent about this.
-    # ======================================================================= #
-    change_directory(temp_directory?, :do_not_report_anything)
-    unless keep_extracted?
-    # ======================================================================= #
-    # === Remove the extracted archive / directory
-    #
-    # We have to clean-up again, by removing the extracted archive. This
-    # behaviour can be changed by the user, though. Additionally, the
-    # individual .yml file may decide for us whether we will remove the
-    # extracted directory or whether we will keep that directory. User
-    # instructions overrule the settings in the .yml file, though.
-    # ======================================================================= #
-      do_remove_the_extracted_archive
-    end
-    # ======================================================================= #
-    # Ensure that the expanded cookbook .yml file exists:
-    #
-    # Note that this has been disabled on 10.10.2019, because it is a
-    # bit buggy. We may have to re-enable this at a later time, but
-    # this requires that we first fix the code that would generate
-    # the expanded cookbook dataset.
-    # ======================================================================= #
-    if is_on_roebe? and
-      !does_the_expanded_cookbook_file_exist_for_this_program?(i)
-      expand_this_cookbook(i)
-    end
-    # ======================================================================= #
-    # Also store the prefix that we used on the toplevel namespace.
-    # ======================================================================= #
-    RBT.set_last_prefix_used(use_which_prefix?)
-    consider_changing_the_tab_title :clear
-    # ======================================================================= #
-    # Show success or failure - this should come last.
-    # ======================================================================= #
-    show_success_or_failure_status
-  end; alias compile_this_program do_compile_this_program # === compile_this_program
-
-  # ========================================================================= #
-  # === set_handle_this_program
-  #
-  # This method has to be used to register the name of the current
-  # program that is to be compiled or installed.
-  # ========================================================================= #
-  def set_handle_this_program(
-      i, &block
-    )
-    return if i and
-              i.respond_to?(:start_with?) and
-              i.start_with?('--') # Ignore '--' entries.
-    if i.is_a? Array # Only consider the first input argument here.
-      i = i.first
-    end
-    i = i.to_s.dup
-    i = remove_archive_at_the_end(
-      File.basename(
-        i.to_s.dup.downcase.delete('/_-') # ← Get rid of '/', '_' and other characters.
-      )
-    ) unless is_an_archive?(i)
-    # ======================================================================= #
-    # === Ad-hox fix libtool files if given to RBT::Compile next
-    #
-    # Invocation example:
-    #
-    #   rbt libgdk-3.la
-    #
-    # ======================================================================= #
-    if i.respond_to?(:end_with?) and
-       i.end_with?('.la') and
-      !File.exist?(i)
-      do_not_try_to_autofix
-      opne "Trying to autocorrect the libtool entry at "\
-           "#{royalblue(i)}"
-      try_to_autocorrect_this_erroneous_libtool_entry(
-        i
-      )
-      return # And "exit" here.
-    end
-    # ======================================================================= #
-    # Enable is-on-gobolinux if a certain .md file exists:
-    # ======================================================================= #
-    target_file = "#{log_dir?}is_on_gobolinux.md"
-    if File.exist?(target_file) and
-      !File.empty?(target_file)
-      # ===================================================================== #
-      # The above file must have been set on a GoboLinux system, when the
-      # user did a rbt --auto before (or created the file manually).
-      # ===================================================================== #
-      enable_is_on_gobolinux
-    end
-    # ======================================================================= #
-    # Keep track of the program we are compiling in the following variable;
-    # after all that's the whole point of this method. :)
-    # ======================================================================= #
-    @handle_this_program = i.dup # Must be a String.
-    return @handle_this_program
-  end; alias set_compile_this_program set_handle_this_program # === set_compile_this_program
-       alias set_program_name         set_handle_this_program # === set_program_name
-
-  # ========================================================================= #
-  # === handle_this_program?
-  #
-  # This is the variable that will keep track of the program that the
-  # user wants to install or compile next.
-  #
-  # It has to be set anew whenever a new program is compiled.
-  # ========================================================================= #
-  def handle_this_program?
-    @handle_this_program
-  end; alias program_name?            handle_this_program? # === program_name?
-       alias handle_which_program?    handle_this_program? # === handle_which_program?
-       alias search_for_this_program? handle_this_program? # === search_for_this_program?
-       alias compile_which_program?   handle_this_program? # === compile_which_program?
-       alias compile_this_program?    handle_this_program? # === compile_this_program?
-       alias compile_these_programs?  handle_this_program? # === compile_these_programs?
-       alias which_program?           handle_this_program? # === which_program?
-       alias program?                 handle_this_program? # === program?
-       alias internal_program_name?   handle_this_program? # === internal_program_name?
-       alias compile_this_program?    handle_this_program? # === compile_this_program?
-       alias this_program?            handle_this_program? # === this_program?
-       alias first_arg                handle_this_program? # === first_arg
-       alias name_of_program?         handle_this_program? # === name_of_program?
-       alias real_program_name?       handle_this_program? # === real_program_name?
-       alias name?                    handle_this_program? # === name?
-       alias program_to_compile?      handle_this_program? # === program_to_compile?
-
-  # ========================================================================= #
-  # === do_compile_in_a_non_traditional_way
-  #
-  # We enable Gobolinux-style compilation here, as in AppDir-like
-  # compilation.
-  # ========================================================================= #
-  def do_compile_in_a_non_traditional_way(
-      program_name_and_program_version = program_name_and_program_version?,
-      be_verbose                       = true
-    )
-    if can_we_continue?
-      case program_name_and_program_version
-      when :be_silent,
-           :be_quiet
-        be_verbose = false
-        program_name_and_program_version = program_name_and_program_version?
-      end
-      case be_verbose
-      when :be_silent,
-           :be_quiet
-        be_verbose = false
-      end
-      if be_verbose
-        opne 'Overruling any potential traditional setting.'
-      end
-      @internal_hash[:counter_called_traditional_or_non_traditional_compilation] += 1
-      ensure_that_a_cookbook_object_has_been_instantiated
-      set_user_prefix :ntrad
-      opne 'Enabling AppDir prefix.'
-      enable_non_traditional_compilation(
-        program_name_and_program_version
-      )
-    end
-  end; alias enable_non_traditional_compilation do_compile_in_a_non_traditional_way # === enable_non_traditional_compilation
-       alias set_standalone_compilation         do_compile_in_a_non_traditional_way # === set_standalone_compilation # This is a legacy alias.
-       alias compile_as_appdir                  do_compile_in_a_non_traditional_way # === compile_as_appdir
-       alias ntrad                              do_compile_in_a_non_traditional_way # === ntrad
-       alias use_non_traditional_prefix         do_compile_in_a_non_traditional_way # === use_non_traditional_prefix
-       alias do_run_via_nontraditional_way      do_compile_in_a_non_traditional_way # === do_run_via_nontraditional_way
-       alias do_use_an_appdir_prefix            do_compile_in_a_non_traditional_way # === do_use_an_appdir_prefix
-
-  # ========================================================================= #
-  # === do_compile_in_a_traditional_way
-  #
-  # Use this method when you want to use '/usr/' as the main prefix of
-  # compilation.
-  #
-  # Usage example:
-  #
-  #   ry php --trad
-  #
-  # ========================================================================= #
-  def do_compile_in_a_traditional_way(
-      be_verbose      = true,
-      can_we_continue = can_we_continue?
-    )
-    if can_we_continue
-      @internal_hash[:we_tried_to_compile_this_program_n_times] += 1
-      if be_verbose
-        opne 'Using a "'+sfancy(:traditional)+'" strategy for compilation '\
-             '(which means prefix '+sdir('/usr/')+').'
-      end
-      set_user_prefix '/usr/' # Specify a user-prefix here.
-    end
-  end; alias enable_traditional_compilation do_compile_in_a_traditional_way # === enable_traditional_compilation
-
-  # ========================================================================= #
-  # === run_configure_like_stage
-  # ========================================================================= #
-  def run_configure_like_stage
-    # use_this_build_system = cookbook_dataset_use_this_build_system?
-    use_this_build_system = build_system? # ^^^ commented that out in July 2021. 
-    case use_this_build_system
-    # ======================================================================= #
-    # === meson
-    # ======================================================================= #
-    when 'meson'
-      do_install_via_meson
-    # ======================================================================= #
-    # === ninja
-    # ======================================================================= #
-    when 'ninja'
-      # ===================================================================== #
-      # Since as of 02.10.2018, we try to use ninja here automatically,
-      # if the cookbook_dataset has a dependency on ninja.
-      # ===================================================================== #
-      set_use_this_make_command('ninja')
-    # ======================================================================= #
-    # === waf
-    # ======================================================================= #
-    when 'waf'
-      run_waf_based_installation
-    # ======================================================================= #
-    # === cmake
-    # ======================================================================= #
-    when 'cmake'
-      do_install_via_cmake
-    # ======================================================================= #
-    # === scons
-    # ======================================================================= #
-    when 'scon'
-      run_scons_based_installation
-    else # this else-clause also covers :infer_automatically.
-      # ===================================================================== #
-      # === :infer_automatically
-      #
-      # This else clause will usually run GNU configure, aka
-      # './configure'.
-      # ===================================================================== #
-      # ===================================================================== #
-      # In this case we have to guess the build type, before we proceed,
-      # since we have given the path to a file that exists.
-      #
-      # This code was disabled in April 2021. Let's see if we will need
-      # it again one day.
-      # ===================================================================== #
-      # guessed_build_type = guess_build_type
-      # opne "Guessing the build-type next ... the build type is: "\
-      #      "#{slateblue(':'+guessed_build_type.to_s)}"
-      # ===================================================================== #
-      # === This entry clause is specifically for perl
-      # ===================================================================== #
-      if configure_command_to_use? and File.exist?(configure_command_to_use?)
-        do_run_GNU_configure_then_make_then_make_install(configure_command_to_use?)
-      # ===================================================================== #
-      # === Handle 'configure' next, if such a file exists
-      # ===================================================================== #
-      elsif File.exist? 'configure'
-        do_run_GNU_configure_then_make_then_make_install
-      # ===================================================================== #
-      # === Handle setup.py first
-      # ===================================================================== #
-      elsif File.exist?(RBT::FILE_SETUP_PY) 
-        run_python_installation
-      # ===================================================================== #
-      # === This is also for perl, if Makefile.PL exists
-      # ===================================================================== #
-      elsif File.exist?('Makefile.PL')
-        esystem 'perl Makefile.PL'
-        run_make_then_make_install
-      # ===================================================================== #
-      # === Handle meson next
-      # ===================================================================== #
-      elsif File.exist? RBT::FILE_MESON_BUILD
-        do_install_via_meson
-      # ===================================================================== #
-      # === Handle cmake next
-      #
-      # This will be based on the file "CMakeLists.txt".
-      # ===================================================================== # 
-      elsif cmake_file_exists?
-        do_install_via_cmake
-      # ===================================================================== #
-      # === Handle plain Makefile next
-      # ===================================================================== #
-      elsif File.exist? 'Makefile'
-        run_make_then_make_install
-      # ===================================================================== #
-      # === Handle ruby setup.rb next
-      # ===================================================================== #
-      elsif File.exist? 'setup.rb'
-        esystem 'ruby setup.rb'
-      else
-        opne 'Nothing useful found in '+sdir(return_pwd)+'.'
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === compile_the_main_program_including_the_dependencies
-  # ========================================================================= #
-  def compile_the_main_program_including_the_dependencies
-    ensure_that_the_main_dataset_exists
-    # ======================================================================= #
-    # Prepend to this chain the known dependencies.
-    # ======================================================================= #
-    _ = compile_these_programs?
-    _.prepend(
-      required_deps_on?
-    )
-    _.flatten!
-    set_array_compile_these_programs(_)
-  end
-
-  # ========================================================================= #
-  # === compile_all_programs_that_belong_to_this_tag
-  #
-  # Invocation examples:
-  #
-  #   rbt --compile-this-tag=gnome
-  #   rbt --compile-this-tag=kde
-  #   rbt --compile-this-tag=kde5
-  #   rbt --compile-this-tag=game
-  #
-  # ========================================================================= #
-  def compile_all_programs_that_belong_to_this_tag(i)
-    # ======================================================================= #
-    # (1) first obtain all programs that belong to a particular tag
-    # ======================================================================= #
-    these_programs = RBT.return_array_of_this_tag(i)
-    # ======================================================================= #
-    # (2) then set to the main array
-    # ======================================================================= #
-    set_compile_these_programs(
-      these_programs
-    )
-  end
-
-  # ========================================================================= #
-  # === compile_this_existing_file
-  #
-  # This method can be used to compile an existing file.
-  # ========================================================================= #
-  def compile_this_existing_file(
-      i = first_argument?
-    )
-    _ = extract_to?.dup
-    extract_this_source_archive(i, _)
-    sanitized_first_argument = remove_archive_at_the_end(
-      return_program_name_hyphen_then_program_version_or_first_argument
-    )
-    unless _.end_with? sanitized_first_argument
-      _ << sanitized_first_argument
-    end
-    _ = remove_archive_from_the_end(_)
-    opnn; e 'Changing directory into '+sdir(_)+' next.'
-    cd _
-    run_configure
-    run_make_then_make_install
-  end; alias extract_this_archive_then_compile_it compile_this_existing_file # === extract_this_archive_then_compile_it
-
-  # ========================================================================= #
-  # === initialize_a_new_cookbook_instance
-  #
-  # The first argument to this method should be the program that the
-  # user wants to wish to compile or install, as a String, such as
-  # "php" or "ruby" or something like that.
-  #
-  # Since as of January 2018, whenever you need an instance from
-  # class RBT::Cookbooks::SanitizeCookbook, this method here
-  # should be used.
-  #
-  # The reason is simple:
-  #
-  # - This method will do all the required invocations needed
-  #   to properly instantiate a new Cookbook instance.
-  #
-  # ========================================================================= #
-  def initialize_a_new_cookbook_instance(
-      i                 = @array_compile_these_programs.first,
-      simple_or_complex = simple_or_complex?
-    )
-    @cookbook = RBT::Cookbooks::SanitizeCookbook.new(i) {{
-      make_use_of_aliases_kept_in_the_file_cookbook_aliases: make_use_of_cookbook_aliases?,
-      simple_or_complex:                                     simple_or_complex
-    }}
-    return @cookbook # Always return the dataset as well here.
-  end; alias initialize_dataset_for                                  initialize_a_new_cookbook_instance # === initialize_dataset_for
-       alias initialize_cookbook_dataset_for                         initialize_a_new_cookbook_instance # === initialize_cookbook_dataset_for
-       alias initialize_dataset_for                                  initialize_a_new_cookbook_instance # === initialize_dataset_for
-       alias initialize_dataset                                      initialize_a_new_cookbook_instance # === initialize_dataset
-       alias initialize_yaml_dataset                                 initialize_a_new_cookbook_instance # === initialize_yaml_dataset
-       alias initialize_dataset_for_this_program                     initialize_a_new_cookbook_instance # === initialize_dataset_for_this_program
-       alias initialize_cookbook_dataset                             initialize_a_new_cookbook_instance # === initialize_cookbook_dataset
-       alias instantiate_a_new_cookbook_for                          initialize_a_new_cookbook_instance # === instantiate_a_new_cookbook_for
-       alias instantiate_a_new_cookbook_instance                     initialize_a_new_cookbook_instance # === instantiate_a_new_cookbook_instance
-       alias instantiate_a_new_cookbook                              initialize_a_new_cookbook_instance # === instantiate_a_new_cookbook
-       alias create_a_new_cookbook_instance                          initialize_a_new_cookbook_instance # === create_a_new_cookbook_instance
-       alias determine_the_dataset_for_this_program                  initialize_a_new_cookbook_instance # === determine_the_dataset_for_this_program
-       alias determine_cookbook_dataset_for_this_program             initialize_a_new_cookbook_instance # === determine_cookbook_dataset_for_this_program
-       alias prepare_dataset_for                                     initialize_a_new_cookbook_instance # === prepare_dataset_for
-       alias load_yaml_dataset_for_this_program                      initialize_a_new_cookbook_instance # === load_yaml_dataset_for_this_program
-       alias update_dataset                                          initialize_a_new_cookbook_instance # === update_dataset
-       alias ensure_that_the_dataset_exists                          initialize_a_new_cookbook_instance # === ensure_that_the_dataset_exists
-       alias ensure_that_the_main_dataset_exists                     initialize_a_new_cookbook_instance # === ensure_that_the_main_dataset_exists
-       alias ensure_that_we_have_a_dataset                           initialize_a_new_cookbook_instance # === ensure_that_we_have_a_dataset
-       alias ensure_that_the_default_dataset_exists_for_this_program initialize_a_new_cookbook_instance # === ensure_that_the_default_dataset_exists_for_this_program
-       alias ensure_dataset_for_this_program                         initialize_a_new_cookbook_instance # === ensure_dataset_for_this_program
-       alias ensure_proper_dataset_for                               initialize_a_new_cookbook_instance # === ensure_proper_dataset_for
-       alias ensure_that_a_dataset_exists_for_this_program           initialize_a_new_cookbook_instance # === ensure_that_a_dataset_exists_for_this_program
-       alias ensure_that_the_dataset_exists_for_this_program         initialize_a_new_cookbook_instance # === ensure_that_the_dataset_exists_for_this_program
-       alias ensure_proper_dataset                                   initialize_a_new_cookbook_instance # === ensure_proper_dataset
-
-  # ========================================================================= #
-  # === set_on_ihash
-  # ========================================================================= #
-  def set_on_ihash(i)
-    @cookbook = i
-  end; alias set_cookbook set_on_ihash # === set_cookbook
-
-  # ========================================================================= #
-  # === compile_array?
-  # ========================================================================= #
-  def compile_array?
-    @array_compile_these_programs
-  end; alias array_compile_these_programs? compile_array? # === array_compile_these_programs?
-
-  # ========================================================================= #
-  # === set_compile_these_programs_then_batch_compile_them
-  #
-  # This method can be used to start batch-compiling several programs
-  # in one go.
-  # ========================================================================= #
-  def set_compile_these_programs_then_batch_compile_them(
-      i, consider_replacing_the_input = :default
-    )
-    set_compile_these_programs(i, consider_replacing_the_input) 
-    batch_compile_these_programs(i)
-  end
-
-  # ========================================================================= #
-  # === set_really_compile_this_program
-  # ========================================================================= #
-  def set_really_compile_this_program(i = :qt)
-    set_compile_this_program(i)
-    set_compile_these_programs(i) if compile_these_programs?.empty?
-    initialize_cookbook_dataset
-  end
-
-  # ========================================================================= #
-  # === do_compile_in_both_traditional_and_non_traditional_manner
-  #
-  # This method combines both main strategies for compilation - first,
-  # into the /usr/ prefix, and then into the appdir prefix.
-  # ========================================================================= #
-  def do_compile_in_both_traditional_and_non_traditional_manner
-    opne 'We will first compile in the traditional way, and then after that'
-    opne 'we will compile in the non-traditional (appdir) way.'
-    do_compile_in_a_traditional_way # First, compile in a traditional way.
-    @internal_hash[:extra_compilation] = true
-  end
-
-  require 'rbt/toplevel_methods/try_to_return_a_special_compile_component.rb'
-  # ========================================================================= #
-  # === try_to_return_a_special_compile_component
-  # ========================================================================= #
-  def try_to_return_a_special_compile_component(i)
-    RBT.try_to_return_a_special_compile_component(i)
-  end
-
-end; end