diff options
| -rw-r--r-- | doc/pkgsrc.html | 40 | ||||
| -rw-r--r-- | doc/pkgsrc.txt | 9 |
2 files changed, 28 insertions, 21 deletions
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 |