rbt 0.16.13 → 0.16.15

data/lib/rbt/actions/individual_actions/software_manager/setters.rb

@@ -12,7 +12,152 @@ class Action
 
 class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
 
-  # ========================================================================= #
+  # ========================================================================== #
+  # === set_extract_to_this_directory_as_specified_by_the_user
+  #
+  # This method can be used by the user to specify a certain directory.
+  # ========================================================================== #
+  def set_extract_to_this_directory_as_specified_by_the_user(
+      i = :random
+    )
+    case i
+    # ======================================================================== #
+    # === :random
+    # ======================================================================== #
+    when :random
+      # ====================================================================== #
+      # In this case we will use a random subdirectory, but within the
+      # temp directory still.
+      # ====================================================================== #
+      i = rbt_temp_dir?+return_n_random_characters(10)
+    end
+    unless i.end_with? '/'
+      i = i.dup if i.frozen?
+      i << '/'
+    end
+    @internal_hash[:extract_to_this_directory_as_specified_by_the_user] = i
+  end
+
+  # ========================================================================== #
+  # === set_retain_the_extracted_source_archive
+  # ========================================================================== #
+  def set_retain_the_extracted_source_archive(
+      i = true
+    )
+    @internal_hash[:retain_the_extracted_source_archive] = true
+  end; alias set_keep_the_extracted_archive set_retain_the_extracted_source_archive # === set_keep_the_extracted_archive
+
+  # ========================================================================== #
+  # === do_retain_the_extracted_source_archive
+  #
+  # This delegates towards the method called
+  # .set_retain_the_extracted_source_archive().
+  #
+  # It may also optionally report to the user as to what is being done.
+  # ========================================================================== #
+  def do_retain_the_extracted_source_archive(
+      be_verbose = be_verbose?
+    )
+    case be_verbose
+    # ======================================================================= #
+    # === :be_silent
+    # ======================================================================= #
+    when :be_silent,
+         :be_quiet
+      be_verbose = false
+    end
+    if be_verbose
+      orev 'The extracted directory will not be removed after'
+      orev 'compilation / installation has finished.'
+    end
+    set_retain_the_extracted_source_archive(true)
+  end; alias do_set_keep_extracted         do_retain_the_extracted_source_archive # === do_set_keep_extracted
+       alias do_set_keep_extracted_archive do_retain_the_extracted_source_archive # === do_set_keep_extracted_archive
+
+  # ========================================================================== #
+  # === set_dont_keep_archive
+  #
+  # Use this method when you don't want to keep the extracted archive.
+  # ========================================================================== #
+  def set_dont_keep_archive(
+      be_verbose = true
+    )
+    if be_verbose
+      orev 'We will not keep our extracted archive.'
+    end
+    @internal_hash[:keep_the_extracted_archive] = false
+  end
+
+  # ========================================================================== #
+  # === set_keep_the_extracted_archive
+  #
+  # This method will keep the source-archive extracted. Note that this
+  # is not the default - by default we will remove the extracted
+  # archive.
+  # ========================================================================== #
+  def set_keep_the_extracted_archive(
+      i = true
+    )
+    @internal_hash[:keep_the_extracted_archive] = i
+  end; alias set_keep_extracted_archive          set_keep_the_extracted_archive # === set_keep_extracted_archive
+       alias set_keep_extracted                  set_keep_the_extracted_archive # === set_keep_extracted
+       alias do_not_remove_the_extracted_archive set_keep_the_extracted_archive # === do_not_remove_the_extracted_archive
+       alias do_not_remove_extracted_archive     set_keep_the_extracted_archive # === do_not_remove_extracted_archive
+
+  # ========================================================================== #
+  # === set_short_name
+  # ========================================================================== #
+  def set_short_name(i)
+    cookbook_dataset?.set_short_name(i)
+  end; alias set_real_short_name set_short_name # === set_real_short_name
+
+  # ========================================================================== #
+  # === set_permanently_extract_to
+  #
+  # This method will permanently set a new directory to which we
+  # will extract to.
+  #
+  # To invoke this method, do something such as:
+  #
+  #   ry --permanently_extract_to=/Depot
+  #   ry --permanently_extract_to=/opt
+  #   ry --permanently_extract_to=$TEMP_DIR
+  #
+  # ========================================================================== #
+  def set_permanently_extract_to(
+      i = nil
+    )
+    if i
+      target = RBT.permanently_set_temp_directory(i)
+      orev "The RBT scripts will henceforthwith be extracted "\
+           "towards `#{sdir(target)}#{rev}`."
+    else
+      orev 'Please provide an argument.'
+    end
+  end
+
+  # ========================================================================== #
+  # === set_user_prefix_to_nil
+  # ========================================================================== #
+  def set_user_prefix_to_nil
+    set_user_prefix(nil)
+  end
+
+  # ========================================================================== #
+  # === set_archive_type
+  # ========================================================================== #
+  def set_archive_type(i)
+    cookbook_dataset?.set_archive_type(i)
+  end
+
+  # =========================================================================== #
+  # === set_internal_pid
+  # =========================================================================== #
+  def set_internal_pid(i = nil)
+    @internal_hash[:pid] = i
+  end; alias set_pid set_internal_pid # === set_pid
+
+  # ========================================================================== #
   # === set_these_env_variables
   #
   # This method can be used to modify ENV variables.
@@ -32,7 +177,7 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
   #   set_this_env_variable 'CFLAGS = -gcc'
   #   set_this_env_variable 'LIBS: -lpthread'
   #
-  # ========================================================================= #
+  # ========================================================================== #
   def set_these_env_variables(
       hash_or_string, # We allow Hash and String as input. But String must be in a special format.
       do_which_action = :report_only,
@@ -47,9 +192,9 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     end
     unless @internal_hash[:do_not_use_special_flags]
       case do_which_action
-      # ===================================================================== #
+      # ====================================================================== #
       # === :be_quiet
-      # ===================================================================== #
+      # ====================================================================== #
       when :be_quiet,
            :be_silent
         be_verbose = false
@@ -59,21 +204,21 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
         do_which_action = :do_set_these_variables
       end
       case be_verbose
-      # ===================================================================== #
+      # ====================================================================== #
       # === :be_verbose
-      # ===================================================================== #
+      # ====================================================================== #
       when :be_verbose
         be_verbose = true
-      # ===================================================================== #
+      # ====================================================================== #
       # === :be_quiet
-      # ===================================================================== #
+      # ====================================================================== #
       when :be_quiet,
            :be_silent
         be_verbose = false
       end
-      # ===================================================================== #
+      # ====================================================================== #
       # === Next, handle Strings
-      # ===================================================================== #
+      # ====================================================================== #
       if hash_or_string.is_a? String
         if hash_or_string.include?('=') or
            hash_or_string.include?(':')
@@ -88,9 +233,9 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
           hash_or_string = { this_key => this_value } 
         end
       end
-      # ===================================================================== #
+      # ====================================================================== #
       # === Next, handle Hashes
-      # ===================================================================== #
+      # ====================================================================== #
       hash_or_string.each_pair {|key, value|
         value.strip! if value.is_a? String
         # =================================================================== #
@@ -121,23 +266,23 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     end
   end; alias set_this_env_variable set_these_env_variables # === set_this_env_variable
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_extracted_base_directory
-  # ========================================================================= #
+  # ========================================================================== #
   def set_extracted_base_directory(i)
     @internal_hash[:extracted_base_directory] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_really_compile_this_program
-  # ========================================================================= #
+  # ========================================================================== #
   def set_really_compile_this_program(i = :qt)
     set_compile_this_program(i)
     set_compile_these_programs(i) if compile_these_programs?.empty?
     initialize_cookbook_dataset
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_user_prefix                      (set_prefix tag, set prefix tag)
   #
   # This method can be used by the user, to designate another prefix in
@@ -145,7 +290,7 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
   # which the program will be installed into.
   #
   # A specialized class, called RBT::Prefix, will handle the prefix.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_user_prefix(
       i = :appdir_prefix
     )
@@ -167,36 +312,36 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
       end
     end
     if i.is_a? Symbol
-      # ===================================================================== #
+      # ====================================================================== #
       # Next, perform some sanitize operations.
       #
       # This clause will handle Symbols such as :app_dir_like or
       # :use_ntrad_prefix_at_a_later_time.
-      # ===================================================================== #
+      # ====================================================================== #
       case i.to_s # case tag
-      # ===================================================================== #
+      # ====================================================================== #
       # === ULOCAL
       #
       # This refers to the commonly used /usr/local/ directory.
-      # ===================================================================== #
+      # ====================================================================== #
       when 'ULOCAL'
         i = '/usr/local/'
-      # ===================================================================== #
+      # ====================================================================== #
       # === trad
-      # ===================================================================== #
+      # ====================================================================== #
       when /^trad$/
         i = '/usr/'
-      # ===================================================================== #
+      # ====================================================================== #
       # === --opt_prefix
-      # ===================================================================== #
+      # ====================================================================== #
       when /^-?-?opt(_|-)?prefix$/,
            :opt
         i = '/opt/'
-      # ===================================================================== #
+      # ====================================================================== #
       # === non_traditional
       #
       # This entry point has various aliases such as :ntrad.
-      # ===================================================================== #
+      # ====================================================================== #
       when /^app(_|-)?dir$/,
            /^app(_|-)?dir(_|-)?like$/,
            /^use(_|-)?appdir(_|-)?prefix$/i,
@@ -222,10 +367,10 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
         # =================================================================== #
         i.delete!('-') if i.respond_to?(:include?) and i.include? '-'
       end
-      # ===================================================================== #
+      # ====================================================================== #
       # === Convert environment variables, if given, and unfreeze frozen
       #     Strings
-      # ===================================================================== #
+      # ====================================================================== #
       if i.is_a?(String)
         # =================================================================== #
         # Unfreeze frozen Strings.
@@ -272,9 +417,9 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
           end
         end
       end
-      # ===================================================================== #
+      # ====================================================================== #
       # === Ensure a trailing '/' for directories.
-      # ===================================================================== #
+      # ====================================================================== #
       unless i.to_s.end_with? '/' # .to_s to protect against Symbols given.
         i << '/' if File.directory?(i.to_s)
       end
@@ -292,7 +437,28 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
        alias set_prefix          set_user_prefix # === set_prefix
        alias set_prefix_to_use   set_user_prefix # === set_prefix_to_use
 
-  # ========================================================================= #
+  # ========================================================================== #
+  # === cookbook_dataset_set_program_version
+  # ========================================================================== #
+  def cookbook_dataset_set_program_version(i)
+    cookbook_dataset?.set_program_version(i)
+  end
+
+  # ========================================================================== #
+  # === set_description
+  # ========================================================================== #
+  def set_description(i)
+    cookbook_dataset?.set_description(i)
+  end; alias set_desc set_description # === set_desc
+
+  # ========================================================================== ##
+  # === set_is_an_abbreviation
+  # ========================================================================== #
+  def set_is_an_abbreviation(i = true)
+    @internal_hash[:is_an_abbreviation] = i
+  end
+
+  # ========================================================================== #
   # === set_cflags                                               (cflags tag)
   #
   # This method will enable you to set i.e. new cflags. This then also
@@ -314,7 +480,7 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
   #
   #   make LDFLAGS=-all-static
   #
-  # ========================================================================= #
+  # ========================================================================== #
   def set_cflags(
       i = default_cflags?,
       &block
@@ -344,37 +510,37 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     )
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_use_this_prefix
   #
   # This variant will only modify the prefix stored by @prefix.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_use_this_prefix(i)
     prefix_object?.set_prefix(i)
   end; alias set_prefix set_use_this_prefix # === set_prefix
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_cookbook_program_name
-  # ========================================================================= #
+  # ========================================================================== #
   def set_cookbook_program_name(i)
     cookbook_dataset?.set_program_name(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_user_prefix
-  # ========================================================================= #
+  # ========================================================================== #
   def set_user_prefix(i)
     @internal_hash[:user_prefix] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_extract_to_this_directory
   #
   # This method can be used to keep track onto which directory archives
   # will be extracted.
   #
   # Within RBT, the target is also known as the "homedir" variable.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_extract_to_this_directory(
       i          = RBT.log_directory?,
       be_verbose = false
@@ -407,64 +573,27 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
        alias extract_to     set_extract_to_this_directory # === extract_to
        alias set_homedir    set_extract_to_this_directory # === set_homedir
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === shall_we_use_an_appdir_prefix?
-  # ========================================================================= #
+  # ========================================================================== #
   def shall_we_use_an_appdir_prefix?
     @internal_hash[:shall_we_use_an_appdir_prefix]
   end; alias appdir_prefix? shall_we_use_an_appdir_prefix? # === appdir_prefix?
 
-  # ========================================================================= #
-  # === set_extract_to_this_directory_as_specified_by_the_user
-  #
-  # This method can be used by the user to specify a certain directory.
-  # ========================================================================= #
-  def set_extract_to_this_directory_as_specified_by_the_user(
-      i = :random
-    )
-    case i
-    when :random
-      # ===================================================================== #
-      # In this case we will use a random subdirectory, but within the
-      # temp directory still.
-      # ===================================================================== #
-      i = rbt_temp_dir?+return_n_random_characters(10)
-    end
-    unless i.end_with? '/'
-      i = i.dup if i.frozen?
-      i << '/'
-    end
-    @internal_hash[:extract_to_this_directory_as_specified_by_the_user] = i
-  end
-
-  # ========================================================================= #
-  # === set_keep_the_extracted_archive
-  #
-  # This method will keep the source-archive extracted. Note that this
-  # is not the default - by default we will remove the extracted
-  # archive.
-  # ========================================================================= #
-  def set_keep_the_extracted_archive(i = true)
-    @internal_hash[:keep_the_extracted_archive] = i
-  end; alias set_keep_extracted_archive          set_keep_the_extracted_archive # === set_keep_extracted_archive
-       alias set_keep_extracted                  set_keep_the_extracted_archive # === set_keep_extracted
-       alias do_not_remove_the_extracted_archive set_keep_the_extracted_archive # === do_not_remove_the_extracted_archive
-       alias do_not_remove_extracted_archive     set_keep_the_extracted_archive # === do_not_remove_extracted_archive
-
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_program_name_and_program_version
   #
   # This is simply a wrapper over the corresponding method in the
   # cookbook-object.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_program_name_and_program_version(i)
     cookbook_dataset?.send(__method__, i)
   end
 
   require 'rbt/utility_scripts/symlink_from_to_current/symlink_from_to_current.rb'
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_symlink_program
-  # ========================================================================= #
+  # ========================================================================== #
   def set_symlink_program(
       compile_this_program     = compile_which_program?,
       use_this_program_version = program_version?
@@ -482,77 +611,77 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     @internal_hash[:symlink_program] = _
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_url1
-  # ========================================================================= #
+  # ========================================================================== #
   def set_url1(i)
     cookbook_dataset?.set_url1(i)
   end; alias set_url set_url1 # === set_url
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_url2
-  # ========================================================================= #
+  # ========================================================================== #
   def set_url2(i)
     cookbook_dataset?.set_url2(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_cookbook_dataset_program_version
   #
   # For this method to work, cookbook_dataset? must have been instantiated
   # before.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_cookbook_dataset_program_version(i)
     cookbook_dataset?.set_program_version(i)
   end; alias set_cookbook_program_version set_cookbook_dataset_program_version # === set_cookbook_program_version
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_path
   #
   # Set the $PATH variable here through this setter-method. This will
   # directly modify ENV[] as is.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_path(i)
     i = i.dup # Better to always .dup it when we set it.
     ENV['PATH'] = i # Must re-enable PATH environment as it was.
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_postinstallation
   #
   # Note that the postinstallation steps will always be stored as
   # an Array.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_postinstallation(i)
     @internal_hash[:postinstallation] = [i].flatten.compact
   end; alias set_postinstall set_postinstallation # === set_postinstall
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_license
-  # ========================================================================= #
+  # ========================================================================== #
   def set_license(i)
     cookbook_dataset?.set_license(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_short_desc
-  # ========================================================================= #
+  # ========================================================================== #
   def set_short_desc(i)
     cookbook_dataset?.set_short_desc(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_base_dir
-  # ========================================================================= #
+  # ========================================================================== #
   def set_base_dir(i)
     cookbook_dataset?.set_base_dir = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_program_version
   #
   # Use this method to assign to a new program version at hand.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_program_version(i)
     # ======================================================================= #
     # The program version is presently (December 2018) not allowed
@@ -587,7 +716,7 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     end
   end; alias set_use_this_version set_program_version # === set_use_this_version
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_configure_base_directory
   #
   # This setter-method sets the @internal_hash[:configure_base_directory],
@@ -608,7 +737,7 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
   #
   # Do note that the cookbook-dataset will also retain the original
   # configure_base_directory.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_configure_base_directory(
       i = :default
     )
@@ -630,16 +759,16 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     @internal_hash[:configure_base_directory] = i # ← Finally, assign it.
   end; alias set_configure_base_dir set_configure_base_directory # === set_configure_base_dir
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_configure_options
   #
   # This will directly modify the cookbook-dataset.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_configure_options(i = '')
     cookbook_dataset?.configure_options = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_parameters_to_make
   #
   # If we have to pass specials options to the program called "make", then
@@ -647,7 +776,7 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
   #
   # These are additional options that can be given to the program called
   # "make".
-  # ========================================================================= #
+  # ========================================================================== #
   def set_parameters_to_make(i)
     # ======================================================================= #
     # The parameters must always be kept as an Array.
@@ -656,27 +785,27 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     @internal_hash[:parameters_to_make] = i # Do not change them to a String via .to_s
   end; alias set_make_options set_parameters_to_make # === set_make_options
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_cookbook_dataset_program
-  # ========================================================================= #
+  # ========================================================================== #
   def set_cookbook_dataset_program(i)
     cookbook_dataset?.set_program(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_program_path
   #
   # This will only modify a value on the @internal_hash.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_program_path(i)
     @internal_hash[:program_path] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_skip_extracting
   #
   # Use this method when we shall skip the extracting phase.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_skip_extracting(
       be_verbose = true
     )
@@ -687,9 +816,9 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     @internal_hash[:skip_extracting] = true
   end; alias do_not_extract set_skip_extracting # === do_not_extract
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_name_for_the_build_directory
-  # ========================================================================= #
+  # ========================================================================== #
   def set_name_for_the_build_directory(
       i          = :use_the_default_name,
       be_verbose = false
@@ -717,53 +846,53 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
        alias use_this_build_directory     set_name_for_the_build_directory # === use_this_build_directory
        alias set_use_this_build_directory set_name_for_the_build_directory # === set_use_this_build_directory
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_use_this_sed_line
-  # ========================================================================= #
+  # ========================================================================== #
   def set_use_this_sed_line(i)
     @internal_hash[:sed] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_delay_before_continuing                               (sleep tag)
   #
   # Ensure that the argument passed to us is correct.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_delay_before_continuing(n_seconds)
     sleep(n_seconds.to_i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_program_full_name
-  # ========================================================================= #
+  # ========================================================================== #
   def set_program_full_name(i = :default)
     cookbook_dataset?.set_program_full_name(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_full_configure_command
-  # ========================================================================= #
+  # ========================================================================== #
   def set_full_configure_command(i)
     i.strip! # ← This is mandatory; may be reconsidered in the future though.
     @internal_hash[:full_configure_command] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_use_this_build_system
   #
   # Consistently use this method when you modify the value at
   # @internal_hash[:use_this_build_system].
   #
   # We need to ensure that it is a Symbol.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_use_this_build_system(i)
     i = i.to_sym unless i.is_a? Symbol
     @internal_hash[:use_this_build_system] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_pkgconfig_symlink
-  # ========================================================================= #
+  # ========================================================================== #
   def set_pkgconfig_symlink(
       i = true
     )
@@ -792,18 +921,18 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     end
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_program_short_name
-  # ========================================================================= #
+  # ========================================================================== #
   def set_program_short_name(i)
     cookbook_dataset?.set_program_short_name(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_preinstall_action
   #
   # This method can be used to set different pre-install actions.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_preinstall_action(i)
     if i.is_a? String # Strings will become an Array here.
       if    i.include? ','
@@ -815,32 +944,32 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     cookbook_dataset?.preinstall = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_cookbook_dataset_program_path
-  # ========================================================================= #
+  # ========================================================================== #
   def set_cookbook_dataset_program_path(i)
     cookbook_dataset?.set_program_path(i)
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_configure_options_on_internal_hash
-  # ========================================================================= #
+  # ========================================================================== #
   def set_configure_options_on_internal_hash(i)
     @internal_hash[:configure_options] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_use_this_configure_command
-  # ========================================================================= #
+  # ========================================================================== #
   def set_use_this_configure_command(i)
     @internal_hash[:configure_command_to_use] = i.to_s
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_use_this_make_command
   #
   # This can be used to use another make command, such as "ninja".
-  # ========================================================================= #
+  # ========================================================================== #
   def set_use_this_make_command(
       i = :default
     )
@@ -855,13 +984,13 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     @internal_hash[:use_this_make_command] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_do_not_symlink
   #
   # Do not symlink after "make install" stage. This prevents the
   # symlinking-step from e. g. /Programs/Htop/1.2.0/ into the
   # /Systemd/Index/ hierarchy.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_do_not_symlink(
       be_verbose = true
     )
@@ -890,41 +1019,27 @@ class SoftwareManager < RBT::Action # === RBT::Action::SoftwareManager
     @internal_hash[:do_not_symlink] = true
   end; alias do_not_symlink set_do_not_symlink # === do_not_symlink
 
-  # ========================================================================= #
-  # === set_dont_keep_archive
-  #
-  # Use this method when you don't want to keep the extracted archive.
-  # ========================================================================= #
-  def set_dont_keep_archive(
-      be_verbose = true
-    )
-    if be_verbose
-      orev 'We will not keep our extracted archive.'
-    end
-    @internal_hash[:keep_the_extracted_archive] = false
-  end
-
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_use_these_configure_options
-  # ========================================================================= #
+  # ========================================================================== #
   def set_use_these_configure_options(i)
     i.tr!(N,' ') if i.include? N
     i.squeeze!(' ')
     @internal_hash[:configure_options] = i
   end; alias set_configure_options= set_use_these_configure_options # === set_configure_options=
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_internal_hash_configure_options
-  # ========================================================================= #
+  # ========================================================================== #
   def set_internal_hash_configure_options(i)
     @internal_hash[:configure_options] = i
   end
 
-  # ========================================================================= #
+  # ========================================================================== #
   # === set_make_command
   #
   # This method can be used to set which make command is to be used.
-  # ========================================================================= #
+  # ========================================================================== #
   def set_make_command(
       i = 'make'
     )