| release.7 (107064) | release.7 (107788) |
|---|---|
| 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.\" | 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 107064 2002-11-18 20:31:35Z jhb $ | 25.\" $FreeBSD: head/share/man/man7/release.7 107788 2002-12-12 17:26:04Z ru $ |
| 26.\" 27.Dd March 12, 2002 28.Dt RELEASE 7 29.Os 30.Sh NAME 31.Nm release 32.Nd "release building infrastructure" 33.Sh DESCRIPTION --- 40 unchanged lines hidden (view full) --- 74target. 75.\" XXX: Some sort of introduction to this list? All the others have one. 76.Bl -tag -width ".Cm rerelease" 77.It Cm release 78Uses 79.Dq Li "make installworld" 80to install a clean system into a 81.Xr chroot 8 | 26.\" 27.Dd March 12, 2002 28.Dt RELEASE 7 29.Os 30.Sh NAME 31.Nm release 32.Nd "release building infrastructure" 33.Sh DESCRIPTION --- 40 unchanged lines hidden (view full) --- 74target. 75.\" XXX: Some sort of introduction to this list? All the others have one. 76.Bl -tag -width ".Cm rerelease" 77.It Cm release 78Uses 79.Dq Li "make installworld" 80to install a clean system into a 81.Xr chroot 8 |
| 82environment on the filesystem. | 82environment on the file system. |
| 83Checks out the specified version of the source code and then rebuilds 84the entire system in the clean environment with 85.Dq Li "make world" . 86The detailed steps that follow are then executed to package up the 87different distributions, build the installation floppy disks, build 88release documentation, and so on. 89.It Cm rerelease 90Assumes that the output of a release build has been manually modified, --- 57 unchanged lines hidden (view full) --- 148Sets up a suitable area for FTP installations in 149.Pa ${CHROOTDIR}/R/ftp . 150.It Cm cdrom.1 151Sets up a suitable area to build CD-ROM images in 152.Pa ${CHROOTDIR}/R/cdrom . 153.It Cm iso.1 154Builds two ISO images (installation and 155.Dq live | 83Checks out the specified version of the source code and then rebuilds 84the entire system in the clean environment with 85.Dq Li "make world" . 86The detailed steps that follow are then executed to package up the 87different distributions, build the installation floppy disks, build 88release documentation, and so on. 89.It Cm rerelease 90Assumes that the output of a release build has been manually modified, --- 57 unchanged lines hidden (view full) --- 148Sets up a suitable area for FTP installations in 149.Pa ${CHROOTDIR}/R/ftp . 150.It Cm cdrom.1 151Sets up a suitable area to build CD-ROM images in 152.Pa ${CHROOTDIR}/R/cdrom . 153.It Cm iso.1 154Builds two ISO images (installation and 155.Dq live |
| 156filesystem) from the CD-ROM release area | 156file system) from the CD-ROM release area |
| 157(disabled by default, see 158.Va MAKE_ISOS 159below). 160.It Cm doc.1 161Builds all of the necessary tools to turn the 162.Fx 163Documentation Project source documents (SGML, XML) into HTML 164and text documents that will accompany the release. --- 19 unchanged lines hidden (view full) --- 184The directory to be used as the 185.Xr chroot 8 186environment for the entire release build. 187.\" XXX: I recommend against hardcoding specific numbers like "2.3" here; 188.\" XXX: perhaps it should be replaced with something to the effect of 189.\" XXX: "we don't know how much space you'll need, but make sure you have 190.\" XXX: at least 3 GB to be safe" (I know i'm still hardcoding a number, 191.\" XXX: but at least it looks less like a decree and more like an estimate. | 157(disabled by default, see 158.Va MAKE_ISOS 159below). 160.It Cm doc.1 161Builds all of the necessary tools to turn the 162.Fx 163Documentation Project source documents (SGML, XML) into HTML 164and text documents that will accompany the release. --- 19 unchanged lines hidden (view full) --- 184The directory to be used as the 185.Xr chroot 8 186environment for the entire release build. 187.\" XXX: I recommend against hardcoding specific numbers like "2.3" here; 188.\" XXX: perhaps it should be replaced with something to the effect of 189.\" XXX: "we don't know how much space you'll need, but make sure you have 190.\" XXX: at least 3 GB to be safe" (I know i'm still hardcoding a number, 191.\" XXX: but at least it looks less like a decree and more like an estimate. |
| 192This filesystem should have at least 2.3 gigabytes of free space on the | 192This file system should have at least 2.3 gigabytes of free space on the |
| 193i386 architecture. 194.It Va CVSROOT 195The location of the 196.Fx 197CVS repository. 198This path name is in reference to the real system root, 199.Em not 200the root of the --- 234 unchanged lines hidden (view full) --- 435.Re 436.Sh HISTORY 437.Fx 4381.x 439used a manual checklist, compiled by 440.An Rod Grimes , 441to produce a release. 442Apart from being incomplete, the list put a lot of specific demands on | 193i386 architecture. 194.It Va CVSROOT 195The location of the 196.Fx 197CVS repository. 198This path name is in reference to the real system root, 199.Em not 200the root of the --- 234 unchanged lines hidden (view full) --- 435.Re 436.Sh HISTORY 437.Fx 4381.x 439used a manual checklist, compiled by 440.An Rod Grimes , 441to produce a release. 442Apart from being incomplete, the list put a lot of specific demands on |
| 443available filesystems and was quite torturous to execute. | 443available file systems and was quite torturous to execute. |
| 444.Pp 445As part of the 446.Fx 2.0 447release engineering effort, significant 448effort was spent getting 449.Pa src/release/Makefile 450into a shape where it could at least automate most of the tediousness 451of building a release in a sterile environment. --- 17 unchanged lines hidden --- | 444.Pp 445As part of the 446.Fx 2.0 447release engineering effort, significant 448effort was spent getting 449.Pa src/release/Makefile 450into a shape where it could at least automate most of the tediousness 451of building a release in a sterile environment. --- 17 unchanged lines hidden --- |