From owner-freebsd-doc@FreeBSD.ORG Mon Jan 10 18:20:20 2005 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6E7EC16A4CF for ; Mon, 10 Jan 2005 18:20:20 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 30B7243D45 for ; Mon, 10 Jan 2005 18:20:20 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id j0AIKKr4053045 for ; Mon, 10 Jan 2005 18:20:20 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.1/8.13.1/Submit) id j0AIKKqS053044; Mon, 10 Jan 2005 18:20:20 GMT (envelope-from gnats) Resent-Date: Mon, 10 Jan 2005 18:20:20 GMT Resent-Message-Id: <200501101820.j0AIKKqS053044@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Gavin Atkinson Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9960216A4CE for ; Mon, 10 Jan 2005 18:10:50 +0000 (GMT) Received: from mail-gw0.york.ac.uk (mail-gw0.york.ac.uk [144.32.128.245]) by mx1.FreeBSD.org (Postfix) with ESMTP id B92A443D46 for ; Mon, 10 Jan 2005 18:10:49 +0000 (GMT) (envelope-from ga9@buffy.york.ac.uk) Received: from buffy.york.ac.uk (buffy.york.ac.uk [144.32.226.160]) by mail-gw0.york.ac.uk (8.12.10/8.12.10) with ESMTP id j0AIAlw2011807 for ; Mon, 10 Jan 2005 18:10:47 GMT Received: from buffy.york.ac.uk (localhost [127.0.0.1]) by buffy.york.ac.uk (8.13.1/8.13.1) with ESMTP id j0AIAlYV002963 for ; Mon, 10 Jan 2005 18:10:47 GMT (envelope-from ga9@buffy.york.ac.uk) Received: (from root@localhost) by buffy.york.ac.uk (8.13.1/8.13.1/Submit) id j0AIAlcL002962; Mon, 10 Jan 2005 18:10:47 GMT (envelope-from ga9) Message-Id: <200501101810.j0AIAlcL002962@buffy.york.ac.uk> Date: Mon, 10 Jan 2005 18:10:47 GMT From: Gavin Atkinson To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/76064: Add more information to build(7) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Gavin Atkinson List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Jan 2005 18:20:20 -0000 >Number: 76064 >Category: docs >Synopsis: Add more information to build(7) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Jan 10 18:20:19 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Gavin Atkinson >Release: FreeBSD 5.3-STABLE i386 >Organization: >Environment: System: FreeBSD buffy.york.ac.uk 5.3-STABLE FreeBSD 5.3-STABLE #6: Tue Dec 7 22:37:07 GMT 2004 root@buffy.york.ac.uk:/usr/obj/usr/src/sys/BUFFY i386 >Description: build(7) lacks documentation on some of the more useful build flags and targets. >How-To-Repeat: n/a >Fix: --- build.7.diff begins here --- Index: src/share/man/man7/build.7 =================================================================== RCS file: /usr/cvs/src/share/man/man7/build.7,v retrieving revision 1.27 diff -u -r1.27 build.7 --- src/share/man/man7/build.7 13 Aug 2004 12:59:46 -0000 1.27 +++ src/share/man/man7/build.7 10 Jan 2005 18:09:59 -0000 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD: src/share/man/man7/build.7,v 1.27 2004/08/13 12:59:46 ru Exp $ .\" -.Dd August 13, 2004 +.Dd January 10, 2005 .Dt BUILD 7 .Os .Sh NAME @@ -90,6 +90,11 @@ Install the kernel and the kernel modules. .It Cm reinstallkernel Reinstall the kernel and the kernel modules. +.It Cm kernel +Equivalent to +.Cm buildkernel +followed by +.Cm installkernel .El .Pp For more information about the ports build process, see @@ -119,6 +124,39 @@ The directory hierarchy where the resulting binaries will be installed. .El +.Sh FLAGS +.Bl -tag -width ".Va NO_KERNELDEPEND" +.It Va -DNO_MAN +Do not build man pages. +.It Va -DNO_GAMES +Do not build games. +.It Va -DNO_DYNAMICROOT +Build +.Pa /bin +and +.Pa /sbin +statically. +.El +.Pp +Note that there are many other flags which can be used. +.Pa /usr/src/Makefile.inc1 +lists more. +.Pp +The following flags can dramatically speed up a build, +but should be used with care and never after the source +has been updated since the last build. +They are mainly useful for testing changes to individual +files, where dependencies are known to have not changed. +.Bl -tag -width ".Va NO_KERNELDEPEND" +.It Va -DNO_CLEAN +Do not clean before building. +.It Va -DNO_KERNELDEPEND +Do not recreate dependency information. +.It Va -DNO_KERNELCONFIG +Do not run +.Xr config 8 +to reconfigure the kernel before building. +.El .Sh FILES .Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact .It Pa /etc/make.conf @@ -148,6 +186,7 @@ .Ed .Sh SEE ALSO .Xr cc 1 , +.Xr config 8 , .Xr install 1 , .Xr make 1 , .Xr make.conf 5 , --- build.7.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: