rbt 0.11.89 → 0.11.91

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c680f7eb4f412dc65a68615f258f3080352013c2a4c0b1e554c47d714dd38e5f
-  data.tar.gz: 9ec6271f2f6a92e7f5631a60de5693388be5983e268548a8e2c5e2e0111675b9
+  metadata.gz: 65b2672483a1d004399685e34a8718d786e0dbe5fb728a8239f7dc780196fadf
+  data.tar.gz: 4bf2fe4cf0bb5135a71c0d0fa4249228542ca8b2a7e6276c9bf060760a4b9691
 SHA512:
-  metadata.gz: b8f97e0cd6d197298d7eb0b8d482e9ab710ac7f8297fa172b3c2fa2ee3e3cd209f47a5e5ab870f14fa7307c90d0629cf2d11767d5413709fd57fbdd635e5c63b
-  data.tar.gz: fa60ac235c3e7532bc0e42beae3134bbb27ac5afd5ebdf64a89c8ddcecd4d6d79d222475accbae3725b7cb049e70d413b264801f612288a3424d8003d2512f29
+  metadata.gz: 590f0f8d24ca2edd6163a0955234b18701832b1c38f875af87958d9ee555139a47c3a0fd704f83a1f47fc4fc16e9307c47a3402bcb26080050718deec24829f6
+  data.tar.gz: 603ac2e4b4264510cdb3e497cd1c3891844eec40ab94a246d7732421c34d68de383cf28e0a848e04280db74b0bf79372a0410d6314a341cd37cd5a875772b332

data/README.md

@@ -5,7 +5,7 @@
 [![forthebadge](https://forthebadge.com/images/badges/made-with-ruby.svg)](https://www.ruby-lang.org/en/)
 [![Gem Version](https://badge.fury.io/rb/rbt.svg)](https://badge.fury.io/rb/rbt)
 
-This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">15.03.2023</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">16:12:30</span> o'clock.
+This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">18.03.2023</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">21:33:52</span> o'clock.
 
 ## RBT - The "Ruby Build Tools" Project
 
@@ -987,6 +987,60 @@ the RBT project" was added as a separate subsection closer
 to the top of this page. That way new users can quickly
 read and learn how I use the RBT project.
 
+## New users and how to "onboard" them, as far as the RBT project is concerned: policy and strategy
+
+This subsection was added in <b>March 2023</b>, as one tiny step
+towards trying to teach newcomers how to use the RBT project.
+
+This subsection only explains a few policies, though - the background
+context, so to say.
+
+The subsection before pointed out that the <b>rbt gem</b> is quite complex,
+and to some extent complicated. In the past the rbt gem was even
+more complicated - and this was one primary reason as to why this
+subsection was added. I want to keep things simple, at the least
+for new users; to some extent also at a later time.
+
+At any rate, before <b>March 2023</b> the rbt gem made use of various
+add-ons, such as <b>ccache</b> or <b>porg</b>. In the event that you
+do not know projects like these: ccache is useful when you have to
+compile many different programs from source. It will use a cache,
+which can really help speed up subsequent recompilation efforts -
+very useful really. <b>porg</b> on the other hand can be used to
+trace as to which files are installed onto the target computer.
+This functionality is especially useful when you wish to be able
+to provide a package manager, e. g. by providing an <b>uninstall</b>
+functionality.
+
+So, before <b>March 2023</b>, the configuration I would use for the
+rbt gem, typically mandated that porg and ccache are to be used -
+and the assumption here was that both projects are installed on
+the target computer, and that they will work, too. These assumptions
+may turn out to be incorrect. I noticed this problem in particular
+when I set up a new computer with a semi-broken toolchain. I can
+typically "uncripple" this eventually, by recompiling what I need,
+but how should a new user know any of this? That takes experience
+and at the least a bit of knowledge.
+
+Thus, as I realised that mandating ccache and porg "out of the
+box" isn't that useful for new users, on a freshly installed
+(random) computer system, I decided that a new policy had to be
+added for RBT. This policy states that the rbt gem will try to
+be <b>minimal</b>, whenever possible, in regards to depending
+on external projects such as ccache or porg. That way the rbt
+gem no longer distributes configuration settings that are not
+so useful for new users.
+
+What is the long term benefit of this approach?
+
+It is hoped that this new policy in place will make it easier
+for genuinely new users to give the project a try. As it is,
+the project is catering too much to my own use cases - while
+that is acceptable for a project that has not yet reached
+a stable release, I believe we should slowly begin to help
+new users more, should they wish to make use of the rbt
+gem. Less frustration, more happiness. \o/
+
 ## @source_base_directory
 
 The very important instance variable **@source_base_directory**, defined
@@ -2299,7 +2353,7 @@ of guide or tutor that can properly explain some cave-eats
 or problems and make some "semi-seducated guesses", in
 order to fix this. But this is a long-term goal - for
 now, the primary purpose of the compile-shell is to aid
-in batch-compiling programs.
+in <b>batch-compiling programs</b>.
 
 Since as of March 2018, an autocompile-option exists in
 the shell. This is currently unfinished but in the future
@@ -2616,6 +2670,7 @@ directory:
     report_host_cpu
     report_mate_desktop_version
     report_total_size_of_all_archives
+    root_prefix
     ruby_libtool
     run_make_then_make_install
     scookie
@@ -9264,21 +9319,29 @@ that can occur during compilation.
 The following programs were updated with this release,
 compared to the previous release:
 
-linux was updated to program version 6.2.6 (on: 13.03.2023-19:21:23)<br>
-pip was updated to program version 23.0.1 (on: 14.03.2023-00:30:16)<br>
-icewm was updated to program version 3.3.2 (on: 14.03.2023-00:41:47)<br>
-setuptools was updated to program version 67.6.0 (on: 14.03.2023-01:09:23)<br>
-git was updated to program version 2.40.0 (on: 14.03.2023-07:42:37)<br>
-tdb was updated to program version 1.4.8 (on: 15.03.2023-06:16:05)<br>
-php was updated to program version 8.2.4 (on: 15.03.2023-06:51:21)<br>
-cmake was updated to program version 3.26.0 (on: 15.03.2023-07:04:00)<br>
-gtk was updated to program version 4.10.1 (on: 15.03.2023-07:09:17)<br>
-gtk was updated to program version 4.10.1 (on: 15.03.2023-07:26:43)<br>
-openssl was updated to program version 3.1.0 (on: 15.03.2023-07:40:02)<br>
-libxt was updated to program version 1.2.1 (on: 15.03.2023-08:48:11)<br>
-ccache was updated to program version 4.8.0 (on: 15.03.2023-15:58:09)<br>
-ccache was updated to program version 4.8 (on: 15.03.2023-15:59:07)<br>
-gobjectintrospection was updated to program version 1.76.0 (on: 15.03.2023-16:00:07)<br>
+bind was updated to program version 9.19.0 (on: 15.03.2023-18:10:22)<br>
+bind was updated to program version 9.19.11 (on: 15.03.2023-18:11:18)<br>
+openssh was updated to program version 9.3p1 (on: 16.03.2023-02:14:21)<br>
+matedesktop was updated to program version 1.26.1 (on: 16.03.2023-02:14:56)<br>
+transmission was updated to program version 4.0.2 (on: 16.03.2023-02:16:23)<br>
+calibre was updated to program version 6.14.1 (on: 16.03.2023-14:58:29)<br>
+sway was updated to program version 1.8.1 (on: 16.03.2023-19:58:33)<br>
+scummvm was updated to program version 2.7.0 (on: 17.03.2023-03:15:15)<br>
+evolution was updated to program version 3.48.0 (on: 17.03.2023-08:39:43)<br>
+a2ps was updated to program version 4.15.1 (on: 18.03.2023-02:33:15)<br>
+libxaw was updated to program version 1.0.15 (on: 18.03.2023-02:52:30)<br>
+libxaw was updated to program version 1.0.15 (on: 18.03.2023-02:54:07)<br>
+cracklib was updated to program version 2.9.10 (on: 18.03.2023-03:07:31)<br>
+imlib2 was updated to program version 1.10.0 (on: 18.03.2023-03:10:09)<br>
+imlib2 was updated to program version 1.11.0 (on: 18.03.2023-03:10:32)<br>
+webkitgtk was updated to program version 2.40.0 (on: 18.03.2023-03:19:32)<br>
+samtools was updated to program version 1.17 (on: 18.03.2023-04:08:43)<br>
+gstpluginsbase was updated to program version 1.22.1 (on: 18.03.2023-06:00:40)<br>
+gstpluginsbad was updated to program version 1.22.1 (on: 18.03.2023-06:06:55)<br>
+nautilus was updated to program version 44.0 (on: 18.03.2023-18:05:39)<br>
+linux was updated to program version 6.2.7 (on: 18.03.2023-18:41:20)<br>
+xz was updated to program version 5.4.2 (on: 18.03.2023-20:33:52)<br>
+geanyplugins was updated to program version 1.38 (on: 18.03.2023-21:25:03)<br>
 
 
 ## Available program versions
@@ -9531,6 +9594,28 @@ actually to see whether I have to update some programs on the
 given computer system (on Linux typically). See the commandline
 option <b>--really-everything</b> to obtain that information.
 
+## Batch Compiling and Chain compiling
+
+You can batch-compile several programs in one go.
+
+The syntax is:
+
+    rbt --batch-compile=mate
+    rbt --batch-compile=ruby_addons
+    rbt --batch-compile=xorg_protos
+
+The first example will compile all of mate; the last example will
+compile all xorg-protos.
+
+Note that for this to work, you first must have defined a compile-chain
+in the file chained_programs.yml, which is part of the RBT project.
+
+Alternatively, you can just specify the programs that you wish to
+compile, separated by a "," character, such as shown by the
+following commandline example:
+
+    rbt --batch-compile=python,php,perl,ruby
+    
 ## Batch-downloading all source archives
 
 You can download all registered **source archives** by calling
@@ -10505,7 +10590,7 @@ castlecombat              0.8.1        28 Jul 2016  http://prdownloads.sourcefor
 caxlsx                    3.2.0        27 May 2022  https://rubygems.org/downloads/caxlsx-3.2.0.gem
 cbase                     1.3.7        28 Sep 2019  http://www.hyperrealm.com/packages/cbase-1.3.7.tar.gz
 cbindgen                  0.24.3       11 Sep 2022  https://github.com/eqrion/cbindgen/archive/v0.24.3/cbindgen-0.24.3.tar.gz
-ccache                    4.7.4        23 Nov 2022  https://github.com/ccache/ccache/releases/download/v4.7.4/ccache-4.7.4.tar.xz
+ccache                    4.8          15 Mar 2023  https://github.com/ccache/ccache/releases/download/v4.8/ccache-4.8.tar.gz
 ccaudio2                  2.2.0        19 Mar 2019  http://ftp.gnu.org/pub/gnu/ccaudio/ccaudio2-2.2.0.tar.gz
 ccmath                    2.2.1        01 Jun 2014  http://www.ibiblio.org/pub/Linux/libs/ccmath-2.2.1.tar.gz
 cdemuclient               3.2.1        27 Jun 2020  http://downloads.sourceforge.net/cdemu/cdemu-client-3.2.1.tar.bz2
@@ -10577,7 +10662,7 @@ cluttergst                3.0.27       07 Feb 2019  http://ftp.gnome.org/pub/gno
 cluttergtk                1.8.4        09 Aug 2017  http://ftp.gnome.org/pub/gnome/sources/clutter-gtk/1.8/clutter-gtk-1.8.4.tar.xz
 cluttergtkmm              1.6.0        18 Mar 2015  http://ftp.gnome.org/pub/GNOME/sources/clutter-gtkmm/1.6/clutter-gtkmm-1.6.0.tar.xz
 cluttermm                 1.17.3       01 May 2014  http://ftp.gnome.org/pub/GNOME/sources/cluttermm/1.17/cluttermm-1.17.3.tar.xz
-cmake                     3.25.3       09 Mar 2023  https://github.com/Kitware/CMake/releases/download/v3.25.3/cmake-3.25.3.tar.gz
+cmake                     3.26.0       15 Mar 2023  https://github.com/Kitware/CMake/releases/download/v3.26.0/cmake-3.26.0.tar.gz
 cmark                     0.29.0       26 May 2020  https://github.com/commonmark/cmark/archive/0.29.0.tar.gz
 cmdftp                    0.9.7        01 Jun 2014  http://download.savannah.nongnu.org/releases/cmdftp/cmdftp-0.9.7.tar.gz
 cmdparse                  3.0.7        06 Mar 2021  https://rubygems.org/downloads/cmdparse-3.0.7.gem
@@ -11249,7 +11334,7 @@ gnuuid                    0.5.1        14 Oct 2018  https://rubygems.org/downloa
 go                        1.4.2        19 May 2015  https://storage.googleapis.com/golang/go1.4.2.src.tar.gz
 gob2                      2.0.20       01 Dec 2013  http://ftp.gnome.org/pub/GNOME/sources/gob2/2.0/gob2-2.0.20.tar.xz
 gobby                     0.5.0        02 Jun 2018  http://releases.0x539.de/gobby/gobby-0.5.0.tar.gz
-gobjectintrospection      1.74.0       29 Dec 2022  https://download.gnome.org/sources/gobject-introspection/1.74/gobject-introspection-1.74.0.tar.xz
+gobjectintrospection      1.76.0       15 Mar 2023  https://download.gnome.org/sources/gobject-introspection/1.76/gobject-introspection-1.76.0.tar.xz
 gocr                      0.47         02 Aug 2017  https://sourceforge.net/projects/jocr/files/gocr/0.47/gocr-0.47.tar.gz
 god                       0.13.7       03 Sep 2022  https://rubygems.org/downloads/god-0.13.7.gem
 goffice                   0.10.54      23 Jan 2023  https://download.gnome.org/sources/goffice/0.10/goffice-0.10.54.tar.xz
@@ -11327,7 +11412,7 @@ gstrtspserver             1.4.5        02 Mar 2015  http://gstreamer.freedesktop
 gsview                    4.9          01 Jun 2014  http://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsview-4.9.tar.gz
 gtef                      1.99.2       12 Mar 2017  http://ftp.gnome.org/pub/GNOME/sources/gtef/1.99/gtef-1.99.2.tar.xz
 gthumb                    3.12.2       04 Apr 2022  https://download.gnome.org/sources/gthumb/3.12/gthumb-3.12.2.tar.xz
-gtk                       4.10.0       05 Mar 2023  https://download.gnome.org/sources/gtk/4.10/gtk-4.10.0.tar.xz
+gtk                       4.10.1       15 Mar 2023  https://download.gnome.org/sources/gtk/4.10/gtk-4.10.1.tar.xz
 gtk+                      3.24.37      04 Mar 2023  https://download.gnome.org/sources/gtk+/3.24/gtk+-3.24.37.tar.xz
 gtkam                     0.2.0        01 Apr 2014  http://sourceforge.net/projects/gphoto/files/gtkam/0.2.0/gtkam-0.2.0.tar.gz
 gtkchtheme                0.3.1        01 Dec 2012  http://plasmasturm.org/code/gtk-chtheme/gtk-chtheme-0.3.1.tar.bz2
@@ -12258,7 +12343,7 @@ libxscrnsaver             1.2.4        05 Dec 2022  https://www.x.org/releases/i
 libxshmfence              1.3.2        12 Dec 2022  https://www.x.org/releases/individual/lib/libxshmfence-1.3.2.tar.xz
 libxslt                   1.1.37       03 Sep 2022  https://download.gnome.org/sources/libxslt/1.1/libxslt-1.1.37.tar.xz
 libxspf                   1.2.0        16 Feb 2017  http://downloads.xiph.org/releases/xspf/libxspf-1.2.0.tar.bz2
-libxt                     1.2.0        23 Jun 2019  http://xorg.freedesktop.org/releases/individual/lib/libXt-1.2.0.tar.gz
+libxt                     1.2.1        15 Mar 2023  https://www.x.org/releases/individual/lib/libXt-1.2.1.tar.bz2
 libxtst                   1.2.4        28 Sep 2022  https://www.x.org/releases/individual/lib/libXtst-1.2.4.tar.gz
 libxv                     1.0.12       05 Dec 2022  https://www.x.org/releases/individual/lib/libXv-1.0.12.tar.gz
 libxvmc                   1.0.13       28 Mar 2022  https://www.x.org/releases/individual/lib/libXvMC-1.0.13.tar.gz
@@ -12672,7 +12757,7 @@ npth                      1.6          30 Jul 2018  ftp://ftp.gnupg.org/gcrypt/n
 nsd                       4.2.1        11 Jul 2019  https://www.nlnetlabs.nl/downloads/nsd/nsd-4.2.1.tar.gz
 nspluginwrapper           1.2.2        01 Jun 2014  http://gwenole.beauchesne.info/projects/nspluginwrapper/files/nspluginwrapper-1.2.2.tar.bz2
 nspr                      4.35         17 Sep 2022  https://archive.mozilla.org/pub/nspr/releases/v4.35/src/nspr-4.35.tar.gz
-nss                       3.88.1       11 Feb 2023  https://archive.mozilla.org/pub/security/nss/releases/NSS_3_88_1_RTM/src/nss-3.88.1.tar.gz
+nss                       3.89         15 Mar 2023  https://archive.mozilla.org/pub/security/nss/releases/NSS_3_89_RTM/src/nss-3.89.tar.gz
                                        31 Oct 2022  https://tuxera.com/opensource/ntfs-3g_ntfsprogs-2022.10.3.tgz
 ntp                       4.2.8p15     24 Jun 2020  https://www.eecis.udel.edu/~ntp/ntp_spool/ntp4/ntp-4.2/ntp-4.2.8p15.tar.gz
 ntrack                    017          09 Jul 2015  https://launchpad.net/ntrack/main/017/+download/ntrack-017.tar.gz
@@ -12724,7 +12809,7 @@ openshot                  1.4.3        01 Jun 2014  http://launchpad.net/opensho
 openshotqt                2.5.1        03 Mar 2020  https://github.com/OpenShot/openshot-qt/archive/v2.5.1.tar.gz
 opensp                    1.5.2        01 Jun 2014  http://ovh.dl.sourceforge.net/sourceforge/openjade/OpenSP-1.5.2.tar.gz
 openssh                   9.2p1        02 Feb 2023  https://ftp3.usa.openbsd.org/pub/OpenBSD/OpenSSH/portable/openssh-9.2p1.tar.gz
-openssl                   3.0.8        07 Feb 2023  https://ftp.openssl.org/source/openssl-3.0.8.tar.gz
+openssl                   3.1.0        15 Mar 2023  https://ftp.openssl.org/source/openssl-3.1.0.tar.gz
 openssn                   1.3          01 Dec 2012  http://sourceforge.net/projects/openssn/files/openssn-1.3/openssn-1.3.tar.gz
 openttd                   1.10.3       11 Aug 2020  https://cdn.openttd.org/openttd-releases/1.10.3/openttd-1.10.3-source.tar.xz
 openvpn                   2.6.1        10 Mar 2023  https://swupdate.openvpn.org/community/releases/openvpn-2.6.1.tar.gz
@@ -12826,7 +12911,7 @@ phodav                    3.0          02 Jul 2022  https://download.gnome.org/s
 phonon                    4.11.1       28 Sep 2019  https://download.kde.org/stable/phonon/4.11.1/phonon-4.11.1.tar.xz
 phononbackendgstreamer    4.9.0        13 Oct 2017  http://download.kde.org/stable/phonon/phonon-backend-gstreamer/4.9.0/phonon-backend-gstreamer-4.9.0.tar.xz
 phononbackendvlc          0.11.2       07 Feb 2021  https://download.kde.org/stable/phonon/phonon-backend-vlc/0.11.2/phonon-backend-vlc-0.11.2.tar.xz
-php                       8.2.3        14 Feb 2023  https://www.php.net/distributions/php-8.2.3.tar.xz
+php                       8.2.4        15 Mar 2023  https://www.php.net/distributions/php-8.2.4.tar.xz
 phpbb                     3.2.3        30 Sep 2018  https://www.phpbb.com/files/release/phpBB-3.2.3.zip
 phpunit                   6.3          24.09.2017   https://phar.phpunit.de/phpunit-6.3.phar
 phpwiki                   1.5.5        02 Aug 2017  https://sourceforge.net/projects/phpwiki/files/PhpWiki%201.5%20%28current%29/phpwiki-1.5.5.zip
@@ -13423,7 +13508,7 @@ tcc                       0.9.26       01 Aug 2013  http://download.savannah.gnu
 tcl                       8.6.13       16 Nov 2022  https://sourceforge.net/projects/tcl/files/Tcl/8.6.13/tcl8.6.13rc2-src.tar.gz
 tcpdump                   4.99.2       31 Dec 2022  http://www.tcpdump.org/release/tcpdump-4.99.2.tar.gz
 tcsh                      6.24.07      25 Dec 2022  https://astron.com/pub/tcsh/tcsh-6.24.07.tar.gz
-tdb                       1.4.7        04 Oct 2022  https://www.samba.org/ftp/tdb/tdb-1.4.7.tar.gz
+tdb                       1.4.8        15 Mar 2023  https://www.samba.org/ftp/tdb/tdb-1.4.8.tar.gz
 tea                       44.1.0       18 Jul 2017  http://semiletov.org/tea/dloads/tea-44.1.0.tar.bz2
 ted                       2.21.src     01 May 2014  ftp://ftp.nluug.nl/pub/editors/ted/ted-2.21.src.tar.gz
 telegnome                 0.3.6        30 Aug 2021  https://download.gnome.org/sources/telegnome/0.3/telegnome-0.3.6.tar.xz

data/bin/root_prefix

@@ -0,0 +1,7 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'rbt/requires/require_the_installer_class.rb'
+
+RBT::Installer.new(ARGV) { :use_root_prefix }

data/doc/README.gen

@@ -983,6 +983,60 @@ the RBT project" was added as a separate subsection closer
 to the top of this page. That way new users can quickly
 read and learn how I use the RBT project.
 
+## New users and how to "onboard" them, as far as the RBT project is concerned: policy and strategy
+
+This subsection was added in <b>March 2023</b>, as one tiny step
+towards trying to teach newcomers how to use the RBT project.
+
+This subsection only explains a few policies, though - the background
+context, so to say.
+
+The subsection before pointed out that the <b>rbt gem</b> is quite complex,
+and to some extent complicated. In the past the rbt gem was even
+more complicated - and this was one primary reason as to why this
+subsection was added. I want to keep things simple, at the least
+for new users; to some extent also at a later time.
+
+At any rate, before <b>March 2023</b> the rbt gem made use of various
+add-ons, such as <b>ccache</b> or <b>porg</b>. In the event that you
+do not know projects like these: ccache is useful when you have to
+compile many different programs from source. It will use a cache,
+which can really help speed up subsequent recompilation efforts -
+very useful really. <b>porg</b> on the other hand can be used to
+trace as to which files are installed onto the target computer.
+This functionality is especially useful when you wish to be able
+to provide a package manager, e. g. by providing an <b>uninstall</b>
+functionality.
+
+So, before <b>March 2023</b>, the configuration I would use for the
+rbt gem, typically mandated that porg and ccache are to be used -
+and the assumption here was that both projects are installed on
+the target computer, and that they will work, too. These assumptions
+may turn out to be incorrect. I noticed this problem in particular
+when I set up a new computer with a semi-broken toolchain. I can
+typically "uncripple" this eventually, by recompiling what I need,
+but how should a new user know any of this? That takes experience
+and at the least a bit of knowledge.
+
+Thus, as I realised that mandating ccache and porg "out of the
+box" isn't that useful for new users, on a freshly installed
+(random) computer system, I decided that a new policy had to be
+added for RBT. This policy states that the rbt gem will try to
+be <b>minimal</b>, whenever possible, in regards to depending
+on external projects such as ccache or porg. That way the rbt
+gem no longer distributes configuration settings that are not
+so useful for new users.
+
+What is the long term benefit of this approach?
+
+It is hoped that this new policy in place will make it easier
+for genuinely new users to give the project a try. As it is,
+the project is catering too much to my own use cases - while
+that is acceptable for a project that has not yet reached
+a stable release, I believe we should slowly begin to help
+new users more, should they wish to make use of the rbt
+gem. Less frustration, more happiness. \o/
+
 ## @source_base_directory
 
 The very important instance variable **@source_base_directory**, defined
@@ -2295,7 +2349,7 @@ of guide or tutor that can properly explain some cave-eats
 or problems and make some "semi-seducated guesses", in
 order to fix this. But this is a long-term goal - for
 now, the primary purpose of the compile-shell is to aid
-in batch-compiling programs.
+in <b>batch-compiling programs</b>.
 
 Since as of March 2018, an autocompile-option exists in
 the shell. This is currently unfinished but in the future
@@ -9324,6 +9378,28 @@ actually to see whether I have to update some programs on the
 given computer system (on Linux typically). See the commandline
 option <b>--really-everything</b> to obtain that information.
 
+## Batch Compiling and Chain compiling
+
+You can batch-compile several programs in one go.
+
+The syntax is:
+
+    rbt --batch-compile=mate
+    rbt --batch-compile=ruby_addons
+    rbt --batch-compile=xorg_protos
+
+The first example will compile all of mate; the last example will
+compile all xorg-protos.
+
+Note that for this to work, you first must have defined a compile-chain
+in the file chained_programs.yml, which is part of the RBT project.
+
+Alternatively, you can just specify the programs that you wish to
+compile, separated by a "," character, such as shown by the
+following commandline example:
+
+    rbt --batch-compile=python,php,perl,ruby
+    
 ## Batch-downloading all source archives
 
 You can download all registered **source archives** by calling

data/doc/deprecated/README.md

@@ -1,3 +1,3 @@
-This directory will eventually be removed, as soon as the
-old documentation has been integrated into the new 
-format (README.gen).
+This directory will eventually be removed, as soon as the old 
+documentation has been integrated into the new format
+(README.gen).

data/doc/deprecated/deprecated_rbt.cgi

@@ -892,31 +892,7 @@ This will create a symlink, for example, at
 
 The reason it was added was because GoboLinux uses semi-upcased
 directory names; and this makes things a bit more complicated 
-sometimes.'
-
-# ======================================================================= #
-# === Batch Compiling / Chain compiling.
-# ======================================================================= #
-
-You can batch-compile several programs in one go.'
-
-The syntax is:
-
-    rbt --batch-compile=mate'
-    rbt --batch-compile=ruby_addons'
-    rbt --batch-compile=xorg_protos'
-
-The first example will compile all of mate; the last example
-will compile all xorg-protos.'
-
-Note that for this to work, you first must have defined
-a compile-chain in the file cookbook_chained_programs.yml,
-which is part of the RBT project.'
-
-Alternatively, you can just specify the programs that you
-wish to compile, separated by a "," character, such as:
-
-    rbt --batch-compile=python,php,perl,ruby'
+sometimes.
 
 # ======================================================================= #
 # === UpdateEntry

data/lib/rbt/installer/initialize.rb

@@ -0,0 +1,183 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'rbt/installer/initialize.rb'
+# =========================================================================== #
+require 'rbt/compile_base/compile_base.rb'
+
+module RBT
+
+class Installer < ::RBT::CompileBase # === RBT::Compile
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # The first argument to this method will contain the commandline arguments
+  # for class RBT::Install. These are usually the name of the program
+  # (or programs) that you wish to compile.
+  #
+  # So, for example, "htop" could be passed as the first argument to
+  # this method. You can also pass in an Array here, and this class
+  # will then attempt to batch-compile these programs.
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV, # ← This should usually be an Array of programs that should be installed.
+      run_already           = true
+    )
+    register_sigint
+    reset
+    # ======================================================================= #
+    # Handle symbols given as first argument next.
+    # ======================================================================= #
+    case commandline_arguments
+    # ======================================================================= #
+    # === :do_not_run_yet
+    # ======================================================================= #
+    when :do_not_run_yet,
+         :do_not_yet_run,
+         :dont_run_yet
+      run_already = false
+      commandline_arguments = []
+    end
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    if block_given?
+      yielded = yield
+      case yielded
+      # ===================================================================== #
+      # === :dont_run_yet
+      # ===================================================================== #
+      when :dont_run_yet
+        run_already = false
+      end
+    end
+    case run_already
+    # ======================================================================= #
+    # === :do_not_run_yet
+    # ======================================================================= #
+    when :do_not_run_yet
+      run_already = false
+    end
+    consider_entering_the_log_directory
+    # ======================================================================= #
+    # === Handle blocks next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      # ===================================================================== #
+      # Handle Symbols first:
+      # ===================================================================== #
+      if yielded.is_a? Symbol
+        case yielded
+        # =================================================================== #
+        # === :do_not_run_yet
+        # =================================================================== #
+        when :do_not_run_yet,
+             :do_not_run,
+             :dont_run_yet
+          run_already = false
+        # =================================================================== #
+        # === :do_not_check_whether_the_program_exists
+        # =================================================================== #
+        when :do_not_check_whether_the_program_exists
+          do_not_check_whether_the_program_exists # ← This method exists, so use it too.
+        # =================================================================== #
+        # === :use_root_prefix
+        # =================================================================== #
+        when :use_root_prefix
+          do_use_root_prefix
+        end
+      # ===================================================================== #
+      # === Handle Hashes next
+      # ===================================================================== #
+      elsif yielded.is_a? Hash
+        # =================================================================== #
+        # === :run_already
+        #
+        # This entry point should be checked last. 
+        # =================================================================== #
+        if yielded.has_key? :run_already
+          case yielded[:run_already]
+          when :do_not_run_yet
+            run_already = false
+          end
+        end
+        # =================================================================== #
+        # === :use_this_prefix
+        # =================================================================== #
+        if yielded.has_key? :use_this_prefix
+          set_use_this_prefix(yielded[:use_this_prefix])
+        end
+        # =================================================================== #
+        # === :shall_we_check_whether_the_program_exists
+        # =================================================================== #
+        if yielded.has_key? :shall_we_check_whether_the_program_exists
+          case yielded[:shall_we_check_whether_the_program_exists]
+          # ================================================================= #
+          # === nope
+          #
+          # In this case we will not check whether the program exists.
+          # ================================================================= #
+          when :nope, false
+            do_not_check_whether_the_program_exists
+          end
+        end
+        # =================================================================== #
+        # === :prefix
+        #
+        # Handle prefix-related keys first.
+        # =================================================================== #
+        if yielded.has_key? :prefix
+          set_user_prefix(yielded.delete(:prefix)) # ← Set the new prefix via a method call.
+        # =================================================================== #
+        # === :use_this_prefix
+        # =================================================================== #
+        elsif yielded.has_key? :use_this_prefix
+          set_user_prefix(yielded.delete(:use_this_prefix))
+        # =================================================================== #
+        # === :use_this_as_prefix
+        # =================================================================== #
+        elsif yielded.has_key? :use_this_as_prefix
+          set_user_prefix(yielded.delete(:use_this_as_prefix))
+        end
+        # =================================================================== #
+        # === :symlink_after_compilation_has_finished
+        # =================================================================== #
+        if yielded.has_key? :symlink_after_compilation_has_finished
+          value = yielded.delete(:symlink_after_compilation_has_finished)
+          if value == false
+            set_do_not_symlink(:be_verbose) # Disable symlinking after compilation.
+          end
+        end
+        # =================================================================== #
+        # Add commandline_arguments if the key is :commandline_arguments
+        #
+        # Such a Hash may have a key like this:
+        #
+        #   {:commandline_arguments=>["--dont-use-colours", "ntrad"]}
+        # =================================================================== #
+        if yielded.has_key? :commandline_arguments
+          append_to_the_commandline(
+            yielded.delete(:commandline_arguments)
+          )
+        end
+      else
+        append_to_the_commandline(yielded)
+      end
+    end
+    # ======================================================================= #
+    # Handle special symbols passed to run_already next:
+    # ======================================================================= #
+    case run_already
+    when :dont_run_yet,
+         :do_not_run_yet,
+         :do_not_run_already
+      run_already = false
+    end
+    time_snapshot # Store the first snapshot, which is the start-mark.
+    run if run_already
+  end
+
+end; end