Commit graph

27 commits

Author SHA1 Message Date
rillig
054f4eb585 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".
2013-08-31 21:27:53 +00:00
rillig
87255936f0 Re-enabled the detection of variables as they appear in
mk/defaults/mk.conf. I don't know when I removed it accidentally.
2009-05-15 21:10:31 +00:00
rillig
d63608279e Eliminated a needless check. 2008-02-20 10:42:21 +00:00
rillig
739578d240 Changed the order of the checks for automatic keywords, so that the
latter checks are not run that much.
2008-02-20 10:40:42 +00:00
rillig
56564adfe7 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 "?=".
2008-02-19 22:12:00 +00:00
rillig
8a2e6d3e9e Removed outdated comment. 2008-02-12 07:16:40 +00:00
rillig
cf4165832c Upper-case keywords may also end with a colon. This is used in
mk/check/check-portability.mk.
2008-01-05 19:48:27 +00:00
rillig
f07e60916d 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.
2008-01-05 17:55:48 +00:00
rillig
4d3b9ab24d 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.
2008-01-05 17:01:23 +00:00
rillig
b79b4beba7 Made "bmake show-help topic=show-var" (and probably some others) work
again.
2007-12-13 11:48:38 +00:00
rillig
bc38d93c53 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.
2007-11-13 16:52:39 +00:00
rillig
6f1d6ed164 Return the documentation for FOO.<param> or FOO.${param} when help for
FOO is requested.
2007-08-14 18:04:16 +00:00
rillig
a3a72d22f3 Keywords may be separated by commas. 2007-06-04 08:11:07 +00:00
rillig
1cf36740dd 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.
2007-05-24 05:29:06 +00:00
rillig
aa979492e3 The mk/*/*/*.mk files are also interesting.
Don't print the make target definition in the help text.
2007-03-09 01:34:50 +00:00
rillig
fdd9280481 Make the help finder find multi-line definitions, like in
mk/configure/replace-interpreter.mk.
2007-02-20 11:45:40 +00:00
rillig
7c42eb00de Some variable definitions in mk/defaults/mk.conf have only one word in
the line where the variable name appears.
2007-01-21 10:00:34 +00:00
rillig
82ff4507d8 The default variable assignment is printed by "make help" again.
Completely empty lines are suppressed.
2007-01-14 16:42:37 +00:00
rillig
741c0c4065 Bugfix: the first and second paragraph of a topic had not had an empty
line between them.
2007-01-11 00:36:12 +00:00
rillig
871cdd10b7 The help topic at the very end of the last file must also be considered. 2007-01-09 04:28:23 +00:00
rillig
53cdd9a462 In make targets, it is seldomly useful to show the implementation to the
user.
2007-01-08 02:27:05 +00:00
rillig
4e742ffca4 Don't print the Keywords line. 2007-01-07 08:48:11 +00:00
rillig
2748a7a44f Rewrote the AWK program and added many comments. 2007-01-06 16:49:40 +00:00
rillig
7f93ba8430 Also accept ordinary variable definitions as defining lines for a help
topic.
2007-01-02 22:54:54 +00:00
rillig
b96150340c 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.
2007-01-02 17:22:30 +00:00
rillig
6f19265695 Added some more formats that are needed to recognize SMART_MESSAGES in
mk/defaults/mk.conf.
2006-11-04 22:05:43 +00:00
rillig
c14791a52e 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.
2006-10-23 14:40:14 +00:00