From owner-freebsd-hackers@FreeBSD.ORG Tue Mar 30 19:35:25 2010 Return-Path: Delivered-To: freebsd-hackers@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4432D106564A for ; Tue, 30 Mar 2010 19:35:25 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from cyrus.watson.org (cyrus.watson.org [65.122.17.42]) by mx1.freebsd.org (Postfix) with ESMTP id 14EB88FC13 for ; Tue, 30 Mar 2010 19:35:25 +0000 (UTC) Received: from bigwig.baldwin.cx (66.111.2.69.static.nyinternet.net [66.111.2.69]) by cyrus.watson.org (Postfix) with ESMTPSA id A6FB146BC2; Tue, 30 Mar 2010 15:35:24 -0400 (EDT) Received: from jhbbsd.localnet (smtp.hudson-trading.com [209.249.190.9]) by bigwig.baldwin.cx (Postfix) with ESMTPA id 481598A025; Tue, 30 Mar 2010 15:35:23 -0400 (EDT) From: John Baldwin To: freebsd-hackers@freebsd.org Date: Tue, 30 Mar 2010 15:10:58 -0400 User-Agent: KMail/1.12.1 (FreeBSD/7.3-CBSD-20100217; KDE/4.3.1; amd64; ; ) References: <874ojx4xp1.fsf@kobe.laptop> In-Reply-To: <874ojx4xp1.fsf@kobe.laptop> MIME-Version: 1.0 Content-Type: Text/Plain; charset="iso-8859-15" Content-Transfer-Encoding: 7bit Message-Id: <201003301510.58203.jhb@freebsd.org> X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.0.1 (bigwig.baldwin.cx); Tue, 30 Mar 2010 15:35:23 -0400 (EDT) X-Virus-Scanned: clamav-milter 0.95.1 at bigwig.baldwin.cx X-Virus-Status: Clean X-Spam-Status: No, score=-1.8 required=4.2 tests=AWL,BAYES_00 autolearn=ham version=3.2.5 X-Spam-Checker-Version: SpamAssassin 3.2.5 (2008-06-10) on bigwig.baldwin.cx Cc: Giorgos Keramidas , Alexander Best , Bruce Cran Subject: Re: building world with debugging symbols X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Mar 2010 19:35:25 -0000 On Tuesday 30 March 2010 11:48:58 am Giorgos Keramidas wrote: > On Fri, 05 Mar 2010 18:15:33 +0100 (CET), Alexander Best 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