summaryrefslogtreecommitdiff
path: root/doc/pkgsrc.html
diff options
context:
space:
mode:
authorbsiegert <bsiegert@pkgsrc.org>2013-08-24 17:02:56 +0000
committerbsiegert <bsiegert@pkgsrc.org>2013-08-24 17:02:56 +0000
commit12c64e6c2336b71e9a6a47139687df168795e10e (patch)
treef7696e6b95a01b095b7b1d3a3f3592a1c6b2ab22 /doc/pkgsrc.html
parent848e71bd6733be6f319702e4e45dc72361652b0d (diff)
downloadpkgsrc-12c64e6c2336b71e9a6a47139687df168795e10e.tar.gz
Regenerate the guide after fixing PR/26464.
Diffstat (limited to 'doc/pkgsrc.html')
-rw-r--r--doc/pkgsrc.html121
1 files changed, 59 insertions, 62 deletions
diff --git a/doc/pkgsrc.html b/doc/pkgsrc.html
index c9387c628d4..dfbb12d76f4 100644
--- a/doc/pkgsrc.html
+++ b/doc/pkgsrc.html
@@ -82,13 +82,12 @@
<dt><span class="sect2"><a href="#cygwin">3.3.1. Cygwin</a></span></dt>
<dt><span class="sect2"><a href="#darwin">3.3.2. Darwin (Mac OS X)</a></span></dt>
<dt><span class="sect2"><a href="#freebsd">3.3.3. FreeBSD</a></span></dt>
-<dt><span class="sect2"><a href="#gnukfreebsd">3.3.4. GNU/kFreeBSD</a></span></dt>
-<dt><span class="sect2"><a href="#interix">3.3.5. Interix</a></span></dt>
-<dt><span class="sect2"><a href="#irix">3.3.6. IRIX</a></span></dt>
-<dt><span class="sect2"><a href="#linux">3.3.7. Linux</a></span></dt>
-<dt><span class="sect2"><a href="#mirbsd">3.3.8. MirBSD</a></span></dt>
-<dt><span class="sect2"><a href="#openbsd">3.3.9. OpenBSD</a></span></dt>
-<dt><span class="sect2"><a href="#solaris">3.3.10. Solaris</a></span></dt>
+<dt><span class="sect2"><a href="#interix">3.3.4. Interix</a></span></dt>
+<dt><span class="sect2"><a href="#irix">3.3.5. IRIX</a></span></dt>
+<dt><span class="sect2"><a href="#linux">3.3.6. Linux</a></span></dt>
+<dt><span class="sect2"><a href="#mirbsd">3.3.7. MirBSD</a></span></dt>
+<dt><span class="sect2"><a href="#openbsd">3.3.8. OpenBSD</a></span></dt>
+<dt><span class="sect2"><a href="#solaris">3.3.9. Solaris</a></span></dt>
</dl></dd>
</dl></dd>
<dt><span class="chapter"><a href="#using">4. Using pkgsrc</a></span></dt>
@@ -680,10 +679,6 @@ minutes!</p>
<td><a class="ulink" href="http://cygwin.com/" target="_top">Cygwin</a></td>
<td align="center">Mar 2013</td>
</tr>
-<tr>
-<td><a class="ulink" href="http://www.debian.org/ports/kfreebsd-gnu/" target="_top">GNU/kFreeBSD</a></td>
-<td align="center">Jul 2013</td>
-</tr>
</tbody>
</table></div>
</div>
@@ -823,13 +818,12 @@ minutes!</p>
<dt><span class="sect2"><a href="#cygwin">3.3.1. Cygwin</a></span></dt>
<dt><span class="sect2"><a href="#darwin">3.3.2. Darwin (Mac OS X)</a></span></dt>
<dt><span class="sect2"><a href="#freebsd">3.3.3. FreeBSD</a></span></dt>
-<dt><span class="sect2"><a href="#gnukfreebsd">3.3.4. GNU/kFreeBSD</a></span></dt>
-<dt><span class="sect2"><a href="#interix">3.3.5. Interix</a></span></dt>
-<dt><span class="sect2"><a href="#irix">3.3.6. IRIX</a></span></dt>
-<dt><span class="sect2"><a href="#linux">3.3.7. Linux</a></span></dt>
-<dt><span class="sect2"><a href="#mirbsd">3.3.8. MirBSD</a></span></dt>
-<dt><span class="sect2"><a href="#openbsd">3.3.9. OpenBSD</a></span></dt>
-<dt><span class="sect2"><a href="#solaris">3.3.10. Solaris</a></span></dt>
+<dt><span class="sect2"><a href="#interix">3.3.4. Interix</a></span></dt>
+<dt><span class="sect2"><a href="#irix">3.3.5. IRIX</a></span></dt>
+<dt><span class="sect2"><a href="#linux">3.3.6. Linux</a></span></dt>
+<dt><span class="sect2"><a href="#mirbsd">3.3.7. MirBSD</a></span></dt>
+<dt><span class="sect2"><a href="#openbsd">3.3.8. OpenBSD</a></span></dt>
+<dt><span class="sect2"><a href="#solaris">3.3.9. Solaris</a></span></dt>
</dl></dd>
</dl></dd>
<dt><span class="chapter"><a href="#using">4. Using pkgsrc</a></span></dt>
@@ -1124,13 +1118,12 @@ release -d
<dt><span class="sect2"><a href="#cygwin">3.3.1. Cygwin</a></span></dt>
<dt><span class="sect2"><a href="#darwin">3.3.2. Darwin (Mac OS X)</a></span></dt>
<dt><span class="sect2"><a href="#freebsd">3.3.3. FreeBSD</a></span></dt>
-<dt><span class="sect2"><a href="#gnukfreebsd">3.3.4. GNU/kFreeBSD</a></span></dt>
-<dt><span class="sect2"><a href="#interix">3.3.5. Interix</a></span></dt>
-<dt><span class="sect2"><a href="#irix">3.3.6. IRIX</a></span></dt>
-<dt><span class="sect2"><a href="#linux">3.3.7. Linux</a></span></dt>
-<dt><span class="sect2"><a href="#mirbsd">3.3.8. MirBSD</a></span></dt>
-<dt><span class="sect2"><a href="#openbsd">3.3.9. OpenBSD</a></span></dt>
-<dt><span class="sect2"><a href="#solaris">3.3.10. Solaris</a></span></dt>
+<dt><span class="sect2"><a href="#interix">3.3.4. Interix</a></span></dt>
+<dt><span class="sect2"><a href="#irix">3.3.5. IRIX</a></span></dt>
+<dt><span class="sect2"><a href="#linux">3.3.6. Linux</a></span></dt>
+<dt><span class="sect2"><a href="#mirbsd">3.3.7. MirBSD</a></span></dt>
+<dt><span class="sect2"><a href="#openbsd">3.3.8. OpenBSD</a></span></dt>
+<dt><span class="sect2"><a href="#solaris">3.3.9. Solaris</a></span></dt>
</dl></dd>
</dl>
</div>
@@ -1254,15 +1247,7 @@ release -d
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
-<a name="gnukfreebsd"></a>3.3.4. GNU/kFreeBSD</h3></div></div></div>
-<p>Debian GNU/kFreeBSD is the only GNU/kFreeBSD distribution now.
- Debian GNU/kFreeBSD 7.0 or later is tested and supported.</p>
-<p> You should install ncurses (libncurses and libncurses-dev)
- packages.</p>
-</div>
-<div class="sect2">
-<div class="titlepage"><div><div><h3 class="title">
-<a name="interix"></a>3.3.5. Interix</h3></div></div></div>
+<a name="interix"></a>3.3.4. Interix</h3></div></div></div>
<p>Interix is a POSIX-compatible subsystem for the Windows NT kernel,
providing a Unix-like environment with a tighter kernel integration than
available with Cygwin. It is part of the Windows Services for Unix
@@ -1280,7 +1265,7 @@ release -d
with pkgsrc.</p>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="platform.interix-sfu-install"></a>3.3.5.1. When installing Interix/SFU</h4></div></div></div>
+<a name="platform.interix-sfu-install"></a>3.3.4.1. When installing Interix/SFU</h4></div></div></div>
<p>At an absolute minimum, the following packages must be installed from
the Windows Services for Unix 3.5 distribution in order to use pkgsrc:</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
@@ -1321,7 +1306,7 @@ release -d
</div>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="platform.interix-sfu-postinstall"></a>3.3.5.2. What to do if Interix/SFU is already installed</h4></div></div></div>
+<a name="platform.interix-sfu-postinstall"></a>3.3.4.2. What to do if Interix/SFU is already installed</h4></div></div></div>
<p>If SFU is already installed and you wish to alter these settings to work
with pkgsrc, note the following things.</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
@@ -1344,7 +1329,7 @@ release -d
</div>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="platform.interix-notes"></a>3.3.5.3. Important notes for using pkgsrc</h4></div></div></div>
+<a name="platform.interix-notes"></a>3.3.4.3. Important notes for using pkgsrc</h4></div></div></div>
<p>The package manager (either the pkgsrc "su" user, or the user
running "pkg_add") must be a member of the local Administrators
group. Such a user must also be used to run the bootstrap. This is
@@ -1367,7 +1352,7 @@ interix:kP=\E[S:kN=\E[T:kH=\E[U:dc@:DC@:tc=pcansi:
</div>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="platform.interix-limits"></a>3.3.5.4. Limitations of the Interix platform</h4></div></div></div>
+<a name="platform.interix-limits"></a>3.3.4.4. Limitations of the Interix platform</h4></div></div></div>
<p>Though Interix suffices as a familiar and flexible substitute
for a full Unix-like platform, it has some drawbacks that should
be noted for those desiring to make the most of Interix.</p>
@@ -1424,7 +1409,7 @@ interix:kP=\E[S:kN=\E[T:kH=\E[U:dc@:DC@:tc=pcansi:
</div>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="platform.interix-knownissues"></a>3.3.5.5. Known issues for pkgsrc on Interix</h4></div></div></div>
+<a name="platform.interix-knownissues"></a>3.3.4.5. Known issues for pkgsrc on Interix</h4></div></div></div>
<p>It is not necessary, in general, to have a "root" user on the
Windows system; any member of the local Administrators group will
suffice. However, some packages currently assume that the user
@@ -1443,7 +1428,7 @@ interix:kP=\E[S:kN=\E[T:kH=\E[U:dc@:DC@:tc=pcansi:
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
-<a name="irix"></a>3.3.6. IRIX</h3></div></div></div>
+<a name="irix"></a>3.3.5. IRIX</h3></div></div></div>
<p>You will need a working C compiler, either gcc or SGI's MIPS and MIPSpro
compiler (cc/c89). Please set the <code class="varname">CC</code> environment variable
according to your preference. If you do not have a license for the MIPSpro
@@ -1488,7 +1473,7 @@ PKGSRC_COMPILER= mipspro
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
-<a name="linux"></a>3.3.7. Linux</h3></div></div></div>
+<a name="linux"></a>3.3.6. Linux</h3></div></div></div>
<p>Some versions of Linux (for example Debian GNU/Linux) need
either libtermcap or libcurses (libncurses). Installing the
distributions libncurses-dev package (or equivalent) should fix
@@ -1531,7 +1516,7 @@ ICCBASE= /opt/intel/cc/10.1.008
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
-<a name="mirbsd"></a>3.3.8. MirBSD</h3></div></div></div>
+<a name="mirbsd"></a>3.3.7. MirBSD</h3></div></div></div>
<p>pkgsrc has been tested on MirBSD #10-current (2011 and newer).
Older versions might also work. Releases before #10 are not
supported.</p>
@@ -1554,7 +1539,7 @@ ICCBASE= /opt/intel/cc/10.1.008
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
-<a name="openbsd"></a>3.3.9. OpenBSD</h3></div></div></div>
+<a name="openbsd"></a>3.3.8. OpenBSD</h3></div></div></div>
<p>OpenBSD 5.1 has been tested and supported,
other versions may work.</p>
<p>Care should be taken so that the tools that this kit installs do not conflict
@@ -1595,7 +1580,7 @@ ICCBASE= /opt/intel/cc/10.1.008
</div>
<div class="sect2">
<div class="titlepage"><div><div><h3 class="title">
-<a name="solaris"></a>3.3.10. Solaris</h3></div></div></div>
+<a name="solaris"></a>3.3.9. Solaris</h3></div></div></div>
<p>Solaris 2.6 through 10 are supported on both x86 and sparc.
You will need a working C compiler. Both gcc 4.5.3 and
Sun WorkShop 5 have been tested.</p>
@@ -1616,7 +1601,7 @@ ICCBASE= /opt/intel/cc/10.1.008
and e.g. <code class="filename">/usr/pkg/{bin,sbin}</code>.</p>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="solaris-gcc-note"></a>3.3.10.1. If you are using gcc</h4></div></div></div>
+<a name="solaris-gcc-note"></a>3.3.9.1. If you are using gcc</h4></div></div></div>
<p>It makes life much simpler if you only use the same gcc consistently
for building all packages.</p>
<p>It is recommended that an external gcc be used only for bootstrapping,
@@ -1627,7 +1612,7 @@ ICCBASE= /opt/intel/cc/10.1.008
</div>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="solaris-sun-workshop-note"></a>3.3.10.2. If you are using Sun WorkShop</h4></div></div></div>
+<a name="solaris-sun-workshop-note"></a>3.3.9.2. If you are using Sun WorkShop</h4></div></div></div>
<p>You will need at least the following packages installed (from WorkShop
5.0)</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
@@ -1657,7 +1642,7 @@ CXXCPP= CC -E
</div>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="solaris-sunpro-64"></a>3.3.10.3. Building 64-bit binaries with SunPro</h4></div></div></div>
+<a name="solaris-sunpro-64"></a>3.3.9.3. Building 64-bit binaries with SunPro</h4></div></div></div>
<p>To build 64-bit packages, you just need to have the
following lines in your <a class="link" href="#mk.conf"><code class="filename">mk.conf</code></a> file:</p>
<pre class="programlisting">
@@ -1673,7 +1658,7 @@ ABI= 64
</div>
<div class="sect3">
<div class="titlepage"><div><div><h4 class="title">
-<a name="plat.sunos.problems"></a>3.3.10.4. Common problems</h4></div></div></div>
+<a name="plat.sunos.problems"></a>3.3.9.4. Common problems</h4></div></div></div>
<p>Sometimes, when using <span class="command"><strong>libtool</strong></span>,
<code class="filename">/bin/ksh</code> crashes with a segmentation fault.
The workaround is to use another shell for the configure
@@ -7707,7 +7692,7 @@ TOOLS_PLATFORM.true?= true # shell builtin
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="tools.questions"></a>18.4. Questions regarding the tools</h2></div></div></div>
<div class="qandaset">
-<a name="idm77779760"></a><dl>
+<a name="idp140462849966688"></a><dl>
<dt>18.4.1. <a href="#tools.new">How do I add a new tool?</a>
</dt>
<dt>18.4.2. <a href="#tools.listall">How do I get a list of all available
@@ -7726,7 +7711,7 @@ TOOLS_PLATFORM.true?= true # shell builtin
<tbody>
<tr class="question">
<td align="left" valign="top">
-<a name="tools.new"></a><a name="idm77779376"></a><p><b>18.4.1.</b></p>
+<a name="tools.new"></a><a name="idp140462849967280"></a><p><b>18.4.1.</b></p>
</td>
<td align="left" valign="top"><p>How do I add a new tool?</p></td>
</tr>
@@ -7736,7 +7721,7 @@ TOOLS_PLATFORM.true?= true # shell builtin
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="tools.listall"></a><a name="idm77778352"></a><p><b>18.4.2.</b></p>
+<a name="tools.listall"></a><a name="idp140462849968576"></a><p><b>18.4.2.</b></p>
</td>
<td align="left" valign="top"><p>How do I get a list of all available
tools?</p></td>
@@ -7747,7 +7732,7 @@ TOOLS_PLATFORM.true?= true # shell builtin
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="tools.used"></a><a name="idm77777200"></a><p><b>18.4.3.</b></p>
+<a name="tools.used"></a><a name="idp140462849969920"></a><p><b>18.4.3.</b></p>
</td>
<td align="left" valign="top"><p>How can I get a list of all the tools that a
package is using while being built? I want to know whether it
@@ -8210,6 +8195,18 @@ DEPENDS+= ImageMagick&gt;=6.0:../../graphics/ImageMagick
vulnerabilities file. See <a class="xref" href="#security-handling" title="19.1.10. Handling packages with security problems">Section 19.1.10, &#8220;Handling packages with security problems&#8221;</a> for more
information.</p>
</li>
+<li class="listitem">
+<p>If the package depends on either one of two (or more)
+ packages, specify the <span class="quote">&#8220;<span class="quote">pre-req-package-name</span>&#8221;</span> as a
+ comma-separated list between curly braces.</p>
+<p>As an example, take a package that depends on the Perl
+ <span class="quote">&#8220;<span class="quote">version</span>&#8221;</span> module, which has been part of Perl
+ itself since version 5.10.0. This either/or dependency is
+ expressed as:</p>
+<pre class="programlisting">
+DEPENDS+= {perl&gt;=5.10.0,p5-version-[0-9]*}:../../devel/p5-version
+ </pre>
+</li>
</ol></div>
<p>If your package needs files from another package to build,
add the relevant distribution files to
@@ -9810,7 +9807,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="idm77224496"></a><dl>
+<a name="idp140462850566928"></a><dl>
<dt>22.1. <a href="#devfaq.makeflags">What is the difference between
MAKEFLAGS, .MAKEFLAGS and
MAKE_FLAGS?</a>
@@ -9855,7 +9852,7 @@ do?</a>
<tbody>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.makeflags"></a><a name="idm77224112"></a><p><b>22.1.</b></p>
+<a name="devfaq.makeflags"></a><a name="idp140462850567552"></a><p><b>22.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
@@ -9871,7 +9868,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.make"></a><a name="idm77220016"></a><p><b>22.2.</b></p>
+<a name="devfaq.make"></a><a name="idp140462850572016"></a><p><b>22.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
@@ -9889,7 +9886,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.cc"></a><a name="idm77215664"></a><p><b>22.3.</b></p>
+<a name="devfaq.cc"></a><a name="idp140462850577040"></a><p><b>22.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
@@ -9907,7 +9904,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.bl3flags"></a><a name="idm77211440"></a><p><b>22.4.</b></p>
+<a name="devfaq.bl3flags"></a><a name="idp140462850581904"></a><p><b>22.4.</b></p>
</td>
<td align="left" valign="top"><p>What is the difference between
<code class="varname">BUILDLINK_LDFLAGS</code>,
@@ -9920,7 +9917,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.bl3prefix"></a><a name="idm77209264"></a><p><b>22.5.</b></p>
+<a name="devfaq.bl3prefix"></a><a name="idp140462850584528"></a><p><b>22.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>
@@ -9936,7 +9933,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.master_sites"></a><a name="idm77206192"></a><p><b>22.6.</b></p>
+<a name="devfaq.master_sites"></a><a name="idp140462850588448"></a><p><b>22.6.</b></p>
</td>
<td align="left" valign="top"><p>What does
<code class="literal">${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
@@ -9960,7 +9957,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.mailinglists"></a><a name="idm77198128"></a><p><b>22.7.</b></p>
+<a name="devfaq.mailinglists"></a><a name="idp140462850598032"></a><p><b>22.7.</b></p>
</td>
<td align="left" valign="top"><p>Which mailing lists are there for package
developers?</p></td>
@@ -9985,7 +9982,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.documentation"></a><a name="idm77194288"></a><p><b>22.8.</b></p>
+<a name="devfaq.documentation"></a><a name="idp140462850602992"></a><p><b>22.8.</b></p>
</td>
<td align="left" valign="top"><p>Where is the pkgsrc
documentation?</p></td>
@@ -10033,7 +10030,7 @@ do?</a>
</tr>
<tr class="question">
<td align="left" valign="top">
-<a name="devfaq.too-much-time"></a><a name="idm77179568"></a><p><b>22.9.</b></p>
+<a name="devfaq.too-much-time"></a><a name="idp140462850611872"></a><p><b>22.9.</b></p>
</td>
<td align="left" valign="top"><p>I have a little time to kill. What shall I
do?</p></td>