From 364de37ea7e5b2ed8de71f0919c691db2139700c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Axel=20D=C3=B6rfler?= <axeld@pinc-software.de>
Date: Sat, 8 Jan 2011 17:26:08 +0000
Subject: [PATCH] * Added Ingo's explanations as comments to the MakeLocate
 variants.

git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@40157 a95241bf-73f2-0310-859d-f6bbb57e9c96
---
 build/jam/MiscRules | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/build/jam/MiscRules b/build/jam/MiscRules
index eb4a0bb76c..973c368e08 100644
--- a/build/jam/MiscRules
+++ b/build/jam/MiscRules
@@ -73,11 +73,15 @@ rule SubIncludeGPL
 
 rule MakeLocateCommonPlatform
 {
+	# The file is shared between all target platforms.
 	MakeLocate $(1) : $(COMMON_PLATFORM_LOCATE_TARGET) ;
 }
 
 rule MakeLocatePlatform
 {
+	# The file is specific for the target platform, but
+	# architecture independent. Usually the right rule for generated
+	# sources, though sometimes sources can be architecture specific.
 	local files = $(1) ;
 	local file ;
 	for file in $(files) {
@@ -91,6 +95,9 @@ rule MakeLocatePlatform
 
 rule MakeLocateArch
 {
+	# The file is platform+architecture specific, but is debug
+	# level independent. This is usually the right rule for generated
+	# architecture specific data or source files.
 	local files = $(1) ;
 	local file ;
 	for file in $(files) {
@@ -104,6 +111,8 @@ rule MakeLocateArch
 
 rule MakeLocateDebug
 {
+	# The file is platform+architecture+debug level specific.
+	# That's what should be used for compiled code.
 	local files = $(1) ;
 	local file ;
 	for file in $(files) {