From de8011e935937fcf167c2adb4110837f65915775 Mon Sep 17 00:00:00 2001
From: Andress Barajas <andress.barajas@gmail.com>
Date: Tue, 19 Nov 2024 19:26:16 -0800
Subject: [PATCH] Add master environ.sh for dynamic environment setup

Introduced a master environ.sh file to allow users to seamlessly utilize updates from environ.sh.sample while retaining their custom overrides in environ.sh when sourcing environ.sh.master.
---
 environ.sh.master | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 environ.sh.master

diff --git a/environ.sh.master b/environ.sh.master
new file mode 100644
index 0000000000..4d2e80e61d
--- /dev/null
+++ b/environ.sh.master
@@ -0,0 +1,26 @@
+# Master KallistiOS Environment Setup
+#
+# This script is responsible for setting up and maintaining your
+# KOS build environment dynamically. It ensures that any new settings 
+# added to environ.sh.sample (the maintainers' version) are available 
+# while preserving the user's custom overrides from environ.sh (their 
+# local version). 
+#
+# **Important:** Do not edit this script. Instead, make your customizations 
+# in environ.sh. This approach ensures you benefit from updates made to 
+# environ.sh.sample without losing your local settings.
+#
+# This script is typically sourced in your current shell environment
+# (probably by .bashrc, .bash_profile, or something similar), so that
+# the KOS environment is set up automatically for each shell session.
+#
+
+# Source the default environment settings
+echo "Sourcing default settings from environ.sh.sample..."
+. "doc/environ.sh.sample"
+
+# Source user-specific overrides, if present
+if [ -f "./environ.sh" ]; then
+    echo "Sourcing local overrides from environ.sh.local..."
+    . "./environ.sh"
+fi