rbt 0.11.118 → 0.13.42

data/lib/rbt/check_for_updates/update_kde_applications.rb

@@ -90,11 +90,10 @@ class UpdateKdeApplications < CheckForRemoteWebpages # === RBT::Cookbooks::Updat
         # In this case, we have to updated.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{remote_download_url?}#{this_program}.tar.xz"
-        opne 'That remote URL should be at: '+
-              sfancy(full_remote_url)
+        that_remote_URL_should_be_at(full_remote_url)
         colourized_result = slateblue(
           "class RBT::UpdateEntry.new(#{full_remote_url})"
         )

data/lib/rbt/check_for_updates/update_kde_framework.rb

@@ -86,11 +86,10 @@ class UpdateKdeFramework < CheckForRemoteWebpages # === RBT::Cookbooks::UpdateKd
         # In this case, we have to updated.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{remote_download_url?}#{this_program}.tar.xz"
-        opne 'That remote URL should be at: '+
-              sfancy(full_remote_url)
+        that_remote_URL_should_be_at(full_remote_url)
         colourized_result = slateblue(
           "class RBT::UpdateEntry.new(#{full_remote_url})"
         )

data/lib/rbt/check_for_updates/update_kde_plasma.rb

@@ -139,13 +139,12 @@ class UpdateKdePlasma < CheckForRemoteWebpages # === RBT::Cookbooks::UpdateKdePl
         # In this case, we have to update.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = remote_download_url?.dup
         full_remote_url << '/' unless full_remote_url.end_with? '/'
         full_remote_url << "#{program_version}/#{this_program}.tar.xz"
-        opne "That remote URL should be at: "\
-             "#{sfancy(full_remote_url)}"
+        that_remote_URL_should_be_at(full_remote_url)
         colourized_result = slateblue(
           "class RBT::UpdateEntry.new(#{full_remote_url})"
         )

data/lib/rbt/check_for_updates/update_kde_porting_aids.rb

@@ -111,11 +111,10 @@ class UpdateKdePortingAids < CheckForRemoteWebpages # === RBT::Cookbooks::Update
         # In this case, we have to updated.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{remote_download_url?}#{this_program}.tar.xz"
-        opne 'That remote URL should be at: '+
-              sfancy(full_remote_url)
+        that_remote_URL_should_be_at(full_remote_url)
         colourized_result = slateblue(
           "class RBT::UpdateEntry.new(#{full_remote_url})"
         )

data/lib/rbt/check_for_updates/update_lxqt.rb

@@ -86,11 +86,10 @@ class UpdateLxqt < CheckForRemoteWebpages # === RBT::Cookbooks::UpdateLxqt
         # In this case, we have to update.
         # =================================================================== #
         @downloaded_n_programs += 1
-        opne "There is a more recent program version "\
+        opne "#{rev}There is a more recent program version "\
              "available for `#{sfancy(name_of_the_program)}`."
         full_remote_url = "#{this_program}".dup
-        opne "That remote URL should be at: "\
-             "#{sfancy(full_remote_url)}"
+        that_remote_URL_should_be_at(full_remote_url)
         colourized_result = slateblue(
           "class RBT::UpdateEntry.new(#{full_remote_url})"
         )

data/lib/rbt/checks_and_validations/allowed_cookbook_entries.rb

@@ -48,6 +48,13 @@ class AllowedCookbookEntries < Base # === RBT::Cookbooks::AllowedCookbookEntries
     RBT.e(i)
   end
 
+  # ========================================================================= #
+  # === RBT::Cookbooks::AllowedCookbookEntries.rev
+  # ========================================================================= #
+  def self.rev
+    ::RBT.rev
+  end
+
   # ========================================================================= #
   # === RBT::Cookbooks::AllowedCookbookEntries.report_allowed_entries
   # ========================================================================= #
@@ -58,15 +65,16 @@ class AllowedCookbookEntries < Base # === RBT::Cookbooks::AllowedCookbookEntries
     e
     e
     e 'The following entries are registered in the file '
-    e ::RBT.sfile('registered_cookbook_entries.rb')+', in the '
-    e 'constant '+::RBT.simp('REGISTERED_COOKBOOK_ENTRIES')+', and '\
-      'thus valid:'
+    e ::RBT.sfile('registered_cookbook_entries.rb')+rev+', in the '
+    e rev+'constant '+
+      ::RBT.simp('REGISTERED_COOKBOOK_ENTRIES')+
+      rev+', and thus valid:'
     e
     REGISTERED_COOKBOOK_ENTRIES.each_with_index {|entry, index|
       index += 1
       colourized_and_padded_index = ::RBT.sfancy(index.to_s.rjust(3))
       entry = Colours.mediumaquamarine(entry)
-      e colourized_and_padded_index+') '+entry
+      e "#{colourized_and_padded_index}#{rev}) #{entry}"
     }; e # Need to output a terminating-newline here for consistency with the above.
   end
 

data/lib/rbt/checks_and_validations/check_for_correct_dependencies.rb

@@ -69,7 +69,7 @@ class CheckForCorrectDependencies < RBT::Base # === RBT::Cookbooks::CheckForCorr
   end
 
   # ========================================================================= #
-  # === show_help
+  # === show_help                                                  (help tag)
   # ========================================================================= #
   def show_help
     e
@@ -93,7 +93,7 @@ class CheckForCorrectDependencies < RBT::Base # === RBT::Cookbooks::CheckForCorr
       when /^help$/
         show_help
       else
-        opne "Unregistered commandline argument: #{sfancy(i)}"
+        opne "#{rev}Unregistered commandline argument: #{sfancy(i)}#{rev}"
       end
     end
   end
@@ -107,7 +107,7 @@ class CheckForCorrectDependencies < RBT::Base # === RBT::Cookbooks::CheckForCorr
       use_this_as_the_key_for_required_deps_on =
         'required_deps_on'.to_sym
     )
-    opne 'Now checking every program. This may take a while.'
+    opne "#{rev}Now checking every program. This may take a while."
     available_programs?.each {|program|
       program = File.basename(program).sub(/\.yml$/,'')
       # ===================================================================== #
@@ -145,7 +145,7 @@ class CheckForCorrectDependencies < RBT::Base # === RBT::Cookbooks::CheckForCorr
           @n_erroneous_entries_were_found += 1
           deps.each {|entry|
             if entry.nil?
-              opne 'Nil value found for `'+steelblue(program)+'`. '\
+              opne rev+'Nil value found for `'+steelblue(program)+'`. '\
                    'This is probably an empty entry.'
             end
             if entry
@@ -153,8 +153,8 @@ class CheckForCorrectDependencies < RBT::Base # === RBT::Cookbooks::CheckForCorr
                 entry = entry.split(' ').first.strip
               end
               unless RBT.really_does_include? entry
-                e "#{format_program(program)} No "\
-                  "entry for `#{simp(entry)}` was found."
+                e "#{rev}#{format_program(program)} No "\
+                  "entry for `#{simp(entry)}#{rev}` was found."
               end
             end
           }

data/lib/rbt/checks_and_validations/check_for_invalid_entries_in_this_cookbook.rb

@@ -143,7 +143,7 @@ class CheckForInvalidEntriesInThisCookbook < RBT::Base # === RBT::Cookbooks::Che
       # Read in the full dataset next.
       # ===================================================================== #
       @work_on_this_file = this_cookbook_entry
-      @dataset = File.readlines(this_cookbook_entry).reject {|line|
+      @dataset = readlines_with_proper_encoding(this_cookbook_entry).reject {|line|
         line.start_with? '#'
       }.join(N)
       @first_line = @dataset.split(N).first.strip.delete(':')
@@ -153,7 +153,7 @@ class CheckForInvalidEntriesInThisCookbook < RBT::Base # === RBT::Cookbooks::Che
       # ===================================================================== #
       # We have to check for registered entries.
       # ===================================================================== #
-      e "#{rev}Working on the file #{sfile(this_cookbook_entry)} next."
+      e "#{rev}Working on the file #{sfile(this_cookbook_entry)} #{rev}next."
       e
       e return_the_main_counter_then_increment_it+
         ' Checking whether '+
@@ -296,10 +296,15 @@ class CheckForInvalidEntriesInThisCookbook < RBT::Base # === RBT::Cookbooks::Che
     when :default,
          nil
       if File.exist? this_file
-        i = @dataset = File.read(this_file)
+        i = @dataset = read_file_with_default_encoding(this_file)
       end
     end
-    n_url1_entries = i.scan(/^ url1: /).size
+    begin
+      n_url1_entries = i.scan(/^ url1: /).size
+    rescue ArgumentError => error
+      e "#{rev}Error for: #{sfile(this_file)}"
+      pp error
+    end
     if n_url1_entries > 1
       opne swarn('There are too many')+steelblue(' url1: ')+
            swarn('entries in that file.')

data/lib/rbt/checks_and_validations/missing_use_this_build_system_entry.rb

@@ -90,7 +90,7 @@ class MissingUseThisBuildSystemEntry < RBT::Base # === RBT::Cookbooks::MissingUs
         e tomato(target) if is_on_roebe
         @missing_use_this_build_system_entries << this_program
         if OPEN_IN_THE_EDITOR
-          e 'Opening in the editor as well:'
+          opne 'Opening in the editor as well:'
           Open.in_editor(target)
           sleep 0.5
         end

data/lib/rbt/checks_and_validations/report_missing_homepage_entries.rb

@@ -0,0 +1,117 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === RBT::Cookbooks::ReportMissingHomepageEntries
+#
+# This small class will simply report which .yml file lacks a homepage
+# entry, or whether that homepage entry is empty.
+#
+# Erroneous entries will be reported to the user in such an event.
+# =========================================================================== #
+# require 'rbt/checks_and_validations/report_missing_homepage_entries.rb'
+# =========================================================================== #
+require 'rbt/base/base.rb'
+
+module RBT
+
+module Cookbooks
+
+class ReportMissingHomepageEntries < RBT::Base # === RBT::Cookbooks::ReportMissingHomepageEntries
+
+  require 'rbt/aliases/aliases.rb'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    reset
+    case run_already
+    when :do_not_run_yet
+      run_already = false
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+    infer_the_namespace
+  end
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  # ========================================================================= #
+  def show_help
+    e
+    e 'Currently no help options are documented for this class.'
+    e
+  end
+
+  # ========================================================================= #
+  # === menu
+  # ========================================================================= #
+  def menu(i)
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      case i # case tag
+      # ===================================================================== #
+      # === missing_homepage --help
+      # ===================================================================== #
+      when /^-?-?help$/i
+        show_help
+        exit
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === report_this_program_has_a_missing_homepage_entry
+  # ========================================================================= #
+  def report_this_program_has_a_missing_homepage_entry(i)
+    e "  #{orange(i)} has no #{steelblue('homepage')} entry."
+  end
+
+  # ========================================================================= #
+  # === report_this_program_has_no_complete_homepage_entry
+  # ========================================================================= #
+  def report_this_program_has_no_complete_homepage_entry(i)
+    e steelblue(i.ljust(30))+
+      ' has an incomplete/missing homepage entry.'
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    all_available_programs?.each {|this_program|
+      _ = nil
+      if does_this_expanded_cookbook_file_exist_for_this_program? this_program
+        dataset = load_dataset_from_this_expanded_cookbook(this_program)
+      else # else load from the default cookbook directory.
+        dataset = load_yaml_file_from_the_cookbook_directory_for_this_program(this_program)
+      end
+      if dataset.has_key? this_program
+        dataset = dataset[this_program]
+      end
+      the_homepage = dataset['homepage'.to_sym]
+      if dataset.has_key? 'homepage'.to_sym
+        if the_homepage == 'unknown'
+          report_this_program_has_no_complete_homepage_entry(this_program)
+        end
+      else
+        report_this_program_has_a_missing_homepage_entry(this_program)
+      end
+    }
+  end
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  RBT::Cookbooks::ReportMissingHomepageEntries.new(ARGV)
+end # missinghomepage

data/lib/rbt/cmake/cmake.rb

@@ -22,8 +22,8 @@
 # The class RBT:Cmake has two "modus operandi". The default way is to
 # run "standalone", that is - simply invoke it and it will do its job.
 #
-# But a second way is to feedback information into class RBT::Compile,
-# so that class RBT::Compile can handle and process all the information
+# But a second way is to feedback information into class RBT::Installer,
+# so that class RBT::Installer can handle and process all the information
 # used. The proper way to assign a parent object is to pass a block.
 # =========================================================================== #
 # === Specification constraints for this class:
@@ -99,8 +99,8 @@ class Cmake < Base # === RBT::Cmake
   # ========================================================================= #
   # === set_parent_object
   #
-  # The parent object, presently, may only be of class RBT::Compile or
-  # it is simply nil.
+  # The parent object, presently, may only be of class RBT::Installer
+  # or it is simply nil.
   # ========================================================================= #
   def set_parent_object(i = nil)
     @parent_object = i

data/lib/rbt/colours/rev_simp_sdir_sfancy_sfile_and_swarn.rb

@@ -71,7 +71,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.simp(i)
       else
-        return COLOURS.send(user_designated_colour(:simp), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:simp), i)
       end
     end
     return i
@@ -85,7 +85,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.swarn(i)
       else
-        return COLOURS.send(user_designated_colour(:swarn), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:swarn), i)
       end
     end
     return i
@@ -106,7 +106,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.sdir(i)
       else
-        return COLOURS.send(user_designated_colour(:sdir), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:sdir), i)
       end
     end
     return i
@@ -120,7 +120,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.sfile(i)
       else
-        return COLOURS.send(user_designated_colour(:sfile), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:sfile), i)
       end
     end
     return i
@@ -148,7 +148,7 @@ module RBT
       if HASH_DESIGNATED_COLOURS.empty?
         return COLOURS.sfancy(i)
       else
-        return COLOURS.send(user_designated_colour(:sfancy), i)
+        return COLOURS::HtmlColoursMethods.send(user_designated_colour(:sfancy), i)
       end
     end
     return i

data/lib/rbt/commandline/commandline.rb

@@ -226,9 +226,9 @@ class Commandline < Base
     if RBT.is_a_registered_program? program_name
       e "The program #{program_name} is registered."
     else # else register it.
-      e 'The program '+sfancy(program_name)+
-        ' is not registered.'
-      e 'Thus, delegating towards class '+
+      e rev+'The program '+sfancy(program_name)+
+        rev+' is not registered.'
+      e rev+'Thus, delegating towards class '+
         steelblue('RBT::Cookbooks::CreateCookbookYamlFile')+
         '.'
       mkdir(src_dir?+program_name)

data/lib/rbt/compile_base/compile_base.rb

@@ -370,10 +370,10 @@ class CompileBase < RBT::Base # === RBT::CompileBase
       # ===================================================================== #
       # Delegate into class RBT::SymlinkHeaders next.
       # ===================================================================== #
-      opne "Next attempting to symlink all #{royalblue('.h')} files into "\
-           "the #{sdir('/usr/include/')} hierarchy."
-      opne "In order for this to work, #{royalblue('.h ')}"\
-           " files have to exist in the AppDir directory."
+      opne "#{rev}Next attempting to symlink all #{royalblue('.h')} #{rev}files "\
+           "into the #{sdir('/usr/include/')} #{rev}hierarchy."
+      opne "#{rev}In order for this to work, #{royalblue('.h')}"\
+           " #{rev}files have to exist in the AppDir directory."
       RBT::SymlinkHeaders.new(i) { :do_not_notify_if_there_were_no_header_files }
     end
   end
@@ -417,7 +417,7 @@ class CompileBase < RBT::Base # === RBT::CompileBase
       # /usr hierarchy.
       # ===================================================================== #
       if File.directory? '/usr/lib/cmake/'
-        opne "Symlinking from #{sdir(target_cmake_dir)} into "\
+        opne "#{rev}Symlinking from #{sdir(target_cmake_dir)} #{rev}into "\
              "#{sdir('/usr/lib/cmake/')}"
         # =================================================================== #
         # Symlink only directories.
@@ -715,6 +715,13 @@ class CompileBase < RBT::Base # === RBT::CompileBase
     RBT::SymlinkFromToCurrent.new(this_program)
   end
 
+  # ========================================================================= #
+  # === cflags?
+  # ========================================================================= #
+  def cflags?
+    ENV['CFLAGS']
+  end
+
   # ========================================================================= #
   # === run
   # ========================================================================= #

data/lib/rbt/constants/constants.rb

@@ -537,6 +537,15 @@ module RBT
     RBT.validation_scripts?
   end
 
+  # ========================================================================= #
+  # === RBT.file_rename_tab_title
+  # ========================================================================= #
+  def self.file_rename_tab_title(
+      use_this_directory = @configuration_directory
+    )
+    "#{use_this_directory}rename_tab_title.yml"
+  end
+
   # ========================================================================= #
   # === RBT.file_use_colours?
   #

data/lib/rbt/constants/remote_URLs.rb

@@ -31,7 +31,7 @@ module RBT
   #
   # ========================================================================= #
   REMOTE_URL_FOR_KDE_APPLICATIONS =
-    "#{DOWNLOAD_KDE_ORG}stable/release-service/23.04.1/src/"
+    "#{DOWNLOAD_KDE_ORG}stable/release-service/23.08.4/src/"
 
   # ========================================================================= #
   # === REMOTE_URL_FOR_KDE_FRAMEWORKS
@@ -49,7 +49,7 @@ module RBT
   #
   # ========================================================================= #
   REMOTE_URL_FOR_KDE_FRAMEWORKS =
-    "#{DOWNLOAD_KDE_ORG}stable/frameworks/5.106/"
+    "#{DOWNLOAD_KDE_ORG}stable/frameworks/5.114/"
 
   # ========================================================================= #
   # === REMOTE_URL_FOR_KDE_PORTING_AIDS
@@ -80,7 +80,7 @@ module RBT
   #
   # ========================================================================= #
   REMOTE_URL_FOR_KDE_PLASMA =
-    "#{DOWNLOAD_KDE_ORG}stable/plasma/5.27.5/"
+    "#{DOWNLOAD_KDE_ORG}stable/plasma/5.27.10/"
 
   # ========================================================================= #
   # === REMOTE_DOWNLOAD_URL_FOR_KDE_PLASMA

data/lib/rbt/cookbooks/check_for_inclusion.rb

@@ -120,7 +120,8 @@ class CheckForInclusion < Base # === RBT::Cookbooks::CheckForInclusion
         # f '`'+file_long_name+'` is included.' if be_verbose? # Be silent here. 
       else # Else it is not included.
         if be_verbose?
-          opnwarn '`'+simp(file_long_name)+swarn('` is not included.')
+          opnwarn '`'+simp(file_long_name)+
+                      swarn('` is not included.')
         end
         @array_files_which_were_not_found << file_long_name
       end

data/lib/rbt/cookbooks/find_duplicate_binaries.rb

@@ -142,7 +142,8 @@ class FindDuplicateBinaries < Base # === RBT::Cookbooks::FindDuplicateBinaries
     e 'Currently we support only one option:'
     e
     ecomment '   --delete # delete duplicate files found in '\
-      'the '+sdir(ubin?)+comment(' hierarchy') # finddup --help
+             'the '+sdir(ubin?)+
+             comment(' hierarchy') # finddup --help
     e
   end
 
@@ -167,7 +168,7 @@ class FindDuplicateBinaries < Base # === RBT::Cookbooks::FindDuplicateBinaries
   def do_delete_duplicate_files
     if delete_duplicates? and !@duplicate_files.empty?
       opne 'Now deleting duplicate files from the '+sdir(ubin?)+
-           ' directory.'
+           rev+' directory.'
       @duplicate_files.each {|entry|
         _ = sysbin?+File.basename(entry)
         if File.exist? _ # Extra safeguard here.

data/lib/rbt/cookbooks/highest.rb

@@ -269,7 +269,7 @@ class Highest < Base # === RBT::Cookbooks::Highest
         @dataset = RBT::Cookbooks::SanitizeCookbook.new(i) { :be_fast_and_be_quiet }
         url = @dataset.program_path? # Keep the local URL here.
         if url.nil?
-          e '`'+simp(i.to_s)+'` is nil, probably because it does not '\
+          e '`'+simp(i.to_s)+rev+'` is nil, probably because it does not '\
             'exist locally.'
           e 'Please consider fixing this problem.'
           if EXIT_ON_MISSING_ENTRY

data/lib/rbt/cookbooks/raw_cookbook/raw_cookbook.rb

@@ -92,6 +92,7 @@ class RawCookbook < ::RBT::Base # === RBT::Cookbooks::RawCookbook
   def reset
     super()
     reset_the_internal_variables
+    infer_the_namespace
   end
 
   # ========================================================================= #
@@ -956,6 +957,20 @@ class RawCookbook < ::RBT::Base # === RBT::Cookbooks::RawCookbook
     _ = _.dup
     _ << '.yml' unless _.end_with?('.yml') or _.empty?
     # ======================================================================= #
+    # Since as of January 2024, if the file does NOT exist, and we are
+    # on a roebe-system, we will automatically generate a new .yml file.
+    # ======================================================================= #
+    if !File.exist?(_) and is_on_roebe?
+      # ===================================================================== #
+      # Autogenerate it anew in this case:
+      # ===================================================================== #
+       opne rev+'The .yml file does not exist at '+sfile(_)+rev+'. As we are'
+       opne "#{rev}on a roebe-system, this .yml file will be generated now."
+       require 'rbt/utility_scripts/expand_cookbooks.rb'
+       target = File.basename(_).delete_suffix('.yml')
+       RBT.expand_cookbooks(target)
+    end
+    # ======================================================================= #
     # The file exists, so we continue here.
     # ======================================================================= #
     if File.exist? _
@@ -990,7 +1005,7 @@ class RawCookbook < ::RBT::Base # === RBT::Cookbooks::RawCookbook
     else
       the_program_is_not_included
       unless @be_quiet_if_the_file_was_not_found
-        no_file_exists_at(_)
+        opnn; no_file_exists_at(_)
       end
     end
     return @internal_hash[:dataset] # Always return the dataset as-is.

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

@@ -77,14 +77,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     obtain(__method__.to_s.delete('?').to_sym)
   end
 
-  # ========================================================================= #
-  # === use_this_build_directory?
-  # ========================================================================= #
-  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
-
   # ========================================================================= #
   # === set_env_variables?
   #
@@ -417,4 +409,13 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
   end; alias cmake_configure_options cmake_configure_options? # === cmake_configure_options
        alias cmake_options?          cmake_configure_options? # === cmake_options?
 
+  # ========================================================================= #
+  # === use_this_build_directory?
+  # ========================================================================= #
+  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?
+
 end; end; end

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

@@ -2372,12 +2372,12 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
       when :library
         binary_or_library = 'library'
       end
-      opne '`'+simp(i)+'` was found as name of a '+
-           simp(binary_or_library)+' file.'
+      opne '`'+simp(i)+rev+'` was found as name of a '+
+           simp(binary_or_library)+rev+' file.'
       opne 'We will now assume that you want to get this '\
            'whole package instead and will'
       opne 'thus set the name to this program now, which belongs to '\
-           'the package `'+sfancy(new_program_name)+'`.'+N
+           'the package `'+sfancy(new_program_name)+rev+'`.'+N
     end
   end
 
@@ -2638,19 +2638,6 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
     set_seek_this_program(_)
   end
 
-  # ========================================================================= #
-  # === instantiate_raw_cookbook
-  # ========================================================================= #
-  def instantiate_raw_cookbook(
-      i = seek_this_program?
-    )
-    # ===================================================================== #
-    # We also have to sync the variable @simple_or_complex down onto the
-    # raw-cookbooks loader.
-    # ===================================================================== #
-    @internal_hash[:raw_cookbook] = RBT.raw_cookbook(i) { simple_or_complex? }
-  end; alias initialize_raw_cookbook instantiate_raw_cookbook # === initialize_raw_cookbook
-
   # ========================================================================= #
   # === sanitize_env_variables
   #  
@@ -7159,6 +7146,19 @@ class SanitizeCookbook < Base # === RBT::Cookbooks::SanitizeCookbook
        alias set_version          set_program_version # === set_version
        alias use_this_version=    set_program_version # === use_this_version=
 
+  # ========================================================================= #
+  # === instantiate_raw_cookbook
+  # ========================================================================= #
+  def instantiate_raw_cookbook(
+      i = seek_this_program?
+    )
+    # ===================================================================== #
+    # We also have to sync the variable @simple_or_complex down onto the
+    # raw-cookbooks loader.
+    # ===================================================================== #
+    @internal_hash[:raw_cookbook] = RBT.raw_cookbook(i) { simple_or_complex? }
+  end; alias initialize_raw_cookbook instantiate_raw_cookbook # === initialize_raw_cookbook
+
   # ========================================================================= #
   # === run                                                         (run tag)
   # ========================================================================= #