docs/186905: [PATCH] porters-handbook/makefiles/chapter.xml Stripping Binaries and Shared Libraries

[nemysis]

>Number:         186905
>Category:       docs
>Synopsis:       [PATCH] porters-handbook/makefiles/chapter.xml Stripping Binaries and Shared Libraries
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 20 01:50:00 UTC 2014
>Closed-Date:
>Last-Modified:
>Originator:     nemysis
>Release:        FreeBSD 10.0-RELEASE-p4
>Organization:
>Environment:
FreeBSD 10.0-RELEASE-p4 FreeBSD 10.0-RELEASE-p4 #0: Tue Jan 14 20:48:07 UTC 2014
>Description:
Porter's Handbook

5.15.2. Stripping Binaries and Shared Libraries

Add example for lighter stripping

>How-To-Repeat:

>Fix:
Please commit enclosed porters-handbook_makefiles_chapter.xml.diff

Patch attached with submission follows:

Index: en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	(revision 43995)
+++ en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	(working copy)
@@ -4138,6 +4138,14 @@
 	<buildtarget>post-install</buildtarget> target.  For
 	example:</para>
 
+      <para>First try to use <varname>USES</varname> macros</para>
+
+      <programlisting>
+	  MAKE_ENV= INSTALL_STRIP_FLAG=${STRIP}</programlisting>
+
+      <para>When this doesn't work, use in
+	  <buildtarget>post-install</buildtarget> target.</para>
+
       <programlisting>post-install:
 	  ${STRIP_CMD} ${STAGEDIR}${PREFIX}/bin/xdl</programlisting>
 


>Release-Note:
>Audit-Trail:
>Unformatted: