Add some documentation.

3 files changed, 13 insertions, 5 deletions

diff --git a/mk/buildlink3/buildcmd b/mk/buildlink3/buildcmd
index 2a1bb6814a4..3f1fe936831 100644
--- a/mk/buildlink3/buildcmd
+++ b/mk/buildlink3/buildcmd
@@ -1,8 +1,8 @@
-# $NetBSD: buildcmd,v 1.1 2003/10/03 19:39:19 jlam Exp $
+# $NetBSD: buildcmd,v 1.2 2003/10/04 10:20:09 jlam Exp $
 #
 # Append $arg to $cmd to build up the command line to be executed, but
 # directly add the next few arguments to $cmd if $skipargs > 0.
-
+#
 if $test $skipargs -gt 0; then
 	cmd="$cmd $arg"
 	while $test $skipargs -gt 0; do
diff --git a/mk/buildlink3/logic b/mk/buildlink3/logic
index 75b9b2909ff..b42d8e7ae5e 100644
--- a/mk/buildlink3/logic
+++ b/mk/buildlink3/logic
@@ -1,5 +1,9 @@
-# $NetBSD: logic,v 1.4 2003/10/03 19:39:19 jlam Exp $
-
+# $NetBSD: logic,v 1.5 2003/10/04 10:20:09 jlam Exp $
+#
+# If the wrapper caches don't cover the $arg we're examining, then run
+# it through the transformations and any wrapper-specific post-logic
+# and cache the result.
+#
 quotedarg=no
 addtocache=no
 addtoprivatecache=no
diff --git a/mk/buildlink3/marshall b/mk/buildlink3/marshall
index 3e949030995..bf0cda279a6 100644
--- a/mk/buildlink3/marshall
+++ b/mk/buildlink3/marshall
@@ -1,4 +1,8 @@
-# $NetBSD: marshall,v 1.3 2003/10/03 19:40:55 jlam Exp $
+# $NetBSD: marshall,v 1.4 2003/10/04 10:20:09 jlam Exp $
+#
+# Handle cases where multiple consecutive arguments must be processed
+# together, either by merging the arguments or "skipping" the extra
+# arguments.
 #
 case $arg in
 #