rbt 0.11.118 → 0.13.42

data/doc/todo/numbered_todo_entries_for_the_RBT_project.md

@@ -1,12 +1,65 @@
 --------------------------------------------------------------------------------
-(47) → validate_all_cookbook_entries
+(80) → rewrite it again? hmmmmmm...
+      fix 3 bugs during that rewrite:
+      1) ry M4 ntrad --use-this-as-program-name=M62
+      homepage tag has to be added still
+      ^^^ and add homepage tags... this is simple
+      also port old code well
+--------------------------------------------------------------------------------
+(1) → incorporate build systems priorities yml file,
+      but we need to test it on some program
+      perhaps gnome program
+      and also make it possible to query that via the
+      ruby-gtk wrapper. aka "infer build system"
+      from this path or something like that.
+--------------------------------------------------------------------------------
+(2) → Rewriting RBT (Rewriting RBT once again!):
+      1a) → if we rewrite rbt then start with the "does the file
+      exist locally". If yes, go through it.
+      Well this needs a bit more planning...
+      AND when it works, document it.
+      ^^^^^
+      1b) → during the rewrite we must enable --expand to read from the
+      expanded dataset too, rather than loading the original yaml
+      file and sanitizing it. The user must be able to decide
+      on his or her own here.
+      ^^^
+      1c) → if we rewrite RBT then perhaps we should first
+      write the logic into a standalone file,
+      which then gets loaded and parsed.
+      This all needs more planning though. we will do the three
+      things or rather two things at a later time ...
+      Use some indent way or so:
+      Hmmm. If we have a separate logic-file:
+      Just describe things in a general way. And handle these sub-tasks
+      individually.
+      - extract_archive
+      - compile_or_install # For packages too.
+      - compile_step (cmake, configure etc..)
+      extract archive
+      if file exists
+      else
+      and perhaps also start with a test case or so.
+--------------------------------------------------------------------------------
+(3) → Write SIMPLE ruby-gtk bindings STANDALONE.
+      ^ Nur die core functionality.
+      ^^^ das dann inkludieren.
+      Display RBT Version here.
+      ______________________________________________________________________
+      [ display available programs here] |
+      via drop down listing         |
+      | INPUT FIELD ___
+      | ^^^compile this program
+      |   button [start compiling]
+      RESULT MESSAGES WILL SHOW UP HERE.
+      alias gtk_compile
+      SYSTEM/compile_program.rb:
+--------------------------------------------------------------------------------
+(4) → validate_all_cookbook_entries
       ^^^ continue there and add homepages to every entry.
       ^^^^^^ being handled right now.
-
-
 --------------------------------------------------------------------------------
-(1) → Ensure that scons-related compiling can work:
-
+(5) → Ensure that scons-related compiling can work:
 # ========================================================================= #
 # === compile_via_scons                                         (scons tag)
 #
@@ -19,8 +72,7 @@
       @rscons.set_prefix prefix
       @rscons.run
 --------------------------------------------------------------------------------
-(1) → Ensure that we can obtain a random program:
-
+(6) → Ensure that we can obtain a random program:
       rbt --random?
       rbt random?
       rbt RANDOM?
@@ -34,7 +86,7 @@
       e.g:
       rbt --last-compiled-program?
 --------------------------------------------------------------------------------
-(2) → Work on RBT in such a way that it will make it super-easy to
+(7) → Work on RBT in such a way that it will make it super-easy to
       setup a new system from scratch on my gobolinux laptop.
       In order to do this, start the gobolinux laptop again
       hmmm.
@@ -42,7 +94,7 @@
       laptop? Choices, choices. Well - laptop is simpler IMO.
       ^^^ yeah use gobolinux on the laptop again!
 --------------------------------------------------------------------------------
-(3) → START of the OLD CONGLOMERATE, such as via old_installer.rb:
+(8) → START of the OLD CONGLOMERATE, such as via old_installer.rb:
       def compile(this_program, real_name = database_loader.short_name)
 # ======================================================================= #
 # Next we check if we have to compile or not. If not, we skip in the
@@ -60,11 +112,6 @@
       end
 # ======================================================================= #
 # We must decide:
-#   Either we install a program in a "traditional" way (FHS compatible)
-#   or we do it the "gobolinux" way. For simplification we call these
-#   ways simply "traditional vs non-traditional" ways. (Gobolinux was
-#   the first to really pioneer non-traditional compilations in the
-#   Linux world)
 #   The checks are important here: We dont want a general "else" case
 #   because all checks should be handled, "else" is simply not a legit
 #   option here. A user should be able to fine tune it to his/her needs
@@ -82,22 +129,11 @@
       elsif database_loader.prefix == 'none'
       compile_how(:undefined)
 # ======================================================================= #
-# (4) User Mode compiling is checked here.
-# ======================================================================= #
-      elsif database_loader.prefix.is_a? String
-      compile_how(:user_defined)
-      end
-      end
-# ======================================================================= #
 # And now, really the last step here is to return whether compilation
 # was a success or a failure. This return value can be used by other
 # programs. (Can be true or false) We will not do so when we only
 # install headers though.
 # ======================================================================= #
-      save_yaml_file_last_compiled_program(this_program) unless @install_only_headers
-      save_yaml_file_last_compiled_configure_options(object_configure_string._) unless @install_only_headers
-      return @installation_was_successful_or_not
-      end
 # ========================================================================= #
 # === save_yaml_file_last_compiled_configure_options
 # As input, pass the configure options to this method.
@@ -143,30 +179,6 @@
 # ========================================================================= #
       def prepare_program(which_program = @program_to_compile)
 # Intercept for help.
-      case @second_argument
-      when 'help'
-      show_help
-      end
-      cliner {
-      opn; e '@array_other_commands:'
-      pp @array_other_commands
-      } if @debug
-      if ! @array_other_commands.empty? # process all other arguments here.
-      @array_other_commands.each { |c| check_argument(c) }
-      end
-      if @flag_set_different_version # overrule version if flag was set
-      database_loader.set_program_version(@flag_set_different_version, T)
-      = sanitized_data # this line can probably be removed.
-      end
-      which_program = @query.name? # Since Feb 2012.
-#compile(which_program, real_long_name)
-      compile(which_program, which_program) # Since Feb 2012. SCREW IT!
-      else
-      opn; error 'Line '+__LINE__.to_s+': Sorry, no match '+
-      'could be found for `'+which_program+'`.'
-      @found_program = false
-      end
-      end
 # ========================================================================= #
 # === compile_all_versions
 #
@@ -177,7 +189,7 @@
       cfav = CheckForAvailableVersions.new(i)
       cfav.check_for_program(:be_silent)
       _ = cfav.available_versions
-      opn; e 'We apply a common operation on these programs now:'
+      opne 'We apply a common operation on these programs now:'
       e '  '+_.join(', ').wrap_at()
       chained = Chained.new(_)
       chained.start_compiling
@@ -196,7 +208,7 @@
 # ======================================================================= #
       _ = @query.program_was_found?
       cliner {
-      opn; e 'Installer.rb: Line '+__LINE__.to_s+', was the program `'+
+      opne 'Installer.rb: Line '+__LINE__.to_s+', was the program `'+
       @program_to_compile+'` found? '+vt(_)
       } if @debug
       if _
@@ -219,8 +231,6 @@
       end
       end
 # ========================================================================= #
-# Considers extracting stuff. Honours @skip_extracting setting too, as in
-#   ry php noextract
 # If this is set to a path, we extract to this dir, which can be useful
 # for packages or fluxbox styles. Also, here we handle extraction of the
 # source files including chdir to the newly created directory. This is done
@@ -228,13 +238,8 @@
 # ========================================================================= #
       def consider_extracting_program(extract_where_to = database_loader.extract_to.dup)
       if @archive_exists
-# now we have two cases: either sub_dir is empty, or it isnt
-      if database_loader.sub_dir.empty? # This is valid for most things.
-      @extracter.set_source_location database_loader.program_path
-      _ = extract_where_to # Assign to the argument.
       unless CONFIG.check_if_compiling_is_in_progress == true and File.exist? _+'/COMPILING_IS_IN_PROGRESS'
-      @extracter.extract_to _
-      end
+      ^^^^ make sure we keep track of this somewhere
       if File.exist? extract_where_to
       change_directory(extract_where_to)
       else
@@ -342,7 +347,7 @@
 #   ry php upload /tmp/python-3.1.1.recipe
 # ========================================================================= #
       def upload_recipe_to(this_recipe, this_url = 'ftp.members.a1.net')
-      ftp_object = StdFtp::FTP_Lib.new(this_url,'shevegen','1aaaaaa')
+      ftp_object = StdFtp::FTP_Lib.new
       ftp_object.build_ftp_object
       ftp_object.change_directory 'html'
       ftp_object.upload(this_recipe)
@@ -510,22 +515,9 @@
       if    name == 'not found' # Pass through if not found.
       elsif name.empty? # Pass through if empty name
       else
-# else, well.. insert it. Also gsub Games, and downcase
-# the name.
-      name.gsub!(/Games\//,'').downcase!
-      cii " => Inserting #{name}, #{description} and #{version} "+
-      "into sqlite3 database at #{database_location}."
-      @object_sqlite3_database = StdDatabases.new
-      @object_sqlite3_database.database_location = database_location
-      @object_sqlite3_database.set_handle
-      @object_sqlite3_database.sqlite3_do_batch
-      @object_sqlite3_database.sqlite3_four_columns_insert(
-      name, version, binaries, description)
-      @object_sqlite3_database.sanitize # sanitize info
-      end
-      end
 # ========================================================================= #
 # === save_compile_time_information
+#
 # This method stores information about the compile time. It stores:
 #  (1) Program Name
 #  (2) Program Version
@@ -551,6 +543,7 @@
       append_what_into('Configure options used: '+@object_configure_string.string?.to_s,_) # 7
 # ========================================================================= #
 # === repackage
+#
 # This method will repackage a given tarball.
 # ========================================================================= #
       def repackage(i)
@@ -574,8 +567,7 @@
       def gather_all_dependencies
 # first must run it to get the info.
       @dependency_collector.gather_dependencies
-      opn; cii 'Getting dependencies next (including itself):'
-      print '  '
+      opne 'Getting dependencies next (including itself):'
       pp @dependency_collector.array_compilation_dependencies
       array = @dependency_collector.array_compilation_dependencies
       _ = Chained.new(array)
@@ -626,16 +618,6 @@
       when 'feedback_urls','feedback_url','feedbackurl','ufeed'
       feedback_urls
       exit_program
-# ======================================================================= #
-# This will report how many programs are registered (n tag):
-#   ry htop n_programs?
-# ======================================================================= #
-      when 'n_programs','nprograms','p?','n_programs?','registered?',
-      'n_registered?','programs?','nprograms?','n','n_versions?',
-      'installed_programs?'
-      _ = @query.database_loader
-      _.consider_reporting_how_many_programs_are_registered(true)
-      exit_program
 # when 'enableshared'
 # ======================================================================= #
 # Suppress output:
@@ -643,7 +625,7 @@
 # ======================================================================= #
       when 'suppress-output','suppressoutput','sout','soutput','souput',
       'suppress_output','be_silent','besilent'
-      opn; e 'We will use systemu to suppress system output.'
+      opne 'We will use systemu to suppress system output.'
       @use_systemu = true
 # ======================================================================= #
 # ry yasm ifiles
@@ -663,15 +645,6 @@
       generate_new_cookbook
       exit_program
 # ======================================================================= #
-# ry gdb installs_these_binaries?
-# ry php ibins?
-# ======================================================================= #
-      when 'installs_these_binaries?','installs_these_binaries','itb','itb?',
-      'ibinary?','ibinaries?','ibins?','install_these?'
-      opn; e 'The program `'+@program_to_compile+'` will install these binaries:'
-      opn; ci '  '+database_loader.binaries
-      exit_program
-# ======================================================================= #
 # If the user wants to treat his input as name for a binary, then this
 # piece of code here helps him do so. It will try to compile the
 # respective program and overrule the alias.
@@ -683,7 +656,7 @@
       when 'check_as_binary_name','as_binary_name','binaryname','bname',
       'asbinaryname','treat_as_library_name','treat_as_binary_name','cabn',
       'as_binary','asbinary'
-      opn; e 'We will check for a binary name.'
+      opne 'We will check for a binary name.'
       @query.bypass_name_check = true
 # ======================================================================= #
 # Daemonize the object.
@@ -778,7 +751,7 @@
       when 'binary','binstall','binary install','package',
       'install','inst','i','install_package'
       this_program = database_loader.name+'-paco.tar.bz2'
-      opn; e ' => Trying binary installation of '+
+      opne ' => Trying binary installation of '+
       "#{database_loader.name} next" # cuz the binary name can be different
       handle_binary_installation(this_program)
       when nil,''
@@ -816,14 +789,10 @@
 #   ry php use_cookbook=/Depot/jjj
 # ========================================================================= #
       def use_this_cookbook(i)
-      cliner {
-      opn; warn 'DEBUG at line '+__LINE__.to_s+': in method use_this_cookbook(), remove me slowly.'
-      warn i
-      }
       if File.file? i
-      opn; e 'Using the cookbook file `'+i+'`.'
+      opne 'Using the cookbook file `'+i+'`.'
       elsif File.directory? i
-      opn; e 'Using the cookbook directory `'+i+'`.'
+      opne 'Using the cookbook directory `'+i+'`.'
       end
       database_loader.initialize_dataset(i) # load a new yaml dataset.
       seek_program # already contains the right program, but may
@@ -879,7 +848,7 @@
 # Add further Options, but only if configure_options
 # includes no --prefix option.
       unless GOBOLINUX_LAYOUT == '1'
-      opn; e 'Appending --prefix=/usr to '+@object_configure_string.string?
+      opne 'Appending --prefix=/usr to '+@object_configure_string.string?
       @object_configure_string.append '--prefix=/usr'
       end
       end
@@ -894,7 +863,7 @@
 # database_loader.configure_command kann hier nit '' sein
 # HERE, configure is DONE and FINISHED. :)
       cliner {
-      opn; e 'Configure finished using this syntax:'
+      opne 'Configure finished using this syntax:'
       opn; cfile @object_configure_string.string
       }
       elsif @build_type == :cmake
@@ -905,7 +874,7 @@
       run_premake_commands
 # Did we supply different make options? We check here for that.
       unless database_loader.make_options.nil? or database_loader.make_options.empty?
-      opn; e 'Doing different make options next.'
+      opne 'Doing different make options next.'
       make_options = database_loader.make_options
       split_character = ','
       if make_options.count(';') > make_options.count(split_character)
@@ -1084,9 +1053,9 @@
 # =================================================================== #
       if @run_configure_script
       if @run_simulation
-      opn; e 'Normally we would run the configure command above now '+
+      opne 'Normally we would run the configure command above now '+
       'but since'
-      opn; e 'we are in simulation mode, we will not run it.'
+      opne 'we are in simulation mode, we will not run it.'
       else # ============================================================ #
 # Check if a configure script exists. Remember though, we must
 # check its absolute location - we could have entered a BUILD/
@@ -1210,8 +1179,8 @@
 # ry htop feedback_urls
 # ========================================================================= #
       def feedback_urls(i = %w( sushi cheese gnomedocuments totem empathy gnomegames ) )
-      opn; e 'Fetching URLs now for these programs:'
-      opn; e '  '+i.join(', ')
+      opne 'Fetching URLs now for these programs:'
+      opne '  '+i.join(', ')
       i.each { |f|
       @query.check_for(f)
       database_loader.feedback_url
@@ -1462,7 +1431,8 @@
 # Copy the whole yaml file:
 #   ry x gcy
 # ======================================================================= #
-      when 'copy_yaml','copyyaml','clone','dump_yaml','dyaml','generate_yaml',
+      when 'copy_yaml',
+      'copyyaml','clone','dump_yaml','dyaml','generate_yaml',
       'generate_custom_yaml','gcy','to_yaml','generateyaml'
       database_loader.generate_custom_yaml(:all) # bl $BT/database_loader.rb
       exit_program
@@ -1482,16 +1452,6 @@
       InteractiveTutorial.new
       exit_program
       else # Else tag.
-# ================================================================== #
-# Here we check if i includes a -- AND a =
-# We assume that we can get rid of the -- first and the split it.
-# The first element is the method name, the second the argument to
-# it.
-# ================================================================== #
-      if i.include?('--') and i.include?('=')
-      splitted = i.gsub(/--/,'').split('=')
-      method_name = splitted[0]
-      case method_name # do sanitizing here.
 # Specify a build dir
 #   ry pango --subdir=HIII
       when 'set_build_dir','build-dir','build_dir','subdir'
@@ -1523,14 +1483,14 @@
 # ========================================================================= #
       def run_configure_script
       if @run_configure_script
-      opn; ef 'Now running configure script from '; cdirf Dir.pwd; e ':'
+      opnef 'Now running configure script from '; cdirf Dir.pwd; e ':'
       @configure_string.do_not_use_a_prefix if @do_not_use_a_prefix
       @configure_string.modify_prefix(@prefix)
       @configure_string.leading_part = @configure_prefix unless @configure_prefix.empty?
 # Fetch the configure options. Append them simply.
       @configure_string.append(@data['program_name'].configure_options)
       _ = @configure_string._
-      opn; e '  '+_
+      opne '  '+_
       sys(_)
       end
       end
@@ -1563,7 +1523,7 @@
 # ========================================================================= #
       def start_compiling
 #set_program_to_compile(@aliases.real_alias) # sync it here. HMM.
-      opn; ef 'Now compiling `'; fancyf @_; e'`.'
+      opnef 'Now compiling `'; fancyf @_; e'`.'
       @data = SanitizeProgramEntry.new(@_, data)
 # @query = Query.new(@program_to_compile) # This must be looked into still.
       set_prefix # On startup and reset(), we set the @prefix variable.
@@ -1647,9 +1607,11 @@
 # ========================================================================= #
       def determine_build_type
 # @build_type can be :configure :cmake :scons :perl :ruby :haskell
+#
 # Inside these general build types you can use subtypes, for example,
 # :ruby1 means to install in RINSTALL1 fashion, :ruby2 means to
 # install in RINSTALL2 fashion.
+#
 # By default it is :configure which means "GNU autoconfigure based
 # system. We need to be careful here, to ensure that the @build_type
 # will be correct.
@@ -1687,7 +1649,6 @@
       end
       }
 #else # else really not included
-      end
       end
       end; private :add_use_flags
 # ========================================================================= #
@@ -1828,7 +1789,7 @@
 # ========================================================================= #
       def search
       find_all_packages @_
-      opn; e 'We will also search in our cookbook files for the '+
+      opne 'We will also search in our cookbook files for the '+
       'entry `'+@_+'` next.'
       search_in_cookbook_files @_
       end
@@ -1840,7 +1801,7 @@
       when true  then @debug = false
       when false then @debug = true
       end
-      opn; e "Changing @debug variable to `#{@debug}` now."
+      opne "Changing @debug variable to `#{@debug}` now."
       save_yaml(DEBUG_FILE, @debug)
       exit_program
 # ========================================================================= #
@@ -1852,7 +1813,7 @@
       def use_specific_build_directory(i = DEFAULT_NAME_BUILD_DIRECTORY, be_verbose = true)
       i = DEFAULT_NAME_BUILD_DIRECTORY if i.nil? # default
       if be_verbose
-      opn; e 'We will use the build directory `'+sdir(i+'/')+'`.'
+      opne 'We will use the build directory `'+sdir(i+'/')+'`.'
       end
       @use_build_directory = T
       @use_this_build_directory = i
@@ -1872,12 +1833,12 @@
       opn; cif 'Using the special build directory called: `'; cdirf rds(@base_dir+'/'+_); e '`'
       if run_simulation?
       opn; cif 'We would now create the directory '; cdir _
-      opn; e 'But since we are running in simulation mode, we '+
+      opne 'But since we are running in simulation mode, we '+
       'will not create it.'
       else
       if File.exist? _ # First, remove the old directory if it exists. This is useful for
-      opn; ef 'The build-directory '; cdirf _+'/'; e ' already exists.'
-      opn; e 'We remove it so that we can make a fresh start.'
+      opnef 'The build-directory '; cdirf _+'/'; e ' already exists.'
+      opne 'We remove it so that we can make a fresh start.'
       remove_directory _
       end
       create_directory _ # Now create this directory.
@@ -1916,7 +1877,7 @@
       register.run_simulation = run_simulation?
       register.register if @continue_after_configure_phase
       else
-      opn; e 'Not registering `'+program+'` because we have '\
+      opne 'Not registering `'+program+'` because we have '\
       'disabled that in the config file.'
       end
       end
@@ -1931,17 +1892,9 @@
 #   rinst all
 #   rinst make.tar.bz2
 # ======================================================================= #
-      require 'rbt'
       module RBT
       class InstallPackage
 # ========================================================================= #
-# ARRAY_EXCLUDE_THESE_PROGRAMS - These programs will be excluded if we
-# install every packages from /Depot/Packages.
-# ========================================================================= #
-      ARRAY_EXCLUDE_THESE_PROGRAMS = %w(
-      /Depot/Packages/X11.tar.bz2
-      )
-# ========================================================================= #
 # === initialize
 # init section
 # ========================================================================= #
@@ -1952,13 +1905,6 @@
       install_package unless @arguments.nil?
       end
 # ========================================================================= #
-# === set_arguments
-# ========================================================================= #
-      def set_arguments(i)
-      @arguments = *i
-      @arguments = @arguments.to_a if @arguments.is_a? String
-      end
-# ========================================================================= #
 # === reset
 # ========================================================================= #
       def reset
@@ -1994,22 +1940,6 @@
       end
       end
 # ========================================================================= #
-# === check_for_specific_arguments
-#
-# This is some kind of option parser. Its very primitive though.
-# rpack
-#   rpack xosd-2.2.12-GoboLinuxStyle-paco.tar.bz2 --to=/pkg
-# ========================================================================= #
-      def check_for_specific_arguments
-      if @arguments.to_s.include?('--to=')
-      @arguments.to_s =~ /--to=(\/.*)/
-      @symlink_into = $1.dup
-      @install_mode = :one_package_different_symlink
-      _ = @arguments.join(' ').gsub(/--to=(\/.*)/,'')
-      @arguments = _.split ' '
-      end
-      end
-# ========================================================================= #
 # === install_package
 #
 # installs a package. @install_mode can be the location
@@ -2037,27 +1967,16 @@
       )
       end
       end
-# ========================================================================= #
-# === do_real_install
-#
-# The system command to install something.
-# ========================================================================= #
-      def do_real_install(target_location, optional_target = nil)
-      if target_location.is_a? Array
-      target_location.each { |member|
-      do_real_install(member,optional_target) # iterate
-      }
-      else
 # ===================================================================== #
 # Now we can simply extract it
 # ===================================================================== #
-      opn; ef 'Now installing: '; cii target_location
+      opnef 'Now installing: '; cii target_location
       extracter = Extracter.new(target_location)
       extracter.extract_to(CONFIG.packages_dir)
       end
       end
 --------------------------------------------------------------------------------
-(4) → rbt glib --use-this-version=2.72.3
+(9) → rbt glib --use-this-version=2.72.3
       But this was quite verbose.
       For RBT::Installer, the above syntax will work (eventually),
       but you can also use the @ syntax (which already does
@@ -2121,15 +2040,6 @@
 # ======================================================================= #
       if block_given?
       yielded = yield
-# =================================================================== #
-# Else we have not passed a Hash, but perhaps we did pass a Symbol.
-# =================================================================== #
-      case yielded
-      when :do_not_check_whether_the_program_exists
-      @honour_check_to_ensure_that_the_program_exists = false
-      end
-      end
-      end
 # ========================================================================= #
 # === initialize_dataset_for_this_program
 #
@@ -2533,8 +2443,7 @@
 # Create a graphviz image by invoking RGraphvizWrapper.rb
 # ========================================================================= #
       def graphviz_create_image
-      opn
-      e 'Creating graphviz image next:'
+      opne 'Creating graphviz image next:'
       begin
       require 'graphviz'
       rescue LoadError => error
@@ -2625,14 +2534,6 @@
       cii ' => Reporting dependencies of all our programs next.'
       @dependencies.each { |k, c| cii "*) #{'%-17s' % k} depends on #{'%+52s' % c}"}
 # ========================================================================= #
-# === silent_include?
-# silent_include just returns true or false, depending on whether we have
-# the sought application or whether we dont
-# ========================================================================= #
-      def silent_include?
-      return_value = includes?
-      return return_value
-# ========================================================================= #
 # === daemonize
 # This will daemonize the script, so you can query the background data.
 # Yes, the Accessor Object itself can put itself into the background, this
@@ -2704,11 +2605,6 @@
       else
       @dependency_frequency_hash[v] += 1
       end
-      end
-      end
-      end
-      end
-      end
 # ======================================================================= #
 # At this point we did finish to build our dependency hash.
 # An example look of a typical entry comes next:
@@ -2777,6 +2673,7 @@
 # Next, .rb files residing under "rbt/misc".
 # =========================================================================== #
       require 'rbt/misc/build_detector.rb'
+      ^^^ do we have this? I think so.
 # =========================================================================== #
 # Require important rbt/toplevel_methods/ files next.
 # =========================================================================== #
@@ -2851,14 +2748,6 @@
 # ======================================================================= #
       cd :log_directory, :be_quiet # Silent cd.
       end
-# DEPRECATED
-      require 'rbt/beautify_configure_help_output'
-      require 'rbt/fetch_all_m4_macros.rb'
-      require 'rbt/generate_rbt_configuration.rb'
-      require 'rbt/generate_shellscript.rb'
-      require 'rbt/scons.rb' # For Scons support.
-      require 'rbt/symlink_program.rb'
-      require 'rbt/programs_backup.rb'
       module RBT
       class Compile < Base
 # ========================================================================= #
@@ -2900,7 +2789,8 @@
 #
 # ry php5 cdeb
 # ======================================================================= #
-      when 'todeb','2dep','create_debs','cdeb','cdebs','cdep','deb'
+      when 'todeb','2dep','create_debs','cdeb',
+      'cdebs','cdep','deb'
       create_debian_package
 # ======================================================================= #
 # === ry htop feedback
@@ -3028,8 +2918,6 @@
 # _ << prefix_to_use
       create_dependencies_file(prefix_to_use)
       create_description_file(prefix_to_use)
-      end
-      end
 # ======================================================================= #
 # Next check if we have to run a configure script or not.
 # ======================================================================= #
@@ -3152,6 +3040,8 @@
       case entry
       when 'last','las','la','l','LAST'
       entry = last_compiled_program?
+# ^^^ this is, I think, useful. Need to -recheck it if we can
+#     re-use this again.
 # ===================================================================== #
 # The program to compile is stored here in this variable for easier
 # access. It is an alias towards @compile_these_programs.
@@ -3191,7 +3081,6 @@
       @scons.set_prefix prefix
       @scons.run
       end
-
 # ========================================================================= #
 # === check_whether_to_use_a_build_directory
 #
@@ -3237,27 +3126,27 @@
       end
 # ry htop --tags pdf
 --------------------------------------------------------------------------------
-(5) → fix:
+(10) → fix:
       ry glibc ntrad dontsymlink --use-this-version=2.26
       ^^^
 --------------------------------------------------------------------------------
-(6) → someone on IRC: I am going to test creating valid gobolinux recipes
+(11) → someone on IRC: I am going to test creating valid gobolinux recipes
       with the RBT scripts.
       someone on IRC: in the long version
       rbt php generate_gobolinux_recipe
 --------------------------------------------------------------------------------
-(7) → Test autogeneration of gobolinux recipes.
+(12) → Test autogeneration of gobolinux recipes.
 --------------------------------------------------------------------------------
-(8) → --purge-old-version
+(13) → --purge-old-version
       ^^^ but only if we compile into the /Programs hierarchy and only
       if it was successful. so before this can be enabled, we need
       to have worked on "was this a success".
       ^^^ interesting.....
 --------------------------------------------------------------------------------
-(9) → At first make use of the ... thingy that fpm. then when we
+(14) → At first make use of the ... thingy that fpm. then when we
 # udnerstood it properly we can replace fpm and integrate it.
 --------------------------------------------------------------------------------
-(10) → When we compile this, also do a
+(15) → When we compile this, also do a
       restore/
       directory machen, sowohl wenn prefix /usr als auch
       gobolinux prefix.
@@ -3270,15 +3159,15 @@
       Für gobo prefix in:
       /Programs/Htop/7.5/restore/
 --------------------------------------------------------------------------------
-(11) → add a way to sync all CHANGED cookbooks
+(16) → add a way to sync all CHANGED cookbooks
       so we need a way to determine when the last update
       happened hmmmmmm. What does this even mean?
 --------------------------------------------------------------------------------
-(12) → -b, --batch
+(17) → -b, --batch
       Batch mode: avoid asking questions.
       Apply where? Hmm. In general, probably.
 --------------------------------------------------------------------------------
-(13) → Automated program compilation tool.
+(18) → Automated program compilation tool.
       Usage: Compile <program> [<version>]
       Options:
       -c, --configure-options <entry>
@@ -3315,7 +3204,7 @@
       -R, --no-requirements
       Do not process the Requirements script after installation
 --------------------------------------------------------------------------------
-(14) → From Freshen, add:
+(19) → From Freshen, add:
       - GetRecipe in ruby
       - GetRecipes only of installed
       programs AND only if newer version, dont flush /Files/Compile/Recipes
@@ -3323,7 +3212,7 @@
       anzeigen
       ^^ Clone Gobolinux Functionality.
 --------------------------------------------------------------------------------
-(15) → Handle these commandline instructions, which originated from the old
+(20) → Handle these commandline instructions, which originated from the old
       class RBT::Commandline but are not yet completely ported:
 # rbt --download=htop # <- implemented \o/
 # rbt --set-source-dir=/Files/Archive/
@@ -3339,16 +3228,16 @@
       opnn; RBT.permanently_set_source_directory($3.to_s.dup) { :be_verbose }
       ^^^
 --------------------------------------------------------------------------------
-(16) → integrate gobolinux loader.
+(21) → integrate gobolinux loader.
       This works semi-ok ... some bugs still exist
       ALSO we must check for recipe-type still.
       but aside from this, this should be doable.
       we could also use this to load a gobo recipe :)
 --------------------------------------------------------------------------------
-(17) → enable:
+(22) → enable:
       set_configure_base_dir
 --------------------------------------------------------------------------------
-(18) → Hmmm. Wenn wir "Compile bla" machen dann sollten wir auch eine
+(23) → Hmmm. Wenn wir "Compile bla" machen dann sollten wir auch eine
       yaml datei erstellen, die ALL die relevante Information hat.
       So können wir nämlich copy/pasten ...
       Also wahrscheinlich noch eine Yaml Datei erstellen.
@@ -3360,55 +3249,13 @@
       aber zuerst mal sollten wir das "compiled program" überlegen b
       ob success war oder nit
 --------------------------------------------------------------------------------
-(19) → add:
+(24) → add:
       --enable-everything
       ^^^ this enables all --enable and all --with
       This has been added but not yet documented.
       It is also a bit buggy and only works for --enable-related entries.
 --------------------------------------------------------------------------------
-(20) → Write SIMPLE ruby-gtk bindings STANDALONE.
-      ^ Nur die core functionality.
-      ^^^ das dann inkludieren.
-      Display RBT Version here.
-      ______________________________________________________________________
-      [ display available programs here] |
-      via drop down listing         |
-      | INPUT FIELD ___
-      | ^^^compile this program
-      |   button [start compiling]
-      RESULT MESSAGES WILL SHOW UP HERE.
-      alias gtk_compile
-      SYSTEM/compile_program.rb:
---------------------------------------------------------------------------------
-(21) → 1) Rewriting RBT (Rewriting RBT once again!):
-      1a) → if we rewrite rbt then start with the "does the file
-      exist locally". If yes, go through it.
-      Well this needs a bit more planning...
-      AND when it works, document it.
-      ^^^^^
-      1b) → during the rewrite we must enable --expand to read from the
-      expanded dataset too, rather than loading the original yaml
-      file and sanitizing it. The user must be able to decide
-      on his or her own here.
-      ^^^
-      1c) → if we rewrite RBT then perhaps we should first
-      write the logic into a standalone file,
-      which then gets loaded and parsed.
-      This all needs more planning though. we will do the three
-      things or rather two things at a later time ...
-      Use some indent way or so:
-      Hmmm. If we have a separate logic-file:
-      Just describe things in a general way. And handle these sub-tasks
-      individually.
-      - extract_archive
-      - compile_or_install # For packages too.
-      - compile_step (cmake, configure etc..)
-      extract archive
-      if file exists
-      else
-      and perhaps also start with a test case or so.
---------------------------------------------------------------------------------
-(22) → enable sinatra bindings to rbt core functionality
+(25) → enable sinatra bindings to rbt core functionality
       For example:
       install/name/version
       ^^^ version is optional
@@ -3430,7 +3277,7 @@
       Yeah we must extend UrlAction and we must add more
       HtmlTemplate instances as well.
 --------------------------------------------------------------------------------
-(23) → Add the ability to uninstall packages with dependencies.
+(26) → Add the ability to uninstall packages with dependencies.
       add action:
       Uninstall.new :htop
       ^^^^ this works only a bit so far e. g. we can uninstall directories
@@ -3438,23 +3285,23 @@
       and this will uninstall the other files that belong to this
       package.
 --------------------------------------------------------------------------------
-(24) → write a script that tells us which programs are
+(27) → write a script that tells us which programs are
       available in a statically compiled manner.
       Work through things such as:
       coreutils
       binutils
       and then figure out which one is static.
 --------------------------------------------------------------------------------
-(25) → 
+(28) → 
       rbt: add a toplevel method that checks for the correct
       program
 --------------------------------------------------------------------------------
-(26) → -> - enhance the GUI things from the get go, perhaps even
+(29) → → - enhance the GUI things from the get go, perhaps even
       via jruby. yeah.
-      -> - make sure it works on windows from the get go as well
+      → - make sure it works on windows from the get go as well
       and test it!
-      -> - start via action DRIVE the actions forward.
-      -> - also when we do a GUI, make it via tabs, including for libui
+      → - start via action DRIVE the actions forward.
+      → - also when we do a GUI, make it via tabs, including for libui
       so that we have all awesome functionality in a single GUI
       really. also visually pretty; first in gtk though.
       then libui.
@@ -3462,20 +3309,20 @@
       however had before we do so, start with slow polishing
       so that the whole RBT suite becomes better
 --------------------------------------------------------------------------------
-(27) → We need a way to work with SQL dataset too rather than
+(30) → We need a way to work with SQL dataset too rather than
       .yml flatfiles. This now works a bit via RBT::CompileViaSQLDatabase.
       Needs to be improved further.
       Also read up on Sequel for this. Once we understand it, try to
       transition to using Sequel.
       ^^^ also add class
 --------------------------------------------------------------------------------
-(28) → add --backend=
+(31) → add --backend=
       for rbt compile to specify sqlite, or raw-yaml,
       expanded, expanda-dataset + explain it
       One day we should be able to specify this.
       For now (2022) we let it go.
 --------------------------------------------------------------------------------
-(29) → we should rewrite the project. The meta-goals are:
+(32) → we should rewrite the project. The meta-goals are:
       (1) support on windows for compilation
       ^^^ but this does not work.
       Also add more specifications in this regard.
@@ -3485,11 +3332,11 @@
       and how to query it. So investigate SQL.
       and make this work on windows as well.
 --------------------------------------------------------------------------------
-(30) → allow just a single src_dir, without subdirectories
+(33) → allow just a single src_dir, without subdirectories
       via some configuration value or so. also an ENV
       setting and commandline.
 --------------------------------------------------------------------------------
-(31) → enable support for:
+(34) → enable support for:
       rbt --compile_all_of=science
       rbt --tag_compile=science
       rbt --compile_these_tags=php
@@ -3498,7 +3345,7 @@
       ^^^ ok rewrite this ... or at the least the part that is faulty
       UNTIL THIS OWRKS
 --------------------------------------------------------------------------------
-(32) → Expand RBT.action() until we have listed ALL actions there.
+(35) → Expand RBT.action() until we have listed ALL actions there.
       Evaluate at some point in the future when this will be
       achieved.
       ^^^ also port bin/FILES into this, until this is done. We really
@@ -3512,7 +3359,7 @@
       Once that is all done, perhaps in 2023 or so,
       remove this todo entry here.
 --------------------------------------------------------------------------------
-(33) → tocd; cd icu4c; appdir *
+(36) → tocd; cd icu4c; appdir *
       appdir *
       -rw-r--r-→ 1 root root 13M Dec 21 03:02 icu4c-60.2.tar.xz
       -rw-r--r-→ 1 root root 13M Dec 21 03:02 icu4c-61.1.tar.xz
@@ -3529,24 +3376,24 @@
       ^^^ it already is part of RBT. Already handled via actions
       so enable this and then document this!
 --------------------------------------------------------------------------------
-(34) → Install all the package managers on the computer system.
+(37) → Install all the package managers on the computer system.
       ^^^ document this as well in a new subsection.
       → add a new subsection. [DONE]
       → dpkg/apt was mentioned but next is pacman.
       → rpm + dnf
 --------------------------------------------------------------------------------
-(35) → und permission checking for RBT.
+(38) → und permission checking for RBT.
       ^^^^ we must check this for windows, whether
       we are even allowed to create a directory
       or not.
 --------------------------------------------------------------------------------
-(36) → Consider adding:
+(39) → Consider adding:
       --silent
       --silence
       --quiet
       or so to show less, or something like that.
 --------------------------------------------------------------------------------
-(37) → Der check auf "if makefile exists"
+(40) → Der check auf "if makefile exists"
       soll nicht gemacht werden wenn wir:
       - ruby
       - python
@@ -3559,8 +3406,7 @@
       ^^^ alos nur wenn es ein compiled-thing is.
       hmmmmmm das mach ma eh schon oder?
 --------------------------------------------------------------------------------
-(38) → (1)
-      This used to work in the past I think:
+(41) → This used to work in the past I think:
 # ======================================================================= #
 # === ry htop check_for_library
 # ======================================================================= #
@@ -3571,13 +3417,13 @@
       'cfl'
       check_for_library
 --------------------------------------------------------------------------------
-(39) → FEATURE:
+(42) → FEATURE:
       enable all of FPM. Start via slackware packages:
       ry htop --create-slackware-package
       ^^^ this should work......
       ry php --create-slackware-package
 --------------------------------------------------------------------------------
-(40) → work on:
+(43) → work on:
       --no-harm
       ^^^ equivalent to --simulate-only
       ry htop --no-harm
@@ -3587,7 +3433,7 @@
       It is not yet finished.
       Probably will take a long time...
 --------------------------------------------------------------------------------
-(41) → add a way for displaying downloadable programs eg
+(44) → add a way for displaying downloadable programs eg
       rbt --show-downloadable-programs
       rbt --downloadable-programs?
       ^^^ add ? and document it and mention it
@@ -3603,56 +3449,55 @@
 #^^^ uniq
       THEN UPLOAD!
 --------------------------------------------------------------------------------
-(42) → re-do RBT hmmm but select some specific things
+(45) → re-do RBT hmmm but select some specific things
       to improve while re-doing this.
       - fix the /home/programs/ issue.
       AND perhaps describe the components, each step...
       error messages too and what not
 --------------------------------------------------------------------------------
-(43) → alias gcc_11.3.0='rbt gcc --use-this-version=11.3.0 --ntrad'
+(46) → alias gcc_11.3.0='rbt gcc --use-this-version=11.3.0 --ntrad'
       ^^^ fix this issue
       ^^^
       gcc1130
       then copy to the other computer
       and fix some opn-related problem
 --------------------------------------------------------------------------------
-(44) → fix "make -j" in rbt.
+(47) → fix "make -j" in rbt.
 --------------------------------------------------------------------------------
-(45) → also, once the two OLD *rb files were ported
+(48) → also, once the two OLD *rb files were ported
       work through compile-menu step by step
       work it through, make sure it all works as-is.
 --------------------------------------------------------------------------------
-(46) → Continue to improve report for class Cookbook
+(49) → Continue to improve report for class Cookbook
       this should be used rahter than Display ... the latter
       should probably be removed altogether. hmmmmm.
       ^^^ evaluate this. No clue whether we should keep it
       or not. It is actually used in RBT::Compile.
-
 --------------------------------------------------------------------------------
-(48) → make sure that the installation_steps work? hmmmmmmmmmmmmmmmm
+(50) → make sure that the installation_steps work? hmmmmmmmmmmmmmmmm
       and document this a bit as well once this works.
 --------------------------------------------------------------------------------
-(49) → add a SQL database that contains all that information as-is,
+(51) → add a SQL database that contains all that information as-is,
       rather than use expanded cookbook files. This should be
       faster to query on windows in particular.
 --------------------------------------------------------------------------------
-(50) → /System/Index/bin/ld: error: cannot find -lgtkmm-3.0
+(52) → /System/Index/bin/ld: error: cannot find -lgtkmm-3.0
       ^^^ register such an error
       AND at the least colourize this in red, the message that is [DONE THIS PART]
       ^^^
 --------------------------------------------------------------------------------
-(51) → add a kill-compile-button or so
+(53) → add a kill-compile-button or so
       but we must determine the PID
       ^^^ the functionality now exists but we need to
       re-arrange the button there. align it rightwards
 --------------------------------------------------------------------------------
-(52) → When we repackage something, and an extracted dir with the same
+(54) → When we repackage something, and an extracted dir with the same
       name already exists, then we notify the user of that, create a
       new dir called
       /REPACKAGING/name_here/ # if that latter name exists already, delete it.
       That way we can compile the same app again.
 --------------------------------------------------------------------------------
-(53) →  # ======================================================================= #
+(55) →  # ======================================================================= #
 # === @simple_or_complex
 #
 # This determines whether to sanitize the dataset (when we use :simple)
@@ -3666,26 +3511,26 @@
 # need to add the expand-dataset part first before we can change this.
 # ======================================================================= #
 --------------------------------------------------------------------------------
-(54) → make it possible to compile a local archive, a local
+(56) → make it possible to compile a local archive, a local
       file, even if it is not registered.
       ^^^ test this.
       if check_whether_the_given_input_is_a_file_and_does_exist? and
       does_this_file_exist_and_is_it_a_file?(this_program) # This may be the case when the user supplied a path.
       ^^^
 --------------------------------------------------------------------------------
-(55) → We need to get a minimal tk for ruby on windows to work.
+(57) → We need to get a minimal tk for ruby on windows to work.
       The idea is really to keep this super simpler.
       tk-entries + buttons.
       compile
 --------------------------------------------------------------------------------
-(56) → Write some class that scans config.log and similar
+(58) → Write some class that scans config.log and similar
       files for problems automatically,  so that I no
       longer have to read these awful files manually.
       RBT::ConfigLogParser handles this.
       We probably have to improve on it.
       But how to test it? Hmmm.
 --------------------------------------------------------------------------------
-(57) → ry libpng --trad --cmake
+(59) → ry libpng --trad --cmake
       RBT::Compile: Using a "traditional" strategy for compilation (which means prefix /usr/).
       RBT::Compile: We will use cmake rather than make.
       RBT::Compile: Making use of these special environment variables:
@@ -3718,22 +3563,22 @@
       sollte cmake verwenden!!!!!
       ^^^ THIS SHOULD DISPLAY THE BUILD SYSTEM AS CMAKE.
 --------------------------------------------------------------------------------
-(58) → Add the ability to safely remove unneeded packages.
+(60) → Add the ability to safely remove unneeded packages.
 --------------------------------------------------------------------------------
-(59) → add:
+(61) → add:
       rbt --upload-programs-version
       ^^^ enable this
 --------------------------------------------------------------------------------
-(60) → Finish the rewrite of the gnome-thingy.
+(62) → Finish the rewrite of the gnome-thingy.
       Or perhaps start anew there.
 --------------------------------------------------------------------------------
-(61) → ry php use_cookbook=/Depot/jjj
+(63) → ry php use_cookbook=/Depot/jjj
       ^^^ add the above and also add to rbtcgi page...
       this way we can use any other cookbook file. (if is directory
       then we read all into it, otherwise specifiy here.)
       dann in rbtcgi übertragen.
 --------------------------------------------------------------------------------
-(62) → build proper slackware packages for 64 bit
+(64) → build proper slackware packages for 64 bit
       auto-store them into /Depot/Packages/ if that
       directory exists # yup, no matter if on-roebe or
       not
@@ -3750,16 +3595,13 @@
       exists as-is
       CONTINUE HERE THEN AFTERWARDS
 --------------------------------------------------------------------------------
-(63) → add some script that checks whether
+(65) → add some script that checks whether
       any program has been updated or not.
       This shall replace manual update stuff.
       ^^^^ hmmm.
       that class shall show to use which programs could be updated.
 --------------------------------------------------------------------------------
-(64) → Mach wieder ein LFS.
-      hmmmm
---------------------------------------------------------------------------------
-(65) → When the user uses --dontsymlink, then do not make a Current symlink
+(66) → When the user uses --dontsymlink, then do not make a Current symlink
       doing so breaks gcc-compilation!
       ry gcc ntrad --use-this-version=6.4.0 --dont-symlink
       RBT::Compile: Setting to the specific version `6.4.0` now.
@@ -3812,31 +3654,31 @@
       Unregistered error: configure_error (class: Symbol)
       RBT::Compile: The program `gcc` could not be installed.
 --------------------------------------------------------------------------------
-(66) → In RBT rbt, make a GUI that shows the result per line,
+(67) → In RBT rbt, make a GUI that shows the result per line,
       into a textview widget - live, when compiling something.
       Unfortunately this does not work well when RBT::Compile
       alos makes use of IO.open() and such. We may have to
       redesign the whole project.
 --------------------------------------------------------------------------------
-(67) → esnure that the another program name such as GCC works.
+(68) → ensure that the another program name such as GCC works.
       also add:
       use_this_program_name_on_gobolinux:
       Basic support for this has been added, but something doesn't
       quite yet work fully there.
 --------------------------------------------------------------------------------
-(68) → ry atk --ntrad --is-on-gobolinux
+(69) → ry atk --ntrad --is-on-gobolinux
       ^^^ enable this
 --------------------------------------------------------------------------------
-(69) → errors.yml
+(70) → errors.yml
       ^^^ fgather ALL errors here.
 --------------------------------------------------------------------------------
-(70) → run through a chain again aka a chroot.
+(71) → run through a chain again aka a chroot.
 --------------------------------------------------------------------------------
-(71) → Wenn die configure stage failed, dann brauchen wir auch gar
+(72) → Wenn die configure stage failed, dann brauchen wir auch gar
       nicht make aufrufen:
       result = `./configure`
 --------------------------------------------------------------------------------
-(72) → someone on IRC: "If only i could feed a Dependencies-dump back into
+(73) → someone on IRC: "If only i could feed a Dependencies-dump back into
       CheckDependencies and get a list of actual dependencies
       that violates the ones listed for the recipe."
       reply: sounds like a feature request!
@@ -3846,10 +3688,6 @@
       to run a comparison between BuildInformation and Dependencies
       in some way to indicate missing or obsolete info in the latter
 --------------------------------------------------------------------------------
-(73) → incorporate build systems priorities yml file
-      but we need to test it on some program
-      perhaps gnome program
---------------------------------------------------------------------------------
 (74) → https://github.com/calf-studio-gear/calf/archive/0.90.0.tar.gz
       ^^^ support github variants like the above
       this should automatically fix-in the right
@@ -3940,13 +3778,7 @@
       opn; warn 'use the "'+@use_traditional_strategy[1]+'" option.'
       sleep 0.8
       end
---------------------------------------------------------------------------------
-(80) → rewrite it again? hmmmmmm...
-      fix 3 bugs during that rewrite:
-      1) ry M4 ntrad --use-this-as-program-name=M62
-      homepage tag has to be added still
-      ^^^ and add homepage tags... this is simple
-      also port old code well
+
 --------------------------------------------------------------------------------
 (81) → When we enable gobolinux functionality we should NOT use certain
       programs such as:
@@ -5241,3 +5073,20 @@
 (214) → convert to non-traditional
       must be rewritten. it makes no longer sense.
 --------------------------------------------------------------------------------
+(215) → add an interactive compile-shell
+      the idea here is to continually run that compile-shell and keep
+      on compiling and installing stuff, constantly showing to the
+      user the current status e. g. what is installed, what can be
+      upgraded and what not. the idea here is to completely finish
+      all tasks from within that interactive compile shell.
+--------------------------------------------------------------------------------
+
+
+
+1001:
+if expanded cookboks .yml file can not be found
+and if is on roebe
+expand it first, then
+re-try.
+and explain why this is done.
+^^^^