svn commit: r44926 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

[Mathieu Arnold]

Author: mat (ports committer)
Date: Fri May 23 20:29:35 2014
New Revision: 44926
URL: http://svnweb.freebsd.org/changeset/doc/44926

Log:
  Add a note hinting porters not to use INSTALL_LIB to install static libraries.
  
  PR:		docs/190146
  Submitted by:	Natacha Porté
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Fri May 23 18:32:38 2014	(r44925)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Fri May 23 20:29:35 2014	(r44926)
@@ -4361,8 +4361,8 @@ PORTVERSION=	1.0</programlisting>
 	</listitem>
 
 	<listitem>
-	  <para><varname>INSTALL_LIB</varname> is a command to
-	    install shared libraries.</para>
+	  <para><varname>INSTALL_LIB</varname> is a command to install
+	    shared libraries (but not static libraries).</para>
 	</listitem>
 
 	<listitem>
@@ -4375,7 +4375,7 @@ PORTVERSION=	1.0</programlisting>
 
 	<listitem>
 	  <para><varname>INSTALL_DATA</varname> is a command to
-	    install sharable data.</para>
+	    install sharable data, including static libraries.</para>
 	</listitem>
 
 	<listitem>
@@ -4387,6 +4387,13 @@ PORTVERSION=	1.0</programlisting>
 
       <para>These are basically the <command>install</command>
 	command with all the appropriate flags.</para>
+
+      <note>
+	<para>Do not use <varname>INSTALL_LIB</varname> to install
+	  static libraries, because stripping them render them
+	  useless.  Use <varname>INSTALL_DATA</varname>
+	  instead.</para>
+      </note>
     </sect2>
 
     <sect2 xml:id="install-strip">