From owner-freebsd-doc@FreeBSD.ORG Sat Nov 3 04:10:01 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A63D8459 for ; Sat, 3 Nov 2012 04:10:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 63DE88FC15 for ; Sat, 3 Nov 2012 04:10:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id qA34A1Yl012809 for ; Sat, 3 Nov 2012 04:10:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id qA34A1tT012808; Sat, 3 Nov 2012 04:10:01 GMT (envelope-from gnats) Resent-Date: Sat, 3 Nov 2012 04:10:01 GMT Resent-Message-Id: <201211030410.qA34A1tT012808@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, "Ronald F.Guilmette" Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 131F136D for ; 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 ; 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" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/173321: ports(7) man page -- no info on building with debugging info Cc: rfg@tristatelogic.com X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: "Ronald F.Guilmette" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Nov 2012 04:10:01 -0000 >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: >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: >Unformatted: