docs/151953: [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes

[Sunpoet Po-Chuan Hsieh]

>Number:         151953
>Category:       docs
>Synopsis:       [PATCH] Porter's Handbook: document INSTALL_LIB and minor fixes
>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:   Fri Nov 05 01:40:08 UTC 2010
>Closed-Date:
>Last-Modified:
>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 at 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:
>Unformatted: