svn commit: r45713 - head/en_US.ISO8859-1/books/porters-handbook/special

[Mathieu Arnold]

Author: mat (ports committer)
Date: Fri Oct  3 17:05:29 2014
New Revision: 45713
URL: https://svnweb.freebsd.org/changeset/doc/45713

Log:
  Document BUNDLE_LIBS.
  
  Differential Revision:	https://reviews.freebsd.org/D887
  Reviewed by:	bcr, bapt
  Sponsored by:	Absolight

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Fri Oct  3 02:09:54 2014	(r45712)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Fri Oct  3 17:05:29 2014	(r45713)
@@ -222,6 +222,18 @@
       <para>Only use bundled libraries if the upstream has a
 	good track record on security and using unbundled versions
 	leads to overly complex patches.</para>
+
+      <note>
+	<para>In some very special cases, for example emulators, like
+	  <application>Wine</application>, a port has to bundle
+	  libraries, because they are in a different architecture, or
+	  they have been modified to fit the software's use.  In that
+	  case, those libraries should not be exposed to other ports
+	  for linking.  Add <literal>BUNDLE_LIBS=yes</literal> to the
+	  port's <filename>Makefile</filename>.  This will tell
+	  &man.pkg.8; to not compute provided libraries.  Always ask
+	  the &a.portmgr; before adding this to a port.</para>
+      </note>
     </sect2>
   </sect1>