From ecu@shiva.bouglou.net  Fri Oct 25 08:58:26 2002
Return-Path: <ecu@shiva.bouglou.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4803337B401
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 25 Oct 2002 08:58:26 -0700 (PDT)
Received: from shiva.bouglou.net (shiva.bouglou.net [62.4.22.68])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9760E43E4A
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 25 Oct 2002 08:58:25 -0700 (PDT)
	(envelope-from ecu@shiva.bouglou.net)
Received: by shiva.bouglou.net (Postfix, from userid 1000)
	id E22BC15435; Fri, 25 Oct 2002 17:58:23 +0200 (CEST)
Message-Id: <20021025155823.E22BC15435@shiva.bouglou.net>
Date: Fri, 25 Oct 2002 17:58:23 +0200 (CEST)
From: Nicolas Jombart <Nicolas.Jombart@hsc-labs.com>
Reply-To: Nicolas Jombart <Nicolas.Jombart@hsc-labs.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Porter's handbook and binary stripping
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         44465
>Category:       docs
>Synopsis:       Porter's handbook and binary stripping
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    adamw
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Oct 25 09:00:06 PDT 2002
>Closed-Date:    Fri Oct 25 14:12:13 PDT 2002
>Last-Modified:  Fri Oct 25 14:12:13 PDT 2002
>Originator:     Nicolas Jombart
>Release:        FreeBSD 4.7-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD shiva.bouglou.net 4.7-PRERELEASE FreeBSD 4.7-PRERELEASE #11: Mon Sep 16 12:03:20 CEST 2002 ecu@shiva.bouglou.net:/usr/obj/usr/src/sys/SHIVA i386


	
>Description:

	Porter's handbook says in 15.1 "do strip binaries", but 
	INSTALL_PROGRAM will do it in any case via install(1).

	You can also see http://www.freebsd.org/cgi/query-pr.cgi?pr=42981


>How-To-Repeat:

	n/a

>Fix:

	The proposed fix only remove this part, but some may prefer
	a quick note that says binaries are stripped on install.

--- porters-hb.txt begins here ---
? docbook.css
Index: book.sgml
===================================================================
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
--- book.sgml	2002/10/08 04:52:43	1.248
+++ book.sgml	2002/10/25 15:42:03
@@ -3938,22 +3938,6 @@
         doing.</para>
 
       <sect1>
-        <title>Strip 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>
-
-        <programlisting>post-install:
-        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>
-      </sect1>
-
-      <sect1>
         <title>INSTALL_* macros</title>
 
         <para>Do use the macros provided in <filename>bsd.port.mk</filename>
--- porters-hb.txt ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->adamw 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Fri Oct 25 09:04:54 PDT 2002 
Responsible-Changed-Why:  
adamw is already working on this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=44465 
State-Changed-From-To: open->closed 
State-Changed-By: adamw 
State-Changed-When: Fri Oct 25 14:09:25 PDT 2002 
State-Changed-Why:  
Instead of just whacking the entire section, I updated the 
information to a more useful state. I'm not sure why I'd 
want to strip something without using the INSTALL_PROGRAM 
macro, but just in case I ever do, information on how to 
do it is available. ::) 

Thanks for submitting this PR, and bringing the issue to 
my attention in the first place! 

-Adam 

http://www.freebsd.org/cgi/query-pr.cgi?pr=44465 
>Unformatted:
