[src/trunk]: src Regen from doc/BUILDING.mdoc;1.100:

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

details:   https://anonhg.NetBSD.org/src/rev/777c61a88b11
branches:  trunk
changeset: 796696:777c61a88b11
user:      apb <apb%NetBSD.org@localhost>
date:      Sat Jun 14 12:21:41 2014 +0000

description:
Regen from doc/BUILDING.mdoc;1.100:
Improve documentation for BUILDID.

diffstat:

 BUILDING |  14 ++++++++++----
 1 files changed, 10 insertions(+), 4 deletions(-)

diffs (29 lines):

diff -r 2c5c5411d02e -r 777c61a88b11 BUILDING
--- a/BUILDING  Sat Jun 14 12:20:17 2014 +0000
+++ b/BUILDING  Sat Jun 14 12:21:41 2014 +0000
@@ -151,10 +151,16 @@
      otherwise specified, these variables may be set in either the process
      environment or the make(1) configuration file specified by MAKECONF.
 
-     BUILDID     Identifier for the build.  The identifier will be appended to
-                 object directory names, and can be consulted in the make(1)
+     BUILDID     Identifier for the build.  If set, this should be a short
+                 string that is suitable for use as part of a file or
+                 directory name.  The identifier will be appended to object
+                 directory names, and can be consulted in the make(1)
                  configuration file in order to set additional build
-                 parameters, such as compiler flags.
+                 parameters, such as compiler flags.  It will also be used as
+                 part of the kernel version string, which can be printed by
+                 ``uname -v''.
+
+                 Default: Unset.
 
      BUILDSEED   GCC uses random numbers when compiling C++ code.  This
                  variable seeds the gcc random number generator using the
@@ -1047,4 +1053,4 @@
      The build.sh based build scheme was introduced for NetBSD 1.6 as
      USE_NEW_TOOLCHAIN, and re-worked to TOOLCHAIN_MISSING after that.
 
-NetBSD                         November 8, 2012                         NetBSD
+NetBSD                           June 14, 2014                          NetBSD