[pkgsrc/trunk]: pkgsrc/mk/defaults Improved the wording of some of the comments.

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/679bac9cdb39
branches:  trunk
changeset: 521685:679bac9cdb39
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sat Nov 18 08:13:26 2006 +0000

description:
Improved the wording of some of the comments.

diffstat:

 mk/defaults/mk.conf |  30 +++++++++++++++++++++---------
 1 files changed, 21 insertions(+), 9 deletions(-)

diffs (66 lines):

diff -r 875938099a01 -r 679bac9cdb39 mk/defaults/mk.conf
--- a/mk/defaults/mk.conf       Sat Nov 18 07:48:06 2006 +0000
+++ b/mk/defaults/mk.conf       Sat Nov 18 08:13:26 2006 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mk.conf,v 1.135 2006/11/08 17:33:26 ghen Exp $
+# $NetBSD: mk.conf,v 1.136 2006/11/18 08:13:26 rillig Exp $
 #
 
 # This file provides default values for variables that may be overridden
@@ -97,8 +97,11 @@
 # Default: determined during bootstrapping
 
 #PKG_DEVELOPER=        yes
-# Run a sanity check that package developers want:
-#  * run check-shlibs to see that all binaries will find their libs
+#
+# Enables some sanity checks to raise the quality of the installed
+# packages. See the files pkgsrc/mk/check/check-*.mk for details and
+# further configuration options.
+#
 # Possible: defined, not defined
 # Default: not defined
 
@@ -108,7 +111,7 @@
 # If set to "no", a warning will be printed if recommendations
 # are possibly ignored.
 #
-# WARNING: This should only be set if you know what you're doing.
+# WARNING: This should only be changed if you know what you're doing.
 # Please read pkgsrc/doc/pkgsrc.txt for details.
 #
 # Possible: yes, no
@@ -146,7 +149,15 @@
 # Default: "no" if PKG_DEVELOPER is defined, "yes" otherwise
 
 PKGSRC_RUN_TEST?=      no
-# Run test target before install
+#
+# Many packages bring their own self tests to ensure they basically
+# work. To run these tests after building a package, set this variable
+# to "yes".
+#
+# Note: Some packages make heavy use of the random number generator in
+# their tests, so need to make sure that there are always enough random
+# numbers on your machine. The package security/bitstir may help here.
+#
 # Possible: yes, no
 # Default: no
 
@@ -346,11 +357,12 @@
 #
 # Default: none
 
-#SPECIFIC_PKGS=
-# Don't use the default of all packages (from the top-level of the
-# pkgsrc tree), and use the values of the definitions
-# SITE_SPECIFIC_PKGS, HOST_SPECIFIC_PKGS, GROUP_SPECIFIC_PKGS, and
+#SPECIFIC_PKGS= yes
+#
+# When doing a bulk build, don't build all packages, only those listed
+# in SITE_SPECIFIC_PKGS, HOST_SPECIFIC_PKGS, GROUP_SPECIFIC_PKGS, and
 # USER_SPECIFIC_PKGS.
+#
 # Possible: defined, not defined
 # Default: not defined