[src/trunk]: src regen from doc/BUILDING.mdoc revision 1.107.

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

details:   https://anonhg.NetBSD.org/src/rev/a0abd2f289e2
branches:  trunk
changeset: 333671:a0abd2f289e2
user:      apb <apb%NetBSD.org@localhost>
date:      Thu Nov 13 08:42:35 2014 +0000

description:
regen from doc/BUILDING.mdoc revision 1.107.
This reinstates documentation for "extsrc" which was lost in 2009.

diffstat:

 BUILDING |  22 ++++++++++++++++++++++
 1 files changed, 22 insertions(+), 0 deletions(-)

diffs (53 lines):

diff -r 362582cdef75 -r a0abd2f289e2 BUILDING
--- a/BUILDING  Thu Nov 13 08:25:31 2014 +0000
+++ b/BUILDING  Thu Nov 13 08:42:35 2014 +0000
@@ -80,6 +80,9 @@
      x11/           ``Reachover'' build structure for X11R6; the source is in
                     X11SRCDIR.
 
+     extsrc/        ``Reachover'' build structure for externally added
+                    programs and libraries; the source is in EXTSRCSRCDIR.
+
    Build tree layout
      The NetBSD build tree is described in hier(7), and the release layout is
      described in release(7).
@@ -197,6 +200,13 @@
                  Note: build.sh will provide a default of destdir.MACHINE (in
                  the top-level .OBJDIR) unless run in `expert' mode.
 
+     EXTSRCSRCDIR
+                 Directory containing sources of externally added programs and
+                 libraries.  If specified, must be an absolute path.
+
+                 Default: NETBSDRCDIR/../extsrc, if that exists; otherwise
+                 /usr/extsrc.
+
      MAKECONF    The name of the make(1) configuration file.  Only settable in
                  the process environment.
 
@@ -264,6 +274,11 @@
 
                  Default: ``yes''
 
+     MKEXTSRC    Can be set to ``yes'' or ``no''.  Indicates whether extsrc is
+                 built from EXTSRCSRCDIR.
+
+                 Default: ``no''
+
      MKHTML      Can be set to ``yes'' or ``no''.  Indicates whether
                  preformatted HTML manual pages will be built and installed
 
@@ -1022,6 +1037,13 @@
 
      -x        Set MKX11=yes.
 
+     -Y extsrcdir
+               Set the value of EXTSRCSRCDIR to extsrcdir.  If a relative path
+               is specified, it will be converted to an absolute path before
+               being used.
+
+     -y        Set MKEXTSRC=yes.
+
      -Z var    Unset ("zap") the environment variable var.  This is propagated
                to the nbmake wrapper.