diff options
author | bsiegert <bsiegert@pkgsrc.org> | 2013-08-24 17:02:56 +0000 |
---|---|---|
committer | bsiegert <bsiegert@pkgsrc.org> | 2013-08-24 17:02:56 +0000 |
commit | 12c64e6c2336b71e9a6a47139687df168795e10e (patch) | |
tree | f7696e6b95a01b095b7b1d3a3f3592a1c6b2ab22 /doc/pkgsrc.html | |
parent | 848e71bd6733be6f319702e4e45dc72361652b0d (diff) | |
download | pkgsrc-12c64e6c2336b71e9a6a47139687df168795e10e.tar.gz |
Regenerate the guide after fixing PR/26464.
Diffstat (limited to 'doc/pkgsrc.html')
-rw-r--r-- | doc/pkgsrc.html | 121 |
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>=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, “Handling packages with security problems”</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">“<span class="quote">pre-req-package-name</span>”</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">“<span class="quote">version</span>”</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>=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> |