From sunpoet@sunpoet.net  Fri Nov  5 01:33:09 2010
Return-Path: <sunpoet@sunpoet.net>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id BAE01106566B
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  5 Nov 2010 01:33:09 +0000 (UTC)
	(envelope-from sunpoet@sunpoet.net)
Received: from mail-gx0-f182.google.com (mail-gx0-f182.google.com [209.85.161.182])
	by mx1.freebsd.org (Postfix) with ESMTP id 7F1B38FC1F
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  5 Nov 2010 01:33:09 +0000 (UTC)
Received: by gxk9 with SMTP id 9so1977186gxk.13
        for <FreeBSD-gnats-submit@freebsd.org>; Thu, 04 Nov 2010 18:33:08 -0700 (PDT)
Received: by 10.150.158.16 with SMTP id g16mr2439892ybe.242.1288920787897;
        Thu, 04 Nov 2010 18:33:07 -0700 (PDT)
Received: from sunpoet.net (sunpoet.net [220.133.12.240])
        by mx.google.com with ESMTPS id q4sm2060737yba.2.2010.11.04.18.33.05
        (version=TLSv1/SSLv3 cipher=RC4-MD5);
        Thu, 04 Nov 2010 18:33:06 -0700 (PDT)
Received: by sunpoet.net (Postfix, from userid 1000)
	id 548B22AEC8F5; Fri,  5 Nov 2010 09:32:41 +0800 (CST)
Message-Id: <20101105013241.548B22AEC8F5@sunpoet.net>
Date: Fri,  5 Nov 2010 09:32:41 +0800 (CST)
From: Sunpoet Po-Chuan Hsieh <sunpoet@sunpoet.net>
Reply-To: Sunpoet Po-Chuan Hsieh <sunpoet@sunpoet.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes 
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         151953
>Category:       docs
>Synopsis:       [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jkois
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Nov 05 01:40:08 UTC 2010
>Closed-Date:    Wed Nov 24 22:24:09 UTC 2010
>Last-Modified:  Wed Nov 24 22:24:09 UTC 2010
>Originator:     Sunpoet Po-Chuan Hsieh
>Release:        FreeBSD 8.1-STABLE amd64
>Organization:
SUNPOET.net
>Environment:
System: FreeBSD bonjour.sunpoet.net 8.1-STABLE FreeBSD 8.1-STABLE #0: Sat Oct 23 16:01:16 CST 2010 sunpoet@bonjour.sunpoet.net:/usr/obj/usr/src/sys/bonjour amd64
	
>Description:
Changes for Porter's Handbook:
- Document INSTALL_LIB
- Use proper tags for INSTALL_PROGRAM and post-install
	
>How-To-Repeat:
	
>Fix:
--- book.sgml.patch begins here ---
Index: book.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.1077
diff -u -r1.1077 book.sgml
--- book.sgml	4 Oct 2010 01:23:59 -0000	1.1077
+++ book.sgml	4 Nov 2010 16:49:35 -0000
@@ -4106,6 +4106,11 @@
 	  </listitem>
 
 	  <listitem>
+	    <para><makevar>INSTALL_LIB</makevar> is a command to install
+	      shared libraries.</para>
+	  </listitem>
+
+	  <listitem>
 	    <para><makevar>INSTALL_KLD</makevar> is a command to install
 	      kernel loadable modules. Some architectures don't like it when
 	      the modules are stripped, therefor use this command instead
@@ -4129,18 +4134,19 @@
       </sect2>
 
       <sect2 id="install-strip">
-	<title>Stripping Binaries</title>
+	<title>Stripping binaries and shared libraries</title>
 
 	<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_CMD}</makevar> will strip your program.  This is
-	  typically done within the <literal>post-install</literal>
-	  target.  For example:</para>
+	  should be stripped, but the <makevar>INSTALL_PROGRAM</makevar> macro
+	  will install and strip a binary at the same time (see the next
+	  section). The <makevar>INSTALL_LIB</makevar> macro does the same thing
+	  to shared libraries.</para>
+
+	<para>If you need to strip a file, but wish to use neither
+	  <makevar>INSTALL_PROGRAM</makevar> nor <makevar>INSTALL_LIB</makevar>
+	  macros, <makevar>${STRIP_CMD}</makevar> will strip your program or
+	  shared library.  This is typically done within the
+	  <maketarget>post-install</maketarget> target.  For example:</para>
 
 	<programlisting>post-install:
 	${STRIP_CMD} ${PREFIX}/bin/xdl</programlisting>
--- book.sgml.patch ends here ---
	


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->jkois 
Responsible-Changed-By: jkois 
Responsible-Changed-When: Mon Nov 22 13:22:24 UTC 2010 
Responsible-Changed-Why:  
Take. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=151953 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/151953: commit references a PR
Date: Mon, 22 Nov 2010 18:31:02 +0000 (UTC)

 jkois       2010-11-22 18:30:50 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/porters-handbook book.sgml 
   Log:
   PR:     docs/151953
   
   Changes for Porter's Handbook:
   - Document INSTALL_LIB
   - Use proper tags for INSTALL_PROGRAM and post-install
   
   Patch provided by:      Sunpoet Po-Chuan Hsieh (sunpoet att sunpoet dott net)
   Discussed with:         decke@
   
   Revision  Changes    Path
   1.1082    +16 -10    doc/en_US.ISO8859-1/books/porters-handbook/book.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: jkois 
State-Changed-When: Wed Nov 24 22:23:02 UTC 2010 
State-Changed-Why:  
Porters-handbook has been modified.   Close this PR. 


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