Add explanation comments on the build system files

scripts/backtrace.sh

@@ -1,3 +1,6 @@
+# This script allow the user to copy a Rust backtrace from Redox
+# and retrieve the symbols
+
 #!/usr/bin/env bash
 
 usage()

scripts/category.sh

@@ -1,3 +1,5 @@
+# This script run the recipe command options on some Cookbook category
+
 #!/usr/bin/env bash
 
 if [ -z "$1" ] || [ -z "$2" ]

scripts/changelog.sh

@@ -1,3 +1,5 @@
+# This script show the changelog of all Redox components
+
 #!/usr/bin/env bash
 
 set -e

scripts/commit-hash.sh

@@ -1,3 +1,5 @@
+# This script show the current Git branch and commit of the recipe source
+
 #!/usr/bin/env bash
 
 if [ $# -ne 1 ]

scripts/dual-boot.sh

@@ -1,3 +1,6 @@
+# This script install Redox in the free space of your storage device
+# and add a boot entry (if you are using the systemd-boot boot loader)
+
 #!/usr/bin/env bash
 
 set -e

scripts/find-recipe.sh

@@ -1,3 +1,5 @@
+# This script show all files installed by a recipe
+
 #!/usr/bin/env bash
 
 # Ensure arch and config are set as desired, we use these to find the build dir

scripts/include-recipes.sh

@@ -1,3 +1,7 @@
+# This script create a list with:
+# "recipe-name = {} #TODO"
+# For quick testing of WIP recipes
+
 #!/usr/bin/env bash
 
 # Given a string, find recipe.toml files containing that string.

scripts/pkg-size.sh

@@ -1,3 +1,6 @@
+# This script show the package size of the recipes ("stage.pkgar" and "stage.tar.gz")
+# It must be used by package maintainers to enforce the library linking size policy
+
 #!/usr/bin/env bash
 
 if [ $# = 0 ]

scripts/show-package.sh

@@ -1,6 +1,6 @@
-#!/usr/bin/env bash
+# This script show the contents of the "stage" and "sysroot" folders in some recipe
 
-# Show the contents of the stage and sysroot folders in some recipe
+#!/usr/bin/env bash
 
 if [ -z "$*" ]
 then

scripts/ventoy.sh

@@ -1,3 +1,5 @@
+# This script create and copy the Redox bootable image to an Ventoy-formatted device
+
 #!/usr/bin/env bash
 
 set -e