[pkgsrc/trunk]: pkgsrc/mk/buildlink3 Add some documentation.

[jlam <jlam%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/e6478423f04f
branches:  trunk
changeset: 462494:e6478423f04f
user:      jlam <jlam%pkgsrc.org@localhost>
date:      Sat Oct 04 10:20:09 2003 +0000

description:
Add some documentation.

diffstat:

 mk/buildlink3/buildcmd |  4 ++--
 mk/buildlink3/logic    |  8 ++++++--
 mk/buildlink3/marshall |  6 +++++-
 3 files changed, 13 insertions(+), 5 deletions(-)

diffs (42 lines):

diff -r aad75a2aa178 -r e6478423f04f mk/buildlink3/buildcmd
--- a/mk/buildlink3/buildcmd    Sat Oct 04 08:12:02 2003 +0000
+++ b/mk/buildlink3/buildcmd    Sat Oct 04 10:20:09 2003 +0000
@@ -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 -r aad75a2aa178 -r e6478423f04f mk/buildlink3/logic
--- a/mk/buildlink3/logic       Sat Oct 04 08:12:02 2003 +0000
+++ b/mk/buildlink3/logic       Sat Oct 04 10:20:09 2003 +0000
@@ -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 -r aad75a2aa178 -r e6478423f04f mk/buildlink3/marshall
--- a/mk/buildlink3/marshall    Sat Oct 04 08:12:02 2003 +0000
+++ b/mk/buildlink3/marshall    Sat Oct 04 10:20:09 2003 +0000
@@ -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
 #