RubyGems - roebe - Versions diffs - 0.5.191 → 0.6.5 - Mend

roebe 0.5.191 → 0.6.5

Files changed (173) hide show

checksums.yaml +4 -4
data/README.md +89 -41
data/bin/create_my_directories +2 -2
data/bin/{ruby_dhcpcd → dhcpcd_wrapper} +1 -1
data/bin/start_lighty +1 -1
data/doc/README.gen +78 -15
data/doc/core/array.md +24 -23
data/doc/core/gem_and_gemspec.md +12 -11
data/doc/core/hash.md +6 -0
data/doc/core/misc.md +23 -20
data/doc/core/regex.md +1 -1
data/doc/core/stderr.md +16 -0
data/doc/deprecations/deprecations.md +2 -1
data/doc/statistics/statistics.md +1 -0
data/lib/roebe/actions/actions.rb +80 -0
data/lib/roebe/base/colours.rb +52 -19
data/lib/roebe/base/misc.rb +30 -1
data/lib/roebe/base/opnn.rb +7 -0
data/lib/roebe/browser/output_url_then_open_in_browser.rb +18 -15
data/lib/roebe/classes/alltagsgeschichte.rb +1 -1
data/lib/roebe/classes/at.rb +2 -2
data/lib/roebe/classes/auto_rename_file_based_on_its_creation_date.rb +24 -12
data/lib/roebe/classes/books/books.rb +234 -142
data/lib/roebe/classes/books/finished_books/finished_books.rb +10 -3
data/lib/roebe/classes/books/menu.rb +25 -16
data/lib/roebe/classes/books/sanitize_this_book_path/sanitize_this_book_path.rb +0 -1
data/lib/roebe/classes/check_yaml.rb +15 -11
data/lib/roebe/classes/compile_kernel.rb +3 -1
data/lib/roebe/classes/contacts/contacts.rb +104 -0
data/lib/roebe/classes/contacts/gui/universal_widgets/contacts.rb +168 -0
data/lib/roebe/classes/contacts/shared_code.rb +344 -0
data/lib/roebe/classes/copy_kernel_config.rb +5 -3
data/lib/roebe/classes/create_desktop_file.rb +1 -1
data/lib/roebe/classes/create_file_skeleton/constants.rb +1 -1
data/lib/roebe/classes/create_file_skeleton/generate_ruby_string.rb +20 -20
data/lib/roebe/classes/create_file_skeleton/reset.rb +19 -16
data/lib/roebe/classes/create_my_directories.rb +12 -10
data/lib/roebe/classes/dhcpcd/{dhcpcd.rb → dhcpcd_wrapper.rb} +137 -95
data/lib/roebe/classes/dhcpcd/kill_dhcpcd.rb +2 -2
data/lib/roebe/classes/do_install.rb +7 -6
data/lib/roebe/classes/done.rb +1 -1
data/lib/roebe/classes/downcase_extension.rb +4 -4
data/lib/roebe/classes/email.rb +44 -40
data/lib/roebe/classes/enable.rb +1 -1
data/lib/roebe/classes/generate_alsa_conf.rb +4 -4
data/lib/roebe/classes/generate_overview_of_the_locally_available_books.rb +5 -3
data/lib/roebe/classes/github.rb +1 -1
data/lib/roebe/classes/kde/install_this_konsole_theme.rb +1 -1
data/lib/roebe/classes/{handle_lighttpd.rb → lighttpd/lighttpd_wrapper.rb} +55 -47
data/lib/roebe/classes/make_gem.rb +49 -35
data/lib/roebe/classes/mbl.rb +6 -4
data/lib/roebe/classes/readme_generator/readme_generator.rb +597 -1
data/lib/roebe/classes/remove_trailing_newline.rb +82 -0
data/lib/roebe/classes/report_how_many_files_are_in_this_directory.rb +83 -0
data/lib/roebe/classes/rxinitrc/constants.rb +7 -5
data/lib/roebe/classes/rxinitrc/rxinitrc.rb +8 -4
data/lib/roebe/classes/set_background.rb +14 -0
data/lib/roebe/classes/show_ten_aliases.rb +15 -3
data/lib/roebe/classes/simple_boot_script.rb +1 -1
data/lib/roebe/classes/size_of.rb +9 -7
data/lib/roebe/classes/tales_from_the_crypt.rb +1 -1
data/lib/roebe/classes/update.rb +4 -11
data/lib/roebe/classes/upload_to_imgur.rb +64 -35
data/lib/roebe/commandline/misc.rb +28 -28
data/lib/roebe/constants/array_install_these_gem_projects.rb +1 -1
data/lib/roebe/constants/constants.rb +8 -1
data/lib/roebe/constants/emojis.rb +0 -19
data/lib/roebe/constants/file_and_directory_constants.rb +2 -2
data/lib/roebe/constants/misc.rb +10 -2
data/lib/roebe/constants/roebe.rb +2 -0
data/lib/roebe/custom_methods/module.rb +45 -16
data/lib/roebe/fonts/fonts.rb +39 -0
data/lib/roebe/gui/universal_widgets/books/books.rb +232 -0
data/lib/roebe/hello_world/hello_world.rb +0 -0
data/lib/roebe/irb/clean_irbrc +1 -0
data/lib/roebe/math/log10.rb +3 -3
data/lib/roebe/math/the_collatz_problem.rb +104 -0
data/lib/roebe/{toplevel_methods/lighttpd.rb → requires/require_lighttpd.rb} +2 -2
data/lib/roebe/shell/shell/shell.rb +6 -6
data/lib/roebe/shell_scripts/README.md +0 -0
data/lib/roebe/shell_scripts/bashrc +0 -0
data/lib/roebe/shell_scripts/konsole_tabs.sh +6 -0
data/lib/roebe/shell_scripts/lfs/001_binutils_1.sh +10 -2
data/lib/roebe/shell_scripts/lfs/002_gcc_1.sh +33 -3
data/lib/roebe/shell_scripts/lfs/003_linux_1.sh +1 -0
data/lib/roebe/shell_scripts/lfs/004_glibc_1.sh +5 -2
data/lib/roebe/shell_scripts/lfs/005_libstdc++_1.sh +8 -1
data/lib/roebe/shell_scripts/lfs/007_ncurses_2.sh +5 -2
data/lib/roebe/shell_scripts/lfs/020_xz_2.sh +5 -4
data/lib/roebe/shell_scripts/lfs/022_gcc_2.sh +15 -1
data/lib/roebe/shell_scripts/lfs/025_ruby_2.sh +13 -0
data/lib/roebe/shell_scripts/lfs/README.md +0 -0
data/lib/roebe/shell_scripts/lfs/lfs_build_variables.sh +56 -16
data/lib/roebe/toplevel_methods/module_methods.rb +5 -3
data/lib/roebe/toplevel_methods/to_mp3.rb +1 -1
data/lib/roebe/version/version.rb +2 -2
data/lib/roebe/wasm/README.md +7 -0
data/lib/roebe/wasm/enable_simple_puts_output.rb +9 -0
data/lib/roebe/wasm/wasm_examples.html +43 -0
data/lib/roebe/www/LEDS/LEDS.rb +35 -25
data/lib/roebe/www/RNA/RNA.cgi +42 -1
data/lib/roebe/www/algorithms/algorithms.rb +40 -0
data/lib/roebe/www/analytical_chemistry/content.md +6 -0
data/lib/roebe/www/animals/animals.cgi +25 -0
data/lib/roebe/www/bioanalytik/bioanalytik.cgi +90 -0
data/lib/roebe/www/biotechnology/biotechnology.rb +39 -3
data/lib/roebe/www/cellbiology/cellbiology.rb +19 -2
data/lib/roebe/www/chemistry/S/303/244uren_Basen_und_der_pH_Wert/S/303/244uren_Basen_und_der_pH_Wert.cgi +242 -0
data/lib/roebe/www/chemistry/chemistry.rb +10 -258
data/lib/roebe/www/chemistry/css_rules.css +67 -0
data/lib/roebe/www/chemistry/die_quantenzahlen/die_quantenzahlen.cgi +123 -0
data/lib/roebe/www/chemistry/funktionelle_gruppen_in_der_chemie/funktionelle_gruppen_in_der_chemie.cgi +52 -0
data/lib/roebe/www/chrome_and_chromium/chrome_and_chromium.rb +37 -42
data/lib/roebe/www/chromium +1 -0
data/lib/roebe/www/cognitive_biology/cognitive_biology.cgi +18 -3
data/lib/roebe/www/erste_hilfe/erste_hilfe.cgi +215 -62
data/lib/roebe/www/fonts/fonts.cgi +245 -0
data/lib/roebe/www/genomics/genomics.rb +4 -0
data/lib/roebe/www/hardware/computersysteme/computersysteme.rb +117 -102
data/lib/roebe/www/hardware/netzteile/netzteile.cgi +94 -0
data/lib/roebe/www/immunology/immunology.rb +131 -7
data/lib/roebe/www/insekten/insekten.md +27 -0
data/lib/roebe/www/lighttpd/autogenerated_lighttpd.conf +7 -3
data/lib/roebe/www/lighttpd/configuration/index.conf +7 -4
data/lib/roebe/www/lighttpd/lighttpd.rb +6 -6
data/lib/roebe/www/linux/antiX/antiX.rb +7 -4
data/lib/roebe/www/linux/linux.rb +9 -11
data/lib/roebe/www/linux/linuxmint/linuxmint.rb +33 -0
data/lib/roebe/www/linux/slackware/slackware.rb +136 -27
data/lib/roebe/www/linux/void/void.rb +34 -8
data/lib/roebe/www/linux_commands/linux_commands.rb +6 -6
data/lib/roebe/www/lyrics/lyrics.rb +1 -1
data/lib/roebe/www/metabolic_pathways/metabolic_pathways.rb +5 -1
data/lib/roebe/www/microbiology/microbiology.rb +17 -2
data/lib/roebe/www/mikrobielle_physiologie/mikrobielle_physiologie.cgi +1086 -2
data/lib/roebe/www/mitochondria/mitochondria.cgi +16 -2
data/lib/roebe/www/module_www.rb +2 -3
data/lib/roebe/www/neurobiology/neurobiology.rb +20 -3
data/lib/roebe/www/pdf/pdf.rb +13 -0
data/lib/roebe/www/physics/physics.rb +20 -4
data/lib/roebe/www/physiology/physiology.rb +5 -1
data/lib/roebe/www/play_this_video_file/play_this_video_file.cgi +1 -1
data/lib/roebe/www/programming_advice/programming_advice.cgi +36 -0
data/lib/roebe/www/programming_advice/programming_advice.md +358 -0
data/lib/roebe/www/psychologie/psychologie.rb +7 -1
data/lib/roebe/www/science/science.rb +6 -0
data/lib/roebe/www/sex_and_reproduction/sex_and_reproduction.cgi +18 -2
data/lib/roebe/www/statistik/statistik.rb +6 -1
data/lib/roebe/www/structural_biology/structural_biology.cgi +18 -0
data/lib/roebe/www/the_cell_cycle/the_cell_cycle.cgi +27 -0
data/lib/roebe/www/video/video.rb +1 -1
data/lib/roebe/www/virology/virology.rb +12 -1
data/lib/roebe/www/war_in_Ukraine_2022/war_in_Ukraine_2022.rb +70 -28
data/lib/roebe/www/waschmaschinen/waschmaschinen.rb +5 -4
data/lib/roebe/www/xfce/xfce.cgi +5 -4
data/lib/roebe/www/xorg/xorg.rb +3 -202
data/lib/roebe/www/yeast/yeast.rb +4 -2
data/lib/roebe/www/yubiko/yubiko.cgi +49 -0
data/lib/roebe/yaml/{autostart_these_programs.yml → autostart_these_programs/autostart_these_programs.yml} +7 -6
data/lib/roebe/yaml/books/favourite_books.yml +11 -9
data/lib/roebe/yaml/directory_structure.yml +2 -0
data/lib/roebe/yaml/use_this_editor/use_this_editor.yml +1 -0
metadata +39 -20
data/lib/roebe/classes/readme_generator/constants.rb +0 -21
data/lib/roebe/classes/readme_generator/initialize.rb +0 -38
data/lib/roebe/classes/readme_generator/misc.rb +0 -548
data/lib/roebe/classes/readme_generator/reset.rb +0 -28
data/lib/roebe/classes/readme_generator/run.rb +0 -20
data/lib/roebe/shell_scripts/lfs/lfs_variables.sh +0 -31
data/lib/roebe/www/cognitive_biology/cognitive_biology.html +0 -40634
data/lib/roebe/www/mikrobielle_physiologie/mikrobielle_physiologie.rb +0 -1055
data/lib/roebe/www/programming_advice/programming_advice.yml +0 -31
data/lib/roebe/yaml/main_editor.yml +0 -1

data/lib/roebe/constants/roebe.rb CHANGED Viewed

@@ -59,6 +59,8 @@ module Roebe
   # ========================================================================= #
   # === Roebe.file_contacts
+  #
+  # Return the path towards the file contacts.yml via this method here.
   # ========================================================================= #
   def self.file_contacts
     FILE_CONTACTS_YAML

data/lib/roebe/custom_methods/module.rb CHANGED Viewed

@@ -37,17 +37,17 @@ module CustomMethods # === Roebe::CustomMethods
   require 'open-uri'
   require 'roebe/project/project.rb'
   require 'roebe/custom_methods/constants.rb'
+  require 'roebe/actions/actions.rb'
   require 'roebe/constants/array_install_these_gem_projects.rb'
   require 'roebe/constants/constants.rb'
+  require 'roebe/requires/require_lighttpd.rb'
   require 'roebe/toplevel_methods/module_methods.rb' # Pulls in Roebe.vetmed? and similar methods.
-  require 'roebe/toplevel_methods/lighttpd.rb'
   require 'roebe/toplevel_methods/downcase_all_entries_in_the_current_directory.rb'
   require 'roebe/toplevel_methods/esystem.rb'
   require 'roebe/toplevel_methods/fibonacci.rb'
   require 'roebe/toplevel_methods/halloween.rb'
   require 'roebe/toplevel_methods/misc.rb'
   require 'roebe/toplevel_methods/rinstall2.rb'
-  require 'roebe/toplevel_methods/lighttpd.rb'
   require 'roebe/toplevel_methods/open_in_editor_and_browser.rb'
   require 'roebe/toplevel_methods/open_in_editor.rb'
   require 'roebe/toplevel_methods/increase_volume.rb'
@@ -212,6 +212,24 @@ BrowserApplication[$e]=!firefox
     end
   end
+  # ========================================================================= #
+  # === generate_files_for_the_ascii_paradise_project
+  # ========================================================================= #
+  def generate_files_for_the_ascii_paradise_project(
+      # ===================================================================== #
+      # === Batch-create
+      # ===================================================================== #
+      start_position = 81,
+      end_position   = 85,
+      name_of_the_ascii_paradise_component = 'dog_tries_to_catch_the_ball_'
+    )
+    start_position.upto(end_position) {|entry|
+      name = name_of_the_ascii_paradise_component+entry.to_s+'.ascii'
+      e name
+      create_file(name)
+    }
+  end
   # ========================================================================= #
   # === ascii_alphabet
   #
@@ -482,6 +500,21 @@ BrowserApplication[$e]=!firefox
     e  "'#{i}' (size #{i.size}) is stored in the encoding #{i.encoding.name}"
   end
+  # ========================================================================= #
+  # === roebe_festnetz?
+  # ========================================================================= #
+  def roebe_festnetz?
+    _ = Roebe.actions(:contacts)
+    _.first[1].to_s
+  end
+  # ========================================================================= #
+  # === show_roebe_festnetz?
+  # ========================================================================= #
+  def show_roebe_festnetz?
+    e steelblue(roebe_festnetz?)
+  end
   # ========================================================================= #
   # === save_all_contacts
   #
@@ -617,13 +650,6 @@ BrowserApplication[$e]=!firefox
     e '/* This is a CSS comment. */'
   end; alias css_hints css_comments? # === css_hints
-  # ========================================================================= #
-  # === ascii
-  # ========================================================================= #
-  def ascii
-    require 'ascii_paradise'
-  end
   begin
     require 'convert_global_env'
   rescue LoadError; end
@@ -1388,7 +1414,7 @@ BrowserApplication[$e]=!firefox
     create_file my_file
     append '<html><body><table>', my_file
     _.each { |image|
-      append '<tr><td><b>'+image+'</b></td><td>'+'<img src="'+image+'"></td></tr>'+"\n",my_file
+      append '<tr><td><b>'+image+'</b></td><td>'+'<img src="'+image+'"></td></tr>'+my_file
     }
     append '</table></body></html>', my_file
     e 'Look at '+my_file
@@ -1483,6 +1509,7 @@ BrowserApplication[$e]=!firefox
     ::Roebe.feedback_base_dir
   end; alias base_project? feedback_base_dir # === base_project?
   # ========================================================================= #
   # === rename_ascii_files
   #
@@ -1492,17 +1519,19 @@ BrowserApplication[$e]=!firefox
     ::Roebe.rename_ascii_files
   end
+  # ========================================================================= #
+  # === ascii
+  # ========================================================================= #
+  def ascii
+    require 'ascii_paradise'
+  end
   # ========================================================================= #
   # === misc                                                       (misc tag)
   #
   # Throwaway testing method.
   # ========================================================================= #
   def misc
-    # ======================================================================= #
-    # batchrename
-    # ======================================================================= #
-    start_position   = 51
-    down_to_position = 19
     start_position.downto(down_to_position).each {|counter|
       filename_in  = 'tears_of_ice_'+counter.to_s+'.ascii'
       filename_out = 'tears_of_ice_'+(counter+1).to_s+'.ascii'
@@ -3654,7 +3683,7 @@ EOF
     #
     # ======================================================================= #
     IRB.conf[:PROMPT][:ROEBE_PROMPT] = {
-      PROMPT_I: "\n",  # A newline is, oddly enough, required here.
+      PROMPT_I: ,   # A newline is, oddly enough, required here.
       PROMPT_N: ".. ", # Or: "",
       PROMPT_S: '"',   # Or nil
       PROMPT_C: '',

data/lib/roebe/fonts/fonts.rb ADDED Viewed

@@ -0,0 +1,39 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This module specifically tries to be of help when it comes to fonts,
+# especially on Linux systems.
+# =========================================================================== #
+module Roebe
+module Fonts # === Roebe::Fonts
+  # ========================================================================= #
+  # === Roebe::Fonts::ARRAY_URL_TO_REMOTE_FONTS
+  # ========================================================================= #
+  ARRAY_URL_TO_REMOTE_FONTS = %w(
+    https://github.com/tonsky/FiraCode/releases/download/6.2/Fira_Code_v6.2.zip
+  )
+  # ========================================================================= #
+  # === Roebe::Fonts::ARRAY_ELEGANT_FONTS
+  #
+  # Good fonts should be stored in the following Array. Note that any '_'
+  # that is part of the names, may be replaced with a ' '. So Fira_Code
+  # would become 'Fira Code'.
+  # ========================================================================= #
+  ARRAY_ELEGANT_FONTS = %w(
+    Hack
+    Fira_Code
+    URW_Bookman
+    Luxi_Sans
+  )
+end; end
+if __FILE__ == $PROGRAM_NAME
+  require 'wget'
+  Wget.download(
+    Roebe::Fonts::ARRAY_URL_TO_REMOTE_FONTS
+  )
+end

data/lib/roebe/gui/universal_widgets/books/books.rb ADDED Viewed

@@ -0,0 +1,232 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Roebe::GUI::Books
+#
+# Usage example:
+#
+#   Roebe::GUI::Books.new(ARGV)
+#
+# =========================================================================== #
+# require 'roebe/gui/universal_widgets/books/books.rb'
+# =========================================================================== #
+require 'roebe/base/base.rb'
+module Roebe
+module GUI
+class Books < Base # === Roebe::GUI::Books
+  require 'universal_widgets/base_module/base_module.rb'
+  include ::UniversalWidgets::BaseModule
+  require 'roebe/classes/books/books.rb'
+  begin
+    require 'pdf_paradise/utility_scripts/pdf_file_n_total_pages.rb'
+  rescue LoadError; end
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Books'
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '62% or minimum 6280px'
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '40% or minimum 400px'
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :hack_20
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    UniversalWidgets.parse(commandline_arguments)
+    case run_already
+    # ======================================================================= #
+    # === :do_not_run_yet
+    # ======================================================================= #
+    when :do_not_run_yet
+      run_already = false
+    end
+    run_super
+  end
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    infer_the_namespace
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    # ======================================================================= #
+    # === @book_object
+    # ======================================================================= #
+    @book_object = Roebe::Books.new { :do_not_run_yet }
+    # ======================================================================= #
+    # === @hash_containing_the_absolute_paths_to_the_pdf_files
+    # ======================================================================= #
+    @hash_containing_the_absolute_paths_to_the_pdf_files = {}
+  end
+  # ========================================================================= #
+  # === create_skeleton                            (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_the_skeleton
+    @outer_vbox = create_vbox
+    @grid = default_grid
+    @grid.padding = 5
+    @grid.default_spacing
+  end; alias create_skeleton create_the_skeleton # === create_skeleton
+  # ========================================================================= #
+  # === populate_the_grid
+  # ========================================================================= #
+  def populate_the_grid
+    favourites?.each_with_index {|this_is_the_book, index| index += 1
+      @hash_containing_the_absolute_paths_to_the_pdf_files[index] =
+        File.absolute_path(this_is_the_book)
+      this_button = bold_button(index.to_s)
+      this_button.clear_background
+      this_button.on_hover(:lightgreen)
+      this_button.hint = 'Click on this button to remove the first page '\
+                         'of the given .pdf file at hand.'
+      this_button.on_clicked {
+        do_remove_the_first_page_at_this_index(index)
+      }
+      @grid.left(this_button)
+      @grid.right(return_the_right_part(this_is_the_book.to_s))
+    }
+  end
+  # ========================================================================= #
+  # === return_the_right_part
+  # ========================================================================= #
+  def return_the_right_part(
+      i,
+      prepend_this = ''.dup
+    )
+    n_pdf_pages = 0
+    i = i.to_s
+    n_pdf_pages = n_pdf_pages?(i)
+    prepend_this << ' ('+n_pdf_pages.to_s+' .pdf pages)'
+    i.delete_suffix!('.pdf')
+    basename = File.basename(i).dup
+    basename << prepend_this
+    _ = left_aligned_text(basename.tr('_',' '))
+    _.make_bold
+    _.make_selectable
+    return _
+  end
+  # ========================================================================= #
+  # === n_pdf_pages?
+  # ========================================================================= #
+  def n_pdf_pages?(
+      i
+    )
+    return ::PdfParadise.n_pdf_pages?(i)
+  end
+  # ========================================================================= #
+  # === connect_the_skeleton                                    (connect tag)
+  # ========================================================================= #
+  def connect_the_skeleton
+    abort_on_exception
+    hbox = create_hbox
+    hbox.horizontal_center
+    @outer_vbox.minimal(hbox)
+    _ = scrolled_window(@grid)
+    _.width_height(800, 600)
+    @outer_vbox.minimal(_)
+    populate_the_grid
+    window = create_window_or_runner(nil, width?, height?, title?)
+    window << @outer_vbox
+    properly_prepare_this_window(window,
+      {
+        title:       title?,
+        font:        font?,
+        width:       width?,
+        height:      height?,
+        padding:     padding?,
+        border_size: border_size?
+      }
+    )
+    window.show_all
+    window.top_left
+    run_main
+  end
+  # ========================================================================= #
+  # === favourites?
+  # ========================================================================= #
+  def favourites?
+    @book_object.favourites?
+  end
+  # ========================================================================= #
+  # === do_remove_the_first_page_at_this_index
+  # ========================================================================= #
+  def do_remove_the_first_page_at_this_index(
+      index
+    )
+    Thread.new {
+      target = @hash_containing_the_absolute_paths_to_the_pdf_files[index]
+      @book_object.remove_the_first_page_of_this_target(target)
+    }
+  end
+  # ========================================================================= #
+  # === Roebe::GUI::Books.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/base_module/base_module.rb'
+    require 'gtk_paradise/run'
+    _ = ::Roebe::GUI::Books.new(i, :do_not_run_yet)
+    r = ::Gtk.run { :auto_accel }
+    r << frame
+    r.automatic
+    r.top_left_then_run
+  end
+  # ========================================================================= #
+  # === Roebe::GUI::Books[]
+  # ========================================================================= #
+  def self.[](i = ARGV)
+    new(i)
+  end
+end; end; end
+if __FILE__ == $PROGRAM_NAME
+  Roebe::GUI::Books.new(ARGV)
+end # calculator.rb

data/lib/roebe/hello_world/hello_world.rb CHANGED Viewed

File without changes

data/lib/roebe/irb/clean_irbrc CHANGED Viewed

@@ -191,6 +191,7 @@ array_require_these_projects = %w(
   rbt
   pdf_paradise
   studium
+  program_information
 )
 array_require_these_projects.each {|this_project|
   require this_project

data/lib/roebe/math/log10.rb CHANGED Viewed

@@ -18,7 +18,7 @@ class Log10 < Base # === Roebe::Log10
   # ========================================================================= #
   def initialize(*i)
     reset
-    @commandline_arguments = [i].flatten.compact
+    set_commandline_arguments(i)
     run
   end
@@ -30,10 +30,10 @@ class Log10 < Base # === Roebe::Log10
   end
   # ========================================================================= #
-  # === reset
+  # === run                                                         (run tag)
   # ========================================================================= #
   def run
-    @commandline_arguments.each {|entry|
+    commandline_arguments?.each {|entry|
       e Math.log10(entry.to_f)
     }
   end

data/lib/roebe/math/the_collatz_problem.rb ADDED Viewed

@@ -0,0 +1,104 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Roebe::TheCollatzProblem
+#
+# This class implements the collatz algorithm.
+#
+# It will limit the attempts, though, to avoid infinite recursion.
+#
+# The individual steps this does are as follows:
+#
+#   (1) Start with any natural number, such as 19.
+#   (2) if n is even, take n/2 as the next number.
+#   (3) if n is odd, take 3n+1 as the next number instead.
+#   (4) repeat the same procedure.
+#
+# This series enters a cycle, where the three numbers 4, 2 and 1 are
+# constantly repeated.
+# =========================================================================== #
+# require 'roebe/math/the_collatz_problem.rb'
+# Roebe::TheCollatzProblem.new(ARGV)
+# =========================================================================== #
+require 'roebe/base/base.rb'
+module Roebe
+class TheCollatzProblem < Base # === Roebe::TheCollatzProblem
+  # ========================================================================= #
+  # === TRY_THIS_NUMBER_BY_DEFAULT
+  # ========================================================================= #
+  TRY_THIS_NUMBER_BY_DEFAULT = 19
+  # ========================================================================= #
+  # === initialize
+  #
+  # If the input number is 19 then we will see this series:
+  #
+  #    n=19: 19, 58, 29, 88, 44, 22, 11, 34, 17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1, 4, 2, 1, …
+  #
+  # ========================================================================= #
+  def initialize(*i)
+    reset
+    set_commandline_arguments(i)
+    run
+  end
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @try_n_runs
+    # ======================================================================= #
+    @try_n_runs = 24 # Limit how often we try this. Avoids infinite loops too!
+  end
+  # ========================================================================= #
+  # === default_print
+  # ========================================================================= #
+  def default_print(n)
+    print n, ', '
+  end
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    _ = first?
+    if _.nil? or _.empty?
+      _ = TRY_THIS_NUMBER_BY_DEFAULT
+    end
+    counter = 1
+    n = _.to_i
+    default_print(n) # Report it initially once.
+    loop {
+      counter += 1
+      if counter > @try_n_runs
+        break
+      end
+      # ===================================================================== #
+      # if n is even, take n/2 as the next number:
+      # ===================================================================== #
+      if n.even?
+        n = n/2
+      # ===================================================================== #
+      # if n is odd, take 3n+1 as the next number instead.
+      # ===================================================================== #
+      elsif n.odd?
+        n = (3 * n) + 1
+      else
+      end
+      default_print(n)
+    }
+    e # Trailing newline makes this prettier, in my opinion.
+  end
+end; end
+if __FILE__ == $PROGRAM_NAME
+  Roebe::TheCollatzProblem.new(ARGV)
+end # rb TheCollatzProblem.rb 10

data/lib/roebe/{toplevel_methods/lighttpd.rb → requires/require_lighttpd.rb} RENAMED Viewed

@@ -2,11 +2,11 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'roebe/toplevel_methods/lighttpd.rb'
+# require 'roebe/requires/require_lighttpd.rb'
 # Roebe.stop_lighty
 # =========================================================================== #
 module Roebe
-  require 'roebe/classes/handle_lighttpd.rb' # Since May 2023 that class handles lighttpd-related stuff.
+  require 'roebe/classes/lighttpd/lighttpd_wrapper.rb' # Since May 2023 that class handles lighttpd-related stuff.
 end

data/lib/roebe/shell/shell/shell.rb CHANGED Viewed

@@ -172,7 +172,7 @@ class Shell < Base # === Roebe::Shell
   end
   begin
-    require 'rbt/utility_scripts/url.rb'
+    require 'rbt/cookbooks/url/url.rb'
   rescue LoadError; end
   require 'open-uri'
@@ -369,7 +369,7 @@ class Shell < Base # === Roebe::Shell
   # ========================================================================= #
   if ::Roebe.is_on_roebe?
     begin
-      require 'multimedia_paradise/constants/file_constants.rb'
+      require 'multimedia_paradise/constants/constants.rb'
       # ======================================================================= #
       # === FILE_VIDEO_COLLECTION
       #
@@ -3604,7 +3604,7 @@ ROEBE_SUBSECTION
   # ========================================================================= #
   def merge(*i)
     begin
-      require 'multimedia_paradise/toplevel_methods/merge_multimedia_file.rb'
+      require 'multimedia_paradise/toplevel_methods/merge.rb'
     rescue LoadError; end
     i.flatten! if i.is_a? Array # Make sure we have a flat array.
     case i.to_s
@@ -10933,7 +10933,7 @@ ROEBE_SUBSECTION
   end
   begin
-    require 'multimedia_paradise/conversions/conversions.rb'
+    require 'multimedia_paradise/toplevel_methods/conversions.rb'
   rescue LoadError; end
   # ========================================================================= #
   # === mp3_to_wav
@@ -14095,7 +14095,7 @@ ROEBE_SUBSECTION
   # ========================================================================= #
   def show_the_homepage_of(i)
     begin
-      require 'rbt/cookbooks/homepage.rb'
+      require 'rbt/cookbooks/homepage/homepage.rb'
     rescue LoadError; end
     [i].flatten.compact.each {|this_program|
       result = RBT.homepage(this_program)
@@ -23997,7 +23997,7 @@ ROEBE_SUBSECTION
   end
   begin
-    require 'multimedia_paradise/constants/file_constants.rb'
+    require 'multimedia_paradise/constants/constants.rb'
   rescue LoadError; end
   # ========================================================================= #
   # === favourite_audio_files?

data/lib/roebe/shell_scripts/README.md CHANGED Viewed

File without changes

data/lib/roebe/shell_scripts/bashrc CHANGED Viewed

File without changes

data/lib/roebe/shell_scripts/konsole_tabs.sh ADDED Viewed

@@ -0,0 +1,6 @@
+title: %n;; command: /usr/bin/bash -c 'd150'
+title: %n;; command: /usr/bin/bash
+title: %n;; command: /usr/bin/bash -c '/usr/bin/konsole_title 1'
+title: %n;; command: /usr/bin/bash -c '/usr/bin/konsole_title 2'
+title: %n;; command: /usr/bin/bash -c '/usr/bin/konsole_title 3'
+title: %n;; command: /usr/bin/bash -c '/usr/bin/konsole_title 4'

data/lib/roebe/shell_scripts/lfs/001_binutils_1.sh CHANGED Viewed

@@ -1,5 +1,7 @@
 # =========================================================================== #
-# This is the instruction for Binutils 1st pass:
+# This is the instruction for Binutils 1st pass.
+# =========================================================================== #
+# https://www.linuxfromscratch.org/lfs/view/stable/chapter05/binutils-pass1.html
 # =========================================================================== #
 source /home/x/programming/ruby/src/roebe/lib/roebe/shell_scripts/lfs/lfs_build_variables.sh
@@ -11,7 +13,13 @@ cd $MY_BINUTILSV
 mkdir -v build
 cd build
-../configure --prefix=$LFS/tools --with-sysroot=$LFS --target=$LFS_TGT --disable-nls --disable-werror --enable-gprofng=no --enable-default-hash-style=gnu
+../configure --prefix=$LFS/tools \
+             --with-sysroot=$LFS \
+             --target=$LFS_TGT   \
+             --disable-nls       \
+             --enable-gprofng=no \
+             --disable-werror    \
+             --enable-default-hash-style=gnu
 make
 make install # -j1
 # =========================================================================== #