rbt 0.10.215 → 0.11.89

data/lib/rbt/installer/handle_installing_and_compiling_programs.rb

@@ -0,0 +1,2190 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rbt/installer/handle_installing_and_compiling_programs.rb'
+# =========================================================================== #
+require 'rbt/compile_base/compile_base.rb'
+
+module RBT
+
+class Installer < ::RBT::CompileBase # === RBT::Compile
+
+  require 'rbt/installer/meson_and_ninja_related_code.rb'
+  require 'rbt/installer/run.rb'
+
+  # ========================================================================= #
+  # === set_install_these_programs
+  #
+  # This setter-method will designate which programs are to be
+  # installed/compiled.
+  #
+  # The format for this will be an Array, such as:
+  #
+  #   ['htop','ruby','php']
+  #
+  # Note that this method will remove all '-' tokens from the given
+  # input at hand, if the second argument given to this method
+  # allows this method to do so.
+  # ========================================================================= #
+  def set_install_these_programs(
+      i                                  = first_argument?,
+      consider_replacing_the_given_input = :honour_user_configuration_setting
+    )
+    i = i.dup if i
+    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
+    # ======================================================================= #
+    # 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 ...
+    # ======================================================================= #
+    unless is_an_archive?(i)
+      _ = i.to_s.dup.downcase.delete('/') # ← Get rid of some unwanted characters. But no longer of '-'.
+      _replace_or_dont_replace = :honour_user_settings
+      if _.start_with?('--')
+        _replace_or_dont_replace = :do_not_replace
+        # This is not yet in use ^^^.
+      else
+        i = remove_archive_at_the_end(File.basename(_))
+      end
+    end
+    # ======================================================================= #
+    # Next, look for chained-programs.
+    # ======================================================================= #
+    _ = dataset_from_the_file_cookbook_chained_programs?
+    if _.has_key?(i) and
+      !does_include?(i)
+      i = _[i]
+    end
+    # ======================================================================= #
+    # Past this point we don't want "--" entries.
+    # ======================================================================= #
+    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/
+        # ^^^ removeing '-' can be problematic.
+        entry = entry.downcase
+        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
+    }
+    # ======================================================================= #
+    # 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".
+    # This was disabled in September 2022.
+    # ======================================================================= #
+    # 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
+    ::RBT.set_install_these_programs(i) { :remove_underscore }
+  end; alias set_compile_these_programs          set_install_these_programs # === set_compile_these_programs
+       alias set_array_compile_these_programs    set_install_these_programs # === set_array_compile_these_programs
+       alias compile_this=                       set_install_these_programs # === compile_this=
+       alias set_handle_this_program             set_install_these_programs # === set_handle_this_program
+       alias determine_which_programs_to_compile set_install_these_programs # === determine_which_programs_to_compile
+
+  # ========================================================================= #
+  # === find_the_corresponding_install_method_and_proceed_from_there
+  # ========================================================================= #
+  def find_the_corresponding_install_method_and_proceed_from_there
+    use_this_build_system = build_system_to_be_used?.to_sym
+    case use_this_build_system
+    # ======================================================================= #
+    # === :meson
+    # ======================================================================= #
+    when :meson
+      run_the_meson_steps
+    # ======================================================================= #
+    # === waf
+    # ======================================================================= #
+    when :waf
+      run_waf_based_installation
+    # ======================================================================= #
+    # === 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')
+    # ======================================================================= #
+    # === :cmake
+    # ======================================================================= #
+    when :cmake
+      run_the_cmake_steps
+    # ======================================================================= #
+    # === :python
+    # ======================================================================= #
+    when :python
+      run_the_python_steps
+    # ======================================================================= #
+    # === :perl
+    # ======================================================================= #
+    when :perl
+      run_the_perl_steps
+    # ======================================================================= #
+    # === scons
+    # ======================================================================= #
+    when :scon
+      run_scons_based_installation
+    # ======================================================================= #
+    # === :configure
+    # ======================================================================= #
+    when :configure
+      run_the_gnu_configure_steps
+    # ======================================================================= #
+    # === :configure_requiring_autoconf_step
+    # ======================================================================= #
+    when :configure_requiring_autoconf_step
+      do_invoke_autoconf
+      run_the_gnu_configure_steps
+    # ======================================================================= #
+    # === :infer_automatically
+    #
+    # This is kind of similar to the original else-clause in class
+    # RBT::Compile.
+    # ======================================================================= #
+    when :infer_automatically
+      # ======================================================================= #
+      # 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. In September 2022 it was re-enabled.
+      # ======================================================================= #
+      _ = RBT.infer_build_system
+      opne "#{gold('Guessing the build-type next ...')} the build "\
+           "type is: #{slateblue(':'+_.to_s)}"
+      if _.nil?
+        _ = :inferring_the_build_system_did_not_work
+      else
+        _ = _.to_sym
+      end
+      case _
+      # ======================================================================= #
+      # === :meson
+      # ======================================================================= #
+      when :meson
+        run_the_meson_steps
+      # ======================================================================= #
+      # === :python
+      # ======================================================================= #
+      when :python
+        run_the_python_steps
+      # ======================================================================= #
+      # === :perl
+      # ======================================================================= #
+      when :perl
+        run_the_perl_steps
+      # ======================================================================= #
+      # === :cmake
+      # ======================================================================= #
+      when :cmake
+        run_the_cmake_steps
+      # ======================================================================= #
+      # === waf
+      # ======================================================================= #
+      when :waf
+        run_waf_based_installation
+      # ======================================================================= #
+      # === :ninja
+      # ======================================================================= #
+      when :ninja
+        set_use_this_make_command('ninja')
+      # ======================================================================= #
+      # === scons
+      # ======================================================================= #
+      when :scon
+        run_scons_based_installation
+      # ======================================================================= #
+      # === :configure
+      # ======================================================================= #
+      when :configure
+        run_the_gnu_configure_steps
+      # ======================================================================= #
+      # === :configure_requiring_autoconf_step
+      # ======================================================================= #
+      when :configure_requiring_autoconf_step
+        do_invoke_autoconf
+        run_the_gnu_configure_steps
+      # ======================================================================= #
+      # === :make
+      # ======================================================================= #
+      when :make
+        run_make_then_make_install
+      # ======================================================================= #
+      # === Handle setup.py next
+      # ======================================================================= #
+      else
+        # =================================================================== #
+        # Note that this clause also covers the problem where the build system
+        # returns the symbol :inferring_the_build_system_did_not_work.
+        # In this case we will still try to make sense of the given situation,
+        # as much as that is possible - hence the subsequent checks.
+        # =================================================================== #
+        if File.exist?(RBT::FILE_SETUP_PY)
+          run_python_installation
+        # =================================================================== #
+        # === Handle ruby setup.rb next
+        # =================================================================== #
+        elsif File.exist?('setup.rb')
+          colourized_and_padded_esystem 'ruby setup.rb'
+        # =================================================================== #
+        # === This entry clause is specifically for perl
+        # =================================================================== #
+        elsif configure_command_to_use? and File.exist?(configure_command_to_use?)
+          do_run_GNU_configure_then_make_then_make_install(configure_command_to_use?)
+        # =================================================================== #
+        # === This entry tries to handle programs such as "duktape", which
+        #     come with plenty of different "Makefile.*" files, but no
+        #     configure script. This functionality was added on February 2023.
+        # =================================================================== #
+        elsif (result = Dir['Makefile.*'].size) > 1
+          opne 'Assuming a Makefile-based program, thus invoking the'
+          opne 'command stored in '+
+               steelblue('use_this_make_command:')+
+               rev+' next'
+          e
+          colourized_and_padded_esystem use_this_make_command?
+          e
+        else
+          opne tomato('Not yet implemented or understood: ')+
+               lightgreen(
+                 _.to_s
+               )+' [Directory: '+sdir(return_pwd)+']'
+        end
+      end
+    else
+      opne "Not implemented: #{_}"
+    end
+  end; alias run_configure_like_stage find_the_corresponding_install_method_and_proceed_from_there # === run_configure_like_stage
+
+  # ========================================================================= #
+  # === 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?
+    )
+    # ======================================================================= #
+    # First check whether we really want to run the configure script:
+    # ======================================================================= #
+    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
+      # ======================================================================= #
+      # === :infer_automatically
+      # ======================================================================= #
+      when :infer_automatically
+        use_this_configure_command = return_build_type
+      else
+        use_this_configure_command = 'configure'
+      end
+    end
+    _ = ''.dup # ← We will start with this here.
+    if use_build_directory?
+      create_the_build_directory_then_cd_into_it { :be_verbose }
+      _.prepend('.')
+    end
+    # ======================================================================= #
+    # === Honour ccache
+    #
+    # Honour the CCACHE setting, if it has been provided. This must come
+    # after we did the _.prepend('.') call.
+    # ======================================================================= #
+    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
+    # ======================================================================= #
+    # 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_for?
+      configure_options_to_use = configure_options?
+                                 # return_the_appropriate_configure_options(
+                                 # use_this_configure_command
+                                 # ).to_s.dup.rstrip
+                                 # ^^^ the above is not needed because we
+                                 #     know the build type already.
+      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.
+    reset_error_map_line_to_a_specific_error # ← Must come before the sys-command.
+    run_this_system_command_in_a_coloured_and_padded_manner(full_configure_command?) { :also_pad_via_cliner }
+    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
+
+  # ========================================================================= #
+  # === use_this_make_install_command?
+  # ========================================================================= #
+  def use_this_make_install_command?
+    cookbook_dataset?.use_this_make_install_command?
+  end
+
+  # ========================================================================= #
+  # === run_the_cmake_steps                                       (cmake tag)
+  #
+  # This method will run the corresponding "cmake" command.
+  #
+  # It will, after running "cmake", do the equivalent of:
+  #
+  #   - premake
+  #   - make
+  #   - make install
+  #
+  # ========================================================================= #
+  def run_the_cmake_steps
+    # ======================================================================= #
+    # We should check whether cmake exists on the host system or whether
+    # it does not.
+    # ======================================================================= #
+    if cmake_exists?
+      cmd = "cmake".dup
+      if do_we_use_any_prefix? # Check whether the user wants to use a prefix at all.
+        cmd << " -DCMAKE_INSTALL_PREFIX=#{prefix?}"
+      end
+      cmake_configure_options = cmake_configure_options?
+      # ======================================================================= #
+      # Append the cmake-configure options next:
+      # ====================================================================== #
+      if cmake_configure_options and !cmake_configure_options.empty?
+        cmd << " #{cmake_configure_options}"
+      end
+      cmd << ' .'
+      if use_build_directory?
+        create_the_build_directory_then_cd_into_it { :be_verbose }
+        cmd << '.'
+      end
+      cmd.squeeze!(' ')
+      cmd.strip!
+      # ======================================================================= #
+      # === Check for more than one -DCMAKE_INSTALL_PREFIX entry next
+      #
+      # This should never be the case, so we will do some quality-control
+      # and exit if this is the case so.
+      # ======================================================================= #
+      scanned_result = cmd.scan(/-DCMAKE_INSTALL_PREFIX=/)
+      if scanned_result.size > 1
+        # =================================================================== #
+        # In this case, something must be wrong. Notify the user about it.
+        # That way this can be corrected eventually.
+        # =================================================================== #
+        opnewarn "There are at the least two definitions of "\
+                 "#{royalblue('-DCMAKE_INSTALL_PREFIX=')}"
+        opnewarn "in the .yml file at hand."
+        opnewarn 'At the least one of these entries must be incorrect '\
+                 'and/or superfluous. Please '
+        opnewarn 'correct this logic-problem because RBT can continue to work.'
+        e
+        e 'See:'
+        e
+        e "  #{sfancy(_)}"
+        e
+        exit_program
+      end
+      # ======================================================================= #
+      # Finally the cmake-command has been built up. We can now push it
+      # towards the general method that handles output.
+      # ======================================================================= #
+      reset_error_map_line_to_a_specific_error
+      set_full_configure_command(cmd)
+      opne 'Next running'
+      run_this_system_command_in_a_coloured_and_padded_manner(cmd) # Using this since as of 28.08.2022.
+      run_premake_then_make_then_make_install
+      # ======================================================================= #
+      # Now that the cmake, premake, make, make install was run we scan
+      # through the registered problems/errors and act on it, before
+      # resetting the error-line again.
+      # ======================================================================= #
+      run_through_the_registered_problems_registered_errors_and_behaviour_changes
+      reset_error_map_line_to_a_specific_error
+    else
+      # ======================================================================= #
+      # The user should be informed that "cmake" could not be found here.
+      # ======================================================================= #
+      notify_the_user_that_cmake_could_not_be_found
+      we_can_not_continue
+    end
+  end; alias run_cmake_command                                  run_the_cmake_steps # === run_cmake_command
+       alias run_the_cmake_command                              run_the_cmake_steps # === run_the_cmake_command
+       alias run_cmake_then_premake_then_make_then_make_install run_the_cmake_steps # === run_cmake_then_premake_then_make_then_make_install
+       alias do_install_via_cmake                               run_the_cmake_steps # === run_cmake_then_premake_then_make_then_make_install
+
+  # ========================================================================= #
+  # === do_install_the_programs              (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::Installer.
+  # ========================================================================= #
+  def do_install_the_programs
+    do_install_these_programs
+  end; alias start_to_compile_the_programs do_install_the_programs # === start_to_compile_the_programs
+       alias start_to_compile              do_install_the_programs # === start_to_compile
+       alias do_compile_these_programs     do_install_the_programs # === do_compile_these_programs
+       alias compile_this_program_again    do_install_the_programs # === compile_this_program_again
+       alias do_initiate_batch_compilation do_install_the_programs # === do_initiate_batch_compilation
+       alias compile_every_program         do_install_the_programs # === compile_every_program
+       alias batch_compile_these_programs  do_install_the_programs # === batch_compile_these_programs
+       alias batch_compile_the_programs    do_install_the_programs # === batch_compile_the_programs
+
+  # ========================================================================= #
+  # === install_which_programs?
+  # ========================================================================= #
+  def install_which_programs?
+    ::RBT.install_which_programs?
+  end; alias array_compile_these_programs? install_which_programs? # === array_compile_these_programs?
+       alias compile_these_programs?       install_which_programs? # === compile_these_programs?
+       alias compile_which_programs?       install_which_programs? # === compile_which_programs?
+       alias compile_array?                install_which_programs? # === compile_array?
+       alias array?                        install_which_programs? # === array?
+
+  # ========================================================================= #
+  # === run_scons
+  #
+  # Invoke this method here only when we wish to use scons in order to
+  # install a program.
+  #
+  # Scons is python-related, which is why it sits here in this file.
+  # ========================================================================= #
+  def run_scons
+    _ = 'scons'.dup
+    if use_build_directory?
+      _.prepend('../')
+    end
+    coloured_and_padded_esystem _
+  end; alias run_scons_based_installation run_scons # === run_scons_based_installation
+
+  # ========================================================================= #
+  # === do_run_with_this_input
+  # ========================================================================= #
+  def do_run_with_this_input(i)
+    we_will_not_try_to_determine_which_programs_have_to_be_installed
+    menu
+    set_install_these_programs(i)
+    do_install_the_programs
+  end
+
+  # ========================================================================= #
+  # === run_premake_make_then_make_install
+  #
+  # Issue "premake commands", then "make" and then "make install" commands.
+  # ========================================================================= #
+  def run_premake_make_then_make_install
+    if run_make?
+      run_premake_commands
+      run_make_then_make_install
+    end
+  end; private :run_premake_make_then_make_install
+    alias run_premake_then_make_then_make_install run_premake_make_then_make_install # === run_premake_then_make_then_make_install
+
+  # ========================================================================= #
+  # === run_make_install?
+  #
+  # Query whether we will do the "make install" step or whether we
+  # will not. Will return a boolean value (true/false).
+  # ========================================================================= #
+  def run_make_install?
+    @internal_hash[:run_make_install]
+  end; alias may_we_run_make_install_command? run_make_install? # == may_we_run_make_install_command?
+
+  # ========================================================================= #
+  # === set_install_this_program
+  #
+  # This method is called set_handle_this_program() in class RBT::Compile.
+  # ========================================================================= #
+  def set_install_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
+    # ======================================================================= #
+    # === Ad-hox fix libtool files if given to RBT::Install 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.
+    # ======================================================================= #
+    i = i.dup # Must be a String.
+    @internal_hash[:install_this_program] = i
+    return i # Return it here just in case.
+  end; alias set_compile_this_program set_install_this_program # === set_compile_this_program
+       alias set_handle_this_program  set_install_this_program # === set_handle_this_program
+       alias set_program_name         set_install_this_program # === set_program_name
+       
+  # ========================================================================= #
+  # === install_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 install_this_program?
+    @internal_hash[:install_this_program]
+  end; alias install_which_program?   install_this_program? # === install_which_program?
+       alias compile_which_program?   install_this_program? # === compile_which_program?
+       alias handle_this_program?     install_this_program? # === handle_this_program
+       alias handle_which_program?    install_this_program? # === handle_which_program?
+       alias program_name?            install_this_program? # === program_name?
+       alias this_program?            install_this_program? # === this_program?
+       alias first_arg                install_this_program? # === first_arg
+       alias name_of_program?         install_this_program? # === name_of_program?
+       alias real_program_name?       install_this_program? # === real_program_name?
+       alias name?                    install_this_program? # === name?
+       alias program_to_compile?      install_this_program? # === program_to_compile?
+       alias search_for_this_program? install_this_program? # === search_for_this_program?
+       alias compile_this_program?    install_this_program? # === compile_this_program?
+       alias which_program?           install_this_program? # === which_program?
+       alias program?                 install_this_program? # === program?
+       alias internal_program_name?   install_this_program? # === internal_program_name?
+
+  # ========================================================================= #
+  # === parse_this_line_obtained_via_io_popen          (io-open tag, sys tag)
+  #
+  # This method is used to parse all output generated via IO.popen().
+  # ========================================================================= #
+  def parse_this_line_obtained_via_io_popen(
+      line,
+      use_colours       = use_colours?,
+      use_inner_padding = false
+    )
+    case use_colours
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default
+      use_colours = use_colours?
+    end
+    # ======================================================================= #
+    # Delegate towards class ColourizeParser next.
+    # ======================================================================= #
+    cparser = @internal_hash[:colourize_parser]
+    unless use_colours
+      cparser.disable_colours
+    end
+    line.chomp!
+    # ======================================================================= #
+    # Feed towards module RBT::Errors::MapLineToASpecificError next:
+    # ======================================================================= #
+    RBT::Errors::MapLineToASpecificError.parse_this_line(line)
+    # ======================================================================= #
+    # Next, put the line towards ColourizeParser. The reason why this is
+    # done after the error checking above is to simply keep the output
+    # as it was originally, before changing it via colours and the like.
+    # ======================================================================= #
+    cparser.grab_this_line(line)
+    line = cparser.line?.dup
+    # ======================================================================= #
+    # === A required package was not found
+    #
+    # Notify the user about this problem.
+    # ======================================================================= #
+    if line.include?('A required package was not found') and
+       !RBT::Errors::MapLineToASpecificError.required_packages?.empty?
+      name_of_the_package = RBT::Errors::MapLineToASpecificError.required_packages?.first.to_s
+      # ===================================================================== #
+      # That name may end with -4, such as "gtksourceview-4". This is not
+      # good as we report this, but the user should really just use
+      # "gtksourceview" instead - hence the following check.
+      # ===================================================================== #
+      if name_of_the_package.include?('-') and (name_of_the_package =~ /-\d{1,20}$/)
+        name_of_the_package = name_of_the_package.split('-')[0 .. -2].join('-')
+      end
+      line << ' '+crimson("( → #{name_of_the_package} is missing)")
+      line << "#{N}#{N}You can try to install it via:#{N}"
+      line << "#{N}#{slateblue('  rbt '+name_of_the_package)}#{N}#{N}"
+    end
+    # ======================================================================= #
+    # The reason we output the line here is so that we can still do
+    # modifications to it, if we have to. This is the case e. g. for
+    # when we wish to display which package is missing.
+    # ======================================================================= #
+    if use_inner_padding
+      e
+      e "  #{line}" # Output here.
+      e
+    else
+      e line # Output here.
+    end
+    if line.include?('configure: No such file or directory')
+      opne 'The '+crimson('above error message')+' most likely means '\
+           'that no configure script could be found.'
+    end
+    @internal_hash[:array_sys_command_string] << line # We could also store the lines here.
+  end
+
+  # ========================================================================= #
+  # === cookbook_for?                                           (dataset tag)
+  #
+  # Keep this query method on top of this file here, ideally.
+  #
+  # This method can be used whenever we wish to query the main data
+  # structure of the target program at hand.
+  #
+  # The dataset variable will typically be an instance of
+  # class RBT::Cookbooks::SanitizeCookbook.
+  # ========================================================================= #
+  def cookbook_for?
+    @internal_hash[:cookbook_for]
+  end; alias dataset?           cookbook_for? # === dataset?
+       alias cookbook_dataset?  cookbook_for? # === cookbook_dataset?
+       alias cookbook_dataset   cookbook_for? # === cookbook_dataset
+       alias cookbooks_dataset? cookbook_for? # === cookbooks_dataset?
+       alias dataset_object?    cookbook_for? # === dataset_object?
+       alias main_dataset?      cookbook_for? # === main_dataset?
+       alias main_dataset       cookbook_for? # === main_dataset
+       alias dataset            cookbook_for? # === dataset
+       alias dataset?           cookbook_for? # === cookbooks_dataset?
+       alias cookbook?          cookbook_for? # === cookbook?
+       alias yaml_dataset?      cookbook_for? # === yaml_dataset?
+       alias cookbooks_for?     cookbook_for? # === cookbooks_dataset?
+       alias data?              cookbook_for? # === data
+       alias sload              cookbook_for? # === sload() (sload tag)
+       alias sanitized_data     cookbook_for? # === sanitized_data()
+       alias yaml_dataset?      cookbook_for? # === yaml_dataset?
+       alias my_program         cookbook_for? # === my_program
+       alias sanitize_cookbook? cookbook_for? # === sanitize_cookbook?
+
+  # ========================================================================= #
+  # === run_premake_commands
+  #
+  # Here we try to run the premake commands, in case they exist.
+  #
+  # If there are no pre_make_commands, then we will not do anything,
+  # as our array will be empty.
+  #
+  # This method is normally run from do_compile_this_program(), via
+  # a call to its alias name consider_running_premake_instruction().
+  # ========================================================================= #
+  def run_premake_commands(
+      array = cookbook_dataset_pre_make_commands?
+    )
+    unless array.empty?
+      opne "#{sfancy('Doing pre_make_commands next from ')}"\
+           "#{sdir_return_pwd}#{sfancy('.')}"
+      array.each { |cmd|
+        opnn
+        e "In the directory #{sdir_return_pwd}, doing the following command next:"
+        e
+        e "  #{slateblue(cmd)}"
+        e
+        e 'next.'
+        run_this_system_command_in_a_coloured_and_padded_manner(cmd)
+      }
+    end
+  end; alias consider_running_premake_instructions run_premake_commands # === consider_running_premake_instructions
+       alias run_pre_make_commands                 run_premake_commands # === run_pre_make_commands
+
+  require 'rbt/utility_scripts/change_prefix.rb'
+  # ========================================================================= #
+  # === run_make                                     (make tag, Makefile tag)
+  #
+  # This is the wrapper method over "make".
+  #
+  # This method will, in the end, delegate towards RBT.colour_make,
+  # which in turn runs the command/binary called "make".
+  #
+  # The specific command that will be used, in this case "make", can also
+  # be a different one, as defined by the respective .yml file for
+  # the given program at hand. Not all programs require "make" for
+  # their compilation.
+  #
+  # The method will also have to ensure that a Makefile-file exists,
+  # but only for installation types that do happen to require a
+  # Makefile.
+  #
+  # Some build systems, such as meson/ninja, may use 'make', but may
+  # also skip it and do "ninja install" instead.
+  # ========================================================================= #
+  def run_make
+    if exit_before_make?
+      opne 'Exiting now as instructed before reaching '\
+           'the "'+orange('make')+'" stage.'
+      exit_program
+    end
+    # ======================================================================= #
+    # === Determine whether the Makefile has to be modified or not.
+    # ======================================================================= #
+    if modify_the_makefile?
+      opne 'The Makefile will be modified next ('+
+           steelblue('PREFIX')+' value will be changed).'
+      do_use_this_makefile_here = "#{return_pwd}Makefile"
+      # ======================================================================= #
+      # Delegate towards RBT::ChangePrefix next.
+      # ======================================================================= #
+      RBT::ChangePrefix.new(
+        use_this_makefile:          do_use_this_makefile_here,
+        use_this_as_the_new_prefix: prefix?.to_s.dup
+      )
+    end
+    if run_make?
+      # ======================================================================= #
+      # "make" is usually used, but we may also make use of "ninja" instead,
+      # so we have to pass in this option towards RBT.colour_make.
+      # ======================================================================= #
+      if run_simulation?
+        opne 'We are running a simulation, hence the following command'
+        opne 'will not be run:'
+        opnfancy "  #{make_command?}"
+      else
+        # =================================================================== #
+        # Clear the old buffer first:
+        # =================================================================== #
+        reset_error_map_line_to_a_specific_error
+        if has_to_be_compiled?
+          consider_using_maximum_speed_for_compilation
+        end
+        # =================================================================== #
+        # We will have to make a cd-operation to the configure base directory
+        # if run_configure is no/false and if we use a build directory.
+        #
+        # This, however had, breaks cmake builds, so it was disabled in
+        # February 2019. It may have to be changed at a later time
+        # anyway.
+        # =================================================================== #
+        # if !run_configure? and use_build_directory?
+        #   cd_to_the_configure_base_directory
+        # end
+        # =================================================================== #
+        # Next consider running pre-make commands - but this must come
+        # AFTER running GNU configure and similar build-style runs.
+        # =================================================================== #
+        consider_running_premake_instructions
+        unless installation_steps?.empty?
+          installation_steps?.each {|this_step|
+            opne "Next doing this step: #{sfancy(this_step)}"
+            esystem this_step
+          }
+        end
+        # =================================================================== #
+        # Delegate towards RBT.colour_make next:
+        # =================================================================== #
+        _ = use_which_system_command?
+        case _
+        # =================================================================== #
+        # === :ioparser
+        #
+        # This is the more sophisticated ioparser variant.
+        # =================================================================== #
+        when :ioparser,
+             :default
+          RBT.colour_make {
+            return_default_hash_to_be_passed_into_colour_make
+          }
+        # =================================================================== #
+        # === :system
+        #
+        # This is the simple system-variant.
+        # =================================================================== #
+        when :system
+          cmd = use_this_make_command?.to_s.dup
+          hash = return_default_hash_to_be_passed_into_colour_make
+          if hash.has_key? :append_these_options
+            cmd << hash[:append_these_options].join(' ')
+          end
+          cmd = cmd.strip.squeeze(' ')
+          coloured_and_padded_esystem(cmd)
+        else
+          e "Unknown system-command: #{steelblue(_.to_s)}"
+        end
+      end
+      run_through_the_registered_problems_registered_errors_and_behaviour_changes
+      reset_error_map_line_to_a_specific_error
+      if automatically_create_package?
+        if is_on_slackware?
+          # =================================================================== #
+          # Create a slackware-package in this case.
+          # =================================================================== #
+          opne 'Next trying to create a package for `'+royalblue('slackware')+'`.'
+          # The following subsection is incomplete. The path could be used
+          # to find out whether things are put in their right position.
+          # path = create_slackware_description_file
+          RBT.run_makepkg_command(compile_which_program?, program_version?)
+        end
+      end
+    end
+  end; alias run_make_command                            run_make # === run_make_command
+       alias considering_running_make_command_via_system run_make # === considering_running_make_command_via_system
+
+  # ========================================================================= #
+  # === 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
+
+  # ========================================================================= #
+  # === run_waf                                                     (waf tag)
+  #
+  # This method can be used to install a project that uses "waf" as
+  # its build system.
+  # ========================================================================= #
+  def run_waf
+    run_pre_make_commands
+    _ = './waf'.dup
+    if use_build_directory?
+      _.prepend(configure_base_directory?)
+    end
+    opnn; report_working_directory
+    # ======================================================================= #
+    # Specify which subcommands to use, e. g. 'waf configure' followed by
+    # 'waf build' and so forth.
+    # ======================================================================= #
+    run_these_subcommands = %w(
+      configure
+      build
+      install
+    )
+    run_these_subcommands.each {|this_subcommand|
+      _ = "#{_} #{this_subcommand}"
+      run_this_system_command_in_a_coloured_and_padded_manner(_)
+    }
+  end; alias run_waf_based_installation run_waf # === run_waf_based_installation
+
+  # ========================================================================= #
+  # === run_python_installation
+  #
+  # You should check whether setup.py exists prior to invoking this
+  # method here.
+  #
+  # You can also pass in another file, such as configure.py. By default,
+  # the method will make use of a file called "setup.py", though.
+  # ========================================================================= #
+  def run_python_installation(
+      i = 'setup.py'
+    )
+    if parameters_to_make?.nil?
+      _ = cookbook_dataset_make_options?
+      if _ and !_.empty?
+        i = _
+      end
+    end
+    i = [i].flatten.compact
+    # ======================================================================= #
+    # We work on an Array here since some make_options entries also
+    # specify an Array.
+    # ======================================================================= #
+    i.each {|do_this_action|
+      case do_this_action
+      when FILE_SETUP_PY # ← This is equivalent to "setup.py".
+        # We could also use RBT::FILE_SETUP_PY.
+        if does_a_python_binary_exist?
+          colourized_and_padded_esystem "python #{do_this_action} configure"
+          colourized_and_padded_esystem "python #{do_this_action} build"
+          colourized_and_padded_esystem "python #{do_this_action} install"
+        else
+          notify_the_user_that_no_binary_python_could_be_found
+        end
+      else
+        run_this_command = "#{do_this_action}".dup
+        if run_this_command.start_with?('python') and !run_this_command.include?('/')
+          # =================================================================== #
+          # This is valid for a command line such as:
+          #   "python setup.py config"
+          # =================================================================== #
+          splitted = run_this_command.split(' ')
+          splitted[1].prepend(configure_base_dir?.dup)
+          run_this_command = splitted.join(' ')
+        end
+        unless run_this_command.start_with? 'python'
+          run_this_command.prepend('python ')
+        end
+        if does_a_python_binary_exist?
+          colourized_and_padded_esystem run_this_command
+        else
+          notify_the_user_that_no_binary_python_could_be_found
+        end
+      end
+    }
+    consider_changing_the_tab_title(
+      :clear, :do_rename
+    )
+  end; alias run_python_install run_python_installation # === run_python_install
+
+  # ========================================================================= #
+  # === run_python_install1
+  # ========================================================================= #
+  def run_python_install1(
+      this_file = RBT.file_predefined_installation_instructions
+    )
+    dataset = YAML.load_file(this_file)['PINSTALL1']
+    if dataset.is_a?(String) and dataset.include?(';')
+      dataset.split(';').each {|this_command|
+        _ = this_command.strip
+        e _
+        run_this_sys_command(_)
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === run_python_install2
+  # ========================================================================= #
+  def run_python_install2(
+      this_file = RBT.file_predefined_installation_instructions
+    )
+    dataset = YAML.load_file(this_file)['PINSTALL2']
+    if dataset.is_a?(String) and dataset.include?(';')
+      dataset.split(';').each {|this_command|
+        _ = this_command.strip
+        e _
+        run_this_sys_command(_)
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === initialize_a_new_cookbook_for
+  #
+  # 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_for(
+      i                 = install_this_program?,
+      simple_or_complex = simple_or_complex?
+    )
+    i = RBT.cookbook_for(i) {{
+      make_use_of_aliases_kept_in_the_file_cookbook_aliases: make_use_of_cookbook_aliases?,
+      simple_or_complex:                                     simple_or_complex?
+    }}
+    @internal_hash[:cookbook_for] = i
+    # ======================================================================= #
+    # Sync the make command to be used at once.
+    # ======================================================================= #
+    set_use_this_make_command(
+      cookbook_dataset_use_this_make_command?
+    )
+    return i # Always return the dataset as well here.
+  end; alias initialize_cookbook_dataset_for                         initialize_a_new_cookbook_for # === initialize_cookbook_dataset_for
+       alias initialize_a_new_cookbook_instance                      initialize_a_new_cookbook_for # === initialize_a_new_cookbook_instance
+       alias load_yaml_dataset_for_this_program                      initialize_a_new_cookbook_for # === load_yaml_dataset_for_this_program
+       alias update_dataset                                          initialize_a_new_cookbook_for # === update_dataset
+       alias ensure_that_the_dataset_exists                          initialize_a_new_cookbook_for # === ensure_that_the_dataset_exists
+       alias ensure_that_the_main_dataset_exists                     initialize_a_new_cookbook_for # === ensure_that_the_main_dataset_exists
+       alias ensure_that_we_have_a_dataset                           initialize_a_new_cookbook_for # === ensure_that_we_have_a_dataset
+       alias ensure_that_the_default_dataset_exists_for_this_program initialize_a_new_cookbook_for # === ensure_that_the_default_dataset_exists_for_this_program
+       alias ensure_dataset_for_this_program                         initialize_a_new_cookbook_for # === ensure_dataset_for_this_program
+       alias ensure_proper_dataset_for                               initialize_a_new_cookbook_for # === ensure_proper_dataset_for
+       alias ensure_that_a_dataset_exists_for_this_program           initialize_a_new_cookbook_for # === ensure_that_a_dataset_exists_for_this_program
+       alias ensure_that_the_dataset_exists_for_this_program         initialize_a_new_cookbook_for # === ensure_that_the_dataset_exists_for_this_program
+       alias ensure_proper_dataset                                   initialize_a_new_cookbook_for # === ensure_proper_dataset
+       alias initialize_dataset_for                                  initialize_a_new_cookbook_for # === initialize_dataset_for
+       alias initialize_dataset_for                                  initialize_a_new_cookbook_for # === initialize_dataset_for
+       alias initialize_dataset                                      initialize_a_new_cookbook_for # === initialize_dataset
+       alias initialize_yaml_dataset                                 initialize_a_new_cookbook_for # === initialize_yaml_dataset
+       alias initialize_dataset_for_this_program                     initialize_a_new_cookbook_for # === initialize_dataset_for_this_program
+       alias initialize_cookbook_dataset                             initialize_a_new_cookbook_for # === initialize_cookbook_dataset
+       alias instantiate_a_new_cookbook_for                          initialize_a_new_cookbook_for # === instantiate_a_new_cookbook_for
+       alias instantiate_a_new_cookbook_instance                     initialize_a_new_cookbook_for # === instantiate_a_new_cookbook_instance
+       alias instantiate_a_new_cookbook                              initialize_a_new_cookbook_for # === instantiate_a_new_cookbook
+       alias create_a_new_cookbook_instance                          initialize_a_new_cookbook_for # === create_a_new_cookbook_instance
+       alias determine_the_dataset_for_this_program                  initialize_a_new_cookbook_for # === determine_the_dataset_for_this_program
+       alias determine_cookbook_dataset_for_this_program             initialize_a_new_cookbook_for # === determine_cookbook_dataset_for_this_program
+       alias prepare_dataset_for                                     initialize_a_new_cookbook_for # === prepare_dataset_for
+
+  # ========================================================================= #
+  # === run_make_install
+  # ========================================================================= #
+  def run_make_install
+    
+  end; alias run_make_install_command                            run_make_install # === run_make_install_command
+       alias considering_running_make_install_command_via_system run_make_install # === considering_running_make_install_command_via_system
+
+  # ========================================================================= #
+  # === run_make_install_command
+  #
+  # This method will ultimately default to run something such
+  # as "make install". Note that some programs do not use
+  # "make install" and instead use something such as
+  # "ninja install".
+  #
+  # The method here thus has to remain somewhat flexible, in order
+  # to install such programs as well.
+  # ========================================================================= #
+  def run_make_install_command
+    # ======================================================================= #
+    # Do not try to compile via make, if it does not have to be compiled.
+    # ======================================================================= #
+    return unless has_to_be_compiled?
+    unless pre_make_install_sed.empty?
+      pre_make_install_sed.each {|sed_instruction|
+        run_this_sed_instruction(sed_instruction)
+      }
+    end
+    if exit_before_make_install?
+      opne 'Exiting now as instructed before reaching '\
+           'the "'+orange('make install')+'" stage.'
+      exit_program
+    end
+    # ======================================================================= #
+    # === Check whether we may run make install or whether we may not.
+    # ======================================================================= #
+    if run_make_install?
+      # ======================================================================= #
+      # Clear the old buffer keeping track of our errors first:
+      # ======================================================================= #
+      reset_error_map_line_to_a_specific_error
+      use_this_make_command = use_this_make_command?
+      if use_this_make_install_command?
+        # =================================================================== #
+        # In this case we will use that make-install command instead.
+        # =================================================================== #
+        use_this_make_command = use_this_make_install_command?
+      end
+      use_this_make_command = use_this_make_command.dup
+      use_porg = false
+      if use_porg? # The user is trying to make use of porg here.
+        if porg_is_available?
+          use_porg = true
+        else
+          # =================================================================== #
+          # Notify the user that porg is NOT available. We will continue
+          # anyway, though.
+          # =================================================================== #
+          notify_the_user_that_porg_is_not_available
+        end
+      end
+      # ======================================================================= #
+      # If the user uses stow then the following clause is entered.
+      # ======================================================================= #
+      if use_stow?
+        RBT.colour_make_install {
+          return_default_hash_to_be_passed_into_colour_make(
+            append: " DESTDIR=/stow/#{compile_which_program?} install",
+            porg:                  use_porg,
+            use_this_make_command: use_this_make_command,
+            pad_the_output:        true
+          )
+        }
+      else
+        RBT.colour_make_install {
+          return_default_hash_to_be_passed_into_colour_make(
+            porg:                  use_porg,
+            use_this_make_command: use_this_make_command,
+            pad_the_output:        true
+          )
+        }
+      end
+      run_through_the_registered_problems_registered_errors_and_behaviour_changes
+      reset_error_map_line_to_a_specific_error
+      if an_error_has_occurred?
+        # =================================================================== #
+        # Register that this step led to an error in this case.
+        # =================================================================== #
+        @internal_hash[:make_install_stage_was_a_success] = false
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === run_system_or_ioparser_command                            (iopen tag)
+  #
+  # This method will, by default, try to make use of IO.popen.
+  #
+  # The alternatives, system() or backticks, are not as useful, in my
+  # opinion. However had, the user can use these others variants as
+  # well, since as of July 2020.
+  #
+  # The current idea is to work on a line-by-line basis when IO.popen is
+  # used, and to also display what is done, so that the user has an
+  # idea what is happening.
+  #
+  # There is also the possibility to use colours and colourize the input;
+  # this allows us to, for example, use specific colours for directories
+  # or for files or to indicate failures.
+  #
+  # Usage example:
+  #
+  #   run_this_system_command_in_a_coloured_and_padded_manner(full_configure_command?) { :also_pad_via_cliner }
+  #
+  # ========================================================================= #
+  def run_system_or_ioparser_command(
+      i,
+      use_colours           = use_colours?,
+      use_padding           = true,
+      show_the_command_used = true,
+      &block
+    )
+    yielded = nil      
+    if block_given?
+      yielded = yield
+    end
+    case use_colours
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default
+      use_colours = use_colours?
+    end
+    use_this_colour = :konsole_dodgerblue # ← dodgerblue
+    set_pid(nil) # Reset the PID here.
+    # ======================================================================= #
+    # === The usere wants to do something with "make" past this point here
+    #
+    # I still do not quite understand the second argument. Either way,
+    # I have determined that this works better.
+    #
+    #   ffmpeg = IO.popen(cmdline + " #{SHELL_ERROR_CODE}", "w+")
+    #
+    # ======================================================================= #
+    if i and i.start_with?('make')
+      unless is_make_available?
+        # =================================================================== #
+        # We need to inform the user that the "make" binary is not available.
+        # =================================================================== #
+        opne "The program \"#{sfancy('make')}\" is "\
+             "#{swarn('not available')}, at the least not as  "\
+             "part of the #{steelblue('$PATH')} variable."
+        opne "RBT::Compile thus can not compile anything. You "\
+             "may want to check the #{orange('$PATH')} variable."
+        do_not_continue_and_do_not_compile(:be_quiet)
+        return
+      end
+    end
+    i = i.dup if i.frozen? # Work on a copy, just in case.
+    i.strip!
+    # ======================================================================= #
+    # Next append shell-error-code, which is just ' 2>&1' really.
+    # The user can disable this, though, via --do-not-append-no-error,
+    # hence the following if-clause.
+    # ======================================================================= #
+    if append_shell_error_code?
+      i << " #{SHELL_ERROR_CODE}" unless i.end_with? " #{SHELL_ERROR_CODE}"
+    end
+    # ======================================================================= #
+    # We have to determine whether we will ultimately run a system()
+    # variant or Ioparser
+    # ======================================================================= #
+    case use_which_system_command?
+    # ======================================================================= #
+    # === :ioparser
+    # ======================================================================= #
+    when :ioparser
+      if show_the_command_used
+        case yielded
+        when :also_pad_via_cliner
+          if use_colours?
+            cliner(use_colour: use_this_colour)
+          else
+            cliner
+          end
+        end
+        coloured_and_padded_e(i, :default, :inner_padding)
+        case yielded
+        when :also_pad_via_cliner
+          if use_colours?
+            cliner(use_colour: use_this_colour)
+          else
+            cliner
+          end
+        end
+      end
+      io_object = IO.popen(i, {:err => [:child, :out]})
+      set_pid(io_object.pid)
+      io_object.each { |line|
+        # =================================================================== #
+        # The next line will also display what has happened.
+        # =================================================================== #
+        parse_this_line_obtained_via_io_popen(line, use_colours)
+      }
+      io_object.close
+      # ======================================================================= #
+      # Right now only the io-parser above can handle the sys-command
+      # strings.
+      # ======================================================================= #
+      # Next, we attempt to determine what some of the errors may be and
+      # perhaps even how to resolve them.
+      # ======================================================================= #
+      # Handle "no configure file" next.
+      # ======================================================================= #
+      if array_sys_command_string? and
+         array_sys_command_string?.any? {|line|
+          line.include? 'sh: ./configure: No such file or directory'
+        }
+        problem_is :no_configure_file
+      # ======================================================================= #
+      # Handle missing headers next.
+      # ======================================================================= #
+      elsif array_sys_command_string?.any? {|line|
+          line.include? 'headers are missing'
+        }
+        _ = array_sys_command_string?.select {|line|
+          line.include? 'headers are missing'
+        }
+        problem_is _
+      end
+    # ======================================================================= #
+    # === :simple_system
+    #
+    # This entry point is for simple system() calls.
+    # ======================================================================= #
+    when :simple_system,
+         :system
+      if use_padding and show_the_command_used
+        case yielded
+        when :also_pad_via_cliner
+          if use_colours?
+            cliner(use_colour: use_this_colour)
+          else
+            cliner
+          end
+        end
+        coloured_and_padded_esystem "#{cmd}", :default, :inner_padding
+        case yielded
+        when :also_pad_via_cliner
+          if use_colours?
+            cliner(use_colour: use_this_colour)
+          else
+            cliner
+          end
+        end
+      else
+        if show_the_command_used
+          case yielded
+          when :also_pad_via_cliner
+            if use_colours?
+              cliner(use_colour: use_this_colour)
+            else
+              cliner
+            end
+          end
+          colourized_and_padded_esystem(cmd)
+          case yielded
+          # ================================================================= #
+          # === :also_pad_via_cliner
+          # ================================================================= #
+          when :also_pad_via_cliner
+            if use_colours?
+              cliner(use_colour: use_this_colour)
+            else
+              cliner
+            end
+          end
+        else
+          system(cmd)
+        end
+      end
+    end
+  end; alias run_this_sys_command                                    run_system_or_ioparser_command # === run_this_sys_command
+       alias custom_system                                           run_system_or_ioparser_command # === custom_system
+       alias run_this_system_command                                 run_system_or_ioparser_command # === run_this_system_command
+       alias run_this_command                                        run_system_or_ioparser_command # === run_this_command
+       alias run_this_system_command_in_a_coloured_and_padded_manner run_system_or_ioparser_command # === run_this_system_command_in_a_coloured_and_padded_manner
+
+  # ========================================================================= #
+  # === do_install_these_programs
+  # ========================================================================= #
+  def do_install_these_programs(
+      i = install_which_programs?
+    )
+    [i].flatten.compact.each {|this_program|
+      do_install_this_program(this_program)
+    }
+  end; alias batch_compile_the_programs    do_install_these_programs # === batch_compile_the_programs
+       alias do_initiate_batch_compilation do_install_these_programs # === do_initiate_batch_compilation
+
+  # ========================================================================= #
+  # === run_make_then_make_install
+  #
+  # Run "make" and then the "make install" command here.
+  #
+  # This method is deliberately very simple.
+  # ========================================================================= #
+  def run_make_then_make_install
+    _ = an_error_has_occurred?
+    _ = false unless check_for_errors?
+    if _
+    else
+      run_make_command
+      run_make_install_command
+    end
+  end; alias run_make_and_make_install_command  run_make_then_make_install # === run_make_and_make_install_command
+       alias run_make_then_make_install_command run_make_then_make_install # === run_make_then_make_install_command
+
+  # ========================================================================= #
+  # === do_install_this_program                            (real compile tag)
+  #
+  # This method can be used to compile a given program. It is the main
+  # "workhorse" for class RBT::Installer.
+  #
+  # To not initialize the dataset, use :do_not_initialize_the_dataset
+  # as block-argument.
+  # ========================================================================= #
+  def do_install_this_program(
+      this_program
+    )
+    # ======================================================================= #
+    # 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 this_program.respond_to?(:include?) and
+       this_program.include?('*')
+      verbose_find_all_keys_starting_with(this_program)
+      exit_program
+    end
+    return unless can_we_continue?
+    # ======================================================================= #
+    # First check if the user wants to ensure a specific licence:
+    # ======================================================================= #
+    if check_for_this_licence?
+      unless licence? == check_for_this_licence?
+        opne "#{tomato('The licences do not match. ')}Expected licence"
+        opne 'was: '+
+             steelblue(
+               RBT.sanitize_this_licence(check_for_this_licence?)
+             )+', specified licence was: '+
+             steelblue(licence?)
+        return
+      end
+    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
+    # ======================================================================= #
+    # Next we have to sanitize the given input a little bit, such as by
+    # getting rid of any '/' character.
+    # ======================================================================= #
+    this_program = this_program.to_s.dup # We need a String.
+    this_program.delete!('_') if this_program.include? '_'
+    this_program = File.basename(this_program) if this_program.include? '/'
+    # ======================================================================= #
+    # Note that the next clause will return and thus break from this
+    # method. Subsequent method calls will not be triggered.
+    # ======================================================================= #
+    if do_we_check_whether_the_program_exists? and
+      !is_this_program_included?(this_program, :be_quiet)
+      opne "The program #{steelblue(this_program)} is #{tomato('not')} "\
+           "registered as part of the RBT project."
+      opne 'Thus, it could not be found and, subsequently, it can not be'
+      opne 'installed or compiled.'
+      return :the_program_is_not_registered_in_the_rbt_project
+    end unless this_program.include?('@')
+    # ======================================================================= #
+    # The @ allows us to bypass the is-included check here. We simply
+    # assume that the user knows what he/she is doing in this case.
+    # ======================================================================= #
+    if is_this_program_included?(this_program, :include_abbreviations_and_be_quiet) or
+       this_program.include?('@') # Allow for '@' as input here.
+      if this_program.include? '@'
+        splitted = this_program.split('@')
+        first_part = splitted.first
+        set_install_this_program(first_part)
+        initialize_a_new_cookbook_for(first_part.delete('-'))
+        # =================================================================== #
+        # In this case we must change the version and then sync back.
+        # =================================================================== #
+        cookbook_dataset?.set_complex_program_version(this_program)
+        cookbook_dataset?.set_program_version(splitted.last)
+        cookbook_dataset?.update_program_name_and_program_version
+        # =================================================================== #
+        # ^^^ program_name_and_program_version must exist, before
+        # we call the next method:
+        # =================================================================== #
+        cookbook_dataset?.update_program_full_name
+        cookbook_dataset?.update_the_program_path
+      else
+        set_install_this_program(this_program)
+        # ==================================================================== #
+        # Next, we will typically initialize a new cookbok instance.
+        # =================================================================== #
+        if block_given?
+          if yield == :do_not_initialize_the_dataset
+          else
+            initialize_a_new_cookbook_for(this_program) # ← Instantiate a new cookbook instance here.
+          end
+        else
+          initialize_a_new_cookbook_for(this_program) # ← Instantiate a new cookbook instance here.
+        end
+      end
+      # ===================================================================== #
+      # Next we have to determine which compiler we want to use.
+      # ===================================================================== #
+      determine_which_compiler_will_be_used
+      prefix?.set_program_version(program_version?) # Set the program version here just in case.
+      program_path = cookbook_program_path?
+      # ===================================================================== #
+      # Sometimes we must re-write the program path, e. g. if we take
+      # another program version. The following method does that for us.
+      # It no longer works as of 2022, though. May have to reconsider this
+      # approach.
+      # ===================================================================== #
+      # consider_sanitizing_the_program_path
+      # determine_the_configure_base_directory_to_use
+      # ===================================================================== #
+      # ===================================================================== #
+      # We must check whether the file already exists locally. If not then
+      # we have to try to download it.
+      # ===================================================================== #
+      if program_path
+        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.
+          # ================================================================= #
+          # ================================================================= #
+          # === Honour the "do_not_download" settings if it exists.
+          # ================================================================= #
+          if cookbook_dataset? and cookbook_dataset?.do_not_download?
+            do_not_download
+          else
+            download_program
+            unicode_middle_cliner # Looks better with cliner, I think.
+          end
+        end
+      end
+      # ===================================================================== #
+      # === (1) 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. It can also
+      # come before we check for the program path - some environment
+      # variables may influence any further downstream checks, so
+      # let's call it here to be on the safe side.
+      # ===================================================================== #
+      considering_setting_any_special_environment_variable
+      # ===================================================================== #
+      # 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 remotely.' 
+        exit_program
+      end
+      if File.exist? program_path
+        # =================================================================== #
+        # === (2) 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(
+          this_program, program_path
+        )
+        # =================================================================== #
+        # === (3) Consider changing the tab title
+        #
+        # In this case we may be able to install/compile the given program
+        # at hand, so we can rename the terminal.
+        #
+        # Changing the name of the tab title should happen only after the
+        # program name was set.
+        #
+        # Note that when we refer to "tab", we really mean KDE konsole
+        # tabs primarily.
+        #
+        # The old code was:
+        #
+        #   
+        #   consider_changing_the_tab_title(use_this_as_tab_title)
+        #
+        # =================================================================== #
+        use_this_as_tab_title = return_program_name_then_hyphen_then_the_program_version # :default
+        if check_whether_the_given_input_is_a_file_and_does_exist? and
+          does_this_file_exist_and_is_it_a_file?(this_program) # This may be the case when the user supplied a path.
+          use_this_as_tab_title = remove_archive_at_the_end(File.basename(this_program))
+        end
+        action(
+          :rename_konsole_tab,
+          use_this_as_tab_title
+        ) if rename_the_terminal?
+        # =================================================================== #
+        # 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
+        # )
+        # =================================================================== #
+        # Next, 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
+        if is_a_gem_file?(program_path)
+          install_ruby_gem(program_path) # Install this rubygem.
+          return
+        end
+        unless ignore_errors?
+          we_can_not_continue if an_error_has_occurred?
+        end
+        # =================================================================== #
+        # === (4) 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
+        # =================================================================== #
+        # === (5) Consider showing the Flexbox next (flexbox tag, infobox tag)
+        #
+        # Consider showing the fluxbox next. This must happen AFTER we
+        # modified the CFLAGS variable.
+        #
+        # 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
+        # =================================================================== #
+        # === (6) Extract the main archive next
+        # =================================================================== #
+        unless skip_extracting?
+          consider_removing_the_old_extracted_directory_if_it_exists
+        end
+        return unless can_we_continue? # This should come before we extract anything.
+        if File.exist? program_path
+          extract_this_archive(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
+        # =================================================================== #
+        # Also reset the compiled n-times counter next.
+        # =================================================================== #
+        reset_compiled_n_times_counter
+        # =================================================================== #
+        # Create the AppDir skeleton before cd-ing to the base directory.
+        # =================================================================== #
+        consider_creating_the_appdir_skeleton
+        # =================================================================== #
+        # Change directory to the extract directory next.
+        # =================================================================== #
+        cd_to_the_extracted_archive
+        # =================================================================== #
+        # 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 "The current working directory is now #{sdir(return_pwd)}."
+        # =================================================================== #
+        # === (7) 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
+        # if use_build_directory?
+        #   create_the_build_directory_then_cd_into_it
+        #   ^^^ disabled as of 21.09.2022 - see README.gen for an explanation.
+        # end
+        # =================================================================== #
+        # === Optional start messages
+        #
+        # Display optional start message here, right before we continue
+        # to the preinstall? stage and other stages.
+        # =================================================================== #
+        consider_displaying_the_start_message
+        # =================================================================== #
+        # === (8) Reset any possible error message at this point.
+        # =================================================================== #
+        RBT.reset_error_message
+        # =================================================================== #
+        # === (9) 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
+        # =================================================================== #
+        # === (10) 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
+        # =================================================================== #
+        # Here the user only wants to install the .h header files.
+        # =================================================================== #
+        if install_only_the_headers?
+          action_install_only_headers
+          exit_program
+        end
+        # =================================================================== #
+        # 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
+        # =================================================================== #
+        # === (11) 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)
+        # =================================================================== #
+        # === (12) The next method-call must occur AFTER the
+        #          pre-installation steps.
+        # =================================================================== #
+        decide_whether_to_invoke_the_autoconf_command
+        # =================================================================== #
+        # The next method used to be called run_configure_like_stage() in
+        # the past, until the rewrite in September 2022.
+        # =================================================================== #
+        find_the_corresponding_install_method_and_proceed_from_there
+        # =================================================================== #
+        # The next method should come after calling the "configure-like
+        # method".
+        # =================================================================== #
+        check_for_common_problems_and_common_errors
+        consider_running_ldconfig
+        # ===================================================================== #
+        # 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
+        if appdir_prefix_was_used?
+          do_store_the_configure_options_that_were_used_into_a_markdown_file
+        end
+        if has_an_error_occurred? or RBT::Errors::MapLineToASpecificError.all_programs_and_errors?.flatten.any? {|inner_line|
+            inner_line.to_s.include?('.h: No such file or directory')
+          }
+          opne swarn('An error has occurred in the directory ')+
+               sdir(return_pwd)+
+               swarn('.')
+          opne swarn('We will most likely not be able to continue.')
+          try_to_give_additional_information_to_the_user_if_the_missing_header_is_registered
+          case ignore_errors?
+          when true
+            # =============================================================== #
+            # pass through
+            # =============================================================== #
+          when :infer # This is the new default.
+            we_can_not_continue
+          else
+            we_can_not_continue
+          end
+        end
+        # =================================================================== #
+        # 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 - this should come before we symlink
+              # the .pc files:
+              # ============================================================= #
+              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
+        this_program = this_program.split('@').first.to_s if this_program.include?('@')
+        # =================================================================== #
+        # Ensure that the expanded cookbook .yml file exists
+        # =================================================================== #
+        if is_on_roebe? and
+          !does_the_expanded_cookbook_file_exist_for_this_program?(this_program)
+          expand_this_cookbook(this_program)
+        end
+        # =================================================================== #
+        # Also store the prefix that we used on the toplevel namespace.
+        # =================================================================== #
+        RBT.set_last_prefix_used(use_which_prefix?)
+        # =================================================================== #
+        # === 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.
+        #
+        # However had, in December 2022 it was realised that some directories
+        # should NOT be removed, even if they are empty - such as temp or
+        # logs directories called during the post-installation step. So
+        # we have to include that as well.
+        # =================================================================== #
+        consider_removing_empty_subdirectories
+        store_time_snapshot
+        consider_creating_a_log_file_containing_information_about_the_used_environment_and_time_of_compilation
+        # =================================================================== #
+        # 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
+        # =================================================================== #
+        # Go back into the starting directory again.
+        # =================================================================== #
+        consider_entering_the_log_directory
+        show_the_everything_is_finished_message
+        # =================================================================== #
+        # Show success or failure - this should come last.
+        # =================================================================== #
+        show_success_or_failure_status
+      else
+        opne "No archive exists at #{sfile(program_path)}."
+      end
+      # ===================================================================== #
+      # consider_changing_the_tab_title :clear
+      # ===================================================================== #
+      action(:rename_konsole_tab, :clear) if rename_the_terminal?
+    else
+      opne "#{steelblue(this_program)} is not included in the RBT database."
+    end
+  end; alias compile_this_program    do_install_this_program # === compile_this_program
+       alias do_compile_this_program do_install_this_program # === do_compile_this_program
+
+  # ========================================================================= #
+  # === run_the_gnu_configure_steps                           (configure tag)
+  # ========================================================================= #
+  def run_the_gnu_configure_steps
+    if shall_we_run_configure?
+      run_the_configure_command
+    end
+    run_make_then_make_install
+  end; alias run_configure_like_stage run_the_gnu_configure_steps # === run_configure_like_stage
+
+end; end