diff options
Diffstat (limited to 'mk/help/help.mk')
| -rw-r--r-- | mk/help/help.mk | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/mk/help/help.mk b/mk/help/help.mk new file mode 100644 index 00000000000..2c05935f47e --- /dev/null +++ b/mk/help/help.mk @@ -0,0 +1,38 @@ +# $NetBSD: help.mk,v 1.1 2006/10/23 14:40:15 rillig Exp $ +# + +# This is the integrated pkgsrc online help system. To query for the +# meaning of a variable, run "make help TOPIC=VARNAME". All variables from +# certain pkgsrc Makefile fragments that have inline comments are eligible +# for querying. + +.if !defined(_PKGSRC_HELP_MK) +_PKGSRC_HELP_MK= # defined + +_HELP_FILES= mk/*.mk mk/*/*.mk + +.if defined(VARNAME) +TOPIC?= ${VARNAME} +.endif +.if defined(topic) +TOPIC?= ${topic} +.endif + +.PHONY: help +help: +.if !defined(TOPIC) + @${PRINTF} "usage: %s help topic=<topic>\\n" ${MAKE:Q} + @${PRINTF} "\\n" + @${PRINTF} "\\t<topic> may be a variable name or a make target,\\n" + @${PRINTF} "\\tfor example CONFIGURE_DIRS or patch. For convenience,\\n" + @${PRINTF} "\\tyou don't need to use uppercase letters when typing\\n" + @${PRINTF} "\\tvariable names.\\n" + @${PRINTF} "\\n" +.else + ${_PKG_SILENT}${_PKG_DEBUG} set -e; \ + cd ${PKGSRCDIR}; \ + { for i in ${_HELP_FILES}; do ${CAT} "$$i"; ${ECHO} ""; done; } \ + | env TOPIC=${TOPIC:Q} ${AWK} -f ${PKGSRCDIR}/mk/help/help.awk +.endif + +.endif |