[src/trunk]: src/share/mk document MKxxx/NOxxx naming rule.

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

details:   https://anonhg.NetBSD.org/src/rev/346e38b6a124
branches:  trunk
changeset: 525877:346e38b6a124
user:      itojun <itojun%NetBSD.org@localhost>
date:      Fri Apr 19 03:08:05 2002 +0000

description:
document MKxxx/NOxxx naming rule.

diffstat:

 share/mk/bsd.README |  12 +++++++++++-
 1 files changed, 11 insertions(+), 1 deletions(-)

diffs (26 lines):

diff -r 8fd70c2bbdc9 -r 346e38b6a124 share/mk/bsd.README
--- a/share/mk/bsd.README       Fri Apr 19 02:20:21 2002 +0000
+++ b/share/mk/bsd.README       Fri Apr 19 03:08:05 2002 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: bsd.README,v 1.96 2002/04/16 03:47:32 itojun Exp $
+#      $NetBSD: bsd.README,v 1.97 2002/04/19 03:08:05 itojun Exp $
 #      @(#)bsd.README  8.2 (Berkeley) 4/2/94
 
 This is the README file for the new make "include" files for the BSD
@@ -58,6 +58,16 @@
 the regular libraries.  A new suffix, ".po", is used to denote a profiled
 object, and ".so" denotes a shared (position-independent) object.
 
+There are various make variables used during the build.  Basic rule for
+the variable naming scheme is as follows:
+
+MKxxx          Can be set to `no' by a user to disable functionality.
+               Defaults to `yes' (or usually does)
+
+NOxxx          If defined, disables a feature.  Not intended for users,
+               it's to allow Makefiles to disable functionality that
+               they don't support (such as missing man pages).
+
 The following variables that control how things are made/installed that
 are not set by default. These should not be set by Makefiles; they're for
 the user to define in MAKECONF (see bsd.own.mk, below) or on the make(1)