From 90947fa05098be2462d8e974f49d4d5001751ff3 Mon Sep 17 00:00:00 2001
From: wiz <wiz@pkgsrc.org>
Date: Sun, 21 Apr 2013 12:44:35 +0000
Subject: regen

---
 doc/pkgsrc.html | 40 ++++++++++++++++++++++------------------
 doc/pkgsrc.txt  |  9 ++++++---
 2 files changed, 28 insertions(+), 21 deletions(-)

(limited to 'doc')

diff --git a/doc/pkgsrc.html b/doc/pkgsrc.html
index eee28728db1..ff66278ad1e 100644
--- a/doc/pkgsrc.html
+++ b/doc/pkgsrc.html
@@ -5680,13 +5680,17 @@ BUILDLINK_TREE+=	-tiff
       <code class="filename">buildlink3.mk</code> file needs to be included:
       </p>
 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
-<li class="listitem"><p>Run <code class="filename">ldd</code> on all installed
-	libraries and look against what other libraries they link. The
-	packages providing these must be
-	buildlinked.</p></li>
 <li class="listitem"><p>Look at the installed header files: What
 	headers do they include? The packages providing these files
 	must be buildlinked.</p></li>
+<li class="listitem"><p>Run <code class="filename">ldd</code> on all installed
+	libraries and look against what other libraries they link.
+	Some of the packages providing these probably need to be
+	buildlinked; however, it's not automatic, since e.g. GTK on
+	some systems pulls in the X libraries, so they will show up in
+	the <code class="filename">ldd</code> output, while on others (like OS
+	X) it won't. <code class="filename">ldd</code>output can thus only be
+	used as a hint.</p></li>
 </ul></div>
 <p>
       </p>
@@ -7638,7 +7642,7 @@ TOOLS_PLATFORM.true?=           true                    # shell builtin
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
 <a name="tools.questions"></a>18.4. Questions regarding the tools</h2></div></div></div>
 <div class="qandaset">
-<a name="idm88328368"></a><dl>
+<a name="idm76274256"></a><dl>
 <dt>18.4.1. <a href="#tools.new">How do I add a new tool?</a>
 </dt>
 <dt>18.4.2. <a href="#tools.listall">How do I get a list of all available
@@ -7657,7 +7661,7 @@ TOOLS_PLATFORM.true?=           true                    # shell builtin
 <tbody>
 <tr class="question">
 <td align="left" valign="top">
-<a name="tools.new"></a><a name="idm88327984"></a><p><b>18.4.1.</b></p>
+<a name="tools.new"></a><a name="idm76273872"></a><p><b>18.4.1.</b></p>
 </td>
 <td align="left" valign="top"><p>How do I add a new tool?</p></td>
 </tr>
@@ -7667,7 +7671,7 @@ TOOLS_PLATFORM.true?=           true                    # shell builtin
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="tools.listall"></a><a name="idm88326832"></a><p><b>18.4.2.</b></p>
+<a name="tools.listall"></a><a name="idm76272848"></a><p><b>18.4.2.</b></p>
 </td>
 <td align="left" valign="top"><p>How do I get a list of all available
 	tools?</p></td>
@@ -7678,7 +7682,7 @@ TOOLS_PLATFORM.true?=           true                    # shell builtin
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="tools.used"></a><a name="idm88325808"></a><p><b>18.4.3.</b></p>
+<a name="tools.used"></a><a name="idm76271824"></a><p><b>18.4.3.</b></p>
 </td>
 <td align="left" valign="top"><p>How can I get a list of all the tools that a
 	package is using while being built? I want to know whether it
@@ -9725,7 +9729,7 @@ place.</p></li>
 	and if you still don't have the answer, ask on the
 	<code class="literal">pkgsrc-users</code> mailing list.</p>
 <div class="qandaset">
-<a name="idm87777968"></a><dl>
+<a name="idm77808848"></a><dl>
 <dt>22.1. <a href="#devfaq.makeflags">What is the difference between
 	MAKEFLAGS, .MAKEFLAGS and
 	MAKE_FLAGS?</a>
@@ -9770,7 +9774,7 @@ do?</a>
 <tbody>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.makeflags"></a><a name="idm87777584"></a><p><b>22.1.</b></p>
+<a name="devfaq.makeflags"></a><a name="idm77808464"></a><p><b>22.1.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
 	<code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and
@@ -9786,7 +9790,7 @@ do?</a>
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.make"></a><a name="idm87773616"></a><p><b>22.2.</b></p>
+<a name="devfaq.make"></a><a name="idm77804496"></a><p><b>22.2.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
 	<code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and
@@ -9804,7 +9808,7 @@ do?</a>
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.cc"></a><a name="idm87769136"></a><p><b>22.3.</b></p>
+<a name="devfaq.cc"></a><a name="idm77800016"></a><p><b>22.3.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
 	<code class="varname">CC</code>, <code class="varname">PKG_CC</code> and
@@ -9822,7 +9826,7 @@ do?</a>
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.bl3flags"></a><a name="idm87765040"></a><p><b>22.4.</b></p>
+<a name="devfaq.bl3flags"></a><a name="idm77795920"></a><p><b>22.4.</b></p>
 </td>
 <td align="left" valign="top"><p>What is the difference between
 	<code class="varname">BUILDLINK_LDFLAGS</code>,
@@ -9835,7 +9839,7 @@ do?</a>
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.bl3prefix"></a><a name="idm87762864"></a><p><b>22.5.</b></p>
+<a name="devfaq.bl3prefix"></a><a name="idm77793616"></a><p><b>22.5.</b></p>
 </td>
 <td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var
 	VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span>
@@ -9851,7 +9855,7 @@ do?</a>
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.master_sites"></a><a name="idm87759664"></a><p><b>22.6.</b></p>
+<a name="devfaq.master_sites"></a><a name="idm77790544"></a><p><b>22.6.</b></p>
 </td>
 <td align="left" valign="top"><p>What does
 	<code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
@@ -9875,7 +9879,7 @@ do?</a>
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.mailinglists"></a><a name="idm87751600"></a><p><b>22.7.</b></p>
+<a name="devfaq.mailinglists"></a><a name="idm77782480"></a><p><b>22.7.</b></p>
 </td>
 <td align="left" valign="top"><p>Which mailing lists are there for package
 	developers?</p></td>
@@ -9900,7 +9904,7 @@ do?</a>
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.documentation"></a><a name="idm87747888"></a><p><b>22.8.</b></p>
+<a name="devfaq.documentation"></a><a name="idm77778768"></a><p><b>22.8.</b></p>
 </td>
 <td align="left" valign="top"><p>Where is the pkgsrc
 	documentation?</p></td>
@@ -9948,7 +9952,7 @@ do?</a>
 </tr>
 <tr class="question">
 <td align="left" valign="top">
-<a name="devfaq.too-much-time"></a><a name="idm87741360"></a><p><b>22.9.</b></p>
+<a name="devfaq.too-much-time"></a><a name="idm77772240"></a><p><b>22.9.</b></p>
 </td>
 <td align="left" valign="top"><p>I have a little time to kill.  What shall I
 do?</p></td>
diff --git a/doc/pkgsrc.txt b/doc/pkgsrc.txt
index fdeb439c29d..c16fbca01a8 100644
--- a/doc/pkgsrc.txt
+++ b/doc/pkgsrc.txt
@@ -4834,12 +4834,15 @@ that library does not need to be propagated in the buildlink3.mk file.
 The following steps should help you decide if a buildlink3.mk file needs to be
 included:
 
-  * Run ldd on all installed libraries and look against what other libraries
-    they link. The packages providing these must be buildlinked.
-
   * Look at the installed header files: What headers do they include? The
     packages providing these files must be buildlinked.
 
+  * Run ldd on all installed libraries and look against what other libraries
+    they link. Some of the packages providing these probably need to be
+    buildlinked; however, it's not automatic, since e.g. GTK on some systems
+    pulls in the X libraries, so they will show up in the ldd output, while on
+    others (like OS X) it won't. lddoutput can thus only be used as a hint.
+
 14.2.2. Updating BUILDLINK_API_DEPENDS.pkg and BUILDLINK_ABI_DEPENDS.pkg in
 buildlink3.mk files
 
-- 
cgit v1.2.3