rbt 0.13.42 → 0.15.1

data/lib/rbt/{cookbooks → actions/individual_actions/cookbooks}/sanitize_cookbook/sanitize_cookbook.rb

@@ -2,14 +2,14 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# === RBT::Cookbooks::SanitizeCookbook
+# === RBT::Action::Cookbooks::SanitizeCookbook
 #
 # From holding the dataset of a specific cookbook at hand, over to
 # displaying said dataset - this is the class to go for.
 #
 # This class builds on the data made available via
-# RBT::Cookbooks::RawCookbook, and turns the dataset
-# of RBT::Cookbooks::RawCookbook into a "full" dataset,
+# RBT::Action::Cookbooks::RawCookbook, and turns the dataset
+# of RBT::Action::Cookbooks::RawCookbook into a "full" dataset,
 # that is, one that is completely sanitized, and ready
 # made for storing it into a new .yml file.
 #
@@ -20,14 +20,14 @@
 # the expanded dataset instead.
 #
 # The idea here is that we can use (and maintain) a minimal dataset
-# via class RBT::Cookbooks::RawCookbook, while providing a more useful
-# dataset via class RBT::Cookbooks::SanitizeCookbook. Note that class
-# RBT::Cookbooks::SanitizeCookbook has to ensure that certain values
+# via class RBT::Action::Cookbooks::RawCookbook, while providing a more useful
+# dataset via class RBT::Action::Cookbooks::SanitizeCookbook. Note that class
+# RBT::Action::Cookbooks::SanitizeCookbook has to ensure that certain values
 # are set to their default (and thus correct) values. The code in
 # this file here ensures precisely ensures this.
 #
 # The obtain() method is used specifically by class
-# RBT::Cookbooks::SanitizeCookbook for query-related
+# RBT::Action::Cookbooks::SanitizeCookbook for query-related
 # methods, and queries in general.
 #
 # Every source archive has different components which have to be
@@ -61,51 +61,202 @@
 #
 # Usage example:
 #
-#   RBT::Cookbooks::SanitizeCookbook.new(ARGV)
+#   RBT::Action::Cookbooks::SanitizeCookbook.new(ARGV)
 #
 # =========================================================================== #
-# require 'rbt/cookbooks/sanitize_cookbook/sanitize_cookbook.rb'
+# require 'rbt/actions/individual_actions/cookbooks/sanitize_cookbook/sanitize_cookbook.rb'
+# RBT::Action::Cookbooks::SanitizeCookbook.new(ARGV)
+# RBT.sanitize_cookbook(ARGV)
 # =========================================================================== #
-require 'rbt/base/base.rb'
+require 'rbt/actions/action.rb'
 
 module RBT
 
+class Action
+
 module Cookbooks
 
-class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
+class SanitizeCookbook < RBT::Action # === RBT::Action::Cookbooks::SanitizeCookbook
+
+  # ========================================================================= #
+  # === HOW_TO_INVOKE_THE_PROGRAM
+  # ========================================================================= #
+  HOW_TO_INVOKE_THE_PROGRAM = 'scookie'
+
+  # ========================================================================= #
+  # === DEFAULT_PROGRAM_VERSION
+  # ========================================================================= #
+  DEFAULT_PROGRAM_VERSION = '1.0.0'
+
+  # ========================================================================= #
+  # === REPLACE_PLUS_WITH_LONG_NAME
+  #
+  # If this constant is true then we will replace '+' with 'plus'
+  # if they are part of a program name.
+  # ========================================================================= #
+  REPLACE_PLUS_WITH_LONG_NAME = false
+
+  # ========================================================================= #
+  # === ARRAY_ARRAY_ENTRIES                                       (array tag)
+  #
+  # These entries should be kept as an Array at all time. They will all
+  # allow us to run .each on them.
+  #
+  # In "pure" ruby code, these would all be set to e. g. "xyz = []", so
+  # really just an Array of Arrays.
+  # ========================================================================= #
+  ARRAY_ARRAY_ENTRIES = %w(
+    blfs
+    binaries
+    gir_files
+    headers
+    installation_steps
+    libraries
+    m4_files
+    pkgconfig_files
+    postinstall
+    pre_configure_steps
+    pre_make_commands
+    pre_make_install_sed
+    required_deps_on
+    tags
+  )
+
+  # ========================================================================= #
+  # === ARRAY_NIL_ENTRIES                                           (nil tag)
+  #
+  # All entries that are nil by default.
+  #
+  # These are entries where a default value is not absolutely necessary.
+  # ========================================================================= #
+  ARRAY_NIL_ENTRIES = %w(
+    short_description
+    set_env_variables
+    homepage
+    meson_configure_options
+    cmake_configure_options
+    svn_url
+    git_url
+    program_name_and_program_version
+    use_this_build_system
+  )
+
+  # ========================================================================= #
+  # === ARRAY_TRUE_VALUES                                          (true tag)
+  #
+  # Only a few variables are true for now, by default - prefix,
+  # run_ldconfig and has_to_be_compiled at the very least.
+  # ========================================================================= #
+  ARRAY_TRUE_VALUES = %w(
+    is_an_active_project
+    has_to_be_compiled
+    may_we_modify_the_configure_options
+    prefix
+    run_configure
+    run_ldconfig
+    run_make
+  )
+
+  # ========================================================================= #
+  # === ARRAY_FALSE_VALUES                                        (false tag)
+  #
+  # This constant collects all values that must be explicitely set to
+  # false on startup.
+  # ========================================================================= #
+  ARRAY_FALSE_VALUES = %w(
+    apply_patch
+    autosymlink_lib64
+    build_static
+    can_be_compiled_statically
+    copy_source
+    do_not_symlink
+    do_not_download
+    echo_yes
+    enable_shared
+    enable_static
+    ignore_errors
+    keep_extracted
+    localstatedir
+    mirror
+    modify_the_makefile
+    override
+    run_make_check
+    sed
+    symlink_glib_schema
+    symlink_headers
+    symlink_pkgconfig_files
+    use_autoconf
+    use_autogen
+    use_build_directory
+    use_glib_schema
+    use_this_make_install_command
+  )
+
+  # ========================================================================= #
+  # === ARRAY_MAIN_PROGRAM_ENTRIES
+  #
+  # We need the following 8 entries defined here, so that we do not
+  # forget them lateron.
+  #
+  # These are the only entries we care about and describe the most
+  # important components of a program.
+  # ========================================================================= #
+  ARRAY_MAIN_PROGRAM_ENTRIES = %w(
+    archive_type
+    base_dir
+    program_full_name
+    program_name
+    program_path
+    program_version
+    real_short_name
+    short_name
+  )
 
-  require 'rbt/requires/require_the_raw_cookbook.rb'
-  require 'rbt/toplevel_methods/remove_archive_from_the_end_or_file_extension.rb'
-  require 'rbt/cookbooks/sanitize_cookbook/constants.rb'
-  require 'rbt/cookbooks/sanitize_cookbook/obtain.rb'
+  # ========================================================================= #
+  # === ARRAY_EMPTY_VALUES
+  #
+  # All values that will be initialized by default to an empty string,
+  # aka '', have to be registered here.
+  # ========================================================================= #
+  ARRAY_EMPTY_VALUES = %w(
+    program_path
+    program_full_name
+    configure_options
+    configure_base_dir
+    configure_command_to_use
+    flatpak_url
+    licence
+    manual_steps
+    md5sum
+    optional_start_message
+    parameters_to_make
+    preinstall
+    program_version
+    use_this_build_directory
+    use_this_make_command
+    url1
+    program_compile_name
+    extract_to
+  )
 
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
   def initialize(
-      commandline_arguments = nil,
-      run_already           = true
+      i           = ARGV,
+      run_already = true,
+      &block
     )
     reset
-    case commandline_arguments
+    case i
     # ======================================================================= #
     # === :do_not_run_yet
     # ======================================================================= #
     when :do_not_run_yet
       run_already = false
-      commandline_arguments = []
-    end
-    set_commandline_arguments(
-      commandline_arguments
-    )
-    case run_already
-    # ======================================================================= #
-    # === :do_not_run_yet
-    # ======================================================================= #
-    when :do_not_run_yet,
-         :dont_run_yet
-      run_already = false
+      i = []
     end
+    set_commandline_arguments(i)
     # ======================================================================= #
     # === Handle blocks next
     # ======================================================================= #
@@ -117,6 +268,12 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       if yielded.is_a? Symbol
         case yielded
         # =================================================================== #
+        # === :do_not_instantiate_a_new_raw_cookbook
+        # =================================================================== #
+        when :do_not_instantiate_a_new_raw_cookbook
+          set_simple
+          do_not_instantiate_a_new_raw_cookbook
+        # =================================================================== #
         # === :do_not_run_yet
         # =================================================================== #
         when :do_not_run_yet,
@@ -140,6 +297,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
         when :be_fast_and_be_quiet,
              :complex,
              :use_expanded_dataset,
+             :expanded,
              :default
           set_be_quiet
           set_simple_or_complex(:complex)
@@ -167,10 +325,10 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
           # remain, though.
           # ================================================================= #
           if yielded.is_a? Symbol
-            opne "Unknown symbol called "\
-                 "#{sfancy(':')}#{sfancy(yielded.to_s)} passed."
+            opne "#{rev}Unknown symbol called "\
+                 "#{sfancy(':')}#{sfancy(yielded.to_s)} #{rev}passed."
             opne 'Showing the very important '+tomato('caller()')+
-                 ' backtrace next:'
+                 "#{rev} backtrace next:"
             e
             cliner; pp caller(); cliner
             e
@@ -207,11 +365,11 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   def reset
     super()
     infer_the_namespace
+    initialize_the_internal_hash
     # ======================================================================= #
     # === :use_colours
     # ======================================================================= #
     set_use_colours
-    initialize_the_internal_hash
   end
 
   # ========================================================================= #
@@ -282,6 +440,10 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     # ======================================================================= #
     @internal_hash[:found] = false
     # ======================================================================= #
+    # === :autogenerate_expanded_dataset
+    # ======================================================================= #
+    @internal_hash[:autogenerate_expanded_dataset] = false
+    # ======================================================================= #
     # === :make_use_of_aliases_kept_in_the_file_cookbook_aliases
     #
     # Next, determine whether to use cookbook-internal aliases or whether
@@ -301,12 +463,74 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     # ======================================================================= #
     @internal_hash[:array_show_these_entries] = []
     # ======================================================================= #
+    # === :may_we_instantiate_a_new_raw_cookbook
+    #
+    # This variable can be used to instantiate a new raw-cookbook. This
+    # is the default behaviour, but sometimes we may not want to do so,
+    # and instead supply our own dataset, which is why this variable
+    # exists.
+    # ======================================================================= #
+    @internal_hash[:may_we_instantiate_a_new_raw_cookbook] = true
+    # ======================================================================= #
     # === :simple_or_complex
     # ======================================================================= #
     # @internal_hash[:simple_or_complex] = :simple
     set_simple_or_complex(:default) # Set it once on startup.
   end; alias reset_the_internal_hash initialize_the_internal_hash # === reset_the_internal_hash
 
+  # ========================================================================= #
+  # === set_url1
+  #
+  # This method will not do any sanitize-action on its own. It will be a
+  # pure setter-method.
+  # ========================================================================= #
+  def set_url1(i)
+    set(:url1, i)
+  end
+
+  # ========================================================================= #
+  # === set_url2
+  # ========================================================================= #
+  def set_url2(i)
+    set(:url2, i)
+  end
+
+  # ========================================================================= #
+  # === use_autogen
+  # ========================================================================= #
+  def set_use_autogen(i = true)
+    set(:use_autogen, i)
+  end; alias use_autogen= set_use_autogen # === use_autogen?
+       alias use_autogen  set_use_autogen # === set_use_autogen
+
+  # ========================================================================= #
+  # === set_last_update
+  # ========================================================================= #
+  def set_last_update(i)
+    set(:last_update, i)
+  end
+
+  # ========================================================================= #
+  # === set_manual_steps
+  # ========================================================================= #
+  def set_manual_steps(i)
+    set(:manual_steps, i)
+  end
+
+  # ========================================================================= #
+  # === set_preinstall
+  # ========================================================================= #
+  def set_preinstall(i)
+    set(:preinstall, i)
+  end; alias preinstall= set_preinstall # === preinstall=
+
+  # ========================================================================= #
+  # === set_gir_files
+  # ========================================================================= #
+  def set_gir_files(i)
+    set(:gir_files, i)
+  end
+
   # ========================================================================= #
   # === reset_the_dataset
   # ========================================================================= #
@@ -399,6 +623,15 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     set(:pkgconfig_files, i)
   end; alias pkgconfig_files= set_pkgconfig_files # === pkgconfig_files?
 
+  # ========================================================================= #
+  # === do_not_symlink?
+  #
+  # Reader method over whether we will not symlink.
+  # ========================================================================= #
+  def do_not_symlink?
+    obtain __method__.to_s.delete('?').to_sym
+  end
+
   # ========================================================================= #
   # === set_base_dir                      (base_dir tag, base dir tag, 7 tag)
   #
@@ -505,45 +738,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     set(:modify_the_makefile, i)
   end
 
-  # ========================================================================= #
-  # === set_url1
-  #
-  # This method will not do any sanitize-action on its own. It will be a
-  # pure setter-method.
-  # ========================================================================= #
-  def set_url1(i)
-    set(:url1, i)
-  end
-
-  # ========================================================================= #
-  # === set_url2
-  # ========================================================================= #
-  def set_url2(i)
-    set(:url2, i)
-  end
-
-  # ========================================================================= #
-  # === use_autogen
-  # ========================================================================= #
-  def set_use_autogen(i = true)
-    set(:use_autogen, i)
-  end; alias use_autogen= set_use_autogen # === use_autogen?
-       alias use_autogen  set_use_autogen # === set_use_autogen
-
-  # ========================================================================= #
-  # === set_last_update
-  # ========================================================================= #
-  def set_last_update(i)
-    set(:last_update, i)
-  end
-
-  # ========================================================================= #
-  # === set_manual_steps
-  # ========================================================================= #
-  def set_manual_steps(i)
-    set(:manual_steps, i)
-  end
-
   # ========================================================================= #
   # === set_seek_this_program
   #
@@ -716,6 +910,15 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   end; alias use_default_connective_token_again set_use_this_connective_token # === use_default_connective_token_again
        alias set_separator_token                set_use_this_connective_token # === set_separator_token
 
+  # ========================================================================= #
+  # === is_sanitize_cookbook?
+  #
+  # More elegant way to state that this class is indeed SanitizeCookbook.
+  # ========================================================================= #
+  def is_sanitize_cookbook?
+    true
+  end
+
   # ========================================================================= #
   # === set_use_this_build_system
   #
@@ -765,20 +968,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     @internal_hash[:original_unmodified_name] = i
   end
 
-  # ========================================================================= #
-  # === set_preinstall
-  # ========================================================================= #
-  def set_preinstall(i)
-    set(:preinstall, i)
-  end; alias preinstall= set_preinstall # === preinstall=
-
-  # ========================================================================= #
-  # === set_gir_files
-  # ========================================================================= #
-  def set_gir_files(i)
-    set(:gir_files, i)
-  end
-
   # ========================================================================= #
   # === set_program_path                                              (8 tag)
   #
@@ -831,139 +1020,524 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   end; alias program_path= set_program_path # === program_path=
 
   # ========================================================================= #
-  # === set_postinstall
+  # === set_postinstall
+  # ========================================================================= #
+  def set_postinstall(i)
+    set(:postinstall, i)
+  end; alias set_postinstallation set_postinstall # === set_postinstallation
+       alias postinstallation=    set_postinstall # === postinstallation=
+
+  # ========================================================================= #
+  # === set_archive_type                                 (archive tag, 4 tag)
+  #
+  # This method will set the 'archive_type' of a given program at hand.
+  #
+  # It is entry number (5), and may typically look like '.tar.xz', in
+  # a program like 'gnome-mahjonng-5.08.tar.xz'.
+  #
+  # Typically, archives will be kept in the .tar.xz format locally, or
+  # rather whatever the value of the DEFAULT_ARCHIVE_TYPE specifies.
+  #
+  # We need this part when we wish to assemble the program_full_name
+  # setting lateron, at entry number (6), which would then look
+  # like this: 'gnome-mahjonng-5.08.tar.xz'
+  # ========================================================================= #
+  def set_archive_type(
+      i = DEFAULT_ARCHIVE_TYPE
+    )
+    case i
+    when :infer_from_url1
+      i = File.basename(url1)
+    when nil,
+         :default,
+         'default'
+      i = DEFAULT_ARCHIVE_TYPE # Safeguard.
+    when :tar_xz
+      i = TARXZ
+    end
+    i = i.to_s.dup.downcase # Keep it downcased as well, and in String format.
+    # ======================================================================= #
+    # === Get rid of '/'
+    # ======================================================================= #
+    if i.include? '/'
+      i = File.basename(i)
+    end
+    # ======================================================================= #
+    # Do some sanitizing next.
+    # ======================================================================= #
+    i.sub!(/\.source$/,'') if i.include? '.source'
+    # ======================================================================= #
+    # If the input includes a '-' token, then something can not be right.
+    # ======================================================================= #
+    if i.include? '-'
+      i = i[(i.rindex('-')+1)..-1]
+    # ======================================================================= #
+    # Same for input containing '_'.
+    # ======================================================================= #
+    elsif i.include? '_'
+      i = i[(i.rindex('_')+1)..-1]
+    end
+    if i == 'guess'
+      i = File.basename(url?)
+    end
+    i = archive_type_of?(i) # This method must have registered all archive-types.
+    set(:archive_type, i)
+  end; alias set_archive        set_archive_type # === set_archive
+       alias set_archive_format set_archive_type # === set_archive_format
+       alias set_this_archive   set_archive_type # === set_this_archive
+       alias archive_type=      set_archive_type # === archive_type=
+
+  # ========================================================================= #
+  # === set_active_project
+  #
+  # The default assumption is that all projects are actively maintained. If
+  # this assumption is incorrect then it has to be registered in the
+  # particular .yml file, via an entry such as: "active_project: no"
+  # ========================================================================= #
+  def set_active_project(i = true)
+    set(:active_project, i)
+  end
+
+  # ========================================================================= #
+  # === set_can_be_compiled_statically
+  # ========================================================================= #
+  def set_can_be_compiled_statically(i)
+    set(:can_be_compiled_statically, i)
+  end
+
+  # ========================================================================= #
+  # === set_pre_configure_steps
+  # ========================================================================= #
+  def set_pre_configure_steps(i)
+    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  end
+
+  # ========================================================================= #
+  # === set_is_an_active_project
+  # ========================================================================= #
+  def set_is_an_active_project(i)
+    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  end
+
+  # ========================================================================= #
+  # === set_configure_options_explained
+  # ========================================================================= #
+  def set_configure_options_explained(i)
+    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  end
+
+  # ========================================================================= #
+  # === set_do_not_download
+  # ========================================================================= #
+  def set_do_not_download(i)
+    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  end
+
+  # ========================================================================= #
+  # === set_echo_yes
+  # ========================================================================= #
+  def set_echo_yes(i)
+    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  end
+
+  # ========================================================================= #
+  # === set_build_static
+  # ========================================================================= #
+  def set_build_static(i)
+    set(:build_static, i)
+  end
+
+  # ========================================================================= #
+  # === modify_the_makefile?
+  #
+  # This method will query whether RBT will modify the Makefile at hand
+  # or whether it will not. Some Makefiles have hardcoded paths which
+  # do not respect the given --prefix variant, not even DESTDIR, as
+  # far as I know. Hence, for these .yml files, we need to have a way
+  # to modify that Makefile and correct it.
+  # ========================================================================= #
+  def modify_the_makefile?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias modify_the_makefile modify_the_makefile? # === modify_the_makefile
+
+  # ========================================================================= #
+  # === run_make?
+  # ========================================================================= #
+  def run_make?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias run_make run_make? # === run_make
+
+  # ========================================================================= #
+  # === gir_files?
+  # ========================================================================= #
+  def gir_files?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias girfiles? gir_files? # === girfiles?
+       alias gir_files gir_files? # === gir_files
+
+  # ========================================================================= #
+  # === url1?
+  #
+  # This method will "hold" the "most" important URL of a program, which is 
+  # the entry called url1.
+  #
+  # Every entry of our cookbooks must have this entry available.
+  #
+  # Usage example to query the value of url1?:
+  #
+  #   puts RBT::Action::Cookbooks::SanitizeCookbook.new('htop').url1?
+  #
+  # ========================================================================= #
+  def url1?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias main_url                   url1? # === main_url
+       alias remote_url                 url1? # === remote_url
+       alias main_url?                  url1? # === main_url?
+       alias url1                       url1? # === url1
+       alias url?                       url1? # === url?
+       alias remote_url?                url1? # === remote_url?
+       alias url_to_the_source_archive? url1? # === url_to_the_source_archive?
+
+  # ========================================================================= #
+  # === symlink_glib_schema?
+  # ========================================================================= #
+  def symlink_glib_schema?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
+
+  # ========================================================================= #
+  # === use_autoconf?
+  # ========================================================================= #
+  def use_autoconf?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
+
+  # ========================================================================= #
+  # === set_env_variables?
+  #
+  # Query the environment variables that this cookbook may set.
+  # ========================================================================= #
+  def set_env_variables?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias env_variables? set_env_variables? # === env_variables?
+     # alias set_env_variables set_env_variables? # === set_env_variables
+     # ^^^ This alias would interfere with the set_env_variables() reader method.
+
+  # ========================================================================= #
+  # === build_static?
+  # ========================================================================= #
+  def build_static?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias build_static build_static? # === build_static
+
+  # ========================================================================= #
+  # === has_to_be_compiled?
+  # ========================================================================= #
+  def has_to_be_compiled?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias has_to_be_compiled                    has_to_be_compiled? # === has_to_be_compiled
+       alias does_the_program_have_to_be_compiled? has_to_be_compiled? # === does_the_program_have_to_be_compiled?
+
+  # ========================================================================= #
+  # === configure_base_dir?
+  # ========================================================================= #
+  def configure_base_dir?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias configure_base_directory? configure_base_dir? # === configure_base_directory?
+
+  # ========================================================================= #
+  # === configure_command_to_use?
+  #
+  # The specific configure command that we will use.
+  # ========================================================================= #
+  def configure_command_to_use?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias configure_command  configure_command_to_use? # === configure_command
+       alias configure_command? configure_command_to_use? # === configure_command?
+
+  # ========================================================================= #
+  # === extra_information?
+  # ========================================================================= #
+  def extra_information?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
+
+  # ========================================================================= #
+  # === program_path?
+  #
+  # This method will return the 'program_path' value, through the reader
+  # method obtain().
+  #
+  # The program_path variable has the FULL path to the archive in
+  # question, for instance:
+  #
+  #   /home/x/src/gnomemahjonng/gnome-mahjonng-5.08.tar.xz
+  #   /home/x/src/gpm/gpm-1.20.1.tar.bz2
+  #   /home/x/src/gambas3/gambas3-3.10.0.tar.xz
+  #   base_dir? ^^^^^^^^^ program_full_name? ^^^
+  #
+  # It consists of base_dir?+program_full_name?.
+  #
+  # Do note that the program_path value is the most important entry,
+  # as ALL the other information can be derived from the information
+  # stored in this variable alone.
+  # ========================================================================= #
+  def program_path?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias local_url?          program_path? # === local_url?
+       alias full_path           program_path? # === full_path
+       alias full_path?          program_path? # === full_path?
+       alias location?           program_path? # === location?
+       alias can_be_found_where? program_path? # === can_be_found_where?
+       alias stored_where?       program_path? # === stored_where?
+       alias program_path        program_path? # === program_path
+       alias path?               program_path? # === path?
+       alias path                program_path? # === path
+       alias ppath?              program_path? # === ppath?
+       alias full_program_path?  program_path? # === full_program_path?
+       alias local_path?         program_path? # === local_path?
+
+  # ========================================================================= #
+  # === svn_url?
+  # ========================================================================= #
+  def svn_url?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
+
+  # ========================================================================= #
+  # === last_update?
+  #
+  # The last_update tag keeps track over as to when that particular program
+  # was last updated.
+  # ========================================================================= #
+  def last_update?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias last_update last_update? # === last_update
+
+  # ========================================================================= #
+  # === m4_files?
+  # ========================================================================= #
+  def m4_files?
+    obtain(:m4_files)
+  end; alias m4_files m4_files? # === m4_files
+
+  # ========================================================================= #
+  # === use_this_program_name_on_gobolinux?
+  # ========================================================================= #
+  def use_this_program_name_on_gobolinux?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
+
+  # ========================================================================= #
+  # === use_autogen?
+  # ========================================================================= #
+  def use_autogen?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias use_autogen use_autogen? # === use_autogen
+
+  # ========================================================================= #
+  # === postinstall?
+  # ========================================================================= #
+  def postinstall?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias postinstallation? postinstall? # === postinstallation?
+
+  # ========================================================================= #
+  # === description?
+  #
+  # In the past raw_description? was guaranteed to return the unmodified
+  # description, including newlines.
+  #
+  # During the rewrite in April 2021, this no longer seemed necessary,
+  # as the sanitization-logic was changed.
+  # ========================================================================= #
+  def description?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias raw_description? description? # === raw_description?
+       alias raw_description  description? # === raw_description
+
+  # ========================================================================= #
+  # === pre_make_commands?
+  # ========================================================================= #
+  def pre_make_commands?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias pre_make_commands pre_make_commands? # === pre_make_commands
+
+  # ========================================================================= #
+  # === use_this_program_name
+  # ========================================================================= #
+  def use_this_program_name
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
+
+  # ========================================================================= #
+  # === git_url?
+  # ========================================================================= #
+  def git_url?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias giturl?  git_url? # === giturl?
+       alias git_URL? git_url? # === git_URL?
+
+  # ========================================================================= #
+  # === pre_configure_steps?
+  # ========================================================================= #
+  def pre_configure_steps?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
+
+  # ========================================================================= #
+  # === pkgconfig_files?
+  # ========================================================================= #
+  def pkgconfig_files?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias pkgconfig_files pkgconfig_files? # === pkgconfig_files
+
+  # ========================================================================= #
+  # === extract_to?
+  #
+  # This must return a String.
+  # ========================================================================= #
+  def extract_to?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias will_be_extracted_towards? extract_to? # === will_be_extracted_towards?
+       # alias extracted_towards?       extract_to? # === extracted_towards?
+
+  # ========================================================================= #
+  # === is_an_active_project?
+  # ========================================================================= #
+  def is_an_active_project?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias active_project  is_an_active_project? # === active_project
+       alias active_project? is_an_active_project? # === active_project?
+
+  # ========================================================================= #
+  # === archive_type?
+  #
+  # Simply query the archive type here. The archive_type is something
+  # such as ".tar.gz" or ".tar.bz2".
+  # ========================================================================= #
+  def archive_type?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias archive?      archive_type? # === archive?
+       alias archive_type  archive_type? # === archive_type
+       alias archive_name? archive_type? # === archive_name?
+
+  # ========================================================================= #
+  # === url2?
+  # ========================================================================= #
+  def url2?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
+
+  # ========================================================================= #
+  # === binaries?
+  # ========================================================================= #
+  def binaries?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias binaries binaries? # === binaries
+       alias bin?     binaries? # === bin?
+
+  # ========================================================================= #
+  # === headers?
+  # ========================================================================= #
+  def headers?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias headers headers? # === headers
+
+  # ========================================================================= #
+  # === n_headers?
   # ========================================================================= #
-  def set_postinstall(i)
-    set(:postinstall, i)
-  end; alias set_postinstallation set_postinstall # === set_postinstallation
-       alias postinstallation=    set_postinstall # === postinstallation=
+  def n_headers?
+    headers?.size
+  end
 
   # ========================================================================= #
-  # === set_archive_type                                 (archive tag, 4 tag)
-  #
-  # This method will set the 'archive_type' of a given program at hand.
-  #
-  # It is entry number (5), and may typically look like '.tar.xz', in
-  # a program like 'gnome-mahjonng-5.08.tar.xz'.
-  #
-  # Typically, archives will be kept in the .tar.xz format locally, or
-  # rather whatever the value of the DEFAULT_ARCHIVE_TYPE specifies.
+  # === base_dir?
   #
-  # We need this part when we wish to assemble the program_full_name
-  # setting lateron, at entry number (6), which would then look
-  # like this: 'gnome-mahjonng-5.08.tar.xz'
+  # This is entry (5), a simple query method. It will give us back the
+  # base directory of our program in question, such as '/home/x/src/htop/'.
   # ========================================================================= #
-  def set_archive_type(
-      i = DEFAULT_ARCHIVE_TYPE
-    )
-    case i
-    when :infer_from_url1
-      i = File.basename(url1)
-    when nil,
-         :default,
-         'default'
-      i = DEFAULT_ARCHIVE_TYPE # Safeguard.
-    when :tar_xz
-      i = TARXZ
-    end
-    i = i.to_s.dup.downcase # Keep it downcased as well, and in String format.
-    # ======================================================================= #
-    # === Get rid of '/'
-    # ======================================================================= #
-    if i.include? '/'
-      i = File.basename(i)
-    end
-    # ======================================================================= #
-    # Do some sanitizing next.
-    # ======================================================================= #
-    i.sub!(/\.source$/,'') if i.include? '.source'
-    # ======================================================================= #
-    # If the input includes a '-' token, then something can not be right.
-    # ======================================================================= #
-    if i.include? '-'
-      i = i[(i.rindex('-')+1)..-1]
-    # ======================================================================= #
-    # Same for input containing '_'.
-    # ======================================================================= #
-    elsif i.include? '_'
-      i = i[(i.rindex('_')+1)..-1]
-    end
-    if i == 'guess'
-      i = File.basename(url?)
-    end
-    i = archive_type_of?(i) # This method must have registered all archive-types.
-    set(:archive_type, i)
-  end; alias set_archive        set_archive_type # === set_archive
-       alias set_archive_format set_archive_type # === set_archive_format
-       alias set_this_archive   set_archive_type # === set_this_archive
-       alias archive_type=      set_archive_type # === archive_type=
+  def base_dir?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias base_dir base_dir? # === base_dir
 
   # ========================================================================= #
-  # === set_active_project
-  #
-  # The default assumption is that all projects are actively maintained. If
-  # this assumption is incorrect then it has to be registered in the
-  # particular .yml file, via an entry such as: "active_project: no"
+  # === replace_plus_with_long_name?
   # ========================================================================= #
-  def set_active_project(i = true)
-    set(:active_project, i)
+  def replace_plus_with_long_name?
+    @internal_hash[:replace_plus_with_long_name]
   end
 
   # ========================================================================= #
-  # === set_can_be_compiled_statically
+  # === mirror?
   # ========================================================================= #
-  def set_can_be_compiled_statically(i)
-    set(:can_be_compiled_statically, i)
+  def mirror?
+    obtain(__method__.to_s.delete('?').to_sym)
   end
 
   # ========================================================================= #
-  # === set_pre_configure_steps
+  # === do_not_download?
   # ========================================================================= #
-  def set_pre_configure_steps(i)
-    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  def do_not_download?
+    obtain(__method__.to_s.delete('?').to_sym)
   end
 
   # ========================================================================= #
-  # === set_symlink_pkgconfig_files
+  # === preinstall?
+  #
+  # Note that preinstall is an Array.
   # ========================================================================= #
-  def set_symlink_pkgconfig_files(i = true)
-    set(__method__.to_s.delete_prefix('set_').to_sym, i)
-  end; alias symlink_pkgconfig_files= set_symlink_pkgconfig_files # === symlink_pkgconfig_files=
+  def preinstall?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end
 
   # ========================================================================= #
-  # === set_is_an_active_project
+  # === apply_patch?
+  #
+  # Query-method as to whether we shall apply a patch or whether we
+  # shall not.
   # ========================================================================= #
-  def set_is_an_active_project(i)
-    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  def apply_patch?
+    obtain(__method__.to_s.delete('?').to_sym)
   end
 
   # ========================================================================= #
-  # === set_configure_options_explained
+  # === ignore_errors?
   # ========================================================================= #
-  def set_configure_options_explained(i)
-    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  def ignore_errors?
+    obtain(__method__.to_s.delete('?').to_sym)
   end
 
   # ========================================================================= #
-  # === set_do_not_download
+  # === use_this_build_system?
+  #
+  # This method will query as to which build-system will be used for
+  # the given program at hand.
   # ========================================================================= #
-  def set_do_not_download(i)
-    set(__method__.to_s.delete_prefix('set_').to_sym, i)
-  end
+  def use_this_build_system?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias use_this_build_system    use_this_build_system? # === use_this_build_system
+       alias use_which_build_system?  use_this_build_system? # === use_which_build_system?
+       alias build_system?            use_this_build_system? # === build_system?
+       alias build_system_to_be_used? use_this_build_system? # === build_system_to_be_used?
+       alias build_system_in_use?     use_this_build_system? # === build_system_in_use?
 
   # ========================================================================= #
-  # === set_echo_yes
+  # === cmake_configure_options?
   # ========================================================================= #
-  def set_echo_yes(i)
-    set(__method__.to_s.delete_prefix('set_').to_sym, i)
-  end
+  def cmake_configure_options?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias cmake_configure_options cmake_configure_options? # === cmake_configure_options
+       alias cmake_options?          cmake_configure_options? # === cmake_options?
 
   # ========================================================================= #
-  # === set_build_static
+  # === use_this_build_directory?
   # ========================================================================= #
-  def set_build_static(i)
-    set(:build_static, i)
-  end
+  def use_this_build_directory?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias build_dir?                   use_this_build_directory? # === build_dir?
+       alias use_this_build_directory     use_this_build_directory? # === use_this_build_directory
+       alias name_of_the_build_directory? use_this_build_directory? # === name_of_the_build_directory?
 
   # ========================================================================= #
   # === set_enable_shared
@@ -1656,10 +2230,15 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     array_show_these_entries?.flatten!
     array_display_these_entries = array_show_these_entries?
     cliner(use_this_colour_or_no_colour) {
-      e "#{rev}Feedbacking all about the program `#{mediumslateblue(program_name)}`, "\
-        "taken from the file"
-      e "`#{sfile(which_file?)}`."
+      e "#{rev}Feedbacking all about the program "\
+        "`#{mediumslateblue(program_name)}#{rev}`, "\
+        "#{rev}taken from the file"
+      e "`#{sfile(which_file?)}#{rev}`."
       e
+      # ===================================================================== #
+      # Next, use a dedicated method to display all the individual
+      # components:
+      # ===================================================================== #
       show_this_dataset_containing_which_entries_should_be_displayed(
         array_display_these_entries
       )
@@ -1684,7 +2263,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
        alias full_report                report # === full_report
 
   # ========================================================================= #
-  # === show_this_dataset_containing_which_entries_should_be_displayed
+  # === show_this_dataset_containing_which_entries_should_be_displayed (display tag)
   # ========================================================================= #
   def show_this_dataset_containing_which_entries_should_be_displayed(
       i = array_show_these_entries?
@@ -1694,16 +2273,47 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     # ======================================================================= #
     threshold_value = 68
     left_pad = '  '
-    ljust_value = 36
+    ljust_value = 43
     i.each {|this_entry|
       case this_entry # case tag
       # ===================================================================== #
+      # === extra_information
+      # ===================================================================== #
+      when :extra_information
+        # =================================================================== #
+        # === Handle extra_information
+        #
+        # Next, limit the size for extra_description. We do not want to show
+        # too much here.
+        # =================================================================== #
+        result = send_this_method_and_sanitize_arrays("#{this_entry}?").to_s
+        if self.class.honour_threshold_value?
+          if (result.size > threshold_value)
+            result = result[0, result.index("\n")].delete('"')+' [...]'
+          end
+        end
+        result.chomp!
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+          darkslateblue(result.lstrip)
+      # ===================================================================== #
+      # === description
+      #
+      # Handle the description entry here.
+      # ===================================================================== #
+      when :description
+        result = description?.chomp.rstrip
+        if (result.size > threshold_value)
+          result = result.tr("\n",' ')[0..(threshold_value-2)]+' [...]'
+        end
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+          limegreen(result.lstrip)+rev
+      # ===================================================================== #
       # === program_version
       #
       # Feedback the program-version at hand.
       # ===================================================================== #
       when :program_version
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           springgreen(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === :use_this_build_system
@@ -1711,7 +2321,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       when :use_this_build_system
         result = send_this_method_and_sanitize_arrays("#{this_entry}?").to_s.dup
         result.prepend(':') if result == 'infer_automatically'
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           mediumpurple(result)
       # ===================================================================== #
       # === homepage
@@ -1719,13 +2329,13 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # Colourize the homepage properly.
       # ===================================================================== #
       when :homepage
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           darkseagreen(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === flatpak_url
       # ===================================================================== #
       when :flatpak_url
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           mediumseagreen(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)+rev
       # ===================================================================== #
       # === .gir files
@@ -1734,7 +2344,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # exist.
       # ===================================================================== #
       when :gir_files
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           darkseagreen(
             send_this_method_and_sanitize_arrays("#{this_entry}?")
           )
@@ -1744,14 +2354,14 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       when :extract_to
         result = send_this_method_and_sanitize_arrays("#{this_entry}?").to_s
         unless result.empty?
-          e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+          e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
             cornflowerblue(result)
         end
       # ===================================================================== #
       # === program_name
       # ===================================================================== #
       when :program_name
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           mediumslateblue(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === blfs
@@ -1759,7 +2369,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       when :blfs
         result = send_this_method_and_sanitize_arrays("#{this_entry}?")
         result = result.flatten.first if result.is_a? Array
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           darkseagreen(result.to_s.delete('[]')) # .to_s to avoid nil values.
       # ===================================================================== #
       # === short_name
@@ -1767,13 +2377,13 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # Is steelblue.
       # ===================================================================== #
       when :short_name
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           steelblue(send_this_method_and_sanitize_arrays("#{this_entry}?"))
       # ===================================================================== #
       # === use_autogen
       # ===================================================================== #
       when :use_autogen
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           cadetblue(
             yes_or_no(
               send_this_method_and_sanitize_arrays("#{this_entry}?").to_s
@@ -1785,7 +2395,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # This entry point can be used to display the headers.
       # ===================================================================== #
       when :headers
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           darkseagreen(
             send_this_method_and_sanitize_arrays(this_entry.to_s+'?', 5) # ← Limit to 5 by default.
           )
@@ -1795,7 +2405,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # This entry point can be used to display the binaries.
       # ===================================================================== #
       when :binaries
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           sfancy(
             send_this_method_and_sanitize_arrays(this_entry.to_s+'?', 5) # ← Limit to 5 by default.
           )
@@ -1805,7 +2415,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # This entry point can be used to display the libraries.
       # ===================================================================== #
       when :libraries
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           sfancy(
             send_this_method_and_sanitize_arrays(this_entry.to_s+'?', 5) # ← Limit to 5 by default.
           )
@@ -1813,19 +2423,19 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # === sed
       # ===================================================================== #
       when :sed
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           mediumturquoise(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === short_description
       # ===================================================================== #
       when :short_description
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           mediumturquoise(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === run_configure
       # ===================================================================== #
       when :run_configure
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           olivedrab(
             yes_or_no(send_this_method_and_sanitize_arrays("#{this_entry}?")).to_s
           )
@@ -1833,7 +2443,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # === has_to_be_compiled
       # ===================================================================== #
       when :has_to_be_compiled
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           steelblue(
             yes_or_no(send_this_method_and_sanitize_arrays("#{this_entry}?")).to_s
           )
@@ -1841,7 +2451,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # === skip_configure
       # ===================================================================== #
       when :skip_configure
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           mediumorchid(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === archive_size
@@ -1849,45 +2459,26 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       when :archive_size,
            :file_size,
            :program_size # colourize program_size.
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           mediumorchid(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === program_compile_name
       # ===================================================================== #
       when :program_compile_name
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           mediumslateblue(send_this_method_and_sanitize_arrays("#{this_entry}?"))
       # ===================================================================== #
-      # === extra_information
-      # ===================================================================== #
-      when :extra_information
-        # =================================================================== #
-        # === Handle extra_information
-        #
-        # Next, limit the size for extra_description. We do not want to show
-        # too much here.
-        # =================================================================== #
-        result = send_this_method_and_sanitize_arrays("#{this_entry}?").to_s
-        if self.class.honour_threshold_value?
-          if (result.size > threshold_value)
-            result = result[0, result.index("\n")].delete('"')+' [...]'
-          end
-        end
-        result.chomp!
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
-          darkslateblue(result)
-      # ===================================================================== #
       # === program_path
       # ===================================================================== #
       when :program_path
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           orange(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === configure_options
       # ===================================================================== #
       when :configure_options
         unless configure_options?.empty?
-          e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+          e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
             mediumseagreen(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)+rev
         end
       # ===================================================================== #
@@ -1896,7 +2487,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       when :meson_configure_options
         if meson_configure_options?
           unless meson_configure_options.empty?
-            e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+            e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
               mediumseagreen(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)+rev
           end
         end
@@ -1904,13 +2495,13 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # === do_not_symlink
       # ===================================================================== #
       when :do_not_symlink
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           lightslategray(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === keep_extracted
       # ===================================================================== #
       when :keep_extracted
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
          seagreen(
            yes_or_no(
              send_this_method_and_sanitize_arrays("#{this_entry}?").to_s
@@ -1920,82 +2511,70 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       # === prefix
       # ===================================================================== #
       when :prefix
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           darkseagreen(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === url1
       # ===================================================================== #
       when :url1,:url2,:url3,:url4,:url5
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           sandybrown(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === pkgconfig_files
       # ===================================================================== #
       when :pkgconfig_files
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           deepskyblue(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === md5sum
       # ===================================================================== #
       when :md5sum
         if show_md5sum?
-          e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+          e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
             sfancy(send_this_method_and_sanitize_arrays("#{this_entry}?"))
         end
       # ===================================================================== #
       # === remote_url
       # ===================================================================== #
       when :remote_url
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           sfancy(send_this_method_and_sanitize_arrays("#{this_entry}?"))
       # ===================================================================== #
       # === program_full_name
       # ===================================================================== #
       when :program_full_name
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           sfancy(send_this_method_and_sanitize_arrays("#{this_entry}?"))
       # ===================================================================== #
       # === base_dir
       # ===================================================================== #
       when :base_dir
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           sfancy(send_this_method_and_sanitize_arrays("#{this_entry}?"))
       # ===================================================================== #
       # === archive_type
       # ===================================================================== #
       when :archive_type
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           sfancy(send_this_method_and_sanitize_arrays("#{this_entry}?"))
       # ===================================================================== #
-      # === description
-      #
-      # Handle the description entry here.
-      # ===================================================================== #
-      when :description
-        result = description?.chomp.rstrip
-        if (result.size > threshold_value)
-          result = result.tr("\n",' ')[0..(threshold_value-2)]+' [...]'
-        end
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
-          limegreen(result)+rev
-      # ===================================================================== #
       # === last_update
       # ===================================================================== #
       when :last_update
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           cornflowerblue(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       # ===================================================================== #
       # === mode
       # ===================================================================== #
       when :mode, :mode_in_use
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           cornflowerblue(send_this_method_and_sanitize_arrays("#{this_entry}?").to_s)
       else # else tag
            # ================================================================ #
            # Note that sfancy() is the default colour used here for the
            # else clause.
            # ================================================================ #
-        e "#{left_pad}#{this_entry}: ".ljust(ljust_value)+
+        e "#{rev}#{left_pad}#{this_entry}: ".ljust(ljust_value)+
           sfancy(send_this_method_and_sanitize_arrays("#{this_entry}?")).to_s
       end
     }
@@ -2013,52 +2592,56 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       i = first?
     )
     determine_which_program_is_sought(i)               # (1) seek this new program
-    instantiate_raw_cookbook(i)                        # (2) finally, instantiate a new raw cookbook
+    if may_we_instantiate_a_new_raw_cookbook?
+      instantiate_raw_cookbook(i)                      # (2) finally, instantiate a new raw cookbook
+    end
     populate_the_dataset_variable                      # (4) initialize the main hash properly
-    if in_simple_mode?                                 # (5) in this case, sync a lot of stuff.
-      # ===================================================================== #
-      # We use this method call because the program we are trying to find
-      # may have been modified, such as from "x11" to "libx11".
-      # ===================================================================== #
-      find_in_the_raw_cookbook(seek_this_program?)
-      ensure_that_this_hash_has_only_valid_keys(
-        raw_cookbook?.dataset?
-      )
-      # ===================================================================== #
-      # :archive_type can be set early because we can scan for the real
-      # value lateron anyway.
-      # ===================================================================== #
-      dataset?[:archive_type] = '.tar.xz'              # (6) archive_type
-      # ===================================================================== #
-      # In this case we have to do additional parsing. However had, when
-      # the .yml file contains a set-entry called program_name_and_program_version
-      # then this entry will be used rather than using url1.
-      # ===================================================================== #
-      _ = program_name_and_program_version?
-      if _ and _.is_a?(String) and !_.empty?
-        _ = ::RBT.sanitize_url1_entry(_, dataset?.merge(url1: raw_cookbook?.url1?)).dup
+    if raw_cookbook?
+      if in_simple_mode?                               # (5) in this case, sync a lot of stuff.
         # =================================================================== #
-        # In this case program_name_and_program_version exists, so we will
-        # set these parts first.
+        # We use this method call because the program we are trying to find
+        # may have been modified, such as from "x11" to "libx11".
         # =================================================================== #
-        set_program_name_and_program_version(_)
-        deduce_everything_from_the_program_name_and_program_version_downwards
-        set_program_full_name(:default)
-        set_short_name(:default)
-        set_base_dir(:default)
-        set_program_path(:default)
-        set_program_version(:infer_from_the_program_name_and_program_version)
+        find_in_the_raw_cookbook(seek_this_program?)
+        ensure_that_this_hash_has_only_valid_keys(
+          raw_cookbook?.dataset?
+        )
+        # =================================================================== #
+        # :archive_type can be set early because we can scan for the real
+        # value lateron anyway.
+        # =================================================================== #
+        dataset?[:archive_type] = '.tar.xz'              # (6) archive_type
+        # =================================================================== #
+        # In this case we have to do additional parsing. However had, when
+        # the .yml file contains a set-entry called program_name_and_program_version
+        # then this entry will be used rather than using url1.
+        # =================================================================== #
+        _ = program_name_and_program_version?
+        if _ and _.is_a?(String) and !_.empty?
+          _ = ::RBT.sanitize_url1_entry(_, dataset?.merge(url1: raw_cookbook?.url1?)).dup
+          # ================================================================= #
+          # In this case program_name_and_program_version exists, so we will
+          # set these parts first.
+          # ================================================================= #
+          set_program_name_and_program_version(_)
+          deduce_everything_from_the_program_name_and_program_version_downwards
+          set_program_full_name(:default)
+          set_short_name(:default)
+          set_base_dir(:default)
+          set_program_path(:default)
+          set_program_version(:infer_from_the_program_name_and_program_version)
+        else
+          parse_url1_and_set_all_associated_values
+        end
+        check_for_outdated_entries(dataset?)
+        sanitize_everything                              # (7) sanitize everything
+        determine_all_relevant_values_for_the_dataset_variable
       else
-        parse_url1_and_set_all_associated_values
+        # =================================================================== #
+        # else we are in complex-mode.
+        # =================================================================== #
+        copy_the_data_from_the_raw_cookbook_onto_the_main_hash
       end
-      check_for_outdated_entries(dataset?)
-      sanitize_everything                              # (7) sanitize everything
-      determine_all_relevant_values_for_the_dataset_variable
-    else
-      # ===================================================================== #
-      # else we are in complex-mode.
-      # ===================================================================== #
-      copy_the_data_from_the_raw_cookbook_onto_the_main_hash
     end
   end; alias assign_and_run                                               find_this_program # === assign_and_run
        alias assign                                                       find_this_program # === assign
@@ -2084,14 +2667,17 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   # === find_in_the_raw_cookbook
   # ========================================================================= #
   def find_in_the_raw_cookbook(
-      i = search_for_this_program?
+      i            = search_for_this_program?,
+      raw_cookbook = raw_cookbook?
     )
-    result = raw_cookbook?.find(i)
     if debug?
-      opne "Loading the dataset from the file "\
-           "`#{sfile(raw_cookbook?.file?)}`."
+      opne "#{rev}Loading the dataset from the file "\
+           "`#{sfile(raw_cookbook?.file?)}#{rev}`."
+    end
+    if raw_cookbook
+      result = raw_cookbook.find(i)
+      return result
     end
-    return result
   end; alias load_yaml_dataset_from_this_file find_in_the_raw_cookbook # === load_yaml_dataset_from_this_file
 
   # ========================================================================= #
@@ -2100,14 +2686,14 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   @honour_threshold_value = true
 
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.do_not_honour_threshold_value
+  # === RBT::Action::Cookbooks::SanitizeCookbook.do_not_honour_threshold_value
   # ========================================================================= #
   def self.do_not_honour_threshold_value
     @honour_threshold_value = false
   end
 
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.honour_threshold_value?
+  # === RBT::Action::Cookbooks::SanitizeCookbook.honour_threshold_value?
   # ========================================================================= #
   def self.honour_threshold_value?
     @honour_threshold_value
@@ -2151,19 +2737,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     end
   end
 
-  # ========================================================================= #
-  # === merge_in_the_dataset_derived_from_the_raw_cookbook
-  # ========================================================================= #
-  def merge_in_the_dataset_derived_from_the_raw_cookbook
-    # ======================================================================= #
-    # Next "copy" the dataset onto the main Hash.
-    # ======================================================================= #
-    raw_cookbook_dataset?.each_pair {|key, value|
-      key = key.to_sym
-      @internal_hash[:dataset][key] = value
-    }
-  end
-
   # ========================================================================= #
   # === array_show_these_entries?
   # ========================================================================= #
@@ -2294,7 +2867,9 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     if url1 and url1.include?('@')
       url1.tr!('@','-')
     end
-    url1 = remove_archive_at_the_end(File.basename(url1))
+    if url1
+      url1 = remove_archive_at_the_end(File.basename(url1))
+    end
     program_information = ProgramInformation.new(url1)
     set_short_name(program_information.short_name?)                                   # (1) short_name, such as 'gnomemahjongg'
     set_program_name(program_information.program_name?)                               # (2) program_name, such as 'gnome-mahjongg'
@@ -2429,44 +3004,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     set_archive_type(i)
   end
 
-  # ========================================================================= #
-  # === determine_all_relevant_values_for_the_dataset_variable
-  #
-  # This method will copy some important values from the raw-cookbook
-  # to the main @dataset variable.
-  # ========================================================================= #
-  def determine_all_relevant_values_for_the_dataset_variable
-    # ======================================================================= #
-    # Some variables are still missing, such as program_path. The
-    # specification does not include these, but we need them for
-    # class RBT::Compile, so add these next.
-    #
-    # Perhaps in the future we may also add these variables, but for
-    # the time being, these variables have to be defined next.
-    # ======================================================================= #
-    dataset?[:program_path] = base_dir?.to_s+
-                              program_name_and_program_version?.to_s+
-                              archive_type?.to_s
-    if dataset?[:program_path].nil?
-      dataset?[:program_path] = raw_cookbook?.program_path?
-    end
-    if dataset?[:program_version].nil?
-      dataset?[:program_version]   = return_program_version_from_the_raw_cookbook
-    end
-    if dataset?[:program_full_name].nil?
-      dataset?[:program_full_name] = return_default_program_full_name
-    end
-    if dataset?[:program_name].nil?
-      dataset?[:program_name]      = return_program_name_from_the_raw_cookbook
-    end
-    if dataset?[:program_name_and_program_version].nil?
-      dataset?[:program_name_and_program_version] = raw_cookbook?.program_name_and_program_version?
-    end
-    if dataset?[:keep_extracted].nil?
-      set_keep_extracted(raw_cookbook?.keep_extracted?)
-    end
-  end
-
   # ========================================================================= #
   # === feedback_version
   #
@@ -3612,6 +4149,20 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     end
   end
 
+  # ========================================================================= #
+  # === set_symlink_pkgconfig_files
+  # ========================================================================= #
+  def set_symlink_pkgconfig_files(i = true)
+    set(__method__.to_s.delete_prefix('set_').to_sym, i)
+  end; alias symlink_pkgconfig_files= set_symlink_pkgconfig_files # === symlink_pkgconfig_files=
+
+  # ========================================================================= #
+  # === symlink_pkgconfig_files?
+  # ========================================================================= #
+  def symlink_pkgconfig_files?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias symlink_pkgconfig_files symlink_pkgconfig_files? # === symlink_pkgconfig_files
+
   # ========================================================================= #
   # === sanitize_symlink_pkgconfig_files
   # ========================================================================= #
@@ -3620,7 +4171,15 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     if _.nil?
       _ = symlink_pkgconfig_files?
     end
-    set_symlink_pkgconfig_files(to_bool(_))
+    case _
+    when 't'
+      _ = 'yes'
+    when 'f'
+      _ = 'no'
+    else
+      _ = to_bool(_)
+    end
+    set_symlink_pkgconfig_files()
   end
 
   # ========================================================================= #
@@ -3822,17 +4381,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     set_use_build_directory(_)
   end
 
-  # ========================================================================= #
-  # === sanitize_symlink_headers
-  # ========================================================================= #
-  def sanitize_symlink_headers
-    _ = raw_cookbook?.symlink_headers?
-    if _.nil?
-      _ = symlink_headers?
-    end
-    set_symlink_headers(to_bool(_))
-  end
-
   # ========================================================================= #
   # === sanitize_build_static
   # ========================================================================= #
@@ -3925,8 +4473,10 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   # ========================================================================= #
   # === sanitize_url2
   # ========================================================================= #
-  def sanitize_url2
-    dataset?[:url2] = raw_cookbook?.url2?
+  def sanitize_url2(
+      url2 = raw_cookbook?.url2?
+    ) 
+    dataset?[:url2] = url2
   end
 
   # ========================================================================= #
@@ -4011,16 +4561,28 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   end
 
   # ========================================================================= #
-  # === sanitize_url1
-  #
-  # We will chop off some parts of the URL.
+  # === symlink_headers?
   # ========================================================================= #
-  def sanitize_url1(
-      i = raw_cookbook?.url1?
-    )
-    set_url1(
-      return_sanitize_url1(i)
-    )
+  def symlink_headers?
+    obtain(__method__.to_s.delete('?').to_sym)
+  end; alias symlink_headers               symlink_headers? # === symlink_headers
+       alias shall_we_symlink_the_headers? symlink_headers? # === shall_we_symlink_the_headers?
+
+  # ========================================================================= #
+  # === sanitize_symlink_headers
+  # ========================================================================= #
+  def sanitize_symlink_headers
+    _ = raw_cookbook?.symlink_headers?
+    if _.nil?
+      _ = symlink_headers?
+    end
+    case _
+    when 't'
+      _ = 'yes'
+    when 'f'
+      _ = 'no'
+    end
+    set_symlink_headers(_)
   end
 
   # ========================================================================= #
@@ -4277,13 +4839,12 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     end
   end; alias md5sum md5sum? # === md5sum
 
-  require 'rbt/utility_scripts/find_alternative_archive.rb'
   # ========================================================================= #
   # === try_to_find_another_local_file
   # ========================================================================= #
   def try_to_find_another_local_file(i)
     without_file_extension = remove_file_extension_from(i)
-    array = RBT.return_alternative_archive(without_file_extension)
+    array = action(:return_alternative_archive, without_file_extension)
     if array and !array.empty?
       first_element = array.first
       if File.exist? first_element
@@ -4555,6 +5116,15 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     determine_the_file_size # ← can happen only after the program path was determined.
   end
 
+  # ========================================================================= #
+  # === determine_the_archive_type
+  # ========================================================================= #
+  def determine_the_archive_type
+    set_archive_type(
+      dataset[:archive_type]
+    )
+  end
+
   # ========================================================================= #
   # === determine_the_file_size
   # ========================================================================= #
@@ -4813,13 +5383,13 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
         unless registered_cookbook_entries.include?(key)
           seek_this_yaml_file = "#{seek_this_program?}"
           seek_this_yaml_file << '.yml' unless seek_this_yaml_file.end_with? '.yml'
-          opne "#{swarn('Warning')} - the cookbook-file for `"\
-               "#{sfancy(seek_this_yaml_file)}`"
-          opne "(path: #{sfile(raw_cookbook?.file?)})"
-          opne "contains a key that was #{swarn('NOT')} registered. "\
-               "The name of that"
-          opne "(invalid / ignored) key is: `#{sfancy(key.to_s)}`."
-          opne "This is defined in the file "\
+          opne "#{swarn('Warning')}#{rev} - the cookbook-file for `"\
+               "#{sfancy(seek_this_yaml_file)}#{rev}`"
+          opne "(path: #{sfile(raw_cookbook?.file?)}#{rev})"
+          opne "#{rev}contains a key that was #{swarn('NOT')} #{rev}"\
+               "registered. The name of that"
+          opne "#{rev}(invalid / ignored) key is: `#{sfancy(key.to_s)}#{rev}`."
+          opne "#{rev}This is defined in the file "\
                "#{Colours.sfile('registered_cookbook_entries.yml')}"
           # ================================================================= #
           # Next, also try to find a name that is similar.
@@ -4830,7 +5400,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
             select_this_entry = registered_cookbook_entries.select {|entry|
               entry.include? key.to_s
             }.first
-            opne "Did you mean this entry instead? "\
+            opne "#{rev}Did you mean this entry instead? "\
                  "#{sfancy(select_this_entry)}"  
           end
           opne 'This is currently discouraged.'
@@ -5083,9 +5653,8 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     e
   end
 
-  require 'rbt/toplevel_methods/e.rb'
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.e
+  # === RBT::Action::Cookbooks::SanitizeCookbook.e
   # ========================================================================= #
   def self.e(i = '')
     RBT.e(i)
@@ -5317,7 +5886,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     # ======================================================================= #
     # The following method-call will toggle the proper behaviour.
     # ======================================================================= #
-    RBT::Cookbooks::SanitizeCookbook.do_not_honour_threshold_value
+    RBT::Action::Cookbooks::SanitizeCookbook.do_not_honour_threshold_value
   end
 
   # ========================================================================= #
@@ -5454,9 +6023,8 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     set_use_this_build_system(_)
   end
 
-  require 'rbt/constants/constants.rb'
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.feedback_all_available_formats
+  # === RBT::Action::Cookbooks::SanitizeCookbook.feedback_all_available_formats
   #
   # To invoke this method from the commandline, try:
   #
@@ -6219,15 +6787,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   end; alias use_this_make_command   use_this_make_command? # === use_this_make_command
        alias use_which_make_command? use_this_make_command? # === use_which_make_command?
 
-  # ========================================================================= #
-  # === do_not_symlink?
-  #
-  # Reader method over whether we will not symlink.
-  # ========================================================================= #
-  def do_not_symlink?
-    obtain __method__.to_s.delete('?').to_sym
-  end
-
   # ========================================================================= #
   # === parameters_to_make?
   # ========================================================================= #
@@ -6719,9 +7278,12 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   # Some entries have to come in a specific order, since they depend on
   # prior values that were already set correctly.
   # ========================================================================= #
-  def sanitize_everything
-    sanitize_url1 # This must come before we sync program-name-and-program-version.
-    sanitize_url2
+  def sanitize_everything(
+      url1 = raw_cookbook?.url1?,
+      url2 = raw_cookbook?.url2?
+    )
+    sanitize_url1(url1) # This must come before we sync program-name-and-program-version.
+    sanitize_url2(url2)
     sanitize_program_name_and_program_version # The program name and program version should come quite early.
     sanitize_homepage
     sanitize_wikipedia
@@ -6762,6 +7324,7 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     sanitize_sed_entry
     sanitize_the_binaries
     sanitize_the_headers
+    sanitize_symlink_headers
     sanitize_the_libraries
     sanitize_configure_command_to_use
     sanitize_configure_options
@@ -6875,28 +7438,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
        alias file_size?    archive_size? # === file_size?
        alias file_size     archive_size? # === file_size
 
-  # ========================================================================= #
-  # === menu                                                       (menu tag)
-  # ========================================================================= #
-  def menu(
-      i = commandline_arguments_with_leading_hyphens
-    )
-    if i.is_a? Array
-      i.each {|entry| menu(entry) }
-    else
-      case i
-      # ===================================================================== #
-      # === --simple
-      #
-      # --raw is an alias to this entry point.
-      # ===================================================================== #
-      when /^-?-?simple$/i,
-           /^-?-?raw$/i
-        set_simple_or_complex(:simple)
-      end
-    end
-  end
-
   # ========================================================================= #
   # === set_simple_or_complex
   # ========================================================================= #
@@ -6947,6 +7488,13 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     @internal_hash[:simple_or_complex] = i
   end
 
+  # ========================================================================= #
+  # === set_simple
+  # ========================================================================= #
+  def set_simple
+    set_simple_or_complex(:simple)
+  end
+
   # ========================================================================= #
   # === meson_or_cmake_or_configure_options?
   #
@@ -7147,7 +7695,104 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
        alias use_this_version=    set_program_version # === use_this_version=
 
   # ========================================================================= #
-  # === instantiate_raw_cookbook
+  # === do_not_autogenerate
+  # ========================================================================= #
+  def do_not_autogenerate
+    @internal_hash[:autogenerate_expanded_dataset] = false
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(
+      i = commandline_arguments_with_leading_hyphens
+    )
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    elsif i.is_a? Hash
+      # ===================================================================== #
+      # === Handle Hashes passed to menu() here
+      # ===================================================================== #
+      i.each_pair {|key, value|
+        case key
+        # =================================================================== #
+        # === :autogenerate_expanded_dataset
+        # =================================================================== #
+        when :autogenerate_expanded_dataset
+          case value
+          when true
+            @internal_hash[:autogenerate_expanded_dataset] = true
+          when false
+            @internal_hash[:autogenerate_expanded_dataset] = false
+          end
+        end 
+      }
+    else
+      case i
+      # ===================================================================== #
+      # === --no-colours
+      # ===================================================================== #
+      when /^-?-?no(-|_)?colou?rs$/i
+        disable_colours
+      # ===================================================================== #
+      # === --simple
+      #
+      # --raw is an alias to this entry point.
+      # ===================================================================== #
+      when /^-?-?simple$/i,
+           /^-?-?raw$/i
+        set_simple_or_complex(:simple)
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === determine_all_relevant_values_for_the_dataset_variable
+  #
+  # This method will copy some important values from the raw-cookbook
+  # to the main @dataset variable.
+  # ========================================================================= #
+  def determine_all_relevant_values_for_the_dataset_variable
+    # ======================================================================= #
+    # Some variables are still missing, such as program_path. The
+    # specification does not include these, but we need them for
+    # class RBT::Compile, so add these next.
+    #
+    # Perhaps in the future we may also add these variables, but for
+    # the time being, these variables have to be defined next.
+    # ======================================================================= #
+    dataset?[:program_path] = base_dir?.to_s+
+                              program_name_and_program_version?.to_s+
+                              archive_type?.to_s
+    if dataset?[:program_path].nil?
+      dataset?[:program_path] = raw_cookbook?.program_path?
+    end
+    if dataset?[:program_version].nil?
+      dataset?[:program_version]   = return_program_version_from_the_raw_cookbook
+    end
+    if dataset?[:program_full_name].nil?
+      dataset?[:program_full_name] = return_default_program_full_name
+    end
+    if dataset?[:program_name].nil?
+      dataset?[:program_name]      = return_program_name_from_the_raw_cookbook
+    end
+    if dataset?[:program_name_and_program_version].nil?
+      dataset?[:program_name_and_program_version] = raw_cookbook?.program_name_and_program_version?
+    end
+    if dataset?[:keep_extracted].nil?
+      set_keep_extracted(raw_cookbook?.keep_extracted?)
+    end
+  end
+
+  # ========================================================================= #
+  # === set_raw_cookbook
+  # ========================================================================= #
+  def set_raw_cookbook(i)
+    @internal_hash[:raw_cookbook] = i
+  end
+
+  # ========================================================================= #
+  # === instantiate_raw_cookbook                                    (raw tag)
   # ========================================================================= #
   def instantiate_raw_cookbook(
       i = seek_this_program?
@@ -7156,18 +7801,18 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     # We also have to sync the variable @simple_or_complex down onto the
     # raw-cookbooks loader.
     # ===================================================================== #
-    @internal_hash[:raw_cookbook] = RBT.raw_cookbook(i) { simple_or_complex? }
+    # @internal_hash[:raw_cookbook] = RBT.raw_cookbook(i) { simple_or_complex? }
+    @internal_hash[:raw_cookbook] = action(
+      :raw_cookbook,
+      i,
+      {
+        autogenerate_expanded_dataset: @internal_hash[:autogenerate_expanded_dataset]
+      }
+    ) { simple_or_complex? }
   end; alias initialize_raw_cookbook instantiate_raw_cookbook # === initialize_raw_cookbook
 
   # ========================================================================= #
-  # === run                                                         (run tag)
-  # ========================================================================= #
-  def run
-    find_this_program
-  end
-
-  # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.return_dataset
+  # === RBT::Action::Cookbooks::SanitizeCookbook.return_dataset
   #
   # This method will return the whole dataset for a given program at
   # hand (if it is registered). You can then use this dataset in
@@ -7180,20 +7825,20 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   #
   # Usage examples:
   #
-  #   htop_dataset = RBT::Cookbooks::SanitizeCookbook.return_dataset(:htop)
-  #   ruby_dataset = RBT::Cookbooks::SanitizeCookbook.return_dataset(:ruby)
+  #   htop_dataset = RBT::Action::Cookbooks::SanitizeCookbook.return_dataset(:htop)
+  #   ruby_dataset = RBT::Action::Cookbooks::SanitizeCookbook.return_dataset(:ruby)
   #
   # ========================================================================= #
   def self.return_dataset(
       of_this_program = :htop
     )
-    dataset = RBT::Cookbooks::SanitizeCookbook.new(of_this_program).yaml_dataset?
+    dataset = RBT::Action::Cookbooks::SanitizeCookbook.new(of_this_program).yaml_dataset?
     return dataset
   end; self.instance_eval { alias return_cookbook_dataset_for return_dataset } # === RBT::Cookbooks::Cookbook.return_cookbook_dataset_for
        self.instance_eval { alias cookbook_dataset_for        return_dataset } # === RBT::Cookbooks::Cookbook.cookbook_dataset_for
 
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.does_include?
+  # === RBT::Action::Cookbooks::SanitizeCookbook.does_include?
   # ========================================================================= #
   def self.does_include?(
       this_program,
@@ -7203,14 +7848,14 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   end
 
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.main_program_entries?
+  # === RBT::Action::Cookbooks::SanitizeCookbook.main_program_entries?
   # ========================================================================= #
   def self.main_program_entries?
     ARRAY_MAIN_PROGRAM_ENTRIES
   end
 
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.opnn
+  # === RBT::Action::Cookbooks::SanitizeCookbook.opnn
   # ========================================================================= #
   def self.opnn(i = NAMESPACE)
     if i.is_a? String
@@ -7220,14 +7865,14 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   end
 
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook.feedback_format_specification_of
+  # === RBT::Action::Cookbooks::SanitizeCookbook.feedback_format_specification_of
   #
   # This is the method that will tell us whether an entry in the cookbooks
   # settings is an Array or a String or a Hash or a Boolean value.
   #
   # Usage example:
   #
-  #   RBT::Cookbooks::SanitizeCookbook.feedback_format_specification_of :headers
+  #   RBT::Action::Cookbooks::SanitizeCookbook.feedback_format_specification_of :headers
   #
   # From the commandline:
   #
@@ -7257,7 +7902,81 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   end
 
   # ========================================================================= #
-  # === RBT::Cookbooks::SanitizeCookbook[]
+  # === may_we_instantiate_a_new_raw_cookbook?
+  # ========================================================================= #
+  def may_we_instantiate_a_new_raw_cookbook?
+    @internal_hash[:may_we_instantiate_a_new_raw_cookbook]
+  end
+
+  # ========================================================================= #
+  # === do_not_instantiate_a_new_raw_cookbook
+  # ========================================================================= #
+  def do_not_instantiate_a_new_raw_cookbook
+    @internal_hash[:may_we_instantiate_a_new_raw_cookbook] = false
+  end
+
+  # ========================================================================= #
+  # === merge_in_the_dataset_derived_from_the_raw_cookbook
+  # ========================================================================= #
+  def merge_in_the_dataset_derived_from_the_raw_cookbook(
+      dataset = raw_cookbook_dataset?
+    )
+    merge_in_this_dataset(dataset)
+  end
+
+  # ========================================================================= #
+  # === merge_in_this_dataset
+  # ========================================================================= #
+  def merge_in_this_dataset(dataset)
+    # ======================================================================= #
+    # Next "copy" the dataset onto the main Hash.
+    # ======================================================================= #
+    if dataset
+      dataset.each_pair {|key, value|
+        key = key.to_sym
+        @internal_hash[:dataset][key] = value
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === sanitize_url1
+  #
+  # We will chop off some parts of the URL.
+  # ========================================================================= #
+  def sanitize_url1(
+      i = raw_cookbook?.url1?
+    )
+    set_url1(
+      return_sanitize_url1(i)
+    )
+  end
+
+  # ========================================================================= #
+  # === do_convert_the_dataset
+  #
+  # This method will convert the raw-dataset into the sanitized dataset.
+  # ========================================================================= #
+  def do_convert_the_dataset(
+      url1 = :default,
+      url2 = :default
+    )
+    set_archive_type
+    parse_url1_and_set_all_associated_values(url1)
+    check_for_outdated_entries(dataset?)
+    sanitize_everything(url1, url2)
+    determine_all_relevant_values_for_the_dataset_variable
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    find_this_program
+  end
+
+  # ========================================================================= #
+  # === RBT::Action::Cookbooks::SanitizeCookbook[]
   # ========================================================================= #
   def self.[](i = ARGV)
     new(i)
@@ -7266,23 +7985,44 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
 end
 
 # =========================================================================== #
-# === RBT::Cookbooks.new
+# === RBT::Actions::Cookbooks.new
 #
 # Invocation examples:
 #
-#   ruby     = RBT::Cookbooks.new 'ruby'
-#   zip      = RBT::Cookbooks.new 'zip'
-#   xxf86dga = RBT::Cookbooks.new 'xxf86dga'
+#   ruby     = RBT::Actions::Cookbooks.new 'ruby'
+#   zip      = RBT::Actions::Cookbooks.new 'zip'
+#   xxf86dga = RBT::Actions::Cookbooks.new 'xxf86dga'
 #
 # =========================================================================== #
 def self.new(i = 'htop')
-  ::RBT::Cookbooks::SanitizeCookbook.new(i)
+  RBT::Action::Cookbooks::SanitizeCookbook.new(i)
 end; self.instance_eval { alias []                 new } # === RBT::Cookbooks[]
      self.instance_eval { alias load_this_cookbook new } # === RBT::Cookbooks.load_this_cookbook
      self.instance_eval { alias cookbook           new } # === RBT::Cookbooks.cookbook
 
 end
 
+end
+
+# =========================================================================== #
+# === RBT.return_cookbook_for
+#
+# This is an easier toplevel method to create a new cookbook-instance.
+# Use with care, though.
+# =========================================================================== #
+def self.return_cookbook_for(
+    i = :lua,
+    &block
+  )
+  if block_given?
+    return RBT::Action::Cookbooks::SanitizeCookbook.new(i, &block)
+  else
+    return RBT::Action::Cookbooks::SanitizeCookbook.new(i) { :fast }
+  end
+end; self.instance_eval { alias load_this_cookbook return_cookbook_for } # === RBT.load_this_cookbook
+     self.instance_eval { alias cookbook           return_cookbook_for } # === RBT.cookbook
+     self.instance_eval { alias cookbook_for       return_cookbook_for } # === RBT.cookbook_for
+
 # =========================================================================== #
 # === RBT.return_description_of
 #
@@ -7295,12 +8035,12 @@ end
 # =========================================================================== #
 def self.return_description_of(i)
   i = i.first if i.is_a? Array
-  _ = RBT::Cookbooks::SanitizeCookbook.new(i)
+  _ = RBT::Action::Cookbooks::SanitizeCookbook.new(i)
   return _.description?.to_s
 end; self.instance_eval { alias return_description_of? return_description_of } # === RBT.return_description_of?
 
 # =========================================================================== #
-# === RBT.feedback_description_of
+# === RBT.feedback_description_of_via_sanitize_cookbook
 #
 # Delegate towards the method .feedback_description_of().
 #
@@ -7309,11 +8049,11 @@ end; self.instance_eval { alias return_description_of? return_description_of } #
 #   RBT.feedback_description_of(:htop)
 #
 # =========================================================================== #
-def self.feedback_description_of(i)
+def self.feedback_description_of_via_sanitize_cookbook(i)
   i = i.first if i.is_a? Array
-  _ = RBT::Cookbooks::SanitizeCookbook.new(i)
+  _ = RBT::Action::Cookbooks::SanitizeCookbook.new(i)
   _.feedback_description
-end; self.instance_eval { alias description_of? feedback_description_of } # === RBT.description_of?
+end; self.instance_eval { alias description_of? feedback_description_of_via_sanitize_cookbook } # === RBT.description_of?
 
 # =========================================================================== #
 # === RBT.return_cookbook_dataset_for
@@ -7321,45 +8061,64 @@ end; self.instance_eval { alias description_of? feedback_description_of } # ===
 # This will return the dataset for a given program, in a fast manner.
 # =========================================================================== #
 def self.return_cookbook_dataset_for(i)
-  RBT::Cookbooks::SanitizeCookbook.return_dataset(i) { :fast }
+  RBT::Action::Cookbooks::SanitizeCookbook.return_dataset(i) { :fast }
 end; self.instance_eval { alias cookbook_dataset_for return_cookbook_dataset_for } # === RBT.cookbook_dataset_for
 
 # =========================================================================== #
-# === RBT.return_cookbook_for
+# === RBT.return_configure_options_of_this_program
+#
+# This method will return the GNU configure options of a program - that
+# is options such as "--enable-static" that may be passed to "./configure"
+# on the commandline.
+#
+# Usage example:
+#
+#   RBT.return_configure_options_of_this_program('php') # => "--enable-bcmath" and so forth
 #
-# This is an easier toplevel method to create a new cookbook-instance.
-# Use with care, though.
 # =========================================================================== #
-def self.return_cookbook_for(
-    i = :lua,
+def self.return_configure_options_of_this_program(i)
+  action(:sanitize_cookbook, i).configure_options?
+end
+
+# =========================================================================== #
+# === RBT.sanitize_cookbook
+# =========================================================================== #
+def self.sanitize_cookbook(
+    i            = ARGV,
+    options_hash = {},
     &block
   )
-  if block_given?
-    return RBT::Cookbooks::SanitizeCookbook.new(i, &block)
-  else
-    return RBT::Cookbooks::SanitizeCookbook.new(i) { :fast }
-  end
-end; self.instance_eval { alias load_this_cookbook return_cookbook_for } # === RBT.load_this_cookbook
-     self.instance_eval { alias cookbook           return_cookbook_for } # === RBT.cookbook
-     self.instance_eval { alias cookbook_for       return_cookbook_for } # === RBT.cookbook_for
+  sanitize_cookbook = RBT::Action::Cookbooks::SanitizeCookbook.new(
+    i,
+    :do_not_run_yet,
+    &block
+  )
+  sanitize_cookbook.menu(options_hash) unless options_hash.empty?
+  sanitize_cookbook.run
+  return sanitize_cookbook
+end
 
 # =========================================================================== #
 # === RBT::Cookbook
 #
 # This will also "alias" methods such as RBT::Cookbook[].
 # =========================================================================== #
-Cookbook = Cookbooks::SanitizeCookbook
+Cookbook = RBT::Action::Cookbooks::SanitizeCookbook
 
 end
 
 if __FILE__ == $PROGRAM_NAME
   alias e puts
   require 'colours/autoinclude'
-  _ = RBT::Cookbooks::SanitizeCookbook.new(ARGV) { :simple } # { :fast }
+  _ = RBT::Action::Cookbooks::SanitizeCookbook.new(ARGV) { :simple } # { :fast }
+  e "#{Colours.rev}The available tags are:"
+  e
   pp _.tags?
-  e 'Short description: '+
-    ::Colours.steelblue(_.short_description?)
-  e 'The dataset is:'
+  e
+  e "#{Colours.rev}Short description: "+
+    Colours::HtmlColoursMethods.steelblue(_.short_description?)
+  e
+  e "#{Colours.rev}The dataset is:"
   e
   pp _.dataset?
   e