[pkgsrc/trunk]: pkgsrc/mk Improved documentation of show-var and show-vars.

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/4942c3afe9cf
branches:  trunk
changeset: 348259:4942c3afe9cf
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sat Jun 11 12:41:30 2016 +0000

description:
Improved documentation of show-var and show-vars.

diffstat:

 mk/bsd.pkg.mk |  19 +++++++++++++------
 1 files changed, 13 insertions(+), 6 deletions(-)

diffs (39 lines):

diff -r 9da0251560ce -r 4942c3afe9cf mk/bsd.pkg.mk
--- a/mk/bsd.pkg.mk     Sat Jun 11 12:34:37 2016 +0000
+++ b/mk/bsd.pkg.mk     Sat Jun 11 12:41:30 2016 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: bsd.pkg.mk,v 1.2019 2016/05/26 16:03:04 khorben Exp $
+#      $NetBSD: bsd.pkg.mk,v 1.2020 2016/06/11 12:41:30 rillig Exp $
 #
 # This file is in the public domain.
 #
@@ -688,17 +688,24 @@
        @${ECHO} ${PKGTOOLS_VERSION}
 .endif
 
-# convenience target, to display make variables from command line
-# i.e. "make show-var VARNAME=var", will print var's value
+# show-var:
+# show-vars:
+# show-subdir-var:
+#      Convenience targets, to display make variables from the command
+#      line. Examples:
 #
-# See also:
-#      show-vars, show-subdir-var
+#      make show-var VARNAME=PKGNAME
+#      make show-vars VARNAMES="PKGNAME PKGVERSION PKGREVISION"
+#      make show-subdir-var VARNAME=DISTFILES
 #
+#      In category directories, show-var and show-vars descend
+#      recursively into each subdirectory, printing the variables of
+#      the individual packages. To show a variable from the category
+#      itself, use show-subdir-var.
 .PHONY: show-var
 show-var:
        @${ECHO} ${${VARNAME}:Q}
 
-# enhanced version of target above, to display multiple variables
 .PHONY: show-vars
 show-vars:
 .for VARNAME in ${VARNAMES}