Tue Oct 11 15:45:32 2016 UTC ()
regen


(sevan)
diff -r1.225 -r1.226 pkgsrc/doc/pkgsrc.html
diff -r1.225 -r1.226 pkgsrc/doc/pkgsrc.txt

cvs diff -r1.225 -r1.226 pkgsrc/doc/pkgsrc.html (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.html 2016/09/12 12:20:47 1.225
+++ pkgsrc/doc/pkgsrc.html 2016/10/11 15:45:31 1.226
@@ -777,28 +777,29 @@ minutes!

 @@ -777,28 +777,29 @@ minutes!

777<dd><p>These people are involved in all those files 777<dd><p>These people are involved in all those files
778 that live in the <code class="filename">mk/</code> directory and below. 778 that live in the <code class="filename">mk/</code> directory and below.
779 Only these people should need to read through <a class="xref" href="#infrastructure" title="Part III. The pkgsrc infrastructure internals">Part III, &#8220;The pkgsrc infrastructure internals&#8221;</a>, though others might be curious, 779 Only these people should need to read through <a class="xref" href="#infrastructure" title="Part III. The pkgsrc infrastructure internals">Part III, &#8220;The pkgsrc infrastructure internals&#8221;</a>, though others might be curious,
780 too.</p></dd> 780 too.</p></dd>
781</dl></div> 781</dl></div>
782</div> 782</div>
783</div> 783</div>
784<div class="sect1"> 784<div class="sect1">
785<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 785<div class="titlepage"><div><div><h2 class="title" style="clear: both">
786<a name="typography"></a>1.4. Typography</h2></div></div></div> 786<a name="typography"></a>1.4. Typography</h2></div></div></div>
787<p>When giving examples for commands, shell prompts are used to 787<p>When giving examples for commands, shell prompts are used to
788 show if the command should/can be issued as root, or if 788 show if the command should/can be issued as root, or if
789 <span class="quote">&#8220;<span class="quote">normal</span>&#8221;</span> user privileges are sufficient. We use a 789 <span class="quote">&#8220;<span class="quote">normal</span>&#8221;</span> user privileges are sufficient. We use a
790 <code class="prompt">#</code> for root's shell prompt, and a <code class="prompt">%</code> for users' 790 <code class="prompt">#</code> for root's shell prompt, a <code class="prompt">%</code> for users'
791 shell prompt, assuming they use the C-shell or tcsh.</p> 791 shell prompt, assuming they use the C-shell or tcsh and a <code class="prompt">$</code> for
 792 bourne shell and derivatives.</p>
792</div> 793</div>
793</div> 794</div>
794<div class="part"> 795<div class="part">
795<div class="titlepage"><div><div><h1 class="title"> 796<div class="titlepage"><div><div><h1 class="title">
796<a name="users-guide"></a>Part I. The pkgsrc user's guide</h1></div></div></div> 797<a name="users-guide"></a>Part I. The pkgsrc user's guide</h1></div></div></div>
797<div class="toc"> 798<div class="toc">
798<p><b>Table of Contents</b></p> 799<p><b>Table of Contents</b></p>
799<dl class="toc"> 800<dl class="toc">
800<dt><span class="chapter"><a href="#getting">2. Where to get pkgsrc and how to keep it up-to-date</a></span></dt> 801<dt><span class="chapter"><a href="#getting">2. Where to get pkgsrc and how to keep it up-to-date</a></span></dt>
801<dd><dl> 802<dd><dl>
802<dt><span class="sect1"><a href="#getting-first">2.1. Getting pkgsrc for the first time</a></span></dt> 803<dt><span class="sect1"><a href="#getting-first">2.1. Getting pkgsrc for the first time</a></span></dt>
803<dd><dl> 804<dd><dl>
804<dt><span class="sect2"><a href="#getting-via-tar">2.1.1. As tar archive</a></span></dt> 805<dt><span class="sect2"><a href="#getting-via-tar">2.1.1. As tar archive</a></span></dt>
@@ -8810,27 +8811,27 @@ place.

 @@ -8810,27 +8811,27 @@ place.

8810</li> 8811</li>
8811</ol></div> 8812</ol></div>
8812</div> 8813</div>
8813</div> 8814</div>
8814<div class="chapter"> 8815<div class="chapter">
8815<div class="titlepage"><div><div><h2 class="title"> 8816<div class="titlepage"><div><div><h2 class="title">
8816<a name="devfaq"></a>Chapter 22. Frequently Asked Questions</h2></div></div></div> 8817<a name="devfaq"></a>Chapter 22. Frequently Asked Questions</h2></div></div></div>
8817<p>This section contains the answers to questions that may 8818<p>This section contains the answers to questions that may
8818 arise when you are writing a package. If you don't find your 8819 arise when you are writing a package. If you don't find your
8819 question answered here, first have a look in the other chapters, 8820 question answered here, first have a look in the other chapters,
8820 and if you still don't have the answer, ask on the 8821 and if you still don't have the answer, ask on the
8821 <code class="literal">pkgsrc-users</code> mailing list.</p> 8822 <code class="literal">pkgsrc-users</code> mailing list.</p>
8822<div class="qandaset"> 8823<div class="qandaset">
8823<a name="idm80465328"></a><dl> 8824<a name="idp140233410228016"></a><dl>
8824<dt>22.1. <a href="#devfaq.makeflags">What is the difference between 8825<dt>22.1. <a href="#devfaq.makeflags">What is the difference between
8825 MAKEFLAGS, .MAKEFLAGS and 8826 MAKEFLAGS, .MAKEFLAGS and
8826 MAKE_FLAGS?</a> 8827 MAKE_FLAGS?</a>
8827</dt> 8828</dt>
8828<dt>22.2. <a href="#devfaq.make">What is the difference between 8829<dt>22.2. <a href="#devfaq.make">What is the difference between
8829 MAKE, GMAKE and 8830 MAKE, GMAKE and
8830 MAKE_PROGRAM?</a> 8831 MAKE_PROGRAM?</a>
8831</dt> 8832</dt>
8832<dt>22.3. <a href="#devfaq.cc">What is the difference between 8833<dt>22.3. <a href="#devfaq.cc">What is the difference between
8833 CC, PKG_CC and 8834 CC, PKG_CC and
8834 PKGSRC_COMPILER?</a> 8835 PKGSRC_COMPILER?</a>
8835</dt> 8836</dt>
8836<dt>22.4. <a href="#devfaq.bl3flags">What is the difference between 8837<dt>22.4. <a href="#devfaq.bl3flags">What is the difference between
@@ -8855,157 +8856,157 @@ place.

 @@ -8855,157 +8856,157 @@ place.

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

cvs diff -r1.225 -r1.226 pkgsrc/doc/pkgsrc.txt (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.txt 2016/09/12 12:20:47 1.225
+++ pkgsrc/doc/pkgsrc.txt 2016/10/11 15:45:31 1.226
@@ -661,28 +661,28 @@ package maintainers @@ -661,28 +661,28 @@ package maintainers
661 A package maintainer creates packages as described in Part II, "The pkgsrc 661 A package maintainer creates packages as described in Part II, "The pkgsrc
662 developer's guide". 662 developer's guide".
663 663
664infrastructure developers 664infrastructure developers
665 665
666 These people are involved in all those files that live in the mk/ directory 666 These people are involved in all those files that live in the mk/ directory
667 and below. Only these people should need to read through Part III, "The 667 and below. Only these people should need to read through Part III, "The
668 pkgsrc infrastructure internals", though others might be curious, too. 668 pkgsrc infrastructure internals", though others might be curious, too.
669 669
6701.4. Typography 6701.4. Typography
671 671
672When giving examples for commands, shell prompts are used to show if the 672When giving examples for commands, shell prompts are used to show if the
673command should/can be issued as root, or if "normal" user privileges are 673command should/can be issued as root, or if "normal" user privileges are
674sufficient. We use a # for root's shell prompt, and a % for users' shell 674sufficient. We use a # for root's shell prompt, a % for users' shell prompt,
675prompt, assuming they use the C-shell or tcsh. 675assuming they use the C-shell or tcsh and a $ for bourne shell and derivatives.
676 676
677Part I. The pkgsrc user's guide 677Part I. The pkgsrc user's guide
678 678
679Table of Contents 679Table of Contents
680 680
6812. Where to get pkgsrc and how to keep it up-to-date 6812. Where to get pkgsrc and how to keep it up-to-date
682 682
683 2.1. Getting pkgsrc for the first time 683 2.1. Getting pkgsrc for the first time
684 684
685 2.1.1. As tar archive 685 2.1.1. As tar archive
686 2.1.2. Via anonymous CVS 686 2.1.2. Via anonymous CVS
687 687
688 2.2. Keeping pkgsrc up-to-date 688 2.2. Keeping pkgsrc up-to-date