Date: 9 Feb 2003 18:13:30 -0000 From: Mike Meyer <mwm@mired.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/48111: [PATCH] Porters handbook uses wrong macro for strip Message-ID: <20030209181330.16893.qmail@mired.org>
next in thread | raw e-mail | index | archive | help
>Number: 48111
>Category: docs
>Synopsis: [PATCH] Porters handbook uses wrong macro for strip
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sun Feb 09 10:20:07 PST 2003
>Closed-Date:
>Last-Modified:
>Originator: Mike Meyer
>Release: FreeBSD 4.7-STABLE i386
>Organization:
Meyer Consulting
>Environment:
System: FreeBSD guru.mired.org 4.7-STABLE FreeBSD 4.7-STABLE #17: Wed Oct 30 09:13:02 CST 2002 mwm@guru.mired.org:/sharetmp/obj/usr/src/sys/GURU i386
>Description:
The porters handbook says to use the ${STRIP} macro to strip binaries
(assuming you aren't using ${INSTALL_PROGRAM} to do it), but it
really should use $(STRIP_CMD).
>How-To-Repeat:
Read the porters handbook, and then try using it.
>Fix:
This patch fixes the porters handbook to recommend the proper macro.
--- book.sgml-orig Sun Feb 9 12:10:13 2003
+++ book.sgml Sun Feb 9 12:10:46 2003
@@ -4586,12 +4586,12 @@
<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
+ <makevar>${STRIP_CMD}</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_CMD} ${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
>Release-Note:
>Audit-Trail:
>Unformatted:
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?20030209181330.16893.qmail>