src/doc/BUILDING.mdoc - diff

Return to BUILDING.mdoc CVS log

Up to [cvs.NetBSD.org] / src / doc

Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.

Diff for /src/doc/BUILDING.mdoc between version 1.89 and 1.89.2.1

version 1.89, 2012/05/25 10:47:25

version 1.89.2.1, 2012/11/20 02:57:55

Line 33

.\" Toolchain prefix for commands

.ds toolprefix nb

.Dd May 25, 2012

.Dd September 19, 2012

.Dt BUILDING 8

.Os NetBSD

Line 287 can be provided only in the environment

.Fl M

flag of

.Nm build.sh ;

it cannot usefully be set inside a Makefile, including

.Pa mk.conf

.Sy ${MAKECONF} .

Line 432 flag.

.YorN

Indicates whether preformatted plaintext manual pages will be created

during a build.

.DFLTy

.DFLTn

.It Sy MKCRYPTO

.YorN

Line 580 unconditionally.

.It Sy MKSTRIPIDENT

.YorN

Indicates whether program binaries and shared libraries should be built

Indicates whether RCS IDs, for use with

to include RCS IDs for use with

.Xr ident 1 ,

.Xr ident 1 .

should be stripped from program binaries and shared libraries.

.DFLTn

.It Sy MKUNPRIVED

Line 744 If set, then in addition to the effects

.Sy MKUPDATE=yes

above, this implies the effects of

.Sy NOCLEANDIR

(i.e.,

.Dq make cleandir

is avoided).

.DFLTn

Line 757 option.

.It Sy NBUILDJOBS

Now obsolete.

Use the

.Xr make 1

option

.Fl j ,

Line 838 builds are listed here.

.It Fl j Ar njob

Run up to

.Ar njob

.Xr make 1

subjobs in parallel.

Makefiles should use .WAIT or have explicit dependencies

as necessary to enforce build ordering.

.It Fl m Ar dir

Line 1030 After performing this operation,

it is recommended that you use

.Xr etcupdate 8

to update files in

.Sy INSTALLWORLDDIR Ns Pa /etc

.Sy INSTALLWORLDDIR Ns Pa /etc ,

and that you use

and

.Xr postinstall 8

to check for inconsistencies (and possibly to fix them).

to check for or fix inconsistencies.

.It Sy sets

Create distribution sets from

.Sy DESTDIR

Line 1192 must be populated by

.Dq make release

or equivalent.

The build must have been performed with

.Sy MKUNPRIVED=yes

because

.Dq make install-image

relies on information in

Line 1225 is attempted, RELEASEDIR must be populat

.Dq make release

or equivalent.

The build must have been performed with

.Sy MKUNPRIVED=yes

because

.Dq make install-image

relies on information in

Line 1367 This command will first run

.Dq make obj

and

.Dq make cleandir

in the

.Pa tools

subdirectory unless the

.Fl o

Line 1501 wrapper script so that the resulting nam

.It Fl C Ar cdextras

Append

.Ar cdextras

to the

.Sy CDEXTRA

variable,

Line 1549 Print a help message.

.It Fl j Ar njob

Run up to

.Ar njob

.Xr make 1

subjobs in parallel;

passed through to

.Xr make 1 .

If you see failures for reasons other than running out of memory

while using

.Sy build.sh

with

.Fl j ,

please save complete build logs

so the failures can be analyzed.

.Pp

To achieve the fastest builds,

Line 1772 Set the environment variable

.Ar var

to an optional

.Ar value .

This is propagated to the

.Sy \*[toolprefix]make

wrapper.

Line 1806 Set

.It Fl Z Ar var

Unset ("zap") the environment variable

.Ar var .

This is propagated to the

.Sy \*[toolprefix]make

wrapper.

Line 1904 portion of the release build.

.Bl -tag -width "NBUILDJOBS"

.It Sy NBUILDJOBS

Use the

.Xr make 1

option

.Fl j

CVSweb <webmaster@jp.NetBSD.org>