Thu Sep 28 07:36:29 2017 UTC ()
regen


(leot)
diff -r1.246 -r1.247 pkgsrc/doc/pkgsrc.html

cvs diff -r1.246 -r1.247 pkgsrc/doc/pkgsrc.html (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.html 2017/09/27 15:43:38 1.246
+++ pkgsrc/doc/pkgsrc.html 2017/09/28 07:36:28 1.247
@@ -8830,27 +8830,27 @@ place.

 @@ -8830,27 +8830,27 @@ place.

8830</li> 8830</li>
8831</ol></div> 8831</ol></div>
8832</div> 8832</div>
8833</div> 8833</div>
8834<div class="chapter"> 8834<div class="chapter">
8835<div class="titlepage"><div><div><h2 class="title"> 8835<div class="titlepage"><div><div><h2 class="title">
8836<a name="devfaq"></a>Chapter 22. Frequently Asked Questions</h2></div></div></div> 8836<a name="devfaq"></a>Chapter 22. Frequently Asked Questions</h2></div></div></div>
8837<p>This section contains the answers to questions that may 8837<p>This section contains the answers to questions that may
8838 arise when you are writing a package. If you don't find your 8838 arise when you are writing a package. If you don't find your
8839 question answered here, first have a look in the other chapters, 8839 question answered here, first have a look in the other chapters,
8840 and if you still don't have the answer, ask on the 8840 and if you still don't have the answer, ask on the
8841 <code class="literal">pkgsrc-users</code> mailing list.</p> 8841 <code class="literal">pkgsrc-users</code> mailing list.</p>
8842<div class="qandaset"> 8842<div class="qandaset">
8843<a name="idm79766320"></a><dl> 8843<a name="idm79242032"></a><dl>
8844<dt>22.1. <a href="#devfaq.makeflags">What is the difference between 8844<dt>22.1. <a href="#devfaq.makeflags">What is the difference between
8845 MAKEFLAGS, .MAKEFLAGS and 8845 MAKEFLAGS, .MAKEFLAGS and
8846 MAKE_FLAGS?</a> 8846 MAKE_FLAGS?</a>
8847</dt> 8847</dt>
8848<dt>22.2. <a href="#devfaq.make">What is the difference between 8848<dt>22.2. <a href="#devfaq.make">What is the difference between
8849 MAKE, GMAKE and 8849 MAKE, GMAKE and
8850 MAKE_PROGRAM?</a> 8850 MAKE_PROGRAM?</a>
8851</dt> 8851</dt>
8852<dt>22.3. <a href="#devfaq.cc">What is the difference between 8852<dt>22.3. <a href="#devfaq.cc">What is the difference between
8853 CC, PKG_CC and 8853 CC, PKG_CC and
8854 PKGSRC_COMPILER?</a> 8854 PKGSRC_COMPILER?</a>
8855</dt> 8855</dt>
8856<dt>22.4. <a href="#devfaq.bl3flags">What is the difference between 8856<dt>22.4. <a href="#devfaq.bl3flags">What is the difference between
@@ -8875,157 +8875,157 @@ place.

 @@ -8875,157 +8875,157 @@ place.

8875</dt> 8875</dt>
8876<dt>22.9. <a href="#devfaq.too-much-time">I have a little time to kill. What shall I 8876<dt>22.9. <a href="#devfaq.too-much-time">I have a little time to kill. What shall I
8877do?</a> 8877do?</a>
8878</dt> 8878</dt>
8879</dl> 8879</dl>
8880<table border="0" style="width: 100%;"> 8880<table border="0" style="width: 100%;">
8881<colgroup> 8881<colgroup>
8882<col align="left" width="1%"> 8882<col align="left" width="1%">
8883<col> 8883<col>
8884</colgroup> 8884</colgroup>
8885<tbody> 8885<tbody>
8886<tr class="question"> 8886<tr class="question">
8887<td align="left" valign="top"> 8887<td align="left" valign="top">
8888<a name="devfaq.makeflags"></a><a name="idm79765936"></a><p><b>22.1.</b></p> 8888<a name="devfaq.makeflags"></a><a name="idm79241648"></a><p><b>22.1.</b></p>
8889</td> 8889</td>
8890<td align="left" valign="top"><p>What is the difference between 8890<td align="left" valign="top"><p>What is the difference between
8891 <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and 8891 <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and
8892 <code class="varname">MAKE_FLAGS</code>?</p></td> 8892 <code class="varname">MAKE_FLAGS</code>?</p></td>
8893</tr> 8893</tr>
8894<tr class="answer"> 8894<tr class="answer">
8895<td align="left" valign="top"></td> 8895<td align="left" valign="top"></td>
8896<td align="left" valign="top"><p><code class="varname">MAKEFLAGS</code> are the flags passed 8896<td align="left" valign="top"><p><code class="varname">MAKEFLAGS</code> are the flags passed
8897 to the pkgsrc-internal invocations of <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-7.1"><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a>, while 8897 to the pkgsrc-internal invocations of <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-7.1"><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a>, while
8898 <code class="varname">MAKE_FLAGS</code> are the flags that are passed to 8898 <code class="varname">MAKE_FLAGS</code> are the flags that are passed to
8899 the <code class="varname">MAKE_PROGRAM</code> when building the 8899 the <code class="varname">MAKE_PROGRAM</code> when building the
8900 package. [FIXME: What is .MAKEFLAGS for?]</p></td> 8900 package. [FIXME: What is .MAKEFLAGS for?]</p></td>
8901</tr> 8901</tr>
8902<tr class="question"> 8902<tr class="question">
8903<td align="left" valign="top"> 8903<td align="left" valign="top">
8904<a name="devfaq.make"></a><a name="idm79761968"></a><p><b>22.2.</b></p> 8904<a name="devfaq.make"></a><a name="idm79237680"></a><p><b>22.2.</b></p>
8905</td> 8905</td>
8906<td align="left" valign="top"><p>What is the difference between 8906<td align="left" valign="top"><p>What is the difference between
8907 <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and 8907 <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and
8908 <code class="varname">MAKE_PROGRAM</code>?</p></td> 8908 <code class="varname">MAKE_PROGRAM</code>?</p></td>
8909</tr> 8909</tr>
8910<tr class="answer"> 8910<tr class="answer">
8911<td align="left" valign="top"></td> 8911<td align="left" valign="top"></td>
8912<td align="left" valign="top"><p><code class="varname">MAKE</code> is the path to the 8912<td align="left" valign="top"><p><code class="varname">MAKE</code> is the path to the
8913 <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-7.1"><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> program that is used in the pkgsrc 8913 <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-7.1"><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> program that is used in the pkgsrc
8914 infrastructure. <code class="varname">GMAKE</code> is the path to GNU 8914 infrastructure. <code class="varname">GMAKE</code> is the path to GNU
8915 Make, but you need to say <code class="varname">USE_TOOLS+=gmake</code> to 8915 Make, but you need to say <code class="varname">USE_TOOLS+=gmake</code> to
8916 use that. <code class="varname">MAKE_PROGRAM</code> is the path to the 8916 use that. <code class="varname">MAKE_PROGRAM</code> is the path to the
8917 Make program that is used for building the 8917 Make program that is used for building the
8918 package.</p></td> 8918 package.</p></td>
8919</tr> 8919</tr>
8920<tr class="question"> 8920<tr class="question">
8921<td align="left" valign="top"> 8921<td align="left" valign="top">
8922<a name="devfaq.cc"></a><a name="idm79757488"></a><p><b>22.3.</b></p> 8922<a name="devfaq.cc"></a><a name="idm79233200"></a><p><b>22.3.</b></p>
8923</td> 8923</td>
8924<td align="left" valign="top"><p>What is the difference between 8924<td align="left" valign="top"><p>What is the difference between
8925 <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and 8925 <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and
8926 <code class="varname">PKGSRC_COMPILER</code>?</p></td> 8926 <code class="varname">PKGSRC_COMPILER</code>?</p></td>
8927</tr> 8927</tr>
8928<tr class="answer"> 8928<tr class="answer">
8929<td align="left" valign="top"></td> 8929<td align="left" valign="top"></td>
8930<td align="left" valign="top"><p><code class="varname">CC</code> is the path to the real C 8930<td align="left" valign="top"><p><code class="varname">CC</code> is the path to the real C
8931 compiler, which can be configured by the pkgsrc user. 8931 compiler, which can be configured by the pkgsrc user.
8932 <code class="varname">PKG_CC</code> is the path to the compiler wrapper. 8932 <code class="varname">PKG_CC</code> is the path to the compiler wrapper.
8933 <code class="varname">PKGSRC_COMPILER</code> is <span class="emphasis"><em>not</em></span> a 8933 <code class="varname">PKGSRC_COMPILER</code> is <span class="emphasis"><em>not</em></span> a
8934 path to a compiler, but the type of compiler that should be 8934 path to a compiler, but the type of compiler that should be
8935 used. See <code class="filename">mk/compiler.mk</code> for more 8935 used. See <code class="filename">mk/compiler.mk</code> for more
8936 information about the latter variable.</p></td> 8936 information about the latter variable.</p></td>
8937</tr> 8937</tr>
8938<tr class="question"> 8938<tr class="question">
8939<td align="left" valign="top"> 8939<td align="left" valign="top">
8940<a name="devfaq.bl3flags"></a><a name="idm79753392"></a><p><b>22.4.</b></p> 8940<a name="devfaq.bl3flags"></a><a name="idm79229104"></a><p><b>22.4.</b></p>
8941</td> 8941</td>
8942<td align="left" valign="top"><p>What is the difference between 8942<td align="left" valign="top"><p>What is the difference between
8943 <code class="varname">BUILDLINK_LDFLAGS</code>, 8943 <code class="varname">BUILDLINK_LDFLAGS</code>,
8944 <code class="varname">BUILDLINK_LDADD</code> and 8944 <code class="varname">BUILDLINK_LDADD</code> and
8945 <code class="varname">BUILDLINK_LIBS</code>?</p></td> 8945 <code class="varname">BUILDLINK_LIBS</code>?</p></td>
8946</tr> 8946</tr>
8947<tr class="answer"> 8947<tr class="answer">
8948<td align="left" valign="top"></td> 8948<td align="left" valign="top"></td>
8949<td align="left" valign="top"><p>[FIXME]</p></td> 8949<td align="left" valign="top"><p>[FIXME]</p></td>
8950</tr> 8950</tr>
8951<tr class="question"> 8951<tr class="question">
8952<td align="left" valign="top"> 8952<td align="left" valign="top">
8953<a name="devfaq.bl3prefix"></a><a name="idm79751216"></a><p><b>22.5.</b></p> 8953<a name="devfaq.bl3prefix"></a><a name="idm79226928"></a><p><b>22.5.</b></p>
8954</td> 8954</td>
8955<td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var 8955<td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var
8956 VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span> 8956 VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span>
8957 say it's empty?</p></td> 8957 say it's empty?</p></td>
8958</tr> 8958</tr>
8959<tr class="answer"> 8959<tr class="answer">
8960<td align="left" valign="top"></td> 8960<td align="left" valign="top"></td>
8961<td align="left" valign="top"><p>For optimization reasons, some variables are only 8961<td align="left" valign="top"><p>For optimization reasons, some variables are only
8962 available in the <span class="quote">&#8220;<span class="quote">wrapper</span>&#8221;</span> phase and later. To 8962 available in the <span class="quote">&#8220;<span class="quote">wrapper</span>&#8221;</span> phase and later. To
8963 <span class="quote">&#8220;<span class="quote">simulate</span>&#8221;</span> the wrapper phase, append 8963 <span class="quote">&#8220;<span class="quote">simulate</span>&#8221;</span> the wrapper phase, append
8964 <span class="command"><strong>PKG_PHASE=wrapper</strong></span> to the above 8964 <span class="command"><strong>PKG_PHASE=wrapper</strong></span> to the above
8965 command.</p></td> 8965 command.</p></td>
8966</tr> 8966</tr>
8967<tr class="question"> 8967<tr class="question">
8968<td align="left" valign="top"> 8968<td align="left" valign="top">
8969<a name="devfaq.master_sites"></a><a name="idm79739824"></a><p><b>22.6.</b></p> 8969<a name="devfaq.master_sites"></a><a name="idm79215536"></a><p><b>22.6.</b></p>
8970</td> 8970</td>
8971<td align="left" valign="top"><p>What does 8971<td align="left" valign="top"><p>What does
8972 <code class="code">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I 8972 <code class="code">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
8973 don't understand the <code class="code">:=</code> inside 8973 don't understand the <code class="code">:=</code> inside
8974 it.</p></td> 8974 it.</p></td>
8975</tr> 8975</tr>
8976<tr class="answer"> 8976<tr class="answer">
8977<td align="left" valign="top"></td> 8977<td align="left" valign="top"></td>
8978<td align="left" valign="top"><p>The <code class="code">:=</code> is not really an 8978<td align="left" valign="top"><p>The <code class="code">:=</code> is not really an
8979 assignment operator, although it looks like it. 8979 assignment operator, although it looks like it.
8980 Instead, it is a degenerate form of 8980 Instead, it is a degenerate form of
8981 <code class="code">${LIST:<em class="replaceable"><code>old_string</code></em>=<em class="replaceable"><code>new_string</code></em>}</code>, 8981 <code class="code">${LIST:<em class="replaceable"><code>old_string</code></em>=<em class="replaceable"><code>new_string</code></em>}</code>,
8982 which is documented in the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-7.1"><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> man page and which is 8982 which is documented in the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-7.1"><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> man page and which is
8983 commonly used in the form <code class="code">${SRCS:.c=.o}</code>. In the 8983 commonly used in the form <code class="code">${SRCS:.c=.o}</code>. In the
8984 case of <code class="varname">MASTER_SITE_*</code>, 8984 case of <code class="varname">MASTER_SITE_*</code>,
8985 <em class="replaceable"><code>old_string</code></em> is the empty string and 8985 <em class="replaceable"><code>old_string</code></em> is the empty string and
8986 <em class="replaceable"><code>new_string</code></em> is 8986 <em class="replaceable"><code>new_string</code></em> is
8987 <code class="code">package/</code>. That's where the 8987 <code class="code">package/</code>. That's where the
8988 <code class="code">:</code> and the <code class="code">=</code> fall 8988 <code class="code">:</code> and the <code class="code">=</code> fall
8989 together.</p></td> 8989 together.</p></td>
8990</tr> 8990</tr>
8991<tr class="question"> 8991<tr class="question">
8992<td align="left" valign="top"> 8992<td align="left" valign="top">
8993<a name="devfaq.mailinglists"></a><a name="idm79732912"></a><p><b>22.7.</b></p> 8993<a name="devfaq.mailinglists"></a><a name="idm79208624"></a><p><b>22.7.</b></p>
8994</td> 8994</td>
8995<td align="left" valign="top"><p>Which mailing lists are there for package 8995<td align="left" valign="top"><p>Which mailing lists are there for package
8996 developers?</p></td> 8996 developers?</p></td>
8997</tr> 8997</tr>
8998<tr class="answer"> 8998<tr class="answer">
8999<td align="left" valign="top"></td> 8999<td align="left" valign="top"></td>
9000<td align="left" valign="top"><div class="variablelist"><dl class="variablelist"> 9000<td align="left" valign="top"><div class="variablelist"><dl class="variablelist">
9001<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#tech-pkg" target="_top">tech-pkg</a></span></dt> 9001<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#tech-pkg" target="_top">tech-pkg</a></span></dt>
9002<dd><p>This is a list for technical discussions related 9002<dd><p>This is a list for technical discussions related
9003 to pkgsrc development, e.g. soliciting feedback for changes to 9003 to pkgsrc development, e.g. soliciting feedback for changes to
9004 pkgsrc infrastructure, proposed new features, questions related 9004 pkgsrc infrastructure, proposed new features, questions related
9005 to porting pkgsrc to a new platform, advice for maintaining a 9005 to porting pkgsrc to a new platform, advice for maintaining a
9006 package, patches that affect many packages, help requests moved 9006 package, patches that affect many packages, help requests moved
9007 from pkgsrc-users when an infrastructure bug is found, 9007 from pkgsrc-users when an infrastructure bug is found,
9008 etc.</p></dd> 9008 etc.</p></dd>
9009<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#pkgsrc-bugs" target="_top">pkgsrc-bugs</a></span></dt> 9009<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#pkgsrc-bugs" target="_top">pkgsrc-bugs</a></span></dt>
9010<dd><p>All bug reports in category "pkg" sent with 9010<dd><p>All bug reports in category "pkg" sent with
9011 <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?send-pr+1.i386+NetBSD-7.1"><span class="citerefentry"><span class="refentrytitle">send-pr</span>(1)</span></a> appear here. Please do not report your bugs here 9011 <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?send-pr+1.i386+NetBSD-7.1"><span class="citerefentry"><span class="refentrytitle">send-pr</span>(1)</span></a> appear here. Please do not report your bugs here
9012 directly; use one of the other mailing 9012 directly; use one of the other mailing
9013 lists.</p></dd> 9013 lists.</p></dd>
9014</dl></div></td> 9014</dl></div></td>
9015</tr> 9015</tr>
9016<tr class="question"> 9016<tr class="question">
9017<td align="left" valign="top"> 9017<td align="left" valign="top">
9018<a name="devfaq.documentation"></a><a name="idm79729200"></a><p><b>22.8.</b></p> 9018<a name="devfaq.documentation"></a><a name="idm79204912"></a><p><b>22.8.</b></p>
9019</td> 9019</td>
9020<td align="left" valign="top"><p>Where is the pkgsrc 9020<td align="left" valign="top"><p>Where is the pkgsrc
9021 documentation?</p></td> 9021 documentation?</p></td>
9022</tr> 9022</tr>
9023<tr class="answer"> 9023<tr class="answer">
9024<td align="left" valign="top"></td> 9024<td align="left" valign="top"></td>
9025<td align="left" valign="top"> 9025<td align="left" valign="top">
9026<p>There are many places where you can find 9026<p>There are many places where you can find
9027 documentation about pkgsrc:</p> 9027 documentation about pkgsrc:</p>
9028<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 9028<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
9029<li class="listitem"><p>The pkgsrc guide (this document) is a collection 9029<li class="listitem"><p>The pkgsrc guide (this document) is a collection
9030 of chapters that explain large parts of pkgsrc, but some 9030 of chapters that explain large parts of pkgsrc, but some
9031 chapters tend to be outdated. Which ones they are is hard to 9031 chapters tend to be outdated. Which ones they are is hard to
@@ -9053,27 +9053,27 @@ do? @@ -9053,27 +9053,27 @@ do?
9053 documented</span>&#8221;</span>, that is the documentation exists only in the 9053 documented</span>&#8221;</span>, that is the documentation exists only in the
9054 mind of the developer who wrote the code. To get this 9054 mind of the developer who wrote the code. To get this
9055 information, use the <span class="command"><strong>cvs annotate</strong></span> command 9055 information, use the <span class="command"><strong>cvs annotate</strong></span> command
9056 to see who has written it and ask on the 9056 to see who has written it and ask on the
9057 <code class="literal">tech-pkg</code> mailing list, so that others can 9057 <code class="literal">tech-pkg</code> mailing list, so that others can
9058 find your questions later (see above). To be sure that the 9058 find your questions later (see above). To be sure that the
9059 developer in charge reads the mail, you may CC him or 9059 developer in charge reads the mail, you may CC him or
9060 her.</p></li> 9060 her.</p></li>
9061</ul></div> 9061</ul></div>
9062</td> 9062</td>
9063</tr> 9063</tr>
9064<tr class="question"> 9064<tr class="question">
9065<td align="left" valign="top"> 9065<td align="left" valign="top">
9066<a name="devfaq.too-much-time"></a><a name="idm79722672"></a><p><b>22.9.</b></p> 9066<a name="devfaq.too-much-time"></a><a name="idm79198384"></a><p><b>22.9.</b></p>
9067</td> 9067</td>
9068<td align="left" valign="top"><p>I have a little time to kill. What shall I 9068<td align="left" valign="top"><p>I have a little time to kill. What shall I
9069do?</p></td> 9069do?</p></td>
9070</tr> 9070</tr>
9071<tr class="answer"> 9071<tr class="answer">
9072<td align="left" valign="top"></td> 9072<td align="left" valign="top"></td>
9073<td align="left" valign="top"> 9073<td align="left" valign="top">
9074<p>This is not really an FAQ yet, but here's the answer 9074<p>This is not really an FAQ yet, but here's the answer
9075anyway.</p> 9075anyway.</p>
9076<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 9076<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
9077<li class="listitem"><p>Run <span class="command"><strong>pkg_chk -N</strong></span> (from the 9077<li class="listitem"><p>Run <span class="command"><strong>pkg_chk -N</strong></span> (from the
9078 <a href="http://cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/pkgtools/pkg_chk/README.html" target="_top"><code class="filename">pkgtools/pkg_chk</code></a> package). It 9078 <a href="http://cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/pkgtools/pkg_chk/README.html" target="_top"><code class="filename">pkgtools/pkg_chk</code></a> package). It
9079 will tell you about newer versions of installed packages that are 9079 will tell you about newer versions of installed packages that are