docs/76064: Add more information to build(7)

[Gavin Atkinson]

>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 at 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: