pkgsrc-Changes archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
CVS commit: pkgsrc/doc
Module Name: pkgsrc
Committed By: leot
Date: Mon Jan 6 21:35:51 UTC 2020
Modified Files:
pkgsrc/doc: pkgsrc.html pkgsrc.txt
Log Message:
doc/pkgsrc.*: regen
To generate a diff of this commit:
cvs rdiff -u -r1.281 -r1.282 pkgsrc/doc/pkgsrc.html
cvs rdiff -u -r1.279 -r1.280 pkgsrc/doc/pkgsrc.txt
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: pkgsrc/doc/pkgsrc.html
diff -u pkgsrc/doc/pkgsrc.html:1.281 pkgsrc/doc/pkgsrc.html:1.282
--- pkgsrc/doc/pkgsrc.html:1.281 Fri Jan 3 15:57:53 2020
+++ pkgsrc/doc/pkgsrc.html Mon Jan 6 21:35:51 2020
@@ -977,7 +977,7 @@ and dashes.</p>
quarterly basis from the current branch and only gets modified
for security updates. The names of the stable branches are built
from the year and the quarter, for example
- <code class="literal">2019Q3</code>.</p>
+ <code class="literal">2019Q4</code>.</p>
<p>The second step is to decide <span class="emphasis"><em>how</em></span> you
want to download pkgsrc. You can get it as a tar file or via CVS.
Both ways are described here.</p>
@@ -1003,11 +1003,11 @@ and dashes.</p>
respectively.
</p>
<p>You can fetch the same files using FTP.</p>
-<p>The tar file for the stable branch 2019Q3 is in the
- directory <code class="filename">pkgsrc-2019Q3</code> and is also called <a class="ulink" href="https://cdn.NetBSD.org/pub/pkgsrc/pkgsrc-2019Q3/pkgsrc.tar.gz"; target="_top"><code
class="filename">pkgsrc.tar.gz</code></a>.</p>
+<p>The tar file for the stable branch 2019Q4 is in the
+ directory <code class="filename">pkgsrc-2019Q4</code> and is also called <a class="ulink" href="https://cdn.NetBSD.org/pub/pkgsrc/pkgsrc-2019Q4/pkgsrc.tar.gz"; target="_top"><code
class="filename">pkgsrc.tar.gz</code></a>.</p>
<p>To download the latest pkgsrc stable tarball, run:</p>
<pre class="screen">
-<code class="prompt">$</code> <strong class="userinput"><code>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2019Q3/pkgsrc.tar.gz</code></strong></pre>
+<code class="prompt">$</code> <strong class="userinput"><code>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2019Q4/pkgsrc.tar.gz</code></strong></pre>
<p>If you prefer, you can also fetch it using "wget", "curl",
or your web browser.</p>
<p>Then, extract it with:</p>
@@ -1022,7 +1022,7 @@ and dashes.</p>
<div class="titlepage"><div><div><h3 class="title">
<a name="getting-via-cvs"></a>3.1.2.�Via anonymous CVS</h3></div></div></div>
<p>To fetch a specific pkgsrc stable branch, run:</p>
-<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr && cvs -q -z2 -d anoncvs%anoncvs.NetBSD.org@localhost:/cvsroot checkout -r pkgsrc-2019Q3 -P
pkgsrc</code></strong>
+<pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>cd /usr && cvs -q -z2 -d anoncvs%anoncvs.NetBSD.org@localhost:/cvsroot checkout -r pkgsrc-2019Q4 -P
pkgsrc</code></strong>
</pre>
<p>This will create the directory <code class="filename">pkgsrc/</code>
in your <code class="filename">/usr/</code> directory and all the package source
@@ -1107,7 +1107,7 @@ release -d
by adding the option <span class="quote">“<span class="quote">-A</span>”</span> after the
<span class="quote">“<span class="quote">update</span>”</span> keyword. To switch from the current branch
back to the stable branch, add the
- <span class="quote">“<span class="quote">-rpkgsrc-2019Q3</span>”</span> option.</p>
+ <span class="quote">“<span class="quote">-rpkgsrc-2019Q4</span>”</span> option.</p>
</div>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
@@ -1352,7 +1352,7 @@ and you can still use binary packages fr
<a class="ulink" href="http://ftp.NetBSD.org/pub/pkgsrc/distfiles/vulnerabilities"; target="_top">vulnerabilities</a>
file downloaded daily so that
it remains current. This may be done by adding an appropriate entry
- to the root users <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?crontab+5.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">crontab</span>(5)</span></a> entry. For example the entry
+ to the root users <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?crontab+5.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">crontab</span>(5)</span></a> entry. For example the entry
</p>
<pre class="screen">
# Download vulnerabilities file
@@ -1381,7 +1381,7 @@ fetch_pkg_vulnerabilities=YES
check_pkg_vulnerabilities=YES
</pre>
<p>
- see <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?daily.conf+5.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">daily.conf</span>(5)</span></a> and
<a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?security.conf+5.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">security.conf</span>(5)</span></a> for more
details.
+ see <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?daily.conf+5.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">daily.conf</span>(5)</span></a> and
<a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?security.conf+5.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">security.conf</span>(5)</span></a> for more
details.
</p>
</div>
<div class="sect2">
@@ -1572,7 +1572,7 @@ Version mismatch: 'tcsh' 6.09.00 vs 6.10
help with this.</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
-<p>If you invoke the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a>
command with
+<p>If you invoke the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a>
command with
<code class="varname">PKG_DEBUG_LEVEL=2</code>, then a huge amount of
information will be displayed. For example,</p>
<pre class="screen"><strong class="userinput"><code>make patch PKG_DEBUG_LEVEL=2</code></strong></pre>
@@ -1580,10 +1580,10 @@ Version mismatch: 'tcsh' 6.09.00 vs 6.10
including the <span class="quote">“<span class="quote">patch</span>”</span> stage.</p>
</li>
<li class="listitem">
-<p>If you want to know the value of a certain <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a>
+<p>If you want to know the value of a certain <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a>
definition, then the <code class="varname">VARNAME</code> definition
should be used, in conjunction with the show-var
- target. e.g. to show the expansion of the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a>
+ target. e.g. to show the expansion of the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a>
variable <code class="varname">LOCALBASE</code>:</p>
<pre class="screen">
<code class="prompt">%</code> <strong class="userinput"><code>make show-var VARNAME=LOCALBASE</code></strong>
@@ -1596,11 +1596,11 @@ Version mismatch: 'tcsh' 6.09.00 vs 6.10
created yourself (see next section), that you put into
pkgsrc/packages manually or that is located on a remote FTP
server, you can use the "bin-install" target. This target will
- install a binary package - if available - via <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>,
+ install a binary package - if available - via <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>,
else do a <span class="command"><strong>make package</strong></span>. The list of remote FTP
sites searched is kept in the variable
<code class="varname">BINPKG_SITES</code>, which defaults to
- ftp.NetBSD.org. Any flags that should be added to <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>
+ ftp.NetBSD.org. Any flags that should be added to <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>
can be put into <code class="varname">BIN_INSTALL_FLAGS</code>. See
<code class="filename">pkgsrc/mk/defaults/mk.conf</code> for more
details.</p>
@@ -1639,7 +1639,7 @@ Version mismatch: 'tcsh' 6.09.00 vs 6.10
<a name="mk.conf"></a><p>The whole pkgsrc system is configured in a single file, usually
called <code class="filename">mk.conf</code>. In which directory pkgsrc looks for
that file depends on the installation. On NetBSD, when you use
-<a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> from the base system, it
is in the directory
+<a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> from the base system, it
is in the directory
<code class="filename">/etc/</code>. In all other cases the default location is
<code class="literal">${PREFIX}/etc/</code>, depending on where you told the
bootstrap program to install the binary packages.</p>
@@ -1781,7 +1781,7 @@ uid=1000(myusername) gid=100(users) grou
<p>
For the following command, you must be able to gain root
- privileges using <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?su+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">su</span>(1)</span></a>
+ privileges using <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?su+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">su</span>(1)</span></a>
</p>
<pre class="programlisting">
@@ -2022,7 +2022,7 @@ PKG_OPTIONS.apache= suexec </pre>
<a name="building-a-single-binary-package"></a>7.1.�Building a single binary package</h2></div></div></div>
<p>Once you have built and installed a package, you can create
a <span class="emphasis"><em>binary package</em></span> which can be installed on
- another system with <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>. This saves having to build
+ another system with <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>. This saves having to build
the same package on a group of hosts and wasting CPU time. It also
provides a simple means for others to install your package, should
you distribute it.</p>
@@ -2613,7 +2613,7 @@ but downloading the entire directory may
<p>The answer here is to do a <span class="command"><strong>make fetch-list</strong></span> in
<code class="filename">/usr/pkgsrc</code> or one of its subdirectories, carry the
resulting list to your machine at work/school and use it there. If you
-don't have a NetBSD-compatible <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?ftp+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">ftp</span>(1)</span></a> (like tnftp) at work, don't
+don't have a NetBSD-compatible <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?ftp+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">ftp</span>(1)</span></a> (like tnftp) at work, don't
forget to set <code class="varname">FETCH_CMD</code> to something that fetches a
URL:</p>
<p>At home:</p>
@@ -2665,7 +2665,7 @@ the one that corresponds to your release
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="using-sudo-with-pkgsrc"></a>10.12.�Using 'sudo' with pkgsrc</h2></div></div></div>
<p>When installing packages as non-root user and using the just-in-time
-<a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?su+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">su</span>(1)</span></a> feature of pkgsrc, it can
become annoying to type in the root
+<a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?su+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">su</span>(1)</span></a> feature of pkgsrc, it can
become annoying to type in the root
password for each required package installed. To avoid this, the sudo
package can be used, which does password caching over a limited time. To
use it, install sudo (either as binary package or from
@@ -2739,7 +2739,7 @@ perform a security check before building
<code class="varname">CFLAGS</code> variable in your
<a class="link" href="#mk.conf"><code class="filename">mk.conf</code></a>, these flags are passed in
environment variables to the <code class="filename">./configure</code>
- scripts and to <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a>.
Some package authors ignore the
+ scripts and to <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a>.
Some package authors ignore the
<code class="varname">CFLAGS</code> from the environment variable by
overriding them in the <code class="filename">Makefile</code>s of their
package.</p>
@@ -3632,7 +3632,7 @@ converters games mbone
Primary location(s) for distribution patch files (see
<code class="varname">PATCHFILES</code> above) if not found locally.</p></li>
<li class="listitem"><p><code class="varname">PATCH_DIST_STRIP</code>:
- an argument to <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?patch+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">patch</span>(1)</span></a> that
sets the pathname strip count to
+ an argument to <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?patch+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">patch</span>(1)</span></a> that
sets the pathname strip count to
help find the correct files to patch. It defaults to
<span class="command"><strong>-p0</strong></span>.</p></li>
</ul></div>
@@ -3642,7 +3642,7 @@ converters games mbone
<li class="listitem"><p><code class="varname">MAINTAINER</code> is the email
address of the person who feels responsible for this package,
and who is most likely to look at problems or questions regarding
- this package which have been reported with <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?send-pr+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">send-pr</span>(1)</span></a>.
+ this package which have been reported with <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?send-pr+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">send-pr</span>(1)</span></a>.
Other developers may contact the <code class="varname">MAINTAINER</code>
before making changes to the package, but are not required to
do so. When packaging a new program, set <code class="varname">MAINTAINER</code>
@@ -3995,13 +3995,13 @@ monitor_file(...)
<div class="variablelist"><dl class="variablelist">
<dt><span class="term"><code class="filename">INSTALL</code></span></dt>
<dd>
-<p>This shell script is invoked twice by <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>.
+<p>This shell script is invoked twice by <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>.
First time after package extraction and before files are
moved in place, the second time after the files to install
are moved in place. This can be used to do any custom
procedures not possible with @exec commands in
- <code class="filename">PLIST</code>. See <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a> and
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_create+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_create</span>(1)</span></a> for
more information. See also <a class="xref" href="#files-and-dirs-outside-prefix" title="17.1.�Files and directories outside the installation prefix">Section�17.1, “Files and directories
outside the installation prefix”</a>.
+ <code class="filename">PLIST</code>. See <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a> and
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_create+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_create</span>(1)</span></a>
for more information. See also <a class="xref" href="#files-and-dirs-outside-prefix" title="17.1.�Files and directories outside the installation prefix">Section�17.1, “Files and directories
outside the installation prefix”</a>.
Please note that you can modify variables in it easily by using
<code class="varname">FILES_SUBST</code> in the package's
<code class="filename">Makefile</code>:</p>
@@ -4021,8 +4021,8 @@ FILES_SUBST+= SOMEVAR="somevalue"
this script's responsibility to clean up any additional messy details
around the package's installation, since all pkg_delete knows is how to
delete the files created in the original distribution.
- See <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_delete</span>(1)</span></a>
- and <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_create+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_create</span>(1)</span></a>
for more information.
+ See <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_delete</span>(1)</span></a>
+ and <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_create+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_create</span>(1)</span></a> for more information.
The same methods to replace variables can be used as for
the <code class="filename">INSTALL</code> file.</p></dd>
<dt><span class="term"><code class="filename">MESSAGE</code></span></dt>
@@ -4161,13 +4161,13 @@ FILESDIR= ../../editors/xemacs/fil
</div>
<p>Pkgsrc consists of many <code class="filename">Makefile</code> fragments,
each of which forms a well-defined part of the pkgsrc system. Using
- the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> system as a
programming language for a big system
+ the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> system as a
programming language for a big system
like pkgsrc requires some discipline to keep the code correct and
understandable.</p>
<p>The basic ingredients for <code class="filename">Makefile</code>
programming are variables and shell
commands. Among these shell commands may even be more complex ones
- like <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?awk+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">awk</span>(1)</span></a> programs. To make
sure that every shell command runs
+ like <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?awk+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">awk</span>(1)</span></a> programs. To make
sure that every shell command runs
as intended it is necessary to quote all variables correctly when they
are used.</p>
<p>This chapter describes some patterns that appear quite often in
@@ -4181,7 +4181,7 @@ FILESDIR= ../../editors/xemacs/fil
target of a rule, always write the data to a temporary file first
and finally rename that file. Otherwise there might occur an error
in the middle of generating the file, and when the user runs
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> for the second time,
the file exists and will not be
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> for the second time,
the file exists and will not be
regenerated properly. Example:</p>
<pre class="programlisting">
wrong:
@@ -4199,11 +4199,11 @@ correct:
<code class="filename">wrong</code> will exist, although there was an error
message in the first run. On the other hand, running <span class="command"><strong>make
correct</strong></span> gives an error message twice, as expected.</p>
-<p>You might remember that <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a>
sometimes removes
+<p>You might remember that <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a> sometimes removes
<code class="literal">${.TARGET}</code> in case of error, but this only
happens when it is interrupted, for example by pressing
<code class="literal">Ctrl+C</code>. This does <span class="emphasis"><em>not</em></span> happen
- when one of the commands fails (like <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?false+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">false</span>(1)</span></a> above).</p>
+ when one of the commands fails (like <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?false+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">false</span>(1)</span></a> above).</p>
</li></ul></div>
</div>
<div class="sect1">
@@ -4212,7 +4212,7 @@ correct:
<p><code class="filename">Makefile</code> variables contain strings that
can be processed using the five operators <code class="code">=</code>,
<code class="code">+=</code>, <code class="code">?=</code>, <code class="code">:=</code> and
- <code class="code">!=</code>, which are described in the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a> man
+ <code class="code">!=</code>, which are described in the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a> man
page.</p>
<p>When a variable's value is parsed from a
<code class="filename">Makefile</code>, the hash character <code class="code">#</code> and
@@ -4230,7 +4230,7 @@ correct:
<p>Some of the modifiers split the string into words and then
operate on the words, others operate on the string as a whole. When a
string is split into words, double quotes and single quotes are
- interpreted as delimiters, just like in <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?sh+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">sh</span>(1)</span></a>.</p>
+ interpreted as delimiters, just like in <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?sh+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">sh</span>(1)</span></a>.</p>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
<a name="makefile.variables.names"></a>14.2.1.�Naming conventions</h3></div></div></div>
@@ -4287,11 +4287,11 @@ are just copied.</p>
<p>Example 2 quotes the string so that the shell interprets it
correctly. But the echo command may additionally interpret strings with a
leading dash or those containing backslashes.</p>
-<p>Example 3 can handle arbitrary strings, since <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?printf+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">printf</span>(1)</span></a> only
+<p>Example 3 can handle arbitrary strings, since <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?printf+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">printf</span>(1)</span></a> only
interprets the format string, but not the next argument. The trailing
single quotes handle the case when the string is empty. In that case, the
:Q modifier would result in an empty string too, which would then be
-skipped by the shell. For <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?printf+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">printf</span>(1)</span></a> this doesn't make a difference,
+skipped by the shell. For <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?printf+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">printf</span>(1)</span></a> this doesn't make a difference,
but other programs may care.</p>
<p>In example 4, the <code class="varname">EXAMPLE_ENV</code> does not
need to be quoted because the quoting has already been done
@@ -4335,7 +4335,7 @@ install-examples: # produces a syntax
done
</pre>
<p>The shell only sees the text <code class="code">for egfile in ; do</code>, since
-<code class="code">${EGFILES}</code> is replaced with an empty string by <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a>.
+<code class="code">${EGFILES}</code> is replaced with an empty string by <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a>.
To fix this syntax error, use one of the snippets below.</p>
<pre class="programlisting">
EMPTY= # empty
@@ -4384,7 +4384,7 @@ the following code: <code class="code">$
<span class="quote">“<span class="quote">packing list</span>”</span>, i.e. a list of files that belong to
the package (relative to the <code class="filename">${PREFIX}</code>
directory it's been installed in) plus some additional statements
- - see the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_create+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_create</span>(1)</span></a>
man page for a full list.
+ - see the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_create+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_create</span>(1)</span></a>
man page for a full list.
This chapter addresses some issues that need attention when
dealing with the <code class="filename">PLIST</code> file (or files, see
below!).</p>
@@ -4528,7 +4528,7 @@ adding the RCS ID the space should be om
<p>To use one or more files as source for the <code class="filename">PLIST</code> used
in generating the binary package, set the variable
<code class="varname">PLIST_SRC</code> to the names of that file(s).
- The files are later concatenated using <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?cat+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">cat</span>(1)</span></a>, and the order of things is
+ The files are later concatenated using <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?cat+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">cat</span>(1)</span></a>, and the order of things is
important. The default for <code class="varname">PLIST_SRC</code> is
<code class="filename">${PKGDIR}/PLIST</code>.</p>
</div>
@@ -5614,7 +5614,7 @@ options are supported by the package, an
if needed.</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p><code class="varname">PKG_OPTIONS_VAR</code> is the name of the
-<a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> variable that the user can
set to override the default
+<a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> variable that the user
can set to override the default
options. It should be set to
PKG_OPTIONS.<em class="replaceable"><code>pkgbase</code></em>. Do not set it to
PKG_OPTIONS.${PKGBASE}, since <code class="varname">PKGBASE</code> is not defined
@@ -5832,7 +5832,7 @@ details.</p>
<code class="varname">USE_IMAKE</code> to be installed correctly under
<code class="varname">LOCALBASE</code>.</p></li>
<li class="listitem"><p>Within <code class="filename">${PREFIX}</code>, packages should
- install files according to <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?hier+7.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">hier</span>(7)</span></a>, with the exception that
+ install files according to <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?hier+7.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">hier</span>(7)</span></a>, with the exception that
manual pages go into <code class="filename">${PREFIX}/man</code>, not
<code class="filename">${PREFIX}/share/man</code>.</p></li>
</ul></div>
@@ -6150,9 +6150,9 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
<code class="filename">.gz</code> are uncompressed before they are
applied, files ending in <code class="filename">.orig</code> or
<code class="filename">.rej</code> are ignored. Any special options to
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?patch+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">patch</span>(1)</span></a> can be handed in
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?patch+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">patch</span>(1)</span></a> can be handed in
<code class="varname">PATCH_DIST_ARGS</code>. See <a class="xref" href="#components.patches" title="13.3.�patches/*">Section�13.3, “<code class="filename">patches/*</code>”</a> for
more details.</p>
-<p>By default <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?patch+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">patch</span>(1)</span></a> is given
special args to make
+<p>By default <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?patch+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">patch</span>(1)</span></a> is given
special args to make
it fail if the patches apply with some lines of fuzz. Please
fix (regen) the patches so that they apply cleanly. The
rationale behind this is that patches that don't apply cleanly
@@ -6331,7 +6331,7 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
defined.</p>
<p>In the <span class="emphasis"><em>install</em></span> phase, the following
variables are useful. They are all variations of the
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?install+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">install</span>(1)</span></a> command that
have the owner, group and
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?install+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">install</span>(1)</span></a> command that
have the owner, group and
permissions preset. <code class="varname">INSTALL</code> is the plain
install command. The specialized variants, together with their
intended use, are:</p>
@@ -6377,7 +6377,7 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
<p>Some other variables are:</p>
<div class="variablelist"><dl class="variablelist">
<dt><span class="term"><code class="varname">INSTALL_UNSTRIPPED</code></span></dt>
-<dd><p>If set to <code class="literal">yes</code>, do not run <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?strip+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">strip</span>(1)</span></a>
+<dd><p>If set to <code class="literal">yes</code>, do not run <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?strip+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">strip</span>(1)</span></a>
when installing binaries. Any debugging sections and symbols present in
binaries will be preserved.
</p></dd>
@@ -6454,13 +6454,13 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
</dd>
<dt><span class="term">deinstall</span></dt>
<dd>
-<p>This target does a <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_delete</span>(1)</span></a> in the
+<p>This target does a <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_delete</span>(1)</span></a> in the
current directory, effectively de-installing the
package. The following variables can be used to tune the
behaviour:</p>
<div class="variablelist"><dl class="variablelist">
<dt><span class="term"><code class="varname">PKG_VERBOSE</code></span></dt>
-<dd><p>Add a "-v" to the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_delete</span>(1)</span></a> command.</p></dd>
+<dd><p>Add a "-v" to the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_delete</span>(1)</span></a> command.</p></dd>
<dt><span class="term"><code class="varname">DEINSTALLDEPENDS</code></span></dt>
<dd><p>Remove all packages that require (depend on)
the given package. This can be used to remove any
@@ -6469,7 +6469,7 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
DEINSTALLDEPENDS=1</strong></span> is done in
<code class="filename">pkgsrc/x11/kde</code>, this is
likely to remove whole KDE. Works by adding
- <span class="quote">“<span class="quote">-R</span>”</span> to the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span
class="citerefentry"><span class="refentrytitle">pkg_delete</span>(1)</span></a>
+ <span class="quote">“<span class="quote">-R</span>”</span> to the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span
class="citerefentry"><span class="refentrytitle">pkg_delete</span>(1)</span></a>
command line.</p></dd>
</dl></div>
</dd>
@@ -6621,7 +6621,7 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
recommended for advanced users.</p>
</dd>
<dt><span class="term">info</span></dt>
-<dd><p>This target invokes <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_info+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_info</span>(1)</span></a> for the current
+<dd><p>This target invokes <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_info+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_info</span>(1)</span></a> for the current
package. You can use this to check which version of a
package is installed.</p></dd>
<dt><span class="term">index</span></dt>
@@ -6737,7 +6737,7 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
<code class="filename">PLIST</code>. On upgrades, it's useful to
diff the output of this command against an already
existing <code class="filename">PLIST</code> file.</p>
-<p>If the package installs files via <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?tar+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">tar</span>(1)</span></a> or
+<p>If the package installs files via <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?tar+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">tar</span>(1)</span></a> or
other methods that don't update file access times, be
sure to add these files manually to your
<code class="filename">PLIST</code>, as the <span class="quote">“<span class="quote">find
@@ -6764,12 +6764,12 @@ builds)</i></a>).
<dd>
<p>Used during bulk-installs to install required
packages. If an up-to-date binary package is available,
- it will be installed via <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>. If not,
+ it will be installed via <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_add</span>(1)</span></a>. If not,
<span class="command"><strong>make bulk-package</strong></span> will be executed,
but the installed binary won't be removed.</p>
<p>A binary package is considered
<span class="quote">“<span class="quote">up-to-date</span>”</span> to be installed via
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_add</span>(1)</span></a> if:</p>
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_add</span>(1)</span></a> if:</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>None of the package's files
(<code class="filename">Makefile</code>, ...) were modified
@@ -6954,7 +6954,7 @@ TOOLS_PLATFORM.true?= true
variables in the file pointed to by <code class="varname">MAKECONF</code>,
which is <a class="link" href="#mk.conf"><code class="filename">mk.conf</code></a> by default. When you
want to use those variables in the preprocessor directives of
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> (for example <code
class="literal">.if</code> or
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> (for example <code
class="literal">.if</code> or
<code class="literal">.for</code>), you need to include the file
<code class="filename">../../mk/bsd.prefs.mk</code> before, which in turn
loads the user preferences.</p>
@@ -7204,7 +7204,7 @@ ACCEPTABLE_LICENSES+=xv-license
</pre>
<p>Please note that the <span class="quote">“<span class="quote">pre-req-package-name</span>”</span>
may include any of the wildcard version numbers recognized by
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_info+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_info</span>(1)</span></a>.</p>
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_info+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_info</span>(1)</span></a>.</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
<p>If your package needs another package's binaries or
@@ -7305,7 +7305,7 @@ CONFLICTS= Xaw-Xpm-[0-9]*
<pre class="programlisting">
CONFLICTS= libXaw3d-[0-9]*
</pre>
-<p><a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_add</span>(1)</span></a> is able to detect
attempts to install packages
+<p><a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_add</span>(1)</span></a> is able to
detect attempts to install packages
that conflict with existing packages and abort. However, in many
situations this is too late in the process. Binary package managers
will not know about the conflict until they attempt to install the
@@ -7316,7 +7316,7 @@ CONFLICTS= libXaw3d-[0-9]*
<p>To avoid these issues <code class="varname">CONFLICTS</code> entries
should be added in all cases where it is known that packages conflict
with each other. These <code class="varname">CONFLICTS</code> entries are
- exported in <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_summary+5.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_summary</span>(5)</span></a> files and consumed by binary package
+ exported in <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_summary+5.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_summary</span>(5)</span></a> files and consumed by binary package
managers to inform users that packages cannot be installed onto
the target system.</p>
</div>
@@ -7367,7 +7367,7 @@ CONFLICTS= libXaw3d-[0-9]*
be set in the package Makefile. This will be carried into any
binary package that is made from this pkgsrc entry. A
<span class="quote">“<span class="quote">preserved</span>”</span> package will
- not be deleted using <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_delete</span>(1)</span></a> unless the
+ not be deleted using <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_delete+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">pkg_delete</span>(1)</span></a> unless the
<span class="quote">“<span class="quote">-f</span>”</span> option is used.</p>
</div>
<div class="sect2">
@@ -7500,7 +7500,7 @@ SUBST_SED.fix-paths+= -e 's,"/
substitution will take place. The patterns are interpreted
relatively to the <code class="varname">WRKSRC</code> directory.</p>
<p><code class="varname">SUBST_SED.*</code> is a list of arguments to
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?sed+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">sed</span>(1)</span></a> that specify the actual
substitution. Every sed
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?sed+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">sed</span>(1)</span></a> that specify the actual
substitution. Every sed
command should be prefixed with <code class="literal">-e</code>, so that
all SUBST blocks look uniform.</p>
<p>There are some more variables, but they are so seldomly
@@ -7699,7 +7699,7 @@ dynamic linker chooses the library with
</li>
<li class="listitem">
<p>When linking shared object (<code class="filename">.so</code>)
- files, i.e. files that are loaded via <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?dlopen+3.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">dlopen</span>(3)</span></a>, NOT
+ files, i.e. files that are loaded via <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?dlopen+3.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">dlopen</span>(3)</span></a>, NOT
shared libraries, use <span class="quote">“<span class="quote">-module
-avoid-version</span>”</span> to prevent them getting version
tacked on.</p>
@@ -7709,7 +7709,7 @@ dynamic linker chooses the library with
<li class="listitem">
<p>When linking programs that depend on these libraries
<span class="emphasis"><em>before</em></span> they are installed, preface
- the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?cc+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">cc</span>(1)</span></a> or <a
class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?ld+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">ld</span>(1)</span></a> line with <span
class="quote">“<span class="quote">${LIBTOOL}
+ the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?cc+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">cc</span>(1)</span></a> or <a
class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?ld+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">ld</span>(1)</span></a> line with <span
class="quote">“<span class="quote">${LIBTOOL}
--mode=link</span>”</span>, and it will find the correct
libraries (static or shared), but please be aware that
libtool will not allow you to specify a relative path in
@@ -7726,8 +7726,8 @@ ${LIBTOOL} --mode=link ${CC} -o <em clas
<p>and it will do the right thing with the libraries.</p>
</li>
<li class="listitem">
-<p>When installing libraries, preface the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?install+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">install</span>(1)</span></a>
- or <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?cp+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">cp</span>(1)</span></a> command with <span
class="quote">“<span class="quote">${LIBTOOL}
+<p>When installing libraries, preface the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?install+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">install</span>(1)</span></a>
+ or <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?cp+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">cp</span>(1)</span></a> command with <span
class="quote">“<span class="quote">${LIBTOOL}
--mode=install</span>”</span>, and change the library name to
<code class="filename">.la</code>. e.g.</p>
<pre class="programlisting">
@@ -7735,7 +7735,7 @@ ${LIBTOOL} --mode=install ${BSD_INSTALL_
</pre>
<p>This will install the static <code class="filename">.a</code>,
shared library, any needed symlinks, and run
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?ldconfig+8.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">ldconfig</span>(8)</span></a>.</p>
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?ldconfig+8.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">ldconfig</span>(8)</span></a>.</p>
</li>
<li class="listitem"><p>In your <code class="filename">PLIST</code>, include only
the <code class="filename">.la</code>
@@ -8788,10 +8788,10 @@ builds)</i></a>.</p>
<a name="submitting-your-package"></a>23.2.�Submitting source packages (for non-NetBSD-developers)</h2></div></div></div>
<p>First, check that your package is complete, compiles and
runs well; see <a class="xref" href="#debug" title="Chapter�22.�Debugging">Chapter�22, <i>Debugging</i></a> and the rest of this
- document. Next, generate an uuencoded gzipped <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?tar+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">tar</span>(1)</span></a>
+ document. Next, generate an uuencoded gzipped <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?tar+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">tar</span>(1)</span></a>
archive that contains all files that make up the package.
Finally, send this package to the pkgsrc bug tracking system,
- either with the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?send-pr+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">send-pr</span>(1)</span></a> command, or if you don't have
+ either with the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?send-pr+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">send-pr</span>(1)</span></a> command, or if you don't have
that, go to the web page
<a class="ulink" href="http://www.NetBSD.org/support/send-pr.html"; target="_top">http://www.NetBSD.org/support/send-pr.html</a>,
which contains some instructions and a link to a form where you
@@ -8955,12 +8955,18 @@ much easier to get wrong than <span clas
<p>Renaming packages is not recommended.</p>
<p>When renaming packages, be sure to fix any references to old name
in other Makefiles, options, buildlink files, etc.</p>
-<p>Also When renaming a package, please define
- <code class="varname">SUPERSEDES</code> to the package name and dewey version
- pattern(s) of the previous package name.
+<p>
+ Also when renaming a package, please add
+ the package name and version pattern(s) of the previous package
+ to <code class="varname">SUPERSEDES</code>.
This may be repeated for multiple renames.
The new package would be an exact replacement.
+ Example:
</p>
+<pre class="programlisting">
+SUPERSEDES+= p5-IO-Compress-Zlib<2.017
+SUPERSEDES+= optcomp-[0-9]*
+</pre>
<p>Note that <span class="quote">“<span class="quote">successor</span>”</span> in the
CHANGES-<em class="replaceable"><code>YYYY</code></em> file doesn't necessarily
mean that it <span class="emphasis"><em>supersedes</em></span>, as that successor may
@@ -8988,7 +8994,7 @@ instead of <span class="quote">“<s
<code class="varname">PREV_PKGPATH</code> to the previous category/package
pathname. The <code class="varname">PREV_PKGPATH</code> can be used by tools
for doing an update using pkgsrc building; for example, it can
-search the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?pkg_summary+5.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_summary</span>(5)</span></a>
database for <code class="varname">PREV_PKGPATH</code>
+search the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?pkg_summary+5.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">pkg_summary</span>(5)</span></a>
database for <code class="varname">PREV_PKGPATH</code>
(if no <code class="varname">SUPERSEDES</code>) and then use the corresponding
new <code class="varname">PKGPATH</code> for that moved package. Note that
it may have multiple matches, so the tool should also check on the
@@ -9024,7 +9030,7 @@ place.</p></li>
and if you still don't have the answer, ask on the
<code class="literal">pkgsrc-users</code> mailing list.</p>
<div class="qandaset">
-<a name="idm75663056"></a><dl>
+<a name="idm75601104"></a><dl>
<dt>24.1. <a href="#devfaq.makeflags">What is the difference between
MAKEFLAGS, .MAKEFLAGS and
MAKE_FLAGS?</a>
@@ -9069,7 +9075,7 @@ do?</a>
<tbody>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.makeflags"></a><a name="idm75670864"></a><p><b>24.1.</b></p>
+<a name="devfaq.makeflags"></a><a name="idm75600720"></a><p><b>24.1.</b></p>
</td>
<td align="left" valign="top"><p>What is the difference between
<code class="varname">MAKEFLAGS</code>, <code class="varname">.MAKEFLAGS</code> and
@@ -9078,14 +9084,14 @@ do?</a>
<tr class="answer">
<td align="left" valign="top"></td>
<td align="left" valign="top"><p><code class="varname">MAKEFLAGS</code> are the flags passed
- to the pkgsrc-internal invocations of <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a>, while
+ to the pkgsrc-internal invocations of <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a>, while
<code class="varname">MAKE_FLAGS</code> are the flags that are passed to
the <code class="varname">MAKE_PROGRAM</code> when building the
package. [FIXME: What is .MAKEFLAGS for?]</p></td>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.make"></a><a name="idm75675088"></a><p><b>24.2.</b></p>
+<a name="devfaq.make"></a><a name="idm75604944"></a><p><b>24.2.</b></p>
</td>
<td align="left" valign="top"><p>What is the difference between
<code class="varname">MAKE</code>, <code class="varname">GMAKE</code> and
@@ -9094,7 +9100,7 @@ do?</a>
<tr class="answer">
<td align="left" valign="top"></td>
<td align="left" valign="top"><p><code class="varname">MAKE</code> is the path to the
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> program that is
used in the pkgsrc
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">make</span>(1)</span></a> program that is
used in the pkgsrc
infrastructure. <code class="varname">GMAKE</code> is the path to GNU
Make, but you need to say <code class="varname">USE_TOOLS+=gmake</code> to
use that. <code class="varname">MAKE_PROGRAM</code> is the path to the
@@ -9103,7 +9109,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.cc"></a><a name="idm75678928"></a><p><b>24.3.</b></p>
+<a name="devfaq.cc"></a><a name="idm75608784"></a><p><b>24.3.</b></p>
</td>
<td align="left" valign="top"><p>What is the difference between
<code class="varname">CC</code>, <code class="varname">PKG_CC</code> and
@@ -9121,7 +9127,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.bl3flags"></a><a name="idm75683024"></a><p><b>24.4.</b></p>
+<a name="devfaq.bl3flags"></a><a name="idm75612880"></a><p><b>24.4.</b></p>
</td>
<td align="left" valign="top"><p>What is the difference between
<code class="varname">BUILDLINK_LDFLAGS</code>,
@@ -9134,7 +9140,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.bl3prefix"></a><a name="idm75680848"></a><p><b>24.5.</b></p>
+<a name="devfaq.bl3prefix"></a><a name="idm75610704"></a><p><b>24.5.</b></p>
</td>
<td align="left" valign="top"><p>Why does <span class="command"><strong>make show-var
VARNAME=BUILDLINK_PREFIX.<em class="replaceable"><code>foo</code></em></strong></span>
@@ -9150,7 +9156,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.master_sites"></a><a name="idm75685968"></a><p><b>24.6.</b></p>
+<a name="devfaq.master_sites"></a><a name="idm75615824"></a><p><b>24.6.</b></p>
</td>
<td align="left" valign="top"><p>What does
<code class="code">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
@@ -9163,7 +9169,7 @@ do?</a>
assignment operator, although it looks like it.
Instead, it is a degenerate form of
<code class="code">${LIST:<em class="replaceable"><code>old_string</code></em>=<em class="replaceable"><code>new_string</code></em>}</code>,
- which is documented in the <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a> man page and which is
+ which is documented in the <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?make+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">make</span>(1)</span></a> man page and which is
commonly used in the form <code class="code">${SRCS:.c=.o}</code>. In the
case of <code class="varname">MASTER_SITE_*</code>,
<em class="replaceable"><code>old_string</code></em> is the empty string and
@@ -9174,7 +9180,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.mailinglists"></a><a name="idm75695568"></a><p><b>24.7.</b></p>
+<a name="devfaq.mailinglists"></a><a name="idm75625424"></a><p><b>24.7.</b></p>
</td>
<td align="left" valign="top"><p>Which mailing lists are there for package
developers?</p></td>
@@ -9192,14 +9198,14 @@ do?</a>
etc.</p></dd>
<dt><span class="term"><a class="ulink" href="http://www.NetBSD.org/mailinglists/index.html#pkgsrc-bugs"; target="_top">pkgsrc-bugs</a></span></dt>
<dd><p>All bug reports in category "pkg" sent with
- <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?send-pr+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">send-pr</span>(1)</span></a> appear here.
Please do not report your bugs here
+ <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?send-pr+1.i386+NetBSD-8.1";><span class="citerefentry"><span class="refentrytitle">send-pr</span>(1)</span></a> appear here.
Please do not report your bugs here
directly; use one of the other mailing
lists.</p></dd>
</dl></div></td>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.documentation"></a><a name="idm75691856"></a><p><b>24.8.</b></p>
+<a name="devfaq.documentation"></a><a name="idm75629904"></a><p><b>24.8.</b></p>
</td>
<td align="left" valign="top"><p>Where is the pkgsrc
documentation?</p></td>
@@ -9247,7 +9253,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.too-much-time"></a><a name="idm75705936"></a><p><b>24.9.</b></p>
+<a name="devfaq.too-much-time"></a><a name="idm75631696"></a><p><b>24.9.</b></p>
</td>
<td align="left" valign="top"><p>I have a little time to kill. What shall I
do?</p></td>
@@ -10108,7 +10114,7 @@ INFO_FILES= yes
<a name="example-descr"></a>A.1.2.�DESCR</h3></div></div></div>
<pre class="programlisting">
GNU version of yacc. Can make re-entrant parsers, and numerous other
-improvements. Why you would want this when Berkeley <a class="citerefentry" href="http://netbsd.gw.com/cgi-bin/man-cgi?yacc+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">yacc</span>(1)</span></a> is part
+improvements. Why you would want this when Berkeley <a class="citerefentry" href="https://netbsd.gw.com/cgi-bin/man-cgi?yacc+1.i386+NetBSD-8.1";><span class="citerefentry"><span
class="refentrytitle">yacc</span>(1)</span></a> is part
of the NetBSD source tree is beyond me.
</pre>
</div>
Index: pkgsrc/doc/pkgsrc.txt
diff -u pkgsrc/doc/pkgsrc.txt:1.279 pkgsrc/doc/pkgsrc.txt:1.280
--- pkgsrc/doc/pkgsrc.txt:1.279 Fri Jan 3 15:57:53 2020
+++ pkgsrc/doc/pkgsrc.txt Mon Jan 6 21:35:51 2020
@@ -830,7 +830,7 @@ Before you download any pkgsrc files, yo
current branch or the stable branch. The latter is forked on a quarterly basis
from the current branch and only gets modified for security updates. The names
of the stable branches are built from the year and the quarter, for example
-2019Q3.
+2019Q4.
The second step is to decide how you want to download pkgsrc. You can get it as
a tar file or via CVS. Both ways are described here.
@@ -854,12 +854,12 @@ published at pkgsrc.tar.bz2 and pkgsrc.t
You can fetch the same files using FTP.
-The tar file for the stable branch 2019Q3 is in the directory pkgsrc-2019Q3 and
+The tar file for the stable branch 2019Q4 is in the directory pkgsrc-2019Q4 and
is also called pkgsrc.tar.gz.
To download the latest pkgsrc stable tarball, run:
-$ ftp ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2019Q3/pkgsrc.tar.gz
+$ ftp ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2019Q4/pkgsrc.tar.gz
If you prefer, you can also fetch it using "wget", "curl", or your web browser.
@@ -878,7 +878,7 @@ $ ftp ftp://ftp.NetBSD.org/pub/pkgsrc/cu
To fetch a specific pkgsrc stable branch, run:
-$ cd /usr && cvs -q -z2 -d anoncvs%anoncvs.NetBSD.org@localhost:/cvsroot checkout -r pkgsrc-2019Q3 -P pkgsrc
+$ cd /usr && cvs -q -z2 -d anoncvs%anoncvs.NetBSD.org@localhost:/cvsroot checkout -r pkgsrc-2019Q4 -P pkgsrc
This will create the directory pkgsrc/ in your /usr/ directory and all the
package source will be stored under /usr/pkgsrc/.
@@ -960,7 +960,7 @@ When updating pkgsrc, the CVS program ke
But if you, for whatever reason, want to switch from the stable branch to the
current one, you can do it by adding the option "-A" after the "update"
keyword. To switch from the current branch back to the stable branch, add the "
--rpkgsrc-2019Q3" option.
+-rpkgsrc-2019Q4" option.
3.2.2.2. What happens to my changes when updating?
@@ -7327,9 +7327,12 @@ Renaming packages is not recommended.
When renaming packages, be sure to fix any references to old name in other
Makefiles, options, buildlink files, etc.
-Also When renaming a package, please define SUPERSEDES to the package name and
-dewey version pattern(s) of the previous package name. This may be repeated for
-multiple renames. The new package would be an exact replacement.
+Also when renaming a package, please add the package name and version pattern
+(s) of the previous package to SUPERSEDES. This may be repeated for multiple
+renames. The new package would be an exact replacement. Example:
+
+SUPERSEDES+= p5-IO-Compress-Zlib<2.017
+SUPERSEDES+= optcomp-[0-9]*
Note that "successor" in the CHANGES-YYYY file doesn't necessarily mean that it
supersedes, as that successor may not be an exact replacement but is a
Home |
Main Index |
Thread Index |
Old Index