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

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/8a08f4783440
branches:  trunk
changeset: 371031:8a08f4783440
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Tue Oct 31 16:24:42 2017 +0000

description:
Improved index generation for "make help".

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

diffstat:

 mk/help/help.awk |   6 ++++--
 mk/help/help.mk  |  11 +++++++----
 2 files changed, 11 insertions(+), 6 deletions(-)

diffs (46 lines):

diff -r 6fb868310eb1 -r 8a08f4783440 mk/help/help.awk
--- a/mk/help/help.awk  Tue Oct 31 15:54:57 2017 +0000
+++ b/mk/help/help.awk  Tue Oct 31 16:24:42 2017 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: help.awk,v 1.27 2013/08/31 21:27:53 rillig Exp $
+# $NetBSD: help.awk,v 1.28 2017/10/31 16:24:42 rillig Exp $
 #
 
 # This program extracts the inline documentation from *.mk files.
@@ -180,8 +180,10 @@
 END {
        end_of_topic();
        if (print_index) {
+               print "Available help topics:";
+               print "";
                for (k in all_keywords) {
-                       print all_keywords[k] "\t" k;
+                       print k | "LC_ALL=C sort";
                }
        } else if (!found_anything) {
                print "No help found for "topic".";
diff -r 6fb868310eb1 -r 8a08f4783440 mk/help/help.mk
--- a/mk/help/help.mk   Tue Oct 31 15:54:57 2017 +0000
+++ b/mk/help/help.mk   Tue Oct 31 16:24:42 2017 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: help.mk,v 1.12 2016/02/01 18:47:23 leot Exp $
+# $NetBSD: help.mk,v 1.13 2017/10/31 16:24:42 rillig Exp $
 #
 
 # This is the integrated pkgsrc online help system. To query for the
@@ -31,9 +31,12 @@
        @${ECHO} "usage: "${MAKE:Q}" help topic=<topic>"
        @${ECHO} ""
        @${ECHO} "      <topic> may be a variable name or a make target,"
-       @${ECHO} "      for example CONFIGURE_DIRS or patch. For convenience,"
-       @${ECHO} "      you don't need to use uppercase letters when typing"
-       @${ECHO} "      variable names."
+       @${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} "      The special topic :index lists all available topics."
        @${ECHO} ""
 .else
        ${RUN} cd ${PKGSRCDIR};                                         \