Add explanation comments on the build system files

mk/ci.mk

@@ -1,3 +1,5 @@
+# Configuration file of the build system commands for the build server
+
 IMG_TAG?=$(shell git describe --tags)
 IMG_SEPARATOR?=_
 IMG_DIR?=build/img/$(ARCH)

mk/config.mk

@@ -1,3 +1,5 @@
+# Configuration file of the build system environment variables
+
 -include .config
 
 HOST_ARCH?=$(shell uname -m)

mk/depends.mk

@@ -1,4 +1,4 @@
-# Dependencies
+# Configuration file for the build system dependencies
 
 # Don't check for Rust/Cargo if you will be using Podman
 ifneq ($(PODMAN_BUILD),1)

mk/disk.mk

@@ -1,3 +1,5 @@
+# Configuration file with the commands configuration of the Redox image
+
 $(BUILD)/harddrive.img: $(FSTOOLS_TAG) $(REPO_TAG)
 	mkdir -p $(BUILD)
 	rm -rf $@  $@.partial

mk/fstools.mk

@@ -1,3 +1,5 @@
+# Configuration file for redox-installer, Cookbook and RedoxFS FUSE
+
 fstools: $(FSTOOLS_TAG)
 
 $(FSTOOLS_TAG): cookbook installer redoxfs $(CONTAINER_TAG)

mk/podman.mk

@@ -1,6 +1,4 @@
-##############################################
-# podman.mk - Use Podman to build components #
-##############################################
+# Configuration file of the Podman commands
 
 # Configuration variables for running make in Podman
 ## Tag the podman image $IMAGE_TAG

mk/prefix.mk

@@ -1,3 +1,5 @@
+# Configuration file for the Rust/GCC cross-compilers and relibc
+
 PREFIX=prefix/$(TARGET)
 
 PREFIX_INSTALL=$(PREFIX)/relibc-install

mk/qemu.mk

@@ -1,3 +1,5 @@
+# Configuration file for QEMU
+
 QEMU=SDL_VIDEO_X11_DGAMOUSE=0 qemu-system-$(QEMU_ARCH)
 QEMUFLAGS=-d guest_errors -name "Redox OS $(ARCH)"
 

mk/repo.mk

@@ -1,3 +1,5 @@
+# Configuration file for recipe commands
+
 $(BUILD)/fetch.tag: prefix $(FSTOOLS_TAG) $(FILESYSTEM_CONFIG) $(CONTAINER_TAG)
 ifeq ($(PODMAN_BUILD),1)
 	$(PODMAN_RUN) $(MAKE) $@

mk/virtualbox.mk

@@ -1,3 +1,5 @@
+# Configuration file for VirtualBox, it creates a VirtualBox virtual machine
+
 virtualbox: $(BUILD)/harddrive.img
 	echo "Delete VM"
 	-$(VBM) unregistervm Redox --delete; \