Thu Oct 9 13:47:58 2014 UTC ()
regen


(wiz)
diff -r1.186 -r1.187 pkgsrc/doc/pkgsrc.html
diff -r1.189 -r1.190 pkgsrc/doc/pkgsrc.txt

cvs diff -r1.186 -r1.187 pkgsrc/doc/pkgsrc.html (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.html 2014/10/09 13:44:46 1.186
+++ pkgsrc/doc/pkgsrc.html 2014/10/09 13:47:57 1.187
@@ -3984,32 +3984,26 @@ sections.

 @@ -3984,32 +3984,26 @@ sections.

3984<li class="listitem"><p><code class="varname">DISTNAME</code> is the basename of the 3984<li class="listitem"><p><code class="varname">DISTNAME</code> is the basename of the
3985 distribution file to be downloaded from the package's 3985 distribution file to be downloaded from the package's
3986 website.</p></li> 3986 website.</p></li>
3987<li class="listitem"><p><code class="varname">PKGNAME</code> is the name of the 3987<li class="listitem"><p><code class="varname">PKGNAME</code> is the name of the
3988 package, as used by pkgsrc. You need to provide it if 3988 package, as used by pkgsrc. You need to provide it if
3989 <code class="varname">DISTNAME</code> (which is the default) is not a good 3989 <code class="varname">DISTNAME</code> (which is the default) is not a good
3990 name for the package in pkgsrc or <code class="varname">DISTNAME</code> is not 3990 name for the package in pkgsrc or <code class="varname">DISTNAME</code> is not
3991 provided (no distribution file is required). Usually it is the pkgsrc 3991 provided (no distribution file is required). Usually it is the pkgsrc
3992 directory name together with the version number. It must match the 3992 directory name together with the version number. It must match the
3993 regular expression 3993 regular expression
3994 <code class="varname">^[A-Za-z0-9][A-Za-z0-9-_.+]*$</code>, that is, it 3994 <code class="varname">^[A-Za-z0-9][A-Za-z0-9-_.+]*$</code>, that is, it
3995 starts with a letter or digit, and contains only letters, digits, 3995 starts with a letter or digit, and contains only letters, digits,
3996 dashes, underscores, dots and plus signs.</p></li> 3996 dashes, underscores, dots and plus signs.</p></li>
3997 the package file to create if the <code class="varname">PKGNAME</code> 
3998 isn't unique on a SVR4 system. The default is 
3999 <code class="varname">PKGNAME</code>, which may be shortened when you use 
4000 <a href="ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc/pkgtools/gensolpkg/README.html" target="_top"><code class="filename">pkgtools/gensolpkg</code></a>. Only add 
4001 does not produce an unique package name on a SVR4 system. 
4002 characters.</p></li> 
4003<li class="listitem"> 3997<li class="listitem">
4004<p><code class="varname">CATEGORIES</code> is a list of categories 3998<p><code class="varname">CATEGORIES</code> is a list of categories
4005 which the package fits in. You can choose any of the top-level 3999 which the package fits in. You can choose any of the top-level
4006 directories of pkgsrc for it.</p> 4000 directories of pkgsrc for it.</p>
4007<p>Currently the following values are available for 4001<p>Currently the following values are available for
4008 <code class="varname">CATEGORIES</code>. If more than 4002 <code class="varname">CATEGORIES</code>. If more than
4009 one is used, they need to be separated by spaces:</p> 4003 one is used, they need to be separated by spaces:</p>
4010<pre class="programlisting"> 4004<pre class="programlisting">
4011archivers cross geography meta-pkgs security 4005archivers cross geography meta-pkgs security
4012audio databases graphics misc shells 4006audio databases graphics misc shells
4013benchmarks devel ham multimedia sysutils 4007benchmarks devel ham multimedia sysutils
4014biology editors inputmethod net textproc 4008biology editors inputmethod net textproc
4015cad emulators lang news time 4009cad emulators lang news time
@@ -7339,67 +7333,67 @@ the name of the common tools. For exampl @@ -7339,67 +7333,67 @@ the name of the common tools. For exampl
7339.if exists(/usr/bin/bzcat) 7333.if exists(/usr/bin/bzcat)
7340TOOLS_PLATFORM.bzcat?= /usr/bin/bzcat 7334TOOLS_PLATFORM.bzcat?= /usr/bin/bzcat
7341.elif exists(/usr/bin/bzip2) 7335.elif exists(/usr/bin/bzip2)
7342TOOLS_PLATFORM.bzcat?= /usr/bin/bzip2 -cd 7336TOOLS_PLATFORM.bzcat?= /usr/bin/bzip2 -cd
7343.endif 7337.endif
7344 7338
7345TOOLS_PLATFORM.true?= true # shell builtin 7339TOOLS_PLATFORM.true?= true # shell builtin
7346</pre> 7340</pre>
7347</div> 7341</div>
7348<div class="sect1"> 7342<div class="sect1">
7349<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 7343<div class="titlepage"><div><div><h2 class="title" style="clear: both">
7350<a name="tools.questions"></a>18.4. Questions regarding the tools</h2></div></div></div> 7344<a name="tools.questions"></a>18.4. Questions regarding the tools</h2></div></div></div>
7351<div class="qandaset"> 7345<div class="qandaset">
7352<a name="idm75779472"></a><dl> 7346<a name="idm73247248"></a><dl>
7353<dt>18.4.1. <a href="#tools.new">How do I add a new tool?</a> 7347<dt>18.4.1. <a href="#tools.new">How do I add a new tool?</a>
7354</dt> 7348</dt>
7355<dt>18.4.2. <a href="#tools.listall">How do I get a list of all available 7349<dt>18.4.2. <a href="#tools.listall">How do I get a list of all available
7356 tools?</a> 7350 tools?</a>
7357</dt> 7351</dt>
7358<dt>18.4.3. <a href="#tools.used">How can I get a list of all the tools that a 7352<dt>18.4.3. <a href="#tools.used">How can I get a list of all the tools that a
7359 package is using while being built? I want to know whether it 7353 package is using while being built? I want to know whether it
7360 uses sed or not.</a> 7354 uses sed or not.</a>
7361</dt> 7355</dt>
7362</dl> 7356</dl>
7363<table border="0" style="width: 100%;"> 7357<table border="0" style="width: 100%;">
7364<colgroup> 7358<colgroup>
7365<col align="left" width="1%"> 7359<col align="left" width="1%">
7366<col> 7360<col>
7367</colgroup> 7361</colgroup>
7368<tbody> 7362<tbody>
7369<tr class="question"> 7363<tr class="question">
7370<td align="left" valign="top"> 7364<td align="left" valign="top">
7371<a name="tools.new"></a><a name="idm75779088"></a><p><b>18.4.1.</b></p> 7365<a name="tools.new"></a><a name="idm73246864"></a><p><b>18.4.1.</b></p>
7372</td> 7366</td>
7373<td align="left" valign="top"><p>How do I add a new tool?</p></td> 7367<td align="left" valign="top"><p>How do I add a new tool?</p></td>
7374</tr> 7368</tr>
7375<tr class="answer"> 7369<tr class="answer">
7376<td align="left" valign="top"></td> 7370<td align="left" valign="top"></td>
7377<td align="left" valign="top"><p>TODO</p></td> 7371<td align="left" valign="top"><p>TODO</p></td>
7378</tr> 7372</tr>
7379<tr class="question"> 7373<tr class="question">
7380<td align="left" valign="top"> 7374<td align="left" valign="top">
7381<a name="tools.listall"></a><a name="idm75778064"></a><p><b>18.4.2.</b></p> 7375<a name="tools.listall"></a><a name="idm73245840"></a><p><b>18.4.2.</b></p>
7382</td> 7376</td>
7383<td align="left" valign="top"><p>How do I get a list of all available 7377<td align="left" valign="top"><p>How do I get a list of all available
7384 tools?</p></td> 7378 tools?</p></td>
7385</tr> 7379</tr>
7386<tr class="answer"> 7380<tr class="answer">
7387<td align="left" valign="top"></td> 7381<td align="left" valign="top"></td>
7388<td align="left" valign="top"><p>TODO</p></td> 7382<td align="left" valign="top"><p>TODO</p></td>
7389</tr> 7383</tr>
7390<tr class="question"> 7384<tr class="question">
7391<td align="left" valign="top"> 7385<td align="left" valign="top">
7392<a name="tools.used"></a><a name="idm75776912"></a><p><b>18.4.3.</b></p> 7386<a name="tools.used"></a><a name="idm73244816"></a><p><b>18.4.3.</b></p>
7393</td> 7387</td>
7394<td align="left" valign="top"><p>How can I get a list of all the tools that a 7388<td align="left" valign="top"><p>How can I get a list of all the tools that a
7395 package is using while being built? I want to know whether it 7389 package is using while being built? I want to know whether it
7396 uses sed or not.</p></td> 7390 uses sed or not.</p></td>
7397</tr> 7391</tr>
7398<tr class="answer"> 7392<tr class="answer">
7399<td align="left" valign="top"></td> 7393<td align="left" valign="top"></td>
7400<td align="left" valign="top"><p>Currently, you can't. (TODO: But I want to be able 7394<td align="left" valign="top"><p>Currently, you can't. (TODO: But I want to be able
7401 to do it.)</p></td> 7395 to do it.)</p></td>
7402</tr> 7396</tr>
7403</tbody> 7397</tbody>
7404</table> 7398</table>
7405</div> 7399</div>
@@ -9461,27 +9455,27 @@ place.

 @@ -9461,27 +9455,27 @@ place.

9461</li> 9455</li>
9462</ol></div> 9456</ol></div>
9463</div> 9457</div>
9464</div> 9458</div>
9465<div class="chapter"> 9459<div class="chapter">
9466<div class="titlepage"><div><div><h2 class="title"> 9460<div class="titlepage"><div><div><h2 class="title">
9467<a name="devfaq"></a>Chapter 22. Frequently Asked Questions</h2></div></div></div> 9461<a name="devfaq"></a>Chapter 22. Frequently Asked Questions</h2></div></div></div>
9468<p>This section contains the answers to questions that may 9462<p>This section contains the answers to questions that may
9469 arise when you are writing a package. If you don't find your 9463 arise when you are writing a package. If you don't find your
9470 question answered here, first have a look in the other chapters, 9464 question answered here, first have a look in the other chapters,
9471 and if you still don't have the answer, ask on the 9465 and if you still don't have the answer, ask on the
9472 <code class="literal">pkgsrc-users</code> mailing list.</p> 9466 <code class="literal">pkgsrc-users</code> mailing list.</p>
9473<div class="qandaset"> 9467<div class="qandaset">
9474<a name="idm77314064"></a><dl> 9468<a name="idm72688784"></a><dl>
9475<dt>22.1. <a href="#devfaq.makeflags">What is the difference between 9469<dt>22.1. <a href="#devfaq.makeflags">What is the difference between
9476 MAKEFLAGS, .MAKEFLAGS and 9470 MAKEFLAGS, .MAKEFLAGS and
9477 MAKE_FLAGS?</a> 9471 MAKE_FLAGS?</a>
9478</dt> 9472</dt>
9479<dt>22.2. <a href="#devfaq.make">What is the difference between 9473<dt>22.2. <a href="#devfaq.make">What is the difference between
9480 MAKE, GMAKE and 9474 MAKE, GMAKE and
9481 MAKE_PROGRAM?</a> 9475 MAKE_PROGRAM?</a>
9482</dt> 9476</dt>
9483<dt>22.3. <a href="#devfaq.cc">What is the difference between 9477<dt>22.3. <a href="#devfaq.cc">What is the difference between
9484 CC, PKG_CC and 9478 CC, PKG_CC and
9485 PKGSRC_COMPILER?</a> 9479 PKGSRC_COMPILER?</a>
9486</dt> 9480</dt>
9487<dt>22.4. <a href="#devfaq.bl3flags">What is the difference between 9481<dt>22.4. <a href="#devfaq.bl3flags">What is the difference between
@@ -9506,157 +9500,157 @@ place.

 @@ -9506,157 +9500,157 @@ place.

9506</dt> 9500</dt>
9507<dt>22.9. <a href="#devfaq.too-much-time">I have a little time to kill. What shall I 9501<dt>22.9. <a href="#devfaq.too-much-time">I have a little time to kill. What shall I
9508do?</a> 9502do?</a>
9509</dt> 9503</dt>
9510</dl> 9504</dl>
9511<table border="0" style="width: 100%;"> 9505<table border="0" style="width: 100%;">
9512<colgroup> 9506<colgroup>
9513<col align="left" width="1%"> 9507<col align="left" width="1%">
9514<col> 9508<col>
9515</colgroup> 9509</colgroup>
9516<tbody> 9510<tbody>
9517<tr class="question"> 9511<tr class="question">
9518<td align="left" valign="top"> 9512<td align="left" valign="top">
9519<a name="devfaq.makeflags"></a><a name="idm77313680"></a><p><b>22.1.</b></p> 9513<a name="devfaq.makeflags"></a><a name="idm72688400"></a><p><b>22.1.</b></p>
9520</td> 9514</td>
9521<td align="left" valign="top"><p>What is the difference between 9515<td align="left" valign="top"><p>What is the difference between
9522 <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and 9516 <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and
9523 <code class="varname">MAKE_FLAGS</code>?</p></td> 9517 <code class="varname">MAKE_FLAGS</code>?</p></td>
9524</tr> 9518</tr>
9525<tr class="answer"> 9519<tr class="answer">
9526<td align="left" valign="top"></td> 9520<td align="left" valign="top"></td>
9527<td align="left" valign="top"><p><code class="varname">MAKEFLAGS</code> are the flags passed 9521<td align="left" valign="top"><p><code class="varname">MAKEFLAGS</code> are the flags passed
9528 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 9522 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
9529 <code class="varname">MAKE_FLAGS</code> are the flags that are passed to 9523 <code class="varname">MAKE_FLAGS</code> are the flags that are passed to
9530 the <code class="varname">MAKE_PROGRAM</code> when building the 9524 the <code class="varname">MAKE_PROGRAM</code> when building the
9531 package. [FIXME: What is .MAKEFLAGS for?]</p></td> 9525 package. [FIXME: What is .MAKEFLAGS for?]</p></td>
9532</tr> 9526</tr>
9533<tr class="question"> 9527<tr class="question">
9534<td align="left" valign="top"> 9528<td align="left" valign="top">
9535<a name="devfaq.make"></a><a name="idm77309584"></a><p><b>22.2.</b></p> 9529<a name="devfaq.make"></a><a name="idm72684304"></a><p><b>22.2.</b></p>
9536</td> 9530</td>
9537<td align="left" valign="top"><p>What is the difference between 9531<td align="left" valign="top"><p>What is the difference between
9538 <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and 9532 <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and
9539 <code class="varname">MAKE_PROGRAM</code>?</p></td> 9533 <code class="varname">MAKE_PROGRAM</code>?</p></td>
9540</tr> 9534</tr>
9541<tr class="answer"> 9535<tr class="answer">
9542<td align="left" valign="top"></td> 9536<td align="left" valign="top"></td>
9543<td align="left" valign="top"><p><code class="varname">MAKE</code> is the path to the 9537<td align="left" valign="top"><p><code class="varname">MAKE</code> is the path to the
9544 <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 9538 <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
9545 infrastructure. <code class="varname">GMAKE</code> is the path to GNU 9539 infrastructure. <code class="varname">GMAKE</code> is the path to GNU
9546 Make, but you need to say <code class="varname">USE_TOOLS+=gmake</code> to 9540 Make, but you need to say <code class="varname">USE_TOOLS+=gmake</code> to
9547 use that. <code class="varname">MAKE_PROGRAM</code> is the path to the 9541 use that. <code class="varname">MAKE_PROGRAM</code> is the path to the
9548 Make program that is used for building the 9542 Make program that is used for building the
9549 package.</p></td> 9543 package.</p></td>
9550</tr> 9544</tr>
9551<tr class="question"> 9545<tr class="question">
9552<td align="left" valign="top"> 9546<td align="left" valign="top">
9553<a name="devfaq.cc"></a><a name="idm77305104"></a><p><b>22.3.</b></p> 9547<a name="devfaq.cc"></a><a name="idm72679952"></a><p><b>22.3.</b></p>
9554</td> 9548</td>
9555<td align="left" valign="top"><p>What is the difference between 9549<td align="left" valign="top"><p>What is the difference between
9556 <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and 9550 <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and
9557 <code class="varname">PKGSRC_COMPILER</code>?</p></td> 9551 <code class="varname">PKGSRC_COMPILER</code>?</p></td>
9558</tr> 9552</tr>
9559<tr class="answer"> 9553<tr class="answer">
9560<td align="left" valign="top"></td> 9554<td align="left" valign="top"></td>
9561<td align="left" valign="top"><p><code class="varname">CC</code> is the path to the real C 9555<td align="left" valign="top"><p><code class="varname">CC</code> is the path to the real C
9562 compiler, which can be configured by the pkgsrc user. 9556 compiler, which can be configured by the pkgsrc user.
9563 <code class="varname">PKG_CC</code> is the path to the compiler wrapper. 9557 <code class="varname">PKG_CC</code> is the path to the compiler wrapper.
9564 <code class="varname">PKGSRC_COMPILER</code> is <span class="emphasis"><em>not</em></span> a 9558 <code class="varname">PKGSRC_COMPILER</code> is <span class="emphasis"><em>not</em></span> a
9565 path to a compiler, but the type of compiler that should be 9559 path to a compiler, but the type of compiler that should be
9566 used. See <code class="filename">mk/compiler.mk</code> for more 9560 used. See <code class="filename">mk/compiler.mk</code> for more
9567 information about the latter variable.</p></td> 9561 information about the latter variable.</p></td>
9568</tr> 9562</tr>
9569<tr class="question"> 9563<tr class="question">
9570<td align="left" valign="top"> 9564<td align="left" valign="top">
9571<a name="devfaq.bl3flags"></a><a name="idm77301008"></a><p><b>22.4.</b></p> 9565<a name="devfaq.bl3flags"></a><a name="idm72675728"></a><p><b>22.4.</b></p>
9572</td> 9566</td>
9573<td align="left" valign="top"><p>What is the difference between 9567<td align="left" valign="top"><p>What is the difference between
9574 <code class="varname">BUILDLINK_LDFLAGS</code>, 9568 <code class="varname">BUILDLINK_LDFLAGS</code>,
9575 <code class="varname">BUILDLINK_LDADD</code> and 9569 <code class="varname">BUILDLINK_LDADD</code> and
9576 <code class="varname">BUILDLINK_LIBS</code>?</p></td> 9570 <code class="varname">BUILDLINK_LIBS</code>?</p></td>
9577</tr> 9571</tr>
9578<tr class="answer"> 9572<tr class="answer">
9579<td align="left" valign="top"></td> 9573<td align="left" valign="top"></td>
9580<td align="left" valign="top"><p>[FIXME]</p></td> 9574<td align="left" valign="top"><p>[FIXME]</p></td>
9581</tr> 9575</tr>
9582<tr class="question"> 9576<tr class="question">
9583<td align="left" valign="top"> 9577<td align="left" valign="top">
9584<a name="devfaq.bl3prefix"></a><a name="idm77298832"></a><p><b>22.5.</b></p> 9578<a name="devfaq.bl3prefix"></a><a name="idm72673552"></a><p><b>22.5.</b></p>
9585</td> 9579</td>
9586<td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var 9580<td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var
9587 VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span> 9581 VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span>
9588 say it's empty?</p></td> 9582 say it's empty?</p></td>
9589</tr> 9583</tr>
9590<tr class="answer"> 9584<tr class="answer">
9591<td align="left" valign="top"></td> 9585<td align="left" valign="top"></td>
9592<td align="left" valign="top"><p>For optimization reasons, some variables are only 9586<td align="left" valign="top"><p>For optimization reasons, some variables are only
9593 available in the <span class="quote">&#8220;<span class="quote">wrapper</span>&#8221;</span> phase and later. To 9587 available in the <span class="quote">&#8220;<span class="quote">wrapper</span>&#8221;</span> phase and later. To
9594 <span class="quote">&#8220;<span class="quote">simulate</span>&#8221;</span> the wrapper phase, append 9588 <span class="quote">&#8220;<span class="quote">simulate</span>&#8221;</span> the wrapper phase, append
9595 <span class="command"><strong>PKG_PHASE=wrapper</strong></span> to the above 9589 <span class="command"><strong>PKG_PHASE=wrapper</strong></span> to the above
9596 command.</p></td> 9590 command.</p></td>
9597</tr> 9591</tr>
9598<tr class="question"> 9592<tr class="question">
9599<td align="left" valign="top"> 9593<td align="left" valign="top">
9600<a name="devfaq.master_sites"></a><a name="idm77283344"></a><p><b>22.6.</b></p> 9594<a name="devfaq.master_sites"></a><a name="idm72670480"></a><p><b>22.6.</b></p>
9601</td> 9595</td>
9602<td align="left" valign="top"><p>What does 9596<td align="left" valign="top"><p>What does
9603 <code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I 9597 <code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
9604 don't understand the <code class="literal">:=</code> inside 9598 don't understand the <code class="literal">:=</code> inside
9605 it.</p></td> 9599 it.</p></td>
9606</tr> 9600</tr>
9607<tr class="answer"> 9601<tr class="answer">
9608<td align="left" valign="top"></td> 9602<td align="left" valign="top"></td>
9609<td align="left" valign="top"><p>The <code class="literal">:=</code> is not really an 9603<td align="left" valign="top"><p>The <code class="literal">:=</code> is not really an
9610 assignment operator, like you might expect at first sight. 9604 assignment operator, like you might expect at first sight.
9611 Instead, it is a degenerate form of 9605 Instead, it is a degenerate form of
9612 <code class="literal">${LIST:<em class="replaceable"><code>old_string</code></em>=<em class="replaceable"><code>new_string</code></em>}</code>, 9606 <code class="literal">${LIST:<em class="replaceable"><code>old_string</code></em>=<em class="replaceable"><code>new_string</code></em>}</code>,
9613 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 you 9607 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 you
9614 may have seen as in <code class="literal">${SRCS:.c=.o}</code>. In the 9608 may have seen as in <code class="literal">${SRCS:.c=.o}</code>. In the
9615 case of <code class="varname">MASTER_SITE_*</code>, 9609 case of <code class="varname">MASTER_SITE_*</code>,
9616 <em class="replaceable"><code>old_string</code></em> is the empty string and 9610 <em class="replaceable"><code>old_string</code></em> is the empty string and
9617 <em class="replaceable"><code>new_string</code></em> is 9611 <em class="replaceable"><code>new_string</code></em> is
9618 <code class="literal">package/</code>. That's where the 9612 <code class="literal">package/</code>. That's where the
9619 <code class="literal">:</code> and the <code class="literal">=</code> fall 9613 <code class="literal">:</code> and the <code class="literal">=</code> fall
9620 together.</p></td> 9614 together.</p></td>
9621</tr> 9615</tr>
9622<tr class="question"> 9616<tr class="question">
9623<td align="left" valign="top"> 9617<td align="left" valign="top">
9624<a name="devfaq.mailinglists"></a><a name="idm77275280"></a><p><b>22.7.</b></p> 9618<a name="devfaq.mailinglists"></a><a name="idm72650128"></a><p><b>22.7.</b></p>
9625</td> 9619</td>
9626<td align="left" valign="top"><p>Which mailing lists are there for package 9620<td align="left" valign="top"><p>Which mailing lists are there for package
9627 developers?</p></td> 9621 developers?</p></td>
9628</tr> 9622</tr>
9629<tr class="answer"> 9623<tr class="answer">
9630<td align="left" valign="top"></td> 9624<td align="left" valign="top"></td>
9631<td align="left" valign="top"><div class="variablelist"><dl class="variablelist"> 9625<td align="left" valign="top"><div class="variablelist"><dl class="variablelist">
9632<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#tech-pkg" target="_top">tech-pkg</a></span></dt> 9626<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#tech-pkg" target="_top">tech-pkg</a></span></dt>
9633<dd><p>This is a list for technical discussions related 9627<dd><p>This is a list for technical discussions related
9634 to pkgsrc development, e.g. soliciting feedback for changes to 9628 to pkgsrc development, e.g. soliciting feedback for changes to
9635 pkgsrc infrastructure, proposed new features, questions related 9629 pkgsrc infrastructure, proposed new features, questions related
9636 to porting pkgsrc to a new platform, advice for maintaining a 9630 to porting pkgsrc to a new platform, advice for maintaining a
9637 package, patches that affect many packages, help requests moved 9631 package, patches that affect many packages, help requests moved
9638 from pkgsrc-users when an infrastructure bug is found, 9632 from pkgsrc-users when an infrastructure bug is found,
9639 etc.</p></dd> 9633 etc.</p></dd>
9640<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#pkgsrc-bugs" target="_top">pkgsrc-bugs</a></span></dt> 9634<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#pkgsrc-bugs" target="_top">pkgsrc-bugs</a></span></dt>
9641<dd><p>All bug reports in category "pkg" sent with 9635<dd><p>All bug reports in category "pkg" sent with
9642 <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 9636 <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
9643 directly; use one of the other mailing 9637 directly; use one of the other mailing
9644 lists.</p></dd> 9638 lists.</p></dd>
9645</dl></div></td> 9639</dl></div></td>
9646</tr> 9640</tr>
9647<tr class="question"> 9641<tr class="question">
9648<td align="left" valign="top"> 9642<td align="left" valign="top">
9649<a name="devfaq.documentation"></a><a name="idm77271568"></a><p><b>22.8.</b></p> 9643<a name="devfaq.documentation"></a><a name="idm72646288"></a><p><b>22.8.</b></p>
9650</td> 9644</td>
9651<td align="left" valign="top"><p>Where is the pkgsrc 9645<td align="left" valign="top"><p>Where is the pkgsrc
9652 documentation?</p></td> 9646 documentation?</p></td>
9653</tr> 9647</tr>
9654<tr class="answer"> 9648<tr class="answer">
9655<td align="left" valign="top"></td> 9649<td align="left" valign="top"></td>
9656<td align="left" valign="top"> 9650<td align="left" valign="top">
9657<p>There are many places where you can find 9651<p>There are many places where you can find
9658 documentation about pkgsrc:</p> 9652 documentation about pkgsrc:</p>
9659<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 9653<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
9660<li class="listitem"><p>The pkgsrc guide (this document) is a collection 9654<li class="listitem"><p>The pkgsrc guide (this document) is a collection
9661 of chapters that explain large parts of pkgsrc, but some 9655 of chapters that explain large parts of pkgsrc, but some
9662 chapters tend to be outdated. Which ones they are is hard to 9656 chapters tend to be outdated. Which ones they are is hard to
@@ -9684,27 +9678,27 @@ do? @@ -9684,27 +9678,27 @@ do?
9684 documented</span>&#8221;</span>, that is the documentation exists only in the 9678 documented</span>&#8221;</span>, that is the documentation exists only in the
9685 mind of the developer who wrote the code. To get this 9679 mind of the developer who wrote the code. To get this
9686 information, use the <span class="command"><strong>cvs annotate</strong></span> command 9680 information, use the <span class="command"><strong>cvs annotate</strong></span> command
9687 to see who has written it and ask on the 9681 to see who has written it and ask on the
9688 <code class="literal">tech-pkg</code> mailing list, so that others can 9682 <code class="literal">tech-pkg</code> mailing list, so that others can
9689 find your questions later (see above). To be sure that the 9683 find your questions later (see above). To be sure that the
9690 developer in charge reads the mail, you may CC him or 9684 developer in charge reads the mail, you may CC him or
9691 her.</p></li> 9685 her.</p></li>
9692</ul></div> 9686</ul></div>
9693</td> 9687</td>
9694</tr> 9688</tr>
9695<tr class="question"> 9689<tr class="question">
9696<td align="left" valign="top"> 9690<td align="left" valign="top">
9697<a name="devfaq.too-much-time"></a><a name="idm77265040"></a><p><b>22.9.</b></p> 9691<a name="devfaq.too-much-time"></a><a name="idm72639760"></a><p><b>22.9.</b></p>
9698</td> 9692</td>
9699<td align="left" valign="top"><p>I have a little time to kill. What shall I 9693<td align="left" valign="top"><p>I have a little time to kill. What shall I
9700do?</p></td> 9694do?</p></td>
9701</tr> 9695</tr>
9702<tr class="answer"> 9696<tr class="answer">
9703<td align="left" valign="top"></td> 9697<td align="left" valign="top"></td>
9704<td align="left" valign="top"> 9698<td align="left" valign="top">
9705<p>This is not really an FAQ yet, but here's the answer 9699<p>This is not really an FAQ yet, but here's the answer
9706anyway.</p> 9700anyway.</p>
9707<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 9701<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
9708<li class="listitem"><p>Run <span class="command"><strong>pkg_chk -N</strong></span> (from the 9702<li class="listitem"><p>Run <span class="command"><strong>pkg_chk -N</strong></span> (from the
9709 <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 9703 <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
9710 will tell you about newer versions of installed packages that are 9704 will tell you about newer versions of installed packages that are

cvs diff -r1.189 -r1.190 pkgsrc/doc/pkgsrc.txt (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.txt 2014/10/09 13:44:46 1.189
+++ pkgsrc/doc/pkgsrc.txt 2014/10/09 13:47:57 1.190
@@ -3473,29 +3473,26 @@ exactly in the order given here. The ord @@ -3473,29 +3473,26 @@ exactly in the order given here. The ord
3473mostly historical and has no further meaning. 3473mostly historical and has no further meaning.
3474 3474
3475 * DISTNAME is the basename of the distribution file to be downloaded from the 3475 * DISTNAME is the basename of the distribution file to be downloaded from the
3476 package's website. 3476 package's website.
3477 3477
3478 * PKGNAME is the name of the package, as used by pkgsrc. You need to provide 3478 * PKGNAME is the name of the package, as used by pkgsrc. You need to provide
3479 it if DISTNAME (which is the default) is not a good name for the package in 3479 it if DISTNAME (which is the default) is not a good name for the package in
3480 pkgsrc or DISTNAME is not provided (no distribution file is required). 3480 pkgsrc or DISTNAME is not provided (no distribution file is required).
3481 Usually it is the pkgsrc directory name together with the version number. 3481 Usually it is the pkgsrc directory name together with the version number.
3482 It must match the regular expression ^[A-Za-z0-9][A-Za-z0-9-_.+]*$, that 3482 It must match the regular expression ^[A-Za-z0-9][A-Za-z0-9-_.+]*$, that
3483 is, it starts with a letter or digit, and contains only letters, digits, 3483 is, it starts with a letter or digit, and contains only letters, digits,
3484 dashes, underscores, dots and plus signs. 3484 dashes, underscores, dots and plus signs.
3485 3485
3486 unique on a SVR4 system. The default is PKGNAME, which may be shortened 
3487 is limited to 5 characters. 
3488 
3489 * CATEGORIES is a list of categories which the package fits in. You can 3486 * CATEGORIES is a list of categories which the package fits in. You can
3490 choose any of the top-level directories of pkgsrc for it. 3487 choose any of the top-level directories of pkgsrc for it.
3491 3488
3492 Currently the following values are available for CATEGORIES. If more than 3489 Currently the following values are available for CATEGORIES. If more than
3493 one is used, they need to be separated by spaces: 3490 one is used, they need to be separated by spaces:
3494 3491
3495 archivers cross geography meta-pkgs security 3492 archivers cross geography meta-pkgs security
3496 audio databases graphics misc shells 3493 audio databases graphics misc shells
3497 benchmarks devel ham multimedia sysutils 3494 benchmarks devel ham multimedia sysutils
3498 biology editors inputmethod net textproc 3495 biology editors inputmethod net textproc
3499 cad emulators lang news time 3496 cad emulators lang news time
3500 chat finance mail parallel wm 3497 chat finance mail parallel wm
3501 comms fonts math pkgtools www 3498 comms fonts math pkgtools www