Sun Dec 30 23:26:35 2018 UTC ()
doc/pkgsrc.*: regen


(leot)
diff -r1.257 -r1.258 pkgsrc/doc/pkgsrc.html
diff -r1.255 -r1.256 pkgsrc/doc/pkgsrc.txt

cvs diff -r1.257 -r1.258 pkgsrc/doc/pkgsrc.html (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.html 2018/10/03 21:15:09 1.257
+++ pkgsrc/doc/pkgsrc.html 2018/12/30 23:26:35 1.258
@@ -917,72 +917,72 @@ free to install the sources and binary p @@ -917,72 +917,72 @@ free to install the sources and binary p
917your filesystem, provided that the pathname does not contain white-space 917your filesystem, provided that the pathname does not contain white-space
918or other characters that are interpreted specially by the shell and some 918or other characters that are interpreted specially by the shell and some
919other programs. A safe bet is to use only letters, digits, underscores 919other programs. A safe bet is to use only letters, digits, underscores
920and dashes.</p> 920and dashes.</p>
921<div class="sect1"> 921<div class="sect1">
922<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 922<div class="titlepage"><div><div><h2 class="title" style="clear: both">
923<a name="getting-first"></a>2.1. Getting pkgsrc for the first time</h2></div></div></div> 923<a name="getting-first"></a>2.1. Getting pkgsrc for the first time</h2></div></div></div>
924<p>Before you download any pkgsrc files, you should decide 924<p>Before you download any pkgsrc files, you should decide
925 whether you want the <span class="emphasis"><em>current</em></span> branch or the 925 whether you want the <span class="emphasis"><em>current</em></span> branch or the
926 <span class="emphasis"><em>stable</em></span> branch. The latter is forked on a 926 <span class="emphasis"><em>stable</em></span> branch. The latter is forked on a
927 quarterly basis from the current branch and only gets modified 927 quarterly basis from the current branch and only gets modified
928 for security updates. The names of the stable branches are built 928 for security updates. The names of the stable branches are built
929 from the year and the quarter, for example 929 from the year and the quarter, for example
930 <code class="literal">2018Q3</code>.</p> 930 <code class="literal">2018Q4</code>.</p>
931<p>The second step is to decide <span class="emphasis"><em>how</em></span> you 931<p>The second step is to decide <span class="emphasis"><em>how</em></span> you
932 want to download pkgsrc. You can get it as a tar file or via CVS. 932 want to download pkgsrc. You can get it as a tar file or via CVS.
933 Both ways are described here.</p> 933 Both ways are described here.</p>
934<p>Note that tar archive contains CVS working copy. 934<p>Note that tar archive contains CVS working copy.
935 Thus you can switch to using CVS at any later time.</p> 935 Thus you can switch to using CVS at any later time.</p>
936<div class="sect2"> 936<div class="sect2">
937<div class="titlepage"><div><div><h3 class="title"> 937<div class="titlepage"><div><div><h3 class="title">
938<a name="getting-via-tar"></a>2.1.1. As tar archive</h3></div></div></div> 938<a name="getting-via-tar"></a>2.1.1. As tar archive</h3></div></div></div>
939<p>The primary download location for all pkgsrc files is 939<p>The primary download location for all pkgsrc files is
940 <a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/" target="_top">http://ftp.NetBSD.org/pub/pkgsrc/</a> or 940 <a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/" target="_top">http://ftp.NetBSD.org/pub/pkgsrc/</a> or
941 <a class="ulink" href="ftp://ftp.NetBSD.org/pub/pkgsrc/" target="_top">ftp://ftp.NetBSD.org/pub/pkgsrc/</a> 941 <a class="ulink" href="ftp://ftp.NetBSD.org/pub/pkgsrc/" target="_top">ftp://ftp.NetBSD.org/pub/pkgsrc/</a>
942 (it points to the same location). 942 (it points to the same location).
943 There are a number of subdirectories for different purposes, 943 There are a number of subdirectories for different purposes,
944 which are described in detail in <a class="xref" href="#ftp-layout" title="Appendix C. Directory layout of the pkgsrc FTP server">Appendix C, <i>Directory layout of the pkgsrc FTP server</i></a>.</p> 944 which are described in detail in <a class="xref" href="#ftp-layout" title="Appendix C. Directory layout of the pkgsrc FTP server">Appendix C, <i>Directory layout of the pkgsrc FTP server</i></a>.</p>
945<p>The tar archive for the current branch is in the directory 945<p>The tar archive for the current branch is in the directory
946 <code class="filename">current</code> and is called <a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz" target="_top"><code class="filename">pkgsrc.tar.gz</code></a>. 946 <code class="filename">current</code> and is called <a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz" target="_top"><code class="filename">pkgsrc.tar.gz</code></a>.
947 It is autogenerated weekly.</p> 947 It is autogenerated weekly.</p>
948<p>To save download time we provide bzip2- and 948<p>To save download time we provide bzip2- and
949 xz-compressed archives which are published at 949 xz-compressed archives which are published at
950 <a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.bz2" target="_top"><code class="filename">pkgsrc.tar.bz2</code></a> 950 <a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.bz2" target="_top"><code class="filename">pkgsrc.tar.bz2</code></a>
951 and 951 and
952 <a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.xz" target="_top"><code class="filename">pkgsrc.tar.xz</code></a> 952 <a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.xz" target="_top"><code class="filename">pkgsrc.tar.xz</code></a>
953 respectively. 953 respectively.
954 </p> 954 </p>
955<p>You can fetch the same files using FTP.</p> 955<p>You can fetch the same files using FTP.</p>
956<p>The tar file for the stable branch 2018Q3 is in the 956<p>The tar file for the stable branch 2018Q4 is in the
957 directory <code class="filename">pkgsrc-2018Q3</code> and is also called <a class="ulink" href="https://cdn.NetBSD.org/pub/pkgsrc/pkgsrc-2018Q3/pkgsrc.tar.gz" target="_top"><code class="filename">pkgsrc.tar.gz</code></a>.</p> 957 directory <code class="filename">pkgsrc-2018Q4</code> and is also called <a class="ulink" href="https://cdn.NetBSD.org/pub/pkgsrc/pkgsrc-2018Q4/pkgsrc.tar.gz" target="_top"><code class="filename">pkgsrc.tar.gz</code></a>.</p>
958<p>To download the latest pkgsrc stable tarball, run:</p> 958<p>To download the latest pkgsrc stable tarball, run:</p>
959<pre class="screen"> 959<pre class="screen">
960<code class="prompt">$</code> <strong class="userinput"><code>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2018Q3/pkgsrc.tar.gz</code></strong></pre> 960<code class="prompt">$</code> <strong class="userinput"><code>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2018Q4/pkgsrc.tar.gz</code></strong></pre>
961<p>If you prefer, you can also fetch it using "wget", "curl", 961<p>If you prefer, you can also fetch it using "wget", "curl",
962 or your web browser.</p> 962 or your web browser.</p>
963<p>Then, extract it with:</p> 963<p>Then, extract it with:</p>
964<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>tar -xzf pkgsrc.tar.gz -C /usr</code></strong></pre> 964<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>tar -xzf pkgsrc.tar.gz -C /usr</code></strong></pre>
965<p>This will create the directory <code class="filename">pkgsrc/</code> 965<p>This will create the directory <code class="filename">pkgsrc/</code>
966 in <code class="filename">/usr/</code> and all the package source will be  966 in <code class="filename">/usr/</code> and all the package source will be
967 stored under <code class="filename">/usr/pkgsrc/</code>.</p> 967 stored under <code class="filename">/usr/pkgsrc/</code>.</p>
968<p>To download pkgsrc-current, run:</p> 968<p>To download pkgsrc-current, run:</p>
969<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz</code></strong></pre> 969<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz</code></strong></pre>
970</div> 970</div>
971<div class="sect2"> 971<div class="sect2">
972<div class="titlepage"><div><div><h3 class="title"> 972<div class="titlepage"><div><div><h3 class="title">
973<a name="getting-via-cvs"></a>2.1.2. Via anonymous CVS</h3></div></div></div> 973<a name="getting-via-cvs"></a>2.1.2. Via anonymous CVS</h3></div></div></div>
974<p>To fetch a specific pkgsrc stable branch, run:</p> 974<p>To fetch a specific pkgsrc stable branch, run:</p>
975<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr &amp;&amp; cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -r pkgsrc-2018Q3 -P pkgsrc</code></strong> 975<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr &amp;&amp; cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -r pkgsrc-2018Q4 -P pkgsrc</code></strong>
976</pre> 976</pre>
977<p>This will create the directory <code class="filename">pkgsrc/</code>  977<p>This will create the directory <code class="filename">pkgsrc/</code>
978 in your <code class="filename">/usr/</code> directory and all the package source  978 in your <code class="filename">/usr/</code> directory and all the package source
979 will be stored under <code class="filename">/usr/pkgsrc/</code>.</p> 979 will be stored under <code class="filename">/usr/pkgsrc/</code>.</p>
980<p>To fetch the pkgsrc current branch, run:</p> 980<p>To fetch the pkgsrc current branch, run:</p>
981<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr &amp;&amp; cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</code></strong> 981<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr &amp;&amp; cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</code></strong>
982</pre> 982</pre>
983<p>Refer to the <a class="ulink" href="http://www.NetBSD.org/mirrors/#anoncvs" target="_top">list of available mirrors</a> to choose a faster CVS mirror, if needed.</p> 983<p>Refer to the <a class="ulink" href="http://www.NetBSD.org/mirrors/#anoncvs" target="_top">list of available mirrors</a> to choose a faster CVS mirror, if needed.</p>
984<p>If you get error messages from <code class="literal">rsh</code>, you need to set CVS_RSH variable. E.g.:</p> 984<p>If you get error messages from <code class="literal">rsh</code>, you need to set CVS_RSH variable. E.g.:</p>
985<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr &amp;&amp; env CVS_RSH=ssh cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</code></strong> 985<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr &amp;&amp; env CVS_RSH=ssh cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</code></strong>
986</pre> 986</pre>
987<p>Refer to documentation on your command shell how to set CVS_RSH=ssh permanently. 987<p>Refer to documentation on your command shell how to set CVS_RSH=ssh permanently.
988 For Bourne shells, you can set it in your <code class="filename">.profile</code> 988 For Bourne shells, you can set it in your <code class="filename">.profile</code>
@@ -1047,27 +1047,27 @@ release -d @@ -1047,27 +1047,27 @@ release -d
1047</pre> 1047</pre>
1048<p>If you get error messages from <code class="literal">rsh</code>, you need to set CVS_RSH variable as described above. E.g.:</p> 1048<p>If you get error messages from <code class="literal">rsh</code>, you need to set CVS_RSH variable as described above. E.g.:</p>
1049<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr/pkgsrc &amp;&amp; env CVS_RSH=ssh cvs up -dP</code></strong> 1049<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr/pkgsrc &amp;&amp; env CVS_RSH=ssh cvs up -dP</code></strong>
1050</pre> 1050</pre>
1051<div class="sect3"> 1051<div class="sect3">
1052<div class="titlepage"><div><div><h4 class="title"> 1052<div class="titlepage"><div><div><h4 class="title">
1053<a name="uptodate-cvs-switch"></a>2.2.2.1. Switching between different pkgsrc branches</h4></div></div></div> 1053<a name="uptodate-cvs-switch"></a>2.2.2.1. Switching between different pkgsrc branches</h4></div></div></div>
1054<p>When updating pkgsrc, the CVS program keeps track of the 1054<p>When updating pkgsrc, the CVS program keeps track of the
1055 branch you selected. But if you, for whatever reason, want to 1055 branch you selected. But if you, for whatever reason, want to
1056 switch from the stable branch to the current one, you can do it 1056 switch from the stable branch to the current one, you can do it
1057 by adding the option <span class="quote">&#8220;<span class="quote">-A</span>&#8221;</span> after the 1057 by adding the option <span class="quote">&#8220;<span class="quote">-A</span>&#8221;</span> after the
1058 <span class="quote">&#8220;<span class="quote">update</span>&#8221;</span> keyword. To switch from the current branch 1058 <span class="quote">&#8220;<span class="quote">update</span>&#8221;</span> keyword. To switch from the current branch
1059 back to the stable branch, add the 1059 back to the stable branch, add the
1060 <span class="quote">&#8220;<span class="quote">-rpkgsrc-2018Q3</span>&#8221;</span> option.</p> 1060 <span class="quote">&#8220;<span class="quote">-rpkgsrc-2018Q4</span>&#8221;</span> option.</p>
1061</div> 1061</div>
1062<div class="sect3"> 1062<div class="sect3">
1063<div class="titlepage"><div><div><h4 class="title"> 1063<div class="titlepage"><div><div><h4 class="title">
1064<a name="uptodate-cvs-changes"></a>2.2.2.2. What happens to my changes when updating?</h4></div></div></div> 1064<a name="uptodate-cvs-changes"></a>2.2.2.2. What happens to my changes when updating?</h4></div></div></div>
1065<p>When you update pkgsrc, the CVS program will only touch 1065<p>When you update pkgsrc, the CVS program will only touch
1066 those files that are registered in the CVS repository. That 1066 those files that are registered in the CVS repository. That
1067 means that any packages that you created on your own will stay 1067 means that any packages that you created on your own will stay
1068 unmodified. If you change files that are managed by CVS, later 1068 unmodified. If you change files that are managed by CVS, later
1069 updates will try to merge your changes with those that have been 1069 updates will try to merge your changes with those that have been
1070 done by others. See the CVS manual, chapter 1070 done by others. See the CVS manual, chapter
1071 <span class="quote">&#8220;<span class="quote">update</span>&#8221;</span> for details.</p> 1071 <span class="quote">&#8220;<span class="quote">update</span>&#8221;</span> for details.</p>
1072</div> 1072</div>
1073</div> 1073</div>
@@ -3552,27 +3552,32 @@ converters games mbone  @@ -3552,27 +3552,32 @@ converters games mbone
3552<div class="sect1"> 3552<div class="sect1">
3553<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 3553<div class="titlepage"><div><div><h2 class="title" style="clear: both">
3554<a name="components.distinfo"></a>11.2. <code class="filename">distinfo</code> 3554<a name="components.distinfo"></a>11.2. <code class="filename">distinfo</code>
3555</h2></div></div></div> 3555</h2></div></div></div>
3556<p>The <code class="filename">distinfo</code> file contains the message 3556<p>The <code class="filename">distinfo</code> file contains the message
3557 digest, or checksum, of each distfile needed for the package. This 3557 digest, or checksum, of each distfile needed for the package. This
3558 ensures that the distfiles retrieved from the Internet have not been 3558 ensures that the distfiles retrieved from the Internet have not been
3559 corrupted during transfer or altered by a malign force to introduce 3559 corrupted during transfer or altered by a malign force to introduce
3560 a security hole. To provide maximum security, all distfiles are 3560 a security hole. To provide maximum security, all distfiles are
3561 protected using three different message digest algorithms (SHA1, 3561 protected using three different message digest algorithms (SHA1,
3562 RMD160, SHA512), as well as the file size.</p> 3562 RMD160, SHA512), as well as the file size.</p>
3563<p>The <code class="filename">distinfo</code> file also contains the 3563<p>The <code class="filename">distinfo</code> file also contains the
3564 checksums for all the patches found in the 3564 checksums for all the patches found in the
3565 <code class="filename">patches</code> directory (see <a class="xref" href="#components.patches" title="11.3. patches/*">Section 11.3, &#8220;<code class="filename">patches/*</code>&#8221;</a>).</p> 3565 <code class="filename">patches</code> directory (see <a class="xref" href="#components.patches" title="11.3. patches/*">Section 11.3, &#8220;<code class="filename">patches/*</code>&#8221;</a>). These checksums ensure that patches
 3566 are only applied intentionally and that they don't accidentally change,
 3567 e.g. when merging different changes together. They also make sure that
 3568 new patches are actually added to CVS and old ones are removed.
 3569 Too see whether the patches and the <code class="filename">distinfo</code> file
 3570 match, run <span class="command"><strong>pkglint</strong></span> after changing the patches.</p>
3566<p>To regenerate the <code class="filename">distinfo</code> file, use the 3571<p>To regenerate the <code class="filename">distinfo</code> file, use the
3567 <span class="command"><strong>make distinfo</strong></span> command.</p> 3572 <span class="command"><strong>make distinfo</strong></span> command.</p>
3568<p>Some packages have different sets of distfiles depending on 3573<p>Some packages have different sets of distfiles depending on
3569 the platform, for example <a href="https://cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/lang/openjdk7/README.html" target="_top"><code class="filename">lang/openjdk7</code></a>. These are kept in the same 3574 the platform, for example <a href="https://cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/lang/openjdk7/README.html" target="_top"><code class="filename">lang/openjdk7</code></a>. These are kept in the same
3570 <code class="filename">distinfo</code> file and care should be taken when 3575 <code class="filename">distinfo</code> file and care should be taken when
3571 upgrading such a package to ensure distfile information is not 3576 upgrading such a package to ensure distfile information is not
3572 lost.</p> 3577 lost.</p>
3573</div> 3578</div>
3574<div class="sect1"> 3579<div class="sect1">
3575<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 3580<div class="titlepage"><div><div><h2 class="title" style="clear: both">
3576<a name="components.patches"></a>11.3. <code class="filename">patches/*</code> 3581<a name="components.patches"></a>11.3. <code class="filename">patches/*</code>
3577</h2></div></div></div> 3582</h2></div></div></div>
3578<p>Some packages don't work out-of-the box on the various 3583<p>Some packages don't work out-of-the box on the various
@@ -8825,27 +8830,27 @@ place.

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

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

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

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

cvs diff -r1.255 -r1.256 pkgsrc/doc/pkgsrc.txt (expand / switch to unified diff)

--- pkgsrc/doc/pkgsrc.txt 2018/10/03 21:15:09 1.255
+++ pkgsrc/doc/pkgsrc.txt 2018/12/30 23:26:35 1.256
@@ -789,74 +789,74 @@ Before you download and extract the file @@ -789,74 +789,74 @@ Before you download and extract the file
789extract them. When using pkgsrc as root user, pkgsrc is usually installed in / 789extract them. When using pkgsrc as root user, pkgsrc is usually installed in /
790usr/pkgsrc. You are though free to install the sources and binary packages 790usr/pkgsrc. You are though free to install the sources and binary packages
791wherever you want in your filesystem, provided that the pathname does not 791wherever you want in your filesystem, provided that the pathname does not
792contain white-space or other characters that are interpreted specially by the 792contain white-space or other characters that are interpreted specially by the
793shell and some other programs. A safe bet is to use only letters, digits, 793shell and some other programs. A safe bet is to use only letters, digits,
794underscores and dashes. 794underscores and dashes.
795 795
7962.1. Getting pkgsrc for the first time 7962.1. Getting pkgsrc for the first time
797 797
798Before you download any pkgsrc files, you should decide whether you want the  798Before you download any pkgsrc files, you should decide whether you want the
799current branch or the stable branch. The latter is forked on a quarterly basis 799current branch or the stable branch. The latter is forked on a quarterly basis
800from the current branch and only gets modified for security updates. The names 800from the current branch and only gets modified for security updates. The names
801of the stable branches are built from the year and the quarter, for example 801of the stable branches are built from the year and the quarter, for example
8022018Q3. 8022018Q4.
803 803
804The second step is to decide how you want to download pkgsrc. You can get it as 804The second step is to decide how you want to download pkgsrc. You can get it as
805a tar file or via CVS. Both ways are described here. 805a tar file or via CVS. Both ways are described here.
806 806
807Note that tar archive contains CVS working copy. Thus you can switch to using 807Note that tar archive contains CVS working copy. Thus you can switch to using
808CVS at any later time. 808CVS at any later time.
809 809
8102.1.1. As tar archive 8102.1.1. As tar archive
811 811
812The primary download location for all pkgsrc files is http://ftp.NetBSD.org/pub 812The primary download location for all pkgsrc files is http://ftp.NetBSD.org/pub
813/pkgsrc/ or ftp://ftp.NetBSD.org/pub/pkgsrc/ (it points to the same location). 813/pkgsrc/ or ftp://ftp.NetBSD.org/pub/pkgsrc/ (it points to the same location).
814There are a number of subdirectories for different purposes, which are 814There are a number of subdirectories for different purposes, which are
815described in detail in Appendix C, Directory layout of the pkgsrc FTP server. 815described in detail in Appendix C, Directory layout of the pkgsrc FTP server.
816 816
817The tar archive for the current branch is in the directory current and is 817The tar archive for the current branch is in the directory current and is
818called pkgsrc.tar.gz. It is autogenerated weekly. 818called pkgsrc.tar.gz. It is autogenerated weekly.
819 819
820To save download time we provide bzip2- and xz-compressed archives which are 820To save download time we provide bzip2- and xz-compressed archives which are
821published at pkgsrc.tar.bz2 and pkgsrc.tar.xz respectively. 821published at pkgsrc.tar.bz2 and pkgsrc.tar.xz respectively.
822 822
823You can fetch the same files using FTP. 823You can fetch the same files using FTP.
824 824
825The tar file for the stable branch 2018Q3 is in the directory pkgsrc-2018Q3 and 825The tar file for the stable branch 2018Q4 is in the directory pkgsrc-2018Q4 and
826is also called pkgsrc.tar.gz. 826is also called pkgsrc.tar.gz.
827 827
828To download the latest pkgsrc stable tarball, run: 828To download the latest pkgsrc stable tarball, run:
829 829
830$ ftp ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2018Q3/pkgsrc.tar.gz 830$ ftp ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2018Q4/pkgsrc.tar.gz
831 831
832If you prefer, you can also fetch it using "wget", "curl", or your web browser. 832If you prefer, you can also fetch it using "wget", "curl", or your web browser.
833 833
834Then, extract it with: 834Then, extract it with:
835 835
836$ tar -xzf pkgsrc.tar.gz -C /usr 836$ tar -xzf pkgsrc.tar.gz -C /usr
837 837
838This will create the directory pkgsrc/ in /usr/ and all the package source will 838This will create the directory pkgsrc/ in /usr/ and all the package source will
839be stored under /usr/pkgsrc/. 839be stored under /usr/pkgsrc/.
840 840
841To download pkgsrc-current, run: 841To download pkgsrc-current, run:
842 842
843$ ftp ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz 843$ ftp ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz
844 844
8452.1.2. Via anonymous CVS 8452.1.2. Via anonymous CVS
846 846
847To fetch a specific pkgsrc stable branch, run: 847To fetch a specific pkgsrc stable branch, run:
848 848
849$ cd /usr && cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -r pkgsrc-2018Q3 -P pkgsrc 849$ cd /usr && cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -r pkgsrc-2018Q4 -P pkgsrc
850 850
851This will create the directory pkgsrc/ in your /usr/ directory and all the 851This will create the directory pkgsrc/ in your /usr/ directory and all the
852package source will be stored under /usr/pkgsrc/. 852package source will be stored under /usr/pkgsrc/.
853 853
854To fetch the pkgsrc current branch, run: 854To fetch the pkgsrc current branch, run:
855 855
856$ cd /usr && cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc 856$ cd /usr && cvs -q -z2 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc
857 857
858Refer to the list of available mirrors to choose a faster CVS mirror, if 858Refer to the list of available mirrors to choose a faster CVS mirror, if
859needed. 859needed.
860 860
861If you get error messages from rsh, you need to set CVS_RSH variable. E.g.: 861If you get error messages from rsh, you need to set CVS_RSH variable. E.g.:
862 862
@@ -918,27 +918,27 @@ To update pkgsrc via CVS, change to the  @@ -918,27 +918,27 @@ To update pkgsrc via CVS, change to the
918$ cd /usr/pkgsrc && cvs update -dP 918$ cd /usr/pkgsrc && cvs update -dP
919 919
920If you get error messages from rsh, you need to set CVS_RSH variable as 920If you get error messages from rsh, you need to set CVS_RSH variable as
921described above. E.g.: 921described above. E.g.:
922 922
923$ cd /usr/pkgsrc && env CVS_RSH=ssh cvs up -dP 923$ cd /usr/pkgsrc && env CVS_RSH=ssh cvs up -dP
924 924
9252.2.2.1. Switching between different pkgsrc branches 9252.2.2.1. Switching between different pkgsrc branches
926 926
927When updating pkgsrc, the CVS program keeps track of the branch you selected. 927When updating pkgsrc, the CVS program keeps track of the branch you selected.
928But if you, for whatever reason, want to switch from the stable branch to the 928But if you, for whatever reason, want to switch from the stable branch to the
929current one, you can do it by adding the option "-A" after the "update" 929current one, you can do it by adding the option "-A" after the "update"
930keyword. To switch from the current branch back to the stable branch, add the " 930keyword. To switch from the current branch back to the stable branch, add the "
931-rpkgsrc-2018Q3" option. 931-rpkgsrc-2018Q4" option.
932 932
9332.2.2.2. What happens to my changes when updating? 9332.2.2.2. What happens to my changes when updating?
934 934
935When you update pkgsrc, the CVS program will only touch those files that are 935When you update pkgsrc, the CVS program will only touch those files that are
936registered in the CVS repository. That means that any packages that you created 936registered in the CVS repository. That means that any packages that you created
937on your own will stay unmodified. If you change files that are managed by CVS, 937on your own will stay unmodified. If you change files that are managed by CVS,
938later updates will try to merge your changes with those that have been done by 938later updates will try to merge your changes with those that have been done by
939others. See the CVS manual, chapter "update" for details. 939others. See the CVS manual, chapter "update" for details.
940 940
941Chapter 3. Using pkgsrc on systems other than NetBSD 941Chapter 3. Using pkgsrc on systems other than NetBSD
942 942
943Table of Contents 943Table of Contents
944 944
@@ -3046,27 +3046,31 @@ Please pay attention to the following go @@ -3046,27 +3046,31 @@ Please pay attention to the following go
3046 * If the package installs any info files, see Section 19.6.7, "Packages 3046 * If the package installs any info files, see Section 19.6.7, "Packages
3047 installing info files". 3047 installing info files".
3048 3048
304911.2. distinfo 304911.2. distinfo
3050 3050
3051The distinfo file contains the message digest, or checksum, of each distfile 3051The distinfo file contains the message digest, or checksum, of each distfile
3052needed for the package. This ensures that the distfiles retrieved from the 3052needed for the package. This ensures that the distfiles retrieved from the
3053Internet have not been corrupted during transfer or altered by a malign force 3053Internet have not been corrupted during transfer or altered by a malign force
3054to introduce a security hole. To provide maximum security, all distfiles are 3054to introduce a security hole. To provide maximum security, all distfiles are
3055protected using three different message digest algorithms (SHA1, RMD160, 3055protected using three different message digest algorithms (SHA1, RMD160,
3056SHA512), as well as the file size. 3056SHA512), as well as the file size.
3057 3057
3058The distinfo file also contains the checksums for all the patches found in the 3058The distinfo file also contains the checksums for all the patches found in the
3059patches directory (see Section 11.3, "patches/*"). 3059patches directory (see Section 11.3, "patches/*"). These checksums ensure that
 3060patches are only applied intentionally and that they don't accidentally change,
 3061e.g. when merging different changes together. They also make sure that new
 3062patches are actually added to CVS and old ones are removed. Too see whether the
 3063patches and the distinfo file match, run pkglint after changing the patches.
3060 3064
3061To regenerate the distinfo file, use the make distinfo command. 3065To regenerate the distinfo file, use the make distinfo command.
3062 3066
3063Some packages have different sets of distfiles depending on the platform, for 3067Some packages have different sets of distfiles depending on the platform, for
3064example lang/openjdk7. These are kept in the same distinfo file and care should 3068example lang/openjdk7. These are kept in the same distinfo file and care should
3065be taken when upgrading such a package to ensure distfile information is not 3069be taken when upgrading such a package to ensure distfile information is not
3066lost. 3070lost.
3067 3071
306811.3. patches/* 307211.3. patches/*
3069 3073
3070Some packages don't work out-of-the box on the various platforms that are 3074Some packages don't work out-of-the box on the various platforms that are
3071supported by pkgsrc. These packages need to be patched to make them work. The 3075supported by pkgsrc. These packages need to be patched to make them work. The
3072patch files can be found in the patches/ directory. 3076patch files can be found in the patches/ directory.