head 1.18; access; symbols pkgsrc-2023Q4:1.18.0.16 pkgsrc-2023Q4-base:1.18 pkgsrc-2023Q3:1.18.0.14 pkgsrc-2023Q3-base:1.18 pkgsrc-2023Q2:1.18.0.12 pkgsrc-2023Q2-base:1.18 pkgsrc-2023Q1:1.18.0.10 pkgsrc-2023Q1-base:1.18 pkgsrc-2022Q4:1.18.0.8 pkgsrc-2022Q4-base:1.18 pkgsrc-2022Q3:1.18.0.6 pkgsrc-2022Q3-base:1.18 pkgsrc-2022Q2:1.18.0.4 pkgsrc-2022Q2-base:1.18 pkgsrc-2022Q1:1.18.0.2 pkgsrc-2022Q1-base:1.18 pkgsrc-2021Q4:1.17.0.20 pkgsrc-2021Q4-base:1.17 pkgsrc-2021Q3:1.17.0.18 pkgsrc-2021Q3-base:1.17 pkgsrc-2021Q2:1.17.0.16 pkgsrc-2021Q2-base:1.17 pkgsrc-2021Q1:1.17.0.14 pkgsrc-2021Q1-base:1.17 pkgsrc-2020Q4:1.17.0.12 pkgsrc-2020Q4-base:1.17 pkgsrc-2020Q3:1.17.0.10 pkgsrc-2020Q3-base:1.17 pkgsrc-2020Q2:1.17.0.8 pkgsrc-2020Q2-base:1.17 pkgsrc-2020Q1:1.17.0.4 pkgsrc-2020Q1-base:1.17 pkgsrc-2019Q4:1.17.0.6 pkgsrc-2019Q4-base:1.17 pkgsrc-2019Q3:1.17.0.2 pkgsrc-2019Q3-base:1.17 pkgsrc-2019Q2:1.16.0.6 pkgsrc-2019Q2-base:1.16 pkgsrc-2019Q1:1.16.0.4 pkgsrc-2019Q1-base:1.16 pkgsrc-2018Q4:1.16.0.2 pkgsrc-2018Q4-base:1.16 pkgsrc-2018Q3:1.15.0.6 pkgsrc-2018Q3-base:1.15 pkgsrc-2018Q2:1.15.0.4 pkgsrc-2018Q2-base:1.15 pkgsrc-2018Q1:1.15.0.2 pkgsrc-2018Q1-base:1.15 pkgsrc-2017Q4:1.13.0.2 pkgsrc-2017Q4-base:1.13 pkgsrc-2017Q3:1.12.0.16 pkgsrc-2017Q3-base:1.12 pkgsrc-2017Q2:1.12.0.12 pkgsrc-2017Q2-base:1.12 pkgsrc-2017Q1:1.12.0.10 pkgsrc-2017Q1-base:1.12 pkgsrc-2016Q4:1.12.0.8 pkgsrc-2016Q4-base:1.12 pkgsrc-2016Q3:1.12.0.6 pkgsrc-2016Q3-base:1.12 pkgsrc-2016Q2:1.12.0.4 pkgsrc-2016Q2-base:1.12 pkgsrc-2016Q1:1.12.0.2 pkgsrc-2016Q1-base:1.12 pkgsrc-2015Q4:1.10.0.72 pkgsrc-2015Q4-base:1.10 pkgsrc-2015Q3:1.10.0.70 pkgsrc-2015Q3-base:1.10 pkgsrc-2015Q2:1.10.0.68 pkgsrc-2015Q2-base:1.10 pkgsrc-2015Q1:1.10.0.66 pkgsrc-2015Q1-base:1.10 pkgsrc-2014Q4:1.10.0.64 pkgsrc-2014Q4-base:1.10 pkgsrc-2014Q3:1.10.0.62 pkgsrc-2014Q3-base:1.10 pkgsrc-2014Q2:1.10.0.60 pkgsrc-2014Q2-base:1.10 pkgsrc-2014Q1:1.10.0.58 pkgsrc-2014Q1-base:1.10 pkgsrc-2013Q4:1.10.0.56 pkgsrc-2013Q4-base:1.10 pkgsrc-2013Q3:1.10.0.54 pkgsrc-2013Q3-base:1.10 pkgsrc-2013Q2:1.10.0.52 pkgsrc-2013Q2-base:1.10 pkgsrc-2013Q1:1.10.0.50 pkgsrc-2013Q1-base:1.10 pkgsrc-2012Q4:1.10.0.48 pkgsrc-2012Q4-base:1.10 pkgsrc-2012Q3:1.10.0.46 pkgsrc-2012Q3-base:1.10 pkgsrc-2012Q2:1.10.0.44 pkgsrc-2012Q2-base:1.10 pkgsrc-2012Q1:1.10.0.42 pkgsrc-2012Q1-base:1.10 pkgsrc-2011Q4:1.10.0.40 pkgsrc-2011Q4-base:1.10 pkgsrc-2011Q3:1.10.0.38 pkgsrc-2011Q3-base:1.10 pkgsrc-2011Q2:1.10.0.36 pkgsrc-2011Q2-base:1.10 pkgsrc-2011Q1:1.10.0.34 pkgsrc-2011Q1-base:1.10 pkgsrc-2010Q4:1.10.0.32 pkgsrc-2010Q4-base:1.10 pkgsrc-2010Q3:1.10.0.30 pkgsrc-2010Q3-base:1.10 pkgsrc-2010Q2:1.10.0.28 pkgsrc-2010Q2-base:1.10 pkgsrc-2010Q1:1.10.0.26 pkgsrc-2010Q1-base:1.10 pkgsrc-2009Q4:1.10.0.24 pkgsrc-2009Q4-base:1.10 pkgsrc-2009Q3:1.10.0.22 pkgsrc-2009Q3-base:1.10 pkgsrc-2009Q2:1.10.0.20 pkgsrc-2009Q2-base:1.10 pkgsrc-2009Q1:1.10.0.18 pkgsrc-2009Q1-base:1.10 pkgsrc-2008Q4:1.10.0.16 pkgsrc-2008Q4-base:1.10 pkgsrc-2008Q3:1.10.0.14 pkgsrc-2008Q3-base:1.10 cube-native-xorg:1.10.0.12 cube-native-xorg-base:1.10 pkgsrc-2008Q2:1.10.0.10 pkgsrc-2008Q2-base:1.10 cwrapper:1.10.0.8 pkgsrc-2008Q1:1.10.0.6 pkgsrc-2008Q1-base:1.10 pkgsrc-2007Q4:1.10.0.4 pkgsrc-2007Q4-base:1.10 pkgsrc-2007Q3:1.10.0.2 pkgsrc-2007Q3-base:1.10 pkgsrc-2007Q2:1.9.0.2 pkgsrc-2007Q2-base:1.9 pkgsrc-2007Q1:1.7.0.4 pkgsrc-2007Q1-base:1.7 jlam-pkgviews:1.7.0.2 jlam-pkgviews-base:1.7 pkgsrc-2006Q4:1.3.0.2 pkgsrc-2006Q4-base:1.3; locks; strict; comment @# @; 1.18 date 2022.01.24.23.16.01; author gutteridge; state Exp; branches; next 1.17; commitid 1dKMy9oCQPyBtWpD; 1.17 date 2019.09.09.09.38.36; author maya; state Exp; branches; next 1.16; commitid 74yEpn7rXVocRjCB; 1.16 date 2018.12.20.16.57.04; author rillig; state Exp; branches; next 1.15; commitid 74MYg35vACXNJy4B; 1.15 date 2018.03.11.14.50.49; author rillig; state Exp; branches; next 1.14; commitid AcfDcX0NKwtqa3uA; 1.14 date 2018.01.07.11.23.37; author rillig; state Exp; branches; next 1.13; commitid aoSOoVhAeyzN2WlA; 1.13 date 2017.10.31.16.24.42; author rillig; state Exp; branches; next 1.12; commitid QclwpL07dxgBTddA; 1.12 date 2016.02.01.18.47.23; author leot; state Exp; branches; next 1.11; commitid 4T2eL7PdQfsmbfTy; 1.11 date 2015.12.27.19.41.29; author wiz; state Exp; branches; next 1.10; commitid VOuBnFFtYD9xECOy; 1.10 date 2007.08.13.05.58.44; author rillig; state Exp; branches; next 1.9; 1.9 date 2007.05.24.05.33.49; author rillig; state Exp; branches; next 1.8; 1.8 date 2007.04.11.06.40.09; author rillig; state Exp; branches; next 1.7; 1.7 date 2007.03.09.01.34.50; author rillig; state Exp; branches; next 1.6; 1.6 date 2007.01.12.07.54.30; author rillig; state Exp; branches; next 1.5; 1.5 date 2007.01.06.16.49.40; author rillig; state Exp; branches; next 1.4; 1.4 date 2007.01.02.17.22.30; author rillig; state Exp; branches; next 1.3; 1.3 date 2006.12.21.19.50.20; author rillig; state Exp; branches; next 1.2; 1.2 date 2006.11.04.22.04.44; author rillig; state Exp; branches; next 1.1; 1.1 date 2006.10.23.14.40.15; author rillig; state Exp; branches; next ; desc @@ 1.18 log @help/help.mk: pick up further language-specific variables Add lua, nodejs, octave, qore, and tk-specific variables. (tk and tk85 define the same variable, so I only included tk.) This relates to PR pkg/56301, where I noticed various REPLACE_* variables were not listed in Appendix E of the pkgsrc guide. There is a separate issue related to Appendix E here. If wip/mk is found, the auto-generation of the help topic list for the pkgsrc guide includes anything it finds under that path, but that's potentially misleading, and causes the generated list to see-saw back and forth as committers do or do not have wip visible (I do not). @ text @# $NetBSD: help.mk,v 1.17 2019/09/09 09:38:36 maya 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. _HELP_FILES= Makefile _HELP_FILES+= mk/*.mk mk/*/*.mk mk/*/*/*.mk _HELP_FILES+= mk/defaults/mk.conf _HELP_FILES+= lang/go/*.mk _HELP_FILES+= lang/lua/*.mk _HELP_FILES+= lang/nodejs/*.mk _HELP_FILES+= lang/perl5/*.mk _HELP_FILES+= lang/php/*.mk _HELP_FILES+= lang/python/*.mk _HELP_FILES+= lang/qore/*.mk _HELP_FILES+= lang/ruby/*.mk _HELP_FILES+= math/octave/*.mk _HELP_FILES+= print/texlive/*.mk _HELP_FILES+= x11/tk/*.mk _HELP_FILES+= mk/*/*.help .if exists(${.PARSEDIR}/../../wip/mk) _HELP_FILES+= wip/mk/*.mk .endif .if defined(VARNAME) TOPIC?= ${VARNAME} .endif .if defined(topic) TOPIC?= ${topic} .endif .if !target(help) .PHONY: help help: . if !defined(TOPIC) @@${ECHO} "usage: "${MAKE:Q}" help topic=" @@${ECHO} "" @@${ECHO} " may be a variable name or a make target," @@${ECHO} " for example CONFIGURE_DIRS or patch." @@${ECHO} "" @@${ECHO} " For convenience, all-uppercase topics such as variable" @@${ECHO} " names may also be given in all-lowercase." @@${ECHO} "" @@${ECHO} " To see all available topics, use:" @@${ECHO} " make help topic=:index" @@${ECHO} "" . else ${RUN} env TOPIC=${TOPIC:Q} ${AWK} -f ${PKGSRCDIR}/mk/help/help.awk \ ${_HELP_FILES:S|^|${_PKGSRC_TOPDIR}/|:S|^${.CURDIR}|.|:S,^./,,} \ | $${PAGER:-cat} . endif .endif @ 1.17 log @Be more verbose about how to list the available topics. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.16 2018/12/20 16:57:04 rillig Exp $ d13 6 a18 1 _HELP_FILES+= lang/perl5/*.mk lang/php/*.mk lang/python/*.mk d20 1 d22 1 @ 1.16 log @mk/help: if no help is found, output releative path names @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.15 2018/03/11 14:50:49 rillig Exp $ d40 2 a41 1 @@${ECHO} " The special topic :index lists all available topics." @ 1.15 log @mk/help: run "make help" through the pager by default @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.14 2018/01/07 11:23:37 rillig Exp $ d43 2 a44 2 ${RUN} cd ${PKGSRCDIR}; \ env TOPIC=${TOPIC:Q} ${AWK} -f ${PKGSRCDIR}/mk/help/help.awk ${_HELP_FILES} \ @ 1.14 log @Improved documentation for "make help". The check for target(help) prevents a warning when "make help" is run from a category directory. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.13 2017/10/31 16:24:42 rillig Exp $ d44 2 a45 1 env TOPIC=${TOPIC:Q} ${AWK} -f ${PKGSRCDIR}/mk/help/help.awk ${_HELP_FILES} @ 1.13 log @Improved index generation for "make help". The index is sorted alphabetically and mentioned in a plain "make help" call. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.12 2016/02/01 18:47:23 leot Exp $ d28 1 d31 1 a31 1 .if !defined(TOPIC) d42 1 a42 1 .else d45 1 @ 1.12 log @Add keywords to print/texlive/package.mk and instruct mk/help/help.mk to also look for print/texlive/*.mk files for help. Now documentation regarding TeX packages for pkgsrc MAINTAINERs and developers is easily accessible via the "help" target. ok wiz@@ @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.11 2015/12/27 19:41:29 wiz Exp $ d34 6 a39 3 @@${ECHO} " for example CONFIGURE_DIRS or patch. For convenience," @@${ECHO} " you don't need to use uppercase letters when typing" @@${ECHO} " variable names." @ 1.11 log @Look in lang/go/*.mk for help topics too. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.10 2007/08/13 05:58:44 rillig Exp $ d15 1 @ 1.10 log @This file doesn't need the multiple-inclusion guards. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.9 2007/05/24 05:33:49 rillig Exp $ d12 1 @ 1.9 log @Replaced printf(1) with echo(1), since printf is not available in the top-level directory of pkgsrc. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.8 2007/04/11 06:40:09 rillig Exp $ a8 3 .if !defined(_PKGSRC_HELP_MK) _PKGSRC_HELP_MK= # defined a39 2 .endif @ 1.8 log @When pkgsrc-wip is available, look in those files, too. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.7 2007/03/09 01:34:50 rillig Exp $ d32 7 a38 7 @@${PRINTF} "usage: %s help topic=\\n" ${MAKE:Q} @@${PRINTF} "\\n" @@${PRINTF} "\\t 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" @ 1.7 log @The mk/*/*/*.mk files are also interesting. Don't print the make target definition in the help text. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.6 2007/01/12 07:54:30 rillig Exp $ d18 3 @ 1.6 log @Added the file msg.help, which describes the INFO_MSG, WARNING_MSG, ERROR_MSG and FATAL_MSG commands. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.5 2007/01/06 16:49:40 rillig Exp $ d13 1 a13 1 _HELP_FILES+= mk/*.mk mk/*/*.mk @ 1.5 log @Rewrote the AWK program and added many comments. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.4 2007/01/02 17:22:30 rillig Exp $ d17 1 @ 1.4 log @Rewrote the integrated help to show the complete pathname, not only the RCS Id, of the file containing the documentation. When the documentation contains lines starting with "Keywords:", these lines are not shown by "make help", but all following words are checked for the topic. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.3 2006/12/21 19:50:20 rillig Exp $ d12 3 a14 1 _HELP_FILES= mk/*.mk mk/*/*.mk mk/defaults/mk.conf @ 1.3 log @The *.mk files for Perl, PHP, Python and Ruby packages are also searched for documentation by "make help". @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.2 2006/11/04 22:04:44 rillig Exp $ d34 2 a35 4 ${_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 @ 1.2 log @mk/defaults/mk.conf is an important source for online help. It just doesn't match the *.mk pattern, and that's why it had been excluded up to now, accidentally. @ text @d1 1 a1 1 # $NetBSD: help.mk,v 1.1 2006/10/23 14:40:15 rillig Exp $ d13 2 @ 1.1 log @Moved the help system into its own subdirectory. Extracted the AWK program into its own file, since that way, one can add comments to the code. For convenience, keyword search is case insensitive. @ text @d1 1 a1 1 # $NetBSD: bsd.pkg.help.mk,v 1.5 2006/10/01 14:52:32 rillig Exp $ d12 1 a12 1 _HELP_FILES= mk/*.mk mk/*/*.mk @