From owner-man-jp-reviewer@jp.FreeBSD.org Fri Mar 15 11:55:27 2002
Received: (from daemon@localhost)
	by castle.jp.FreeBSD.org (8.11.6+3.4W/8.11.3) id g2F2tRb92554;
	Fri, 15 Mar 2002 11:55:27 +0900 (JST)
	(envelope-from owner-man-jp-reviewer@jp.FreeBSD.org)
Received: from rwcrmhc54.attbi.com (rwcrmhc54.attbi.com [216.148.227.87])
	by castle.jp.FreeBSD.org (8.11.6+3.4W/8.11.3) with ESMTP/inet id g2F2tQc92549
	for <man-jp-reviewer@jp.freebsd.org>; Fri, 15 Mar 2002 11:55:26 +0900 (JST)
	(envelope-from kuma@12-225-156-18.client.attbi.com)
Received: from 12-225-156-18.client.attbi.com ([12.225.156.18])
          by rwcrmhc54.attbi.com
          (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP
          id <20020315025515.QMQB1214.rwcrmhc54.attbi.com@12-225-156-18.client.attbi.com>
          for <man-jp-reviewer@jp.freebsd.org>;
          Fri, 15 Mar 2002 02:55:15 +0000
To: man-jp-reviewer@jp.FreeBSD.org
From: kumagai@attbi.com (Norihiro Kumagai)
Date: Thu, 14 Mar 2002 18:55:41 -0800
Message-ID: <3599.1016160941@12-225-156-18.client.attbi.com>
Reply-To: man-jp-reviewer@jp.FreeBSD.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+020312
X-Sequence: man-jp-reviewer 3999
Subject: [man-jp-reviewer 3999] release.7
Errors-To: owner-man-jp-reviewer@jp.FreeBSD.org
Sender: owner-man-jp-reviewer@jp.FreeBSD.org
X-Originator: kuma@12-225-156-18.client.attbi.com

$B7'C+$G$9!#(B

$B$^$D$7$?$5$s$NF|5-$G(B release.7 $B$,=PMh$?$3$H$rCN$j!"LLGr$=$&$J$N$G(B
$BLu$7$F$_$^$7$?!#$H$j$"$($:::FI4uK>!#(B

--
$B7'C+(B $BE5Bg(B


.\" Copyright (c) 2002 Murray Stokely <murray@FreeBSD.org>
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" %FreeBSD: src/share/man/man7/release.7,v 1.3.2.1 2002/03/14 09:53:19 murray Exp %
.\"
.\" WORD: clean sysmtem		$B$^$C$5$i$N%7%9%F%`(B[release.7]
.\"
.Dd March 12, 2002
.Dt RELEASE 7
.Os
.Sh $BL>>N(B
.Nm release
.Nd "$B%j%j!<%99=C[4pHW(B"
.Sh $B2r@b(B
.Fx
.\"X provides a complete build environment suitable for users to make
.\"X full releases of the
$B$O!"%f!<%6$,(B
.Fx
.\"X operating system.
$B%*%Z%l!<%F%#%s%0%7%9%F%`$N%j%j!<%9A4$F$r:n@.$G$-$k$h$&$J40A4$J9=C[4D6-$r(B
$BDs6!$7$F$$$^$9!#(B
.\"X All of the tools necessary to build a release are available from the
.\"X CVS repository in
$B%j%j!<%9$r9=C[$9$k$?$a$KI,MW$J%D!<%k$NA4$F$O!"(B CVS $B%j%]%8%H%jCf$N(B
.Pa src/release
$B$KB7$C$F$$$^$9!#(B
.\"X A complete release can actually be built with only a single command,
.\"X including the creation of ISO images suitable for burning to CDROM,
.\"X installation floppies, and an FTP install directory.
$B<B$N$H$3$m!"(B
CDROM $B$r>F$/:]$K;H$($k(B ISO $B%$%a!<%8!"%$%s%9%H!<%kMQ%U%m%C%T!"(B
FTP $B%$%s%9%H!<%kMQ%G%#%l%/%H%j$N@8@.$r$O$8$a$H$7$F!"40A4$J%j%j!<%9$r(B
$B%3%^%s%I0lH/$G9=C[$G$-$^$9!#(B
.\"X This command is aptly named
$B$3$N%3%^%s%I$O!"(B
.Dq Li "make release"
$B$H!"$&$^$$L>A0$,IU$1$i$l$F$$$^$9!#(B
.Pp
.\"X Before attempting to build a release, the user is expected to be
.\"X familiar with the contents of
$B%j%j!<%9$r9=C[$9$kA0$K!"(B
.Xr build 7
$B$NFbMF$K$h$/Fk@w$s$G$*$$$F$/$@$5$$!#$^$?!"(B
.\"X and should have experience upgrading systems from source with
.Dq Li "make world"
$B$K$h$k%=!<%9$+$i$N%7%9%F%`%"%C%W%0%l!<%I$N7P83$bI,?\$G$9!#(B
.\"X The release build process requires that
$B%j%j!<%99=C[%W%m%;%9$O!"(B
.\"X be populated with the output of
.Dq Li "make buildworld"
$B$N7k2L$r(B
.Pa /usr/obj
$B$KCV$$$F$*$/$3$H$rMW5a$7$^$9!#(B
.\"X This is necessary so that the object files for a complete system can
.\"X be installed into a clean
$B40A4$J%7%9%F%`$N$?$a$N%*%V%8%'%/%H%U%!%$%k$r!"$^$C$5$i$N(B
.Xr chroot 8
.\"X environment.
$B4D6-$K%$%s%9%H!<%k$G$-$k$h$&$K$9$k$?$a$K!"$3$l$,I,MW$H$J$j$^$9!#(B
.\"X The release procedure also requires that the
$B%j%j!<%9$r?J$a$k$K$O!"(B
.Xr vn 4
.\"X (vnode disk) device driver be present in the kernel
.\"X (either by being compiled in or loaded as a module).
(vnode $B%G%#%9%/(B) $B%G%P%$%9%I%i%$%P$,%+!<%M%k$KB8:_$9$k(B
($B%3%s%Q%$%k:Q$_!"$^$?$O%b%8%e!<%k$H$7$F%m!<%I$N$$$:$l$b2D(B)
$B$3$H$bI,MW$G$9!#(B
.Pp
.\"X This document does not cover source code management, quality
.\"X assurance, or other aspects of the release engineering process.
$B$3$NJ8=q$O!"%=!<%9%3!<%I4IM}!"IJ<A4IM}$J$I!"(B
$B%j%j!<%9%(%s%8%K%"%j%s%0%W%m%;%9$K4X$9$k$=$NB>$NB&LL$O07$$$^$;$s!#(B
.Sh $B%?!<%2%C%H(B
.\"X The release makefile
$B%j%j!<%9MQ(B makefile
.Pq Pa src/release/Makefile
.\"X is fairly abstruse.
$B$O!"$+$J$jFq2r$G$9!#(B
.\"X Most developers will only be concerned with the
$B$[$H$s$I$N>l9g!"(B
.Cm release
.\"X target.
$B%?!<%2%C%H$N$3$H$r9M$($k$@$1$G:Q$`$H;W$$$^$9!#(B
.\" XXX: Some sort of introduction to this list?  All the others have one.
.Bl -tag -width ".Cm rerelease"
.It Cm release
.\"X Uses
.Dq Li "make installworld"
.\"X to install a clean system into a
$B$rMQ$$$F!"%U%!%$%k%7%9%F%`$N(B
.Xr chroot 8
.\"X environment on the filesystem.
$B4D6-$K$^$C$5$i$N%7%9%F%`$r%$%s%9%H!<%k$7$^$9!#(B
.\"X Checks out the specified version of the source code and then rebuilds
.\"X the entire system in the clean environment with
$B;XDj$7$?%P!<%8%g%s$N%=!<%9%3!<%I$r%A%'%C%/%"%&%H$7!"(B
.Dq Li "make world"
$B$rMQ$$$F!"$^$C$5$i$N4D6-$K40A4$J%7%9%F%`$r:F9=C[$7$^$9!#(B
.\"X The detailed steps that follow are then executed to package up the
.\"X different distributions, build the installation floppy disks, build
.\"X release documentation, and so on.
$B$=$N$"$H$K!"%G%#%9%H%j%S%e!<%7%g%sJL$N%Q%C%1!<%8%s%0(B($B$^$H$a>e$2(B)$B!"(B
$B%$%s%9%H!<%kMQ%U%m%C%T%G%#%9%/$N9=C[!"%j%j!<%9J8=q$N9=C[$J$I$N(B
$B:Y$+$$%9%F%C%W$,B3$-$^$9!#(B
.It Cm rerelease
.\"X Assumes that the output of a release build has been manually modified,
.\"X and performs the minimal number of steps to rebuild the release using
.\"X the intermediate output of the previous
$B$3$N%?!<%2%C%H$O!"%j%j!<%99=C[:n6H$N7k2L$r<j$G=$@5$7!"A0$N(B
.Dq Li "make release"
$B$NCf4V7k2L$r;H$$!":G>.$N%9%F%C%W?t$G%j%j!<%9$r:F9=C[$9$k$3$H$r(B
$BA[Dj$7$?$b$N$G$9!#(B
.El
.Pp
.\"X Targets called by
.Dq Li "make release"
$B$K$h$j8F$S=P$5$l$k%?!<%2%C%H$O<!$N$H$*$j$G$9!#(B
.Bl -tag -width ".Cm release.9"
.It Cm release.1
.\"X Cleans out the
$B%G%#%l%/%H%j(B
.Pa ${CHROOTDIR}/R
.\"X directory and uses
$B$r$^$C$5$i$K$7!"(B
.Xr mtree 8
.\"X to build the directory hierarchy for the system.
$B$rMQ$$$F%7%9%F%`MQ$N%G%#%l%/%H%j3,AX$r9=C[$7$^$9!#(B
.It Cm release.2
.\"X Installs the system into the distribution directories.
$B%7%9%F%`$r%G%#%9%H%j%S%e!<%7%g%sMQ%G%#%l%/%H%j$K%$%s%9%H!<%k$7$^$9!#(B
.It Cm release.3
.\" XXX: This should either be "GENERIC kernel" (singular) or
.\" XXX: "GENERIC and <some other> kernels".
.\"X Makes and installs the
.Pa GENERIC
.\"X kernel.
$B%+!<%M%k$r:n$j!"%$%s%9%H!<%k$7$^$9!#(B
.It Cm release.4
.\"X Uses
.Xr crunchgen 1
.\"X to build
$B$rMQ$$$F!"%$%s%9%H!<%kMQ%U%m%C%T$K@3B)$9$k(B
.\"X .Dq crunched
.Dq $B%/%i%s%A$5$l$?(B
.\"X binaries to live on the installation floppies.
$B%P%$%J%j$r9=C[$7$^$9!#(B
.It Cm release.5
.\"X Builds synthetic distributions, and cleans up the previously built
.\"X distribution trees.
.\"kuma: synthetic distribution $B$H$O2?$+(B?
$B9g@.%G%#%9%H%j%S%e!<%7%g%s$r9=C[$7!"(B
$B0JA0$K9=C[$7$?%G%#%9%H%j%S%e!<%7%g%s%D%j!<$r$^$C$5$i$K$7$^$9!#(B
.It Cm release.6
.\"X Creates tarballs of the assembled distribution trees.
$BAH$_N)$F$i$l$?%G%#%9%H%j%S%e!<%7%g%s%D%j!<$N(B tarball $B$r(B
$B@8@.$7$^$9!#(B
.It Cm release.7
.\"X Makes source distributions.
$B%=!<%9%G%#%9%H%j%S%e!<%7%g%s$r:n@.$7$^$9!#(B
.It Cm release.8
.\"X Creates the boot and MFS root floppies.
boot $B%U%m%C%T!"(BMSF root $B%U%m%C%T$r@8@.$7$^$9!#(B
.It Cm release.9
.\"X Creates the fixit floppy.
fixit $B%U%m%C%T$r@8@.$7$^$9!#(B
.It Cm ftp.1
.\"X Sets up a suitable area for FTP installations.
FTP $B%$%s%9%H!<%k$KE,@Z$JNN0h$r=`Hw$7$^$9!#(B
.It Cm cdrom.1
.\"X Sets up a suitable area to build CDROM images.
CDROM $B%$%a!<%89=C[$KE,@Z$JNN0h$r=`Hw$7$^$9!#(B
.It Cm iso.1
.\"X Builds two ISO images (installation and
CDROM $B%j%j!<%9NN0h$+$i(B ISO $B%$%a!<%8(B 2 $B$D$r9=C[$7$^$9(B (installation $B$H(B
.Dq live
.\"X filesystem) from the CDROM release area
$B%U%!%$%k%7%9%F%`$N(B 2 $B$D(B)$B!#%G%U%)%k%H$G$OL58z$K$J$C$F$$$^$9!#(B
$B0J2<$N(B
.\"X (Disabled by default, see
.Pa MAKE_ISOS
.\"X below).
$B$r;2>H$7$F$/$@$5$$!#(B
.It Cm doc.1
.\"X Builds all of the necessary tools to turn the
.Fx
.\"X Documentation Project source documents (SGML, XML) into HTML
.\"X and text documents that will accompany the release.
.\"X Also, builds and installs the actual user documentation.
.\"X This includes the Handbook, FAQ, articles, and so on.
$B%I%-%e%a%s%F!<%7%g%s%W%m%8%'%/%H$N%=!<%9%I%-%e%a%s%H(B (SGML, XML) $B$+$i(B
$B%j%j!<%9$K4^$a$k(B HTML / $B%F%-%9%H%I%-%e%a%s%H$KJQ49$9$k$?$a$K(B
$BI,MW$J%D!<%kA4$F$r9=C[$7$^$9!#(B
$B$^$?!"8=:_B8:_$9$k%f!<%6%I%-%e%a%s%H$b9=C[!"%$%s%9%H!<%k$7$^$9!#(B
$B$3$l$K$O!"(BHandbook, FAQ, $B5-;v$J$I$,4^$^$l$^$9!#(B
.\"kuma: article $B$H$O6qBNE*$K2?$+(B?
.It Cm doc.2
.\"X Builds the release documentation.
.\"X This includes the release notes,
.\"X hardware guide, and installation instructions.
$B%j%j!<%9%I%-%e%a%s%H$r9=C[$7$^$9!#(B
$B$3$l$K$O!"%j%j!<%9%N!<%H!"%O!<%I%&%(%"%,%$%I!"%$%s%9%H!<%k;X<(=q(B
(installation instructions) $B$,4^$^$l$^$9!#(B
.El
.Sh $B4D6-JQ?t(B
.\"X Variables that must be specified:
$B;XDj$7$J$1$l$P$J$i$J$$4D6-JQ?t$O!"(B
.Bl -tag -width ".Va RELEASETAG"
.It Ev CHROOTDIR
.\"X The directory to be used as the
.Xr chroot 8
.\"X environment for the entire release build.
$B4D6-$H$7$F!"A4%j%j!<%99=C[$K;HMQ$9$k%G%#%l%/%H%j!#(B
.\" XXX: I recommend against hardcoding specific numbers like "2.3" here;
.\" XXX: perhaps it should be replaced with something to the effect of
.\" XXX: "we don't know how much space you'll need, but make sure you have
.\" XXX: at least 3 GB to be safe" (I know i'm still hardcoding a number,
.\" XXX: but at least it looks less like a decree and more like an estimate.
.\"X This filesystem should have at least 2.3 gigabytes of free space on the
.\"X i386 architecture.
.It Ev BUILDNAME
.\"X The name of the release to be built.
.\"X This is used to set the
$B9=C[$9$k%j%j!<%9$NL>A0!#$3$NL>A0$O!"(B
.Pa sys/conf/newvers.sh
$B$NCf$N(B
.Dv RELEASE
$B$NCM$r@_Dj$9$k$N$K;HMQ$7$^$9!#$3$NCM$O(B
.\"X value in
.\"X which affects the output of
.Xr uname 1
$B$N=PNO$K1F6A$7$^$9!#(B
.It Ev CVSROOT
.\"X The location of the
.Fx
.\"X CVS repository.
CVS $B%j%]%8%H%j$N>l=j!#(B
.It Ev RELEASETAG
.\"X The CVS tag corresponding to the release that is to be built.
.\"X If undefined, the release will be built from the
$B9=C[$9$k%j%j!<%9$KAjEv$9$k(B CVS $B%?%0!#L$Dj5A$N>l9g!"(BCVS $B%D%j!<$N(B
.Dv HEAD
(
.Dq -CURRENT $B%9%J%C%W%7%g%C%H(B
) $B$+$i9=C[$5$l$^$9!#(B
.\"X of the CVS tree
.\"X (a
.El
.Pp
.\"X Optional variables:
$B%*%W%7%g%s$NJQ?t$O<!$N$H$*$j$G$9!#(B
.Bl -tag -width ".Ev RELEASEDISTFILES"
.It Ev LOCAL_PATCHES
.\"X A patch file against
.Pa /usr/src
.\"X that will be applied in the
$B$KBP$9$k%Q%C%A%U%!%$%k!#$3$N%Q%C%A$O!"%j%j!<%99=C[$r3+;O$9$kA0$K!"(B
.Xr chroot 8
.\"X environment before the release build begins.
$B4D6-$GE,MQ$5$l$^$9!#(B
.It Ev PATCH_FLAGS
.\"X Arguments for the
$B%Q%C%A%U%!%$%k(B
.Ev LOCAL_PATCHES
$B$rE,MQ$9$k:]$KMQ$$$k(B
.Xr patch 1
$B%3%^%s%I$KEO$90z?t!#(B
.\"X command used to apply
.\"X patch file.
.It Ev MAKE_ISOS
.\"X If defined, bootable ISO CDROM images will be created from the
.\"X contents of the CDROM stage directory.
$B$3$l$rDj5A$7$?>l9g!"(BCDROM $B%9%F!<%8$N%G%#%l%/%H%j$NFbMF$+$i!"(B
$B%V!<%?%V%k(B ISO CDROM $B%$%a!<%8$r@8@.$7$^$9!#(B
.It Ev NODOC
.\"X If set to
.Dq Li YES
.\"X then the documentation will not be built.
.\"X Due to the SGML-based
.\"X toolchain and multiple languages supported by the
$B$H@_Dj$7$?>l9g!"%I%-%e%a%s%H$O@8@.$7$^$;$s!#(B
.Fx
.\"X Documentation Project, this may speed up the release build considerably.
$B%I%-%e%a%s%F!<%7%g%s%W%m%8%'%/%H$,%5%]!<%H$9$k(B SGML $B%Y!<%9$N%D!<%k72$H(B
$BJ#?t8@8lBP1~$N1F6A$,$J$/$J$k$N$G!"$3$l$K$h$j%j%j!<%99=C[$r(B
$B$+$J$j9bB.$K$9$k$3$H$,$G$-$^$9!#(B
.It Ev NOPORTS
.\"X If set to
.Dq Li YES
.\"X then the ports tree will be omitted from the release.
$B$H@_Dj$7$?>l9g!"(Bports $B%D%j!<$O%j%j!<%9$+$i>JN,$5$l$^$9!#(B
.It Ev RELEASEDISTFILES
.\"X The directory where the distribution files for ports required by the
.\"X release build can be found.
.\"X This may save a significant amount of time over downloading the
.\"X distfiles through a slow link.
ports $BMQ$H$7$F!"%j%j!<%99=C[$KI,MW$H$J$k(B
$B%G%#%9%H%j%S%e!<%7%g%s%U%!%$%k$,B8:_$9$k%G%#%l%/%H%j$G$9!#(B
$B$3$l$K$h$j!"DcB.$J%j%s%/7PM3$G(B
distfiles $B$r%@%&%s%m!<%I$9$k:]$KHq$d$5$l$kG|Bg$J;~4V$r(B
$B@aLs$9$k$3$H$,$G$-$^$9!#(B
.It Ev RELEASENOUPDATE
.\"X If this variable is defined for
$B$3$NJQ?t$NCM$r(B
.Dq Li "make rerelease"
$B$H@_Dj$7$?>l9g!"(B
.\"X the source code will not be updated with
.Dq Li "cvs update"
$B$K$h$k%=!<%9%3!<%I99?7$r9T$J$$$^$;$s!#(B
.El
.Sh $B4XO"%U%!%$%k(B
.Bl -tag -compact
.It Pa /etc/make.conf
.It Pa /usr/doc/Makefile
.It Pa /usr/doc/share/mk/doc.project.mk
.It Pa /usr/ports/Mk/bsd.port.mk
.It Pa /usr/ports/Mk/bsd.sites.mk
.It Pa /usr/share/examples/etc/make.conf
.It Pa /usr/src/Makefile
.It Pa /usr/src/Makefile.inc1
.It Pa /usr/src/release/Makefile
.It Pa /usr/src/release/${arch}/drivers.conf
.It Pa /usr/src/release/${arch}/boot_crunch.conf
.It Pa /usr/src/release/${arch}/fixit_crunch.conf
.El
.Sh $B;HMQNc(B
.\"X The following sequence of commands was used to build the
$B0J2<$N%3%^%s%INs$O(B
.Fx 4.5
.\"X release:
release $B$r9=C[$9$k:]$K;HMQ$7$?$b$N$G$9!#(B
.Bd -literal -offset indent
cd /usr
cvs co -rRELENG_4_5_0_RELEASE src
cd src
make buildworld
cd release
make release CHROOTDIR=/local3/release BUILDNAME=4.5-RELEASE \\
  CVSROOT=/host/cvs/usr/home/ncvs RELEASETAG=RELENG_4_5_0_RELEASE
.Ed
.Pp
.\"X After running these commands, a complete system suitable for FTP or
.\"X CDROM distribution is available in the
$B$3$l$i$N%3%^%s%I$r<B9T$9$k$H!"(BFTP $B%G%#%9%H%j%S%e!<%7%g%sMQ$H!"(B
CDROM $B%G%#%9%H%j%S%e!<%7%g%sMQ$H$7$F;H$($k40A4$J%7%9%F%`$,(B
$B%G%#%l%/%H%j(B
.Pa /local3/release/R
.\"X directory.
$B$K$G$-$^$9!#(B
.Pp
.\"X The following sequence of commands can be used to build a
$B<!$N%3%^%s%INs$O!"%m!<%+%k$G=$@5$7$?%=!<%9%D%j!<$N(B
.Dq -CURRENT snapshot
.\"X of a
.\"X locally modified source tree:
$B$r9=C[$9$k$?$a$K;HMQ$G$-$^$9!#(B
.Bd -literal -offset indent
cd /usr/src
cvs diff -u > /path/to/local.patch
make buildworld
cd release
make release CHROOTDIR=/local3/release BUILDNAME=5.0-SNAPSHOT \\
  CVSROOT=/host/cvs/usr/home/ncvs LOCAL_PATCHES=/path/to/local.patch
.Ed
.Sh $B4XO"9`L\(B
.Xr cc 1 ,
.Xr crunchgen 1 ,
.Xr cvs 1 ,
.Xr install 1 ,
.Xr make 1 ,
.Xr patch 1 ,
.Xr uname 1 ,
.Xr vn 4 ,
.Xr make.conf 5 ,
.Xr build 7 ,
.Xr ports 7 ,
.Xr chroot 8 ,
.Xr mtree 8
.Rs
.%T FreeBSD Release Engineering
.%O http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/releng/
.Re
.Rs
.%T FreeBSD Release Engineering of Third Party Packages
.%O http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/releng-packages/
.Re
.Rs
.%T FreeBSD Developers' Handbook
.%O http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/developers-handbook/
.Re
.Sh $BNr;K(B
.Fx
.\"X 1.x
.\"X used a manual checklist, compiled by Rod Grimes, to produce a release.
.\"X Apart from being incomplete, the list put a lot of specific demands on
.\"X available filesystems and was quite torturous to execute.
1.x
$B$G$O!"%A%'%C%/%j%9%H$r<j$G%A%'%C%/$7$J$,$i!"(B
Rod Grimes $B$K$h$j%3%s%Q%$%k$5$l!"%j%j!<%9$,:n@.$5$l$^$7$?!#(B
$BIT40A4$5$O$5$F$*$/$K$7$F$b!"$3$N%A%'%C%/%j%9%H$K$O!"(B
$B%U%!%$%k%7%9%F%`$r;H$($k$h$&$K$9$k$?$a$N$3$^$4$^$H$7$?MW5a$,BgNL$K(B
$B4^$^$l$F$*$j!"$=$N<B9T$O9iLd$H$7$+$$$$$h$&$,$J$$$b$N$G$7$?!#(B
.Pp
.\"X As part of the
.Fx 2.0
.\"X release engineering effort, significant
.\"X effort was spent getting
$B%j%j!<%9%(%s%8%K%"%j%s%0$rB3$1$kCf$G!"(B
.Pa src/release/Makefile
.\"X into a shape where it could at least automate most of the tediousness
.\"X of building a release in a sterile environment.
$B$rD>$7$F!"L56]4D6-$G%j%j!<%9$r9=C[$9$k:]$NB`6~$J:n6H$N$[$H$s$I$r(B
$B<+F0E*$K9T$J$($k$h$&$K$9$k$3$H$K!"82Cx$JEXNO$,J'$o$l$^$7$?!#(B
.\"kuma: sterile environment?! $B!VITLS!W(Bor$B!VL56]!W!#(B
.\"kuma: $B!V%Z%s%Z%sAp$b@8$($J$$87$7$$4D6-$G$NEXNO!W(B?
.\"kuma: $B$=$l$H$b!V1x@w$N$J$$$^$C$5$i$5!W(B? $BK\?M$K3NG'$9$k$3$H!#(B
.Pp
.\"X With its almost 1000 revisions spread over multiple branches, the 
$BJ#?t$N%V%i%s%A$K$^$?$,$k(B 1000 $B2s6a$/$N2~HG$r7P$F!"(B
.Pa src/release/Makefile
$B$N(B
.Xr cvs 1
.\"X log of
.\"X contains a vivid historical record of some
.\"X of the hardships release engineers go through.
$B%m%0$K$O!"%j%j!<%9%(%s%8%K%"$?$A$,7P83$7$?6lFq$N$$$/$P$/$+$r<($9(B
$B@8!9$7$$Nr;K$N5-O?$,9o$_9~$^$l$F$$$^$9!#(B
.Sh $B:n<T(B
.Pa src/release/Makefile
.\"X was originally written by 
$B$O!"$b$H$b$H$O(B
.An -nosplit
.An Rod Grimes ,
.An Jordan Hubbard ,
.\"X and
.An Poul-Henning Kamp
$B$,=q$-$^$7$?!#$3$N%^%K%e%"%k%Z!<%8$O!"(B
.\"X This manual page was written by
.An Murray Stokely Aq murray@FreeBSD.org
$B$,=q$-$^$7$?!#(B
