Sun May 5 21:43:40 2013 UTC ()
regen


(rodent)
diff -r1.157 -r1.158 pkgsrc/doc/pkgsrc.html
diff -r1.160 -r1.161 pkgsrc/doc/pkgsrc.txt

cvs diff -r1.157 -r1.158 pkgsrc/doc/pkgsrc.html (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.html 2013/05/03 20:55:21 1.157
+++ pkgsrc/doc/pkgsrc.html 2013/05/05 21:43:39 1.158
@@ -7648,67 +7648,67 @@ the name of the common tools. For exampl @@ -7648,67 +7648,67 @@ the name of the common tools. For exampl
7648.if exists(/usr/bin/bzcat) 7648.if exists(/usr/bin/bzcat)
7649TOOLS_PLATFORM.bzcat?= /usr/bin/bzcat 7649TOOLS_PLATFORM.bzcat?= /usr/bin/bzcat
7650.elif exists(/usr/bin/bzip2) 7650.elif exists(/usr/bin/bzip2)
7651TOOLS_PLATFORM.bzcat?= /usr/bin/bzip2 -cd 7651TOOLS_PLATFORM.bzcat?= /usr/bin/bzip2 -cd
7652.endif 7652.endif
7653 7653
7654TOOLS_PLATFORM.true?= true # shell builtin 7654TOOLS_PLATFORM.true?= true # shell builtin
7655</pre> 7655</pre>
7656</div> 7656</div>
7657<div class="sect1"> 7657<div class="sect1">
7658<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 7658<div class="titlepage"><div><div><h2 class="title" style="clear: both">
7659<a name="tools.questions"></a>18.4. Questions regarding the tools</h2></div></div></div> 7659<a name="tools.questions"></a>18.4. Questions regarding the tools</h2></div></div></div>
7660<div class="qandaset"> 7660<div class="qandaset">
7661<a name="idm30189572"></a><dl> 7661<a name="idm86685616"></a><dl>
7662<dt>18.4.1. <a href="#tools.new">How do I add a new tool?</a> 7662<dt>18.4.1. <a href="#tools.new">How do I add a new tool?</a>
7663</dt> 7663</dt>
7664<dt>18.4.2. <a href="#tools.listall">How do I get a list of all available 7664<dt>18.4.2. <a href="#tools.listall">How do I get a list of all available
7665 tools?</a> 7665 tools?</a>
7666</dt> 7666</dt>
7667<dt>18.4.3. <a href="#tools.used">How can I get a list of all the tools that a 7667<dt>18.4.3. <a href="#tools.used">How can I get a list of all the tools that a
7668 package is using while being built? I want to know whether it 7668 package is using while being built? I want to know whether it
7669 uses sed or not.</a> 7669 uses sed or not.</a>
7670</dt> 7670</dt>
7671</dl> 7671</dl>
7672<table border="0" style="width: 100%;"> 7672<table border="0" style="width: 100%;">
7673<colgroup> 7673<colgroup>
7674<col align="left" width="1%"> 7674<col align="left" width="1%">
7675<col> 7675<col>
7676</colgroup> 7676</colgroup>
7677<tbody> 7677<tbody>
7678<tr class="question"> 7678<tr class="question">
7679<td align="left" valign="top"> 7679<td align="left" valign="top">
7680<a name="tools.new"></a><a name="idm30189380"></a><p><b>18.4.1.</b></p> 7680<a name="tools.new"></a><a name="idm86685232"></a><p><b>18.4.1.</b></p>
7681</td> 7681</td>
7682<td align="left" valign="top"><p>How do I add a new tool?</p></td> 7682<td align="left" valign="top"><p>How do I add a new tool?</p></td>
7683</tr> 7683</tr>
7684<tr class="answer"> 7684<tr class="answer">
7685<td align="left" valign="top"></td> 7685<td align="left" valign="top"></td>
7686<td align="left" valign="top"><p>TODO</p></td> 7686<td align="left" valign="top"><p>TODO</p></td>
7687</tr> 7687</tr>
7688<tr class="question"> 7688<tr class="question">
7689<td align="left" valign="top"> 7689<td align="left" valign="top">
7690<a name="tools.listall"></a><a name="idm30188868"></a><p><b>18.4.2.</b></p> 7690<a name="tools.listall"></a><a name="idm86684208"></a><p><b>18.4.2.</b></p>
7691</td> 7691</td>
7692<td align="left" valign="top"><p>How do I get a list of all available 7692<td align="left" valign="top"><p>How do I get a list of all available
7693 tools?</p></td> 7693 tools?</p></td>
7694</tr> 7694</tr>
7695<tr class="answer"> 7695<tr class="answer">
7696<td align="left" valign="top"></td> 7696<td align="left" valign="top"></td>
7697<td align="left" valign="top"><p>TODO</p></td> 7697<td align="left" valign="top"><p>TODO</p></td>
7698</tr> 7698</tr>
7699<tr class="question"> 7699<tr class="question">
7700<td align="left" valign="top"> 7700<td align="left" valign="top">
7701<a name="tools.used"></a><a name="idm30188356"></a><p><b>18.4.3.</b></p> 7701<a name="tools.used"></a><a name="idm86683184"></a><p><b>18.4.3.</b></p>
7702</td> 7702</td>
7703<td align="left" valign="top"><p>How can I get a list of all the tools that a 7703<td align="left" valign="top"><p>How can I get a list of all the tools that a
7704 package is using while being built? I want to know whether it 7704 package is using while being built? I want to know whether it
7705 uses sed or not.</p></td> 7705 uses sed or not.</p></td>
7706</tr> 7706</tr>
7707<tr class="answer"> 7707<tr class="answer">
7708<td align="left" valign="top"></td> 7708<td align="left" valign="top"></td>
7709<td align="left" valign="top"><p>Currently, you can't. (TODO: But I want to be able 7709<td align="left" valign="top"><p>Currently, you can't. (TODO: But I want to be able
7710 to do it.)</p></td> 7710 to do it.)</p></td>
7711</tr> 7711</tr>
7712</tbody> 7712</tbody>
7713</table> 7713</table>
7714</div> 7714</div>
@@ -7909,26 +7909,27 @@ INTERACTIVE_STAGE= configure instal @@ -7909,26 +7909,27 @@ INTERACTIVE_STAGE= configure instal
7909 lucent 7909 lucent
7910 miros 7910 miros
7911 mit 7911 mit
7912 mpl-1.0 mpl-1.1 mpl-2.0 7912 mpl-1.0 mpl-1.1 mpl-2.0
7913 mplusfont 7913 mplusfont
7914 ofl-v1.0 ofl-v1.1 7914 ofl-v1.0 ofl-v1.1
7915 original-bsd modified-bsd 2-clause-bsd 7915 original-bsd modified-bsd 2-clause-bsd
7916 php 7916 php
7917 png-license 7917 png-license
7918 postgresql-license 7918 postgresql-license
7919 public-domain 7919 public-domain
7920 python-software-foundation 7920 python-software-foundation
7921 qpl-v1.0 7921 qpl-v1.0
 7922 sgi-free-software-b-v2.0
7922 sleepycat-public 7923 sleepycat-public
7923 unlicense 7924 unlicense
7924 x11 7925 x11
7925 zlib 7926 zlib
7926 zpl 7927 zpl
7927 </pre> 7928 </pre>
7928<p> 7929<p>
7929 </p> 7930 </p>
7930<p>The license tag mechanism is intended to address 7931<p>The license tag mechanism is intended to address
7931 copyright-related issues surrounding building, installing and 7932 copyright-related issues surrounding building, installing and
7932 using a package, and not to address redistribution issues (see 7933 using a package, and not to address redistribution issues (see
7933 <code class="varname">RESTRICTED</code> and 7934 <code class="varname">RESTRICTED</code> and
7934 <code class="varname">NO_SRC_ON_FTP</code>, etc.).  7935 <code class="varname">NO_SRC_ON_FTP</code>, etc.).
@@ -7959,26 +7960,27 @@ LICENSE= xv-license @@ -7959,26 +7960,27 @@ LICENSE= xv-license
7959 convey to pkgsrc that it should not in the future fail because of 7960 convey to pkgsrc that it should not in the future fail because of
7960 that license:</p> 7961 that license:</p>
7961<pre class="programlisting"> 7962<pre class="programlisting">
7962ACCEPTABLE_LICENSES+=xv-license 7963ACCEPTABLE_LICENSES+=xv-license
7963 </pre> 7964 </pre>
7964<p>When adding a package with a new license, the following steps 7965<p>When adding a package with a new license, the following steps
7965 are required:</p> 7966 are required:</p>
7966<div class="orderedlist"><ol class="orderedlist" type="1"> 7967<div class="orderedlist"><ol class="orderedlist" type="1">
7967<li class="listitem"> 7968<li class="listitem">
7968<p>Check if the file can avoid the -license filename tag as described above by referencing <a class="ulink" href="http://www.gnu.org/licenses/license-list.html" target="_top">Various Licenses and Comments about Them</a> and <a class="ulink" href="http://opensource.org/licenses/alphabetical" target="_top">Licenses by Name | Open Source Initiative</a>. If this is the case, additionally add the license filename to:</p> 7969<p>Check if the file can avoid the -license filename tag as described above by referencing <a class="ulink" href="http://www.gnu.org/licenses/license-list.html" target="_top">Various Licenses and Comments about Them</a> and <a class="ulink" href="http://opensource.org/licenses/alphabetical" target="_top">Licenses by Name | Open Source Initiative</a>. If this is the case, additionally add the license filename to:</p>
7969<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 7970<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
7970<li class="listitem"><p>DEFAULT_ACCEPTABLE_LICENSES in <code class="filename">pkgsrc/mk/license.mk</code></p></li> 7971<li class="listitem"><p>DEFAULT_ACCEPTABLE_LICENSES in <code class="filename">pkgsrc/mk/license.mk</code></p></li>
7971<li class="listitem"><p>default_acceptable_licenses in <code class="filename">pkgsrc/pkgtools/pkg_install/files/lib/license.c</code></p></li> 7972<li class="listitem"><p>default_acceptable_licenses in <code class="filename">pkgsrc/pkgtools/pkg_install/files/lib/license.c</code></p></li>
 7973<li class="listitem"><p>the ACCEPTABLE_LICENSES list in <code class="filename">pkgsrc/doc/guide/files/fixes.xml</code></p></li>
7972</ul></div> 7974</ul></div>
7973<p>with the proper syntax as demonstrated in those files, respectively.</p> 7975<p>with the proper syntax as demonstrated in those files, respectively.</p>
7974</li> 7976</li>
7975<li class="listitem"><p>The license text should be added to <code class="filename">pkgsrc/licenses</code> for displaying. A list of known licenses can be seen in this directory.</p></li> 7977<li class="listitem"><p>The license text should be added to <code class="filename">pkgsrc/licenses</code> for displaying. A list of known licenses can be seen in this directory.</p></li>
7976</ol></div> 7978</ol></div>
7977<p>When the license changes (in a way other than formatting), 7979<p>When the license changes (in a way other than formatting),
7978 please make sure that the new license has a different name (e.g., 7980 please make sure that the new license has a different name (e.g.,
7979 append the version number if it exists, or the date). Just 7981 append the version number if it exists, or the date). Just
7980 because a user told pkgsrc to build programs under a previous 7982 because a user told pkgsrc to build programs under a previous
7981 version of a license does not mean that pkgsrc should build 7983 version of a license does not mean that pkgsrc should build
7982 programs under the new licenses. The higher-level point is that 7984 programs under the new licenses. The higher-level point is that
7983 pkgsrc does not evaluate licenses for reasonableness; the only 7985 pkgsrc does not evaluate licenses for reasonableness; the only
7984 test is a mechanistic test of whether a particular text has been 7986 test is a mechanistic test of whether a particular text has been
@@ -9735,27 +9737,27 @@ place.

 @@ -9735,27 +9737,27 @@ place.

9735</li> 9737</li>
9736</ol></div> 9738</ol></div>
9737</div> 9739</div>
9738</div> 9740</div>
9739<div class="chapter"> 9741<div class="chapter">
9740<div class="titlepage"><div><div><h2 class="title"> 9742<div class="titlepage"><div><div><h2 class="title">
9741<a name="devfaq"></a>Chapter 22. Frequently Asked Questions</h2></div></div></div> 9743<a name="devfaq"></a>Chapter 22. Frequently Asked Questions</h2></div></div></div>
9742<p>This section contains the answers to questions that may 9744<p>This section contains the answers to questions that may
9743 arise when you are writing a package. If you don't find your 9745 arise when you are writing a package. If you don't find your
9744 question answered here, first have a look in the other chapters, 9746 question answered here, first have a look in the other chapters,
9745 and if you still don't have the answer, ask on the 9747 and if you still don't have the answer, ask on the
9746 <code class="literal">pkgsrc-users</code> mailing list.</p> 9748 <code class="literal">pkgsrc-users</code> mailing list.</p>
9747<div class="qandaset"> 9749<div class="qandaset">
9748<a name="idm29880324"></a><dl> 9750<a name="idm88223536"></a><dl>
9749<dt>22.1. <a href="#devfaq.makeflags">What is the difference between 9751<dt>22.1. <a href="#devfaq.makeflags">What is the difference between
9750 MAKEFLAGS, .MAKEFLAGS and 9752 MAKEFLAGS, .MAKEFLAGS and
9751 MAKE_FLAGS?</a> 9753 MAKE_FLAGS?</a>
9752</dt> 9754</dt>
9753<dt>22.2. <a href="#devfaq.make">What is the difference between 9755<dt>22.2. <a href="#devfaq.make">What is the difference between
9754 MAKE, GMAKE and 9756 MAKE, GMAKE and
9755 MAKE_PROGRAM?</a> 9757 MAKE_PROGRAM?</a>
9756</dt> 9758</dt>
9757<dt>22.3. <a href="#devfaq.cc">What is the difference between 9759<dt>22.3. <a href="#devfaq.cc">What is the difference between
9758 CC, PKG_CC and 9760 CC, PKG_CC and
9759 PKGSRC_COMPILER?</a> 9761 PKGSRC_COMPILER?</a>
9760</dt> 9762</dt>
9761<dt>22.4. <a href="#devfaq.bl3flags">What is the difference between 9763<dt>22.4. <a href="#devfaq.bl3flags">What is the difference between
@@ -9780,157 +9782,157 @@ place.

 @@ -9780,157 +9782,157 @@ place.

9780</dt> 9782</dt>
9781<dt>22.9. <a href="#devfaq.too-much-time">I have a little time to kill. What shall I 9783<dt>22.9. <a href="#devfaq.too-much-time">I have a little time to kill. What shall I
9782do?</a> 9784do?</a>
9783</dt> 9785</dt>
9784</dl> 9786</dl>
9785<table border="0" style="width: 100%;"> 9787<table border="0" style="width: 100%;">
9786<colgroup> 9788<colgroup>
9787<col align="left" width="1%"> 9789<col align="left" width="1%">
9788<col> 9790<col>
9789</colgroup> 9791</colgroup>
9790<tbody> 9792<tbody>
9791<tr class="question"> 9793<tr class="question">
9792<td align="left" valign="top"> 9794<td align="left" valign="top">
9793<a name="devfaq.makeflags"></a><a name="idm29880132"></a><p><b>22.1.</b></p> 9795<a name="devfaq.makeflags"></a><a name="idm88223152"></a><p><b>22.1.</b></p>
9794</td> 9796</td>
9795<td align="left" valign="top"><p>What is the difference between 9797<td align="left" valign="top"><p>What is the difference between
9796 <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and 9798 <code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and
9797 <code class="varname">MAKE_FLAGS</code>?</p></td> 9799 <code class="varname">MAKE_FLAGS</code>?</p></td>
9798</tr> 9800</tr>
9799<tr class="answer"> 9801<tr class="answer">
9800<td align="left" valign="top"></td> 9802<td align="left" valign="top"></td>
9801<td align="left" valign="top"><p><code class="varname">MAKEFLAGS</code> are the flags passed 9803<td align="left" valign="top"><p><code class="varname">MAKEFLAGS</code> are the flags passed
9802 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 9804 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
9803 <code class="varname">MAKE_FLAGS</code> are the flags that are passed to 9805 <code class="varname">MAKE_FLAGS</code> are the flags that are passed to
9804 the <code class="varname">MAKE_PROGRAM</code> when building the 9806 the <code class="varname">MAKE_PROGRAM</code> when building the
9805 package. [FIXME: What is .MAKEFLAGS for?]</p></td> 9807 package. [FIXME: What is .MAKEFLAGS for?]</p></td>
9806</tr> 9808</tr>
9807<tr class="question"> 9809<tr class="question">
9808<td align="left" valign="top"> 9810<td align="left" valign="top">
9809<a name="devfaq.make"></a><a name="idm29873860"></a><p><b>22.2.</b></p> 9811<a name="devfaq.make"></a><a name="idm88219056"></a><p><b>22.2.</b></p>
9810</td> 9812</td>
9811<td align="left" valign="top"><p>What is the difference between 9813<td align="left" valign="top"><p>What is the difference between
9812 <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and 9814 <code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and
9813 <code class="varname">MAKE_PROGRAM</code>?</p></td> 9815 <code class="varname">MAKE_PROGRAM</code>?</p></td>
9814</tr> 9816</tr>
9815<tr class="answer"> 9817<tr class="answer">
9816<td align="left" valign="top"></td> 9818<td align="left" valign="top"></td>
9817<td align="left" valign="top"><p><code class="varname">MAKE</code> is the path to the 9819<td align="left" valign="top"><p><code class="varname">MAKE</code> is the path to the
9818 <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 9820 <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
9819 infrastructure. <code class="varname">GMAKE</code> is the path to GNU 9821 infrastructure. <code class="varname">GMAKE</code> is the path to GNU
9820 Make, but you need to say <code class="varname">USE_TOOLS+=gmake</code> to 9822 Make, but you need to say <code class="varname">USE_TOOLS+=gmake</code> to
9821 use that. <code class="varname">MAKE_PROGRAM</code> is the path to the 9823 use that. <code class="varname">MAKE_PROGRAM</code> is the path to the
9822 Make program that is used for building the 9824 Make program that is used for building the
9823 package.</p></td> 9825 package.</p></td>
9824</tr> 9826</tr>
9825<tr class="question"> 9827<tr class="question">
9826<td align="left" valign="top"> 9828<td align="left" valign="top">
9827<a name="devfaq.cc"></a><a name="idm29871620"></a><p><b>22.3.</b></p> 9829<a name="devfaq.cc"></a><a name="idm88214704"></a><p><b>22.3.</b></p>
9828</td> 9830</td>
9829<td align="left" valign="top"><p>What is the difference between 9831<td align="left" valign="top"><p>What is the difference between
9830 <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and 9832 <code class="varname">CC</code>, <code class="varname">PKG_CC</code> and
9831 <code class="varname">PKGSRC_COMPILER</code>?</p></td> 9833 <code class="varname">PKGSRC_COMPILER</code>?</p></td>
9832</tr> 9834</tr>
9833<tr class="answer"> 9835<tr class="answer">
9834<td align="left" valign="top"></td> 9836<td align="left" valign="top"></td>
9835<td align="left" valign="top"><p><code class="varname">CC</code> is the path to the real C 9837<td align="left" valign="top"><p><code class="varname">CC</code> is the path to the real C
9836 compiler, which can be configured by the pkgsrc user. 9838 compiler, which can be configured by the pkgsrc user.
9837 <code class="varname">PKG_CC</code> is the path to the compiler wrapper. 9839 <code class="varname">PKG_CC</code> is the path to the compiler wrapper.
9838 <code class="varname">PKGSRC_COMPILER</code> is <span class="emphasis"><em>not</em></span> a 9840 <code class="varname">PKGSRC_COMPILER</code> is <span class="emphasis"><em>not</em></span> a
9839 path to a compiler, but the type of compiler that should be 9841 path to a compiler, but the type of compiler that should be
9840 used. See <code class="filename">mk/compiler.mk</code> for more 9842 used. See <code class="filename">mk/compiler.mk</code> for more
9841 information about the latter variable.</p></td> 9843 information about the latter variable.</p></td>
9842</tr> 9844</tr>
9843<tr class="question"> 9845<tr class="question">
9844<td align="left" valign="top"> 9846<td align="left" valign="top">
9845<a name="devfaq.bl3flags"></a><a name="idm29869444"></a><p><b>22.4.</b></p> 9847<a name="devfaq.bl3flags"></a><a name="idm88210480"></a><p><b>22.4.</b></p>
9846</td> 9848</td>
9847<td align="left" valign="top"><p>What is the difference between 9849<td align="left" valign="top"><p>What is the difference between
9848 <code class="varname">BUILDLINK_LDFLAGS</code>, 9850 <code class="varname">BUILDLINK_LDFLAGS</code>,
9849 <code class="varname">BUILDLINK_LDADD</code> and 9851 <code class="varname">BUILDLINK_LDADD</code> and
9850 <code class="varname">BUILDLINK_LIBS</code>?</p></td> 9852 <code class="varname">BUILDLINK_LIBS</code>?</p></td>
9851</tr> 9853</tr>
9852<tr class="answer"> 9854<tr class="answer">
9853<td align="left" valign="top"></td> 9855<td align="left" valign="top"></td>
9854<td align="left" valign="top"><p>[FIXME]</p></td> 9856<td align="left" valign="top"><p>[FIXME]</p></td>
9855</tr> 9857</tr>
9856<tr class="question"> 9858<tr class="question">
9857<td align="left" valign="top"> 9859<td align="left" valign="top">
9858<a name="devfaq.bl3prefix"></a><a name="idm29868356"></a><p><b>22.5.</b></p> 9860<a name="devfaq.bl3prefix"></a><a name="idm88208304"></a><p><b>22.5.</b></p>
9859</td> 9861</td>
9860<td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var 9862<td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var
9861 VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span> 9863 VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span>
9862 say it's empty?</p></td> 9864 say it's empty?</p></td>
9863</tr> 9865</tr>
9864<tr class="answer"> 9866<tr class="answer">
9865<td align="left" valign="top"></td> 9867<td align="left" valign="top"></td>
9866<td align="left" valign="top"><p>For optimization reasons, some variables are only 9868<td align="left" valign="top"><p>For optimization reasons, some variables are only
9867 available in the <span class="quote">&#8220;<span class="quote">wrapper</span>&#8221;</span> phase and later. To 9869 available in the <span class="quote">&#8220;<span class="quote">wrapper</span>&#8221;</span> phase and later. To
9868 <span class="quote">&#8220;<span class="quote">simulate</span>&#8221;</span> the wrapper phase, append 9870 <span class="quote">&#8220;<span class="quote">simulate</span>&#8221;</span> the wrapper phase, append
9869 <span class="command"><strong>PKG_PHASE=wrapper</strong></span> to the above 9871 <span class="command"><strong>PKG_PHASE=wrapper</strong></span> to the above
9870 command.</p></td> 9872 command.</p></td>
9871</tr> 9873</tr>
9872<tr class="question"> 9874<tr class="question">
9873<td align="left" valign="top"> 9875<td align="left" valign="top">
9874<a name="devfaq.master_sites"></a><a name="idm29866756"></a><p><b>22.6.</b></p> 9876<a name="devfaq.master_sites"></a><a name="idm88205232"></a><p><b>22.6.</b></p>
9875</td> 9877</td>
9876<td align="left" valign="top"><p>What does 9878<td align="left" valign="top"><p>What does
9877 <code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I 9879 <code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
9878 don't understand the <code class="literal">:=</code> inside 9880 don't understand the <code class="literal">:=</code> inside
9879 it.</p></td> 9881 it.</p></td>
9880</tr> 9882</tr>
9881<tr class="answer"> 9883<tr class="answer">
9882<td align="left" valign="top"></td> 9884<td align="left" valign="top"></td>
9883<td align="left" valign="top"><p>The <code class="literal">:=</code> is not really an 9885<td align="left" valign="top"><p>The <code class="literal">:=</code> is not really an
9884 assignment operator, like you might expect at first sight. 9886 assignment operator, like you might expect at first sight.
9885 Instead, it is a degenerate form of 9887 Instead, it is a degenerate form of
9886 <code class="literal">${LIST:<em class="replaceable"><code>old_string</code></em>=<em class="replaceable"><code>new_string</code></em>}</code>, 9888 <code class="literal">${LIST:<em class="replaceable"><code>old_string</code></em>=<em class="replaceable"><code>new_string</code></em>}</code>,
9887 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 9889 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
9888 may have seen as in <code class="literal">${SRCS:.c=.o}</code>. In the 9890 may have seen as in <code class="literal">${SRCS:.c=.o}</code>. In the
9889 case of <code class="varname">MASTER_SITE_*</code>, 9891 case of <code class="varname">MASTER_SITE_*</code>,
9890 <em class="replaceable"><code>old_string</code></em> is the empty string and 9892 <em class="replaceable"><code>old_string</code></em> is the empty string and
9891 <em class="replaceable"><code>new_string</code></em> is 9893 <em class="replaceable"><code>new_string</code></em> is
9892 <code class="literal">package/</code>. That's where the 9894 <code class="literal">package/</code>. That's where the
9893 <code class="literal">:</code> and the <code class="literal">=</code> fall 9895 <code class="literal">:</code> and the <code class="literal">=</code> fall
9894 together.</p></td> 9896 together.</p></td>
9895</tr> 9897</tr>
9896<tr class="question"> 9898<tr class="question">
9897<td align="left" valign="top"> 9899<td align="left" valign="top">
9898<a name="devfaq.mailinglists"></a><a name="idm29862788"></a><p><b>22.7.</b></p> 9900<a name="devfaq.mailinglists"></a><a name="idm88197168"></a><p><b>22.7.</b></p>
9899</td> 9901</td>
9900<td align="left" valign="top"><p>Which mailing lists are there for package 9902<td align="left" valign="top"><p>Which mailing lists are there for package
9901 developers?</p></td> 9903 developers?</p></td>
9902</tr> 9904</tr>
9903<tr class="answer"> 9905<tr class="answer">
9904<td align="left" valign="top"></td> 9906<td align="left" valign="top"></td>
9905<td align="left" valign="top"><div class="variablelist"><dl class="variablelist"> 9907<td align="left" valign="top"><div class="variablelist"><dl class="variablelist">
9906<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#tech-pkg" target="_top">tech-pkg</a></span></dt> 9908<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#tech-pkg" target="_top">tech-pkg</a></span></dt>
9907<dd><p>This is a list for technical discussions related 9909<dd><p>This is a list for technical discussions related
9908 to pkgsrc development, e.g. soliciting feedback for changes to 9910 to pkgsrc development, e.g. soliciting feedback for changes to
9909 pkgsrc infrastructure, proposed new features, questions related 9911 pkgsrc infrastructure, proposed new features, questions related
9910 to porting pkgsrc to a new platform, advice for maintaining a 9912 to porting pkgsrc to a new platform, advice for maintaining a
9911 package, patches that affect many packages, help requests moved 9913 package, patches that affect many packages, help requests moved
9912 from pkgsrc-users when an infrastructure bug is found, 9914 from pkgsrc-users when an infrastructure bug is found,
9913 etc.</p></dd> 9915 etc.</p></dd>
9914<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#pkgsrc-bugs" target="_top">pkgsrc-bugs</a></span></dt> 9916<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#pkgsrc-bugs" target="_top">pkgsrc-bugs</a></span></dt>
9915<dd><p>All bug reports in category "pkg" sent with 9917<dd><p>All bug reports in category "pkg" sent with
9916 <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 9918 <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
9917 directly; use one of the other mailing 9919 directly; use one of the other mailing
9918 lists.</p></dd> 9920 lists.</p></dd>
9919</dl></div></td> 9921</dl></div></td>
9920</tr> 9922</tr>
9921<tr class="question"> 9923<tr class="question">
9922<td align="left" valign="top"> 9924<td align="left" valign="top">
9923<a name="devfaq.documentation"></a><a name="idm29860740"></a><p><b>22.8.</b></p> 9925<a name="devfaq.documentation"></a><a name="idm88193328"></a><p><b>22.8.</b></p>
9924</td> 9926</td>
9925<td align="left" valign="top"><p>Where is the pkgsrc 9927<td align="left" valign="top"><p>Where is the pkgsrc
9926 documentation?</p></td> 9928 documentation?</p></td>
9927</tr> 9929</tr>
9928<tr class="answer"> 9930<tr class="answer">
9929<td align="left" valign="top"></td> 9931<td align="left" valign="top"></td>
9930<td align="left" valign="top"> 9932<td align="left" valign="top">
9931<p>There are many places where you can find 9933<p>There are many places where you can find
9932 documentation about pkgsrc:</p> 9934 documentation about pkgsrc:</p>
9933<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 9935<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
9934<li class="listitem"><p>The pkgsrc guide (this document) is a collection 9936<li class="listitem"><p>The pkgsrc guide (this document) is a collection
9935 of chapters that explain large parts of pkgsrc, but some 9937 of chapters that explain large parts of pkgsrc, but some
9936 chapters tend to be outdated. Which ones they are is hard to 9938 chapters tend to be outdated. Which ones they are is hard to
@@ -9958,27 +9960,27 @@ do? @@ -9958,27 +9960,27 @@ do?
9958 documented</span>&#8221;</span>, that is the documentation exists only in the 9960 documented</span>&#8221;</span>, that is the documentation exists only in the
9959 mind of the developer who wrote the code. To get this 9961 mind of the developer who wrote the code. To get this
9960 information, use the <span class="command"><strong>cvs annotate</strong></span> command 9962 information, use the <span class="command"><strong>cvs annotate</strong></span> command
9961 to see who has written it and ask on the 9963 to see who has written it and ask on the
9962 <code class="literal">tech-pkg</code> mailing list, so that others can 9964 <code class="literal">tech-pkg</code> mailing list, so that others can
9963 find your questions later (see above). To be sure that the 9965 find your questions later (see above). To be sure that the
9964 developer in charge reads the mail, you may CC him or 9966 developer in charge reads the mail, you may CC him or
9965 her.</p></li> 9967 her.</p></li>
9966</ul></div> 9968</ul></div>
9967</td> 9969</td>
9968</tr> 9970</tr>
9969<tr class="question"> 9971<tr class="question">
9970<td align="left" valign="top"> 9972<td align="left" valign="top">
9971<a name="devfaq.too-much-time"></a><a name="idm29857476"></a><p><b>22.9.</b></p> 9973<a name="devfaq.too-much-time"></a><a name="idm88186800"></a><p><b>22.9.</b></p>
9972</td> 9974</td>
9973<td align="left" valign="top"><p>I have a little time to kill. What shall I 9975<td align="left" valign="top"><p>I have a little time to kill. What shall I
9974do?</p></td> 9976do?</p></td>
9975</tr> 9977</tr>
9976<tr class="answer"> 9978<tr class="answer">
9977<td align="left" valign="top"></td> 9979<td align="left" valign="top"></td>
9978<td align="left" valign="top"> 9980<td align="left" valign="top">
9979<p>This is not really an FAQ yet, but here's the answer 9981<p>This is not really an FAQ yet, but here's the answer
9980anyway.</p> 9982anyway.</p>
9981<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 9983<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
9982<li class="listitem"><p>Run <span class="command"><strong>pkg_chk -N</strong></span> (from the 9984<li class="listitem"><p>Run <span class="command"><strong>pkg_chk -N</strong></span> (from the
9983 <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 9985 <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
9984 will tell you about newer versions of installed packages that are 9986 will tell you about newer versions of installed packages that are

cvs diff -r1.160 -r1.161 pkgsrc/doc/pkgsrc.txt (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.txt 2013/05/03 20:55:22 1.160
+++ pkgsrc/doc/pkgsrc.txt 2013/05/05 21:43:39 1.161
@@ -6647,26 +6647,27 @@ variable with "=" instead of "+=". The l @@ -6647,26 +6647,27 @@ variable with "=" instead of "+=". The l
6647 lucent 6647 lucent
6648 miros 6648 miros
6649 mit 6649 mit
6650 mpl-1.0 mpl-1.1 mpl-2.0 6650 mpl-1.0 mpl-1.1 mpl-2.0
6651 mplusfont 6651 mplusfont
6652 ofl-v1.0 ofl-v1.1 6652 ofl-v1.0 ofl-v1.1
6653 original-bsd modified-bsd 2-clause-bsd 6653 original-bsd modified-bsd 2-clause-bsd
6654 php 6654 php
6655 png-license 6655 png-license
6656 postgresql-license 6656 postgresql-license
6657 public-domain 6657 public-domain
6658 python-software-foundation 6658 python-software-foundation
6659 qpl-v1.0 6659 qpl-v1.0
 6660 sgi-free-software-b-v2.0
6660 sleepycat-public 6661 sleepycat-public
6661 unlicense 6662 unlicense
6662 x11 6663 x11
6663 zlib 6664 zlib
6664 zpl 6665 zpl
6665 6666
6666 6667
6667The license tag mechanism is intended to address copyright-related issues 6668The license tag mechanism is intended to address copyright-related issues
6668surrounding building, installing and using a package, and not to address 6669surrounding building, installing and using a package, and not to address
6669redistribution issues (see RESTRICTED and NO_SRC_ON_FTP, etc.). Packages with 6670redistribution issues (see RESTRICTED and NO_SRC_ON_FTP, etc.). Packages with
6670redistribution restrictions should set these tags. 6671redistribution restrictions should set these tags.
6671 6672
6672Denoting that a package may be copied according to a particular license is done 6673Denoting that a package may be copied according to a particular license is done
@@ -6696,26 +6697,28 @@ ACCEPTABLE_LICENSES+=xv-license @@ -6696,26 +6697,28 @@ ACCEPTABLE_LICENSES+=xv-license
6696 6697
6697When adding a package with a new license, the following steps are required: 6698When adding a package with a new license, the following steps are required:
6698 6699
6699 1. Check if the file can avoid the -license filename tag as described above by 6700 1. Check if the file can avoid the -license filename tag as described above by
6700 referencing Various Licenses and Comments about Them and Licenses by Name | 6701 referencing Various Licenses and Comments about Them and Licenses by Name |
6701 Open Source Initiative. If this is the case, additionally add the license 6702 Open Source Initiative. If this is the case, additionally add the license
6702 filename to: 6703 filename to:
6703 6704
6704 + DEFAULT_ACCEPTABLE_LICENSES in pkgsrc/mk/license.mk 6705 + DEFAULT_ACCEPTABLE_LICENSES in pkgsrc/mk/license.mk
6705 6706
6706 + default_acceptable_licenses in pkgsrc/pkgtools/pkg_install/files/lib/ 6707 + default_acceptable_licenses in pkgsrc/pkgtools/pkg_install/files/lib/
6707 license.c 6708 license.c
6708 6709
 6710 + the ACCEPTABLE_LICENSES list in pkgsrc/doc/guide/files/fixes.xml
 6711
6709 with the proper syntax as demonstrated in those files, respectively. 6712 with the proper syntax as demonstrated in those files, respectively.
6710 6713
6711 2. The license text should be added to pkgsrc/licenses for displaying. A list 6714 2. The license text should be added to pkgsrc/licenses for displaying. A list
6712 of known licenses can be seen in this directory. 6715 of known licenses can be seen in this directory.
6713 6716
6714When the license changes (in a way other than formatting), please make sure 6717When the license changes (in a way other than formatting), please make sure
6715that the new license has a different name (e.g., append the version number if 6718that the new license has a different name (e.g., append the version number if
6716it exists, or the date). Just because a user told pkgsrc to build programs 6719it exists, or the date). Just because a user told pkgsrc to build programs
6717under a previous version of a license does not mean that pkgsrc should build 6720under a previous version of a license does not mean that pkgsrc should build
6718programs under the new licenses. The higher-level point is that pkgsrc does not 6721programs under the new licenses. The higher-level point is that pkgsrc does not
6719evaluate licenses for reasonableness; the only test is a mechanistic test of 6722evaluate licenses for reasonableness; the only test is a mechanistic test of
6720whether a particular text has been approved by either of two bodies. 6723whether a particular text has been approved by either of two bodies.
6721 6724