summaryrefslogtreecommitdiffstats
path: root/Makefile.org
diff options
context:
space:
mode:
authorRichard Levitte <levitte@openssl.org>2006-02-10 08:48:43 +0000
committerRichard Levitte <levitte@openssl.org>2006-02-10 08:48:43 +0000
commitb480283c56cd7c93237aad1ef6b269b357b46c5f (patch)
treedab7e53f2640013c188a265084cef0076f941674 /Makefile.org
parentf5ce5e14653fb5225252075b585b3101d54f30ea (diff)
Document the building macros.
Diffstat (limited to 'Makefile.org')
-rw-r--r--Makefile.org13
1 files changed, 13 insertions, 0 deletions
diff --git a/Makefile.org b/Makefile.org
index da63e906b7..902bcd9a41 100644
--- a/Makefile.org
+++ b/Makefile.org
@@ -197,6 +197,19 @@ BUILDENV= PLATFORM='${PLATFORM}' PROCESSOR='${PROCESSOR}' \
# MAKEOVERRIDES= effectively "equalizes" GNU-ish and SysV-ish make flavors,
# which in turn eliminates ambiguities in variable treatment with -e.
+# BUILD_CMD is a generic macro to build a given target in a given
+# subdirectory. The target must be given through the shell variable
+# `target' and the subdirectory to build in must be given through `dir'.
+# This macro shouldn't be used directly, use RECURSIVE_BUILD_CMD or
+# BUILD_ONE_CMD instead.
+#
+# BUILD_ONE_CMD is a macro to build a given target in a given
+# subdirectory if that subdirectory is part of $(DIRS). It requires
+# exactly the same shell variables as BUILD_CMD.
+#
+# RECURSIVE_BUILD_CMD is a macro to build a given target in all
+# subdirectories defined in $(DIRS). It requires that the target
+# is given through the shell variable `target'.
BUILD_CMD= if [ -d "$$dir" ]; then \
( cd $$dir && echo "making $$target in $$dir..." && \
$(CLEARENV) && $(MAKE) -e $(BUILDENV) TOP=.. DIR=$$dir $$target \