building world with debugging symbols

[Giorgos Keramidas]

On Fri, 05 Mar 2010 18:15:33 +0100 (CET), Alexander Best <alexbestms at wwu.de> wrote:
>> DEBUG_FLAGS=-g
>
> ahh. thanks for the hint. with DEBUG_FLAGS i was able to build world with
> debugging symbols but also managed to keep the bootloader small enough.
>
> i don't think this option is documented anywhere or is it?

It's not documented in the obvious place I'd look for it: the build(7)
manpage.  Does the following look ok?

%%%
diff -r 236fcd32a358 share/man/man7/build.7
--- a/share/man/man7/build.7	Sun Mar 28 00:46:10 2010 +0200
+++ b/share/man/man7/build.7	Tue Mar 30 18:48:16 2010 +0300
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 15, 2009
+.Dd March 30, 2010
 .Dt BUILD 7
 .Os
 .Sh NAME
@@ -311,6 +311,20 @@ should be set as with
 .Sh ENVIRONMENT
 Variables that influence all builds include:
 .Bl -tag -width ".Va MAKEOBJDIRPREFIX"
+.It Va DEBUG_FLAGS
+Defines a set of debugging flags that will be used to build all userland
+binaries under
+.Pa /usr/src .
+When
+.Va DEBUG_FLAGS
+is defined, the
+.Cm install
+and
+.Cm installworld
+targets install binaries from the current
+.Va MAKEOBJDIRPREFIX
+without stripping too, so that debugging information is retained in the
+installed binaries.
 .It Va DESTDIR
 The directory hierarchy prefix where built objects will be installed.
 If not set,
%%%
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 195 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/freebsd-hackers/attachments/20100330/3cf0a351/attachment.pgp