Improved documentation of show-var and show-vars.

1 files changed, 13 insertions, 6 deletions

diff --git a/mk/bsd.pkg.mk b/mk/bsd.pkg.mk
index 9dc325f8855..007b0ec3a46 100644
--- a/mk/bsd.pkg.mk
+++ b/mk/bsd.pkg.mk
@@ -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 @@ show-pkgtools-version:
 	@${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}