The NetBSD Project

CVS log for pkgsrc/mk/help/help.awk

[BACK] Up to [cvs.NetBSD.org] / pkgsrc / mk / help

Request diff between arbitrary revisions


Default branch: MAIN


Revision 1.44 / (download) - annotate - [select for diffs], Sat May 20 16:14:07 2023 UTC (11 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2024Q1-base, pkgsrc-2024Q1, pkgsrc-2023Q4-base, pkgsrc-2023Q4, pkgsrc-2023Q3-base, pkgsrc-2023Q3, pkgsrc-2023Q2-base, pkgsrc-2023Q2, HEAD
Changes since 1.43: +3 -5 lines
Diff to previous 1.43 (colored)

mk/help.awk: clean up comments

Revision 1.43 / (download) - annotate - [select for diffs], Sat Jun 11 15:58:41 2022 UTC (22 months, 1 week ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2023Q1-base, pkgsrc-2023Q1, pkgsrc-2022Q4-base, pkgsrc-2022Q4, pkgsrc-2022Q3-base, pkgsrc-2022Q3, pkgsrc-2022Q2-base, pkgsrc-2022Q2
Changes since 1.42: +8 -8 lines
Diff to previous 1.42 (colored)

mk/help: replace 'appear' with 'occur', as it is more accurate

Revision 1.42 / (download) - annotate - [select for diffs], Tue Aug 4 21:46:44 2020 UTC (3 years, 8 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2022Q1-base, pkgsrc-2022Q1, pkgsrc-2021Q4-base, pkgsrc-2021Q4, pkgsrc-2021Q3-base, pkgsrc-2021Q3, pkgsrc-2021Q2-base, pkgsrc-2021Q2, pkgsrc-2021Q1-base, pkgsrc-2021Q1, pkgsrc-2020Q4-base, pkgsrc-2020Q4, pkgsrc-2020Q3-base, pkgsrc-2020Q3
Changes since 1.41: +4 -4 lines
Diff to previous 1.41 (colored)

mk/help: fix help parser for variable names followed by comma

Seen in mk/fetch/fetch.mk for FETCH_USE_IPV4_ONLY.

Revision 1.41 / (download) - annotate - [select for diffs], Sun May 3 10:57:06 2020 UTC (3 years, 11 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2020Q2-base, pkgsrc-2020Q2
Changes since 1.40: +6 -9 lines
Diff to previous 1.40 (colored)

mk/help: clean up code

Revision 1.40 / (download) - annotate - [select for diffs], Sun May 3 10:51:06 2020 UTC (3 years, 11 months ago) by rillig
Branch: MAIN
Changes since 1.39: +14 -14 lines
Diff to previous 1.39 (colored)

mk/help: remove negation from variable names

Revision 1.39 / (download) - annotate - [select for diffs], Sun May 3 09:51:07 2020 UTC (3 years, 11 months ago) by rillig
Branch: MAIN
Changes since 1.38: +5 -3 lines
Diff to previous 1.38 (colored)

mk/help: do not treat continuation lines as textual comments

Revision 1.38 / (download) - annotate - [select for diffs], Sun May 3 09:44:07 2020 UTC (3 years, 11 months ago) by rillig
Branch: MAIN
Changes since 1.37: +6 -6 lines
Diff to previous 1.37 (colored)

mk/help: make variable more precise

The word "ignore" was too unspecific.  There are lines that should be
printed, and there are lines that should be evaluated.

Revision 1.37 / (download) - annotate - [select for diffs], Sun May 3 09:06:59 2020 UTC (3 years, 11 months ago) by rillig
Branch: MAIN
Changes since 1.36: +15 -16 lines
Diff to previous 1.36 (colored)

mk/help: clean up code for selecting relevant help topics

Revision 1.36 / (download) - annotate - [select for diffs], Sun May 3 08:49:16 2020 UTC (3 years, 11 months ago) by rillig
Branch: MAIN
Changes since 1.35: +9 -3 lines
Diff to previous 1.35 (colored)

mk/help: only list help topics that have associated keywords

Revision 1.35 / (download) - annotate - [select for diffs], Mon Mar 30 06:21:52 2020 UTC (4 years ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2020Q1-base, pkgsrc-2020Q1
Changes since 1.34: +33 -6 lines
Diff to previous 1.34 (colored)

mk/help/help.awk: find library functions in undefined-references.help

Before, searching for topic=socket did not find the documentation.

The detection of useful help topics is still not perfect since it now
finds sections that consist of a single word, such as the word
"undo-replace" in mk/install/replace.mk, but that will be fixed later,
after adding a few unit tests.

Revision 1.34 / (download) - annotate - [select for diffs], Sun Aug 25 20:30:11 2019 UTC (4 years, 7 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2019Q4-base, pkgsrc-2019Q4, pkgsrc-2019Q3-base, pkgsrc-2019Q3
Changes since 1.33: +2 -2 lines
Diff to previous 1.33 (colored)

mk/help: remove unnecessary backslash before # in AWK program

GNU Awk on Cygwin warns about these.

Revision 1.33 / (download) - annotate - [select for diffs], Sun Apr 28 12:10:24 2019 UTC (4 years, 11 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2019Q2-base, pkgsrc-2019Q2
Changes since 1.32: +2 -2 lines
Diff to previous 1.32 (colored)

mk/help: do not provide help for topics starting with underscore

These are reserved for the pkgsrc infrastructure.

Revision 1.32 / (download) - annotate - [select for diffs], Sun Mar 3 16:47:58 2019 UTC (5 years, 1 month ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2019Q1-base, pkgsrc-2019Q1
Changes since 1.31: +6 -6 lines
Diff to previous 1.31 (colored)

mk/help: remove extra empty line when listing all help topics

Revision 1.31 / (download) - annotate - [select for diffs], Sun Jul 22 06:45:31 2018 UTC (5 years, 8 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2018Q4-base, pkgsrc-2018Q4, pkgsrc-2018Q3-base, pkgsrc-2018Q3
Changes since 1.30: +19 -11 lines
Diff to previous 1.30 (colored)

mk/help: if no intentional documentation is found, list containing files

Revision 1.30 / (download) - annotate - [select for diffs], Wed Mar 7 00:14:57 2018 UTC (6 years, 1 month ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2018Q2-base, pkgsrc-2018Q2, pkgsrc-2018Q1-base, pkgsrc-2018Q1
Changes since 1.29: +24 -5 lines
Diff to previous 1.29 (colored)

mk/help: sort keywords

Revision 1.29 / (download) - annotate - [select for diffs], Tue Mar 6 23:49:37 2018 UTC (6 years, 1 month ago) by rillig
Branch: MAIN
Changes since 1.28: +16 -2 lines
Diff to previous 1.28 (colored)

mk/help: ignore topics in lines that are indented by at least 2 tabs

The variable names are typically mentioned in one of these styles:

# Package-settable variables:
#
# VARNAME
#	Description

# Package-settable variables:
#
#	VARNAME
#		Description

Lines that are indented with two tabs contain text. And if one of these
lines starts with a variable name, it is just a coincidence. A practical
example of this happening is in mk/misc/developer.mk 1.24, where PKGNAME
starts a line of description.

Revision 1.28 / (download) - annotate - [select for diffs], Tue Oct 31 16:24:42 2017 UTC (6 years, 5 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2017Q4-base, pkgsrc-2017Q4
Changes since 1.27: +4 -2 lines
Diff to previous 1.27 (colored)

Improved index generation for "make help".

The index is sorted alphabetically and mentioned in a plain "make help"
call.

Revision 1.27 / (download) - annotate - [select for diffs], Sat Aug 31 21:27:53 2013 UTC (10 years, 7 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2017Q3-base, pkgsrc-2017Q3, pkgsrc-2017Q2-base, pkgsrc-2017Q2, pkgsrc-2017Q1-base, pkgsrc-2017Q1, pkgsrc-2016Q4-base, pkgsrc-2016Q4, pkgsrc-2016Q3-base, pkgsrc-2016Q3, pkgsrc-2016Q2-base, pkgsrc-2016Q2, pkgsrc-2016Q1-base, pkgsrc-2016Q1, pkgsrc-2015Q4-base, pkgsrc-2015Q4, pkgsrc-2015Q3-base, pkgsrc-2015Q3, pkgsrc-2015Q2-base, pkgsrc-2015Q2, pkgsrc-2015Q1-base, pkgsrc-2015Q1, pkgsrc-2014Q4-base, pkgsrc-2014Q4, pkgsrc-2014Q3-base, pkgsrc-2014Q3, pkgsrc-2014Q2-base, pkgsrc-2014Q2, pkgsrc-2014Q1-base, pkgsrc-2014Q1, pkgsrc-2013Q4-base, pkgsrc-2013Q4, pkgsrc-2013Q3-base, pkgsrc-2013Q3
Changes since 1.26: +4 -3 lines
Diff to previous 1.26 (colored)

Up to now there was no way to get help on pkgsrc internal variables,
like _PKG_VARS. Since there exists documentation on these internal
variables, it should be found by "bmake help".

Revision 1.26 / (download) - annotate - [select for diffs], Fri May 15 21:10:31 2009 UTC (14 years, 11 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2013Q2-base, pkgsrc-2013Q2, pkgsrc-2013Q1-base, pkgsrc-2013Q1, pkgsrc-2012Q4-base, pkgsrc-2012Q4, pkgsrc-2012Q3-base, pkgsrc-2012Q3, pkgsrc-2012Q2-base, pkgsrc-2012Q2, pkgsrc-2012Q1-base, pkgsrc-2012Q1, pkgsrc-2011Q4-base, pkgsrc-2011Q4, pkgsrc-2011Q3-base, pkgsrc-2011Q3, pkgsrc-2011Q2-base, pkgsrc-2011Q2, pkgsrc-2011Q1-base, pkgsrc-2011Q1, pkgsrc-2010Q4-base, pkgsrc-2010Q4, pkgsrc-2010Q3-base, pkgsrc-2010Q3, pkgsrc-2010Q2-base, pkgsrc-2010Q2, pkgsrc-2010Q1-base, pkgsrc-2010Q1, pkgsrc-2009Q4-base, pkgsrc-2009Q4, pkgsrc-2009Q3-base, pkgsrc-2009Q3, pkgsrc-2009Q2-base, pkgsrc-2009Q2
Changes since 1.25: +2 -2 lines
Diff to previous 1.25 (colored)

Re-enabled the detection of variables as they appear in
mk/defaults/mk.conf. I don't know when I removed it accidentally.

Revision 1.25 / (download) - annotate - [select for diffs], Wed Feb 20 10:42:21 2008 UTC (16 years, 2 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2009Q1-base, pkgsrc-2009Q1, pkgsrc-2008Q4-base, pkgsrc-2008Q4, pkgsrc-2008Q3-base, pkgsrc-2008Q3, pkgsrc-2008Q2-base, pkgsrc-2008Q2, pkgsrc-2008Q1-base, pkgsrc-2008Q1, cwrapper, cube-native-xorg-base, cube-native-xorg
Changes since 1.24: +3 -5 lines
Diff to previous 1.24 (colored)

Eliminated a needless check.

Revision 1.24 / (download) - annotate - [select for diffs], Wed Feb 20 10:40:42 2008 UTC (16 years, 2 months ago) by rillig
Branch: MAIN
Changes since 1.23: +5 -5 lines
Diff to previous 1.23 (colored)

Changed the order of the checks for automatic keywords, so that the
latter checks are not run that much.

Revision 1.23 / (download) - annotate - [select for diffs], Tue Feb 19 22:12:00 2008 UTC (16 years, 2 months ago) by rillig
Branch: MAIN
Changes since 1.22: +15 -7 lines
Diff to previous 1.22 (colored)

Rewrote the help file parser a little bit, so that the definitions from
defaults/mk.conf can be found again. (The words didn't end with
[A-Za-z0-9], but rather with "?=".

Revision 1.22 / (download) - annotate - [select for diffs], Tue Feb 12 07:16:40 2008 UTC (16 years, 2 months ago) by rillig
Branch: MAIN
Changes since 1.21: +1 -2 lines
Diff to previous 1.21 (colored)

Removed outdated comment.

Revision 1.21 / (download) - annotate - [select for diffs], Sat Jan 5 19:48:27 2008 UTC (16 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.20: +2 -2 lines
Diff to previous 1.20 (colored)

Upper-case keywords may also end with a colon. This is used in
mk/check/check-portability.mk.

Revision 1.20 / (download) - annotate - [select for diffs], Sat Jan 5 17:55:48 2008 UTC (16 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.19: +60 -28 lines
Diff to previous 1.19 (colored)

Rewrote the help parser. You can get a list of all help topics by
running "bmake help topic=:index" now. This change is in preparation of
importing this help into the pkgsrc guide. There are still too many
false positives to be useful.

Revision 1.19 / (download) - annotate - [select for diffs], Sat Jan 5 17:01:23 2008 UTC (16 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.18: +13 -9 lines
Diff to previous 1.18 (colored)

Instead of just recording whether a topic is relevant or not, collect
all applicable keywords (like variable names, make targets or explicit
keywords). This will help printing an index of all keywords.

Revision 1.18 / (download) - annotate - [select for diffs], Thu Dec 13 11:48:38 2007 UTC (16 years, 4 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2007Q4-base, pkgsrc-2007Q4
Changes since 1.17: +4 -4 lines
Diff to previous 1.17 (colored)

Made "bmake show-help topic=show-var" (and probably some others) work
again.

Revision 1.17 / (download) - annotate - [select for diffs], Tue Nov 13 16:52:39 2007 UTC (16 years, 5 months ago) by rillig
Branch: MAIN
Changes since 1.16: +3 -3 lines
Diff to previous 1.16 (colored)

Replaced the use of gensub() with sub(), since the former is not
mentioned in The Open Group's specification of awk. Specifically,
FreeBSD's awk doesn't have it.

Revision 1.16 / (download) - annotate - [select for diffs], Tue Aug 14 18:04:16 2007 UTC (16 years, 8 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2007Q3-base, pkgsrc-2007Q3
Changes since 1.15: +8 -3 lines
Diff to previous 1.15 (colored)

Return the documentation for FOO.<param> or FOO.${param} when help for
FOO is requested.

Revision 1.15 / (download) - annotate - [select for diffs], Mon Jun 4 08:11:07 2007 UTC (16 years, 10 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2007Q2-base, pkgsrc-2007Q2
Changes since 1.14: +2 -2 lines
Diff to previous 1.14 (colored)

Keywords may be separated by commas.

Revision 1.14 / (download) - annotate - [select for diffs], Thu May 24 05:29:06 2007 UTC (16 years, 11 months ago) by rillig
Branch: MAIN
Changes since 1.13: +3 -1 lines
Diff to previous 1.13 (colored)

If more than one location for a topic is found, print an empty line
between them. Up to now, "bmake help topic=configure" looked rather
compressed.

Revision 1.13 / (download) - annotate - [select for diffs], Fri Mar 9 01:34:50 2007 UTC (17 years, 1 month ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2007Q1-base, pkgsrc-2007Q1, jlam-pkgviews-base, jlam-pkgviews
Changes since 1.12: +9 -1 lines
Diff to previous 1.12 (colored)

The mk/*/*/*.mk files are also interesting.

Don't print the make target definition in the help text.

Revision 1.12 / (download) - annotate - [select for diffs], Tue Feb 20 11:45:40 2007 UTC (17 years, 2 months ago) by rillig
Branch: MAIN
Changes since 1.11: +10 -5 lines
Diff to previous 1.11 (colored)

Make the help finder find multi-line definitions, like in
mk/configure/replace-interpreter.mk.

Revision 1.11 / (download) - annotate - [select for diffs], Sun Jan 21 10:00:34 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.10: +2 -2 lines
Diff to previous 1.10 (colored)

Some variable definitions in mk/defaults/mk.conf have only one word in
the line where the variable name appears.

Revision 1.10 / (download) - annotate - [select for diffs], Sun Jan 14 16:42:37 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.9: +3 -3 lines
Diff to previous 1.9 (colored)

The default variable assignment is printed by "make help" again.
Completely empty lines are suppressed.

Revision 1.9 / (download) - annotate - [select for diffs], Thu Jan 11 00:36:12 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.8: +2 -1 lines
Diff to previous 1.8 (colored)

Bugfix: the first and second paragraph of a topic had not had an empty
line between them.

Revision 1.8 / (download) - annotate - [select for diffs], Tue Jan 9 04:28:23 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.7: +25 -20 lines
Diff to previous 1.7 (colored)

The help topic at the very end of the last file must also be considered.

Revision 1.7 / (download) - annotate - [select for diffs], Mon Jan 8 02:27:05 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.6: +10 -3 lines
Diff to previous 1.6 (colored)

In make targets, it is seldomly useful to show the implementation to the
user.

Revision 1.6 / (download) - annotate - [select for diffs], Sun Jan 7 08:48:11 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.5: +2 -1 lines
Diff to previous 1.5 (colored)

Don't print the Keywords line.

Revision 1.5 / (download) - annotate - [select for diffs], Sat Jan 6 16:49:40 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.4: +53 -30 lines
Diff to previous 1.4 (colored)

Rewrote the AWK program and added many comments.

Revision 1.4 / (download) - annotate - [select for diffs], Tue Jan 2 22:54:54 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.3: +2 -2 lines
Diff to previous 1.3 (colored)

Also accept ordinary variable definitions as defining lines for a help
topic.

Revision 1.3 / (download) - annotate - [select for diffs], Tue Jan 2 17:22:30 2007 UTC (17 years, 3 months ago) by rillig
Branch: MAIN
Changes since 1.2: +48 -32 lines
Diff to previous 1.2 (colored)

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.

Revision 1.2 / (download) - annotate - [select for diffs], Sat Nov 4 22:05:43 2006 UTC (17 years, 5 months ago) by rillig
Branch: MAIN
CVS Tags: pkgsrc-2006Q4-base, pkgsrc-2006Q4
Changes since 1.1: +3 -2 lines
Diff to previous 1.1 (colored)

Added some more formats that are needed to recognize SMART_MESSAGES in
mk/defaults/mk.conf.

Revision 1.1 / (download) - annotate - [select for diffs], Mon Oct 23 14:40:15 2006 UTC (17 years, 6 months ago) by rillig
Branch: MAIN

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.

This form allows you to request diff's between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.




CVSweb <webmaster@jp.NetBSD.org>