From 7410c65b8f5284064e5419efe2e553337c83395a Mon Sep 17 00:00:00 2001
From: Mathieu Arnold <mat@FreeBSD.org>
Date: Fri, 3 Oct 2014 17:05:29 +0000
Subject: [PATCH] Document BUNDLE_LIBS.

Differential Revision:	https://reviews.freebsd.org/D887
Reviewed by:	bcr, bapt
Sponsored by:	Absolight
---
 .../books/porters-handbook/special/chapter.xml       | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
index 7c4bce5294..f6cc9e1239 100644
--- a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -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>