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.)
- - - -
This commit is contained in:
apb 2014-11-13 08:25:31 +00:00
parent 62a9ce094f
commit d1f4f392c7

View File

@ -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 @@ If any of these directories are missing, they will be skipped during the build.
.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 @@ unless run in
.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 @@ Indicates whether system documentation destined for
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 @@ absolute path before being used.
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 .