summaryrefslogtreecommitdiff
path: root/doc/pkgsrc.html
diff options
context:
space:
mode:
authorrillig <rillig@pkgsrc.org>2006-01-12 11:25:27 +0000
committerrillig <rillig@pkgsrc.org>2006-01-12 11:25:27 +0000
commit7aa836ae0ed934a6317a01703ff76e37a7f7f27b (patch)
treea72d239414e91e8641fa7a52f908ceb9236668da /doc/pkgsrc.html
parentc7184fa02f09d949ecd76b1de856e5bb603ecb07 (diff)
downloadpkgsrc-7aa836ae0ed934a6317a01703ff76e37a7f7f27b.tar.gz
regen.
Diffstat (limited to 'doc/pkgsrc.html')
-rw-r--r--doc/pkgsrc.html1072
1 files changed, 663 insertions, 409 deletions
diff --git a/doc/pkgsrc.html b/doc/pkgsrc.html
index 89ec1590d99..ca461bbf914 100644
--- a/doc/pkgsrc.html
+++ b/doc/pkgsrc.html
@@ -1,7 +1,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content=
- "HTML Tidy for NetBSD (vers 1 September 2005), see www.w3.org" />
+ "HTML Tidy for NetBSD (vers 1st August 2004), see www.w3.org" />
<meta http-equiv="Content-Type" content=
"text/html; charset=us-ascii" />
@@ -15,12 +15,12 @@
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF">
- <div class="book" lang="en">
+ <div class="book" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h1 class="title"><a name="the-pkgsrc-guide"></a>The
- pkgsrc guide</h1>
+ <h1 class="title"><a name="the-pkgsrc-guide" id=
+ "the-pkgsrc-guide"></a>The pkgsrc guide</h1>
</div>
<div>
@@ -1070,11 +1070,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="introduction" id=
"introduction"></a>Chapter&nbsp;1.&nbsp;What is
pkgsrc?</h2>
</div>
@@ -1099,11 +1099,12 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "introduction-section" id=
"introduction-section"></a>1.1.&nbsp;Introduction</h2>
</div>
</div>
@@ -1236,12 +1237,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "overview"></a>1.2.&nbsp;Overview</h2>
+ "overview" id="overview"></a>1.2.&nbsp;Overview</h2>
</div>
</div>
</div>
@@ -1282,11 +1283,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "terminology" id=
"terminology"></a>1.3.&nbsp;Terminology</h2>
</div>
</div>
@@ -1381,11 +1383,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "typography" id=
"typography"></a>1.4.&nbsp;Typography</h2>
</div>
</div>
@@ -1401,11 +1404,11 @@ alink="#0000FF">
</div>
</div>
- <div class="part" lang="en">
+ <div class="part" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h1 class="title"><a name=
+ <h1 class="title"><a name="users-guide" id=
"users-guide"></a>Part&nbsp;I.&nbsp;The pkgsrc user's
guide</h1>
</div>
@@ -1688,11 +1691,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="getting" id=
"getting"></a>Chapter&nbsp;2.&nbsp;Where to get
pkgsrc and how to keep it up-to-date</h2>
</div>
@@ -1721,12 +1724,13 @@ alink="#0000FF">
file, via SUP, or via CVS. All three ways are described
here.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "as-tar-file"></a>2.1.&nbsp;As tar file</h2>
+ "as-tar-file" id="as-tar-file"></a>2.1.&nbsp;As tar
+ file</h2>
</div>
</div>
</div>
@@ -1739,12 +1743,12 @@ alink="#0000FF">
class="filename">/usr/pkgsrc</code>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "via-sup"></a>2.2.&nbsp;Via SUP</h2>
+ "via-sup" id="via-sup"></a>2.2.&nbsp;Via SUP</h2>
</div>
</div>
</div>
@@ -1766,12 +1770,12 @@ alink="#0000FF">
<em class="replaceable"><code>/path/to/your/supfile</code></em></strong></span>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "via-cvs"></a>2.3.&nbsp;Via CVS</h2>
+ "via-cvs" id="via-cvs"></a>2.3.&nbsp;Via CVS</h2>
</div>
</div>
</div>
@@ -1813,11 +1817,12 @@ alink="#0000FF">
all work is done relatively within the pkgsrc tree.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "uptodate-cvs" id=
"uptodate-cvs"></a>2.4.&nbsp;Keeping pkgsrc
up-to-date via CVS</h2>
</div>
@@ -1850,11 +1855,11 @@ alink="#0000FF">
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="platforms" id=
"platforms"></a>Chapter&nbsp;3.&nbsp;Using pkgsrc on
systems other than NetBSD</h2>
</div>
@@ -1900,11 +1905,12 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "bootstrapping-pkgsrc" id=
"bootstrapping-pkgsrc"></a>3.1.&nbsp;Bootstrapping
pkgsrc</h2>
</div>
@@ -1972,7 +1978,7 @@ alink="#0000FF">
<p>See <a href="#getting" title=
"Chapter&nbsp;2.&nbsp;Where to get pkgsrc and how to keep it up-to-date">
- Chapter&nbsp;2, <i>Where to get pkgsrc and how to keep it
+ Chapter 2, <i>Where to get pkgsrc and how to keep it
up-to-date</i></a> for other ways to get pkgsrc before
bootstrapping. The given <span><strong class=
"command">bootstrap</strong></span> command will use the
@@ -2010,11 +2016,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "platform-specific-notes" id=
"platform-specific-notes"></a>3.2.&nbsp;Platform-specific
notes</h2>
</div>
@@ -2024,11 +2031,11 @@ alink="#0000FF">
<p>Here are some platform-specific notes you should be
aware of.</p>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="darwin" id=
"darwin"></a>3.2.1.&nbsp;Darwin (Mac OS X)</h3>
</div>
</div>
@@ -2069,13 +2076,13 @@ alink="#0000FF">
be case-sensitive, and HFS+ is not.</p>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name=
- "platform.osx-image"></a>3.2.1.1.&nbsp;Using a
- disk image</h4>
+ <h4 class="title"><a name="platform.osx-image"
+ id="platform.osx-image"></a>3.2.1.1.&nbsp;Using
+ a disk image</h4>
</div>
</div>
</div>
@@ -2095,12 +2102,12 @@ alink="#0000FF">
<p>That's it!</p>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name=
- "platform.osx-ufs"></a>3.2.1.2.&nbsp;Using a
+ <h4 class="title"><a name="platform.osx-ufs"
+ id="platform.osx-ufs"></a>3.2.1.2.&nbsp;Using a
UFS partition</h4>
</div>
</div>
@@ -2162,11 +2169,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="freebsd" id=
"freebsd"></a>3.2.2.&nbsp;FreeBSD</h3>
</div>
</div>
@@ -2224,11 +2231,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="interix" id=
"interix"></a>3.2.3.&nbsp;Interix</h3>
</div>
</div>
@@ -2249,11 +2256,12 @@ alink="#0000FF">
officially supported. (The main difference in 3.0/3.1
is lack of pthreads.)</p>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "platform.interix-sfu-install" id=
"platform.interix-sfu-install"></a>3.2.3.1.&nbsp;When
installing Interix/SFU</h4>
</div>
@@ -2316,11 +2324,12 @@ alink="#0000FF">
"_top">http://www.duh.org/interix/hotfixes.php</a>.</p>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "platform.interix-sfu-postinstall" id=
"platform.interix-sfu-postinstall"></a>3.2.3.2.&nbsp;What
to do if Interix/SFU is already installed</h4>
</div>
@@ -2370,11 +2379,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "platform.interix-notes" id=
"platform.interix-notes"></a>3.2.3.3.&nbsp;Important
notes for using pkgsrc</h4>
</div>
@@ -2413,11 +2423,12 @@ alink="#0000FF">
</pre>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "platform.interix-limits" id=
"platform.interix-limits"></a>3.2.3.4.&nbsp;Limitations
of the Interix platform</h4>
</div>
@@ -2530,11 +2541,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "platform.interix-knownissues" id=
"platform.interix-knownissues"></a>3.2.3.5.&nbsp;Known
issues for pkgsrc on Interix</h4>
</div>
@@ -2562,11 +2574,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="irix" id=
"irix"></a>3.2.4.&nbsp;IRIX</h3>
</div>
</div>
@@ -2650,11 +2662,11 @@ alink="#0000FF">
pass the '--preserve-path' flag.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="linux" id=
"linux"></a>3.2.5.&nbsp;Linux</h3>
</div>
</div>
@@ -2731,11 +2743,11 @@ alink="#0000FF">
libtool.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="openbsd" id=
"openbsd"></a>3.2.6.&nbsp;OpenBSD</h3>
</div>
</div>
@@ -2804,11 +2816,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="solaris" id=
"solaris"></a>3.2.7.&nbsp;Solaris</h3>
</div>
</div>
@@ -2849,13 +2861,13 @@ alink="#0000FF">
<span class="emphasis"><em>not</em></span>
supported.</p>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name=
- "solaris-gcc-note"></a>3.2.7.1.&nbsp;If you are
- using gcc</h4>
+ <h4 class="title"><a name="solaris-gcc-note"
+ id="solaris-gcc-note"></a>3.2.7.1.&nbsp;If you
+ are using gcc</h4>
</div>
</div>
</div>
@@ -2880,11 +2892,12 @@ alink="#0000FF">
"_top">http://www.sun.com/bigadmin/common/freewareSearch.html</a>.</p>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "solaris-sun-workshop-note" id=
"solaris-sun-workshop-note"></a>3.2.7.2.&nbsp;If
you are using Sun WorkShop</h4>
</div>
@@ -2947,11 +2960,11 @@ alink="#0000FF">
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="using" id=
"using"></a>Chapter&nbsp;4.&nbsp;Using pkgsrc</h2>
</div>
</div>
@@ -3005,11 +3018,12 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "getting-started" id=
"getting-started"></a>4.1.&nbsp;Working with binary
packages</h2>
</div>
@@ -3020,11 +3034,12 @@ alink="#0000FF">
install a precompiled binary package that someone else
already prepared for your type of machine.</p>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "where-to-get-binary-packages" id=
"where-to-get-binary-packages"></a>4.1.1.&nbsp;Where
to get binary packages</h3>
</div>
@@ -3061,11 +3076,12 @@ alink="#0000FF">
documentation for the exact location.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "how-to-use-binary-packages" id=
"how-to-use-binary-packages"></a>4.1.2.&nbsp;How
to use binary packages</h3>
</div>
@@ -3135,11 +3151,11 @@ alink="#0000FF">
just installed program.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="a-word-of-warning" id=
"a-word-of-warning"></a>4.1.3.&nbsp;A word of
warning</h3>
</div>
@@ -3155,14 +3171,21 @@ alink="#0000FF">
packages which you did not create yourself, and the
security holes that can be introduced onto your system
by indiscriminate adding of such files.</p>
+
+ <p>The same warning of course applies to every package
+ you install from source when you haven't completely
+ read and understood the source code of the package, the
+ compiler that is used to build the package and all the
+ other tools that are involved.</p>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "building-packages-from-source" id=
"building-packages-from-source"></a>4.2.&nbsp;Building
packages from source</h2>
</div>
@@ -3175,11 +3198,11 @@ alink="#0000FF">
&#8220;The pkgsrc developer's guide&#8221;</a> for
instructions how to create your own packages.</p>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="requirements" id=
"requirements"></a>4.2.1.&nbsp;Requirements</h3>
</div>
</div>
@@ -3195,12 +3218,12 @@ alink="#0000FF">
required, too.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "fetching-distfiles"></a>4.2.2.&nbsp;Fetching
+ <h3 class="title"><a name="fetching-distfiles"
+ id="fetching-distfiles"></a>4.2.2.&nbsp;Fetching
distfiles</h3>
</div>
</div>
@@ -3238,11 +3261,12 @@ alink="#0000FF">
"filename">/usr/pkgsrc/distfiles</code>.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "how-to-build-and-install" id=
"how-to-build-and-install"></a>4.2.3.&nbsp;How to
build and install</h3>
</div>
@@ -3290,8 +3314,8 @@ alink="#0000FF">
<p>Taking the figlet utility as an example, we can
install it on our system by building as shown in
<a href="#logs" title=
- "Appendix&nbsp;B.&nbsp;Build logs">Appendix&nbsp;B,
- <i>Build logs</i></a>.</p>
+ "Appendix&nbsp;B.&nbsp;Build logs">Appendix B, <i>Build
+ logs</i></a>.</p>
<p>The program is installed under the default root of
the packages tree - <code xmlns=
@@ -3429,11 +3453,12 @@ alink="#0000FF">
"varname">LOCALBASE</code>.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "selecting-the-compiler" id=
"selecting-the-compiler"></a>4.2.4.&nbsp;Selecting
the compiler</h3>
</div>
@@ -3519,11 +3544,11 @@ alink="#0000FF">
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="configuring" id=
"configuring"></a>Chapter&nbsp;5.&nbsp;Configuring
pkgsrc</h2>
</div>
@@ -3552,11 +3577,12 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "general-configuration" id=
"general-configuration"></a>5.1.&nbsp;General
configuration</h2>
</div>
@@ -3638,11 +3664,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "variables-affecting-build" id=
"variables-affecting-build"></a>5.2.&nbsp;Variables
affecting the build process</h2>
</div>
@@ -3714,11 +3741,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "developer-advanced-settings" id=
"developer-advanced-settings"></a>5.3.&nbsp;Developer/advanced
settings</h2>
</div>
@@ -3796,11 +3824,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "selecting-build-options" id=
"selecting-build-options"></a>5.4.&nbsp;Selecting
Build Options</h2>
</div>
@@ -3902,11 +3931,11 @@ alink="#0000FF">
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="binary" id=
"binary"></a>Chapter&nbsp;6.&nbsp;Creating binary
packages</h2>
</div>
@@ -3977,11 +4006,12 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "building-a-single-binary-package" id=
"building-a-single-binary-package"></a>6.1.&nbsp;Building
a single binary package</h2>
</div>
@@ -4019,7 +4049,7 @@ alink="#0000FF">
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">/usr/pkgsrc/packages</code>, in the form of a
gzipped tar file. See <a href="#logs.package" title=
- "B.2.&nbsp;Packaging figlet">Section&nbsp;B.2,
+ "B.2.&nbsp;Packaging figlet">Section B.2,
&#8220;Packaging figlet&#8221;</a> for a continuation of
the above <a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
@@ -4028,16 +4058,17 @@ alink="#0000FF">
"filename">misc/figlet</code></a> example.</p>
<p>See <a href="#submit" title=
- "Chapter&nbsp;17.&nbsp;Submitting and Committing">Chapter&nbsp;17,
- <i>Submitting and Committing</i></a> for information on
- how to submit such a binary package.</p>
+ "Chapter&nbsp;17.&nbsp;Submitting and Committing">Chapter
+ 17, <i>Submitting and Committing</i></a> for information
+ on how to submit such a binary package.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "settings-for-creationg-of-binary-packages" id=
"settings-for-creationg-of-binary-packages"></a>6.2.&nbsp;Settings
for creation of binary packages</h2>
</div>
@@ -4049,13 +4080,13 @@ alink="#0000FF">
&#8220;Other helpful targets&#8221;</a>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "bulkbuild"></a>6.3.&nbsp;Doing a bulk build of all
- packages</h2>
+ "bulkbuild" id="bulkbuild"></a>6.3.&nbsp;Doing a
+ bulk build of all packages</h2>
</div>
</div>
</div>
@@ -4077,21 +4108,23 @@ alink="#0000FF">
sure to not actually compile on NFS storage, as this
slows things down a lot.</p>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="binary.configuration"
+ id=
"binary.configuration"></a>6.3.1.&nbsp;Configuration</h3>
</div>
</div>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "binary.bulk.build.conf" id=
"binary.bulk.build.conf"></a>6.3.1.1.&nbsp;<code xmlns="http://www.w3.org/TR/xhtml1/transitional"
class="filename">build.conf</code></h4>
</div>
@@ -4116,11 +4149,11 @@ alink="#0000FF">
the comments in that file.</p>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name=
+ <h4 class="title"><a name="binary.mk.conf" id=
"binary.mk.conf"></a>6.3.1.2.&nbsp;/etc/mk.conf</h4>
</div>
</div>
@@ -4183,13 +4216,38 @@ alink="#0000FF">
</li>
</ul>
</div>
+
+ <p>Some other options are scattered in the pkgsrc
+ infrastructure:</p>
+
+ <div class="itemizedlist">
+ <ul type="disc">
+ <li>
+ <p><code class="varname">CHECK_FILES</code> can
+ be set to &#8220;<span class=
+ "quote">yes</span>&#8221; to check that the
+ installed set of files matches the <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional"
+ class="filename">PLIST</code>.</p>
+ </li>
+
+ <li>
+ <p><code class=
+ "varname">CHECK_INTERPRETER</code> can be set
+ to &#8220;<span class="quote">yes</span>&#8221;
+ to check that the installed &#8220;<span class=
+ "quote">#!</span>&#8221;-scripts will find
+ their interpreter.</p>
+ </li>
+ </ul>
+ </div>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name=
+ <h4 class="title"><a name="pre-build.local" id=
"pre-build.local"></a>6.3.1.3.&nbsp;<code xmlns="http://www.w3.org/TR/xhtml1/transitional"
class="filename">pre-build.local</code></h4>
</div>
@@ -4225,11 +4283,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "other-environmental-considerations" id=
"other-environmental-considerations"></a>6.3.2.&nbsp;Other
environmental considerations</h3>
</div>
@@ -4271,11 +4330,11 @@ alink="#0000FF">
warned! :)</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="operation" id=
"operation"></a>6.3.3.&nbsp;Operation</h3>
</div>
</div>
@@ -4320,11 +4379,11 @@ alink="#0000FF">
class="filename">build.conf</code> file.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="what-it-does" id=
"what-it-does"></a>6.3.4.&nbsp;What it does</h3>
</div>
</div>
@@ -4384,11 +4443,12 @@ alink="#0000FF">
these broken package builds later.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "disk-space-requirements" id=
"disk-space-requirements"></a>6.3.5.&nbsp;Disk
space requirements</h3>
</div>
@@ -4427,13 +4487,13 @@ alink="#0000FF">
recompiling.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "setting-up-a-sandbox"></a>6.3.6.&nbsp;Setting up
- a sandbox for chrooted builds</h3>
+ <h3 class="title"><a name="setting-up-a-sandbox"
+ id="setting-up-a-sandbox"></a>6.3.6.&nbsp;Setting
+ up a sandbox for chrooted builds</h3>
</div>
</div>
</div>
@@ -4644,11 +4704,12 @@ alink="#0000FF">
(wherever that points/mounts to/from).</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "building-a-partial-set" id=
"building-a-partial-set"></a>6.3.7.&nbsp;Building
a partial set of packages</h3>
</div>
@@ -4698,11 +4759,11 @@ alink="#0000FF">
needed.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="bulk-upload" id=
"bulk-upload"></a>6.3.8.&nbsp;Uploading results
of a bulk build</h3>
</div>
@@ -4848,11 +4909,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "creating-cdroms" id=
"creating-cdroms"></a>6.4.&nbsp;Creating a multiple
CD-ROM packages collection</h2>
</div>
@@ -4873,11 +4935,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
all the dependencies for a given package on the same CD
as that package.</p>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="cdpack-example" id=
"cdpack-example"></a>6.4.1.&nbsp;Example of
cdpack</h3>
</div>
@@ -4943,11 +5005,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="faq" id=
"faq"></a>Chapter&nbsp;7.&nbsp;Frequently Asked
Questions</h2>
</div>
@@ -5026,11 +5088,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
for in the previous chapters, and it contains items for
both pkgsrc users and developers.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "mailing-list-pointers" id=
"mailing-list-pointers"></a>7.1.&nbsp;Are there any
mailing lists for pkg-related discussion?</h2>
</div>
@@ -5085,11 +5148,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"_top">http://mail-index.NetBSD.org/</a>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "pkgviews-docs" id=
"pkgviews-docs"></a>7.2.&nbsp;Where's the pkgviews
documentation?</h2>
</div>
@@ -5102,11 +5166,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">pkgsrc/mk/buildlink3/PKGVIEWS_UG</code>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "faq-pkgtools" id=
"faq-pkgtools"></a>7.3.&nbsp;Utilities for package
management (pkgtools)</h2>
</div>
@@ -5361,11 +5426,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "non-root-pkgsrc" id=
"non-root-pkgsrc"></a>7.4.&nbsp;How to use pkgsrc
as non-root</h2>
</div>
@@ -5403,11 +5469,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
finer tuning of the tree layout.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "resume-transfers" id=
"resume-transfers"></a>7.5.&nbsp;How to resume
transfers when fetching distfiles?</h2>
</div>
@@ -5446,11 +5513,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "XFree86-from-pkgsrc" id=
"XFree86-from-pkgsrc"></a>7.6.&nbsp;How can I
install/use XFree86 from pkgsrc?</h2>
</div>
@@ -5471,11 +5539,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "x.org-from-pkgsrc" id=
"x.org-from-pkgsrc"></a>7.7.&nbsp;How can I
install/use X.org from pkgsrc?</h2>
</div>
@@ -5496,11 +5565,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "fetch-behind-firewall" id=
"fetch-behind-firewall"></a>7.8.&nbsp;How to fetch
files from behind a firewall</h2>
</div>
@@ -5521,13 +5591,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "passive-ftp"></a>7.9.&nbsp;How do I tell
- <span><strong class="command">make
+ "passive-ftp" id="passive-ftp"></a>7.9.&nbsp;How do
+ I tell <span><strong class="command">make
fetch</strong></span> to do passive FTP?</h2>
</div>
</div>
@@ -5572,11 +5642,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
active transfers.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "fetching-all-distfiles" id=
"fetching-all-distfiles"></a>7.10.&nbsp;How to
fetch all distfiles at once</h2>
</div>
@@ -5647,11 +5718,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "tmac.andoc-missing" id=
"tmac.andoc-missing"></a>7.11.&nbsp;What does
&#8220;<span class="quote">Don't know how to make
/usr/share/tmac/tmac.andoc</span>&#8221; mean?</h2>
@@ -5683,11 +5755,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
class="filename">/etc/mk.conf</code>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "bsd.own.mk-missing" id=
"bsd.own.mk-missing"></a>7.12.&nbsp;What does
&#8220;<span class="quote">Could not find
bsd.own.mk</span>&#8221; mean?</h2>
@@ -5716,11 +5789,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
-r</strong></span>).</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "using-sudo-with-pkgsrc" id=
"using-sudo-with-pkgsrc"></a>7.13.&nbsp;Using
'sudo' with pkgsrc</h2>
</div>
@@ -5751,13 +5825,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "faq.conf"></a>7.14.&nbsp;How do I change the
- location of configuration files?</h2>
+ "faq.conf" id="faq.conf"></a>7.14.&nbsp;How do I
+ change the location of configuration files?</h2>
</div>
</div>
</div>
@@ -5795,11 +5869,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
rebuild and reinstall any affected packages.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "audit-packages" id=
"audit-packages"></a>7.15.&nbsp;Automated security
checks</h2>
</div>
@@ -5872,11 +5947,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="part" lang="en">
+ <div class="part" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h1 class="title"><a name=
+ <h1 class="title"><a name="developers-guide" id=
"developers-guide"></a>Part&nbsp;II.&nbsp;The pkgsrc
developer's guide</h1>
</div>
@@ -6039,8 +6114,8 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<dt><span class="sect2"><a href=
"#updating-buildlink-depends">11.2.2. Updating
<code class=
- "varname">BUILDLINK_DEPENDS.<em class="replaceable"><code>pkg</code></em></code>
- in <code xmlns=
+ "varname">BUILDLINK_DEPENDS.<em class="replaceable">
+ <code>pkg</code></em></code> in <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">buildlink3.mk</code>
files</a></span></dt>
@@ -6485,11 +6560,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dl>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="components" id=
"components"></a>Chapter&nbsp;8.&nbsp;Package
components - files, directories and contents</h2>
</div>
@@ -6535,11 +6610,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
of files involved which are described in the following
sections.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "components.Makefile" id=
"components.Makefile"></a>8.1.&nbsp;<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">Makefile</code></h2>
@@ -6855,11 +6931,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "components.distinfo" id=
"components.distinfo"></a>8.2.&nbsp;<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">distinfo</code></h2>
@@ -6908,11 +6985,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
information is not lost.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "components.patches" id=
"components.patches"></a>8.3.&nbsp;patches/*</h2>
</div>
</div>
@@ -7016,11 +7094,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
after pkgsrc patches are applied</em></span>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "other-mandatory-files" id=
"other-mandatory-files"></a>8.4.&nbsp;Other
mandatory files</h2>
</div>
@@ -7060,11 +7139,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "components.optional" id=
"components.optional"></a>8.5.&nbsp;Optional
files</h2>
</div>
@@ -7148,12 +7228,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "work-dir"></a>8.6.&nbsp;<code xmlns=
+ "work-dir" id="work-dir"></a>8.6.&nbsp;<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">work*</code></h2>
</div>
@@ -7176,11 +7256,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<code class="varname">OBJMACHINE</code> is set.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "files-dir" id=
"files-dir"></a>8.7.&nbsp;<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">files/*</code></h2>
@@ -7201,11 +7282,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="makefile" id=
"makefile"></a>Chapter&nbsp;9.&nbsp;Programming in
<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
@@ -7290,11 +7371,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">Makefile</code>s, including the pitfalls that
come along with them.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "makefile.variables" id=
"makefile.variables"></a>9.1.&nbsp;<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">Makefile</code> variables</h2>
@@ -7398,11 +7480,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</ul>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "makefile.variables.names" id=
"makefile.variables.names"></a>9.1.1.&nbsp;Naming
conventions</h3>
</div>
@@ -7438,11 +7521,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "makefile.code" id=
"makefile.code"></a>9.2.&nbsp;Code snippets</h2>
</div>
</div>
@@ -7453,11 +7537,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
appropriate here, you should test your code and add it
here.</p>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="adding-to-list" id=
"adding-to-list"></a>9.2.1.&nbsp;Adding things to
a list</h3>
</div>
@@ -7483,11 +7567,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
are correctly interpreted in both lists.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "converting-internal-to-external" id=
"converting-internal-to-external"></a>9.2.2.&nbsp;Converting
an internal list into an external list</h3>
</div>
@@ -7508,11 +7593,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">""</code> is explained below.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "passing-variable-to-shell" id=
"passing-variable-to-shell"></a>9.2.3.&nbsp;Passing
variables to a shell command</h3>
</div>
@@ -7570,11 +7656,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
there is no example for it.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="quoting-guideline" id=
"quoting-guideline"></a>9.2.4.&nbsp;Quoting
guideline</h3>
</div>
@@ -7695,11 +7781,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "bsd-make-bug-workaround" id=
"bsd-make-bug-workaround"></a>9.2.5.&nbsp;Workaround
for a bug in BSD Make</h3>
</div>
@@ -7726,11 +7813,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="plist" id=
"plist"></a>Chapter&nbsp;10.&nbsp;PLIST issues</h2>
</div>
</div>
@@ -7791,12 +7878,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">PLIST</code> file (or files, see below!).</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "rcs-id"></a>10.1.&nbsp;RCS ID</h2>
+ "rcs-id" id="rcs-id"></a>10.1.&nbsp;RCS ID</h2>
</div>
</div>
</div>
@@ -7809,11 +7896,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "automatic-plist-generation" id=
"automatic-plist-generation"></a>10.2.&nbsp;Semi-automatic
<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
@@ -7831,11 +7919,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
information on this target.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "print-PLIST" id=
"print-PLIST"></a>10.3.&nbsp;Tweaking output of
<span><strong class="command">make
print-PLIST</strong></span></h2>
@@ -7879,11 +7968,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "plist.misc" id=
"plist.misc"></a>10.4.&nbsp;Variable substitution
in PLIST</h2>
</div>
@@ -8008,11 +8098,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
&#8220;<span class="quote">somevalue</span>&#8221;.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "manpage-compression" id=
"manpage-compression"></a>10.5.&nbsp;Man page
compression</h2>
</div>
@@ -8037,11 +8128,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
class="filename">PLIST</code> itself.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "using-PLIST_SRC" id=
"using-PLIST_SRC"></a>10.6.&nbsp;Changing PLIST
source with <code class=
"varname">PLIST_SRC</code></h2>
@@ -8061,11 +8153,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
things is important.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "platform-specific-plist" id=
"platform-specific-plist"></a>10.7.&nbsp;Platform-specific
and differing PLISTs</h2>
</div>
@@ -8112,11 +8205,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "faq.common-dirs" id=
"faq.common-dirs"></a>10.8.&nbsp;Sharing
directories between packages</h2>
</div>
@@ -8204,11 +8298,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="buildlink" id=
"buildlink"></a>Chapter&nbsp;11.&nbsp;Buildlink
methodology</h2>
</div>
@@ -8307,11 +8401,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
buildlink3 is designed to insulate the package build from
non-system-supplied software.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "converting-to-buildlink3" id=
"converting-to-buildlink3"></a>11.1.&nbsp;Converting
packages to use buildlink3</h2>
</div>
@@ -8480,11 +8575,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
complete description of how to use them properly.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "creating-buildlink3.mk" id=
"creating-buildlink3.mk"></a>11.2.&nbsp;Writing
<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
@@ -8528,12 +8624,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"prompt">%</code> createbuildlink &gt;buildlink3.mk</code></strong>
</pre>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "anatomy-of-bl3"></a>11.2.1.&nbsp;Anatomy of a
+ <h3 class="title"><a name="anatomy-of-bl3" id=
+ "anatomy-of-bl3"></a>11.2.1. Anatomy of a
buildlink3.mk file</h3>
</div>
</div>
@@ -8650,9 +8746,9 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">BUILDLINK_INCDIRS.<em class=
"replaceable"><code>pkg</code></em></code> and
<code class=
- "varname">BUILDLINK_LIBDIRS.<em class="replaceable"><code>pkg</code></em></code>
- (not shown above) are lists of subdirectories of
- <code xmlns=
+ "varname">BUILDLINK_LIBDIRS.<em class="replaceable">
+ <code>pkg</code></em></code> (not shown above)
+ are lists of subdirectories of <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">${BUILDLINK_PREFIX.<em class=
"replaceable"><code>pkg</code></em>}</code> to
@@ -8789,15 +8885,16 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
included.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
- "updating-buildlink-depends"></a>11.2.2.&nbsp;Updating
+ "updating-buildlink-depends" id=
+ "updating-buildlink-depends"></a>11.2.2. Updating
<code class=
- "varname">BUILDLINK_DEPENDS.<em class="replaceable"><code>pkg</code></em></code>
- in <code xmlns=
+ "varname">BUILDLINK_DEPENDS.<em class="replaceable">
+ <code>pkg</code></em></code> in <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">buildlink3.mk</code> files</h3>
</div>
@@ -8848,21 +8945,21 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
want to cause unneeded package deletions and rebuilds.
In many cases, new versions of packages work just fine
with older dependencies. See <a href="#dependencies"
- title=
- "15.1.4.&nbsp;Handling dependencies">Section&nbsp;15.1.4,
- &#8220;Handling dependencies&#8221;</a> for more
- information about dependencies on other packages,
+ title="15.1.4.&nbsp;Handling dependencies">Section
+ 15.1.4, &#8220;Handling dependencies&#8221;</a> for
+ more information about dependencies on other packages,
including the <code class=
"varname">BUILDLINK_RECOMMENDED</code> and <code class=
"varname">RECOMMENDED</code> definitions.</p>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "writing-builtin.mk" id=
"writing-builtin.mk"></a>11.3.&nbsp;Writing
<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
@@ -8917,11 +9014,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</ol>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="anatomy-of-builtin.mk"
+ id=
"anatomy-of-builtin.mk"></a>11.3.1.&nbsp;Anatomy
of a <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
@@ -9048,11 +9146,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"replaceable"><code>pkg</code></em></code>).</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "native-or-pkgsrc-preference" id=
"native-or-pkgsrc-preference"></a>11.3.2.&nbsp;Global
preferences for native or pkgsrc software</h3>
</div>
@@ -9096,11 +9195,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="pkginstall" id=
"pkginstall"></a>Chapter&nbsp;12.&nbsp;The pkginstall
framework</h2>
</div>
@@ -9244,11 +9343,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
by means of the installation scripts, which are
automatically generated by pkginstall.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "files-and-dirs-outside-prefix" id=
"files-and-dirs-outside-prefix"></a>12.1.&nbsp;Files
and directories outside the installation
prefix</h2>
@@ -9284,11 +9384,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">Makefile</code>. The rest of this section
describes these variables.</p>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="dirs-outside-prefix"
+ id=
"dirs-outside-prefix"></a>12.1.1.&nbsp;Directory
manipulation</h3>
</div>
@@ -9334,12 +9435,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "files-outside-prefix"></a>12.1.2.&nbsp;File
+ <h3 class="title"><a name="files-outside-prefix"
+ id="files-outside-prefix"></a>12.1.2.&nbsp;File
manipulation</h3>
</div>
</div>
@@ -9401,11 +9502,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "conf-files" id=
"conf-files"></a>12.2.&nbsp;Configuration
files</h2>
</div>
@@ -9426,12 +9528,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
This ensures that administrators never lose any custom
changes they may have made.</p>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "conf-files-sysconfdir"></a>12.2.1.&nbsp;How
+ <h3 class="title"><a name="conf-files-sysconfdir"
+ id="conf-files-sysconfdir"></a>12.2.1.&nbsp;How
<code class="varname">PKG_SYSCONFDIR</code> is
set</h3>
</div>
@@ -9556,11 +9658,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
means.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="conf-files-configure"
+ id=
"conf-files-configure"></a>12.2.2.&nbsp;Telling
the software where configuration files are</h3>
</div>
@@ -9585,11 +9688,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
unfortunately).</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="conf-files-patching"
+ id=
"conf-files-patching"></a>12.2.3.&nbsp;Patching
installations</h3>
</div>
@@ -9645,12 +9749,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
outside it.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "conf-files-disable"></a>12.2.4.&nbsp;Disabling
+ <h3 class="title"><a name="conf-files-disable"
+ id="conf-files-disable"></a>12.2.4.&nbsp;Disabling
handling of configuration files</h3>
</div>
</div>
@@ -9663,11 +9767,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "rcd-scripts" id=
"rcd-scripts"></a>12.3.&nbsp;System startup
scripts</h2>
</div>
@@ -9750,11 +9855,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</ol>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="rcd-scripts-disable"
+ id=
"rcd-scripts-disable"></a>12.3.1.&nbsp;Disabling
handling of system startup scripts</h3>
</div>
@@ -9772,11 +9878,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "users-and-groups" id=
"users-and-groups"></a>12.4.&nbsp;System users and
groups</h2>
</div>
@@ -9822,12 +9929,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
numeric identifier is optional.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "shells"></a>12.5.&nbsp;System shells</h2>
+ "shells" id="shells"></a>12.5.&nbsp;System
+ shells</h2>
</div>
</div>
</div>
@@ -9854,12 +9962,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
PKG_SHELL= ${PREFIX}/bin/zsh
</pre>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "shells-disable"></a>12.5.1.&nbsp;Disabling shell
+ <h3 class="title"><a name="shells-disable" id=
+ "shells-disable"></a>12.5.1. Disabling shell
registration</h3>
</div>
</div>
@@ -9873,12 +9981,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "fonts"></a>12.6.&nbsp;Fonts</h2>
+ "fonts" id="fonts"></a>12.6.&nbsp;Fonts</h2>
</div>
</div>
</div>
@@ -9910,13 +10018,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
FONTS_DIRS.ttf= ${PREFIX}/lib/X11/fonts/TTF
</pre>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "fonts-disable"></a>12.6.1.&nbsp;Disabling
- automatic update of the fonts databases</h3>
+ <h3 class="title"><a name="fonts-disable" id=
+ "fonts-disable"></a>12.6.1. Disabling automatic
+ update of the fonts databases</h3>
</div>
</div>
</div>
@@ -9930,11 +10038,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="options" id=
"options"></a>Chapter&nbsp;13.&nbsp;Options
handling</h2>
</div>
@@ -9970,11 +10078,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
sets of options will be built into a package or to allow a
set of global default options apply.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "global-default-options" id=
"global-default-options"></a>13.1.&nbsp;Global
default options</h2>
</div>
@@ -9989,11 +10098,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
class="filename">/etc/mk.conf</code>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "converting-to-options" id=
"converting-to-options"></a>13.2.&nbsp;Converting
packages to use <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
@@ -10135,8 +10245,9 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><code class=
"varname">PKG_OPTIONS_LEGACY_VARS</code> is a list
of &#8220;<span class="quote"><em class=
- "replaceable"><code>USE_VARIABLE</code></em>:<em class="replaceable"><code>option</code></em></span>&#8221;
- pairs that map legacy <code xmlns=
+ "replaceable"><code>USE_VARIABLE</code></em>:<em class="replaceable">
+ <code>option</code></em></span>&#8221; pairs that
+ map legacy <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">/etc/mk.conf</code> variables to their
option counterparts. Pairs should be added with
@@ -10150,9 +10261,10 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><code class=
"varname">PKG_OPTIONS_LEGACY_OPTS</code> is a list
of &#8220;<span class="quote"><em class=
- "replaceable"><code>old-option</code></em>:<em class="replaceable"><code>new-option</code></em></span>&#8221;
- pairs that map options that have been renamed to
- their new counterparts. Pairs should be added with
+ "replaceable"><code>old-option</code></em>:<em class="replaceable">
+ <code>new-option</code></em></span>&#8221; pairs
+ that map options that have been renamed to their
+ new counterparts. Pairs should be added with
&#8220;<span class="quote">+=</span>&#8221; to keep
the listing of global legacy options. A warning
will be issued if the user uses a legacy
@@ -10217,11 +10329,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "option-names" id=
"option-names"></a>13.3.&nbsp;Option Names</h2>
</div>
</div>
@@ -10258,11 +10371,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="build" id=
"build"></a>Chapter&nbsp;14.&nbsp;The build
process</h2>
</div>
@@ -10337,11 +10450,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.intro" id=
"build.intro"></a>14.1.&nbsp;Introduction</h2>
</div>
</div>
@@ -10355,7 +10469,7 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">install</code>), all of which are described in
the following sections. Each phase is splitted into
so-called <span class="emphasis"><em>stages</em></span>,
- which take the name of the containing stage, prefixed by
+ which take the name of the containing phase, prefixed by
one of <code class="varname">pre-</code>, <code class=
"varname">do-</code> or <code class=
"varname">post-</code>. (Examples are <code class=
@@ -10366,22 +10480,19 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>The basic steps for building a program are always the
same. First the program's source (<span class=
"emphasis"><em>distfile</em></span>) must be brought to
- the local system and then extracted. After any patches to
- compile properly on NetBSD are applied, the software can
- be configured, then built (usually by compiling), and
- finally the generated binaries, etc. can be put into
- place on the system. These are exactly the steps
- performed by the NetBSD package system, which is
- implemented as a series of targets in a central Makefile,
- <code xmlns="http://www.w3.org/TR/xhtml1/transitional"
- class="filename">pkgsrc/mk/bsd.pkg.mk</code>.</p>
+ the local system and then extracted. After any
+ pkgsrc-specific patches to compile properly are applied,
+ the software can be configured, then built (usually by
+ compiling), and finally the generated binaries, etc. can
+ be put into place on the system.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.prefix" id=
"build.prefix"></a>14.2.&nbsp;Program location</h2>
</div>
</div>
@@ -10562,11 +10673,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.builddirs" id=
"build.builddirs"></a>14.3.&nbsp;Directories used
during the build process</h2>
</div>
@@ -10584,14 +10696,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">PKGSRCDIR/PKGPATH</code> is used for
directories that are pkgsrc-specific. <code class=
"varname">WRKSRC</code> is used for directories inside
- the package itself. The permissions after each variable
- indicate whether the variable may be changed by the
- package Makefile.</p>
+ the package itself.</p>
<div class="variablelist">
<dl>
<dt><span class="term"><code class=
- "varname">PKGSRCDIR</code> (read-only)</span></dt>
+ "varname">PKGSRCDIR</code></span></dt>
<dd>
<p>This is an absolute pathname that points to the
@@ -10600,7 +10710,7 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dd>
<dt><span class="term"><code class=
- "varname">PKGPATH</code> (read-only)</span></dt>
+ "varname">PKGPATH</code></span></dt>
<dd>
<p>This is a pathname relative to <code class=
@@ -10609,7 +10719,7 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dd>
<dt><span class="term"><code class=
- "varname">WRKDIR</code> (read-only)</span></dt>
+ "varname">WRKDIR</code></span></dt>
<dd>
<p>This is an absolute pathname pointing to the
@@ -10623,24 +10733,28 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dd>
<dt><span class="term"><code class=
- "varname">WRKSRC</code> (read-write)</span></dt>
+ "varname">WRKSRC</code></span></dt>
<dd>
<p>This is an absolute pathname pointing to the
directory where the distfiles are extracted. It is
usually a direct subdirectory of <code class=
"varname">WRKDIR</code>, and often it's the only
- directory entry that isn't hidden.</p>
+ directory entry that isn't hidden. This variable
+ may be changed by a package <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">Makefile</code>.</p>
</dd>
</dl>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.running" id=
"build.running"></a>14.4.&nbsp;Running a phase</h2>
</div>
</div>
@@ -10657,13 +10771,14 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
will be built, but not installed.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.fetch"></a>14.5.&nbsp;The <span class=
- "emphasis"><em>fetch</em></span> phase</h2>
+ "build.fetch" id="build.fetch"></a>14.5.&nbsp;The
+ <span class="emphasis"><em>fetch</em></span>
+ phase</h2>
</div>
</div>
</div>
@@ -10695,11 +10810,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">MASTER_SORT_REGEX</code>.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.checksum" id=
"build.checksum"></a>14.6.&nbsp;The <span class=
"emphasis"><em>checksum</em></span> phase</h2>
</div>
@@ -10715,11 +10831,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
master distribution site or network lossage.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.extract" id=
"build.extract"></a>14.7.&nbsp;The <span class=
"emphasis"><em>extract</em></span> phase</h2>
</div>
@@ -10787,13 +10904,14 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.patch"></a>14.8.&nbsp;The <span class=
- "emphasis"><em>patch</em></span> phase</h2>
+ "build.patch" id="build.patch"></a>14.8.&nbsp;The
+ <span class="emphasis"><em>patch</em></span>
+ phase</h2>
</div>
</div>
</div>
@@ -10835,13 +10953,14 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
there.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.tools"></a>14.9.&nbsp;The <span class=
- "emphasis"><em>tools</em></span> phase</h2>
+ "build.tools" id="build.tools"></a>14.9.&nbsp;The
+ <span class="emphasis"><em>tools</em></span>
+ phase</h2>
</div>
</div>
</div>
@@ -10849,11 +10968,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>[TODO]</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.wrapper" id=
"build.wrapper"></a>14.10.&nbsp;The <span class=
"emphasis"><em>wrapper</em></span> phase</h2>
</div>
@@ -10863,11 +10983,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>[TODO]</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.configure" id=
"build.configure"></a>14.11.&nbsp;The <span class=
"emphasis"><em>configure</em></span> phase</h2>
</div>
@@ -10922,13 +11043,14 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">USE_X11BASE</code> instead.)</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.build"></a>14.12.&nbsp;The <span class=
- "emphasis"><em>build</em></span> phase</h2>
+ "build.build" id="build.build"></a>14.12.&nbsp;The
+ <span class="emphasis"><em>build</em></span>
+ phase</h2>
</div>
</div>
</div>
@@ -10968,13 +11090,14 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
&#8220;<span class="quote">all</span>&#8221;.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.test"></a>14.13.&nbsp;The <span class=
- "emphasis"><em>test</em></span> phase</h2>
+ "build.test" id="build.test"></a>14.13.&nbsp;The
+ <span class="emphasis"><em>test</em></span>
+ phase</h2>
</div>
</div>
</div>
@@ -10982,11 +11105,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>[TODO]</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.install" id=
"build.install"></a>14.14.&nbsp;The <span class=
"emphasis"><em>install</em></span> phase</h2>
</div>
@@ -10996,21 +11120,122 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>Once the build stage has completed, the final step is
to install the software in public directories, so users
can access the programs and files. As in the
- build-target, <code class="varname">$MAKE_PROGRAM</code>
- is invoked on <code class="varname">$MAKEFILE</code>
- here, but with the <code class=
- "varname">$INSTALL_TARGET</code> instead, the latter
- defaulting to &#8220;<span class=
+ build-target, <code class="varname">MAKE_PROGRAM</code>
+ is invoked on <code class="varname">MAKEFILE</code> here,
+ but with the <code class="varname">INSTALL_TARGET</code>
+ instead, the latter defaulting to &#8220;<span class=
"quote">install</span>&#8221; (plus &#8220;<span class=
"quote">install.man</span>&#8221;, if <code class=
"varname">USE_IMAKE</code> is set).</p>
+
+ <p>In the <span class="emphasis"><em>install</em></span>
+ phase, the following variables are useful. They are all
+ variations of the <a href=
+ "http://netbsd.gw.com/cgi-bin/man-cgi?install+1+NetBSD-current">
+ <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>
+
+ <div class="variablelist">
+ <dl>
+ <dt><span class="term"><code class=
+ "varname">INSTALL_PROGRAM_DIR</code></span></dt>
+
+ <dd>
+ <p>directories that contain binaries</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_SCRIPT_DIR</code></span></dt>
+
+ <dd>
+ <p>directories that contain scripts</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_LIB_DIR</code></span></dt>
+
+ <dd>
+ <p>directories that contain shared and static
+ libraries</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_DATA_DIR</code></span></dt>
+
+ <dd>
+ <p>directories that contain data files</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_MAN_DIR</code></span></dt>
+
+ <dd>
+ <p>directories that contain man pages</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_PROGRAM</code></span></dt>
+
+ <dd>
+ <p>binaries that can be stripped from debugging
+ symbols</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_SCRIPT</code></span></dt>
+
+ <dd>
+ <p>binaries that cannot be unstripped</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_GAME</code></span></dt>
+
+ <dd>
+ <p>game binaries</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_LIB</code></span></dt>
+
+ <dd>
+ <p>shared and static libraries</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_DATA</code></span></dt>
+
+ <dd>
+ <p>data files</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_GAME_DATA</code></span></dt>
+
+ <dd>
+ <p>data files for games</p>
+ </dd>
+
+ <dt><span class="term"><code class=
+ "varname">INSTALL_MAN</code></span></dt>
+
+ <dd>
+ <p>man pages</p>
+ </dd>
+ </dl>
+ </div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.package" id=
"build.package"></a>14.15.&nbsp;The <span class=
"emphasis"><em>package</em></span> phase</h2>
</div>
@@ -11020,11 +11245,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>[TODO]</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "build.helpful-targets" id=
"build.helpful-targets"></a>14.16.&nbsp;Other
helpful targets</h2>
</div>
@@ -11560,11 +11786,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="fixes" id=
"fixes"></a>Chapter&nbsp;15.&nbsp;Making your package
work</h2>
</div>
@@ -11766,22 +11992,24 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "general-operation" id=
"general-operation"></a>15.1.&nbsp;General
operation</h2>
</div>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "pulling-vars-from-etc-mk.conf" id=
"pulling-vars-from-etc-mk.conf"></a>15.1.1.&nbsp;How
to pull in variables from /etc/mk.conf</h3>
</div>
@@ -11845,11 +12073,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
interested in optimization for the current CPU.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "where-to-install-documentation" id=
"where-to-install-documentation"></a>15.1.2.&nbsp;Where
to install documentation</h3>
</div>
@@ -11865,11 +12094,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
package).</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="restricted-packages"
+ id=
"restricted-packages"></a>15.1.3.&nbsp;Restricted
packages</h3>
</div>
@@ -11944,11 +12174,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
binary packages!</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="dependencies" id=
"dependencies"></a>15.1.4.&nbsp;Handling
dependencies</h3>
</div>
@@ -12122,8 +12352,8 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<code class="varname">RECOMMENDED</code>, see
<a href="#security-handling" title=
"15.1.8.&nbsp;Handling packages with security problems">
- Section&nbsp;15.1.8, &#8220;Handling packages
- with security problems&#8221;</a> for more
+ Section 15.1.8, &#8220;Handling packages with
+ security problems&#8221;</a> for more
information.</p>
</li>
@@ -12199,11 +12429,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">devel/gettext-m4</code></a> package.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="conflicts" id=
"conflicts"></a>15.1.5.&nbsp;Handling conflicts
with other packages</h3>
</div>
@@ -12251,11 +12481,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"quote">Xaw3d-1.3</span>&#8221;.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="not-building-packages"
+ id=
"not-building-packages"></a>15.1.6.&nbsp;Packages
that cannot or should not be built</h3>
</div>
@@ -12284,11 +12515,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
message.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="undeletable-packages"
+ id=
"undeletable-packages"></a>15.1.7.&nbsp;Packages
which should not be deleted, once installed</h3>
</div>
@@ -12309,11 +12541,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
is used.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="security-handling" id=
"security-handling"></a>15.1.8.&nbsp;Handling
packages with security problems</h3>
</div>
@@ -12348,11 +12580,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
handled semi-automatically by a weekly cron job.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="compiler-bugs" id=
"compiler-bugs"></a>15.1.9.&nbsp;How to handle
compiler bugs</h3>
</div>
@@ -12375,12 +12607,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
number of examples!</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
- "bumping-pkgrevision"></a>15.1.10.&nbsp;How to
+ <h3 class="title"><a name="bumping-pkgrevision"
+ id="bumping-pkgrevision"></a>15.1.10.&nbsp;How to
handle incrementing versions when fixing an
existing package</h3>
</div>
@@ -12416,11 +12648,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "portability-of-packages" id=
"portability-of-packages"></a>15.1.11.&nbsp;Portability
of packages</h3>
</div>
@@ -12433,11 +12666,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
portable. There are some particular details you should
pay attention to while working on pkgsrc.</p>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name=
+ <h4 class="title"><a name="install-scripts" id=
"install-scripts"></a>15.1.11.1.&nbsp;${INSTALL},
${INSTALL_DATA_DIR}, ...</h4>
</div>
@@ -12458,22 +12691,23 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "downloading-issues" id=
"downloading-issues"></a>15.2.&nbsp;Possible
downloading issues</h2>
</div>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="no-plain-download" id=
"no-plain-download"></a>15.2.1.&nbsp;Packages
whose distfiles aren't available for plain
downloading</h3>
@@ -12543,11 +12777,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
with them.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "modified-distfiles-same-name" id=
"modified-distfiles-same-name"></a>15.2.2.&nbsp;How
to handle modified distfiles with the 'old'
name</h3>
@@ -12585,22 +12820,23 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "configuration-gotchas" id=
"configuration-gotchas"></a>15.3.&nbsp;Configuration
gotchas</h2>
</div>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="fixes.libtool" id=
"fixes.libtool"></a>15.3.1.&nbsp;Shared libraries
- libtool</h3>
</div>
@@ -12825,11 +13061,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="using-libtool" id=
"using-libtool"></a>15.3.2.&nbsp;Using libtool on
GNU packages that already support libtool</h3>
</div>
@@ -12908,11 +13144,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="autoconf-automake" id=
"autoconf-automake"></a>15.3.3.&nbsp;GNU
Autoconf/Automake</h3>
</div>
@@ -12965,22 +13201,23 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "fixes-build" id=
"fixes-build"></a>15.4.&nbsp;Building the
package</h2>
</div>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="cpp-defines" id=
"cpp-defines"></a>15.4.1.&nbsp;CPP defines</h3>
</div>
</div>
@@ -13011,11 +13248,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
that you are using NetBSD on an i386 compatible CPU,
and your compiler is GCC.</p>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "fixes-build-cpp-opsys" id=
"fixes-build-cpp-opsys"></a>15.4.1.1.&nbsp;CPP
defines for operating systems</h4>
</div>
@@ -13047,12 +13285,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name=
- "fixes-build-cpp-cpu"></a>15.4.1.2.&nbsp;CPP
+ <h4 class="title"><a name="fixes-build-cpp-cpu"
+ id="fixes-build-cpp-cpu"></a>15.4.1.2.&nbsp;CPP
defines for CPUs</h4>
</div>
</div>
@@ -13064,11 +13302,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect3" lang="en">
+ <div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a name=
+ "fixes-build-cpp-compiler" id=
"fixes-build-cpp-compiler"></a>15.4.1.3.&nbsp;CPP
defines for compilers</h4>
</div>
@@ -13081,11 +13320,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="cpp-list-examples" id=
"cpp-list-examples"></a>15.4.2.&nbsp;Examples of
CPP defines for some platforms</h3>
</div>
@@ -13149,11 +13388,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="cpp-list" id=
"cpp-list"></a>15.4.3.&nbsp;Getting a list of CPP
defines</h3>
</div>
@@ -13174,22 +13413,23 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "package-specific-actions" id=
"package-specific-actions"></a>15.5.&nbsp;Package
specific actions</h2>
</div>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="user-interaction" id=
"user-interaction"></a>15.5.1.&nbsp;User
interaction</h3>
</div>
@@ -13236,11 +13476,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="handling-licenses" id=
"handling-licenses"></a>15.5.2.&nbsp;Handling
licenses</h3>
</div>
@@ -13335,11 +13575,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
pkgsrc that a fee has been paid.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "installing-score-files" id=
"installing-score-files"></a>15.5.3.&nbsp;Installing
score files</h3>
</div>
@@ -13374,11 +13615,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
these correctly.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="perl-scripts" id=
"perl-scripts"></a>15.5.4.&nbsp;Packages
containing perl scripts</h3>
</div>
@@ -13393,11 +13634,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">WRKSRC</code>, that you want adjusted.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="hardcoded-paths" id=
"hardcoded-paths"></a>15.5.5.&nbsp;Packages with
hardcoded paths to other interpreters</h3>
</div>
@@ -13422,11 +13663,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="perl-modules" id=
"perl-modules"></a>15.5.6.&nbsp;Packages
installing perl modules</h3>
</div>
@@ -13471,11 +13712,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">PLIST</code>.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="faq.info-files" id=
"faq.info-files"></a>15.5.7.&nbsp;Packages
installing info files</h3>
</div>
@@ -13575,11 +13816,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
error.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="manpages" id=
"manpages"></a>15.5.8.&nbsp;Packages installing
man pages</h3>
</div>
@@ -13643,11 +13884,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
on installation of compressed manual pages.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="gconf2-data-files" id=
"gconf2-data-files"></a>15.5.9.&nbsp;Packages
installing GConf2 data files</h3>
</div>
@@ -13732,11 +13973,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "scrollkeeper-data-files" id=
"scrollkeeper-data-files"></a>15.5.10.&nbsp;Packages
installing scrollkeeper data files</h3>
</div>
@@ -13782,11 +14024,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="x11-fonts" id=
"x11-fonts"></a>15.5.11.&nbsp;Packages installing
X11 fonts</h3>
</div>
@@ -13819,11 +14061,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
them.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="gtk2-modules" id=
"gtk2-modules"></a>15.5.12.&nbsp;Packages
installing GTK2 modules</h3>
</div>
@@ -13893,11 +14135,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="sgml-xml-data" id=
"sgml-xml-data"></a>15.5.13.&nbsp;Packages
installing SGML or XML data</h3>
</div>
@@ -13957,11 +14199,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="mime-database" id=
"mime-database"></a>15.5.14.&nbsp;Packages
installing extensions to the MIME database</h3>
</div>
@@ -14024,11 +14266,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="intltool" id=
"intltool"></a>15.5.15.&nbsp;Packages using
intltool</h3>
</div>
@@ -14049,11 +14291,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
appeared since it was released.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="startup-scripts" id=
"startup-scripts"></a>15.5.16.&nbsp;Packages
installing startup scripts</h3>
</div>
@@ -14073,11 +14315,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
when the package is deinstalled.</p>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="tex-packages" id=
"tex-packages"></a>15.5.17.&nbsp;Packages
installing TeX modules</h3>
</div>
@@ -14150,11 +14392,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "feedback-to-author" id=
"feedback-to-author"></a>15.6.&nbsp;Feedback to the
author</h2>
</div>
@@ -14174,11 +14417,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="debug" id=
"debug"></a>Chapter&nbsp;16.&nbsp;Debugging</h2>
</div>
</div>
@@ -14390,11 +14633,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en">
+ <div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="submit" id=
"submit"></a>Chapter&nbsp;17.&nbsp;Submitting and
Committing</h2>
</div>
@@ -14426,11 +14669,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "submitting-your-package" id=
"submitting-your-package"></a>17.1.&nbsp;Submitting
your packages</h2>
</div>
@@ -14495,11 +14739,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "general-notes-for-changes" id=
"general-notes-for-changes"></a>17.2.&nbsp;General
notes when adding, updating, or removing
packages</h2>
@@ -14548,11 +14793,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">pkgsrc/doc/CHANGES</code>!</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "committing-importing" id=
"committing-importing"></a>17.3.&nbsp;Committing:
Importing a package into CVS</h2>
</div>
@@ -14597,11 +14843,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
consistent tag.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "updating-package" id=
"updating-package"></a>17.4.&nbsp;Updating a
package to a newer version</h2>
</div>
@@ -14648,11 +14895,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
preferred above new and possibly untested features.</p>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "moving-package" id=
"moving-package"></a>17.5.&nbsp;Moving a package in
pkgsrc</h2>
</div>
@@ -14741,11 +14989,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="appendix" lang="en">
+ <div class="appendix" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="examples" id=
"examples"></a>Appendix&nbsp;A.&nbsp;A simple example
package: bison</h2>
</div>
@@ -14790,21 +15038,22 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
present in the tree is beyond us, but it's useful for the
purposes of this exercise.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "example-files" id=
"example-files"></a>A.1.&nbsp;files</h2>
</div>
</div>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="example-Makefile" id=
"example-Makefile"></a>A.1.1.&nbsp;Makefile</h3>
</div>
</div>
@@ -14828,11 +15077,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="example-descr" id=
"example-descr"></a>A.1.2.&nbsp;DESCR</h3>
</div>
</div>
@@ -14845,11 +15094,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name=
+ <h3 class="title"><a name="example-plist" id=
"example-plist"></a>A.1.3.&nbsp;PLIST</h3>
</div>
</div>
@@ -14863,11 +15112,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en">
+ <div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
+ "checking-package-with-pkglint" id=
"checking-package-with-pkglint"></a>A.1.4.&nbsp;Checking
a package with <span><strong class=
"command">pkglint</strong></span></h3>
@@ -14898,11 +15148,12 @@ looks fine.
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "steps-for-b-i-p" id=
"steps-for-b-i-p"></a>A.2.&nbsp;Steps for building,
installing, packaging</h2>
</div>
@@ -14930,8 +15181,8 @@ looks fine.
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">PLIST</code> (see <a href="#components" title=
"Chapter&nbsp;8.&nbsp;Package components - files, directories and contents">
- Chapter&nbsp;8, <i>Package components - files, directories
- and contents</i></a>) then continue with fetching the
+ Chapter 8, <i>Package components - files, directories and
+ contents</i></a>) then continue with fetching the
distfile:</p>
<pre class="screen">
<code class="prompt">#</code> <strong class=
@@ -15056,11 +15307,11 @@ Creating gzip'd tar ball in '/u/pkgsrc/lang/bison/bison-1.25.tgz'
</div>
</div>
- <div class="appendix" lang="en">
+ <div class="appendix" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="logs" id=
"logs"></a>Appendix&nbsp;B.&nbsp;Build logs</h2>
</div>
</div>
@@ -15078,11 +15329,12 @@ Creating gzip'd tar ball in '/u/pkgsrc/lang/bison/bison-1.25.tgz'
</dl>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "logs.building" id=
"logs.building"></a>B.1.&nbsp;Building figlet</h2>
</div>
</div>
@@ -15181,11 +15433,12 @@ cp figlet.6 /usr/pkg/man/man6
</pre>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "logs.package" id=
"logs.package"></a>B.2.&nbsp;Packaging figlet</h2>
</div>
</div>
@@ -15204,11 +15457,11 @@ Registering depends:.
</div>
</div>
- <div class="appendix" lang="en">
+ <div class="appendix" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="ftp-layout" id=
"ftp-layout"></a>Appendix&nbsp;C.&nbsp;Layout of the
FTP server's package archive</h2>
</div>
@@ -15283,8 +15536,8 @@ Registering depends:.
<ol type="1">
<li>
<p>Run bulk build, see <a href="#bulkbuild" title=
- "6.3.&nbsp;Doing a bulk build of all packages">Section&nbsp;6.3,
- &#8220;Doing a bulk build of all
+ "6.3.&nbsp;Doing a bulk build of all packages">Section
+ 6.3, &#8220;Doing a bulk build of all
packages&#8221;</a></p>
</li>
@@ -15307,11 +15560,11 @@ Registering depends:.
</div>
</div>
- <div class="appendix" lang="en">
+ <div class="appendix" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name=
+ <h2 class="title"><a name="editing" id=
"editing"></a>Appendix&nbsp;D.&nbsp;Editing guidelines
for the pkgsrc guide</h2>
</div>
@@ -15333,12 +15586,12 @@ Registering depends:.
<p>This section contains information on editing the pkgsrc
guide itself.</p>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "targets"></a>D.1.&nbsp;Targets</h2>
+ "targets" id="targets"></a>D.1.&nbsp;Targets</h2>
</div>
</div>
</div>
@@ -15390,11 +15643,12 @@ Registering depends:.
</div>
</div>
- <div class="sect1" lang="en">
+ <div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
+ "procedure" id=
"procedure"></a>D.2.&nbsp;Procedure</h2>
</div>
</div>