Date: Fri, 25 Oct 2002 11:15:32 -0700 From: Adam Weinberger <adamw@FreeBSD.ORG> To: Ceri Davies <setantae@submonkey.net> Cc: Tom Hukins <tom@FreeBSD.ORG>, 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> In-Reply-To: <20021025104615.GB7415@submonkey.net> References: <200210242100.g9OL0AGV025120@freefall.freebsd.org> <20021025103619.GM70503@vectors.cx> <20021025104615.GB7415@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
>> (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.</para>
<sect1>
- <title>Strip Binaries</title>
+ <title>Stripping Binaries</title>
- <para>Do strip binaries. If the original source already strips the
- binaries, fine; otherwise you should add a
- <literal>post-install</literal> rule to it yourself. Here is an
- example:</para>
+ <para>Do not strip binaries manually unless you have to. All binaries
+ should be stripped, but the <maketarget>INSTALL_PROGRAM</maketarget>
+ macro will install and strip a binary at the same time (see the next
+ section).</para>
+
+ <para>If you need to strip a file, but do not wish to use the
+ <makevar>INSTALL_PROGRAM</makevar> macro,
+ <makevar>${STRIP}</makevar> will strip your program. This is
+ typically done within the <literal>post-install</literal>
+ target. For example:</para>
<programlisting>post-install:
- strip ${PREFIX}/bin/xdl</programlisting>
+ ${STRIP} ${PREFIX}/bin/xdl</programlisting>
<para>Use the &man.file.1; command on the installed executable to
check whether the binary is stripped or not. If it does not say
- <literal>not stripped</literal>, it is stripped.</para>
+ <literal>not stripped</literal>, it is stripped. Additionally,
+ &man.strip.1; will not strip a previously stripped program; it
+ will instead exit cleanly.</para>
</sect1>
<sect1>
--
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021025181532.GR70503>