From rfg@tristatelogic.com  Sat Nov  3 04:04:26 2012
Return-Path: <rfg@tristatelogic.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 131F136D
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  3 Nov 2012 04:04:26 +0000 (UTC)
	(envelope-from rfg@tristatelogic.com)
Received: from outgoing.tristatelogic.com (segfault.tristatelogic.com [69.62.255.118])
	by mx1.freebsd.org (Postfix) with ESMTP id E03AE8FC15
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  3 Nov 2012 04:04:25 +0000 (UTC)
Received: by segfault.tristatelogic.com (Postfix, from userid 1237)
	id 6C05150821; Fri,  2 Nov 2012 21:04:25 -0700 (PDT)
Message-Id: <20121103040425.6C05150821@segfault.tristatelogic.com>
Date: Fri,  2 Nov 2012 21:04:25 -0700 (PDT)
From: Ronald F.Guilmette <rfg@tristatelogic.com>
Reply-To: Ronald F.Guilmette <rfg@tristatelogic.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc: rfg@tristatelogic.com
Subject: ports(7) man page -- no info on building with debugging info
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         173321
>Category:       docs
>Synopsis:       ports(7) man page -- no info on building with debugging info
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Nov 03 04:10:01 UTC 2012
>Closed-Date:    
>Last-Modified:  Sat May 18 03:10:00 UTC 2013
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 8.3-RELEASE amd64
>Organization:
entr0py
>Environment:

FreeBSD 8.3-RELEASE GENERIC amd64

>Description:

Looking in the ports(7) man page, there does not appear to be any information
in there whatsoever that describes the accepted & official method whereby
any given port can be built and installed in such a way so that the
executable(s) and also the shared library/libraries that form the port
will be compiled with full debugging symbols AND so that this debug info
will NOT be stripped out of the components of the port as they are actually
being installed into the directories where they will ultimately live.

This makes no sense to me (and I consider it a bug), because the ports(7)
man page _does_ have what looks like complete information about any and
every possible ``standard'' port Makefile target.  Given that, it seems
to me to be more than reasonable to expect this man page to also document
something as fundamental as how to build & install a port with debug symbols.

>How-To-Repeat:

man 7 ports

>Fix:

I would suggest some prose to add, but frankly, I am not 100% sure that I
know the Right Way to build & install with debugging symbols.  (I think that
I know, but I could easily be wrong.)
>Release-Note:
>Audit-Trail:

From: Chris Rees <crees@FreeBSD.org>
To: "bug-followup@freebsd.org" <bug-followup@freebsd.org>
Cc:  
Subject: Re: docs/173321: ports(7) man page -- no info on building with
 debugging info
Date: Sat, 3 Nov 2012 09:12:12 +0000

 I think that we should just make the manpage a stub pointing to (in
 /usr/ports) README, Mk/bsd.options.desc.mk and the comments in
 bsd.port.mk.
 
 The ports tree evolves so quickly that any man page written for it
 will immediately be out of date and incorrect.
 
 Anyone else agree?
 
 Chris

From: Jason Helfman <jgh@FreeBSD.org>
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/173321
Date: Fri, 17 May 2013 20:06:34 -0700

 --bcaec520f6a91f2fc504dcf5637a
 Content-Type: text/plain; charset=ISO-8859-1
 
 Agreed.
 
 If anything, set DEBUG in /etc/make.conf at a minimal. And after that is
 written, and committed, a new method will exist :)
 
 This should be closed.
 
 -jgh
 
 --
 Jason Helfman          | FreeBSD Committer
 jgh@FreeBSD.org     | http://people.freebsd.org/~jgh  | The Power to Serve
 
 --bcaec520f6a91f2fc504dcf5637a
 Content-Type: text/html; charset=ISO-8859-1
 Content-Transfer-Encoding: quoted-printable
 
 <div dir=3D"ltr">Agreed.<div><br></div><div>If anything, set DEBUG in /etc/=
 make.conf at a minimal. And after that is written, and committed, a new met=
 hod will exist :)</div><div><br></div><div style>This should be closed.</di=
 v>
 <div style><br></div><div>-jgh<br clear=3D"all"><div><br></div>--<br>Jason =
 Helfman=A0=A0=A0=A0=A0=A0 =A0=A0 | FreeBSD Committer<br>jgh@FreeBSD.org=A0=
 =A0=A0=A0 | <a href=3D"http://people.freebsd.org/%7Ejgh" target=3D"_blank">=
 http://people.freebsd.org/~jgh</a>=A0 | The Power to Serve<br>
 
 </div></div>
 
 --bcaec520f6a91f2fc504dcf5637a--
>Unformatted:
