From owner-freebsd-doc Fri Oct 25 3:34:43 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8E26337B401; Fri, 25 Oct 2002 03:34:41 -0700 (PDT) Received: from vectors.cx (manifold.vectors.cx [64.163.147.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1462543E75; Fri, 25 Oct 2002 03:34:41 -0700 (PDT) (envelope-from monkey@vectors.cx) Received: from vectors.cx (329f5b78a7df194a9380c808de5de18d@localhost [127.0.0.1]) by vectors.cx (8.12.6/8.12.4) with ESMTP id g9PAaJho075730; Fri, 25 Oct 2002 03:36:19 -0700 (PDT) (envelope-from monkey@vectors.cx) Received: (from monkey@localhost) by vectors.cx (8.12.6/8.12.6/Submit) id g9PAaJuM075729; Fri, 25 Oct 2002 03:36:19 -0700 (PDT) (envelope-from monkey) Date: Fri, 25 Oct 2002 03:36:19 -0700 From: Adam Weinberger To: Tom Hukins Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/44396: Section 15.1 of the Porter's Handbook is no longer applicable Message-ID: <20021025103619.GM70503@vectors.cx> References: <200210242100.g9OL0AGV025120@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii; x-action=pgp-signed Content-Disposition: inline In-Reply-To: <200210242100.g9OL0AGV025120@freefall.freebsd.org> X-Editor: Vim 6.1 http://www.vim.org X-Mailer: Mutt 1.5 http://www.mutt.org X-PGP-Key: http://www.vectors.cx/pgp.key.txt X-URL: http://www.vectors.cx http://www.crackula.com User-Agent: Mutt/1.5.1i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 >> (10.24.2002 @ 1400 PST): Tom Hukins said, in 1.1K: << > > The section could stay around, and just become a Don't... "Don't strip > > unless you have to." > > That makes sense. What are your thoughts on this: =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.248 diff -u -r1.248 book.sgml - --- doc/en_US.ISO8859-1/books/porters-handbook/book.sgml 8 Oct 2002 04:52:43 -00001.248 +++ doc/en_US.ISO8859-1/books/porters-handbook/book.sgml 25 Oct 2002 10:32:23 -0000 @@ -3938,19 +3938,27 @@ doing. - - Strip Binaries + Stripping Binaries - - Do strip binaries. If the original source already strips the - - binaries, fine; otherwise you should add a - - post-install rule to it yourself. Here is an - - example: + Don't strip binaries manually unless you have to. All binaries + should be stripped, but the INSTALL_PROGRAM + macro will install and strip a bnary at the same time (see the next + section). + + If you need to strip a file, but don't wish to use the + INSTALL_PROGRAM macro, + ${STRIP} will strip your program. This is + typically done within the post-install + target. For example: post-install: - - strip ${PREFIX}/bin/xdl + ${STRIP} ${PREFIX}/bin/xdl Use the &man.file.1; command on the installed executable to check whether the binary is stripped or not. If it does not say - - not stripped, it is stripped. + not stripped, it is stripped. Additionally, + &man.strip.1; will not strip a previously stripped program; it + will instead exit cleanly. - -- Adam Weinberger adam@vectors.cx adamw@FreeBSD.ORG -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) iD8DBQE9uR6jo8KM2ULHQ/0RAu6FAKCqLVefJVvLD3fzo8K7CVmbEvawhQCcCQtM aOpcWLJJtGG11gcBmjG8hVE= =ijel -----END PGP SIGNATURE----- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message