In this document we present the scripts shipped in Slint that allow
booting Slint just after installation as after a kernel upgrade, and
optionally bringing portability to Slint.

1. grubconfig

This script installs and configure grub in a newly installed Slint, to
allow booting it.

It installs if possible grub in both Legacy and UEFI modes, for more
flexibility. This needs to set up an EFI system partition (ESP) on the
device where Slint is installed, even if the machine boots the installer
in Legacy mode. An ESP is mandatory if the machine can only boot in EFI
mode.

If the machine is in UEFI mode when installing, grubconfig proposes
to install a boot entry for Slint in the machine's firmware boot menu,
in addition to the boot image installed in the ESP.

2. install-portable.sh

install-portable.sh allows to modify a system just installed on an USB
drive (hard disk or SSD connected through USB) so that it can boot on
on many  different computers. In that aim it will load at boot times all
kernel modules that can be needed to handle many hardware configurations
as well as the root file system. The boot menu will then only include
boot entries for Slint, as the machine on which it will be used is not
known in advance.

install-portable will be included in the installer of the next ISO.
Then, the user will have the option to make the installed system
portable or not:
- if the system should be portable, this script will be executed.
- else, grubconfig will be used.

Features:
- Build and install an initrd including the needed kernel modules,
- Remove the huge kernel if installed
- Install Grub in both EFI and Legacy modes with a custom grub.cfg
 
Usage (until it be shipped in the installer):
- Before beginning the installation, store the script in hard disk of
  the host machine or an USB stick.
- Install the system on the USB drive. You may install GRUB if you want,
  anyway grub.cfg will be overridden when running install-portable.sh
- At end of installation, before rebooting mount the partition where the
  script is stored as /floppy and run it:
  cd floppy
  sh install_portable.sh

Please note that if Slint is the only system installed on a machine, it
won't hurt to make it "portable" even though it will stay on the same
machine. Only in case of multi-boot it is preferable to not use this
mode, so that the boot menu includes entries for the other OS.

3. update-portable

This script brings portability to an already installed Slint as if it
was set up this way at time of installation.

If the system is already portable, it is run transparently by the script
upgrade-kernel (see below) to update the initrd and the custom grub
configuration file grub.conf.

If you prefer to switch or go back to a non-portable Slint, just run
the script update-grub (see below).

You can switch between portable and non-portable at libitum.

4. upgrade-kernel

This script applies an upgrade of kernel package provided by Slint:
- upgrading these packages,
- making an initrd with support for all the installed generic kernels,
- and updating the GRUB configuration file grub.cfg, running either
  update-portable or update-grub for a portable or non-portable Slint.

5. update-grub

This script backs up the existing configuration file grub.cfg then
makes and installs a new one, running the grub-mkconfig utility shipped
in the GRUB package.