[src/trunk]: src/distrib/sets Document sets programmatically instead of keepi...

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/525e833e42d3
branches:  trunk
changeset: 821526:525e833e42d3
user:      christos <christos%NetBSD.org@localhost>
date:      Wed Feb 08 18:21:23 2017 +0000

description:
Document sets programmatically instead of keeping a list that constantly is
out of date.

diffstat:

 distrib/sets/sets.subr |  103 +++++++++++++-----------------------------------
 1 files changed, 28 insertions(+), 75 deletions(-)

diffs (135 lines):

diff -r 490e2a50d091 -r 525e833e42d3 distrib/sets/sets.subr
--- a/distrib/sets/sets.subr    Wed Feb 08 18:05:25 2017 +0000
+++ b/distrib/sets/sets.subr    Wed Feb 08 18:21:23 2017 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: sets.subr,v 1.178 2016/08/19 10:23:26 mrg Exp $
+#      $NetBSD: sets.subr,v 1.179 2017/02/08 18:21:23 christos Exp $
 #
 
 #
@@ -179,7 +179,7 @@
 # In each file, a record consists of a path and a System Package name,
 # separated by whitespace. E.g.,
 #
-#      # $NetBSD: sets.subr,v 1.178 2016/08/19 10:23:26 mrg Exp $
+#      # $NetBSD: sets.subr,v 1.179 2017/02/08 18:21:23 christos Exp $
 #      .                       base-sys-root   [keyword[,...]]
 #      ./altroot               base-sys-root
 #      ./bin                   base-sys-root
@@ -194,90 +194,43 @@
 #
 # The third field is an optional comma separated list of keywords to
 # control if a record is printed; every keyword listed must be enabled
-# for the record to be printed.  The following keywords are available:
-#      dummy                   dummy entry (ignored)
-#      obsolete                file is obsolete, and only printed if 
-#                              ${obsolete} != 0
+# for the record to be printed. The list of all avalaible make variables
+# that can be turned on or off can be found by running in this directory:
+#
+#      make -f mkvars.mk mkvarsyesno
 #
-#      atf                     ${MKATF} != no
-#      bfd                     obsolete, use binutils.
-#      binutils                ${MKBINUTILS} != no
-#      bsdgrep                 ${MKBSDGREP} != no
-#      catpages                ${MKCATPAGES} != no
-#      compat                  ${MKCOMPAT} != no
-#      compatmodules           ${MKCOMPATMODULES} != no
-#      compattests             ${MKCOMPATTESTS} != no
-#      crypto                  ${MKCRYPTO} != no
-#      crypto_rc5              ${MKCRYPTO_RC5} != no
-#      ctf                     ${MKCTF} != no
-#      cvs                     ${MKCVS} != no
-#      debug                   ${MKDEBUG} != no
-#      debuglib                ${MKDEBUGLIB} != no
-#      doc                     ${MKDOC} != no
-#      dtrace                  ${MKDTRACE} != no
-#      dynamicroot             ${MKDYNAMICROOT} != no
-#      extsrc                  ${MKEXTSRC} != no
-#      gcc                     ${MKGCC} != no
-#      gcccmds                 ${MKGCCCMDS} != no
-#      gdb                     ${MKGDB} != no
-#      hesiod                  ${MKHESIOD} != no
-#      html                    ${MKHTML} != no
-#      inet6                   ${MKINET6} != no
-#      info                    ${MKINFO} != no
-#      ipfilter                ${MKIPFILTER} != no
-#      iscsi                   ${MKISCSI} != no
-#      kerberos                ${MKKERBEROS} != no
-#      kmod                    ${MKKMOD} != no
-#      kyua                    ${MKKYUA} != no
-#      ldap                    ${MKLDAP} != no
-#      lint                    ${MKLINT} != no
-#      libcxx                  ${MKLIBCXX} != no
+# These MK<NAME> variables can be used as selectors in the sets as <name>.
+# 
+# The following extra keywords are also available, listed by:
+#
+#      make -f mkvars.mk mkextravars
+#
+# These are:
+#    1. The HAVE_<name>:
+#      ssp                     ${HAVE_SSP} != no
 #      libgcc_eh               ${HAVE_LIBGCC_EH} != no
-#      libstdcxx               ${MKLIBSTDCXX} != no
-#      lld                     ${MKLLD} != no
-#      lldb                    ${MKLLDB} != no
-#      llvm                    ${MKLLVM} != no
-#      lvm                     ${MKLVM} != no
-#      makemandb               ${MKMAKEMANDB} != no
-#      man                     ${MKMAN} != no
-#      manpages                ${MKMANPAGES} != no
-#      manz                    ${MKMANZ} != no
-#      mclinker                ${MKMCLINKER} != no
-#      mdns                    ${MKMDNS} != no
-#      nls                     ${MKNLS} != no
-#      nvi                     ${MKNVI} != no
-#      pam                     ${MKPAM} != no
-#      pcc                     ${MKPCC} != no
-#      pf                      ${MKPF} != no
-#      pic                     ${MKPIC} != no
-#      picinstall              ${MKPICINSTALL} != no
-#      pigzgzip                ${MKPIGZGZIP} != no
-#      postfix                 ${MKPOSTFIX} != no
-#      profile                 ${MKPROFILE} != no
-#      perfuse                 ${MKPERFUSE} != no
-#      rump                    ${MKRUMP} != no
-#      share                   ${MKSHARE} != no
-#      skey                    ${MKSKEY} != no
-#      sljit                   ${MKSLJIT} != no
-#      softfloat               ${MKSOFTFLOAT} != no
-#      solaris                 ${MKDTRACE} != no or ${MKZFS} != no or ${MKCTF} != no
-#      ssp                     ${HAVE_SSP} != no
-#      tpm                     ${MKTPM} != no
-#      xorg                    ${MKX11} != no
-#      xorg_server             ${MKXORG_SERVER} != no
-#      yp                      ${MKYP} != no
-#      zfs                     ${MKZFS} != no
-#
-#      endian=<n>              <n> = value of ${TARGET_ENDIANNESS}
 #      binutils=<n>            <n> = value of ${HAVE_BINUTILS}
 #      gcc=<n>                 <n> = value of ${HAVE_GCC}
 #      gdb=<n>                 <n> = value of ${HAVE_GDB}
 #      xorg_server_ver=<n>     <n> = value of ${HAVE_XORG_SERVER_VER}
 #
+#    2. The USE_<name>:
 #      use_inet6               ${USE_INET6} != no
 #      use_kerberos            ${USE_KERBEROS} != no
+#      use_ldap                ${USE_LDAP} != no
 #      use_yp                  ${USE_YP} != no
 #
+#    3. Finally:
+#      dummy                   dummy entry (ignored)
+#      obsolete                file is obsolete, and only printed if 
+#                              ${obsolete} != 0
+#
+#      solaris                 ${MKDTRACE} != no or ${MKZFS} != no or ${MKCTF} != no
+#
+#
+#      endian=<n>              <n> = value of ${TARGET_ENDIANNESS}
+#
+#
 #      .cat                    if ${MKMANZ} != "no" && ${MKCATPAGES} != "no"
 #                                automatically append ".gz" to the filename
 #