1.\" Copyright (c) 2002 Murray Stokely <murray@FreeBSD.org>
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
--- 8 unchanged lines hidden (view full) ---
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD: head/share/man/man7/release.7 262810 2014-03-05 23:17:53Z gjb $
26.\"
27.Dd March 5, 2014
28.Dt RELEASE 7
29.Os
30.Sh NAME
31.Nm release
32.Nd "release building infrastructure"
33.Sh DESCRIPTION
34.Fx
35provides a complete build environment suitable for users to make
--- 97 unchanged lines hidden (view full) ---
133.Pa $CHROOTDIR/R .
134.Pp
135The optional
136.Fa release.conf
137configuration file supports the following variables:
138.Bl -tag -width Ev
139.It Va CHROOTDIR
140The directory within which the release will be built.
141.It Va CHROOT_MAKEENV
142Additional
143.Xr make 1
144arguments to pass through, which directly affect the
145tuning of the build chroot.
146.It Va SVNROOT
147The
148.Xr svn 1
149host used to check out the various trees.
150Defaults to
151.Pa svn://svn.FreeeBSD.org .
152.It Va SRCBRANCH
153The
--- 95 unchanged lines hidden (view full) ---
249.It Va WITH_DVD
250Set to a non-empty value to include the
251.Cm dvdrom
252target.
253.It Va VCSCMD
254The command run to obtain the source trees.
255Defaults to
256.Qq Cm svn checkout .
257.It Va CHROOTBUILD_SKIP
258If defined, the
259.Li buildworld ,
260.Li installworld ,
261and
262.Li distribution
263stages of the
264.Xr chroot 8
265build environment setup are skipped.
266This is intended solely for cases where the
267.Xr chroot 8
268userland are provided by alternate means.
269.El
270.Sh EMBEDDED BUILDS
271The following
272.Fa release.conf
273variables are relevant only to release builds for embedded systems:
274.Bl -tag -width Ev
275.It Va EMBEDDEDBUILD
276Set to a non-null value to enable functionality for embedded device
277release builds.
278.Pq This option is considered highly experimental.
279.Pp
280When set,
281.Va WITH_DVD
282is unset, and
283.Va NODOC
284is defined.
285Additionally,
286.Va XDEV
287and
288.Va XDEV_ARCH
289must also be defined.
290When the build environment is created,
291.Fa release.sh
292runs a separate build script located in an architecture-specific
293directory in
294.Pa src/release/${XDEV}/ .
295.It Va EMBEDDEDPORTS
296Set to the list of any ports that are required for the target device
297in the format of
298.Fa category/port .
299The
300.Fa devel/subversion
301port is built by default.
302.It Va CROCHETSRC
303Set to the source URL for the Crochet build tool.
304.It Va CROCHETBRANCH
305Set to the subversion branch from
306.Va ${CROCHETSRC}
307to use.
308Defaults to
309.Pa trunk .
310.It Va UBOOTSRC
311Set to the source URL of u-boot, if required.
312.It Va UBOOTBRANCH
313Set to the subversion branch from
314.Va ${UBOOTSRC}
315to use.
316Defaults to
317.Pa trunk .
318.It Va UBOOTDIR
319Set to the target directory within
320.Va ${CHROOTDIR}
321to check out
322.Va ${UBOOTSRC}/${UBOOTBRANCH} .
323.El
324.Sh MAKEFILE TARGETS
325The release makefile
326.Pq Pa src/release/Makefile
327is fairly abstruse.
328Most developers will only be concerned with the
329.Cm release
330and
331.Cm install
--- 294 unchanged lines hidden ---
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
--- 8 unchanged lines hidden (view full) ---
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD: head/share/man/man7/release.7 262810 2014-03-05 23:17:53Z gjb $
26.\"
27.Dd March 5, 2014
28.Dt RELEASE 7
29.Os
30.Sh NAME
31.Nm release
32.Nd "release building infrastructure"
33.Sh DESCRIPTION
34.Fx
35provides a complete build environment suitable for users to make
--- 97 unchanged lines hidden (view full) ---
133.Pa $CHROOTDIR/R .
134.Pp
135The optional
136.Fa release.conf
137configuration file supports the following variables:
138.Bl -tag -width Ev
139.It Va CHROOTDIR
140The directory within which the release will be built.
141.It Va CHROOT_MAKEENV
142Additional
143.Xr make 1
144arguments to pass through, which directly affect the
145tuning of the build chroot.
146.It Va SVNROOT
147The
148.Xr svn 1
149host used to check out the various trees.
150Defaults to
151.Pa svn://svn.FreeeBSD.org .
152.It Va SRCBRANCH
153The
--- 95 unchanged lines hidden (view full) ---
249.It Va WITH_DVD
250Set to a non-empty value to include the
251.Cm dvdrom
252target.
253.It Va VCSCMD
254The command run to obtain the source trees.
255Defaults to
256.Qq Cm svn checkout .
257.It Va CHROOTBUILD_SKIP
258If defined, the
259.Li buildworld ,
260.Li installworld ,
261and
262.Li distribution
263stages of the
264.Xr chroot 8
265build environment setup are skipped.
266This is intended solely for cases where the
267.Xr chroot 8
268userland are provided by alternate means.
269.El
270.Sh EMBEDDED BUILDS
271The following
272.Fa release.conf
273variables are relevant only to release builds for embedded systems:
274.Bl -tag -width Ev
275.It Va EMBEDDEDBUILD
276Set to a non-null value to enable functionality for embedded device
277release builds.
278.Pq This option is considered highly experimental.
279.Pp
280When set,
281.Va WITH_DVD
282is unset, and
283.Va NODOC
284is defined.
285Additionally,
286.Va XDEV
287and
288.Va XDEV_ARCH
289must also be defined.
290When the build environment is created,
291.Fa release.sh
292runs a separate build script located in an architecture-specific
293directory in
294.Pa src/release/${XDEV}/ .
295.It Va EMBEDDEDPORTS
296Set to the list of any ports that are required for the target device
297in the format of
298.Fa category/port .
299The
300.Fa devel/subversion
301port is built by default.
302.It Va CROCHETSRC
303Set to the source URL for the Crochet build tool.
304.It Va CROCHETBRANCH
305Set to the subversion branch from
306.Va ${CROCHETSRC}
307to use.
308Defaults to
309.Pa trunk .
310.It Va UBOOTSRC
311Set to the source URL of u-boot, if required.
312.It Va UBOOTBRANCH
313Set to the subversion branch from
314.Va ${UBOOTSRC}
315to use.
316Defaults to
317.Pa trunk .
318.It Va UBOOTDIR
319Set to the target directory within
320.Va ${CHROOTDIR}
321to check out
322.Va ${UBOOTSRC}/${UBOOTBRANCH} .
323.El
324.Sh MAKEFILE TARGETS
325The release makefile
326.Pq Pa src/release/Makefile
327is fairly abstruse.
328Most developers will only be concerned with the
329.Cm release
330and
331.Cm install
--- 294 unchanged lines hidden ---