From 70157462d8938512e2b83953c4349b7774d67714 Mon Sep 17 00:00:00 2001
From: Szabina Korbai <szkorbai@linux.ibm.com>
Date: Wed, 1 Oct 2025 15:22:52 +0200
Subject: [PATCH] common.mak: Add explanation to *_FOR_BUILD variables
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Reviewed-by: Steffen Eiden <seiden@linux.ibm.com>
Reviewed-by: Marc Hartmayer <mhartmay@linux.ibm.com>
Reviewed-by: Jan Höppner <hoeppner@linux.ibm.com>
Signed-off-by: Szabina Korbai <szkorbai@linux.ibm.com>
Signed-off-by: Steffen Eiden <seiden@linux.ibm.com>
---
 common.mak | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/common.mak b/common.mak
index f21d4cd4..8f1d04af 100644
--- a/common.mak
+++ b/common.mak
@@ -119,6 +119,10 @@ ifneq ($(HOST_ARCH),$(BUILD_ARCH))
   endif
 endif
 
+# *_FOR_BUILD variables define compilation configurations for binaries used
+# during the build process (e.g. autocompleteion script generators). This
+# is especially important for cross-compilation where these binaries need to
+# be executed on the build system.
 $(eval $(call define_toolchain_variables,_FOR_BUILD,))
 $(eval $(call define_toolchain_variables,,$(CROSS_COMPILE)))