Date: Tue, 30 Mar 2010 15:10:58 -0400 From: John Baldwin <jhb@freebsd.org> To: freebsd-hackers@freebsd.org Cc: Giorgos Keramidas <keramida@ceid.upatras.gr>, Alexander Best <alexbestms@wwu.de>, Bruce Cran <bruce@cran.org.uk> Subject: Re: building world with debugging symbols Message-ID: <201003301510.58203.jhb@freebsd.org> In-Reply-To: <874ojx4xp1.fsf@kobe.laptop> References: <permail-20100305171533f7e55a9d0000225a-a_best01@message-id.uni-muenster.de> <874ojx4xp1.fsf@kobe.laptop>
next in thread | previous in thread | raw e-mail | index | archive | help
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@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201003301510.58203.jhb>