rbt 0.10.215 → 0.11.89

data/lib/rbt/cookbooks/sanitize_cookbook/misc.rb

@@ -1,3561 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === RBT::Cookbooks::SanitizeCookbook
-# =========================================================================== #
-# require 'rbt/cookbooks/sanitize_cookbook/misc.rb'
-# =========================================================================== #
-require 'rbt/base/prototype.rb'
-
-module RBT
-
-module Cookbooks
-
-class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
-
-  # ========================================================================= #
-  # === find_this_program                                          (find tag)
-  #
-  # This method will also keep track which program we are trying to
-  # find.
-  #
-  # Note that .find() is an alias to this method.
-  # ========================================================================= #
-  def find_this_program(
-      i = first?
-    )
-    determine_which_program_is_sought(i)               # (1) seek this new program
-    instantiate_raw_cookbook(i)                        # (2) finally, instantiate a new raw cookbook
-    populate_the_dataset_variable                      # (4) initialize the main hash properly
-    if in_simple_mode?                                 # (5) in this case, sync a lot of stuff.
-      # ===================================================================== #
-      # We use this method call because the program we are trying to find
-      # may have been modified, such as from "x11" to "libx11".
-      # ===================================================================== #
-      find_in_the_raw_cookbook(seek_this_program?)
-      ensure_that_this_hash_has_only_valid_keys(
-        raw_cookbook?.dataset?
-      )
-      # ===================================================================== #
-      # :archive_type can be set early because we can scan for the real
-      # value lateron anyway.
-      # ===================================================================== #
-      dataset?[:archive_type] = '.tar.xz'              # (6) archive_type
-      # ===================================================================== #
-      # In this case we have to do additional parsing. However had, when
-      # the .yml file contains a set-entry called program_name_and_program_version
-      # then this entry will be used rather than using url1.
-      # ===================================================================== #
-      _ = program_name_and_program_version?
-      if _ and _.is_a?(String) and !_.empty?
-        _ = ::RBT.sanitize_url1_entry(_, dataset?.merge(url1: raw_cookbook?.url1?)).dup
-        # =================================================================== #
-        # In this case program_name_and_program_version exists, so
-        # we will set these parts first.
-        # =================================================================== #
-        set_program_name_and_program_version(_)
-        deduce_everything_from_the_program_name_and_program_version_downwards
-        set_program_full_name(:default)
-        set_short_name(:default)
-        set_base_dir(:default)
-        set_program_path(:default)
-        set_program_version(:infer_from_the_program_name_and_program_version)
-      else
-        parse_url1_and_set_all_associated_values
-      end
-      check_for_outdated_entries(dataset?)
-      sanitize_everything                              # (7) sanitize everything
-      determine_all_relevant_values_for_the_dataset_variable
-    else
-      # ===================================================================== #
-      # else we are in complex-mode.
-      # ===================================================================== #
-      copy_the_data_from_the_raw_cookbook_onto_the_main_hash
-    end
-  end; alias assign_and_run                                               find_this_program # === assign_and_run
-       alias assign                                                       find_this_program # === assign
-       alias initialize_yaml_dataset                                      find_this_program # === initialize_yaml_dataset
-       alias update_with_this_program                                     find_this_program # === update_with_this_program
-       alias update                                                       find_this_program # === update
-       alias query                                                        find_this_program # === query
-       alias set_dataset                                                  find_this_program # === set_dataset
-       alias find                                                         find_this_program # === find
-       alias find_this_program_and_then_set_the_internal_cookbook_dataset find_this_program # === find_this_program_and_then_set_the_internal_cookbook_dataset
-
-  # ========================================================================= #
-  # === copy_the_data_from_the_raw_cookbook_onto_the_main_hash
-  # ========================================================================= #
-  def copy_the_data_from_the_raw_cookbook_onto_the_main_hash
-    hash = dataset?
-    raw_cookbook_dataset?.each_pair {|key, value|
-      hash[key] = value # Only copy, do not modify anything.
-    }
-  end
-
-  # ========================================================================= #
-  # === find_in_the_raw_cookbook
-  # ========================================================================= #
-  def find_in_the_raw_cookbook(
-      i = search_for_this_program?
-    )
-    result = raw_cookbook?.find(i)
-    if debug?
-      opnn; e "Loading the dataset from the file "\
-              "`#{sfile(raw_cookbook?.file?)}`."
-    end
-    return result
-  end; alias load_yaml_dataset_from_this_file find_in_the_raw_cookbook # === load_yaml_dataset_from_this_file
-
-  # ========================================================================= #
-  # === @honour_threshold_value
-  # ========================================================================= #
-  @honour_threshold_value = true
-
-  # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.do_not_honour_threshold_value
-  # ========================================================================= #
-  def self.do_not_honour_threshold_value
-    @honour_threshold_value = false
-  end
-
-  # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.honour_threshold_value?
-  # ========================================================================= #
-  def self.honour_threshold_value?
-    @honour_threshold_value
-  end
-
-  # ========================================================================= #
-  # === sanitize_program_version
-  # ========================================================================= #
-  def sanitize_program_version
-    _ = raw_cookbook?.program_version?
-    if _.nil? or (_ and _.empty?)
-      _ = program_version?.to_s
-    end
-    set_program_version(_)
-  end
-
-  # ========================================================================= #
-  # === populate_the_dataset_variable
-  # ========================================================================= #
-  def populate_the_dataset_variable(
-      i = simple_or_complex?
-    )
-    initialize_the_main_hash_with_default_values # First, fill the dataset with default values.
-    case i
-    # ======================================================================= #
-    # === :simple
-    #
-    # If we make use of the simple dataset then we do not have to sync the
-    # value back onto RawCookbook.
-    # ======================================================================= #
-    when :simple
-      # ===================================================================== #
-      # In this case we have to do sanitizing stuff.
-      # ===================================================================== #
-      merge_in_the_dataset_derived_from_the_raw_cookbook # must come after we instantiated the raw cookbook
-    # ======================================================================= #
-    # === :complex
-    #
-    # In this case we can simply query from the raw-cookbook dataset.
-    # ======================================================================= #
-    when :complex
-      raw_cookbook?.set_complex # Pass the info to the raw-cookbook as well.
-      allowed_cookbook_entries?.each {|this_entry|
-        _ = ("#{this_entry.to_s}?").to_sym
-        dataset?[this_entry.to_sym] = raw_cookbook?.send(_)
-      }
-      determine_all_relevant_values_for_the_dataset_variable
-    end
-  end
-
-  # ========================================================================= #
-  # === merge_in_the_dataset_derived_from_the_raw_cookbook
-  # ========================================================================= #
-  def merge_in_the_dataset_derived_from_the_raw_cookbook
-    # ======================================================================= #
-    # Next "copy" the dataset onto the main Hash.
-    # ======================================================================= #
-    raw_cookbook_dataset?.each_pair {|key, value|
-      key = key.to_sym
-      @internal_hash[:dataset][key] = value
-    }
-  end
-
-  # ========================================================================= #
-  # === array_show_these_entries?
-  # ========================================================================= #
-  def array_show_these_entries?
-    @internal_hash[:array_show_these_entries]
-  end
-
-  # ========================================================================= #
-  # === append_to_array_show_these_entries
-  #
-  # Use this method when you wish to append to the main Array keeping
-  # track of which entries are to be shown.
-  # ========================================================================= #
-  def append_to_array_show_these_entries(i)
-    array_show_these_entries? << i
-  end
-
-  # ========================================================================= #
-  # === find_this_program_and_then_set_the_internal_cookbook_dataset_then_determine_everything
-  # ========================================================================= #
-  def find_this_program_and_then_set_the_internal_cookbook_dataset_then_determine_everything(
-      compile_this_program = first_argument?
-    )
-    if does_include?(compile_this_program)
-      the_program_was_found # The program was found - so continue.
-      find_this_program_and_then_set_the_internal_cookbook_dataset(
-        compile_this_program
-      )
-      determine_everything
-    else
-      this_program_was_not_found(compile_this_program)
-    end
-  end; alias metafind  find_this_program_and_then_set_the_internal_cookbook_dataset_then_determine_everything # === metafind
-       alias meta_find find_this_program_and_then_set_the_internal_cookbook_dataset_then_determine_everything # === meta_find
-
-  # ========================================================================= #
-  # === parse_url1_and_set_all_associated_values
-  #
-  # We will make various changes depending on the url1 entry.
-  #
-  # If this entry exists, various data points will be set on the main
-  # dataset of this class.
-  # ========================================================================= #
-  def parse_url1_and_set_all_associated_values(
-      url1 = raw_cookbook?.url1?
-    )
-    # ======================================================================= #
-    # url1 may look like this:
-    #
-    #  https://www.python.org/ftp/python/3.9.4/Python-3.9.4.tgz
-    #
-    # ======================================================================= #
-    if url1
-      # ===================================================================== #
-      # Fix .js files.
-      # ===================================================================== #
-      if url1.end_with? '.js'
-        set_archive('.js')
-      elsif url1.end_with? '.gem'
-        set_archive(url1)
-      end
-      if url1.include? '%2B' # This means '+'.
-        url1.gsub!(/%2B/,'+')
-      end
-      if url1.include? '-trunk'
-        url1 = remove_file_extension(url1)
-      end
-      if url1.include? '-release.tar'
-        url1 = chop_off_archive(url1)
-        url1.sub!(/-release/,'')
-      end
-      # ===================================================================== #
-      # === Handle github URLs next
-      #
-      # Next, check if it is a github url and if it may not have a
-      # "-" and if it consists only of numbers; in this case we know
-      # we have to determine the program name in a different manner.
-      # ===================================================================== #
-      if is_github_url?(url1) and
-         !File.basename(url1).include?('-')  and
-         (url1 =~ /\d{0,2}\.\d{0,2}\.?\d{0,2}/)
-         # ================================================================== #
-         # In this case we will re-write this URL; and also modify the
-         # variable called url1.
-         #
-         # The current content of url1 may be a String such as:
-         #
-         #   'https://github.com/opencv/opencv/archive/3.4.5.tar.gz'
-         #
-         # ================================================================== #
-         use_this_regex =
-           /\/v?(\d{0,2}\.\d{0,2}\.?\d{0,2})\./ # See: https://rubular.com/r/dvCdVJWbtUhJaJ
-         # ================================================================== #
-         # We must use the unmodified input-name here because that name may
-         # still include '-' characters, which may be important for some
-         # programs. Unfortunately this is not always available, such as
-         # for:
-         #
-         #   https://github.com/kdave/btrfs-progs/archive/refs/tags/v5.11.1.tar.gz
-         #
-         # Thus, we will default to original_unmodified_name?, but we
-         # will try to determine whether the "/"-splitted third part
-         # contains a '-' character. If so then this name is used
-         # instead. The explanation can be seen by the text
-         # given above.
-         # ================================================================== #
-         replacement_name = original_unmodified_name?.to_s.dup
-         if url1.include? '/'
-           splitted = url1.split('/')
-           if splitted[4] and splitted[4].include?('-')
-             replacement_name = splitted[4]
-           end
-         end
-         url1.sub!(
-           use_this_regex,
-           '/'+replacement_name+'-\1.'
-         )
-      end
-    end
-    url1 = remove_archive_at_the_end(File.basename(url1))
-    program_information = ProgramInformation.new(url1)
-    set_short_name(program_information.short_name?)                                   # (1) short_name, such as 'gnomemahjongg'
-    set_program_name(program_information.program_name?)                               # (2) program_name, such as 'gnome-mahjongg'
-    set_program_version(program_information.program_version?)                         # (3) program_version
-    set_program_name_and_program_version("#{program_name?}-#{program_version?}")      # (4) program_name_and_program_version
-    set_program_full_name(program_name_and_program_version?+archive_type?)            # (6) program_full_name, such as 'gnome-mahjonng-5.08.tar.xz'
-    set_base_dir(:default)                                                            # (7) base_dir
-    _ = base_dir?.to_s+
-        program_name?.to_s+'-'+
-        program_version?.to_s+
-        archive_type?.to_s
-    set_program_path(_)                                                               # (8) program_path
-    unless File.exist? _
-      try_to_find_another_local_file(_)
-      set_program_path
-    end
-  end; alias guess_entries_based_on_the_first_url parse_url1_and_set_all_associated_values # === guess_entries_based_on_the_first_url
-
-  # ========================================================================= #
-  # === reassemble_the_program_path
-  #
-  # This method will always ultimate attempt to set the program path, if
-  # possible.
-  # ========================================================================= #
-  def reassemble_the_program_path(
-      i = return_default_program_path
-    )
-    assemble_the_default_program_name_and_program_version # Assign to something such as: "gnome-mahjongg-0.1.3"
-    set_program_path(i)
-  end; alias assemble_program_path   reassemble_the_program_path # === assemble_program_path
-       alias reassemble_program_path reassemble_the_program_path # === reassemble_program_path
-
-  # ========================================================================= #
-  # === initialize_the_main_hash_with_default_values
-  #
-  # This method is necessary so that our main hash contains all
-  # necessary values initially.
-  # ========================================================================= #
-  def initialize_the_main_hash_with_default_values
-    reset_the_dataset # This will make @internal_hash[:dataset] an empty Hash.
-    # ======================================================================= #
-    # Add the emptry-entries to the dataset next:
-    # ======================================================================= #
-    add_the_empty_entries_to_the_dataset_variable
-    add_the_nil_entries_to_the_dataset_variable
-    add_the_array_entries_to_the_dataset_variable
-    add_the_true_entries_to_the_dataset_variable
-    add_the_false_entries_to_the_dataset_variable
-    # ======================================================================= #
-    # Last but not least, add the remaining entries to the dataset variable.
-    # ======================================================================= #
-    add_the_remaining_entries_to_the_dataset_variable
-  end; alias populate_the_dataset_variable_with_default_values initialize_the_main_hash_with_default_values # === populate_the_dataset_variable_with_default_values
-
-  # ========================================================================= #
-  # === report_binary_or_library_program_name
-  #
-  # Only call this method when we have found an alias.
-  # ========================================================================= #
-  def report_binary_or_library_program_name(
-      i,
-      new_program_name,
-      binary_or_library = 'binary'
-    )
-    if i and !i.empty?
-      case binary_or_library
-      # ===================================================================== #
-      # === :binary
-      # ===================================================================== #
-      when :binary
-        binary_or_library = 'binary'
-      # ===================================================================== #
-      # === :library
-      # ===================================================================== #
-      when :library
-        binary_or_library = 'library'
-      end
-      opnn; e '`'+simp(i)+'` was found as name of a '+
-              simp(binary_or_library)+' file.'
-      opnn; e 'We will now assume that you want to get this '\
-              'whole package instead and will'
-      opnn; e 'thus set the name to this program now, which belongs to '\
-              'the package `'+sfancy(new_program_name)+'`.'+N
-    end
-  end
-
-  # ========================================================================= #
-  # === be_complex
-  # ========================================================================= #
-  def be_complex
-    @internal_hash[:simple_or_complex] = :complex
-  end
-
-  # ========================================================================= #
-  # === clear_yaml_dataset
-  # ========================================================================= #
-  def clear_yaml_dataset
-    cookbook_dataset?.clear
-  end
-
-  # ========================================================================= #
-  # === do_extract
-  #
-  # You can use this method, if you have class Extracter available,
-  # to force class Extracter to extract this program.
-  # ========================================================================= #
-  def do_extract(
-      i = program_path?
-    )
-    begin
-      require 'extracter' unless Object.const_defined? :Extracter
-    rescue LoadError; end
-    if Object.const_defined? :Extracter
-      # ======================================================================= #
-      # Ok, extracter is available so we can continue.
-      # ======================================================================= #
-      Extracter.new(i?).extracted_path? # Specify the path.
-    else
-      opnn; e 'class Extracter is not available. Consider installing it via:'
-      e
-      opnn; e orange('  gem install extracter')
-      e
-    end
-  end
-
-  # ========================================================================= #
-  # === assume_default_archive_type
-  # ========================================================================= #
-  def assume_default_archive_type(
-      i = DEFAULT_ARCHIVE_TYPE
-    )
-    set_archive_type(i)
-  end
-
-  # ========================================================================= #
-  # === determine_all_relevant_values_for_the_dataset_variable
-  #
-  # This method will copy some important values from the raw-cookbook
-  # to the main @dataset variable.
-  # ========================================================================= #
-  def determine_all_relevant_values_for_the_dataset_variable
-    # ======================================================================= #
-    # Some variables are still missing, such as program_path. The
-    # specification does not include these, but we need them for
-    # class RBT::Compile, so add these next.
-    #
-    # Perhaps in the future we may also add these variables, but for
-    # the time being, these variables have to be defined next.
-    # ======================================================================= #
-    dataset?[:program_path] = base_dir?.to_s+
-                              program_name_and_program_version?.to_s+
-                              archive_type?.to_s
-    if dataset?[:program_path].nil?
-      dataset?[:program_path] = raw_cookbook?.program_path?
-    end
-    if dataset?[:program_version].nil?
-      dataset?[:program_version]   = return_program_version_from_the_raw_cookbook
-    end
-    if dataset?[:program_full_name].nil?
-      dataset?[:program_full_name] = return_default_program_full_name
-    end
-    if dataset?[:program_name].nil?
-      dataset?[:program_name]      = return_program_name_from_the_raw_cookbook
-    end
-    if dataset?[:program_name_and_program_version].nil?
-      dataset?[:program_name_and_program_version] = raw_cookbook?.program_name_and_program_version?
-    end
-    if dataset?[:keep_extracted].nil?
-      set_keep_extracted(raw_cookbook?.keep_extracted?)
-    end
-  end
-
-  # ========================================================================= #
-  # === feedback_version
-  #
-  # This will feedback the program-version.
-  # ========================================================================= #
-  def feedback_version(shall_we_exit = true)
-    opnn; e "The current RBT-Version is: #{RBT.version?}"
-    exit if shall_we_exit
-  end
-
-  # ========================================================================= #
-  # === sanitize_program_path
-  # ========================================================================= #
-  def sanitize_program_path
-    reassemble_program_path
-  end; alias rebuild_path sanitize_program_path # === rebuild_path
-
-  # ========================================================================= #
-  # === determine_the_program_name_and_the_program_version_from_url1
-  #
-  # Do note that this method will respect program_name_and_program_version
-  # entries.
-  # ========================================================================= #
-  def determine_the_program_name_and_the_program_version_from_url1(
-      url1 = url1?
-    )
-    i = remove_archive_from_the_end(
-      File.basename(url1)
-    ).dup
-    _ = program_name_and_program_version?
-    if _ and _.is_a?(String) and !_.empty?
-      # ===================================================================== #
-      # This clause is entered when the .yml file at hand has both an
-      # url1 entry but also a specific program_name_and_program_version
-      # entry. In this case we simply grab the
-      # program_name_and_program_version entry instead.
-      # ===================================================================== #
-      i = _
-    end
-    if i.include?(token?)
-      completely_infer_the_program_name_and_the_program_version_from_this_input(i)
-    elsif i.include?(opposite_token?)
-      set_separator_token(opposite_token?)
-      completely_infer_the_program_name_and_the_program_version_from_this_input(i)
-    else
-      if is_a_github_url? and (i =~ /^v\d+/)
-        require 'rbt/toplevel_methods/return_program_name_and_program_version_from_this_github_url.rb'
-        i = RBT.return_program_name_and_program_version_from_this_github_url(url1?)
-      end
-      # ===================================================================== #
-      # Alright - we have not found a separator token, such as '-' or
-      # '_'. What to do in such a case?
-      # One strategy is to notify the user about it, but this does not
-      # really resolve the issue at hand. Since as of 27.05.2020
-      # I decided to "fake-simulate" the proper program name and program
-      # version based on ProgramInformation. That also means that the
-      # old notification was disabled, but it will be kept in the source
-      # code here, in the event that we may wish to re-attach it one day.
-      # ===================================================================== #
-      completely_infer_the_program_name_and_the_program_version_from_this_input(
-        ProgramInformation.return_name(i)+
-        '-'+
-        ProgramInformation.return_version(i)
-      )
-      # opnn; e 'No separator token found: '+steelblue(token?.to_s)
-      # opnn; e tomato('The URL was: ')+steelblue(url1)
-    end
-  end; alias determine_the_program_name_and_the_program_version_from_url1_while_respecting_existing_values determine_the_program_name_and_the_program_version_from_url1 # === determine_the_program_name_and_the_program_version_from_url1_while_respecting_existing_values
-
-  # ========================================================================= #
-  # === assemble_the_default_program_name_and_program_version
-  #
-  # This method will assemble the program_name (6) variable, which
-  # is derived directly from:
-  #
-  #  program_name? and '-' and program_version?
-  #
-  # For example it could look like this:
-  #
-  #   "gnome-mahjongg-5.08"
-  #
-  # ========================================================================= #
-  def assemble_the_default_program_name_and_program_version(
-      i = :default
-    )
-    case i
-    when :default
-      i = program_name?+
-          token?+
-          program_version?
-    end
-    set_program_name_and_program_version(i)
-  end; alias assemble_program_name                   assemble_the_default_program_name_and_program_version # === assemble_program_name
-       alias update_program_name                     assemble_the_default_program_name_and_program_version # === update_program_name
-       alias attach_program_name_and_program_version assemble_the_default_program_name_and_program_version # === attach_program_name_and_program_version
-       alias assemble_default_program_name           assemble_the_default_program_name_and_program_version # === assemble_default_program_name
-
-  # ========================================================================= #
-  # === update_program_path
-  # ========================================================================= #
-  def update_program_path
-    set_program_path(:default)
-  end; alias assemble_full_path update_program_path # === assemble_full_path
-
-  # ========================================================================= #
-  # === rebuild_program_full_name
-  # ========================================================================= #
-  def rebuild_program_full_name
-    set_program_full_name(:default)
-  end; alias update_program_full_name rebuild_program_full_name # === update_program_full_name
-
-  # ========================================================================= #
-  # === update_appdir_prefix
-  # ========================================================================= #
-  def update_appdir_prefix
-    set_prefix(:appdir)
-  end
-
-  # ========================================================================= #
-  # === clear_configure_options
-  # ========================================================================= #
-  def clear_configure_options
-    set_configure_options nil
-  end; alias clear clear_configure_options # === clear
-
-  # ========================================================================= #
-  # === this_program_was_not_found
-  # ========================================================================= #
-  def this_program_was_not_found(i)
-    unless i.to_s.empty?
-      opnn; e "The program #{steelblue(i.to_s)} does "\
-              "#{tomato('not')} appear to be registered."
-    end
-  end
-
-  # ========================================================================= #
-  # === quiet_down
-  #
-  # This method will cause the cookbook to be silent and not report
-  # how many programs are registered.
-  # ========================================================================= #
-  def quiet_down
-    set_be_silent # This is defined in the parent class.
-    @internal_hash[:report_how_many_programs_are_registered] = false
-  end
-
-  # ========================================================================= #
-  # === feedback_available_cookbooks
-  #
-  # Feedback which cookbooks are available.
-  # ========================================================================= #
-  def feedback_available_cookbooks(i = available_programs?)
-    e 'These cookbooks are available:'; print '  '
-    e i.join(', ')
-  end
-
-  # ========================================================================= #
-  # === feedback_description
-  #
-  # Use this method if you wish to feedback the description of a given
-  # program at hand.
-  # ========================================================================= #
-  def feedback_description
-    e description?
-  end
-
-  # ========================================================================= #
-  # === determine_which_program_is_sought
-  # ========================================================================= #
-  def determine_which_program_is_sought(
-      _ = first_argument?
-    )
-    set_seek_this_program(_)
-  end
-
-  # ========================================================================= #
-  # === instantiate_raw_cookbook
-  # ========================================================================= #
-  def instantiate_raw_cookbook(
-      i = seek_this_program?
-    )
-    # ===================================================================== #
-    # We also have to sync the variable @simple_or_complex down onto the
-    # raw-cookbooks loader.
-    # ===================================================================== #
-    @internal_hash[:raw_cookbook] = RBT.raw_cookbook(i) { simple_or_complex? }
-  end; alias initialize_raw_cookbook instantiate_raw_cookbook # === initialize_raw_cookbook
-
-  # ========================================================================= #
-  # === sanitize_env_variables
-  #  
-  # This will sanitize ENV variables. The ENV variables must be a
-  # Hash at all times.
-  # ========================================================================= #
-  def sanitize_env_variables
-    # ======================================================================= #
-    # Sync it first.
-    # ======================================================================= #
-    dataset?[:set_env_variables] = raw_cookbook?.set_env_variables?
-    _ = set_env_variables?
-    if _ and _.is_a? Array # Must also check for nil.
-      # ===================================================================== #
-      # If it is an Array, then it must be wrong, so correct this here
-      # silently. We need a Hash, as specified in the specification.
-      # ===================================================================== #
-      hash = {}
-      _.each {|inner_hash|
-        if inner_hash.is_a? Hash
-          key   = inner_hash.keys.first
-          value = inner_hash.values.first
-          hash[key] = value
-        end
-      }
-      dataset?[:set_env_variables] = hash
-    end 
-  end; alias sanitize_set_env_variables sanitize_env_variables # === sanitize_set_env_variables
-
-  # ========================================================================= #
-  # === sanitize_configure_options                            (configure tag)
-  #
-  # Work on the configure options, i.e. @dataset['configure_options'].
-  #
-  # Note that this depends on program_version? having been set properly.
-  #
-  # Some options should not be sanitized, such as "-Wno-dev -G Ninja .."
-  # in applications that use the cmake build system, e. g. LLVM.
-  # ========================================================================= #
-  def sanitize_configure_options
-    # ======================================================================= #
-    # We must first check if we are allowed to modify the configure options
-    # at all. Some programs, such as openssl, will not allow such
-    # modification due to their strange way how they mix different
-    # configure-options.
-    #
-    # There are some exceptions to this, though. Newlines for example
-    # can always be removed.
-    # ======================================================================= #
-    _ = raw_cookbook?.configure_options?.to_s.strip # We don't want newlines.
-    if may_we_modify_the_configure_options?
-      # ===================================================================== #
-      # Get rid of multi-blanks next.
-      # ===================================================================== #
-      if _
-        # =================================================================== #
-        # We will assume this to be a comment, so we have to remove these
-        # comments.
-        # =================================================================== #
-        if _.include? ' # '
-          _ = remove_comments_from_each_line(_)
-        end
-        _.squeeze!('/')
-        _.gsub!(/#{N}/,' ')
-      end
-      # ===================================================================== #
-      # Treat 'VERSION' as a macro, for expansion.
-      # ===================================================================== #
-      if _.include? 'PROGRAM_VERSION'
-        _.gsub!(/PROGRAM_VERSION/, program_version?.to_s) if _
-      elsif _.include? 'VERSION'
-        _.gsub!(/VERSION/, program_version?.to_s) if _
-      end
-      # ===================================================================== #
-      # Treat 'CURRENT' as a macro, for expansion.
-      # ===================================================================== #
-      if _.include? 'CURRENT'
-        _.gsub!(/CURRENT/, program_version?.to_s) if _
-      end
-      # ===================================================================== #
-      # === NAME_OF_THE_DISTRIBUTION
-      # ===================================================================== #
-      if _.include? 'NAME_OF_THE_DISTRIBUTION'
-        name = load_yaml(
-          "#{project_yaml_directory?}configuration/name_of_the_distribution.yml"
-        )
-        _.gsub!(/NAME_OF_THE_DISTRIBUTION/, name)
-      end
-      unless _.empty?
-        # =================================================================== #
-        # Finally, run through the configure options. If they start with
-        # the Strings "enable" or "disable", with or without, we prepend --
-        # if this is not yet the case.
-        #
-        # Since as of September 2011, we will always prepend --, unless
-        # the first character already is a '-' (this is done to 
-        # =================================================================== #
-        splitted = _.split(' ')
-        _ = splitted.map {|configure_option|
-          # If configure_option =~ /^disable|enable|with|without/
-          # ================================================================= #
-          # Only add when not yet first char is NOT a '-'.
-          # ================================================================= #
-          unless configure_option.start_with?('-') or
-                 configure_option.start_with?('$') or
-                 configure_option.start_with?('.')
-            unless (configure_option == 'Ninja') and
-                   splitted.include?('-G') # For cmake variants like: "-G Ninja"
-              configure_option.prepend('--')
-            end
-          end
-          # end
-          configure_option
-        }.join(' ')
-      end
-      # ===================================================================== #
-      # Try to handle $ input.
-      # ===================================================================== #
-      if _.include? '$'
-        unless Object.const_defined? :ConvertGlobalEnv
-          require 'convert_global_env'
-        end
-        _ = ConvertGlobalEnv.convert(_)
-      end
-    end
-    _.tr!(N, ' ') # Replace all newlines again.
-    set_configure_options(_) # Last but not least, reassign.
-  end
-
-  # ========================================================================= #
-  # === sanitize_base_dir
-  # ========================================================================= #
-  def sanitize_base_dir
-    _ = base_dir?.to_s
-    set_base_dir(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_configure_base_dir
-  #
-  # We must ensure that this variable has a trailing / character.
-  #
-  # There are several reasons for this, but one important reason is
-  # that class RBT::Compile will do a calculation based on the
-  # amount of '/' in the configure_base_dir string. So if we have
-  # one more or less '/', the calculation's result will vary -
-  # thus, we must ensure that the '/' is trailing here.
-  # ========================================================================= #
-  def sanitize_configure_base_dir
-    _ = raw_cookbook?.configure_base_dir?
-    if _.nil?
-      _ = configure_base_dir?
-    end
-    set_configure_base_dir(rds("#{_}/"))
-  end
-
-  # ========================================================================= #
-  # === sanitize_symlink_glib_schema
-  # ========================================================================= #
-  def sanitize_symlink_glib_schema
-    _ = raw_cookbook?.symlink_glib_schema?.to_s
-    if _ and _.empty?
-      _ = symlink_glib_schema?.to_s
-    end
-    set_symlink_glib_schema(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_use_this_make_command
-  #
-  # This will default to whatever is stored in the configuration file.
-  #
-  # Should be 'make' usually, but could be "cmake" or another make-like
-  # command.
-  # ========================================================================= #
-  def sanitize_use_this_make_command
-    _ = use_this_make_command?
-    if _ and _.empty?
-      _ = raw_cookbook?.use_this_make_command?
-      if _.nil? or _.empty?
-        _ = MAKE_COMMAND_TO_USE # MAKE_COMMAND_TO_USE is defined in constants.rb
-      end
-    end
-    set_use_this_make_command(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_extra_information
-  #
-  # We must not lose information from the original dataset, in regards
-  # to extra_information.
-  # ========================================================================= #
-  def sanitize_extra_information
-    _ = raw_cookbook?.extra_information?
-    if _
-      _.chomp!  if _.respond_to? :chomp!
-      _.rstrip! if _.respond_to? :rstrip!
-      _ = word_wrap(_) if use_word_wrap?
-      set_extra_information(_)
-    end
-  end
-
-  # ========================================================================= #
-  # === sanitize_configure_options_explained
-  # ========================================================================= #
-  def sanitize_configure_options_explained
-    _ = raw_cookbook?.configure_options_explained?.to_s
-    set_configure_options_explained(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_enable_static
-  # ========================================================================= #
-  def sanitize_enable_static
-    _ = raw_cookbook?.enable_static?.to_s
-    if _ and _.empty?
-      _ = enable_static?.to_s
-    end
-    set_do_not_symlink(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_use_autoconf
-  # ========================================================================= #
-  def sanitize_use_autoconf
-    _ = raw_cookbook?.use_autoconf?
-    if _ and _.is_a?(String) and _.empty?
-      _ = use_autoconf?.to_s
-    end
-    _ = to_bool(_)
-    _ = false if _.nil?
-    set_use_autoconf(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_wikipedia
-  # ========================================================================= #
-  def sanitize_wikipedia
-    _ = raw_cookbook?.wikipedia?
-    set_wikipedia(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_git_url
-  # ========================================================================= #
-  def sanitize_git_url
-    _ = git_url?
-    _ = raw_cookbook?.git_url? if _.nil?
-    set_git_url(_) if _
-  end
-
-  # ========================================================================= #
-  # === sanitize_use_this_program_name_on_gobolinux
-  # ========================================================================= #
-  def sanitize_use_this_program_name_on_gobolinux(
-      are_we_on_gobolinux = are_we_on_gobolinux?
-    )
-    _ = program_compile_name?
-    if are_we_on_gobolinux and
-      !use_this_program_name_on_gobolinux?.to_s.empty?
-      _ = use_this_program_name_on_gobolinux?.to_s
-      set_program_compile_name(_) # Will always be at the least an empty String.
-    end
-  end; alias sanitize_program_compile_name sanitize_use_this_program_name_on_gobolinux # === sync_use_this_program_name_on_gobolinux
-
-  # ========================================================================= #
-  # === sanitize_preinstall
-  # ========================================================================= #
-  def sanitize_preinstall
-    _ = preinstall?
-    if _ and _.empty?
-      _ = raw_cookbook?.preinstall?
-    end
-    if _.is_a?(String) and (_.count(N) > 1)
-      _ = _.split(N)
-    end
-    if _.nil? # Safeguard to ensure Array.
-      set_preinstall []
-    else
-      _ = [_] if _.is_a? String
-      if _.is_a? Array
-        _.compact!
-        _.map!(&:strip)
-        _.reject! {|entry| entry.empty? } # Weed out empty entries.
-        _.flatten!
-      end
-      set_preinstall _
-    end
-  end
-
-  # ========================================================================= #
-  # === sanitize_cmake_configure_options
-  #
-  # This method is similar to the method that will sanitize the configure
-  # options, but it is only valid for cmake, not for GNU autoconfigure.
-  #
-  # A similar method exists for meson-configure-options by the way.
-  # ========================================================================= #
-  def sanitize_cmake_configure_options
-    _ = cmake_configure_options?
-    if _.nil?
-      if raw_cookbook?.cmake_configure_options?
-        _ = raw_cookbook?.cmake_configure_options?
-      end
-    end
-    if _ and !_.empty?
-      _ = _.to_s.strip
-      # ===================================================================== #
-      # We will assume this to be a comment, so we have to remove these
-      # comments.
-      # ===================================================================== #
-      if _.include? ' # '
-        _ = remove_comments_from_each_line(_)
-      end
-      _.tr!(N,' ')
-      _.strip!
-      set_cmake_configure_options(_)
-    end
-  end
-
-  # ========================================================================= #
-  # === sanitize_meson_configure_options
-  #
-  # This method is similar to the method sanitize_configure_options()
-  # but it is only valid for meson, not for GNU autoconfigure.
-  #
-  # The configure options for meson must be kept as a String, at all times.
-  # ========================================================================= #
-  def sanitize_meson_configure_options
-    _ = raw_cookbook?.meson_configure_options?
-    _ = meson_configure_options? unless meson_configure_options?.nil?
-    # ======================================================================= #
-    # We sanitize it a bit, if the option exists.
-    # ======================================================================= #
-    if _
-      _ = _.to_s.strip
-      # ===================================================================== #
-      # We will assume this to be a comment, so we have to remove these
-      # comments.
-      # ===================================================================== #
-      if _.include? ' # '
-        _ = remove_comments_from_each_line(_)
-      end
-      if _.include? N
-        _.tr!(N,' ')
-      end
-      _.strip!
-      _.squeeze!(' ')
-      set_meson_configure_options(_)
-    end
-  end
-
-  # ========================================================================= #
-  # === sanitize_pre_configure_steps
-  # ========================================================================= #
-  def sanitize_pre_configure_steps
-    _ = pre_configure_steps?
-    _ = raw_cookbook?.pre_configure_steps? if _ and _.empty?
-    set_pre_configure_steps(_) if _
-  end
-
-  # ========================================================================= #
-  # === sanitize_pkgconfig_files
-  # ========================================================================= #
-  def sanitize_pkgconfig_files
-    _ = pkgconfig_files?
-    if _ and _.empty?
-      _ = raw_cookbook?.pkgconfig_files? if raw_cookbook?.pkgconfig_files?
-    end
-    set_pkgconfig_files(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_echo_yes
-  # ========================================================================= #
-  def sanitize_echo_yes
-    _ = raw_cookbook?.echo_yes?.to_s
-    set_echo_yes(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_svn_url
-  # ========================================================================= #
-  def sanitize_svn_url
-    _ = svn_url?
-    if _.nil?
-      _ = raw_cookbook?.svn_url?
-    end
-    set_svn_url(_.to_s)
-  end
-
-  # ========================================================================= #
-  # === sanitize_autogen
-  # ========================================================================= #
-  def sanitize_autogen
-    _ = raw_cookbook?.use_autogen?
-    if _.nil?
-      _ = use_autogen?
-    end
-    set_use_autogen(
-      to_bool(_)
-    )
-  end
-
-  # ========================================================================= #
-  # === sanitize_postinstall
-  #
-  # This will sanitize the postinstall stuff, by assigning to the
-  # respective entry in the main Hash.
-  #
-  # Note that we have to invoke this method only after short_name
-  # and program_version was set, because one entry requires this
-  # specifically.
-  #
-  # As of 20.09.2014, the specification requires that postinstall
-  # must be an Array at all times.
-  #
-  # Invocation example:
-  #
-  #   scookie libraw1394
-  #
-  # ========================================================================= #
-  def sanitize_postinstall
-    _ = [postinstall?].flatten.compact # Get rid of nil values.
-    if _ and _.is_a?(Array) and _.empty?
-      _ = raw_cookbook_dataset?['postinstall']
-    end
-    if _.is_a? Array
-      _.map! {|entry| substitute_macros(entry) }
-    end
-    # ===================================================================== #
-    # Turn it into an Array for sure:
-    # ===================================================================== #
-    _ = [_].flatten.compact
-    # ===================================================================== #
-    # Sanitize the @postinstall variable next.
-    # ===================================================================== #
-    if _.is_a? Array
-      point_to_binaries    = sysbin_directory?
-      point_to_libraries   = syslib_directory?
-      point_to_includes    = sysinclude_directory?
-      point_to_program_dir = program_directory?
-      _.map! {|entry|
-        if entry.include? 'UNIVERSAL_BINARY_DIR'
-          entry.gsub!(/UNIVERSAL_BINARY_DIR/,  point_to_binaries)
-        end
-        entry.gsub!(/UNIVERSAL_BINARIES_DIR/,  point_to_binaries)
-        entry.sub!(/UBD/,                      point_to_binaries)
-        entry.gsub!(/UNIVERSAL_LIBRARIES_DIR/, point_to_libraries)
-        entry.sub!(/ULD/,                      point_to_libraries)
-        entry.gsub!(/UNIVERSAL_INCLUDE_DIR/,   point_to_includes)
-        entry.gsub!(/PROGRAM_DIR/,             point_to_program_dir)
-        entry.gsub!(/PROGRAMS_DIR/,            point_to_program_dir)
-        entry.gsub!(/,cp/,                     ',copy_file')
-        # ================================================================= #
-        # Handle the MIDDLE_VERSION macro next. This one is, for
-        # python, the value "8", from version "3.8.3" - thus the
-        # middle part.
-        # ================================================================= #
-        if entry.include? 'MIDDLE_VERSION'
-          entry.sub!(/MIDDLE_VERSION/, return_middle_part_of_the_program_version)
-        end
-        entry.strip! # Strip it.
-        entry = rds(entry) # Replace // with // here.
-        entry
-      }
-      set_postinstall _ # Reassign.
-    end
-    unless postinstall?.is_a? Array
-      _ = rds(postinstall?)
-      _ = _.split(',') if _.include? ','
-      set_postinstall [_].flatten
-    end
-  end
-
-  # ========================================================================= #
-  # === sanitize_the_binaries                                  (binaries tag)
-  #
-  # This method will sanitize the binaries entry.
-  #
-  # The binaries must be kept in Array format at all times.
-  # ========================================================================= #
-  def sanitize_the_binaries
-    _ = raw_cookbook?.binaries?
-    _ = [] if _.nil?
-    if _ and !_.empty?
-      if _.is_a?(String) and !_.empty?
-        _ = _.split(',')
-      elsif _.is_a? String
-        _ = [_]
-      end
-      if _.is_a? Array
-        if _.first.include? ',' # Assume that we must split then.
-          _.map! {|entry| entry.split(',') }
-        end if _.first
-      end
-    end
-    _ = _.flatten.compact.map(&:strip)
-    set_binaries(_)
-  end; alias sanitize_binaries sanitize_the_binaries # === sanitize_binaries
-
-  # ========================================================================= #
-  # === sanitize_has_to_be_compiled
-  # ========================================================================= #
-  def sanitize_has_to_be_compiled
-    _ = raw_cookbook?.has_to_be_compiled?
-    if _.nil? or (_.is_a?(String) and _.empty?) # Empty Strings will be "sanitized" here.
-      _ = has_to_be_compiled?
-    end
-    set_has_to_be_compiled(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_pre_make_commands
-  #
-  # We must keep the pre_make_commands in Array format. The method
-  # here will make sure of this.
-  #
-  # We can only invoke this after having set program_version before,
-  # because some macro-substitutions require the program version to
-  # be properly set before the make-commands can be sanitized.
-  # ========================================================================= #
-  def sanitize_pre_make_commands
-    _ = pre_make_commands?
-    if _.empty?
-      _ = raw_cookbook?.pre_make_commands?
-    end
-    _.compact! if _.is_a? Array # Get rid of nil values.
-    case _ # Do a bit free-form sanitizing next.
-    when 'handle configure.py'
-      _ = 'python configure.py'
-    end
-    array = []
-    if _
-      unless _.empty?
-        _ = substitute_macros(_)
-        array << _
-      end
-    end
-    array.flatten!
-    array.compact!
-    set_pre_make_commands(array) # Turn it into an Array here.
-  end
-
-  # ========================================================================= #
-  # === sanitize_description                      (description tag, desc tag)
-  #
-  # Get rid of trailing newlines in our description, and apply
-  # some other operations. 
-  # ========================================================================= #
-  def sanitize_description
-    _ = description?.to_s.chomp
-    _.chop! if _.end_with? '"' # Get rid of leading and trailing ".
-    _[0,1] = '' if _.start_with? '"'
-    # ======================================================================= #
-    # Some macros have to be expanded before we invoke substitute_macros().
-    # SELF_NAME is such an example.
-    # ======================================================================= #
-    if _.include? 'SELF_NAME'
-      _.gsub!(/SELF_NAME/, short_name?)
-    end
-    _ = substitute_macros(_)
-    begin # Replace newlines with ' ' characters.
-      _ = _.gsub(/#{N}/,' ').squeeze(' ')
-    rescue Exception => error
-      cliner {
-        opnn; e 'An error happened for the description:'
-        pp @_
-        pp error
-      }
-    end
-    # ======================================================================= #
-    # Next, if this is empty, but short_description? is not, then
-    # simply copy-paste the content of short_description? onto
-    # the main program description.
-    # ======================================================================= #
-    if _.to_s.empty? and !short_description?.to_s.strip.empty?
-      _ = short_description?.dup
-    end
-    set_description(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_gir_files
-  # ========================================================================= #
-  def sanitize_gir_files
-    _ = gir_files?
-    if _.empty?
-      _ = raw_cookbook?.gir_files? if raw_cookbook?.gir_files?
-    end
-    set_gir_files(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_configure_command_to_use
-  # ========================================================================= #
-  def sanitize_configure_command_to_use
-    _ = configure_command_to_use?
-    if _ and _.empty?
-      _ = raw_cookbook?.configure_command_to_use?.to_s # It must be a String.
-    end
-    if _
-      if _.empty? and deps_on? and deps_on?.include?('waf')
-        _ = 'waf'
-      end
-      if _.empty?
-        _ = 'configure' # set default, reset every time.
-      else
-        _ = convert_global_env(_) if _.include? '$'
-      end
-      set_configure_command_to_use(_)
-    end
-  end; alias sanitize_configure_command sanitize_configure_command_to_use # === sanitize_configure_command
-
-  # ========================================================================= #
-  # === sanitize_autosymlink_lib64
-  # ========================================================================= #
-  def sanitize_autosymlink_lib64
-    _ = raw_cookbook?.autosymlink_lib64?
-    set_autosymlink_lib64(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_can_be_compiled_statically
-  # ========================================================================= #
-  def sanitize_can_be_compiled_statically
-    _ = raw_cookbook?.can_be_compiled_statically?
-    set_can_be_compiled_statically(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_the_libraries
-  #
-  # This sanitizes the libraries entry, @_[:libraries].
-  #
-  # We must keep this entry in Array format.
-  # ========================================================================= #
-  def sanitize_the_libraries
-    _ = raw_cookbook?.libraries?
-    unless _.is_a? Array
-      _ = [_].compact
-    end
-    # ======================================================================= #
-    # Next, we will assume something such as:
-    #   ["libdevkit-power-gobject.{so,a},libupower-glib.{so,a}"] 
-    # ======================================================================= #
-    unless _.empty? # safeguard against nil entries.
-      if _ and _.first and _.first.include?('}') and _.first.include?('{')
-        splitted = _.first.split(/\},/)
-        splitted.map! {|entry|
-          entry =~ REGEX_TO_SANITIZE_LIBRARIES
-          [$1+'.'+$2, $1+'.'+$3]
-        }
-        splitted.flatten!
-        _ = splitted
-      end
-    end
-    if _.is_a? Array
-      if _.first.include? ','
-        _ = _.first.split(',')
-        _.map!(&:strip) # It should not include empty whitespace.
-        # =================================================================== #
-        # Some libraries may have components such as foo{so.a}
-        # We need to split these up into foo.so and foo.a.
-        # =================================================================== #
-      end if _.first
-    end
-    new_value = [_].flatten.compact
-    set_libraries(new_value)
-  end; alias sanitize_libraries sanitize_the_libraries # === sanitize_libraries
-
-  # ========================================================================= #
-  # === sanitize_flatpak_url
-  # ========================================================================= #
-  def sanitize_flatpak_url
-    _ = raw_cookbook?.flatpak_url?.to_s
-    if _ and _.empty?
-      _ = flatpak_url?.to_s
-    end
-    set_flatpak_url(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_last_update
-  #
-  # The only sanitize-operation we do here is if it is an valid date,
-  # such as "32 Aug 2017".
-  # ========================================================================= #
-  def sanitize_last_update
-    _ = last_update?
-    if _ and _.include? ' '
-      splitted = _.split(' ')
-      day = splitted.first # Fetch the day-entry.
-      if day.to_i > 31
-        opnn; e swarn('The last_update entry for ')+
-                steelblue(program_name?)+
-                swarn(' is wrong (too high).')
-        opnn; e swarn('Please correct this entry.')
-        opnn; e swarn('The faulty entry currently looks like this:')
-        e
-        e "  #{_}"
-        e
-        # =================================================================== #
-        # We could exit here but this is mostly an annoyance rather than
-        # a bug, so we continue. As of April 2021, we will exit.
-        # =================================================================== #
-        exit
-      end
-    elsif _.count('.') == 2 # Input such as '24.09.2017'
-      splitted = _.split('.')
-      splitted[1] = return_month_based_on_this_number(splitted[1])[0,3] # This is the month but only the first 3 characters.
-      _ = splitted.join(' ')
-      set_last_update(_)
-    end
-  end; alias sanitize_last_update_entry sanitize_last_update # === sanitize_last_update_entry
-
-  # ========================================================================= #
-  # === sanitize_mirror
-  # ========================================================================= #
-  def sanitize_mirror
-    _ = raw_cookbook?.mirror?.to_s
-    set_mirror(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_use_this_build_directory
-  # ========================================================================= #
-  def sanitize_use_this_build_directory
-    _ = raw_cookbook?.use_this_build_directory?
-    set_use_this_build_directory(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_short_name
-  # ========================================================================= #
-  def sanitize_short_name
-    _ = raw_cookbook?.short_name?
-    if _.nil?
-      _ = short_name?
-    end
-    set_short_name(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_homepage
-  # ========================================================================= #
-  def sanitize_homepage
-    _ = raw_cookbook?.homepage?
-    unless _.is_a? String # Make sure we have a String.
-      _ = _.to_s
-    end
-    set_homepage(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_required_deps_on
-  #
-  # The entry required_deps_on will be sanitized here - it must be an 
-  # Array at all times.
-  # ========================================================================= #
-  def sanitize_required_deps_on
-    _ = raw_cookbook?.required_deps_on?
-    if _.nil?
-      _ = return_proper_type_for(:required_deps_on)
-    end
-    if _.is_a? String # Input such as 'perl cmake'. Has to become an Array.
-      if _.include? ' '
-        unless _.include?('>') or _.include?('<') # But not when we have comparison-operators.
-          _ = _.split(' ')
-        end
-      end
-    end
-    array = []
-    _ = [_].flatten.compact # Must be an Array.
-    _.map! {|entry|
-      if entry.include? ','
-        entry = entry.split(',').map(&:strip)
-      end 
-      entry
-    } unless _.empty?
-    array << _
-    array.flatten!
-    array.compact!
-    # ======================================================================= #
-    # At this point the entry is a sanitized Array. But the cookbook
-    # file may still have made a mistake, such as when an entry
-    # was accidentally listed twice. (I had this problem in Feb
-    # 2017, which was why I added the following code.)
-    # So we need to check whether the entries are all unique - and
-    # if they are not, we will notify the user that something may
-    # be wrong with the yaml file in question.
-    # ======================================================================= #
-    if array.uniq.size != array.size
-      path = RBT.individual_cookbooks_dir?+
-             program?+
-             '.yml'
-      non_unique_entries = array.uniq.map { |e|
-        [array.count(e), e]
-      }.select {| c, _ | c > 1 }.sort.reverse.first.last
-      unless non_unique_entries.is_a? Array
-        non_unique_entries = [non_unique_entries] # We need an Array.
-      end
-      opnn; e swarn('There may be one (or several) duplicate dependencies '\
-                    'listed in the yaml file.')
-      opnn; e swarn('  Path: ')+sfile(path)
-      opnn; e swarn('Here are the duplicate entries:')
-      non_unique_entries.each {|duplicate_entry|
-        e "  #{simp(duplicate_entry)}"
-      }
-      e swarn('If you wish to check for that on your own, have a look at the')
-      e swarn('yaml file at `')+sfile(path)+swarn('`.')
-      e swarn('Check the "required_deps_on:" entry of the .yml file.')
-    end
-    set_required_deps_on(array)
-  end; alias sanitize_required_deps sanitize_required_deps_on # === sanitize_required_deps
-
-  # ========================================================================= #
-  # === sanitize_sed_entry                                          (sed tag)
-  #
-  # The sed entry allows us to make some very simple replacements in files.
-  #
-  # We will guarantee that this setting will be an Array.
-  # ========================================================================= #
-  def sanitize_sed_entry
-    # ======================================================================= #
-    # Only sanitize the sed entry if we have that key.
-    # ======================================================================= #
-    if has_key? :sed
-      raw_data = raw_cookbook_dataset?
-      _ = sed?
-      if (_ == false) and raw_data.has_key?('sed')
-        _ = raw_data['sed']
-      end
-      if _
-        _ = _.split(N) if _.is_a? String
-        if _
-          # ================================================================= #
-          # We need an Array past this point.
-          # ================================================================= #
-          _ = [_].compact # We don't want to store nil values here.
-          set_sed(_)
-        end
-      end
-    end
-  end; alias try_to_sanitize_the_sed_entry sanitize_sed_entry # === try_to_sanitize_the_sed_entry
-
-  # ========================================================================= #
-  # === sanitize_blfs_entry
-  #
-  # This will be only synced if we actually have an entry.
-  #
-  # The BLFS entry must be guaranteed to be an Array.
-  # ========================================================================= #
-  def sanitize_blfs_entry
-    _ = raw_cookbook?.blfs?
-    if _
-      unless _.is_a? Array
-        if _.nil?
-          _ = []
-        elsif _.empty?
-          _ = [] # Empty Array then.
-        else
-          _ = [_]
-        end
-      end
-      set_blfs(_)
-    else # Set it to be an empty Array by default, in this case.
-      set_blfs []
-    end
-  end; alias sanitize_BLFS_entry sanitize_blfs_entry # === sanitize_BLFS_entry
-
-  # ========================================================================= #
-  # === sanitize_licence
-  #
-  # Empty license should default to "unknown" license. This method will
-  # ensure that this is the case.
-  # ========================================================================= #
-  def sanitize_licence
-    _ = licence?
-    begin
-      if _.nil? or _.empty?
-        _ = 'unknown'
-      else
-        if _.is_a?(String) and _.include?(',') # ← In this case, turn it into an Array.
-          _ = _.split(',').map(&:strip)
-        else
-          _ = 'unknown' if _.nil? or _.empty?
-        end
-      end
-      set_licence(_)
-    rescue Exception => error
-      opnn; e 'An error happened in sanitize_licence().'
-      pp data?
-      pp error
-      pp error.class
-      opnn; e 'Exiting now - this error (in sanitize_licence()) '\
-              'should be fixed though.'
-      exit
-    end
-  end
-
-  # ========================================================================= #
-  # === sanitize_short_description
-  #
-  # Right now this method will only get rid of newlines and do a .strip()
-  # call.
-  # ========================================================================= #
-  def sanitize_short_description
-    short_description = short_description?
-    if short_description.nil?
-      short_description = raw_cookbook?.short_description?
-    end
-    if short_description and short_description.include? N
-      set_short_description(
-        short_description.to_s.delete(N).strip
-      )
-    end
-  end
-
-  # ========================================================================= #
-  # === sanitize_do_not_symlink
-  # ========================================================================= #
-  def sanitize_do_not_symlink
-    _ = raw_cookbook?.do_not_symlink?.to_s
-    if _ and _.empty?
-      _ = do_not_symlink?.to_s
-    end
-    set_do_not_symlink(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_keep_extracted
-  # ========================================================================= #
-  def sanitize_keep_extracted
-    _ = raw_cookbook?.keep_extracted?.to_s
-    if _ and _.empty?
-      _ = keep_extracted?.to_s
-    end
-    set_keep_extracted(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_libexec
-  # ========================================================================= #
-  def sanitize_libexec
-    _ = raw_cookbook?.libexec?
-    if _ and _.empty?
-      _ = libexec?
-    end
-    set_libexec(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_use_this_make_install_command
-  # ========================================================================= #
-  def sanitize_use_this_make_install_command
-    _ = raw_cookbook?.use_this_make_install_command?
-    set_use_this_make_install_command(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_program_name_and_program_version
-  # ========================================================================= #
-  def sanitize_program_name_and_program_version
-    _ = raw_cookbook?.program_name_and_program_version?
-    if _.nil?
-      _ = program_name_and_program_version?
-    end
-    _ = return_sanitized_program_name_and_program_version(_, url1?)
-    unless _.nil?
-      set_program_name_and_program_version(_)
-    end
-  end
-
-  # ========================================================================= #
-  # === sanitize_symlink_pkgconfig_files
-  # ========================================================================= #
-  def sanitize_symlink_pkgconfig_files
-    _ = raw_cookbook?.symlink_pkgconfig_files?
-    if _.nil?
-      _ = symlink_pkgconfig_files?
-    end
-    set_symlink_pkgconfig_files(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_installation_steps
-  #
-  # Installation steps are steps that we have to perform in order to
-  # get different programs to install on a given computer system.
-  #
-  # Special macros can be used as part of the installation steps.
-  #
-  # For instance:
-  #
-  #   MY_PROGRAMS/Procps/PROGRAM_VERSION
-  #
-  # Will be expanded to whatever value MY_PROGRAMS was set to; usually
-  # it is, or should be, pointing towards "/Programs/" or
-  # "/home/Programs/".
-  #
-  # Do note that this means that the value for MY_PROGRAMS must
-  # exist, otherwise this can not possibly work. Of course you
-  # can omit using macros and just hardcode values there anyway;
-  # the macros only exist to make it simpler to handle different
-  # programs.
-  #
-  # Another example for macro-conversion would be the String 'RINSTALL1',
-  # which will become expanded into the following three actions:
-  #
-  #   ruby install.rb config
-  #   ruby install.rb setup
-  #   ruby install.rb install
-  #
-  # The latter expansions are part of the file:
-  #
-  #   predefined_installation_instructions.yml
-  #
-  # So, if you want to add new macros, you can do so by modifying that
-  # very yaml file.
-  #
-  # Keep in mind that the installation steps are stored as Array at all times.
-  # ========================================================================= #
-  def sanitize_installation_steps
-    _ = installation_steps?
-    if _ and _.empty?
-      if raw_cookbook?.installation_steps? and
-        !raw_cookbook?.installation_steps?.empty?
-        _ = raw_cookbook?.installation_steps?
-      end
-    end
-    unless _.is_a? Array
-      _ = [_].flatten.compact # ← .compact to avoid retaining nil values.
-    end
-    if _.empty?
-      _ << 'make' # ← This is the hardcoded default value at all times.
-    end
-    # ======================================================================= #
-    # bl $RBT/yaml/predefined_installation_instructions.yml
-    # ======================================================================= #
-    dataset = load_yaml(
-      file_predefined_installation_instructions?
-    )
-    _.map! {|entry|
-      if dataset.has_key? entry
-        entry = dataset[entry]
-        if entry.is_a? String
-          # ================================================================= #
-          # The String may look like this:
-          #
-          #   copy_ruby; ruby setup.rb config; ruby setup.rb setup; ruby setup.rb install
-          #
-          # ================================================================= #
-          if entry.include? ';'
-            entry = entry.split(';').map(&:strip)
-          end
-        end
-      end
-    }
-    _.flatten!
-    _.compact!
-    _.reject!(&:empty?)
-    # ========================================================================= #
-    # Past this point here we have an Array.
-    # ========================================================================= #
-    unless _.empty?
-      _.map! {|line|
-        line = line.dup if line.frozen?
-        line.strip!
-        # =================================================================== #
-        # Next, replace all ',' with ';' characters.
-        # =================================================================== #
-        line.tr!(',',';') if line.include? ','
-        if Object.const_defined? :ConvertGlobalEnv
-          line = ConvertGlobalEnv[line] if line.include? '$'
-        end
-        # =================================================================== #
-        # === Replace the predefined installation instruction next
-        # =================================================================== #
-        if predefined_installation_instructions?.include? line
-          line = predefined_installation_instructions?[line]
-        end
-        if line.include? 'VERSION'
-          # ================================================================= #
-          # Need to set @program_version first, hence we update some stuff.
-          # ================================================================= #
-          set_program_name(program_name?) # This equals, for example, to "gnome-mahjonng-5.08"
-          if line.include? 'PROGRAM_VERSION' 
-            line.gsub!(/PROGRAM_VERSION/, program_version?) if program_version?
-          elsif line.include? 'VERSION'
-            line.gsub!(/VERSION/, program_version?) if program_version?
-          end
-        end
-        line = line.split(';') if line.include? ';' # This may turn it into an Array.
-        line
-      }
-    end
-    _.flatten!
-    _.map!(&:strip)
-    set_installation_steps(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_localstatedir
-  # ========================================================================= #
-  def sanitize_localstatedir
-    _ = raw_cookbook?.localstatedir?.to_s
-    if _ and _.empty?
-      _ = localstatedir?.to_s
-    end
-    set_localstatedir(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_do_not_download
-  # ========================================================================= #
-  def sanitize_do_not_download
-    _ = raw_cookbook?.do_not_download?
-    if _.nil?
-      _ = do_not_download?
-    end
-    set_do_not_download(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_parameters_to_make
-  #
-  # This method will sanitize the parameters that can be given to the
-  # program called "make" (on the commandline). "make" is typically
-  # invoked for a given program.
-  # ========================================================================= #
-  def sanitize_parameters_to_make
-    _ = parameters_to_make?
-    if _ and _.empty?
-       _ = raw_cookbook?.parameters_to_make?
-    end
-    _ = [_].flatten.compact.reject {|entry| entry.is_a?(String) and entry.empty? }
-    set_parameters_to_make(_)
-  end; alias sanitize_make_options       sanitize_parameters_to_make # === sanitize_make_options
-
-  # ========================================================================= #
-  # === sanitize_enable_shared
-  # ========================================================================= #
-  def sanitize_enable_shared
-    _ = raw_cookbook?.enable_shared?.to_s
-    if _ and _.empty?
-      _ = enable_shared?.to_s
-    end
-    set_enable_shared(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_is_an_active_project
-  # ========================================================================= #
-  def sanitize_is_an_active_project
-    _ = raw_cookbook?.is_an_active_project?
-    if _.nil?
-      _ = is_an_active_project?
-    end
-    set_is_an_active_project(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_m4_files
-  # ========================================================================= #
-  def sanitize_m4_files
-    _ = raw_cookbook?.m4_files?
-    if _ and _.empty?
-      _ = m4_files?
-    end
-    set_m4_files(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_use_build_directory
-  # ========================================================================= #
-  def sanitize_use_build_directory
-    _ = raw_cookbook?.use_build_directory?
-    if _.nil?
-      _ = use_build_directory?
-    end
-    set_use_build_directory(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_symlink_headers
-  # ========================================================================= #
-  def sanitize_symlink_headers
-    _ = raw_cookbook?.symlink_headers?
-    if _.nil?
-      _ = symlink_headers?
-    end
-    set_symlink_headers(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_build_static
-  # ========================================================================= #
-  def sanitize_build_static
-    _ = raw_cookbook?.build_static?
-    if _.nil?
-      _ = build_static?
-    end
-    set_build_static(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_run_configure
-  # ========================================================================= #
-  def sanitize_run_configure
-    _ = raw_cookbook?.run_configure?
-    if _.nil?
-      _ = run_configure?
-    end
-    if _ and _.is_a?(String) and _.empty?
-      _ = run_configure?.to_s
-    end
-    _ = to_bool(_)
-    _ = false if _.nil?
-    set_run_configure(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_apply_patch
-  #
-  # Here we sanitize the value for apply_patch. tiff.yml may be an example
-  # for how to use this setting.
-  # ========================================================================= #
-  def sanitize_apply_patch
-    _ = raw_cookbook?.apply_patch?
-    _ = apply_patch? unless _.is_a?(Array)
-    if _
-      if _.include? '#'
-        _ = _[0 .. (_.index('#') - 1)]
-        set_apply_patch _
-      end
-      if _.include? 'if PROGRAM_VERSION' # Ok, we specified a specific version.
-        version_to_compare = _.split(' ').last
-        if version_to_compare == program_version? # Ok, patch can be applied.
-        else # Else do not apply this patch.
-          _ = ''
-        end
-      end
-    end
-    set_apply_patch(_)
-  end; alias sanitize_apply_patch sanitize_apply_patch # === sanitize_apply_patch
-
-  # ========================================================================= #
-  # === sanitize_may_we_modify_the_configure_options
-  # ========================================================================= #
-  def sanitize_may_we_modify_the_configure_options
-    _ = raw_cookbook?.may_we_modify_the_configure_options?.to_s
-    if _ and _.empty?
-      _ = may_we_modify_the_configure_options?.to_s
-    end
-    set_may_we_modify_the_configure_options(to_bool(_))
-  end
-
-  # ========================================================================= #
-  # === sanitize_modify_the_makefile
-  # ========================================================================= #
-  def sanitize_modify_the_makefile
-    _ = raw_cookbook?.modify_the_makefile?
-    if _.nil? or ( _.is_a?(String) and _.empty? )
-      _ = false # This is the default value.
-    end
-    set_modify_the_makefile(to_bool(_))
-  end
-
-
-  # ========================================================================= #
-  # === sanitize_md5sum
-  # ========================================================================= #
-  def sanitize_md5sum
-    _ = raw_cookbook?.md5sum?
-    if _.nil?
-      _ = md5sum?
-      if _.nil?
-        _ = `md5sum #{program_path?}` if File.exist? program_path?
-      end
-    end
-    set_md5sum(_)
-  end; alias sanitize_md5sum_value sanitize_md5sum # === sanitize_md5sum_value
-
-  # ========================================================================= #
-  # === sanitize_url2
-  # ========================================================================= #
-  def sanitize_url2
-    dataset?[:url2] = raw_cookbook?.url2?
-  end
-
-  # ========================================================================= #
-  # === add_the_remaining_entries_to_the_dataset_variable
-  #
-  # This will add the remaining entries into the main dataset.
-  #
-  # These entries will default to an empty String. If you need another
-  # default for any of the missing entry then you should modify the
-  # corresponding value in the file 'constants.rb' and specify to which
-  # group it belongs.
-  # ========================================================================= #
-  def add_the_remaining_entries_to_the_dataset_variable
-    registered_cookbook_entries?.each {|key|
-      dataset?[key.to_sym] unless has_key? key.to_sym
-    }
-  end
-
-  # ========================================================================= #
-  # === add_the_false_entries_to_the_dataset_variable             (false tag)
-  #
-  # Here we will set all false values into our main dataset.
-  #
-  # We do this only if we do not yet have such a value in our dataset
-  # though.
-  # ========================================================================= #  
-  def add_the_false_entries_to_the_dataset_variable(i = ARRAY_FALSE_VALUES)
-    # ======================================================================= #
-    # Set the false values to false next.
-    # ======================================================================= #
-    i.each {|this_false_value|
-      if has_key? this_false_value
-        # =================================================================== #
-        # If that key already exists in the dataset then we have to ensure
-        # that it will be a boolean value.
-        # =================================================================== #
-        sanitize_boolean_value(this_false_value)
-      else
-        set(this_false_value, false)
-      end
-    }
-  end
-
-  # ========================================================================= #
-  # === add_the_true_entries_to_the_dataset_variable
-  # ========================================================================= #
-  def add_the_true_entries_to_the_dataset_variable(
-      i = ARRAY_TRUE_VALUES
-    )
-    # ======================================================================= #
-    # Set the false values to false next.
-    # ======================================================================= #
-    i.each {|this_false_value|
-      if has_key? this_false_value
-        # =================================================================== #
-        # If that key already exists in the dataset then we have to ensure
-        # that it will be a boolean value.
-        # =================================================================== #
-        sanitize_then_set_boolean_value(this_false_value)
-      else
-        set(this_false_value, true)
-      end
-    }
-  end
-
-  # ========================================================================= #
-  # === sanitize_then_set_boolean_value
-  #
-  # This method will turn 't' into true and 'f' into false.
-  # ========================================================================= #
-  def sanitize_then_set_boolean_value(i)
-    _ = obtain(i)
-    set(i, to_bool(_))
-  end; alias sanitize_boolean_value sanitize_then_set_boolean_value # === sanitize_boolean_value
-
-  # ========================================================================= #
-  # === sanitize_manual_steps
-  # ========================================================================= #
-  def sanitize_manual_steps
-    _ = raw_cookbook?.manual_steps?
-    set_manual_steps(_)
-  end
-
-  # ========================================================================= #
-  # === sanitize_url1
-  #
-  # We will chop off some parts of the URL.
-  # ========================================================================= #
-  def sanitize_url1(
-      i = raw_cookbook?.url1?
-    )
-    set_url1(
-      return_sanitize_url1(i)
-    )
-  end
-
-  # ========================================================================= #
-  # === sanitize_the_headers                                    (headers tag)
-  #
-  # The headers entry must be kept as an Array at all times, according
-  # to the specification.
-  # ========================================================================= #
-  def sanitize_the_headers
-    _ = headers?
-    if _ and _.is_a?(Array) and _.empty?
-      _ = raw_cookbook_dataset?['headers']
-    end
-    if _.is_a? Array
-      if _.first.include? ','
-        _ = _.first.split(',')
-      end if _.first
-    end
-    if _.is_a? String
-      _ = _.to_s.strip
-      _ = _.split(',') if _.include? ','
-      _ = nil if _.empty?
-    end
-    _ = [_].flatten.compact
-    # ======================================================================= #
-    # The individual entries may have a newline or an empty String at
-    # the beginning. The next line of code ensures that we will get
-    # rid of these.
-    # ======================================================================= #
-    _.map! {|entry| entry.delete(N).strip }
-    # ======================================================================= #
-    # Must keep it sorted, since as of July 2017. It is easier to 
-    # keep track of these entries on the commandline when they
-    # are sorted.
-    # ======================================================================= #
-    _.sort!
-    set_headers(_)
-  end; alias sanitize_headers sanitize_the_headers # === sanitize_headers
-
-  # ========================================================================= #
-  # === add_the_empty_entries_to_the_dataset_variable             (empty tag)
-  #
-  # We must ensure that the empty values are also properly set to ""
-  # on startup, in a mandatory fashion.
-  # ========================================================================= #
-  def add_the_empty_entries_to_the_dataset_variable(
-      i = ARRAY_EMPTY_VALUES
-    )
-    i.each {|entry|
-      # ===================================================================== #
-      # Store the keys as a Symbol.
-      # ===================================================================== #
-      dataset?[entry.to_sym] = ''
-    }
-  end
-
-  # ========================================================================= #
-  # === add_the_array_entries_to_the_dataset_variable             (array tag)
-  #
-  # This method will ensure that all specified Array entries are part
-  # of the internal yaml dataset when a new class is instantiated.
-  # ========================================================================= #
-  def add_the_array_entries_to_the_dataset_variable(
-      i = ARRAY_ARRAY_ENTRIES
-    )
-    i.each {|entry|
-      set(entry.to_sym, [])
-    }
-  end
-
-  # ========================================================================= #
-  # === add_the_nil_entries_to_the_dataset_variable                 (nil tag)
-  #
-  # This will set entries, such as "homepage", to nil initially.
-  # ========================================================================= #
-  def add_the_nil_entries_to_the_dataset_variable(
-      i = ARRAY_NIL_ENTRIES
-    )
-    i.each {|entry|
-      dataset?[entry.to_sym] = nil
-    }
-  end
-
-  # ========================================================================= #
-  # === sanitize_the_prefix                             (sanitize prefix tag)
-  #
-  # The value for the prefix of the program at hand will be sanitized
-  # here, in this method.
-  #
-  # The prefix must be a String at all times according to the specification.
-  #
-  # Since as of May 2013, we will never use a shortcut anymore, we
-  # will *always* store the full, absolute path to our entry.
-  #
-  # "false" as value, is an indication of using the path to an AppDir.
-  #
-  # For example, a value of false would be interpreted like 
-  # /Programs/Htop/2.0.0 - in other words, a proper appdir.
-  #
-  # The --prefix is always a directory, so as of Jan 2014 this method
-  # will append a / to this unless the last character is already a /.
-  # ========================================================================= #
-  def sanitize_the_prefix
-    # ======================================================================= #
-    # General way to overrule the prefix setting in this case.
-    # ======================================================================= #
-    if COMPILE_EVERYTHING_INTO_STANDALONE_DIRECTORY
-      old_prefix = 't'
-    else
-      # ===================================================================== #
-      # We need to use .to_s because the prefix can be a boolean value as
-      # well, such as true or false.
-      # ===================================================================== #
-      old_prefix = prefix?.to_s.dup
-    end
-    # ======================================================================= #
-    # As of January 2014, we will pass the String through the macro-check,
-    # which has to be done because our string may include PROGRAM_NAME
-    # as a prefix.
-    # ======================================================================= #
-    old_prefix = substitute_macros(old_prefix).dup
-    case old_prefix
-    # ======================================================================= #
-    # === traditional
-    # ======================================================================= #
-    when 't',
-         'true',
-         'yes',
-         'y',
-         'traditional'
-      set_internal_prefix('/usr/')
-    # ======================================================================= #
-    # === non-traditional
-    # ======================================================================= #
-    when 'f',
-         'false',
-         'no',
-         'AppDir',
-         'return_appdir_path',
-         'appdir_path'
-      # ===================================================================== #
-      # This must use an appdir prefix.
-      # ===================================================================== #
-      set_internal_prefix(return_appdir_prefix.dup) # ← This is the AppDir variant.
-    else
-      old_prefix = old_prefix.dup
-      # ===================================================================== #
-      # Append '/' unless we already have a trailing '/'.
-      # ===================================================================== #
-      old_prefix << '/' unless old_prefix.end_with? '/'
-      old_prefix.sub!(/ULOCAL/,'/usr/local') if old_prefix.include? 'ULOCAL' # ULOCAL gets expanded to /usr/local
-      old_prefix.sub!(/ULOC/,  '/usr/local') if old_prefix.include? 'ULOC'   # same counts for ULOC
-      # ======================================================================= #
-      # We used to delete '-' here in the past, but as of September 2017
-      # this is no longer the case. Some programs may have a '-' as part
-      # of the program version, and it may be better to include this
-      # rather than remove it.
-      # ======================================================================= #
-      # old_prefix.delete!('-') if _.include? '-'
-      set_internal_prefix(old_prefix)
-    end
-  end; alias sanitize_prefix sanitize_the_prefix # === sanitize_prefix
-
-  # ========================================================================= #
-  # === update_kde_applications
-  # ========================================================================= #
-  def update_kde_applications
-    unless RBT::Cookbooks.const_defined? :UpdateKdeApplications
-      require 'rbt/check_for_updates/update_kde_applications.rb'
-    end
-    UpdateKdeApplications.new
-  end
-
-  begin
-    require 'md5sum' # Used in this file here.
-  rescue LoadError; end
-  require 'rbt/toplevel_methods/md5sum.rb'
-  # ========================================================================= #
-  # === md5sum?
-  #
-  # Conditionally use md5sum.
-  #
-  # This method must accomodate three different possibilities:
-  #
-  #   (1) We have generated a .yml file in a special directory. We
-  #       will preferentially use that one, if it exists. This requires
-  #       of the user to have generated these values already. If the
-  #       user did so then we will use these values rather than
-  #       calculate them anew again. The advantage of this way is 
-  #       that it will significantly speed up the process.
-  #
-  #   (2) IF we do not have such a file as described in (1), then we will
-  #       first try to use the ruby Md5sum class, specifically its Md5sum[]
-  #       class method. Note that the ruby Md5sum class is fairly slow for
-  #       large programs, which is why option (1) is the default since as
-  #       of April 2016.
-  #
-  #   (3) The other two options (1) and (2) not being available, we will
-  #       try to use the unix coreutils "md5sum" instead, which is a 
-  #       binary, and should be pretty fast.
-  #
-  # Note that as of May 2016, we also make available a way to
-  # AVOID calculating the md5sum at all. Not everyone will need
-  # the md5sum information after all.
-  # ========================================================================= #
-  def md5sum?(
-      use_this_path = program_path?
-    )
-    # ======================================================================= #
-    # === Try to use yaml files first
-    #
-    # The expanded directory on my system will be here:
-    #
-    #   /Depot/Temp/CookbookDirectory/expanded_cookbooks/
-    #
-    # ======================================================================= #
-    if File.directory?(RBT.base_dir_to_store_expanded_cookbooks?) and
-       File.exist?(use_this_path.to_s) and
-       use_this_path.end_with?('.yml')
-       begin
-         dataset = YAML.load_file(use_this_path)
-         return dataset['md5sum'].to_s
-       rescue ArgumentError => error
-         opnn; e 'An error happened for the path `'+sfile(use_this_path)+
-                 '`. We will exit as a consequence.'
-         pp error
-         exit
-       end
-    # ======================================================================= #
-    # === Use the pure ruby way next
-    # ======================================================================= #
-    elsif Object.const_defined? :Md5sum
-      Md5sum[use_this_path].md5sum? # Calculate it anew via Md5sum[].
-    # ======================================================================= #
-    # === Try to use md5sum binary directly next
-    #
-    # This entry point depends on a binary that is part of the
-    # coreutils package.
-    # ======================================================================= #
-    elsif (result = `md5sum bogus 2>&1`) and
-          !result.include?('command not found')
-      if File.directory? use_this_path # A workaround for now.
-        return '0'
-      else
-        # =================================================================== #
-        # Delegate to the system tool here, part of coreutils.
-        # =================================================================== #
-        result = `md5sum #{use_this_path}`.split(' ').first
-        result.strip! if result
-        return result
-      end
-    else
-      '0' # Return 0 then. But that should not ever happen.
-    end
-  end; alias md5sum md5sum? # === md5sum
-
-  require 'rbt/utility_scripts/find_alternative_archive.rb'
-  # ========================================================================= #
-  # === try_to_find_another_local_file
-  # ========================================================================= #
-  def try_to_find_another_local_file(i)
-    without_file_extension = remove_file_extension_from(i)
-    array = RBT.return_alternative_archive(without_file_extension)
-    if array and !array.empty?
-      first_element = array.first
-      if File.exist? first_element
-        set_archive(first_element)
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === determine_program_name_and_program_version
-  #
-  # This method will automatically determine the program name and
-  # the program version, based on two other settings in the
-  # main cookbook-dataset. This means that this method will
-  # ONLY succeed if these two settings have been determined
-  # PRIOR to invoking this method here.
-  # ========================================================================= #
-  def determine_program_name_and_program_version
-    set_program_name_and_program_version(
-      :default
-    )
-  end
-
-  # ========================================================================= #
-  # === check_for_outdated_entries
-  #
-  # This method will check for outdated/obsolete entries and notify the user
-  # about this. Tha way we can get rid of such obsolete entries.
-  # ========================================================================= #
-  def check_for_outdated_entries(
-      _ = dataset?
-    )
-    use_this_key = 'github'
-    if !_.has_key?(use_this_key) and _.has_key?(use_this_key.to_sym)
-      use_this_key = use_this_key.to_sym
-    end
-    if _.has_key?(use_this_key) and
-      !_[use_this_key].nil? and
-      !_[use_this_key].empty?
-      opnn; e crimson('This file contains an obsolete entry called ')+
-              royalblue('github')
-      opnn; e crimson('This entry could be replaced with the '\
-              'entry called ')+
-              steelblue('git_url')+
-              crimson('.')
-      opnn; e crimson('It should be possible to get rid of this entry in ')+
-              crimson('the yaml file ')
-      e
-      e "  #{sfile(yaml_file?)}"
-      e
-    end
-  end
-
-  # ========================================================================= #
-  # === return_proper_type
-  #
-  # This will return the proper default time, such as [] or '' and so forth.
-  # ========================================================================= #
-  def return_proper_type_for(i = :required_deps_on)
-    file = ::RBT.file_specification_of_registered_cookbook_entries
-    if File.exist? file
-      _ = YAML.load_file(file)
-      if _.include? i.to_s
-        assumed_type = _[i.to_s]
-        case assumed_type
-        when 'Array'
-          return []
-        else
-          e tomato('Unhandled type: ')+
-            steelblue(assumed_type.to_s)
-        end
-      end
-    end
-    return nil
-  end
-
-  # ========================================================================= #
-  # === deduce_everything_from_the_program_name_and_program_version_downwards
-  #
-  # This method will deduce - and set - everything starting from the
-  # program_name_and_program_version entry downwards.
-  #
-  # It will NOT set other aggregate methods, such as set_program_path().
-  # The reason for this is that this method here shall work downwards
-  # what it can deduce on its own, without depending on other methods.
-  # ========================================================================= #
-  def deduce_everything_from_the_program_name_and_program_version_downwards(
-      i = program_name_and_program_version?
-    )
-    program_information = ProgramInformation.new(i)
-    set_short_name(program_information.short_name?)
-    set_program_name(program_information.program_name?)
-    set_program_version(program_information.program_version?)
-  end
-
-  # ========================================================================= #
-  # === sort_by_archive_priority
-  #
-  # This method will sort the archive format based on priorities.
-  # ========================================================================= #
-  def sort_by_archive_priority(i)
-    array_priority = %w(
-      .xz
-      .bz2
-      .gz
-      .lz
-      .gem
-      .js
-    )
-    begin
-      selection = i.select {|entry|
-        entry.include?('.') and is_an_archive?(entry)
-      }
-      i = selection.sort_by {|entry|
-        extname = File.extname(entry)
-        if array_priority.include? extname
-          entry = array_priority.index(extname)
-        end
-        entry
-      }
-    rescue ArgumentError => error
-      opnn; e 'An error occurred in the method '+
-              slateblue(__method__.to_s)+'. (Line: '+royalblue(__LINE__)+')'
-      pp i
-      pp error
-      exit
-    end
-    return i
-  end
-
-  # ========================================================================= #
-  # === the_program_is_included
-  #
-  # This method will set-toggle that the program we are looking for,
-  # is included; aka that it was found.
-  # ========================================================================= #
-  def the_program_is_included
-    @internal_hash[:found] = true
-  end; alias the_program_was_found the_program_is_included # === the_program_was_found
-
-  # ========================================================================= #
-  # === infer_the_short_name
-  #
-  # This will simply assume the default short name.
-  # ========================================================================= #
-  def infer_the_short_name
-    set_short_name(:default)
-  end
-
-  # ========================================================================= #
-  # === output_main_dataset
-  # ========================================================================= # 
-  def output_main_dataset
-    do_not_use_colours
-    pp yaml_dataset?
-  end
-
-  # ========================================================================= #
-  # === completely_infer_the_program_name_and_the_program_version_from_this_input
-  #
-  # This will honour macros in program_name_and_program_version.
-  # ========================================================================= #
-  def completely_infer_the_program_name_and_the_program_version_from_this_input(i)
-    set_program_name_and_program_version(
-      return_sanitized_program_name_and_program_version(
-        i
-      )
-    )
-    set_program_name(
-      ProgramInformation.return_name(program_name_and_program_version?).dup
-    )
-    set_program_version(
-      ProgramInformation.return_version(program_name_and_program_version?).dup
-    )
-  end
-
-  # ========================================================================= #
-  # === enable_debug
-  # ========================================================================= #
-  def enable_debug
-    @internal_hash[:debug] = true
-  end
-
-  # ========================================================================= #
-  # === use_this_connective_token?
-  # ========================================================================= #
-  def use_this_connective_token?
-    @internal_hash[:use_this_connective_token]
-  end; alias connective_token? use_this_connective_token? # === connective_token?
-       alias token?            use_this_connective_token? # === token?
-
-
-  # ========================================================================= #
-  # === menu                                                       (menu tag)
-  # ========================================================================= #
-  def menu(
-      i = commandline_arguments_with_leading_hyphens
-    )
-    if i.is_a? Array
-      i.each {|entry| menu(entry) }
-    else
-      case i
-      # ===================================================================== #
-      # === --simple
-      # ===================================================================== #
-      when /^-?-?simple$/i
-        set_simple_or_complex(:simple)
-      end
-    end
-  end
-
-  # ========================================================================= #
-  # === do_use_this_program_version
-  #
-  # Use this method specifically to set (and use) another program version.
-  #
-  # The difference towards set_program_version is that we will also
-  # re-assemble the default program path.
-  # ========================================================================= #
-  def do_use_this_program_version(i = '1.52.1')
-    set_program_version(i)
-    reassemble_program_path
-  end; alias use_this_program_version do_use_this_program_version # === use_this_program_version
-       alias do_use_this_version=     do_use_this_program_version # === do_use_this_version=
-
-  # ========================================================================= #
-  # === guess_short_name
-  #
-  # This method can be used to guess the short name of a program.
-  # ========================================================================= #
-  def guess_short_name(
-      i = program_name?
-    )
-    _ = ::ProgramInformation.return_short_name(i)
-    set_short_name(_)
-  end
-
-  # ========================================================================= #
-  # === try_to_guess_the_program_version
-  # ========================================================================= #
-  def try_to_guess_the_program_version(
-      i = program_name?
-    )
-    _program_name, program_version = ProgramInformation.new(i).return_name_and_version
-    set_program_version(program_version)
-  end
-
-  # ========================================================================= #
-  # === append_this_to_the_configure_options
-  #
-  # This method can be used to append something to the (stored)
-  # configure options in use.
-  # ========================================================================= #
-  def append_this_to_the_configure_options(i = '')
-    _ = configure_options?.to_s
-    _ << " #{i}"
-    set_configure_options(_)
-  end
-
-  # ========================================================================= #
-  # === determine_the_full_program_path
-  #
-  # This refers to program_path, which may look like
-  # '/home/x/src/gnomemahjongg/gnome-mahjonng-5.08.tar.xz'.
-  #
-  # In other words, it combines base_dir?+program_full_name?.
-  #
-  # In June 2020 this was changed, to more adjust towards the needs
-  # of class RBT::Compile.
-  # ========================================================================= #
-  def determine_the_full_program_path
-    set_program_path(:try_to_rebuild_it_from_smaller_components)
-  end; alias determine_the_program_path determine_the_full_program_path # === determine_the_program_path
-       alias rebuild_program_path       determine_the_full_program_path # === rebuild_program_path
-
-  # ========================================================================= #
-  # === determine_everything                                  (determine tag)
-  #
-  # This method will essentially determine all the other dependent
-  # variables, and set them onto the main (internal) dataset - the
-  # cookbook dataset.
-  # ========================================================================= #
-  def determine_everything
-    determine_the_program_name_and_the_program_version_from_url1_while_respecting_existing_values
-    determine_the_base_dir
-    determine_the_archive_type
-    determine_the_full_program_name
-    determine_the_full_program_path
-    determine_the_file_size # ← can happen only after the program path was determined.
-  end
-
-  # ========================================================================= #
-  # === determine_the_file_size
-  # ========================================================================= #
-  def determine_the_file_size
-    result = 0
-    _ = program_path?
-    if File.exist? _
-      result = File.size(_)
-    end
-    set_archive_size(result)
-  end
-
-  # ========================================================================= #
-  # === determine_the_full_program_name
-  #
-  # program_full_name is like 'gnome-mahjonng-5.08.tar.xz', so
-  # this is program_name_and_program_version?+archive_type?
-  # ========================================================================= #
-  def determine_the_full_program_name
-    set_program_full_name(:default)
-  end
-
-  # ========================================================================= #
-  # === determine_the_base_dir
-  #
-  # This is like '/home/x/src/gnomemahjongg/', so combining
-  # src_dir?+short_name?. We will use :default, though, as
-  # argument to set_base_dir() since that already does the
-  # above for us.
-  # ========================================================================= #
-  def determine_the_base_dir
-    if short_name?.nil?
-      if program_name?
-        set_short_name(program_name?)
-      end
-    end
-    set_base_dir(:default)
-  end
-
-  # ========================================================================= #
-  # === update_yaml_dataset
-  # ========================================================================= #
-  def update_yaml_dataset(i)
-    dataset?.update(i)
-  end
-
-  # ========================================================================= #
-  # === is_another_archive_used_locally?
-  #
-  # This method depends on program_path? having been properly set BEFORE 
-  # the method is invoked.
-  #
-  # The method will return true or false.
-  # ========================================================================= #
-  def is_another_archive_used_locally?(
-      i = archive_type?
-    )
-    result = false
-    program_path = program_path?
-    if program_path
-      unless File.exist?(program_path)
-        target = base_dir?+program_name_and_program_version?+'*'
-        entries = Dir[target]
-        if entries.nil? or 
-           entries.first.nil? or
-           entries.first.include?(archive_type?)
-          e 'An error happened. The target was:'
-          e
-          e tomato(target)
-          e
-          e 'The program at hand was assumed to be '+steelblue(i)+' and'
-          e 'the program_path was assumed to be: '+lightgreen(program_path.to_s)
-          if is_on_roebe? and !target.end_with?('-*')
-            # =============================================================== #
-            # This here looks like so: '/home/x/src/-*'
-            # palemoon may show this error.
-            # =============================================================== #
-            exit
-          end
-        else
-          result = true
-        end
-      end
-    end
-    return result
-  end
-
-  # ========================================================================= #
-  # === do_change_to_appdir_layout
-  #
-  # You can use this method to change to the AppDir layout.
-  # ========================================================================= #
-  def do_change_to_appdir_layout
-    sanitize_prefix(:return_appdir_path)
-  end
-
-  # ========================================================================= #
-  # === substitute_macros
-  #
-  # Do "macro" expansion through this method.
-  #
-  # This method will sanitize some special variables, which are assumes
-  # to be "macros" - that is, to be substituted with another value.
-  #
-  # Right now this is only used for kernel variable, PROGRAM_NAME,
-  # PNAME, NAME, KERNEL_V and PROGRAM_VERSION but maybe someone else
-  # wants to do more macro processing, so we will keep this bundled
-  # here together.
-  # ========================================================================= #
-  def substitute_macros(input)
-    if input.is_a? Array
-      input.map {|entry| substitute_macros(entry) } # Recursive call.
-    else
-      i = input.to_s.dup # Work on a new copy here.
-      if i.include? 'PROGRAM_VERSION'
-        i.gsub!(/PROGRAM_VERSION/, program_version?)
-      end
-      if i.include? 'PNAME'
-        i.gsub!(/PNAME/,           short_name?)
-      elsif i.include? 'NAME'
-        i.gsub!(/NAME/,            short_name?)
-      elsif i.include? 'PROGRAM_NAME'
-        i.gsub!(/PROGRAM_NAME/,    short_name?)
-      end
-      if ENV['KERNEL_V'] && i.include?('KERNEL_V')
-        i.gsub!(/#{i}/, ENV['KERNEL_V'])
-      end
-      i
-    end
-  end
-
-  # ========================================================================= #
-  # === try_to_guess_the_program_path_based_on_the_program_name_and_program_version
-  #
-  # This will build program_path, which is:
-  #
-  # '/home/x/src/gnomemahjongg/gnome-mahjonng-5.08.tar.xz'
-  #
-  # aka base_dir?+program_full_name?
-  # ========================================================================= #
-  def try_to_guess_the_program_path_based_on_the_program_name_and_program_version(
-      _ = base_dir?+
-          program_full_name?
-    )
-    if File.exist? _
-      set_program_path(_)
-    end
-  end
-
-  # ========================================================================= #
-  # === determine_the_program_name_and_the_program_version
-  #
-  # This method will determine:
-  #
-  #   (1) the "program_name"
-  #   (2) the "program_version"
-  #
-  # setting.
-  #
-  # We will not use .downcase because some program names may include
-  # upcased characters, such as "libX11".
-  # ========================================================================= #
-  def determine_the_program_name_and_the_program_version(
-      i = dataset?[:url1]
-    )
-    if ihash?.has_key?(:program_name)
-      # ===================================================================== #
-      # If we already have set a program_name value, and this one includes
-      # a '-' character, then we assume here that the original cookbook
-      # file already contains a "foobar-1.0" entry, which we will simply
-      # use next.
-      # ===================================================================== #
-      if ihash?[:program_name].include? '-'
-        i = ihash?[:program_name]
-      end
-    end
-    # ======================================================================= #
-    # First, if the input contains a '/' then we split towards the last
-    # part.
-    # ======================================================================= #
-    if i.include? '/'
-      i = File.basename(i)
-    end
-    i = remove_archive_at_the_end(i) # Get rid of e. g. '.tar.xz'
-    if i.include? '-'
-      program_name    = ProgramInformation.return_name(i)
-      program_version = ProgramInformation.return_version(i)
-    else
-      program_name    = i.dup
-      program_version = DEFAULT_PROGRAM_VERSION
-    end
-    set_program_name(program_name)
-    set_program_version(program_version)
-    set_program_name_and_program_version(:default)
-    set_short_name(program_name)
-  end
-
-  # ========================================================================= #
-  # === decompose_program_name
-  #
-  # This method will set short_name and program_version, by making use of
-  # the content stored in program_name? by default.
-  # ========================================================================= #
-  def decompose_program_name(
-      i = program_name?
-    )
-    _ = ::ProgramInformation.return_short_name_and_program_version(i)
-    set_short_name(_.short_name?, :propagate_towards_real_short_name)
-    set_program_version(_.program_version?)
-  end
-
-  # ========================================================================= #
-  # === ensure_that_this_hash_has_only_valid_keys
-  #
-  # The input to this method must be a Hash.
-  #
-  # This method will ensure that the given Hash has only valid keys.
-  #
-  # In the past, we could use it to convert it into Symbols but
-  # this is no longer in use. We now make no further modifications
-  # to the original dataset.
-  #
-  # If all keys are valid then we won't have to notify the user about
-  # it at all.
-  # ========================================================================= #
-  def ensure_that_this_hash_has_only_valid_keys(
-      i = raw_cookbook.hash?
-    )
-    registered_cookbook_entries = registered_cookbook_entries?
-    # ======================================================================= #
-    # Check whether all is fine with the raw-dataset.
-    # ======================================================================= #
-    if i.nil?
-      cliner
-      opnn; e sfancy('nil')+' was passed into the method '+
-              orange('ensure_that_this_hash_has_only_valid_keys()')
-      opnn; e steelblue('This can not be right. Program name was: ')+
-              sfancy(program_name?.to_s)+'.'
-      pp caller()
-      pp self
-      cliner
-    else
-      i.each_pair {|key, value|
-        key = key.to_s # We will only deal with Strings past this point.
-        case key
-        # =================================================================== #
-        # === Add some ad-hoc exceptions next
-        # =================================================================== #
-        when 'program_full_name','md5sum', # Ad-hoc exceptions.
-             'program_name',
-             'program_path',
-             'program_version',
-             'set_env_variables'
-          next
-        end
-        unless registered_cookbook_entries.include?(key)
-          seek_this_yaml_file = "#{seek_this_program?}"
-          seek_this_yaml_file << '.yml' unless seek_this_yaml_file.end_with? '.yml'
-          opnn; e "#{swarn('Warning')} - the cookbook-file for `"\
-                  "#{sfancy(seek_this_yaml_file)}`"
-          opnn; e "(path: #{sfile(raw_cookbook?.file?)})"
-          opnn; e "contains a key that was #{swarn('NOT')} registered. "\
-                  "The name of that"
-          opnn; e "(invalid / ignored) key is: `#{sfancy(key.to_s)}`."
-          opnn; e "This is defined in the file "\
-                  "#{Colours.sfile('registered_cookbook_entries.yml')}"
-          # ================================================================= #
-          # Next, also try to find a name that is similar.
-          # ================================================================= #
-          if registered_cookbook_entries.any? {|entry|
-              entry.include? key.to_s
-            }
-            select_this_entry = registered_cookbook_entries.select {|entry|
-              entry.include? key.to_s
-            }.first
-            opnn; e "Did you mean this entry instead? "\
-                    "#{sfancy(select_this_entry)}"  
-          end
-          opne 'This is currently discouraged.'
-          # exit
-        end
-      }
-    end
-  end
-
-  # ========================================================================= #
-  # === chop_off_revision_number
-  #
-  # This method will check if a program version ends with a String such
-  # as "-r8". If so then this part will be chopped off.
-  #
-  # Usually this trailing part denotes an internal revision rather than
-  # an external program version.
-  # ========================================================================= #
-  def chop_off_revision_number
-    _ = program_version?
-    use_this_regex = /(-r\d{1,2})$/
-    if _ =~ use_this_regex
-      _.sub!(use_this_regex,'')
-      set_program_version(_)
-    end
-  end
-
-  # ========================================================================= #
-  # === try_to_guess_the_archive_type
-  #
-  # This method will try to guess the archive type, e. g. .tar.xz or
-  # .tar.gz of a given program at hand, based on which files may
-  # exist locally already.
-  #
-  # Note that program_name may look like 'gnome-mahjongg' and
-  # base_dir may look like '/home/x/src/gnomemahjongg/'.
-  # ========================================================================= #
-  def try_to_guess_the_archive_type
-    target = "#{base_dir?}#{program_name?}*"
-    files = Dir[target]
-    unless files.empty?
-      first = files.first
-      # And use the first variant here.
-      set_archive(return_archive_type(first))
-    end # else we won't set it
-  end
-
-  # ========================================================================= #
-  # === assemble_program_full_name
-  #
-  # This method will build-up a valid "program_full_name" setting.
-  #
-  # In order to achieve this, it will make use of the method called
-  # return_default_program_full_name, which itself is a combination
-  # of program_name?+archive_type?.
-  # ========================================================================= #
-  def assemble_program_full_name(
-      i = return_default_program_full_name
-    )
-    set_program_full_name(i)
-  end; alias reassemble_program_full_name assemble_program_full_name # === reassemble_program_full_name
-       alias determine_program_full_name  assemble_program_full_name # === determine_program_full_name
-
-  # ========================================================================= #
-  # === has_key?
-  #
-  # This query method will delegate towards the yaml dataset, whether
-  # it has a given key or whether it does not.
-  #
-  # The key should ideally be a Symbol - keep this in mind.
-  #
-  # Since as of April 2021 there will be no modifications made; the input
-  # argument will be the key. Prior to that we converted it to a String
-  # via .to_s.
-  # ========================================================================= #
-  def has_key?(i = :blfs)
-    dataset?.has_key?(i)
-  end
-
-  # ========================================================================= #
-  # === is_a_game?
-  #
-  # This method will simply return true if the program in question is
-  # a game, and false if it is not a game. That way we can quickly
-  # find out whether the input is a game or whether it is not.
-  #
-  # Usage example:
-  #
-  #   ProgramInformation.return_name @program_name
-  #   ProgramInformation.return_name 'supertux-0.1.1'
-  #
-  # ========================================================================= #
-  def is_a_game?
-    return true if tags?.to_s.include? 'game'
-    return false # Else return false here.
-  end
-
-  # ========================================================================= #
-  # === show_help                                                  (help tag)
-  #
-  # To invoke this particular method, try:
-  #
-  #   cookbook --help
-  #
-  # To invoke individual entries, do:
-  #
-  #   cookbook nprograms?
-  #   cookbook --overview
-  #   cookbook --version
-  #
-  # ========================================================================= #
-  def show_help
-    left_padding = '  ' # A bit of left-padding here.
-    n_space_characters = 50
-    how_to_invoke_the_program = HOW_TO_INVOKE_THE_PROGRAM
-    opnn; e 'This class can feedback information about any '\
-            'specific program.'
-    e
-    # ======================================================================= #
-    # === Common usage examples
-    # ======================================================================= #
-    e 'Common usage examples:'
-    e
-    e left_padding+how_to_invoke_the_program+' ruby'
-    e left_padding+how_to_invoke_the_program+' htop'
-    e left_padding+how_to_invoke_the_program+' m4'
-    e
-    # ======================================================================= #
-    # === Advanced Options
-    # ======================================================================= #
-    e 'Advanced options:'
-    e
-    e properly_pad_and_colourize_this_help_option('nprograms?',
-        'show how many programs are registered in the cookbooks-collection'
-      )
-    e properly_pad_and_colourize_this_help_option('--aliases?',
-        'show all available aliases to the registered cookbooks-programs'
-      )
-    e properly_pad_and_colourize_this_help_option('--available_programs?',
-        'show all available programs'
-      )
-    e properly_pad_and_colourize_this_help_option('--batch-download-all-source-archives',
-        'batch-download all source archives (optionally select for specific tags)'
-      )
-    e properly_pad_and_colourize_this_help_option('--overview',
-        'give us an overview over all programs in the utility_scripts directory,'
-      )
-    e (' ' * n_space_characters)+'# of the cookbooks project'
-    e properly_pad_and_colourize_this_help_option('--format=[name]',
-        'feedback the format type of this entry,'
-      )
-    e (' ' * n_space_characters)+'# such as via '+simp('cookbook --format=postinstall')
-    e properly_pad_and_colourize_this_help_option('--expand',
-        'to expand the short yaml dataset into'
-      )
-    e properly_pad_and_colourize_this_help_option('--expand=PROGRAM_NAME',
-        'to expand an individual program, such as python or ruby'
-      )
-    # ======================================================================= #
-    # === --n-registered-binaries?
-    # ======================================================================= #
-    e properly_pad_and_colourize_this_help_option('--n-registered-binaries?',
-        'to report how many registered binaries are available'
-      )
-    # ======================================================================= #
-    # === --show-all-about=PROGRAM_NAME
-    # ======================================================================= #
-    e properly_pad_and_colourize_this_help_option('--show-all-about=PROGRAM_NAME',
-        'to show all about the given program at hand'
-      )
-    e properly_pad_and_colourize_this_help_option('--permanently-disable-colours',
-        'to permanently disable all colour output by the Cookbooks project'
-      )
-    e properly_pad_and_colourize_this_help_option('--update-kde-plasma',
-        'batch-update (that is, download) all KDE5 components of KDE Plasma'
-      )
-    e (' ' * n_space_characters)+'# a long dataset; --initialize is an alias to this action'
-    e properly_pad_and_colourize_this_help_option('--create-programs-version-html-file',
-        'create and upload a .html file containing all '\
-        'program_name-program_versions'
-      )
-    e (' ' * n_space_characters)+'# entries. This is primarily meant for my home system.'
-    # ======================================================================= #
-    # === --allowed_tags?
-    # ======================================================================= #
-    e properly_pad_and_colourize_this_help_option('--allowed_tags?',
-       'show a list of all allowed tags in the '+simp('tags: subsection')+
-       ' of a cookbook-yaml file'
-      )
-    # ======================================================================= #
-    # === --generate_version_file
-    # ======================================================================= #
-    e properly_pad_and_colourize_this_help_option('--generate_version_file',
-        'to generate a programs-version yaml file'
-      )
-    # ======================================================================= #
-    # === --use-psych
-    # ======================================================================= #
-    e properly_pad_and_colourize_this_help_option('--use-psych',
-        'to use psych for the yaml files'
-      )
-    # ======================================================================= #
-    # === --use-syck
-    # ======================================================================= #
-    e properly_pad_and_colourize_this_help_option('--use-syck',
-        'to use syck for the yaml files'
-      )
-    # ======================================================================= #
-    # === --create-html-page-for-these-programs=
-    # ======================================================================= #
-    e properly_pad_and_colourize_this_help_option('--create-html-page-for-these-programs=',
-        'to generate a .html page for the given programs; separate '\
-        'the input via'
-      )
-    e (' ' * n_space_characters)+'# "'+sfancy(',')+'" such as in '+
-      simp('=ruby,python,php')
-    # ======================================================================= #
-    # === --n_binaries?
-    # ======================================================================= #
-    e properly_pad_and_colourize_this_help_option('--n_binaries?',
-        'tell us how many binaries/executables are tracked '\
-        'in all cookbook-yaml files'
-      )
-    e properly_pad_and_colourize_this_help_option('--publish',
-        'publish the list of all program versions of the cookbooks project'
-      )
-    e properly_pad_and_colourize_this_help_option('--total-size?',
-        'show the total size of all locally available archives'
-      )
-    e properly_pad_and_colourize_this_help_option('--tutorial',
-        'do show the short tutorial how the Cookbooks project may be used'
-      )
-    e properly_pad_and_colourize_this_help_option('--update-tags',
-        'do update the tags defined in the various cookbooks'
-      )
-    e properly_pad_and_colourize_this_help_option('--validate-entries',
-        'validate all Cookbook entries'
-      )
-    e properly_pad_and_colourize_this_help_option('--version',
-        'feedback the current version of the Cookbooks gem'
-      )
-    e properly_pad_and_colourize_this_help_option('--set_source_dir=/tmp',
-        'permanently set a new source dir (aka where all '\
-        'archives are kept locally)'
-      )
-    e properly_pad_and_colourize_this_help_option('--set_temp_dir=/tmp',
-        'permanently change the yaml file to set a '\
-        'new temp directory'
-      )
-    e
-  end
-
-  require 'rbt/toplevel_methods/e.rb'
-  # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.e
-  # ========================================================================= #
-  def self.e(i = '')
-    RBT.e(i)
-  end
-
-  # ========================================================================= #
-  # === show_tags
-  # ========================================================================= #
-  def show_tags
-    e return_tags
-  end
-  
-  # ========================================================================= #
-  # === sanitize_tags
-  #
-  # Keep in mind that the tags must always be in Array format.
-  #
-  # We will update the tags entry through this method here.
-  # ========================================================================= #  
-  def sanitize_tags
-    _ = tags?
-    if _ and _.empty? and
-       raw_cookbook?.tags? and
-      !raw_cookbook?.tags?.empty?
-      _ = raw_cookbook?.tags?
-    end
-    if _.nil?
-      set_tags [] # In this case it will be an empty Array.
-      return
-    end
-    # ======================================================================= #
-    # Clean up the Array next.
-    # ======================================================================= #
-    if _.is_a? Array
-      _.map! {|line|
-        if line
-          begin
-            line.tr!(' ','_')
-            line.strip!
-          rescue Exception => error
-            opne 'Something went wrong with the variable (called '+steelblue(line)+').'
-            opne 'The whole dataset was:'
-            e
-            pp _
-            e
-            e 'The program was:'
-            e
-            e steelblue("  #{program_name?}")
-            e
-            e 'The error was (of class '+error.class.to_s+'):'
-            pp error
-          end
-        end
-        line
-      }
-    end
-    dataset_containing_the_specification_of_registered_cookbook_entries =
-      file_specification_of_registered_cookbook_entries
-    format = dataset_containing_the_specification_of_registered_cookbook_entries['tags']
-    unless _.class.to_s == format
-      case format
-      when 'Array'
-        if _.is_a? String
-          if _.include? ','
-            _ = _.split(',').map(&:strip)
-          end
-        end 
-        _ = [_].compact.flatten # Convert the String into an Array here and remove nil values.
-      end
-    end
-    if _.is_a? Array
-      # ===================================================================== #
-      # Before we do anything else, we will apply a .map-strip and a 
-      # exchange of all ' ' with '_' operation:
-      # ===================================================================== #
-      _.map! {|line|
-        if line
-          line.tr!(' ','_')
-          line.strip!
-        end
-        line
-      }
-      first = _.first
-      if first
-        if first.include? ' ' # We have a situation such as this one here: ["video gnome"]
-          first = first.split(' ')
-          _ = first
-        elsif first.is_a?(String) and first.include?(',') # Some entries may have something like:  ruby,gnome  in the yaml file, we check for these here.
-          first = first.split(',')
-          _ = first
-        end
-      end
-    end
-    # ======================================================================= #
-    # Since as of Feb 2017, we will also ensure that the tags that are
-    # in use, conform to our specification at hand. If not then we will
-    # notify the user, and exit.
-    # ======================================================================= #
-    allowed_tags = load_yaml(RBT.file_allowed_tags)
-    allowed_tags.map! {|line|
-      line.tr(' ','_').strip
-    }
-    _.each {|this_tag| # Iterate through to find improper tags.
-      if this_tag.to_s.empty? or # Empty tags are skipped as well.
-         allowed_tags.include?(this_tag)
-      else
-        this_program = short_name?
-        e
-        e "#{rev}The specified tag called `#{simp(this_tag)}` for the program "\
-          "#{sfancy(this_program.downcase)}"\
-          " has not"
-        e 'been registered in the file:'
-        e
-        e "  `#{sfile(RBT.file_allowed_tags)}`."
-        e
-        e 'This is currently '+violet('disallowed')+'.'
-        e
-        e 'The faulty entry must be corrected. So either the cookbook file '
-        e 'in question should be modified, or the tag should be added'
-        e "to the registry of allowed tags in the specification "\
-          "file. (#{sfile('allowed_tags.yml')})"
-        e
-        if is_on_roebe?
-          open_in_editor(
-            this_program.downcase.delete('-')
-          )
-        end
-        # =================================================================== #
-        # No longer exit as of November 2013.
-        # And in April 2021 we will exit again.
-        # =================================================================== #
-        exit # And exit here.
-      end
-    }
-    set_tags(_) # Finally set the Array that has our tags.
-  end
-
-  # ========================================================================= #
-  # === query_for
-  #
-  # This method is a more general query-method for certain data stored
-  # in the Cookbook class.
-  #
-  # For example: the input String 'Compiling this program:' will yield
-  # the name of the program that the cookbook class currently holds.
-  #
-  # The primary use case is for the Flexbox class.
-  # ========================================================================= #
-  def query_for(i)
-    _ = i.to_s.dup
-    _.chop! if _.end_with? ':'
-    case _
-    # ======================================================================= #
-    # === "Homepage"
-    # ======================================================================= #
-    when /^Homepage$/i
-      homepage_url?
-    # ======================================================================= #
-    # === program_name_and_program_version?
-    # ======================================================================= #
-    when /^program(-|_| )?name(-|_| )?and(-|_| )?program(-|_| )?version\??$/i
-      program_name_and_program_version?
-    # ======================================================================= #
-    # === extract_to?
-    # ======================================================================= #
-    when /^extract(-|_| )?to\??$/i
-      extract_to?
-    # ======================================================================= #
-    # === "Build system to be used:"
-    # ======================================================================= #
-    when /^Build(-|_| )?system(-|_| )?to(-|_| )?be(-|_| )?used$/i
-      use_this_build_system?
-    # ======================================================================= #
-    # === "configure options"
-    # ======================================================================= #
-    when /^configure(-|_| )?options\??$/i
-      configure_options?
-    # ======================================================================= #
-    # === "URL to the source archive"
-    # ======================================================================= #
-    when /^URL(-|_| )?to(-|_| )?the(-|_| )?source(-|_| )?archive$/i
-      url_to_the_source_archive?
-    # ======================================================================= #
-    # === "Keep the archive extracted"
-    # ======================================================================= #
-    when /^Keep(-|_| )?the(-|_| )?archive(-|_| )?extracted$/i
-      keep_the_archive_extracted?
-    # ======================================================================= #
-    # === "Program path"
-    # ======================================================================= #
-    when /^Program(-|_| )?path$/i
-      program_path?
-    # ======================================================================= #
-    # === "Program version"
-    # ======================================================================= #
-    when /^Program(-|_| )?version$/i
-      program_version?
-    # ======================================================================= #
-    # === "Compiling this program"
-    # ======================================================================= #
-    when /^Compiling(-|_| )?this(-|_| )?program$/i,
-         /^Installing(-|_| )?this(-|_| )?program$/i,
-         /^Extracting(-|_| )?this(-|_| )?program$/i
-      short_name?
-    # ======================================================================= #
-    # === "Prefix"
-    # ======================================================================= #
-    when /^Prefix$/i
-      prefix?
-    else
-      e crimson("Unhandled input to #{__method__}: #{_}")
-    end
-  end
-
-  # ========================================================================= #
-  # === show_n_programs_available
-  # ========================================================================= #
-  def show_n_programs_available
-    e return_n_programs_available
-  end
-
-  # ========================================================================= #
-  # === do_show_full_description
-  #
-  # This method will allow us to show the full description of a given
-  # program.
-  # ========================================================================= #
-  def do_show_full_description
-    # ======================================================================= #
-    # The following method-call will toggle the proper behaviour.
-    # ======================================================================= #
-    RBT::Cookbooks::SanitizeCookbook.do_not_honour_threshold_value
-  end
-
-  # ========================================================================= #
-  # === opnn
-  # ========================================================================= #
-  def opnn
-    super(
-      namespace:   namespace?,
-      use_colours: RBT.use_colours?
-    )
-  end
-
-  # ========================================================================= #
-  # === send_this_method_and_sanitize_arrays
-  #
-  # The second argument can be used to "limit the result", e. g. to
-  # show only n elements (from an Array, typically).
-  #
-  # It is used in particular to not display too many elements, as these
-  # may overflow on the screen (commandline output) - but the user
-  # can override this behaviour, via --do-not-truncate.
-  # ========================================================================= #
-  def send_this_method_and_sanitize_arrays(
-      i, limit_the_result = false
-    )
-    result = send(i)
-    # ======================================================================= #
-    # The following clause will be entered if there are too many entries
-    # for the given field - in particular header-files, binaries and
-    # libraries.
-    # ======================================================================= #
-    if @internal_hash[:try_to_truncate_too_long_output] and
-       limit_the_result and
-       (result.size > limit_the_result) # Check for more elements here.
-      # ===================================================================== #
-      # === Handle "headers?" next
-      # ===================================================================== #
-      if i.to_s.include?('headers?')
-        if limit_the_result
-          append_this = ' ... → TRUNCATED '+
-                        (result.size - limit_the_result).to_s+
-                        ' more .h header files'
-          result = result[0 .. (limit_the_result - 1)]
-          result << append_this
-        end
-      # ===================================================================== #
-      # === Handle "libraries?" next
-      # ===================================================================== #
-      elsif i.to_s.include?('libraries?')
-        if limit_the_result
-          append_this = ' ... → TRUNCATED '+
-                        (result.size - limit_the_result).to_s+
-                        ' more library files'
-          result = result[0 .. (limit_the_result - 1)]
-          result << append_this
-        end
-      # ===================================================================== #
-      # === Handle "binaries?" next
-      # ===================================================================== #
-      elsif i.to_s.include?('binaries?')
-        if limit_the_result
-          append_this = ' ... → TRUNCATED '+
-                        (result.size - limit_the_result).to_s+
-                        ' more binaries/executables'
-          result = result[0 .. (limit_the_result - 1)]
-          result << append_this
-        end
-      end
-    end
-    if result.is_a? Array
-      result = '['+result.join(',')+']' unless result.compact.empty?
-    end
-    return result
-  end
-
-  # ========================================================================= #
-  # === do_not_make_use_of_aliases_kept_in_the_file_cookbook_aliases
-  # ========================================================================= #
-  def do_not_make_use_of_aliases_kept_in_the_file_cookbook_aliases
-    @internal_hash[:make_use_of_aliases_kept_in_the_file_cookbook_aliases] = false
-  end
-
-  # ========================================================================= #
-  # === calculate_archive_size
-  #
-  # This method can be used to determine the size of the target archive
-  # in question. The corresponding entry will be set in the main Hash,
-  # called 'archive_size'.
-  #
-  # In order for this to work, we need the content of program_path defined
-  # before, however. Whenever we set program_path, we can re-calculate
-  # the filesize anew.
-  # ========================================================================= #
-  def calculate_archive_size(
-      i = program_path?
-    )
-    set_archive_size(0) # First set it to 0 always, as default.
-    if found_result? and File.exist?(i.to_s)
-      size = File.size?(i.to_s)
-      set_archive_size(size)
-    end
-  end
-
-  # ========================================================================= #
-  # === properly_pad_and_colourize_this_help_option
-  # ========================================================================= #
-  def properly_pad_and_colourize_this_help_option(
-      key_to_invoke_the_method,
-      text_that_is_to_be_displayed
-    )
-    left_padding = '  ' # A bit of left-padding here.
-    n_left_pad_value  = 38
-    n_left_pad_value -= key_to_invoke_the_method.size
-    left_padding+HOW_TO_INVOKE_THE_PROGRAM+
-                 skyblue(' '+key_to_invoke_the_method)+
-                 (' ' * n_left_pad_value)+' # '+
-                 text_that_is_to_be_displayed
-  end
-
-  # ========================================================================= #
-  # === sanitize_use_this_build_system
-  #
-  # The build_system entry must always be a String.
-  # ========================================================================= #
-  def sanitize_use_this_build_system
-    _ = use_this_build_system?
-    _ = '' if _.nil?
-    if _ and _.is_a?(String) and _.empty?
-      # ===================================================================== #
-      # Must set a new default value in this case.
-      # ===================================================================== #
-      _ = :default # This means to infer the build system in use.
-    end
-    set_use_this_build_system(_)
-  end
-
-  require 'rbt/constants/registered_cookbook_entries.rb'
-  # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.feedback_all_available_formats
-  #
-  # To invoke this method from the commandline, try:
-  #
-  #   rbt --feedback_all_available_formats
-  #
-  # ========================================================================= #
-  def self.feedback_all_available_formats(
-      i = ::RBT.return_file_specification_of_registered_cookbook_entries
-    )
-    dataset = YAML.load_file(i)
-    dataset.each_pair {|key, value|
-      if Object.const_defined? :Colours
-        separator = ::RBT.slateblue(': ')
-      else
-        separator = simp(': ')
-      end
-      ::RBT.e(
-        key.ljust(30)+separator+value.rjust(10)
-      )
-    }
-  end
-
-  # ========================================================================= #
-  # === n_programs_available?
-  # ========================================================================= #
-  def n_programs_available?
-    RBT.n_programs?
-  end
-
-  # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.return_dataset
-  #
-  # This method will return the whole dataset for a given program at
-  # hand (if it is registered). You can then use this dataset in
-  # other programs.
-  #
-  # As input it is preferred to provide a symbol, such as :htop or
-  # :lua; a String should work fine as well, though.
-  #
-  # Returns: a Hash
-  #
-  # Usage examples:
-  #
-  #   htop_dataset = RBT::Cookbooks::SanitizeCookbook.return_dataset(:htop)
-  #   ruby_dataset = RBT::Cookbooks::SanitizeCookbook.return_dataset(:ruby)
-  #
-  # ========================================================================= #
-  def self.return_dataset(
-      of_this_program = :htop
-    )
-    dataset = RBT::Cookbooks::SanitizeCookbook.new(of_this_program).yaml_dataset?
-    return dataset
-  end; self.instance_eval { alias return_cookbook_dataset_for return_dataset } # === RBT::Cookbooks::Cookbook.return_cookbook_dataset_for
-       self.instance_eval { alias cookbook_dataset_for        return_dataset } # === RBT::Cookbooks::Cookbook.cookbook_dataset_for
-
-end; end; end