[pkgsrc/trunk]: pkgsrc/mk mk: use a single form for headings in the documenta...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/6e1d9beded1d
branches:  trunk
changeset: 400697:6e1d9beded1d
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Mon Sep 02 02:23:02 2019 +0000

description:
mk: use a single form for headings in the documentation comments

diffstat:

 mk/bdb.buildlink3.mk         |  8 ++++----
 mk/compiler/ccache.mk        |  6 +++---
 mk/configure/cmake.mk        |  4 ++--
 mk/curses.buildlink3.mk      |  8 ++++----
 mk/features/features-vars.mk |  6 +++---
 mk/install/bin-install.mk    |  4 ++--
 mk/install/install.mk        |  6 +++---
 mk/libusb.buildlink3.mk      |  4 ++--
 mk/license.mk                |  6 +++---
 mk/mpi.buildlink3.mk         |  4 ++--
 mk/mysql.buildlink3.mk       |  6 +++---
 mk/readline.buildlink3.mk    |  6 +++---
 mk/termcap.buildlink3.mk     |  4 ++--
 mk/terminfo.buildlink3.mk    |  6 +++---
 mk/unprivileged.mk           |  6 +++---
 15 files changed, 42 insertions(+), 42 deletions(-)

diffs (truncated from 367 to 300 lines):

diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/bdb.buildlink3.mk
--- a/mk/bdb.buildlink3.mk      Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/bdb.buildlink3.mk      Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: bdb.buildlink3.mk,v 1.26 2016/04/11 04:22:34 dbj Exp $
+# $NetBSD: bdb.buildlink3.mk,v 1.27 2019/09/02 02:23:02 rillig Exp $
 #
 # This Makefile fragment is meant to be included by packages that
 # require a Berkeley DB (BDB) implementation and that are not restricted
@@ -8,7 +8,7 @@
 # FIXME: This Makefile cannot handle packages that can use only a
 # subset of { db2 db3 db4 }.
 #
-# === User-settable variables ===
+# User-settable variables:
 #
 # BDB_DEFAULT
 #      This value represents the package we use when either a db-1.85
@@ -26,7 +26,7 @@
 #      It defaults to "db1" if it's built-in, or to ${BDB_DEFAULT}
 #      otherwise.
 #
-# === Package-settable variables ===
+# Package-settable variables:
 #
 # BDB_ACCEPTED
 #      The list of Berkeley DB implementations that can be used by the
@@ -35,7 +35,7 @@
 #      FIXME: If the list does not include db1 and does not include
 #      BDB_DEFAULT, the package will not build at the moment.
 #
-# === Variables set by this file ===
+# System-defined variables:
 #
 # BDB_TYPE
 #      The name of the selected BDB implementation.
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/compiler/ccache.mk
--- a/mk/compiler/ccache.mk     Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/compiler/ccache.mk     Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: ccache.mk,v 1.38 2018/08/22 20:48:37 maya Exp $
+# $NetBSD: ccache.mk,v 1.39 2019/09/02 02:23:02 rillig Exp $
 #
 # Copyright (c) 2004 The NetBSD Foundation, Inc.
 # All rights reserved.
@@ -28,7 +28,7 @@
 # POSSIBILITY OF SUCH DAMAGE.
 #
 
-# === User-settable variables ===
+# User-settable variables:
 #
 # CCACHE_BASE
 #      The directory where ccache is installed. The build dependency on
@@ -46,7 +46,7 @@
 #       doing to the specified file. This is useful for tracking down
 #       problems.
 #
-# === Package-settable variables ===
+# Package-settable variables:
 #
 # IGNORE_CCACHE
 #      Can be set to "yes" for packages that have problems with ccache.
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/configure/cmake.mk
--- a/mk/configure/cmake.mk     Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/configure/cmake.mk     Mon Sep 02 02:23:02 2019 +0000
@@ -1,9 +1,9 @@
-# $NetBSD: cmake.mk,v 1.16 2018/04/08 19:11:27 chuck Exp $
+# $NetBSD: cmake.mk,v 1.17 2019/09/02 02:23:03 rillig Exp $
 #
 # This file handles packages that use CMake as their primary build
 # system. For more information about CMake, see http://www.cmake.org/.
 #
-# === Package-settable variables ===
+# Package-settable variables:
 #
 # CMAKE_DEPENDENCIES_REWRITE
 #      A list of files (XXX: variable name) relative to WRKSRC in
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/curses.buildlink3.mk
--- a/mk/curses.buildlink3.mk   Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/curses.buildlink3.mk   Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: curses.buildlink3.mk,v 1.29 2018/12/16 23:21:52 rillig Exp $
+# $NetBSD: curses.buildlink3.mk,v 1.30 2019/09/02 02:23:02 rillig Exp $
 #
 # This Makefile fragment is meant to be included by packages that require
 # any curses implementation instead of one particular one.  The available
@@ -9,7 +9,7 @@
 # directly include the appropriate buildlink3.mk instead of this file in
 # the package Makefile.
 #
-# === User-settable variables ===
+# User-settable variables:
 #
 # CURSES_DEFAULT
 #      This value represents the type of curses we wish to use on the
@@ -19,7 +19,7 @@
 #      Possible: curses, ncurses, ncursesw, pdcurses
 #      Default: (depends)
 #
-# === Package-settable variables ===
+# Package-settable variables:
 #
 # USE_CURSES
 #      This value represents the features the package needs from curses.
@@ -47,7 +47,7 @@
 #
 #      Default: (unset)
 #
-# === Variables set by this file ===
+# System-defined variables:
 #
 # CURSES_TYPE
 #      The name of the selected curses implementation.
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/features/features-vars.mk
--- a/mk/features/features-vars.mk      Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/features/features-vars.mk      Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: features-vars.mk,v 1.26 2019/07/10 17:15:27 sevan Exp $
+# $NetBSD: features-vars.mk,v 1.27 2019/09/02 02:23:03 rillig Exp $
 #
 # The platforms that are supported by pkgsrc differ in the amount of
 # functions they provide in the C library (libc). Functions that are
@@ -29,7 +29,7 @@
 #      #include <err.h>
 #      #endif
 #
-# === Package-settable variables ===
+# Package-settable variables:
 #
 # USE_FEATURES
 #      Lists the system features required by the package.
@@ -52,7 +52,7 @@
 #
 #      Default value: undefined
 #
-# === Variables defined by this file ===
+# System-defined variables:
 #
 # MISSING_FEATURES
 #      The features listed in USE_FEATURES that are missing on the
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/install/bin-install.mk
--- a/mk/install/bin-install.mk Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/install/bin-install.mk Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: bin-install.mk,v 1.28 2018/11/15 01:40:52 sevan Exp $
+# $NetBSD: bin-install.mk,v 1.29 2019/09/02 02:23:03 rillig Exp $
 #
 
 # This file provides the following targets:
@@ -7,7 +7,7 @@
 #      Tries to install a package from a prebuilt binary package, and
 #      if that doesn't work, builds the package from source.
 #
-# === User-settable variables ===
+# User-settable variables:
 #
 # PACKAGES
 #      This directory is searched before BINPKG_SITES when trying to
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/install/install.mk
--- a/mk/install/install.mk     Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/install/install.mk     Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: install.mk,v 1.76 2019/05/07 19:36:44 rillig Exp $
+# $NetBSD: install.mk,v 1.77 2019/09/02 02:23:03 rillig Exp $
 #
 # This file provides the code for the "install" phase.
 #
@@ -21,7 +21,7 @@
 #      in order to install the package.
 #
 
-# === User-settable variables ===
+# User-settable variables:
 #
 # INSTALL_UNSTRIPPED
 #      If "yes", all binaries and shared libraries are installed
@@ -34,7 +34,7 @@
 #
 # Keywords: strip unstripped
 #
-# === Package-settable variables ===
+# Package-settable variables:
 #
 # INSTALLATION_DIRS
 #      A list of directories that should be created at the very
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/libusb.buildlink3.mk
--- a/mk/libusb.buildlink3.mk   Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/libusb.buildlink3.mk   Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: libusb.buildlink3.mk,v 1.1 2018/02/10 13:45:45 khorben Exp $
+# $NetBSD: libusb.buildlink3.mk,v 1.2 2019/09/02 02:23:02 rillig Exp $
 #
 # This Makefile is meant to be included by packages that require an
 # implementation of the former libusb (still found in devel/libusb). The
@@ -9,7 +9,7 @@
 # LIBUSB_TYPE to "compat". On NetBSD, it has the advantage of not requiring root
 # privileges to locate and use USB devices without a kernel driver.
 #
-# === User-settable variables ===
+# User-settable variables:
 #
 # LIBUSB_TYPE
 #      The name of the libusb implementation to default to, native or compat.
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/license.mk
--- a/mk/license.mk     Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/license.mk     Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: license.mk,v 1.101 2019/08/14 18:12:00 brook Exp $
+# $NetBSD: license.mk,v 1.102 2019/09/02 02:23:02 rillig Exp $
 #
 # This file handles everything about the LICENSE variable. It is
 # included automatically by bsd.pkg.mk.
@@ -10,7 +10,7 @@
 # XXX: Some of this content arguably belongs in the pkgsrc guide
 # instead.
 #
-# === User-settable variables ===
+# User-settable variables:
 #
 # ACCEPTABLE_LICENSES
 #
@@ -25,7 +25,7 @@
 #
 #      Default value: ${DEFAULT_ACCEPTABLE_LICENSES}
 #
-# === Package-settable variables ===
+# Package-settable variables:
 #
 # LICENSE
 #
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/mpi.buildlink3.mk
--- a/mk/mpi.buildlink3.mk      Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/mpi.buildlink3.mk      Mon Sep 02 02:23:02 2019 +0000
@@ -1,10 +1,10 @@
-# $NetBSD: mpi.buildlink3.mk,v 1.4 2019/04/20 16:32:42 rillig Exp $
+# $NetBSD: mpi.buildlink3.mk,v 1.5 2019/09/02 02:23:02 rillig Exp $
 #
 # This Makefile fragment is meant to be included by packages
 # that use any MPI implementation instead of one particular one.
 # The available MPI implementations are "mpich" and "openmpi".
 #
-# === User-settable variables ===
+# User-settable variables:
 #
 # MPI_TYPE
 #      This value represents the type of MPI we wish to use on the system.
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/mysql.buildlink3.mk
--- a/mk/mysql.buildlink3.mk    Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/mysql.buildlink3.mk    Mon Sep 02 02:23:02 2019 +0000
@@ -1,9 +1,9 @@
-# $NetBSD: mysql.buildlink3.mk,v 1.23 2019/09/02 02:14:58 rillig Exp $
+# $NetBSD: mysql.buildlink3.mk,v 1.24 2019/09/02 02:23:02 rillig Exp $
 #
 # This file is included by packages that require some version of the
 # MySQL database client.
 #
-# === User-settable variables ===
+# User-settable variables:
 #
 # MYSQL_VERSION_DEFAULT
 #      The preferred MySQL version.
@@ -11,7 +11,7 @@
 #      Possible: 57 56 55 51 MARIADB55
 #      Default: 57
 #
-# === Package-settable variables ===
+# Package-settable variables:
 #
 # MYSQL_VERSIONS_ACCEPTED
 #      The list of MySQL versions that the package accepts.
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/readline.buildlink3.mk
--- a/mk/readline.buildlink3.mk Mon Sep 02 02:14:58 2019 +0000
+++ b/mk/readline.buildlink3.mk Mon Sep 02 02:23:02 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: readline.buildlink3.mk,v 1.5 2016/04/11 04:22:34 dbj Exp $
+# $NetBSD: readline.buildlink3.mk,v 1.6 2019/09/02 02:23:02 rillig Exp $
 #
 # This Makefile fragment is meant to be included by packages that require
 # any readline implementation instead of one particular one.  The available
@@ -8,7 +8,7 @@
 # directly include the appropriate buildlink3.mk instead of this file in
 # the package Makefile.
 #
-# === User-settable variables ===
+# User-settable variables:
 #
 # READLINE_DEFAULT
 #      This value represents the type of readline we wish to use on the
@@ -18,7 +18,7 @@
 #      Possible: editline readline
 #      Default: (depends)
 #
-# === Variables set by this file ===
+# System-defined variables:
 #
 # READLINE_TYPE
 #      The name of the selected readline implementation, editline or
diff -r 9a9fadc3ca37 -r 6e1d9beded1d mk/termcap.buildlink3.mk
--- a/mk/termcap.buildlink3.mk  Mon Sep 02 02:14:58 2019 +0000