summaryrefslogtreecommitdiff
path: root/mk/misc
diff options
context:
space:
mode:
authorrillig <rillig>2009-07-28 07:01:56 +0000
committerrillig <rillig>2009-07-28 07:01:56 +0000
commitf9376d252baffe0c24699ef40bfc5c99e4a1721d (patch)
treef88e49caf419163393f34359cbcd33ac6cbbf842 /mk/misc
parent77af8747997efd680176ecc837a1101be24ed008 (diff)
downloadpkgsrc-f9376d252baffe0c24699ef40bfc5c99e4a1721d.tar.gz
Documented the trap into which I had just fallen.
Diffstat (limited to 'mk/misc')
-rw-r--r--mk/misc/show.mk9
1 files changed, 8 insertions, 1 deletions
diff --git a/mk/misc/show.mk b/mk/misc/show.mk
index b8f76242818..cbc85252424 100644
--- a/mk/misc/show.mk
+++ b/mk/misc/show.mk
@@ -1,4 +1,4 @@
-# $NetBSD: show.mk,v 1.9 2008/11/19 08:06:36 rillig Exp $
+# $NetBSD: show.mk,v 1.10 2009/07/28 07:01:56 rillig Exp $
#
# This file contains some targets that print information gathered from
# variables. They do not modify any variables.
@@ -88,6 +88,13 @@ show-build-defs: .PHONY
# * "pkg" for package-settable variables,
# * "sys" for system-defined variables.
#
+# CAVEAT: Some few variable values that are shown here may be
+# misleading. For example, make(1)'s := operator leaves references
+# to undefined variables as-is, so they may be resolved later. So
+# if you want to take a snapshot of the exact value of a variable,
+# you have to use "snapshot!=printf %s ''${var:q}" instead of
+# "snapshot:=${var}".
+#
# Keywords: debug show _vargroups
#