[src/trunk]: src/doc Document "extsrc". This was added to src/BUILDING in re...

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

details:   https://anonhg.NetBSD.org/src/rev/362582cdef75
branches:  trunk
changeset: 333670:362582cdef75
user:      apb <apb%NetBSD.org@localhost>
date:      Thu Nov 13 08:25:31 2014 +0000

description:
Document "extsrc".  This was added to src/BUILDING in revision 1.90
dated 2009-11-30, but was not added to src/doc/BUILDING.mdoc,
so the changes were lost.

The original log message was:
- - - -
revision 1.90
date: 2009-11-30 16:13:22 +0000;  author: uebayasi;  state: Exp;  lines: +22 -0;
Support "extsrc", externally added programs and libraries.  Users can write
their own reach-overs, cross-build, install, and get set files just like base
and X11 / X.org.  (These sets are not included as TNF releases.)
- - - -

diffstat:

 doc/BUILDING.mdoc |  34 +++++++++++++++++++++++++++++++++-
 1 files changed, 33 insertions(+), 1 deletions(-)

diffs (69 lines):

diff -r 6a2520d49afb -r 362582cdef75 doc/BUILDING.mdoc
--- a/doc/BUILDING.mdoc Thu Nov 13 08:16:42 2014 +0000
+++ b/doc/BUILDING.mdoc Thu Nov 13 08:25:31 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: BUILDING.mdoc,v 1.106 2014/11/06 06:41:23 uebayasi Exp $
+.\"    $NetBSD: BUILDING.mdoc,v 1.107 2014/11/13 08:25:31 apb Exp $
 .\"
 .\" Copyright (c) 2001-2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -155,6 +155,11 @@
 .Dq Reachover
 build structure for X11R6; the source is in
 .Sy X11SRCDIR .
+.It Pa extsrc/
+.Dq Reachover
+build structure for externally added programs and libraries;
+the source is in
+.Sy EXTSRCSRCDIR .
 .El
 .
 .Ss Build tree layout
@@ -416,6 +421,15 @@
 .Sq expert
 mode.
 .
+.It Sy EXTSRCSRCDIR
+Directory containing sources of externally added programs
+and libraries.
+If specified, must be an absolute path.
+.DFLT
+.Sy NETBSDRCDIR Ns Pa /../extsrc ,
+if that exists; otherwise
+.Pa /usr/extsrc .
+.
 .It Sy MAKECONF
 The name of the
 .Xr make 1
@@ -507,6 +521,12 @@
 will be installed during a build.
 .DFLTy
 .
+.It Sy MKEXTSRC
+.YorN
+Indicates whether extsrc is built from
+.Sy EXTSRCSRCDIR .
+.DFLTn
+.
 .It Sy MKHTML
 .YorN
 Indicates whether preformatted HTML manual pages will be built
@@ -1943,6 +1963,18 @@
 Set
 .Sy MKX11=yes .
 .
+.It Fl Y Ar extsrcdir
+Set the value of
+.Sy EXTSRCSRCDIR
+to
+.Ar extsrcdir .
+If a relative path is specified, it will be converted to an
+absolute path before being used.
+.
+.It Fl y
+Set
+.Sy MKEXTSRC=yes .
+.
 .It Fl Z Ar var
 Unset ("zap") the environment variable
 .Ar var .