Add explanatory comments to confusing code segments

scripts/Arch/Collections/personal.sh

@@ -193,6 +193,7 @@ yay --noconfirm -Syu \
 # Coding
 yay --noconfirm -Syu \
     archiso \
+    `# ISO support for wimlib`
     cdrkit \
     wimlib \
     devdocs-desktop \
@@ -200,6 +201,7 @@ yay --noconfirm -Syu \
     esbonio \
     powershell-bin \
     godot-mono-bin \
+    `# Trash functionality for code` \
     gvfs \
     vscodium-bin \
     vscodium-insiders-bin \
@@ -242,6 +244,7 @@ yay --noconfirm -Syu \
     bb \
     tea \
     woodpecker-cli \
+    `# RDP support for Remmina` \
     freerdp \
     remmina \
     wireshark-qt \

scripts/Arch/Software/IcedTea/install.sh

@@ -1,3 +1,4 @@
 yay --noconfirm -Syu jdk-temurin;
 yay --noconfirm -Syu icedtea-web;
+# Allow execution of huwaei KVM application (uses out of date security mechanisms)
 sudo sed -i "/^jdk.jar.disabledAlgorithms=/{ :comment; s/\(.*\)/#\1/; /\\\\\$/{ n; bcomment; }; }" /usr/lib/jvm/default-runtime/conf/security/java.security

scripts/Arch/Software/KDE/install.sh

@@ -2,10 +2,12 @@
 sudo pacman -Syu --noconfirm \
     pipewire-jack \
     plasma-meta \
+    `# As per: https://wiki.archlinux.org/title/KDE#Discover_does_not_show_any_applications` \
     packagekit-qt6 \
     tesseract-data-deu \
     tesseract-data-eng \
     kde-applications-meta \
+    `# Automatic rotation: https://wiki.archlinux.org/title/Tablet_PC#With_a_KDE_module` \
     iio-sensor-proxy \
     pipewire-audio \
     pipewire-pulse \

scripts/Arch/Software/vim/install.sh

@@ -2,8 +2,10 @@
 pushd "${BASH_SOURCE%/*}" > /dev/null;
 
 yay --noconfirm -Syu \
+    `# Necessary for accessing clipboard in terminal: https://wiki.archlinux.org/title/Vim` \
     gvim \
     vi-vim-symlink \
+    `# Add clipboard support for wayland: https://www.reddit.com/r/Fedora/comments/ax9p9t/comment/jjb4p7b/` \
     vim-wayland-clipboard-git \
     wl-clipboard \
     ;

scripts/Arch/Software/waydroid/install.sh

@@ -1,8 +1,12 @@
 #!/bin/bash
 yay --noconfirm -Syu \
+    `# Waydroid prerequisite: https://wiki.archlinux.org/title/Waydroid#DKMS_modules` \
     binder_linux-dkms \
     waydroid \
+    `# For installing ARM suppot on waydroid` \
     waydroid-script-git \
+    `# Clipboard support: https://wiki.archlinux.org/title/Waydroid#Failed_to_start_Clipboard_manager_service` \
     python-pyclip \
+    `# Wayland clipboard support: https://github.com/spyoungtech/pyclip?tab=readme-ov-file#linux` \
     wl-clipboard \
     ;

scripts/Common/Config/nvidia-dkms/install.sh

@@ -1,4 +1,6 @@
 #!/bin/bash
+# According to installation guide on Arch Wiki:
+# https://wiki.archlinux.org/title/NVIDIA#DRM_kernel_mode_setting
 {
     echo "options nvidia_drm modeset=1";
     echo "options nvidia_drm fbdev=1";
@@ -13,6 +15,7 @@ sudo sed -i \
 
 sudo mkinitcpio -P;
 
+# According to: https://wiki.archlinux.org/title/NVIDIA/Tips_and_tricks
 {
     echo "options nvidia NVreg_PreserveVideoMemoryAllocations=1";
     echo "options nvidia NVreg_TemporaryFilePath=/var/tmp";

scripts/Common/Config/vim/install.sh

@@ -4,5 +4,6 @@ configFile="/etc/vimrc";
 
 if ! grep "\b$indicator\b" "$configFile" > /dev/null
 then
+    # As described in https://wiki.archlinux.org/title/Vim#Clipboard
     echo "$indicator+=unnamed,unnamedplus" | sudo tee /etc/vimrc > /dev/null;
 fi;