building world with debugging symbols

[John Baldwin]

On Tuesday 30 March 2010 11:48:58 am Giorgos Keramidas wrote:
> 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.

I would drop the "too" and start 'so' on a new line (at least that is my 
interpretation of the line-break rules we use for mdoc).  Other than that I 
think this looks fine.

-- 
John Baldwin