From owner-freebsd-doc Fri Oct 25 11:13:56 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 EC81F37B401; Fri, 25 Oct 2002 11:13:53 -0700 (PDT) Received: from vectors.cx (manifold.vectors.cx [64.163.147.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6D8FB43E75; Fri, 25 Oct 2002 11:13:53 -0700 (PDT) (envelope-from monkey@vectors.cx) Received: from vectors.cx (1d903bebbb07e63f5d8920b867d4c83a@localhost [127.0.0.1]) by vectors.cx (8.12.6/8.12.4) with ESMTP id g9PIFWho077301; Fri, 25 Oct 2002 11:15:32 -0700 (PDT) (envelope-from monkey@vectors.cx) Received: (from monkey@localhost) by vectors.cx (8.12.6/8.12.6/Submit) id g9PIFWVd077300; Fri, 25 Oct 2002 11:15:32 -0700 (PDT) (envelope-from monkey) Date: Fri, 25 Oct 2002 11:15:32 -0700 From: Adam Weinberger To: Ceri Davies Cc: Tom Hukins , freebsd-doc@FreeBSD.ORG Subject: Re: docs/44396: Section 15.1 of the Porter's Handbook is no longer applicable Message-ID: <20021025181532.GR70503@vectors.cx> References: <200210242100.g9OL0AGV025120@freefall.freebsd.org> <20021025103619.GM70503@vectors.cx> <20021025104615.GB7415@submonkey.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20021025104615.GB7415@submonkey.net> 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 >> (10.25.2002 @ 0346 PST): Ceri Davies said, in 2.0K: << > Can you tell mutt not to wrap and post this again? It's hard to read. > > This indentation doesn't look consistent with the stuff you've removed. > That might be down to the line wrap again though. > > Also, you have contraction in there : "Don't". > These are generally to be avoided, so could you change that to "Do not" ? > > s/bnary/binary/ > > s/don't/do not/ again. >> end of "Re: docs/44396: Section 15.1 of the Porter's Handbook is no longer applicable" from Ceri Davies << Hrmmn... the bottle said, "Do not operate a car or heavy machinery." It should have added "or Vi" to that. Thanks for being so on-the-ball, guys! Let's try this again. Sorry, folks ::) -Adam =================================================================== 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 18:08:20 -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: + Do not strip binaries manually unless you have to. All binaries + should be stripped, but the INSTALL_PROGRAM + macro will install and strip a binary at the same time (see the next + section). + + If you need to strip a file, but do not 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 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message