[pkgsrc/trunk]: pkgsrc/mk Improved documentation for "make help".

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/671bda342f38
branches:  trunk
changeset: 373601:671bda342f38
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun Jan 07 11:23:37 2018 +0000

description:
Improved documentation for "make help".

The check for target(help) prevents a warning when "make help" is run from
a category directory.

diffstat:

 mk/checksum/bsd.checksum-vars.mk |  3 ++-
 mk/checksum/bsd.checksum.mk      |  3 ++-
 mk/help/help.mk                  |  8 +++++---
 mk/misc/category.mk              |  5 +++--
 mk/tools/replace.mk              |  3 ++-
 5 files changed, 14 insertions(+), 8 deletions(-)

diffs (95 lines):

diff -r a23508126102 -r 671bda342f38 mk/checksum/bsd.checksum-vars.mk
--- a/mk/checksum/bsd.checksum-vars.mk  Sun Jan 07 11:20:18 2018 +0000
+++ b/mk/checksum/bsd.checksum-vars.mk  Sun Jan 07 11:23:37 2018 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: bsd.checksum-vars.mk,v 1.2 2008/05/22 16:27:22 joerg Exp $
+# $NetBSD: bsd.checksum-vars.mk,v 1.3 2018/01/07 11:23:37 rillig Exp $
 #
 # This Makefile fragment is included separately by bsd.pkg.mk and
 # defines some variables which must be defined earlier than where
@@ -8,6 +8,7 @@
 #
 #    DISTINFO_FILE is the path to file containing the checksums.
 #
+# Keywords: distinfo
 
 DISTINFO_FILE?=                ${PKGDIR}/distinfo
 
diff -r a23508126102 -r 671bda342f38 mk/checksum/bsd.checksum.mk
--- a/mk/checksum/bsd.checksum.mk       Sun Jan 07 11:20:18 2018 +0000
+++ b/mk/checksum/bsd.checksum.mk       Sun Jan 07 11:23:37 2018 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: bsd.checksum.mk,v 1.10 2009/07/15 09:40:30 joerg Exp $
+# $NetBSD: bsd.checksum.mk,v 1.11 2018/01/07 11:23:37 rillig Exp $
 #
 # This Makefile fragment is included by bsd.pkg.mk and defines the
 # relevant variables and targets for the "checksum" phase.
@@ -40,6 +40,7 @@
 #
 #      Default value: undefined
 #
+# Keywords: distinfo
 
 .PHONY: checksum checksum-phase
 .PHONY: makesum makepatchsum mps mdi makedistinfo distinfo
diff -r a23508126102 -r 671bda342f38 mk/help/help.mk
--- a/mk/help/help.mk   Sun Jan 07 11:20:18 2018 +0000
+++ b/mk/help/help.mk   Sun Jan 07 11:23:37 2018 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: help.mk,v 1.13 2017/10/31 16:24:42 rillig Exp $
+# $NetBSD: help.mk,v 1.14 2018/01/07 11:23:37 rillig Exp $
 #
 
 # This is the integrated pkgsrc online help system. To query for the
@@ -25,9 +25,10 @@
 TOPIC?=                ${topic}
 .endif
 
+.if !target(help)
 .PHONY: help
 help:
-.if !defined(TOPIC)
+.  if !defined(TOPIC)
        @${ECHO} "usage: "${MAKE:Q}" help topic=<topic>"
        @${ECHO} ""
        @${ECHO} "      <topic> may be a variable name or a make target,"
@@ -38,7 +39,8 @@
        @${ECHO} ""
        @${ECHO} "      The special topic :index lists all available topics."
        @${ECHO} ""
-.else
+.  else
        ${RUN} cd ${PKGSRCDIR};                                         \
        env TOPIC=${TOPIC:Q} ${AWK} -f ${PKGSRCDIR}/mk/help/help.awk ${_HELP_FILES}
+.  endif
 .endif
diff -r a23508126102 -r 671bda342f38 mk/misc/category.mk
--- a/mk/misc/category.mk       Sun Jan 07 11:20:18 2018 +0000
+++ b/mk/misc/category.mk       Sun Jan 07 11:23:37 2018 +0000
@@ -1,6 +1,7 @@
-# $NetBSD: category.mk,v 1.2 2007/10/13 11:04:18 dsl Exp $
+# $NetBSD: category.mk,v 1.3 2018/01/07 11:23:37 rillig Exp $
 #
-# This file contains the variables and targets for category Makefiles.
+# This file contains the variables and targets for category Makefiles,
+# e.g. x11/Makefile.
 #
 
 .include "common.mk"
diff -r a23508126102 -r 671bda342f38 mk/tools/replace.mk
--- a/mk/tools/replace.mk       Sun Jan 07 11:20:18 2018 +0000
+++ b/mk/tools/replace.mk       Sun Jan 07 11:23:37 2018 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: replace.mk,v 1.280 2017/08/01 15:09:52 wiz Exp $
+# $NetBSD: replace.mk,v 1.281 2018/01/07 11:23:37 rillig Exp $
 #
 # Copyright (c) 2005 The NetBSD Foundation, Inc.
 # All rights reserved.
@@ -78,6 +78,7 @@
 #
 #      USE_TOOLS+=     perl:run
 #
+# Keywords: USE_TOOLS tool tools
 
 # bison implies "bison-yacc"
 .if !empty(USE_TOOLS:Mbison) || !empty(USE_TOOLS:Mbison\:*)