rbt 0.9.007 → 0.10.156

data/lib/rbt/cookbooks/{cookbook/sanitize.rb → sanitize_cookbook/sync.rb}

@@ -2,290 +2,610 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'rbt/cookbooks/cookbook/sanitize.rb'
+# require 'rbt/cookbooks/sanitize_cookbook/sync.rb'
 # =========================================================================== #
 module RBT
 
 module Cookbooks
 
-class Cookbook < ::RBT::Base # === RBT::Cookbooks::Cookbook
+class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
 
   # ========================================================================= #
-  # === sanitize_the_internal_dataset                (sanitize tag, sani tag)
+  # === sync_url1_onto_the_main_hash
+  # ========================================================================= #
+  def sync_url1_onto_the_main_hash
+    _ = @raw_cookbook.url1?
+    if _
+      _ = return_sanitize_url1(_)
+    end
+    set_url1(_)
+  end
+
+  # ========================================================================= #
+  # === sync_md5sum_onto_the_main_hash
+  # ========================================================================= #
+  def sync_md5sum_onto_the_main_hash
+    @dataset[:md5sum] = @raw_cookbook.md5sum?
+  end
+
+  # ========================================================================= #
+  # === sync_url2_onto_the_main_hash
+  # ========================================================================= #
+  def sync_url2_onto_the_main_hash
+    @dataset[:url2] = @raw_cookbook.url2?
+  end
+
+  # ========================================================================= #
+  # === sync_homepage_onto_the_main_hash
+  # ========================================================================= #
+  def sync_homepage_onto_the_main_hash
+    _ = @raw_cookbook.homepage?
+    unless _.is_a? String # Make sure we have a String.
+      _ = _.to_s
+    end
+    set_homepage(_)
+  end; alias sanitize_the_homepage_entry sync_homepage_onto_the_main_hash # === sanitize_the_homepage_entry
+
+  # ========================================================================= #
+  # === sync_required_deps_on_onto_the_main_hash
+  # ========================================================================= #
+  def sync_required_deps_on_onto_the_main_hash
+    _ = @raw_cookbook.required_deps_on?
+    if _.nil?
+      _ = return_proper_type_for(:required_deps_on)
+    end
+    @dataset[:required_deps_on] = _
+  end
+
+  # ========================================================================= #
+  # === sync_required_deps_onto_the_main_hash
+  #
+  # The entry required_deps_on will be sanitized here - it must be an 
+  # Array at all times.
+  # ========================================================================= #
+  def sync_required_deps_onto_the_main_hash
+    _ = required_deps_on?
+    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 sync_required_deps_onto_the_main_hash # === sanitize_required_deps
+
+  # ========================================================================= #
+  # === sync_headers_onto_the_main_hash                         (headers tag)
+  #
+  # This method was added in May 2014.
+  #
+  # The headers entry must be kept as an Array at all times, according
+  # to the specification.
+  # ========================================================================= #
+  def sync_headers_onto_the_main_hash
+    _ = 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 sync_headers_onto_the_main_hash # === sanitize_headers
+
+  # ========================================================================= #
+  # === sync_postinstall_onto_the_main_hash
+  #
+  # 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.
   #
-  # This is the method that will sanitize the whole internal dataset,
-  # which is typically a yaml-based dataset.
+  # As of 20.09.2014, the specification requires that postinstall
+  # must be an Array at all times.
   #
-  # Take note that some entries have to come in a specific order, since
-  # they depend on prior values already set correctly.
+  # Invocation example:
   #
-  # This method must ensure that the mandatory entries will exist in
-  # the main yaml dataset.
+  #   scookie libraw1394
   #
-  # Additionally, this method may run various sanitize-commands,
-  # through subsequent method calls.
   # ========================================================================= #
-  def sanitize_the_internal_dataset
-    if @found
-      if url1? and url1.end_with? '.js'
-        set_archive('.js')
+  def sync_postinstall_onto_the_main_hash
+    _ = [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; alias sanitize_postinstall sync_postinstall_onto_the_main_hash # === sanitize_postinstall
+
+  # ========================================================================= #
+  # === sync_blfs_entry_onto_the_main_hash
+  #
+  # This will be only synced if we actually have an entry.
+  #
+  # The BLFS entry must be guaranteed to be an Array.
+  # ========================================================================= #
+  def sync_blfs_entry_onto_the_main_hash
+    _ = @raw_cookbook.blfs?
+    if _
+      unless _.is_a? Array
+        if _.nil?
+          _ = []
+        elsif _.empty?
+          _ = [] # Empty Array then.
+        else
+          _ = [_]
+        end
       end
-      check_for_outdated_entries
-      set_default_raw_description
-      if url1? and (short_name?.nil? or short_name?.empty?)
-        if (program_name?.nil? or program_name?.empty?)
+      set_blfs(_)
+    else # Set it to be an empty Array by default, in this case.
+      set_blfs []
+    end
+  end; alias sanitize_blfs_entry sync_blfs_entry_onto_the_main_hash # === sanitize_blfs_entry
+
+  # ========================================================================= #
+  # === sync_sed_entry_onto_the_main_hash                           (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 sync_sed_entry_onto_the_main_hash
+    # ======================================================================= #
+    # 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 _
           # ================================================================= #
-          # Note that we must also check for program_name above, as
-          # the .yml file may have specified a specific other version
-          # that is to be used.
+          # We need an Array past this point.
           # ================================================================= #
-          guess_entries_based_on_the_first_url
-        else
-          sanitize_program_name
-          _ = ProgramInformation.new(program_name?)
-          if short_name?.empty?
-            set_short_name(_.short_name?)
-          end
-          if program_version?.empty?
-            set_program_version(_.program_version?)
-          end
-          if base_dir?.empty?
-            set_base_dir(src_dir?+short_name?)
-          end
-          set_archive(:tar_xz)
-          set_program_full_name(:default)
-          set_program_path(:default)
+          _ = [_].compact # We don't want to store nil values here.
+          set_sed(_)
+        end
+      end
+    end
+  end; alias try_to_sanitize_the_sed_entry sync_sed_entry_onto_the_main_hash # === try_to_sanitize_the_sed_entry
+
+  # ========================================================================= #
+  # === sync_binaries_onto_the_main_hash                       (binaries tag)
+  #
+  # This method will sanitize the binaries entry.
+  #
+  # The binaries must be kept in Array format at all times.
+  # ========================================================================= #
+  def sync_binaries_onto_the_main_hash
+    _ = @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 sync_binaries_onto_the_main_hash # === sanitize_binaries
+
+  # ========================================================================= #
+  # === sync_configure_options_onto_the_main_hash             (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 sync_configure_options_onto_the_main_hash
+    # ======================================================================= #
+    # 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
       # ===================================================================== #
-      # Next, sanitize individual entries.
+      # Treat 'VERSION' as a macro, for expansion.
       # ===================================================================== #
-      # sanitize_may_we_modify_the_configure_options # ← Must come before sanitize_configure_options()
-      # ^^^ but it is currently not needed, anyway.
-      sanitize_licence
-      sanitize_apply_patch
-      sanitize_binaries
-      sanitize_libraries
-      sanitize_blfs_entry
-      sanitize_tags
-      sanitize_use_this_build_system
-      sanitize_configure_options
-      sanitize_meson_configure_options
-      sanitize_cmake_configure_options
-      sanitize_preinstall
-      sanitize_autogen
-      sanitize_headers
-      sanitize_has_to_be_compiled
-      sanitize_configure_command_to_use
-      sanitize_configure_base_dir
-      sanitize_required_deps
-      sanitize_url1
-      try_to_sanitize_the_sed_entry
-      sanitize_parameters_to_make
-      sanitize_env_variables
-      sanitize_last_update_entry
-      sanitize_short_description
-      sanitize_description
-      sanitize_extra_information
-      sanitize_use_this_make_command
-      sanitize_pre_make_commands
-      sanitize_installation_steps
-      sanitize_run_configure
-      sanitize_program_compile_name
-      sanitize_program_name
-      unless File.exist? program_path?
-        rebuild_program_full_name
-        set_program_name_and_program_version(
-          :default
-        )
-        sanitize_program_path
+      if _.include? 'PROGRAM_VERSION'
+        _.gsub!(/PROGRAM_VERSION/, program_version?.to_s) if _
+      elsif _.include? 'VERSION'
+        _.gsub!(/VERSION/, program_version?.to_s) if _
       end
-      unless File.exist? program_path?
-        try_to_guess_the_program_path_based_on_the_program_name_and_program_version
+      # ===================================================================== #
+      # Treat 'CURRENT' as a macro, for expansion.
+      # ===================================================================== #
+      if _.include? 'CURRENT'
+        _.gsub!(/CURRENT/, program_version?.to_s) if _
       end
-      unless File.exist? program_path?
+      # ===================================================================== #
+      # === 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?
         # =================================================================== #
-        # Try to see whether we can modify the archive_type, in order to
-        # find a proper match.
+        # 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 
         # =================================================================== #
-        target = base_dir?+'*'
-        possible_matches = Dir[target].sort
-        unless possible_matches.empty?
+        splitted = _.split(' ')
+        _ = splitted.map {|configure_option|
+          # If configure_option =~ /^disable|enable|with|without/
           # ================================================================= #
-          # This means we may have found another archive. We will sort this
-          # first.
+          # Only add when not yet first char is NOT a '-'.
           # ================================================================= #
-          possible_matches = sort_by_archive_priority(possible_matches)
-          first_entry = possible_matches.first # Obtain an entry to it.
+          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; alias sanitize_configure_options sync_configure_options_onto_the_main_hash # === sanitize_configure_options
+
+  # ========================================================================= #
+  # === sync_prefix_onto_the_main_hash                  (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 sync_prefix_onto_the_main_hash
+    # ======================================================================= #
+    # General way to overrule the prefix setting in this case.
+    # ======================================================================= #
+    if COMPILE_EVERYTHING_INTO_STANDALONE_DIRECTORY
+      _ = 't'
+    else
+      # ===================================================================== #
+      # We need to use .to_s because the prefix can be a boolean value as
+      # well, such as true or false.
+      # ===================================================================== #
+      _ = 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.
+    # ======================================================================= #
+    _ = substitute_macros(_).dup
+    case _
+    when 't','true','yes','y','traditional'
+      _ = '/usr/'
+    when 'f','false','no','AppDir',
+         'return_appdir_path','appdir_path'
+      _ = return_appdir_prefix.dup # ← This is the AppDir variant.
+    end
+    # ======================================================================= #
+    # Append '/' unless we already have a trailing '/'.
+    # ======================================================================= #
+    _ << '/' unless _.end_with? '/'
+    _.sub!(/ULOCAL/,'/usr/local') if _.include? 'ULOCAL' # ULOCAL gets expanded to /usr/local
+    _.sub!(/ULOC/,  '/usr/local') if _.include? 'ULOC'   # same counts for ULOC
+    # ======================================================================= #
+    # We used to delete '-' here in the past, but as of Sep 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.
+    # ======================================================================= #
+    # _.delete!('-') if _.include? '-'
+    set_prefix(_)
+  end; alias sanitize_prefix sync_prefix_onto_the_main_hash # === sanitize_prefix
+
+  # ========================================================================= #
+  # === sync_installation_steps_onto_the_main_hash
+  #
+  # 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 sync_installation_steps_onto_the_main_hash
+    _ = 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
           # ================================================================= #
-          # Check for nil-entries:
+          # The String may look like this:
+          #
+          #   copy_ruby; ruby setup.rb config; ruby setup.rb setup; ruby setup.rb install
+          #
           # ================================================================= #
-          if first_entry.nil?
-            unless Dir[target].empty? # Try to rescue.
-              first_entry = Dir[target].first
-            end
-            if first_entry.nil?
-              opnn; e swarn('Error at line '+__LINE__.to_s+':')
-              pp possible_matches
-              e 'The target was: '+steelblue(target)
-              pp Dir[target]
-              opnn; e swarn('Error at line '+__LINE__.to_s+':')
-              e 'The first_entry was nil.'
-              e 'Possible matches were:'
-              pp possible_matches
-              e 'The target was at: '+steelblue(target)
-              e 'The program path was at: '+steelblue(program_path?.to_s)
-              opnn; e swarn('^^^ Error at line '+__LINE__.to_s+':')
-            end
+          if entry.include? ';'
+            entry = entry.split(';').map(&:strip)
           end
-          short_first_entry = File.basename(first_entry)
-          set_archive_type(
-            short_first_entry
-          )
+        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'
           # ================================================================= #
-          # Check whether the program name is like 'apt_1.2.1'
+          # Need to set @program_version first, hence we update some stuff.
           # ================================================================= #
-          if program_name.include?('_') and !program_name.include?('-')
-            unless File.basename(first_entry).include?('_')
-              name, version = ProgramInformation.return_name_and_version_of(
-                                File.basename(first_entry)
-                              )
-              set_short_name(name)
-              set_program_version(version)
-              use_default_connective_token_again 
-              assemble_program_name
-            end
+          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
-          sync_archive_type_entries # This method will also update the program path.
-        end
-      end
-      if archive_type?.empty? and !program_name?.empty?
-        try_to_guess_the_archive_type
-      end
-      # ======================================================================= #
-      # Do some syncing next - first, make sure that the program_full_name
-      # setting is not empty.
-      # ======================================================================= #
-      if program_full_name?.empty?
-        sync_archive_type_entries
-      end
-      set_extract_to
-      # ======================================================================= #
-      # Last but not least, find out the file size of the program in question.
-      # ======================================================================= #
-      calculate_archive_size
-      calculate_md5sum if shall_we_display_the_md5sum?
-      # ===================================================================== #
-      # === Sanitize the Prefix
-      #
-      # The prefix setting can only be sanitized after the program_version
-      # has been sanitized, since the actual prefix may depend on the
-      # program version in use, such as for AppDirs.
-      # ===================================================================== #
-      sanitize_prefix # Must come BEFORE sanitize_postinstall.
-      # ===================================================================== #
-      # === sanitize_postinstall
-      #
-      # sanitize_postinstall should only be called after the prefix was
-      # already defined, since a few internal-parts of the method
-      # sanitize_postinstall may need to know the real prefix in use.
-      # ===================================================================== #
-      sanitize_postinstall
-      # ===================================================================== #
-      # Last but not least, delete the array that holds the invalid
-      # keys, since this information will no longer be relevant.
-      # ===================================================================== #
-      cleanup_unusued_variables
-    end
-  end; alias sanitize_yaml_dataset sanitize_the_internal_dataset # === sanitize_yaml_dataset
-
-  # ========================================================================= #
-  # === cleanup_unusued_variables
-  # ========================================================================= #
-  def cleanup_unusued_variables
-    # ======================================================================= #
-    # Must safeguard to query whether the key still exists. When it
-    # does, we will simply delete them.
-    # ======================================================================= #
-    if internal_hash?.has_key? :array_invalid_keys
-      internal_hash?.delete :array_invalid_keys
-    end
-  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?
-    _ = [_].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_blfs_entry
-  #
-  # This method will clean up the BLFS entry, should it exist.
-  #
-  # It must be guaranteed to be an Array.
-  # ========================================================================= #
-  def sanitize_blfs_entry
-    if has_key? 'blfs'
-      _ = blfs?
-      unless _.is_a? Array
-        if _.nil?
-          _ = []
-        elsif _.empty?
-          _ = [] # Empty Array then.
-        else
-          _ = [_]
         end
-        set_blfs _
-      end
-    else # Set it to be an empty Array by default, in this case.
-      set_blfs []
-    end
-  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?
-    if _.has_key?('github') and !_['github'].nil? and !_['github'].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
+        line = line.split(';') if line.include? ';' # This may turn it into an Array.
+        line
+      }
     end
-  end
+    _.flatten!
+    _.map!(&:strip)
+    set_installation_steps(_)
+  end; alias sanitize_installation_steps sync_installation_steps_onto_the_main_hash # === sanitize_installation_steps
 
   # ========================================================================= #
-  # === sanitize_tags
+  # === sync_tags_onto_the_main_hash
   #
   # 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
+  def sync_tags_onto_the_main_hash
     _ = 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
@@ -325,8 +645,8 @@ class Cookbook < ::RBT::Base # === RBT::Cookbooks::Cookbook
     end
     if _.is_a? Array
       # ===================================================================== #
-      # Before we do anything else, we will apply a .map-strip
-      # and a exchange of all ' ' with '_' operation:
+      # Before we do anything else, we will apply a .map-strip and a 
+      # exchange of all ' ' with '_' operation:
       # ===================================================================== #
       _.map! {|line|
         if line
@@ -348,33 +668,31 @@ class Cookbook < ::RBT::Base # === RBT::Cookbooks::Cookbook
     end
     # ======================================================================= #
     # Since as of Feb 2017, we will also ensure that the tags that are
-    # in use, conform to our specification. If not then we will notify
-    # the user, and exit.
+    # 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|
+    _.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 "The specified tag called `#{simp(this_tag)}` for the program "\
+        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('discouraged')+
-          ', but still allowed.'
+        e 'This is currently '+violet('disallowed')+'.'
         e
-        e 'The faulty entry should still be corrected though. So either'
-        e 'the cookbook file in question should be modified, or the tag should'
-        e "be added to the registry of allowed tags in the specification "\
+        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?
@@ -384,224 +702,186 @@ class Cookbook < ::RBT::Base # === RBT::Cookbooks::Cookbook
         end
         # =================================================================== #
         # No longer exit as of November 2013.
+        # And in April 2021 we will exit again.
         # =================================================================== #
-        # exit # And exit here.
+        exit # And exit here.
       end
     }
-    set_tags _ # Finally set the Array that has our tags.
-  end
+    set_tags(_) # Finally set the Array that has our tags.
+  end; alias sanitize_tags sync_tags_onto_the_main_hash # === sanitize_tags
 
   # ========================================================================= #
-  # === sanitize_use_this_build_system
+  # === sync_licence_onto_the_main_hash
   #
-  # The build_system entry must always be a String.
+  # Empty license should default to "unknown" license. This method
+  # will ensure that this is the case.
   # ========================================================================= #
-  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.
-      # ===================================================================== #
-      set_use_this_build_system :default # This means to infer the build system in use.
+  def sync_licence_onto_the_main_hash
+    _ = 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
+  end; alias sanitize_licence sync_licence_onto_the_main_hash # === sanitize_licence
 
   # ========================================================================= #
-  # === sanitize_apply_patch
+  # === sync_meson_configure_options_onto_the_main_hash
   #
-  # Here we sanitize the value for apply_patch.
+  # 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_apply_patch
-    _ = apply_patch?
+  def sync_meson_configure_options_onto_the_main_hash
+    _ = @raw_cookbook.meson_configure_options?
+    _ = meson_configure_options? unless meson_configure_options?.nil?
+    # ======================================================================= #
+    # We sanitize it a bit, if the option exists.
+    # ======================================================================= #
     if _
-      if _.include? '#'
-        _ = _[0 .. (_.index('#') - 1)]
-        set_apply_patch _
+      _ = _.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? '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.
-          set_apply_patch ''
-        end
+      if _.include? N
+        _.tr!(N,' ')
       end
+      _.strip!
+      _.squeeze!(' ')
+      set_meson_configure_options(_)
     end
-  end
+  end; alias sanitize_meson_configure_options sync_meson_configure_options_onto_the_main_hash # === sanitize_meson_configure_options
 
   # ========================================================================= #
-  # === sanitize_binaries                                    (binaries tag)
-  #
-  # This method will sanitize the binaries entry, @_[:binaries].
-  #
-  # We must keep the binaries in Array format at all times.
+  # === sync_has_to_be_compiled_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_binaries
-    _ = binaries? # Obtain a pointer.
-    _ = [] if _.nil?
-    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
+  def sync_has_to_be_compiled_onto_the_main_hash
+    _ = 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
-    _ = _.flatten.compact.map(&:strip)
-    set_binaries(_)
-  end
+    set_has_to_be_compiled(to_bool(_))
+  end; alias sanitize_has_to_be_compiled sync_has_to_be_compiled_onto_the_main_hash # === sanitize_has_to_be_compiled
 
   # ========================================================================= #
-  # === sanitize_libraries
-  #
-  # This sanitizes the libraries entry, @_[:libraries].
+  # === sync_short_description_onto_the_main_hash
   #
-  # We must keep this entry in Array format.
+  # Right now this method will only get rid of newlines and do a .strip()
+  # call.
   # ========================================================================= #
-  def sanitize_libraries
-    _ = 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
+  def sync_short_description_onto_the_main_hash
+    short_description = short_description?
+    if short_description.nil?
+      short_description = raw_cookbook?.short_description?
     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
+    if short_description and short_description.include? N
+      set_short_description(
+        short_description.to_s.delete(N).strip
+      )
     end
-    new_value = [_].flatten.compact
-    set_libraries(new_value)
-  end
+  end; alias sanitize_short_description sync_short_description_onto_the_main_hash # === sanitize_short_description
 
   # ========================================================================= #
-  # === 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.
+  # === sync_last_update_onto_the_main_hash
   #
-  # Some options should not be sanitized, such as "-Wno-dev -G Ninja .."
-  # in applications that use the cmake build system, e. g. LLVM.
+  # The only sanitize-operation we do here is if it is an valid date,
+  # such as "32 Aug 2017".
   # ========================================================================= #
-  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.
-    # ======================================================================= #
-    _ = configure_options?.to_s.strip # Don't want empty thingies here.
-    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(' ')
+  def sync_last_update_onto_the_main_hash
+    _ = 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
-      # ===================================================================== #
-      # Try to handle $ input.
-      # ===================================================================== #
-      if _.include? '$'
-        unless Object.const_defined? :ConvertGlobalEnv
-          require 'convert_global_env'
-        end
-        _ = ConvertGlobalEnv.convert(_)
+    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 sync_last_update_onto_the_main_hash # === sanitize_last_update
+
+  # ========================================================================= #
+  # === sync_pre_make_commands_onto_the_main_hash
+  #
+  # 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 sync_pre_make_commands_onto_the_main_hash
+    _ = 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
-    _.tr!(N, ' ') # Replace all newlines again.
-    set_configure_options(_) # Last but not least, reassign.
-  end
+    array.flatten!
+    array.compact!
+    set_pre_make_commands(array) # Turn it into an Array here.
+  end; alias sanitize_pre_make_commands sync_pre_make_commands_onto_the_main_hash # === sanitize_pre_make_commands
 
   # ========================================================================= #
-  # === sanitize_cmake_configure_options
+  # === sync_cmake_configure_options_onto_the_main_hash
   #
-  # This method is similar to the method sanitize_configure_options()
-  # but it is only valid for cmake, not for GNU autoconfigure. A
-  # similar method exists for meson-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
+  def sync_cmake_configure_options_onto_the_main_hash
     _ = cmake_configure_options?
+    if _.nil?
+      if raw_cookbook?.cmake_configure_options?
+        _ = raw_cookbook?.cmake_configure_options?
+      end
+    end
     if _ and !_.empty?
       _ = _.to_s.strip
       # ===================================================================== #
@@ -615,13 +895,71 @@ class Cookbook < ::RBT::Base # === RBT::Cookbooks::Cookbook
       _.strip!
       set_cmake_configure_options(_)
     end
-  end
+  end; alias sanitize_cmake_configure_options sync_cmake_configure_options_onto_the_main_hash # === sanitize_cmake_configure_options
+
+  # ========================================================================= #
+  # === sync_description_onto_the_main_hash       (description tag, desc tag)
+  #
+  # Get rid of trailing newlines in our description, and apply
+  # some other operations. 
+  # ========================================================================= #
+  def sync_description_onto_the_main_hash
+    _ = 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; alias sanitize_description sync_description_onto_the_main_hash # === sanitize_description
+
+  # ========================================================================= #
+  # === sync_parameters_to_make_onto_the_main_hash
+  #
+  # 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 sync_parameters_to_make_onto_the_main_hash
+    _ = 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       sync_parameters_to_make_onto_the_main_hash # === sanitize_make_options
+       alias sanitize_parameters_to_make sync_parameters_to_make_onto_the_main_hash # === sanitize_parameters_to_make
 
   # ========================================================================= #
-  # === sanitize_preinstall
+  # === sync_preinstall_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_preinstall
+  def sync_preinstall_onto_the_main_hash
     _ = preinstall?
+    if _ and _.empty?
+      _ = raw_cookbook?.preinstall?
+    end
     if _.is_a?(String) and (_.count(N) > 1)
       _ = _.split(N)
     end
@@ -637,154 +975,89 @@ class Cookbook < ::RBT::Base # === RBT::Cookbooks::Cookbook
       end
       set_preinstall _
     end
-  end
-
-  # ========================================================================= #
-  # === try_to_sanitize_the_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 try_to_sanitize_the_sed_entry
-    # ======================================================================= #
-    # Only sanitize the sed entry if we have that key.
-    # ======================================================================= #
-    if has_key? :sed
-      _ = sed?
-      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
+  end; alias sanitize_preinstall sync_preinstall_onto_the_main_hash # === sanitize_preinstall
 
   # ========================================================================= #
-  # === sanitize_the_homepage_entry
+  # === sync_use_this_program_name_on_gobolinux_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_the_homepage_entry
-    _ = homepage?
-    unless _.is_a? String
-      set_homepage(_.to_s)
+  def sync_use_this_program_name_on_gobolinux_onto_the_main_hash(
+      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
+  end; alias sanitize_program_compile_name sync_use_this_program_name_on_gobolinux_onto_the_main_hash # === sync_use_this_program_name_on_gobolinux_onto_the_main_hash
 
   # ========================================================================= #
-  # === sanitize_licence
+  # === sync_use_this_make_command_onto_the_main_hash
   #
-  # Empty license should default to "unknown" license. This method
-  # will ensure that this is the case.
+  # 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_licence
-    _ = licence?
-    begin
+  def sync_use_this_make_command_onto_the_main_hash
+    _ = use_this_make_command?
+    if _ and _.empty?
+      _ = raw_cookbook?.use_this_make_command?
       if _.nil? or _.empty?
-        set_licence('unknown')
-      else
-        if _.is_a?(String) and _.include?(',') # ← In this case, turn it into an Array.
-          set_licence(_.split(',').map(&:strip))
-        end
+        _ = MAKE_COMMAND_TO_USE # MAKE_COMMAND_TO_USE is defined in constants.rb
       end
-    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
+    set_use_this_make_command(_)
+  end; alias sanitize_use_this_make_command sync_use_this_make_command_onto_the_main_hash # === sanitize_use_this_make_command
 
   # ========================================================================= #
-  # === 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.
+  # === sync_gir_files_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_meson_configure_options
-    _ = meson_configure_options?
-    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_meson_configure_options(_)
+  def sync_gir_files_onto_the_main_hash
+    _ = gir_files?
+    if _.empty?
+      _ = raw_cookbook?.gir_files? if raw_cookbook?.gir_files?
     end
+    set_gir_files(_)
   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.
+  # === sync_pre_configure_steps_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_configure_base_dir
-    _ = configure_base_dir?
-    if _
-      unless _.empty?
-        set_configure_base_dir(
-          rds("#{_}/")
-        )
-      end
-    end
+  def sync_pre_configure_steps_onto_the_main_hash
+    _ = pre_configure_steps?
+    _ = raw_cookbook?.pre_configure_steps? if _ and _.empty?
+    set_pre_configure_steps(_) if _
   end
 
   # ========================================================================= #
-  # === sanitize_url1
-  #
-  # We will chop off some parts of the URL.
+  # === sync_git_url_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_url1(
-      i = url1?
-    )
-    set_url1(
-      return_sanitize_url1(i)
-    )
+  def sync_git_url_onto_the_main_hash
+    _ = git_url?
+    _ = raw_cookbook?.git_url? if _.nil?
+    set_git_url(_) if _
   end
 
   # ========================================================================= #
-  # === return_sanitize_url1
+  # === sync_pkgconfig_files_onto_the_main_hash
   # ========================================================================= #
-  def return_sanitize_url1(i = url1?)
-    i = i.dup
-    # ======================================================================= #
-    # === Handle "llvm-10.0.0.src.tar.xz" and similar cases next
-    # ======================================================================= #
-    if i.include? '.src.'
-      i.sub!(/\.src/,'')
+  def sync_pkgconfig_files_onto_the_main_hash
+    _ = pkgconfig_files?
+    if _ and _.empty?
+      _ = raw_cookbook?.pkgconfig_files? if raw_cookbook?.pkgconfig_files?
     end
-    if i.end_with? '/download'
-      i.gsub!(/\/download$/,'')
-    end
-    return i
+    set_pkgconfig_files(_)
   end
 
   # ========================================================================= #
-  # === sanitize_configure_command_to_use
+  # === sync_configure_command_to_use_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_configure_command_to_use
+  def sync_configure_command_to_use_onto_the_main_hash
     _ = 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'
@@ -794,867 +1067,635 @@ class Cookbook < ::RBT::Base # === RBT::Cookbooks::Cookbook
       else
         _ = convert_global_env(_) if _.include? '$'
       end
-      set_configure_command_to_use(_) # set rescue.
+      set_configure_command_to_use(_)
     end
-  end; alias sanitize_configure_command sanitize_configure_command_to_use # === sanitize_configure_command
+  end; alias sanitize_configure_command_to_use sync_configure_command_to_use_onto_the_main_hash # === sanitize_configure_command_to_use
+       alias sanitize_configure_command        sync_configure_command_to_use_onto_the_main_hash # === sanitize_configure_command
 
   # ========================================================================= #
-  # === sanitize_last_update_entry
+  # === sync_extra_information_onto_the_main_hash
   #
-  # The only sanitize-operation we do here is if it is an valid date,
-  # such as "32 Aug 2017".
+  # We must not lose information from the original dataset, in regards
+  # to extra_information.
   # ========================================================================= #
-  def sanitize_last_update_entry
-    _ = last_update?
-    if _.include? ' '
-      splitted = _.split(' ')
-      day = splitted.first
-      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.')
+  def sync_extra_information_onto_the_main_hash
+    _ = @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; alias sanitize_extra_information sync_extra_information_onto_the_main_hash # === sanitize_extra_information
+
+  # ========================================================================= #
+  # === sync_autosymlink_lib64_onto_the_main_hash
+  # ========================================================================= #
+  def sync_autosymlink_lib64_onto_the_main_hash
+    _ = @raw_cookbook.autosymlink_lib64?
+    set_autosymlink_lib64(_)
+  end
+
+  # ========================================================================= #
+  # === sync_can_be_compiled_statically_onto_the_main_hash
+  # ========================================================================= #
+  def sync_can_be_compiled_statically_onto_the_main_hash
+    _ = @raw_cookbook.can_be_compiled_statically?
+    set_can_be_compiled_statically(to_bool(_))
+  end
+
+  # ========================================================================= #
+  # === sync_configure_options_explained_onto_the_main_hash
+  # ========================================================================= #
+  def sync_configure_options_explained_onto_the_main_hash
+    _ = @raw_cookbook.configure_options_explained?.to_s
+    set_configure_options_explained(_)
+  end
+
+  # ========================================================================= #
+  # === sync_echo_yes_onto_the_main_hash
+  # ========================================================================= #
+  def sync_echo_yes_onto_the_main_hash
+    _ = @raw_cookbook.echo_yes?.to_s
+    set_echo_yes(to_bool(_))
+  end
+
+  # ========================================================================= #
+  # === sync_do_not_symlink_onto_the_main_hash
+  # ========================================================================= #
+  def sync_do_not_symlink_onto_the_main_hash
+    _ = @raw_cookbook.do_not_symlink?.to_s
+    if _ and _.empty?
+      _ = do_not_symlink?.to_s
+    end
+    set_do_not_symlink(to_bool(_))
+  end
+
+  # ========================================================================= #
+  # === sync_enable_static_onto_the_main_hash
+  # ========================================================================= #
+  def sync_enable_static_onto_the_main_hash
+    _ = @raw_cookbook.enable_static?.to_s
+    if _ and _.empty?
+      _ = enable_static?.to_s
+    end
+    set_do_not_symlink(to_bool(_))
+  end
+
+  # ========================================================================= #
+  # === sync_keep_extracted_onto_the_main_hash
+  # ========================================================================= #
+  def sync_keep_extracted_onto_the_main_hash
+    _ = @raw_cookbook.keep_extracted?.to_s
+    if _ and _.empty?
+      _ = keep_extracted?.to_s
+    end
+    set_keep_extracted(to_bool(_))
+  end
+
+  # ========================================================================= #
+  # === sync_libraries_onto_the_main_hash
+  #
+  # This sanitizes the libraries entry, @_[:libraries].
+  #
+  # We must keep this entry in Array format.
+  # ========================================================================= #
+  def sync_libraries_onto_the_main_hash
+    _ = @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.
         # =================================================================== #
-        # We could exit here but this is mostly an annoyance rather than
-        # a bug, so we continue.
+        # Some libraries may have components such as foo{so.a}
+        # We need to split these up into foo.so and foo.a.
         # =================================================================== #
-      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 if _.first
     end
-  end; alias sanitize_last_update sanitize_last_update_entry # === sanitize_last_update
+    new_value = [_].flatten.compact
+    set_libraries(new_value)
+  end; alias sanitize_libraries sync_libraries_onto_the_main_hash # === sanitize_libraries
 
   # ========================================================================= #
-  # === sanitize_short_description
-  #
-  # Right now this method will only get rid of newlines.
+  # === sync_enable_shared_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_short_description
-    short_description = short_description?
-    if short_description and short_description?.include? N
-      set_short_description(
-        short_description?.delete(N)
-      )
+  def sync_enable_shared_onto_the_main_hash
+    _ = @raw_cookbook.enable_shared?.to_s
+    if _ and _.empty?
+      _ = enable_shared?.to_s
     end
+    set_enable_shared(to_bool(_))
   end
 
   # ========================================================================= #
-  # === sanitize_base_dir
-  #
-  # This method will currently only downcase the last part, so that
-  # "Eterm/" becomes "eterm/" instead. Note that the base_dir value
-  # will typically look like this: '/home/x/src/gnomemahjongg/' 
-  # ========================================================================= #
-  def sanitize_base_dir
-    _ = base_dir?
-    if _.include? '/'
-      splitted = _.split('/')
-      last_part = splitted.last
-      unless last_part == last_part.downcase
-        splitted[-1] = last_part.downcase
-        _ = splitted.join('/')
-        set_base_dir(_)
-      end
+  # === sync_libexec_onto_the_main_hash
+  # ========================================================================= #
+  def sync_libexec_onto_the_main_hash
+    _ = @raw_cookbook.libexec?
+    if _ and _.empty?
+      _ = libexec?
     end
+    set_libexec(_)
   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.
+  # === sync_last_update_entry_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_pre_make_commands
-    _ = pre_make_commands?
-    _.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
+  def sync_last_update_entry_onto_the_main_hash
+    set_last_update(@raw_cookbook.last_update?.to_s)
+  end; alias sanitize_last_update_entry sync_last_update_entry_onto_the_main_hash # === sanitize_last_update_entry
+
+  # ========================================================================= #
+  # === sync_m4_files_onto_the_main_hash
+  # ========================================================================= #
+  def sync_m4_files_onto_the_main_hash
+    _ = @raw_cookbook.m4_files?
+    if _ and _.empty?
+      _ = m4_files?
     end
-    array.flatten!
-    array.compact!
-    set_pre_make_commands(array) # Turn it into an Array here.
+    set_m4_files(_)
   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/".
-  #
-  # 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.
-  #
-  # 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.
+  # === sync_flatpak_url_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_installation_steps
-    _ = installation_steps?
-    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.
+  def sync_flatpak_url_onto_the_main_hash
+    _ = @raw_cookbook.flatpak_url?.to_s
+    if _ and _.empty?
+      _ = flatpak_url?.to_s
     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
-      }
+    set_flatpak_url(_)
+  end
+
+  # ========================================================================= #
+  # === sync_mirror_onto_the_main_hash
+  # ========================================================================= #
+  def sync_mirror_onto_the_main_hash
+    _ = @raw_cookbook.mirror?.to_s
+    set_mirror(_)
+  end
+
+  # ========================================================================= #
+  # === sync_symlink_glib_schema_onto_the_main_hash
+  # ========================================================================= #
+  def sync_symlink_glib_schema_onto_the_main_hash
+    _ = @raw_cookbook.symlink_glib_schema?.to_s
+    if _ and _.empty?
+      _ = symlink_glib_schema?.to_s
     end
-    _.flatten!
-    _.map!(&:strip)
-    set_installation_steps _
+    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.
+  # === sync_use_autoconf_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_use_this_make_command
-    if use_this_make_command?.to_s.empty?
-      set_use_this_make_command(MAKE_COMMAND_TO_USE) # MAKE_COMMAND_TO_USE is defined in constants.rb
+  def sync_use_autoconf_onto_the_main_hash
+    _ = 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_boolean_value
-  #
-  # This method will turn 't' into true and 'f' into false.
+  # === sync_use_this_make_install_command_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_boolean_value(i)
-    _ = obtain(i)
-    set(i, to_bool(_))
+  def sync_use_this_make_install_command_onto_the_main_hash
+    _ = raw_cookbook?.use_this_make_install_command?
+    set_use_this_make_install_command(_)
   end
 
   # ========================================================================= #
-  # === sanitize_run_configure
+  # === sync_use_this_build_directory_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_run_configure
-    _ = run_configure?
-    if _.is_a? String
-      _ = to_bool(_)
-    end
-    set_run_configure(_)
+  def sync_use_this_build_directory_onto_the_main_hash
+    _ = raw_cookbook?.use_this_build_directory?
+    set_use_this_build_directory(_)
   end
 
   # ========================================================================= #
-  # === sanitize_autogen
+  # === sync_wikipedia_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_autogen
-    set_use_autogen(
-      to_bool(use_autogen?)
-    )
+  def sync_wikipedia_onto_the_main_hash
+    _ = raw_cookbook?.wikipedia?
+    set_wikipedia(_)
   end
 
   # ========================================================================= #
-  # === sanitize_has_to_be_compiled
+  # === sync_is_an_active_project_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_has_to_be_compiled
-    _ = has_to_be_compiled?
-    set_has_to_be_compiled(to_bool(_))
+  def sync_is_an_active_project_onto_the_main_hash
+    _ = @raw_cookbook.is_an_active_project?
+    if _.nil?
+      _ = is_an_active_project?
+    end
+    set_is_an_active_project(to_bool(_))
   end
 
   # ========================================================================= #
-  # === sanitize_description                      (description tag, desc tag)
-  #
-  # Get rid of trailing newlines in our description, and apply
-  # some other operations. 
+  # === sync_env_variables_onto_the_main_hash
+  #  
+  # This will sanitize ENV variables. The ENV variables must be a
+  # Hash at all times.
   # ========================================================================= #
-  def sanitize_description
-    _ = description?.to_s.chomp
-    _.chop! if _.end_with? '"' # Get rid of leading and trailing ".
-    _[0,1] = '' if _.start_with? '"'
+  def sync_env_variables_onto_the_main_hash
     # ======================================================================= #
-    # Some macros have to be expanded before we invoke substitute_macros().
-    # SELF_NAME is such an example.
+    # Sync it first.
     # ======================================================================= #
-    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
+    @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_env_variables sync_env_variables_onto_the_main_hash # === sanitize_env_variables
+
+  # ========================================================================= #
+  # === sync_program_version_onto_the_main_hash
+  # ========================================================================= #
+  def sync_program_version_onto_the_main_hash
+    _ = @raw_cookbook.program_version?
+    if _.nil? or (_ and _.empty?)
+      _ = program_version?.to_s
     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 _
+    set_program_version(_)
   end
 
   # ========================================================================= #
-  # === sanitize_required_deps
-  #
-  # The entry required_deps_on will be sanitized here - it must be an 
-  # Array at all times.
+  # === sync_svn_url_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_required_deps
-    _ = required_deps_on?
-    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
+  def sync_svn_url_onto_the_main_hash
+    _ = svn_url?
+    if _.nil?
+      _ = @raw_cookbook.svn_url?
     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.')
+    set_svn_url(_.to_s)
+  end
+
+  # ========================================================================= #
+  # === sync_configure_base_dir_onto_the_main_hash
+  #
+  # 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 sync_configure_base_dir_onto_the_main_hash
+    _ = raw_cookbook?.configure_base_dir?
+    if _.nil?
+      _ = configure_base_dir?
     end
-    set_required_deps_on(array)
-  end
+    set_configure_base_dir(rds("#{_}/"))
+  end; alias sanitize_configure_base_dir sync_configure_base_dir_onto_the_main_hash # === sanitize_configure_base_dir
 
   # ========================================================================= #
-  # === sanitize_extra_information
+  # === sync_program_name_and_program_version_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_extra_information
-    if extra_information?
-      set_extra_information(
-        extra_information?.chomp.rstrip
-      )
+  def sync_program_name_and_program_version_onto_the_main_hash
+    _ = 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_program_compile_name
+  # === sync_use_build_directory_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_program_compile_name
-    _ = 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.
+  def sync_use_build_directory_onto_the_main_hash
+    _ = raw_cookbook?.use_build_directory?
+    if _.nil?
+      _ = use_build_directory?
     end
+    set_use_build_directory(_)
   end
 
   # ========================================================================= #
-  # === return_url_replace_underscore
+  # === sync_short_name_onto_the_main_hash
   # ========================================================================= #
-  def return_url_replace_underscore(i = url?)
-    _ = File.basename(i).dup
-    if _.include? '_'
-      _.tr!('_','-') # Replace all '_' with '-'.
-    elsif _.include? '.' # Else replace just the first '.'.
-      _.sub!('.','-')
+  def sync_short_name_onto_the_main_hash
+    _ = raw_cookbook?.short_name?
+    if _.nil?
+      _ = short_name?
     end
-    _ = remove_file_extension(_)
-    return _
+    set_short_name(_)
   end
 
   # ========================================================================= #
-  # === return_first_dot_as_hyphen_from_this_url
+  # === sync_base_dir_onto_the_main_hash
   # ========================================================================= #
-  def return_first_dot_as_hyphen_from_this_url(i = url?)
-    new_url = File.basename(i).dup # Obtain the URL here.
-    new_url.sub!(/\./,'-') # This replaces only the first '.' found.
-    return new_url
+  def sync_base_dir_onto_the_main_hash
+    _ = base_dir?.to_s
+    set_base_dir(_)
   end
 
   # ========================================================================= #
-  # === return_first_underscore_as_hyphen_and_other_undscores_as_dots
-  #
-  # This method exists specifically for input such as 'boost_1_61_0'.
+  # === sync_autogen_onto_the_main_hash
   # ========================================================================= #
-  def return_first_underscore_as_hyphen_and_other_undscores_as_dots(i = url?)
-    i = return_first_underscore_as_hyphen_from_this_url(i).dup
-    i.tr!('_','.')
-    return i
-  end
+  def sync_autogen_onto_the_main_hash
+    _ = raw_cookbook?.use_autogen?
+    if _.nil?
+      _ = use_autogen?
+    end
+    set_use_autogen(
+      to_bool(_)
+    )
+  end; alias sanitize_autogen sync_autogen_onto_the_main_hash # === sanitize_autogen
 
   # ========================================================================= #
-  # === return_sanitized_program_name_and_program_version
-  #
-  # This method will also get rid of archives.
+  # === sync_use_this_build_system_onto_the_main_hash
   #
-  # A full program_name_and_program_version would be something
-  # like:
-  #
-  #    'gnome-mahjonng-5.08'
-  #
-  #     (2) program_name                      like 'gnome-mahjongg'
+  # The build_system entry must always be a String.
   # ========================================================================= #
-  def return_sanitized_program_name_and_program_version(
-      i = program_name_and_program_version?.dup
-    )
-    url = url1?.dup
-    case i # case tag
-    # ======================================================================= #
-    # === FIRST_UNDERSCORE_AS_HYPHEN
-    #
-    # This will convert input such as 'boost_1_61_0' into 'boost-1_61_0'.
-    # ======================================================================= #
-    when 'FIRST_UNDERSCORE_AS_HYPHEN',
-         'FIRST_UNDERSCORE_IS_HYPHEN',
-         'USE_URL_REPLACE_UNDERSCORE'
-      i = return_first_underscore_as_hyphen_from_this_url(url) 
-    # ======================================================================= #
-    # === PROGRAM_NAME_AND_PROGRAM_VERSION_WITHOUT_ALPHABET
-    #
-    # This entry point has been specifically added for the program "brotli",
-    # but also other programs that would fall into that scheme.
-    #
-    # Brotli has an URL like this:
-    #
-    #   https://github.com/google/brotli/archive/v1.0.7/brotli-v1.0.7.tar.gz
-    #
-    # The annoying part is the very last 'v'. If you extract this archive
-    # then the resulting directory name is "brotli-1.0.7", so the folks
-    # who packaged this archive evidently are very clueless. But even
-    # aside from this, the issue is that the RBT project may have to guess
-    # and infer the correct program version, which should not include the
-    # 'v' character anyway. The following when-entry ensures precisely
-    # this: all alphabet-characters will be dropped from the program
-    # version.
-    #
-    # This entry point has been added on 30.11.2019.
-    #
-    # Note that PROGRAM_VERSION is not exactly the same, since it will
-    # ONLY modify the program version; it will NOT change the name of
-    # the program at hand.
-    #
-    # Keep in mind that the input may be incomplete, such as in the
-    # String "ninja-PROGRAM_VERSION".
-    # ======================================================================= #
-    when /^PROGRAM_NAME_AND_PROGRAM_VERSION_WITHOUT_ALPHABET$/,
-         /^PROGRAM_VERSION$/,
-         /-PROGRAM_VERSION$/
-      program_version = program_version?
-      if program_version.nil? or program_version.empty?
-        _ = remove_archive_from_the_end(File.basename(url1?.dup))
-        _.delete!('a-z')
-        _[0,1] = '' if _.start_with? '-'
-        program_version = _
-      end
-      if    i.include? 'PROGRAM_NAME_AND_PROGRAM_VERSION_WITHOUT_ALPHABET'
-        use_this_as_program_short_name = program_short_name?
-        if use_this_as_program_short_name.nil? or
-           use_this_as_program_short_name.empty?
-          use_this_as_program_short_name = ProgramInformation.return_short_name(
-            remove_archive_from_the_end(
-              File.basename(url1?.dup)
-            )
-          )
-        end
-        i.sub!(/PROGRAM_NAME_AND_PROGRAM_VERSION_WITHOUT_ALPHABET/,
-          use_this_as_program_short_name+'-'+program_version)
-      elsif i.include? 'PROGRAM_VERSION'
-        i.sub!(/PROGRAM_VERSION/, program_version)
-      end
-      i.squeeze!('.')
-    # ======================================================================= #
-    # === USE_URL_LAST_HYPHEN_IS_DOT
-    #
-    # This entry point will convert the last hyphen, aka '-', into a '.'
-    # dot. The input may be 'ImageMagick-7.0.8-27' and it will then
-    # become 'ImageMagick-7.0.8.27'.
-    # ======================================================================= #
-    when /^USE_URL_LAST_HYPHEN_IS_DOT$/
-      _ = File.basename(url1?)
-      i = remove_archive_from_the_end(_)
-      i = i.reverse.sub(/-/,'.').reverse
-    # ======================================================================= #
-    # === FIRST_UNDERSCORE_AS_HYPHEN_AND_OTHER_UNDERSCORES_AS_DOTS
-    #
-    # This is due to boost again - apparnetly the boost developers make
-    # use of a very strange packaging schemata.
-    #
-    # So this entry point will convert input such as 'boost_1_61_0' into
-    # 'boost-1.61.0'.
-    # ======================================================================= #
-    when 'FIRST_UNDERSCORE_AS_HYPHEN_AND_OTHER_UNDERSCORES_AS_DOTS'
-      i = return_first_underscore_as_hyphen_and_other_undscores_as_dots(url)
-    # ======================================================================= #
-    # === FIRST_DOT_AS_HYPHEN
-    #
-    # The following case is for input such as "sendmail.5.2.18"
-    # which should become "sendmail-5.2.18".
-    #
-    # We only manipulate the last part though, so if we have input that
-    # contains a '/', we assume that this is a path and split it up.
-    # This is the reason why we will use File.basename()
-    # ======================================================================= #
-    when 'FIRST_DOT_AS_HYPHEN'
-      i = return_first_dot_as_hyphen_from_this_url(url)
-    # ======================================================================= #
-    # === URL_REPLACE_UNDERSCORE
-    #
-    # This entry point handles the case when the input has '_' characters
-    # in the String. If this is the case then all '_' will be replaced
-    # via '-' characters.
-    # ======================================================================= #
-    when 'URL_REPLACE_UNDERSCORE',
-         'URL_CONVERT_UNDERSCORE',
-         'USE_URL_SANITIZED',
-         'REPLACE_UNDERSCORES',
-         'USE_URL_MIDDLE_HYPHENS'
-      i = return_url_replace_underscore(url)
-    # ======================================================================= #
-    # === USE_URL_DOWNCASE
-    #
-    # Use the URL as program name but downcase it.
-    # ======================================================================= #
-    when 'USE_URL_DOWNCASE',
-         'USE_DOWNCASED'
-      i = url.downcase
-    # ======================================================================= #
-    # === USE_URL
-    #
-    # Simply use the URL as-is, for the program name.
-    # ======================================================================= #
-    when 'USE_URL'
-      i = url
-    else
+  def sync_use_this_build_system_onto_the_main_hash
+    _ = use_this_build_system?
+    _ = '' if _.nil?
+    if _ and _.is_a?(String) and _.empty?
       # ===================================================================== #
-      # Handle github-specific links next.
+      # Must set a new default value in this case.
       # ===================================================================== #
-      if is_github_url? and
-         i.start_with?('v-') and
-         (i =~ /v-\d{0,2}.\d{1,2}.\d{1,2}/) # See: http://rubular.com/r/tWF7ikLZiw
-        # =================================================================== #
-        # Ok, we now know that the input is something like 'v-1.11.0'.
-        # We must thus sanitize several parts of the dataset.
-        # =================================================================== #
-        if short_name? == 'v' # ← This must evidently be replaced then.
-          set_short_name(
-            search_for_this_program?.dup, :also_set_other_names
-          )
-          set_program_name
-          set_base_dir
-          i = program_name?
-        end
-      end
+      _ = :default # This means to infer the build system in use.
     end
-    # ======================================================================= #
-    # Get rid of any .tar.xz or similar archive end here.
-    # ======================================================================= #
-    i = remove_archive_from_the_end(i)
-    return i
-  end
+    set_use_this_build_system(_)
+  end; alias sanitize_use_this_build_system sync_use_this_build_system_onto_the_main_hash # === sanitize_use_this_build_system
 
   # ========================================================================= #
-  # === sanitize_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 /.
+  # === sync_symlink_headers_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_prefix
-    # ======================================================================= #
-    # General way to overrule the prefix setting in this case.
-    # ======================================================================= #
-    if COMPILE_EVERYTHING_INTO_STANDALONE_DIRECTORY
-      _ = 't'
-    end
-    # ======================================================================= #
-    # We need to use .to_s because the prefix can be a boolean value as
-    # well, such as true or false.
-    # ======================================================================= #
-    _ = prefix?.to_s.dup
-    # ======================================================================= #
-    # 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.
-    # ======================================================================= #
-    _ = substitute_macros(_).dup
-    case _
-    when 't','true','yes','y','traditional'
-      _ = '/usr/'
-    when 'f','false','no','AppDir',
-         'return_appdir_path','appdir_path'
-      _ = return_appdir_prefix.dup # ← This is the AppDir variant.
+  def sync_symlink_headers_onto_the_main_hash
+    _ = raw_cookbook?.symlink_headers?
+    if _.nil?
+      _ = symlink_headers?
     end
-    # ======================================================================= #
-    # Append '/' unless we already have a trailing '/'.
-    # ======================================================================= #
-    _ << '/' unless _.end_with? '/'
-    _.sub!(/ULOCAL/,'/usr/local') if _.include? 'ULOCAL' # ULOCAL gets expanded to /usr/local
-    _.sub!(/ULOC/,  '/usr/local') if _.include? 'ULOC'   # same counts for ULOC
-    # ======================================================================= #
-    # We used to delete '-' here in the past, but as of Sep 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.
-    # ======================================================================= #
-    # _.delete!('-') if _.include? '-'
-    set_prefix(_)
+    set_symlink_headers(to_bool(_))
   end
 
   # ========================================================================= #
-  # === sanitize_program_name
-  #
-  # This method can be used to sanitize the program_name entry.
-  #
-  # The program_name entry is something such as ''gnome-mahjongg' -
-  # thus, it does not include a version.
+  # === sync_symlink_pkgconfig_files_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_program_name
-    set_program_name(
-      return_sanitized_program_name_and_program_version(
-        program_name?.dup
-      )
-    ) # And set the new variant.
+  def sync_symlink_pkgconfig_files_onto_the_main_hash
+    _ = raw_cookbook?.symlink_pkgconfig_files?
+    if _.nil?
+      _ = symlink_pkgconfig_files?
+    end
+    set_symlink_pkgconfig_files(to_bool(_))
   end
 
   # ========================================================================= #
-  # === return_first_underscore_as_hyphen_from_this_url
+  # === sync_localstatedir_onto_the_main_hash
   # ========================================================================= #
-  def return_first_underscore_as_hyphen_from_this_url(i = url1?)
-    new_url = File.basename(i).dup # Obtain the URL here.
-    new_url.sub!(/_/,'-') # This replaces only the first '_' found.
-    return remove_archive_from_the_end(new_url)
+  def sync_localstatedir_onto_the_main_hash
+    _ = @raw_cookbook.localstatedir?.to_s
+    if _ and _.empty?
+      _ = localstatedir?.to_s
+    end
+    set_localstatedir(to_bool(_))
   end
 
   # ========================================================================= #
-  # === sanitize_env_variables
-  #
-  # This will sanitize ENV variables. The ENV variables must be a Hash
-  # at all times.
+  # === sync_do_not_download_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_env_variables
-    _ = 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
-      }
-      set_env_variables(hash)
+  def sync_do_not_download_onto_the_main_hash
+    _ = @raw_cookbook.do_not_download?
+    if _.nil?
+      _ = do_not_download?
     end
+    set_do_not_download(to_bool(_))
   end
 
   # ========================================================================= #
-  # === sanitize_program_path
-  # ========================================================================= #
-  def sanitize_program_path
-    reassemble_program_path
-  end; alias rebuild_path sanitize_program_path # === rebuild_path
-
-  # ========================================================================= #
-  # === sync_archive_type_entries
-  #
-  # This method will sync archive-type entries.
+  # === sync_build_static_onto_the_main_hash
   # ========================================================================= #
-  def sync_archive_type_entries
-    reassemble_program_full_name
-    reassemble_program_path
+  def sync_build_static_onto_the_main_hash
+    _ = @raw_cookbook.build_static?
+    if _.nil?
+      _ = build_static?
+    end
+    set_build_static(to_bool(_))
   end
 
   # ========================================================================= #
-  # === try_to_guess_the_program_path_based_on_the_program_name_and_program_version
+  # === sync_run_configure_onto_the_main_hash
   # ========================================================================= #
-  def try_to_guess_the_program_path_based_on_the_program_name_and_program_version
-    _ = base_dir?+
-        program_name_and_program_version?+
-        archive_type?
-    if File.exist? _
-      set_program_path(_)
+  def sync_run_configure_onto_the_main_hash
+    _ = raw_cookbook?.run_configure?
+    if _.nil?
+      _ = run_configure?
     end
-  end
+    if _ and _.is_a?(String) and _.empty?
+      _ = run_configure?.to_s
+    end
+    _ = to_bool(_)
+    _ = false if _.nil?
+    set_run_configure(_)
+  end; alias sanitize_run_configure sync_run_configure_onto_the_main_hash # === sanitize_run_configure
 
   # ========================================================================= #
-  # === sanitize_headers                                        (headers tag)
+  # === sync_apply_patch_onto_the_main_hash
   #
-  # This method was added in May 2014.
-  #
-  # The headers entry must be kept as an Array at all times, according
-  # to the specification.
+  # Here we sanitize the value for apply_patch. tiff.yml may be an example
+  # for how to use this setting.
   # ========================================================================= #
-  def sanitize_headers
-    _ = headers?
-    if _.is_a? Array
-      if _.first.include? ','
-        _ = _.first.split(',')
-      end if _.first
+  def sync_apply_patch_onto_the_main_hash
+    _ = @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
-    if _.is_a? String
-      _ = _.to_s.strip
-      _ = _.split(',') if _.include? ','
-      _ = nil if _.empty?
+    set_apply_patch(_)
+  end; alias sanitize_apply_patch sync_apply_patch_onto_the_main_hash # === sanitize_apply_patch
+
+  # ========================================================================= #
+  # === sync_may_we_modify_the_configure_options_onto_the_main_hash
+  # ========================================================================= #
+  def sync_may_we_modify_the_configure_options_onto_the_main_hash
+    _ = @raw_cookbook.may_we_modify_the_configure_options?.to_s
+    if _ and _.empty?
+      _ = may_we_modify_the_configure_options?.to_s
     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(_)
+    set_may_we_modify_the_configure_options(to_bool(_))
   end
 
   # ========================================================================= #
-  # === return_middle_part_of_the_program_version
+  # === sync_modify_the_makefile_onto_the_main_hash
   # ========================================================================= #
-  def return_middle_part_of_the_program_version
-    result = program_version?.dup
-    if result.include? '.'
-      result = result.split('.')[1]
+  def sync_modify_the_makefile_onto_the_main_hash
+    _ = @raw_cookbook.modify_the_makefile?
+    if _.nil? or ( _.is_a?(String) and _.empty? )
+      _ = false # This is the default value.
     end
-    return result
+    set_modify_the_makefile(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
-  #
+  # === sync_md5sum_value_onto_the_main_hash
   # ========================================================================= #
-  def sanitize_postinstall
-    _ = [postinstall?].flatten.compact # Get rid of nil values.
-    unless _.empty?
-      if _.is_a? Array
-        _.map! {|entry| substitute_macros(entry) }
-      end
-      _.gsub!(/#{N}/,',') if _.include?(N) # Replace newlines with ',' char.
-      # ===================================================================== #
-      # Replace universal targets with real targets.
-      # ===================================================================== #
-      case prefix?
-      when false # Yup. Only one option for false..
-        point_to_libraries   = syslib_directory?
-        point_to_binaries    = sysbin_directories?
-        point_to_includes    = '/System/Index/include/'
-        point_to_program_dir = rds( # Remove double slashes.
-          programs_dir?+
-          short_name?.to_s.capitalize+'/'+
-          program_version?.to_s+'/bin'
-        )
-      # ===================================================================== #
-      # === :FHS
-      # ===================================================================== #
-      when true,
-           :FHS
-        # =================================================================== #
-        # FHS installation method comes here. It will defaults to /usr/bin.
-        # It also includes true of course.
-        # =================================================================== #
-        point_to_libraries   = '/usr/lib'
-        point_to_binaries    = '/usr/bin'
-        point_to_includes    = '/usr/include'
-        point_to_program_dir = point_to_binaries
-      else
-        point_to_libraries   = prefix?+'lib'
-        point_to_binaries    = prefix?+'bin' # For example, /Programs/Glib/2.40.0/bin/
-        point_to_includes    = prefix?+'include'
-        point_to_program_dir = point_to_binaries
-      end
-      # ===================================================================== #
-      # Turn it into an Array for sure:
-      # ===================================================================== #
-      _ = [_].flatten.compact
-      # ===================================================================== #
-      # Sanitize the @postinstall variable next.
-      # ===================================================================== #
-      if _.is_a? Array
-        _.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.
+  def sync_md5sum_value_onto_the_main_hash
+    _ = @raw_cookbook.md5sum?
+    if _.nil?
+      _ = md5sum?
+      if _.nil?
+        _ = `md5sum #{program_path?}` if File.exist? program_path?
       end
     end
-    unless postinstall?.is_a? Array
-      _ = rds(postinstall?)
-      _ = _.split(',') if _.include? ','
-      set_postinstall [_].flatten
-    end
+    set_md5sum(_)
+  end
+
+  # ========================================================================= #
+  # === sync_everything                    (sync tag, sanitize tag, sani tag)
+  #  
+  # This is the method that will sync and sanitize the whole internal
+  # dataset, which is typically deriving from a yaml-based dataset,
+  # via class RawCookbook.
+  #
+  # Some entries have to come in a specific order, since they depend on
+  # prior values that were already set correctly.
+  # ========================================================================= #
+  def sync_everything
+    sync_url1_onto_the_main_hash # This must come before we sync program-name-and-program-version.
+    sync_url2_onto_the_main_hash
+    sync_program_name_and_program_version_onto_the_main_hash
+    sync_homepage_onto_the_main_hash
+    sync_extract_to_onto_the_main_hash
+    sync_extra_information_onto_the_main_hash
+    sync_md5sum_onto_the_main_hash
+    sync_required_deps_on_onto_the_main_hash
+    sync_blfs_entry_onto_the_main_hash
+    sync_short_name_onto_the_main_hash
+    sync_description_onto_the_main_hash
+    sync_binaries_onto_the_main_hash
+    sync_last_update_entry_onto_the_main_hash
+    sync_env_variables_onto_the_main_hash
+    sync_required_deps_onto_the_main_hash
+    sync_has_to_be_compiled_onto_the_main_hash
+    sync_short_description_onto_the_main_hash
+    sync_pre_configure_steps_onto_the_main_hash
+    sync_is_an_active_project_onto_the_main_hash
+    sync_build_static_onto_the_main_hash
+    sync_can_be_compiled_statically_onto_the_main_hash
+    sync_keep_extracted_onto_the_main_hash
+    sync_program_version_onto_the_main_hash
+    sync_apply_patch_onto_the_main_hash
+    # ======================================================================= #
+    # === Sanitize the Prefix
+    #
+    # The prefix setting can only be sanitized after the program_version
+    # has been sanitized, since the actual prefix may depend on the
+    # program version in use, such as for AppDirs.
+    # ======================================================================= #
+    sync_prefix_onto_the_main_hash # Must come BEFORE we sanitize the post-installation step.
+    # ======================================================================= #
+    # === Clean up post-install related activities
+    #
+    # The clean-up of post-install related activities should only be
+    # called after the prefix was already defined, since a few
+    # internal-parts of the method sync_postinstall_onto_the_main_hash
+    # may need to know the real prefix in use.
+    # ======================================================================= #
+    sync_postinstall_onto_the_main_hash
+    sync_sed_entry_onto_the_main_hash
+    sync_headers_onto_the_main_hash
+    sync_libraries_onto_the_main_hash
+    sync_binaries_onto_the_main_hash
+    sync_configure_command_to_use_onto_the_main_hash
+    sync_configure_options_onto_the_main_hash
+    sync_meson_configure_options_onto_the_main_hash
+    sync_cmake_configure_options_onto_the_main_hash
+    sync_configure_options_explained_onto_the_main_hash
+    sync_installation_steps_onto_the_main_hash
+    sync_gir_files_onto_the_main_hash
+    sync_tags_onto_the_main_hash
+    sync_licence_onto_the_main_hash
+    sync_autogen_onto_the_main_hash
+    sync_use_autoconf_onto_the_main_hash
+    sync_last_update_onto_the_main_hash
+    sync_pre_make_commands_onto_the_main_hash
+    sync_description_onto_the_main_hash
+    sync_extra_information_onto_the_main_hash
+    sync_parameters_to_make_onto_the_main_hash
+    sync_preinstall_onto_the_main_hash
+    sync_git_url_onto_the_main_hash
+    sync_use_this_make_command_onto_the_main_hash
+    sync_use_this_program_name_on_gobolinux_onto_the_main_hash
+    sync_pkgconfig_files_onto_the_main_hash
+    sync_symlink_pkgconfig_files_onto_the_main_hash
+    sync_symlink_headers_onto_the_main_hash
+    sync_run_configure_onto_the_main_hash
+    sync_autosymlink_lib64_onto_the_main_hash
+    sync_do_not_symlink_onto_the_main_hash
+    sync_echo_yes_onto_the_main_hash
+    sync_enable_shared_onto_the_main_hash
+    sync_enable_static_onto_the_main_hash
+    sync_flatpak_url_onto_the_main_hash
+    sync_libexec_onto_the_main_hash
+    sync_m4_files_onto_the_main_hash
+    sync_mirror_onto_the_main_hash
+    sync_symlink_glib_schema_onto_the_main_hash
+    sync_use_this_make_install_command_onto_the_main_hash
+    sync_wikipedia_onto_the_main_hash
+    sync_configure_base_dir_onto_the_main_hash
+    sync_base_dir_onto_the_main_hash
+    sync_svn_url_onto_the_main_hash
+    sync_use_build_directory_onto_the_main_hash
+    sync_use_this_build_directory_onto_the_main_hash
+    sync_use_this_build_system_onto_the_main_hash
+    sync_localstatedir_onto_the_main_hash
+    sync_do_not_download_onto_the_main_hash
+    sync_may_we_modify_the_configure_options_onto_the_main_hash
+    sync_modify_the_makefile_onto_the_main_hash
+    sync_md5sum_value_onto_the_main_hash
+    # ======================================================================= #
+    # Last but not least, find out the file size of the program in question.
+    # ======================================================================= #
+    calculate_archive_size
+    calculate_md5sum if shall_we_display_the_md5sum?
   end
 
 end; end; end