Tue Jul 24 23:44:22 2018 UTC ()
doc/pkgsrc.*: regen


(maya)
diff -r1.253 -r1.254 pkgsrc/doc/pkgsrc.html
diff -r1.249 -r1.250 pkgsrc/doc/pkgsrc.txt

cvs diff -r1.253 -r1.254 pkgsrc/doc/pkgsrc.html (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.html 2018/07/05 10:13:18 1.253
+++ pkgsrc/doc/pkgsrc.html 2018/07/24 23:44:22 1.254
@@ -3773,33 +3773,27 @@ monitor_file(...) @@ -3773,33 +3773,27 @@ monitor_file(...)
3773#if defined(HAVE_KQUEUE) 3773#if defined(HAVE_KQUEUE)
3774 int fd = kqueue(); 3774 int fd = kqueue();
3775 ... 3775 ...
3776#else 3776#else
3777 ... 3777 ...
3778#endif 3778#endif
3779} 3779}
3780</pre> 3780</pre>
3781 </td> 3781 </td>
3782</tr> 3782</tr>
3783</tbody> 3783</tbody>
3784</table></div> 3784</table></div>
3785</div> 3785</div>
3786<br class="table-break"><p>For more information, please read the <span class="emphasis"><em>Making 3786<br class="table-break">
3787 packager-friendly software</em></span> article (<a class="ulink" href="http://www.onlamp.com/pub/a/onlamp/2005/03/31/packaging.html" target="_top">part 
3788 1</a>, <a class="ulink" href="http://www.oreillynet.com/pub/a/onlamp/2005/04/28/packaging2.html" target="_top">part 
3789 2</a>). It summarizes multiple details on how to make 
3790 software easier to package; all the suggestions in it were 
3791 collected from our experience in pkgsrc work, so they are possibly 
3792 helpful when creating patches too.</p> 
3793</div> 3787</div>
3794<div class="sect2"> 3788<div class="sect2">
3795<div class="titlepage"><div><div><h3 class="title"> 3789<div class="titlepage"><div><div><h3 class="title">
3796<a name="components.patches.feedback"></a>11.3.5. Feedback to the author</h3></div></div></div> 3790<a name="components.patches.feedback"></a>11.3.5. Feedback to the author</h3></div></div></div>
3797<p>Always, always, <span class="strong"><strong>always</strong></span> 3791<p>Always, always, <span class="strong"><strong>always</strong></span>
3798 feed back any <span class="emphasis"><em>portability fixes</em></span> or 3792 feed back any <span class="emphasis"><em>portability fixes</em></span> or
3799 improvements you do to a package to the mainstream developers. 3793 improvements you do to a package to the mainstream developers.
3800 This is the only way to get their attention on portability issues 3794 This is the only way to get their attention on portability issues
3801 and to ensure that future versions can be built out-of-the box on 3795 and to ensure that future versions can be built out-of-the box on
3802 NetBSD. Furthermore, any user that gets newer distfiles will get 3796 NetBSD. Furthermore, any user that gets newer distfiles will get
3803 the fixes straight from the packaged code.</p> 3797 the fixes straight from the packaged code.</p>
3804<p>This generally involves cleaning up the patches 3798<p>This generally involves cleaning up the patches
3805 (because sometimes the patches that are 3799 (because sometimes the patches that are
@@ -8829,27 +8823,27 @@ place.

 @@ -8829,27 +8823,27 @@ place.

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

 @@ -8874,157 +8868,157 @@ place.

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

cvs diff -r1.249 -r1.250 pkgsrc/doc/pkgsrc.txt (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.txt 2018/07/05 10:05:17 1.249
+++ pkgsrc/doc/pkgsrc.txt 2018/07/24 23:44:22 1.250
@@ -3192,31 +3192,26 @@ Table 11.1. Patching examples @@ -3192,31 +3192,26 @@ Table 11.1. Patching examples
3192| |int |int | 3192| |int |int |
3193| |monitor_file(...) |monitor_file(...) | 3193| |monitor_file(...) |monitor_file(...) |
3194| |{ |{ | 3194| |{ |{ |
3195| |#if defined(__NetBSD__) |#if defined(HAVE_KQUEUE) | 3195| |#if defined(__NetBSD__) |#if defined(HAVE_KQUEUE) |
3196|C source | int fd = kqueue();| int fd = kqueue(); | 3196|C source | int fd = kqueue();| int fd = kqueue(); |
3197|file | ... | ... | 3197|file | ... | ... |
3198| |#else |#else | 3198| |#else |#else |
3199| | ... | ... | 3199| | ... | ... |
3200| |#endif |#endif | 3200| |#endif |#endif |
3201| |} |} | 3201| |} |} |
3202+-------------------------------------------------------------------------------------------+ 3202+-------------------------------------------------------------------------------------------+
3203 3203
3204 3204
3205For more information, please read the Making packager-friendly software article 
3206(part 1, part 2). It summarizes multiple details on how to make software easier 
3207to package; all the suggestions in it were collected from our experience in 
3208pkgsrc work, so they are possibly helpful when creating patches too. 
3209 
321011.3.5. Feedback to the author 320511.3.5. Feedback to the author
3211 3206
3212Always, always, always feed back any portability fixes or improvements you do 3207Always, always, always feed back any portability fixes or improvements you do
3213to a package to the mainstream developers. This is the only way to get their 3208to a package to the mainstream developers. This is the only way to get their
3214attention on portability issues and to ensure that future versions can be built 3209attention on portability issues and to ensure that future versions can be built
3215out-of-the box on NetBSD. Furthermore, any user that gets newer distfiles will 3210out-of-the box on NetBSD. Furthermore, any user that gets newer distfiles will
3216get the fixes straight from the packaged code. 3211get the fixes straight from the packaged code.
3217 3212
3218This generally involves cleaning up the patches (because sometimes the patches 3213This generally involves cleaning up the patches (because sometimes the patches
3219that are added to pkgsrc are quick hacks), filing bug reports in the 3214that are added to pkgsrc are quick hacks), filing bug reports in the
3220appropriate trackers for the projects and working with the mainstream authors 3215appropriate trackers for the projects and working with the mainstream authors
3221to accept your changes. It is extremely important that you do it so that the 3216to accept your changes. It is extremely important that you do it so that the
3222packages in pkgsrc are kept simple and thus further changes can be done without 3217packages in pkgsrc are kept simple and thus further changes can be done without