summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorminskim <minskim>2005-11-13 03:53:14 +0000
committerminskim <minskim>2005-11-13 03:53:14 +0000
commitcbfeddb3c5bf9ceb0e1cc16733d34a5220c29e1e (patch)
tree8c9cd6f5442962a69df2e450bae55c5e3a527dea
parentd6a299317bd7fa66dd750fc6cee102bc9f4d8e0a (diff)
downloadpkgsrc-cbfeddb3c5bf9ceb0e1cc16733d34a5220c29e1e.tar.gz
regen.
-rw-r--r--doc/pkgsrc.html1151
-rw-r--r--doc/pkgsrc.txt162
2 files changed, 707 insertions, 606 deletions
diff --git a/doc/pkgsrc.html b/doc/pkgsrc.html
index fc1955655c1..48a2c3074ab 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 1st August 2004), see www.w3.org" />
+ "HTML Tidy for NetBSD (vers 1 September 2005), 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" xml:lang="en">
+ <div class="book" lang="en">
<div class="titlepage">
<div>
<div>
- <h1 class="title"><a name="the-pkgsrc-guide" id=
- "the-pkgsrc-guide"></a>The pkgsrc guide</h1>
+ <h1 class="title"><a name="the-pkgsrc-guide"></a>The
+ pkgsrc guide</h1>
</div>
<div>
@@ -906,37 +906,45 @@ alink="#0000FF">
info files</a></span></dt>
<dt><span class="sect2"><a href=
- "#gconf2-data-files">15.5.8. Packages
+ "#manpages">15.5.8. Packages installing man
+ pages</a></span></dt>
+
+ <dt><span class="sect2"><a href=
+ "#gconf2-data-files">15.5.9. Packages
installing GConf2 data files</a></span></dt>
<dt><span class="sect2"><a href=
- "#scrollkeeper-data-files">15.5.9. Packages
+ "#scrollkeeper-data-files">15.5.10. Packages
installing scrollkeeper data
files</a></span></dt>
<dt><span class="sect2"><a href=
- "#x11-fonts">15.5.10. Packages installing X11
+ "#x11-fonts">15.5.11. Packages installing X11
fonts</a></span></dt>
<dt><span class="sect2"><a href=
- "#gtk2-modules">15.5.11. Packages installing
+ "#gtk2-modules">15.5.12. Packages installing
GTK2 modules</a></span></dt>
<dt><span class="sect2"><a href=
- "#sgml-xml-data">15.5.12. Packages installing
+ "#sgml-xml-data">15.5.13. Packages installing
SGML or XML data</a></span></dt>
<dt><span class="sect2"><a href=
- "#mime-database">15.5.13. Packages installing
+ "#mime-database">15.5.14. Packages installing
extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href=
- "#intltool">15.5.14. Packages using
+ "#intltool">15.5.15. Packages using
intltool</a></span></dt>
<dt><span class="sect2"><a href=
- "#startup-scripts">15.5.15. Packages installing
+ "#startup-scripts">15.5.16. Packages installing
startup scripts</a></span></dt>
+
+ <dt><span class="sect2"><a href=
+ "#tex-packages">15.5.17. Packages installing
+ TeX modules</a></span></dt>
</dl>
</dd>
@@ -1042,11 +1050,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="introduction" id=
+ <h2 class="title"><a name=
"introduction"></a>Chapter&nbsp;1.&nbsp;What is
pkgsrc?</h2>
</div>
@@ -1071,12 +1079,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -1209,12 +1216,12 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "overview" id="overview"></a>1.2.&nbsp;Overview</h2>
+ "overview"></a>1.2.&nbsp;Overview</h2>
</div>
</div>
</div>
@@ -1255,12 +1262,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -1355,12 +1361,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -1376,11 +1381,11 @@ alink="#0000FF">
</div>
</div>
- <div class="part" lang="en" xml:lang="en">
+ <div class="part" lang="en">
<div class="titlepage">
<div>
<div>
- <h1 class="title"><a name="users-guide" id=
+ <h1 class="title"><a name=
"users-guide"></a>Part&nbsp;I.&nbsp;The pkgsrc user's
guide</h1>
</div>
@@ -1660,11 +1665,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="getting" id=
+ <h2 class="title"><a name=
"getting"></a>Chapter&nbsp;2.&nbsp;Where to get
pkgsrc</h2>
</div>
@@ -1690,13 +1695,12 @@ alink="#0000FF">
file, via SUP, or via CVS. All three ways are described
here.</p>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "as-tar-file" id="as-tar-file"></a>2.1.&nbsp;As tar
- file</h2>
+ "as-tar-file"></a>2.1.&nbsp;As tar file</h2>
</div>
</div>
</div>
@@ -1709,12 +1713,12 @@ alink="#0000FF">
class="filename">/usr/pkgsrc</code>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "via-sup" id="via-sup"></a>2.2.&nbsp;Via SUP</h2>
+ "via-sup"></a>2.2.&nbsp;Via SUP</h2>
</div>
</div>
</div>
@@ -1736,12 +1740,12 @@ alink="#0000FF">
<em class="replaceable"><code>/path/to/your/supfile</code></em></strong></span>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "via-cvs" id="via-cvs"></a>2.3.&nbsp;Via CVS</h2>
+ "via-cvs"></a>2.3.&nbsp;Via CVS</h2>
</div>
</div>
</div>
@@ -1784,11 +1788,11 @@ alink="#0000FF">
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="platforms" id=
+ <h2 class="title"><a name=
"platforms"></a>Chapter&nbsp;3.&nbsp;Using pkgsrc on
systems other than NetBSD</h2>
</div>
@@ -1834,12 +1838,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -1906,7 +1909,7 @@ alink="#0000FF">
</pre>
<p>See <a href="#getting" title=
- "Chapter&nbsp;2.&nbsp;Where to get pkgsrc">Chapter 2,
+ "Chapter&nbsp;2.&nbsp;Where to get pkgsrc">Chapter&nbsp;2,
<i>Where to get pkgsrc</i></a> for other ways to get
pkgsrc before bootstrapping. The given
<span><strong class="command">bootstrap</strong></span>
@@ -1941,12 +1944,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -1956,11 +1958,11 @@ alink="#0000FF">
<p>Here are some platform-specific notes you should be
aware of.</p>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="darwin" id=
+ <h3 class="title"><a name=
"darwin"></a>3.2.1.&nbsp;Darwin (Mac OS X)</h3>
</div>
</div>
@@ -2001,13 +2003,13 @@ alink="#0000FF">
be case-sensitive, and HFS+ is not.</p>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name="platform.osx-image"
- id="platform.osx-image"></a>3.2.1.1.&nbsp;Using
- a disk image</h4>
+ <h4 class="title"><a name=
+ "platform.osx-image"></a>3.2.1.1.&nbsp;Using a
+ disk image</h4>
</div>
</div>
</div>
@@ -2027,12 +2029,12 @@ alink="#0000FF">
<p>That's it!</p>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name="platform.osx-ufs"
- id="platform.osx-ufs"></a>3.2.1.2.&nbsp;Using a
+ <h4 class="title"><a name=
+ "platform.osx-ufs"></a>3.2.1.2.&nbsp;Using a
UFS partition</h4>
</div>
</div>
@@ -2094,11 +2096,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="freebsd" id=
+ <h3 class="title"><a name=
"freebsd"></a>3.2.2.&nbsp;FreeBSD</h3>
</div>
</div>
@@ -2156,11 +2158,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="interix" id=
+ <h3 class="title"><a name=
"interix"></a>3.2.3.&nbsp;Interix</h3>
</div>
</div>
@@ -2181,12 +2183,11 @@ alink="#0000FF">
officially supported. (The main difference in 3.0/3.1
is lack of pthreads.)</p>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" 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>
@@ -2249,12 +2250,11 @@ alink="#0000FF">
"_top">http://www.duh.org/interix/hotfixes.php</a>.</p>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" 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>
@@ -2304,12 +2304,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" 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>
@@ -2348,12 +2347,11 @@ alink="#0000FF">
</pre>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" 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>
@@ -2369,18 +2367,22 @@ alink="#0000FF">
<ul type="disc">
<li>
<p><span class=
- "strong"><strong>X-Windows:</strong></span></p>
+ "strong"><strong>X11:</strong></span></p>
<p>Interix comes with the standard set of X11R6
- client libraries, and can run X-Windows based
+ client libraries, and can run X11 based
applications, but it does <span class=
"emphasis"><em>not</em></span> come with an X
server. Some options are <a href=
"http://www.starnet.com/products/xwin32/"
target="_top">StarNet X-Win32</a>, <a href=
"http://connectivity.hummingbird.com/products/nc/exceed/"
- target="_top">Hummingbird Exceed</a>, and the
- free X-Windows server included with <a href=
+ target="_top">Hummingbird Exceed</a> (available
+ in a trimmed version for Interix from Interop
+ Systems as the <a href=
+ "http://www.interopsystems.com/InteropXserver.htm"
+ target="_top">Interop X Server</a>), and the
+ free X11 server included with <a href=
"http://x.cygwin.com/" target=
"_top">Cygwin</a>.</p>
@@ -2394,7 +2396,7 @@ alink="#0000FF">
</li>
<li>
- <p><span class="strong"><strong>X-Windows
+ <p><span class="strong"><strong>X11
acceleration:</strong></span></p>
<p>Because Interix runs in a completely
@@ -2462,12 +2464,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" 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>
@@ -2495,11 +2496,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="irix" id=
+ <h3 class="title"><a name=
"irix"></a>3.2.4.&nbsp;IRIX</h3>
</div>
</div>
@@ -2583,11 +2584,11 @@ alink="#0000FF">
pass the '--preserve-path' flag.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="linux" id=
+ <h3 class="title"><a name=
"linux"></a>3.2.5.&nbsp;Linux</h3>
</div>
</div>
@@ -2664,11 +2665,11 @@ alink="#0000FF">
libtool.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="openbsd" id=
+ <h3 class="title"><a name=
"openbsd"></a>3.2.6.&nbsp;OpenBSD</h3>
</div>
</div>
@@ -2737,11 +2738,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="solaris" id=
+ <h3 class="title"><a name=
"solaris"></a>3.2.7.&nbsp;Solaris</h3>
</div>
</div>
@@ -2782,13 +2783,13 @@ alink="#0000FF">
<span class="emphasis"><em>not</em></span>
supported.</p>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name="solaris-gcc-note"
- id="solaris-gcc-note"></a>3.2.7.1.&nbsp;If you
- are using gcc</h4>
+ <h4 class="title"><a name=
+ "solaris-gcc-note"></a>3.2.7.1.&nbsp;If you are
+ using gcc</h4>
</div>
</div>
</div>
@@ -2813,12 +2814,11 @@ alink="#0000FF">
"_top">http://www.sun.com/bigadmin/common/freewareSearch.html</a>.</p>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" 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>
@@ -2881,11 +2881,11 @@ alink="#0000FF">
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="using" id=
+ <h2 class="title"><a name=
"using"></a>Chapter&nbsp;4.&nbsp;Using pkgsrc</h2>
</div>
</div>
@@ -2939,12 +2939,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -2955,12 +2954,11 @@ alink="#0000FF">
install a precompiled binary package that someone else
already prepared for your type of machine.</p>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -2997,12 +2995,11 @@ alink="#0000FF">
documentation for the exact location.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -3072,11 +3069,11 @@ alink="#0000FF">
just installed program.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="a-word-of-warning" id=
+ <h3 class="title"><a name=
"a-word-of-warning"></a>4.1.3.&nbsp;A word of
warning</h3>
</div>
@@ -3095,12 +3092,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -3113,11 +3109,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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="requirements" id=
+ <h3 class="title"><a name=
"requirements"></a>4.2.1.&nbsp;Requirements</h3>
</div>
</div>
@@ -3133,12 +3129,12 @@ alink="#0000FF">
required, too.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="fetching-distfiles"
- id="fetching-distfiles"></a>4.2.2.&nbsp;Fetching
+ <h3 class="title"><a name=
+ "fetching-distfiles"></a>4.2.2.&nbsp;Fetching
distfiles</h3>
</div>
</div>
@@ -3176,12 +3172,11 @@ alink="#0000FF">
"filename">/usr/pkgsrc/distfiles</code>.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -3229,8 +3224,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 B, <i>Build
- logs</i></a>.</p>
+ "Appendix&nbsp;B.&nbsp;Build logs">Appendix&nbsp;B,
+ <i>Build logs</i></a>.</p>
<p>The program is installed under the default root of
the packages tree - <code xmlns=
@@ -3368,12 +3363,11 @@ alink="#0000FF">
"varname">LOCALBASE</code>.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -3459,11 +3453,11 @@ alink="#0000FF">
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="configuring" id=
+ <h2 class="title"><a name=
"configuring"></a>Chapter&nbsp;5.&nbsp;Configuring
pkgsrc</h2>
</div>
@@ -3492,12 +3486,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -3579,12 +3572,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -3656,12 +3648,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -3708,12 +3699,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -3810,11 +3800,11 @@ alink="#0000FF">
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="binary" id=
+ <h2 class="title"><a name=
"binary"></a>Chapter&nbsp;6.&nbsp;Creating binary
packages</h2>
</div>
@@ -3885,12 +3875,11 @@ alink="#0000FF">
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -3928,7 +3917,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 B.2,
+ "B.2.&nbsp;Packaging figlet">Section&nbsp;B.2,
&#8220;Packaging figlet&#8221;</a> for a continuation of
the above <a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
@@ -3937,17 +3926,16 @@ alink="#0000FF">
"filename">misc/figlet</code></a> example.</p>
<p>See <a href="#submit" title=
- "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>
+ "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>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -3959,13 +3947,13 @@ alink="#0000FF">
&#8220;Other helpful targets&#8221;</a>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "bulkbuild" id="bulkbuild"></a>6.3.&nbsp;Doing a
- bulk build of all packages</h2>
+ "bulkbuild"></a>6.3.&nbsp;Doing a bulk build of all
+ packages</h2>
</div>
</div>
</div>
@@ -3984,22 +3972,21 @@ alink="#0000FF">
sure to not actually compile on NFS storage, as this
slows things down a lot.</p>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="binary.configuration"
- id=
+ <h3 class="title"><a name=
"binary.configuration"></a>6.3.1.&nbsp;Configuration</h3>
</div>
</div>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name="binary.mk.conf" id=
+ <h4 class="title"><a name=
"binary.mk.conf"></a>6.3.1.1.&nbsp;/etc/mk.conf</h4>
</div>
</div>
@@ -4028,11 +4015,11 @@ alink="#0000FF">
</pre>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name="build.conf" id=
+ <h4 class="title"><a name=
"build.conf"></a>6.3.1.2.&nbsp;<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional"
class="filename">build.conf</code></h4>
@@ -4059,11 +4046,11 @@ alink="#0000FF">
update</strong></span>.</p>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name="pre-build.local" id=
+ <h4 class="title"><a name=
"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>
@@ -4099,12 +4086,11 @@ alink="#0000FF">
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -4146,11 +4132,11 @@ alink="#0000FF">
warned! :)</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="operation" id=
+ <h3 class="title"><a name=
"operation"></a>6.3.3.&nbsp;Operation</h3>
</div>
</div>
@@ -4195,11 +4181,11 @@ alink="#0000FF">
class="filename">build.conf</code> file.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="what-it-does" id=
+ <h3 class="title"><a name=
"what-it-does"></a>6.3.4.&nbsp;What it does</h3>
</div>
</div>
@@ -4259,12 +4245,11 @@ alink="#0000FF">
these broken package builds later.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -4303,13 +4288,13 @@ alink="#0000FF">
recompiling.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <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>
+ <h3 class="title"><a name=
+ "setting-up-a-sandbox"></a>6.3.6.&nbsp;Setting up
+ a sandbox for chrooted builds</h3>
</div>
</div>
</div>
@@ -4520,12 +4505,11 @@ alink="#0000FF">
(wherever that points/mounts to/from).</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -4575,11 +4559,11 @@ alink="#0000FF">
needed.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="bulk-upload" id=
+ <h3 class="title"><a name=
"bulk-upload"></a>6.3.8.&nbsp;Uploading results
of a bulk build</h3>
</div>
@@ -4725,12 +4709,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -4751,11 +4734,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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="cdpack-example" id=
+ <h3 class="title"><a name=
"cdpack-example"></a>6.4.1.&nbsp;Example of
cdpack</h3>
</div>
@@ -4821,11 +4804,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="faq" id=
+ <h2 class="title"><a name=
"faq"></a>Chapter&nbsp;7.&nbsp;Frequently Asked
Questions</h2>
</div>
@@ -4904,12 +4887,11 @@ 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" xml:lang="en">
+ <div class="sect1" 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>
@@ -4964,12 +4946,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"_top">http://mail-index.NetBSD.org/</a>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -4982,12 +4963,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">pkgsrc/mk/buildlink3/PKGVIEWS_UG</code>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5242,12 +5222,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5285,12 +5264,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
finer tuning of the tree layout.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5329,12 +5307,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5355,12 +5332,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5381,12 +5357,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5407,13 +5382,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "passive-ftp" id="passive-ftp"></a>7.9.&nbsp;How do
- I tell <span><strong class="command">make
+ "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>
@@ -5458,12 +5433,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
active transfers.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5534,12 +5508,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5571,12 +5544,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
class="filename">/etc/mk.conf</code>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5605,12 +5577,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
-r</strong></span>).</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5641,13 +5612,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "faq.conf" id="faq.conf"></a>7.14.&nbsp;How do I
- change the location of configuration files?</h2>
+ "faq.conf"></a>7.14.&nbsp;How do I change the
+ location of configuration files?</h2>
</div>
</div>
</div>
@@ -5685,12 +5656,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
rebuild and reinstall any affected packages.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -5756,11 +5726,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="part" lang="en" xml:lang="en">
+ <div class="part" lang="en">
<div class="titlepage">
<div>
<div>
- <h1 class="title"><a name="developers-guide" id=
+ <h1 class="title"><a name=
"developers-guide"></a>Part&nbsp;II.&nbsp;The pkgsrc
developer's guide</h1>
</div>
@@ -5923,8 +5893,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>
@@ -6273,37 +6243,45 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
info files</a></span></dt>
<dt><span class="sect2"><a href=
- "#gconf2-data-files">15.5.8. Packages installing
+ "#manpages">15.5.8. Packages installing man
+ pages</a></span></dt>
+
+ <dt><span class="sect2"><a href=
+ "#gconf2-data-files">15.5.9. Packages installing
GConf2 data files</a></span></dt>
<dt><span class="sect2"><a href=
- "#scrollkeeper-data-files">15.5.9. Packages
+ "#scrollkeeper-data-files">15.5.10. Packages
installing scrollkeeper data
files</a></span></dt>
<dt><span class="sect2"><a href=
- "#x11-fonts">15.5.10. Packages installing X11
+ "#x11-fonts">15.5.11. Packages installing X11
fonts</a></span></dt>
<dt><span class="sect2"><a href=
- "#gtk2-modules">15.5.11. Packages installing GTK2
+ "#gtk2-modules">15.5.12. Packages installing GTK2
modules</a></span></dt>
<dt><span class="sect2"><a href=
- "#sgml-xml-data">15.5.12. Packages installing
+ "#sgml-xml-data">15.5.13. Packages installing
SGML or XML data</a></span></dt>
<dt><span class="sect2"><a href=
- "#mime-database">15.5.13. Packages installing
+ "#mime-database">15.5.14. Packages installing
extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href=
- "#intltool">15.5.14. Packages using
+ "#intltool">15.5.15. Packages using
intltool</a></span></dt>
<dt><span class="sect2"><a href=
- "#startup-scripts">15.5.15. Packages installing
+ "#startup-scripts">15.5.16. Packages installing
startup scripts</a></span></dt>
+
+ <dt><span class="sect2"><a href=
+ "#tex-packages">15.5.17. Packages installing TeX
+ modules</a></span></dt>
</dl>
</dd>
@@ -6346,11 +6324,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dl>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="components" id=
+ <h2 class="title"><a name=
"components"></a>Chapter&nbsp;8.&nbsp;Package
components - files, directories and contents</h2>
</div>
@@ -6396,12 +6374,11 @@ 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" xml:lang="en">
+ <div class="sect1" 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>
@@ -6717,12 +6694,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -6771,12 +6747,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
information is not lost.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -6880,12 +6855,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
after pkgsrc patches are applied</em></span>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -6925,12 +6899,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -7014,12 +6987,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "work-dir" id="work-dir"></a>8.6.&nbsp;<code xmlns=
+ "work-dir"></a>8.6.&nbsp;<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">work*</code></h2>
</div>
@@ -7042,12 +7015,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<code class="varname">OBJMACHINE</code> is set.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -7068,11 +7040,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="makefile" id=
+ <h2 class="title"><a name=
"makefile"></a>Chapter&nbsp;9.&nbsp;Programming in
<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
@@ -7157,12 +7129,11 @@ 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" xml:lang="en">
+ <div class="sect1" 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>
@@ -7266,12 +7237,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</ul>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -7307,12 +7277,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -7323,11 +7292,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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="adding-to-list" id=
+ <h3 class="title"><a name=
"adding-to-list"></a>9.2.1.&nbsp;Adding things to
a list</h3>
</div>
@@ -7353,12 +7322,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
are correctly interpreted in both lists.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -7379,12 +7347,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">""</code> is explained below.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -7442,11 +7409,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
there is no example for it.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="quoting-guideline" id=
+ <h3 class="title"><a name=
"quoting-guideline"></a>9.2.4.&nbsp;Quoting
guideline</h3>
</div>
@@ -7567,12 +7534,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -7599,11 +7565,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="plist" id=
+ <h2 class="title"><a name=
"plist"></a>Chapter&nbsp;10.&nbsp;PLIST issues</h2>
</div>
</div>
@@ -7664,12 +7630,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" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "rcs-id" id="rcs-id"></a>10.1.&nbsp;RCS ID</h2>
+ "rcs-id"></a>10.1.&nbsp;RCS ID</h2>
</div>
</div>
</div>
@@ -7682,12 +7648,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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=
@@ -7705,12 +7670,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
information on this target.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -7754,12 +7718,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -7884,12 +7847,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
&#8220;<span class="quote">somevalue</span>&#8221;.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -7914,12 +7876,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
class="filename">PLIST</code> itself.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -7939,12 +7900,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
things is important.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -7991,12 +7951,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -8084,11 +8043,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="buildlink" id=
+ <h2 class="title"><a name=
"buildlink"></a>Chapter&nbsp;11.&nbsp;Buildlink
methodology</h2>
</div>
@@ -8187,12 +8146,11 @@ 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" xml:lang="en">
+ <div class="sect1" 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>
@@ -8361,12 +8319,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
complete description of how to use them properly.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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=
@@ -8410,12 +8367,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"prompt">%</code> createbuildlink &gt;buildlink3.mk</code></strong>
</pre>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="anatomy-of-bl3" id=
- "anatomy-of-bl3"></a>11.2.1. Anatomy of a
+ <h3 class="title"><a name=
+ "anatomy-of-bl3"></a>11.2.1.&nbsp;Anatomy of a
buildlink3.mk file</h3>
</div>
</div>
@@ -8532,9 +8489,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
@@ -8671,16 +8628,15 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
included.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
- "updating-buildlink-depends" id=
- "updating-buildlink-depends"></a>11.2.2. Updating
+ "updating-buildlink-depends"></a>11.2.2.&nbsp;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>
@@ -8731,21 +8687,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
- 15.1.4, &#8220;Handling dependencies&#8221;</a> for
- more information about dependencies on other packages,
+ 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,
including the <code class=
"varname">BUILDLINK_RECOMMENDED</code> and <code class=
"varname">RECOMMENDED</code> definitions.</p>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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=
@@ -8800,12 +8756,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</ol>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="anatomy-of-builtin.mk"
- id=
+ <h3 class="title"><a name=
"anatomy-of-builtin.mk"></a>11.3.1.&nbsp;Anatomy
of a <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional" class=
@@ -8932,12 +8887,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"replaceable"><code>pkg</code></em></code>).</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -8981,11 +8935,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="pkginstall" id=
+ <h2 class="title"><a name=
"pkginstall"></a>Chapter&nbsp;12.&nbsp;The pkginstall
framework</h2>
</div>
@@ -9121,14 +9075,14 @@ 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" xml:lang="en">
+ <div class="sect1" 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. Files and
- directories outside the installation prefix</h2>
+ "files-and-dirs-outside-prefix"></a>12.1.&nbsp;Files
+ and directories outside the installation
+ prefix</h2>
</div>
</div>
</div>
@@ -9161,12 +9115,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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="dirs-outside-prefix"
- id="dirs-outside-prefix"></a>12.1.1. Directory
+ <h3 class="title"><a name=
+ "dirs-outside-prefix"></a>12.1.1.&nbsp;Directory
manipulation</h3>
</div>
</div>
@@ -9211,12 +9165,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="files-outside-prefix"
- id="files-outside-prefix"></a>12.1.2. File
+ <h3 class="title"><a name=
+ "files-outside-prefix"></a>12.1.2.&nbsp;File
manipulation</h3>
</div>
</div>
@@ -9278,13 +9232,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "conf-files" id="conf-files"></a>12.2.
- Configuration files</h2>
+ "conf-files"></a>12.2.&nbsp;Configuration
+ files</h2>
</div>
</div>
</div>
@@ -9303,12 +9257,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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="conf-files-sysconfdir"
- id="conf-files-sysconfdir"></a>12.2.1. How
+ <h3 class="title"><a name=
+ "conf-files-sysconfdir"></a>12.2.1.&nbsp;How
<code class="varname">PKG_SYSCONFDIR</code> is
set</h3>
</div>
@@ -9428,18 +9382,18 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"http://www.w3.org/TR/xhtml1/transitional" class=
"filename">OWN_DIRS</code>. See <a href=
"#dirs-outside-prefix" title=
- "12.1.1.&nbsp;Directory manipulation">Section 12.1.1,
+ "12.1.1.&nbsp;Directory manipulation">Section&nbsp;12.1.1,
&#8220;Directory manipulation&#8221;</a> what this
means.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="conf-files-configure"
- id="conf-files-configure"></a>12.2.2. Telling the
- software where configuration files are</h3>
+ <h3 class="title"><a name=
+ "conf-files-configure"></a>12.2.2.&nbsp;Telling
+ the software where configuration files are</h3>
</div>
</div>
</div>
@@ -9462,12 +9416,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
unfortunately).</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="conf-files-patching"
- id="conf-files-patching"></a>12.2.3. Patching
+ <h3 class="title"><a name=
+ "conf-files-patching"></a>12.2.3.&nbsp;Patching
installations</h3>
</div>
</div>
@@ -9504,7 +9458,7 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
the variables <code class="varname">CONF_FILES</code>
and <code class="varname">CONF_FILES_PERMS</code> are
used. Check out <a href="#files-outside-prefix" title=
- "12.1.2.&nbsp;File manipulation">Section 12.1.2,
+ "12.1.2.&nbsp;File manipulation">Section&nbsp;12.1.2,
&#8220;File manipulation&#8221;</a> for information
about their syntax and their purpose. Here is an
example, taken from the <a xmlns=
@@ -9522,12 +9476,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
outside it.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="conf-files-disable"
- id="conf-files-disable"></a>12.2.4. Disabling
+ <h3 class="title"><a name=
+ "conf-files-disable"></a>12.2.4.&nbsp;Disabling
handling of configuration files</h3>
</div>
</div>
@@ -9540,13 +9494,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "rcd-scripts" id="rcd-scripts"></a>12.3. System
- startup scripts</h2>
+ "rcd-scripts"></a>12.3.&nbsp;System startup
+ scripts</h2>
</div>
</div>
</div>
@@ -9557,8 +9511,8 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
same rules described in <a href=
"#files-and-dirs-outside-prefix" title=
"12.1.&nbsp;Files and directories outside the installation prefix">
- Section 12.1, &#8220;Files and directories outside the
- installation prefix&#8221;</a> apply, and the same
+ Section&nbsp;12.1, &#8220;Files and directories outside
+ the installation prefix&#8221;</a> apply, and the same
solutions can be used. However, pkginstall provides a
special mechanism to handle these files.</p>
@@ -9627,12 +9581,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</ol>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="rcd-scripts-disable"
- id="rcd-scripts-disable"></a>12.3.1. Disabling
+ <h3 class="title"><a name=
+ "rcd-scripts-disable"></a>12.3.1.&nbsp;Disabling
handling of system startup scripts</h3>
</div>
</div>
@@ -9649,13 +9603,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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.
- System users and groups</h2>
+ "users-and-groups"></a>12.4.&nbsp;System users and
+ groups</h2>
</div>
</div>
</div>
@@ -9699,12 +9653,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
numeric identifier is optional.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "shells" id="shells"></a>12.5. System shells</h2>
+ "shells"></a>12.5.&nbsp;System shells</h2>
</div>
</div>
</div>
@@ -9732,13 +9686,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
PKG_SHELL= ${PREFIX}/bin/zsh
</pre>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="shells-disable" id=
- "shells-disable"></a>12.5.1. Disabling handling
- of configuration files</h3>
+ <h3 class="title"><a name=
+ "shells-disable"></a>12.5.1.&nbsp;Disabling
+ handling of configuration files</h3>
</div>
</div>
</div>
@@ -9752,11 +9706,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="options" id=
+ <h2 class="title"><a name=
"options"></a>Chapter&nbsp;13.&nbsp;Options
handling</h2>
</div>
@@ -9792,12 +9746,11 @@ 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" xml:lang="en">
+ <div class="sect1" 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>
@@ -9812,12 +9765,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
class="filename">/etc/mk.conf</code>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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=
@@ -9898,9 +9850,8 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<span class="citerefentry"><span class=
"refentrytitle">make</span>(1)</span></a> variable
that the user can set to override the default
- options. It should be set to &#8220;<span class=
- "quote">PKG_OPTIONS.<em class=
- "replaceable"><code>pkgbase</code></em></span>&#8221;.</p>
+ options. It should be set to PKG_OPTIONS.<em class=
+ "replaceable"><code>pkgbase</code></em>.</p>
</li>
<li>
@@ -9957,9 +9908,8 @@ 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
@@ -9973,10 +9923,9 @@ 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
@@ -10041,12 +9990,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10083,11 +10031,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="build" id=
+ <h2 class="title"><a name=
"build"></a>Chapter&nbsp;14.&nbsp;The build
process</h2>
</div>
@@ -10162,12 +10110,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10203,12 +10150,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
class="filename">pkgsrc/mk/bsd.pkg.mk</code>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10389,12 +10335,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10441,11 +10386,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<dd>
<p>This is an absolute pathname pointing to the
- directory where all work takes place. This
- directory typically contains temporary directories
- used by the various pkgsrc frameworks, like
- <span class="emphasis"><em>buildlink</em></span> or
- the <span class=
+ directory where all work takes place. The distfiles
+ are extraced to this directory. It also contains
+ temporary directories and log files used by the
+ various pkgsrc frameworks, like <span class=
+ "emphasis"><em>buildlink</em></span> or the
+ <span class=
"emphasis"><em>wrappers</em></span>.</p>
</dd>
@@ -10463,12 +10409,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10485,14 +10430,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
will be built, but not installed.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.fetch" id="build.fetch"></a>14.5.&nbsp;The
- <span class="emphasis"><em>fetch</em></span>
- phase</h2>
+ "build.fetch"></a>14.5.&nbsp;The <span class=
+ "emphasis"><em>fetch</em></span> phase</h2>
</div>
</div>
</div>
@@ -10524,12 +10468,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">MASTER_SORT_REGEX</code>.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10545,12 +10488,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
master distribution site or network lossage.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10618,14 +10560,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.patch" id="build.patch"></a>14.8.&nbsp;The
- <span class="emphasis"><em>patch</em></span>
- phase</h2>
+ "build.patch"></a>14.8.&nbsp;The <span class=
+ "emphasis"><em>patch</em></span> phase</h2>
</div>
</div>
</div>
@@ -10667,14 +10608,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
there.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.tools" id="build.tools"></a>14.9.&nbsp;The
- <span class="emphasis"><em>tools</em></span>
- phase</h2>
+ "build.tools"></a>14.9.&nbsp;The <span class=
+ "emphasis"><em>tools</em></span> phase</h2>
</div>
</div>
</div>
@@ -10682,12 +10622,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>[TODO]</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10697,12 +10636,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>[TODO]</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10757,14 +10695,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">USE_X11BASE</code> instead.)</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.build" id="build.build"></a>14.12.&nbsp;The
- <span class="emphasis"><em>build</em></span>
- phase</h2>
+ "build.build"></a>14.12.&nbsp;The <span class=
+ "emphasis"><em>build</em></span> phase</h2>
</div>
</div>
</div>
@@ -10804,14 +10741,13 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
&#8220;<span class="quote">all</span>&#8221;.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "build.test" id="build.test"></a>14.13.&nbsp;The
- <span class="emphasis"><em>test</em></span>
- phase</h2>
+ "build.test"></a>14.13.&nbsp;The <span class=
+ "emphasis"><em>test</em></span> phase</h2>
</div>
</div>
</div>
@@ -10819,12 +10755,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>[TODO]</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10844,12 +10779,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">USE_IMAKE</code> is set).</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -10859,12 +10793,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p>[TODO]</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -11400,11 +11333,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="fixes" id=
+ <h2 class="title"><a name=
"fixes"></a>Chapter&nbsp;15.&nbsp;Making your package
work</h2>
</div>
@@ -11555,37 +11488,44 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"#faq.info-files">15.5.7. Packages installing info
files</a></span></dt>
+ <dt><span class="sect2"><a href="#manpages">15.5.8.
+ Packages installing man pages</a></span></dt>
+
<dt><span class="sect2"><a href=
- "#gconf2-data-files">15.5.8. Packages installing
+ "#gconf2-data-files">15.5.9. Packages installing
GConf2 data files</a></span></dt>
<dt><span class="sect2"><a href=
- "#scrollkeeper-data-files">15.5.9. Packages
+ "#scrollkeeper-data-files">15.5.10. Packages
installing scrollkeeper data files</a></span></dt>
<dt><span class="sect2"><a href=
- "#x11-fonts">15.5.10. Packages installing X11
+ "#x11-fonts">15.5.11. Packages installing X11
fonts</a></span></dt>
<dt><span class="sect2"><a href=
- "#gtk2-modules">15.5.11. Packages installing GTK2
+ "#gtk2-modules">15.5.12. Packages installing GTK2
modules</a></span></dt>
<dt><span class="sect2"><a href=
- "#sgml-xml-data">15.5.12. Packages installing SGML
+ "#sgml-xml-data">15.5.13. Packages installing SGML
or XML data</a></span></dt>
<dt><span class="sect2"><a href=
- "#mime-database">15.5.13. Packages installing
+ "#mime-database">15.5.14. Packages installing
extensions to the MIME database</a></span></dt>
<dt><span class="sect2"><a href=
- "#intltool">15.5.14. Packages using
+ "#intltool">15.5.15. Packages using
intltool</a></span></dt>
<dt><span class="sect2"><a href=
- "#startup-scripts">15.5.15. Packages installing
+ "#startup-scripts">15.5.16. Packages installing
startup scripts</a></span></dt>
+
+ <dt><span class="sect2"><a href=
+ "#tex-packages">15.5.17. Packages installing TeX
+ modules</a></span></dt>
</dl>
</dd>
@@ -11595,24 +11535,22 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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" xml:lang="en">
+ <div class="sect2" 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>
@@ -11676,12 +11614,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
interested in optimization for the current CPU.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -11697,12 +11634,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
package).</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="restricted-packages"
- id=
+ <h3 class="title"><a name=
"restricted-packages"></a>15.1.3.&nbsp;Restricted
packages</h3>
</div>
@@ -11777,11 +11713,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
binary packages!</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="dependencies" id=
+ <h3 class="title"><a name=
"dependencies"></a>15.1.4.&nbsp;Handling
dependencies</h3>
</div>
@@ -11955,8 +11891,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 15.1.8, &#8220;Handling packages with
- security problems&#8221;</a> for more
+ Section&nbsp;15.1.8, &#8220;Handling packages
+ with security problems&#8221;</a> for more
information.</p>
</li>
@@ -12032,11 +11968,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">devel/gettext-m4</code></a> package.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="conflicts" id=
+ <h3 class="title"><a name=
"conflicts"></a>15.1.5.&nbsp;Handling conflicts
with other packages</h3>
</div>
@@ -12084,12 +12020,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"quote">Xaw3d-1.3</span>&#8221;.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="not-building-packages"
- id=
+ <h3 class="title"><a name=
"not-building-packages"></a>15.1.6.&nbsp;Packages
that cannot or should not be built</h3>
</div>
@@ -12118,12 +12053,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
message.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="undeletable-packages"
- id=
+ <h3 class="title"><a name=
"undeletable-packages"></a>15.1.7.&nbsp;Packages
which should not be deleted, once installed</h3>
</div>
@@ -12144,11 +12078,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
is used.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="security-handling" id=
+ <h3 class="title"><a name=
"security-handling"></a>15.1.8.&nbsp;Handling
packages with security problems</h3>
</div>
@@ -12183,11 +12117,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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="compiler-bugs" id=
+ <h3 class="title"><a name=
"compiler-bugs"></a>15.1.9.&nbsp;How to handle
compiler bugs</h3>
</div>
@@ -12210,12 +12144,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
number of examples!</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="bumping-pkgrevision"
- id="bumping-pkgrevision"></a>15.1.10.&nbsp;How to
+ <h3 class="title"><a name=
+ "bumping-pkgrevision"></a>15.1.10.&nbsp;How to
handle incrementing versions when fixing an
existing package</h3>
</div>
@@ -12251,12 +12185,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -12269,11 +12202,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" xml:lang="en">
+ <div class="sect3" lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name="install-scripts" id=
+ <h4 class="title"><a name=
"install-scripts"></a>15.1.11.1.&nbsp;${INSTALL},
${INSTALL_DATA_DIR}, ...</h4>
</div>
@@ -12294,23 +12227,22 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="no-plain-download" id=
+ <h3 class="title"><a name=
"no-plain-download"></a>15.2.1.&nbsp;Packages
whose distfiles aren't available for plain
downloading</h3>
@@ -12380,12 +12312,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
with them.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -12423,23 +12354,22 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="fixes.libtool" id=
+ <h3 class="title"><a name=
"fixes.libtool"></a>15.3.1.&nbsp;Shared libraries
- libtool</h3>
</div>
@@ -12664,11 +12594,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="using-libtool" id=
+ <h3 class="title"><a name=
"using-libtool"></a>15.3.2.&nbsp;Using libtool on
GNU packages that already support libtool</h3>
</div>
@@ -12747,11 +12677,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="autoconf-automake" id=
+ <h3 class="title"><a name=
"autoconf-automake"></a>15.3.3.&nbsp;GNU
Autoconf/Automake</h3>
</div>
@@ -12804,23 +12734,22 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="cpp-defines" id=
+ <h3 class="title"><a name=
"cpp-defines"></a>15.4.1.&nbsp;CPP defines</h3>
</div>
</div>
@@ -12851,12 +12780,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
that you are using NetBSD on an Intel CPU, and your
compiler is GCC.</p>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" 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>
@@ -12880,6 +12808,7 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<pre class="programlisting">
FreeBSD __FreeBSD__
DragonFly __DragonFly__
+ Interix __INTERIX
Linux linux, __linux, __linux__
NetBSD __NetBSD__
OpenBSD __OpenBSD__
@@ -12887,12 +12816,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a name="fixes-build-cpp-cpu"
- id="fixes-build-cpp-cpu"></a>15.4.1.2.&nbsp;CPP
+ <h4 class="title"><a name=
+ "fixes-build-cpp-cpu"></a>15.4.1.2.&nbsp;CPP
defines for CPUs</h4>
</div>
</div>
@@ -12904,12 +12833,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect3" lang="en" xml:lang="en">
+ <div class="sect3" 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>
@@ -12921,11 +12849,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="cpp-list" id=
+ <h3 class="title"><a name=
"cpp-list"></a>15.4.2.&nbsp;Getting a list of CPP
defines</h3>
</div>
@@ -12942,23 +12870,22 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="user-interaction" id=
+ <h3 class="title"><a name=
"user-interaction"></a>15.5.1.&nbsp;User
interaction</h3>
</div>
@@ -13005,11 +12932,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="handling-licenses" id=
+ <h3 class="title"><a name=
"handling-licenses"></a>15.5.2.&nbsp;Handling
licenses</h3>
</div>
@@ -13104,12 +13031,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
pkgsrc that a fee has been paid.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -13144,11 +13070,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
these correctly.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="perl-scripts" id=
+ <h3 class="title"><a name=
"perl-scripts"></a>15.5.4.&nbsp;Packages
containing perl scripts</h3>
</div>
@@ -13163,11 +13089,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"varname">WRKSRC</code>, that you want adjusted.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="hardcoded-paths" id=
+ <h3 class="title"><a name=
"hardcoded-paths"></a>15.5.5.&nbsp;Packages with
hardcoded paths to other interpreters</h3>
</div>
@@ -13192,11 +13118,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="perl-modules" id=
+ <h3 class="title"><a name=
"perl-modules"></a>15.5.6.&nbsp;Packages
installing perl modules</h3>
</div>
@@ -13241,11 +13167,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">PLIST</code>.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="faq.info-files" id=
+ <h3 class="title"><a name=
"faq.info-files"></a>15.5.7.&nbsp;Packages
installing info files</h3>
</div>
@@ -13345,12 +13271,80 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
error.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="gconf2-data-files" id=
- "gconf2-data-files"></a>15.5.8.&nbsp;Packages
+ <h3 class="title"><a name=
+ "manpages"></a>15.5.8.&nbsp;Packages installing
+ man pages</h3>
+ </div>
+ </div>
+ </div>
+
+ <p>Many packages install manual pages. The man pages
+ are installed under <code class=
+ "varname">${PREFIX}/${PKGMANDIR}</code> which is
+ <code xmlns="http://www.w3.org/TR/xhtml1/transitional"
+ class="filename">/usr/pkg/man</code> by default.
+ <code class="varname">PKGMANDIR</code> defaults to
+ &#8220;<span class="quote">man</span>&#8221;. For
+ example, you can set <code class=
+ "varname">PKGMANDIR</code> to &#8220;<span class=
+ "quote">share/man</span>&#8221; to have man pages
+ install under <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">/usr/pkg/share/man/</code> by default.</p>
+
+ <div class="note" style=
+ "margin-left: 0.5in; margin-right: 0.5in;">
+ <h3 class="title">Note</h3>
+
+ <p>The support for a custom <code class=
+ "varname">PKGMANDIR</code> is not complete.</p>
+ </div>
+
+ <p>The <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">PLIST</code> files can just use <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">man/</code> as the top level directory for
+ the man page file entries and the pkgsrc framework will
+ convert as needed.</p>
+
+ <p>Packages that are configured with <code class=
+ "varname">GNU_CONFIGURE</code> set as
+ &#8220;<span class="quote">yes</span>&#8221;, by
+ default will use the <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">./configure</code> --mandir switch to set
+ where the man pages should be installed. The path is
+ <code class="varname">GNU_CONFIGURE_MANDIR</code> which
+ defaults to <code class=
+ "varname">${PREFIX}/${PKGMANDIR}</code>.</p>
+
+ <p>Packages that use <code class=
+ "varname">GNU_CONFIGURE</code> but do not use --mandir,
+ can set <code class=
+ "varname">CONFIGURE_HAS_MANDIR</code> to
+ &#8220;<span class="quote">no</span>&#8221;. Or if the
+ <code xmlns="http://www.w3.org/TR/xhtml1/transitional"
+ class="filename">./configure</code> script uses a
+ non-standard use of --mandir, you can set <code class=
+ "varname">GNU_CONFIGURE_MANDIR</code> as needed.</p>
+
+ <p>See <a href="#manpage-compression" title=
+ "10.5.&nbsp;Man page compression">Section&nbsp;10.5,
+ &#8220;Man page compression&#8221;</a> for information
+ on installation of compressed manual pages.</p>
+ </div>
+
+ <div class="sect2" lang="en">
+ <div class="titlepage">
+ <div>
+ <div>
+ <h3 class="title"><a name=
+ "gconf2-data-files"></a>15.5.9.&nbsp;Packages
installing GConf2 data files</h3>
</div>
</div>
@@ -13434,13 +13428,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name=
- "scrollkeeper-data-files" id=
- "scrollkeeper-data-files"></a>15.5.9.&nbsp;Packages
+ "scrollkeeper-data-files"></a>15.5.10.&nbsp;Packages
installing scrollkeeper data files</h3>
</div>
</div>
@@ -13485,12 +13478,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="x11-fonts" id=
- "x11-fonts"></a>15.5.10.&nbsp;Packages installing
+ <h3 class="title"><a name=
+ "x11-fonts"></a>15.5.11.&nbsp;Packages installing
X11 fonts</h3>
</div>
</div>
@@ -13526,12 +13519,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
them.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="gtk2-modules" id=
- "gtk2-modules"></a>15.5.11.&nbsp;Packages
+ <h3 class="title"><a name=
+ "gtk2-modules"></a>15.5.12.&nbsp;Packages
installing GTK2 modules</h3>
</div>
</div>
@@ -13600,12 +13593,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="sgml-xml-data" id=
- "sgml-xml-data"></a>15.5.12.&nbsp;Packages
+ <h3 class="title"><a name=
+ "sgml-xml-data"></a>15.5.13.&nbsp;Packages
installing SGML or XML data</h3>
</div>
</div>
@@ -13664,12 +13657,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="mime-database" id=
- "mime-database"></a>15.5.13.&nbsp;Packages
+ <h3 class="title"><a name=
+ "mime-database"></a>15.5.14.&nbsp;Packages
installing extensions to the MIME database</h3>
</div>
</div>
@@ -13731,12 +13724,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="intltool" id=
- "intltool"></a>15.5.14.&nbsp;Packages using
+ <h3 class="title"><a name=
+ "intltool"></a>15.5.15.&nbsp;Packages using
intltool</h3>
</div>
</div>
@@ -13756,12 +13749,12 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
appeared since it was released.</p>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="startup-scripts" id=
- "startup-scripts"></a>15.5.15.&nbsp;Packages
+ <h3 class="title"><a name=
+ "startup-scripts"></a>15.5.16.&nbsp;Packages
installing startup scripts</h3>
</div>
</div>
@@ -13779,14 +13772,77 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
installed, and it will automatically remove the scripts
when the package is deinstalled.</p>
</div>
+
+ <div class="sect2" lang="en">
+ <div class="titlepage">
+ <div>
+ <div>
+ <h3 class="title"><a name=
+ "tex-packages"></a>15.5.17.&nbsp;Packages
+ installing TeX modules</h3>
+ </div>
+ </div>
+ </div>
+
+ <p>If a package installs TeX packages into the texmf
+ tree, the <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">ls-R</code> database of the tree needs to be
+ updated.</p>
+
+ <div class="note" style=
+ "margin-left: 0.5in; margin-right: 0.5in;">
+ <h3 class="title">Note</h3>
+
+ <p>Except the main TeX packages such as teTeX-texmf,
+ packages should install files into <code class=
+ "varname">PKG_LOCALTEXMFPREFIX</code>, not
+ <code class="varname">PKG_TEXMFPREFIX</code>.</p>
+ </div>
+
+ <div class="orderedlist">
+ <ol type="1">
+ <li>
+ <p>Include <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">../../print/teTeX/module.mk</code>
+ instead of <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">../../mk/tex.buildlink3.mk</code>.
+ This takes care of rebuilding the <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">ls-R</code> database at installation
+ and deinstallation time.</p>
+ </li>
+
+ <li>
+ <p>If your package installs files into a texmf
+ tree other than the one at <code class=
+ "varname">PKG_LOCALTEXMFPREFIX</code>, set
+ <code class="varname">TEXMFDIRS</code> to the
+ list of all texmf trees that need database
+ update.</p>
+ </li>
+
+ <li>
+ <p>Make sure that none of <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">ls-R</code> databases are included in
+ <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional" class=
+ "filename">PLIST</code>, as they will be removed
+ only by the teTeX-bin package.</p>
+ </li>
+ </ol>
+ </div>
+ </div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -13806,11 +13862,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="debug" id=
+ <h2 class="title"><a name=
"debug"></a>Chapter&nbsp;16.&nbsp;Debugging</h2>
</div>
</div>
@@ -14022,11 +14078,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="chapter" lang="en" xml:lang="en">
+ <div class="chapter" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="submit" id=
+ <h2 class="title"><a name=
"submit"></a>Chapter&nbsp;17.&nbsp;Submitting and
Committing</h2>
</div>
@@ -14058,12 +14114,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -14128,12 +14183,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -14182,12 +14236,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">pkgsrc/doc/CHANGES</code>!</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -14232,12 +14285,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
consistent tag.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -14284,12 +14336,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
preferred above new and possibly untested features.</p>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -14378,11 +14429,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</div>
</div>
- <div class="appendix" lang="en" xml:lang="en">
+ <div class="appendix" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="examples" id=
+ <h2 class="title"><a name=
"examples"></a>Appendix&nbsp;A.&nbsp;A simple example
package: bison</h2>
</div>
@@ -14427,22 +14478,21 @@ 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" xml:lang="en">
+ <div class="sect1" 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" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="example-Makefile" id=
+ <h3 class="title"><a name=
"example-Makefile"></a>A.1.1.&nbsp;Makefile</h3>
</div>
</div>
@@ -14466,11 +14516,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="example-descr" id=
+ <h3 class="title"><a name=
"example-descr"></a>A.1.2.&nbsp;DESCR</h3>
</div>
</div>
@@ -14483,11 +14533,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" lang="en">
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a name="example-plist" id=
+ <h3 class="title"><a name=
"example-plist"></a>A.1.3.&nbsp;PLIST</h3>
</div>
</div>
@@ -14501,12 +14551,11 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
</pre>
</div>
- <div class="sect2" lang="en" xml:lang="en">
+ <div class="sect2" 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>
@@ -14537,12 +14586,11 @@ looks fine.
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -14570,8 +14618,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 8, <i>Package components - files, directories and
- contents</i></a>) then continue with fetching the
+ Chapter&nbsp;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=
@@ -14696,11 +14744,11 @@ Creating gzip'd tar ball in '/u/pkgsrc/lang/bison/bison-1.25.tgz'
</div>
</div>
- <div class="appendix" lang="en" xml:lang="en">
+ <div class="appendix" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="logs" id=
+ <h2 class="title"><a name=
"logs"></a>Appendix&nbsp;B.&nbsp;Build logs</h2>
</div>
</div>
@@ -14718,12 +14766,11 @@ Creating gzip'd tar ball in '/u/pkgsrc/lang/bison/bison-1.25.tgz'
</dl>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -14822,12 +14869,11 @@ cp figlet.6 /usr/pkg/man/man6
</pre>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
@@ -14846,11 +14892,11 @@ Registering depends:.
</div>
</div>
- <div class="appendix" lang="en" xml:lang="en">
+ <div class="appendix" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="ftp-layout" id=
+ <h2 class="title"><a name=
"ftp-layout"></a>Appendix&nbsp;C.&nbsp;Layout of the
FTP server's package archive</h2>
</div>
@@ -14925,8 +14971,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
- 6.3, &#8220;Doing a bulk build of all
+ "6.3.&nbsp;Doing a bulk build of all packages">Section&nbsp;6.3,
+ &#8220;Doing a bulk build of all
packages&#8221;</a></p>
</li>
@@ -14949,11 +14995,11 @@ Registering depends:.
</div>
</div>
- <div class="appendix" lang="en" xml:lang="en">
+ <div class="appendix" lang="en">
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a name="editing" id=
+ <h2 class="title"><a name=
"editing"></a>Appendix&nbsp;D.&nbsp;Editing guidelines
for the pkgsrc guide</h2>
</div>
@@ -14975,12 +15021,12 @@ Registering depends:.
<p>This section contains information on editing the pkgsrc
guide itself.</p>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a name=
- "targets" id="targets"></a>D.1.&nbsp;Targets</h2>
+ "targets"></a>D.1.&nbsp;Targets</h2>
</div>
</div>
</div>
@@ -15032,12 +15078,11 @@ Registering depends:.
</div>
</div>
- <div class="sect1" lang="en" xml:lang="en">
+ <div class="sect1" 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>
diff --git a/doc/pkgsrc.txt b/doc/pkgsrc.txt
index e4db8ad15fb..d13df6be3af 100644
--- a/doc/pkgsrc.txt
+++ b/doc/pkgsrc.txt
@@ -255,14 +255,16 @@ II. The pkgsrc developer's guide
15.5.5. Packages with hardcoded paths to other interpreters
15.5.6. Packages installing perl modules
15.5.7. Packages installing info files
- 15.5.8. Packages installing GConf2 data files
- 15.5.9. Packages installing scrollkeeper data files
- 15.5.10. Packages installing X11 fonts
- 15.5.11. Packages installing GTK2 modules
- 15.5.12. Packages installing SGML or XML data
- 15.5.13. Packages installing extensions to the MIME database
- 15.5.14. Packages using intltool
- 15.5.15. Packages installing startup scripts
+ 15.5.8. Packages installing man pages
+ 15.5.9. Packages installing GConf2 data files
+ 15.5.10. Packages installing scrollkeeper data files
+ 15.5.11. Packages installing X11 fonts
+ 15.5.12. Packages installing GTK2 modules
+ 15.5.13. Packages installing SGML or XML data
+ 15.5.14. Packages installing extensions to the MIME database
+ 15.5.15. Packages using intltool
+ 15.5.16. Packages installing startup scripts
+ 15.5.17. Packages installing TeX modules
15.6. Feedback to the author
@@ -816,18 +818,19 @@ Though Interix suffices as a familiar and flexible substitute for a full
Unix-like platform, it has some drawbacks that should be noted for those
desiring to make the most of Interix.
- * X-Windows:
+ * X11:
Interix comes with the standard set of X11R6 client libraries, and can run
- X-Windows based applications, but it does not come with an X server. Some
- options are StarNet X-Win32, Hummingbird Exceed, and the free X-Windows
+ X11 based applications, but it does not come with an X server. Some options
+ are StarNet X-Win32, Hummingbird Exceed (available in a trimmed version for
+ Interix from Interop Systems as the Interop X Server), and the free X11
server included with Cygwin.
Also, StarNet Communications has graciously provided a free version of
their X-Win32 product that accepts connections only from localhost: X-Win32
LX, recommended by the maintainer of Interix pkgsrc support.
- * X-Windows acceleration:
+ * X11 acceleration:
Because Interix runs in a completely different NT subsystem from Win32
applications, it does not currently support various X11 protocol extensions
@@ -2163,7 +2166,7 @@ Table of Contents
11.2. Writing buildlink3.mk files
11.2.1. Anatomy of a buildlink3.mk file
- 11.2.2. Updating BUILDLINK_DEPENDS. pkg in buildlink3.mk files
+ 11.2.2. Updating BUILDLINK_DEPENDS.pkg in buildlink3.mk files
11.3. Writing builtin.mk files
@@ -2260,14 +2263,16 @@ Table of Contents
15.5.5. Packages with hardcoded paths to other interpreters
15.5.6. Packages installing perl modules
15.5.7. Packages installing info files
- 15.5.8. Packages installing GConf2 data files
- 15.5.9. Packages installing scrollkeeper data files
- 15.5.10. Packages installing X11 fonts
- 15.5.11. Packages installing GTK2 modules
- 15.5.12. Packages installing SGML or XML data
- 15.5.13. Packages installing extensions to the MIME database
- 15.5.14. Packages using intltool
- 15.5.15. Packages installing startup scripts
+ 15.5.8. Packages installing man pages
+ 15.5.9. Packages installing GConf2 data files
+ 15.5.10. Packages installing scrollkeeper data files
+ 15.5.11. Packages installing X11 fonts
+ 15.5.12. Packages installing GTK2 modules
+ 15.5.13. Packages installing SGML or XML data
+ 15.5.14. Packages installing extensions to the MIME database
+ 15.5.15. Packages using intltool
+ 15.5.16. Packages installing startup scripts
+ 15.5.17. Packages installing TeX modules
15.6. Feedback to the author
@@ -3165,8 +3170,8 @@ dependency on pkg is added. Several important variables are set in the section:
is selected by setting BUILDLINK_DEPMETHOD.pkg to "build". By default, the
full dependency is used.
- * BUILDLINK_INCDIRS.pkg and BUILDLINK_LIBDIRS. pkg (not shown above) are
- lists of subdirectories of ${BUILDLINK_PREFIX.pkg} to add to the header and
+ * BUILDLINK_INCDIRS.pkg and BUILDLINK_LIBDIRS.pkg (not shown above) are lists
+ of subdirectories of ${BUILDLINK_PREFIX.pkg} to add to the header and
library search paths. These default to "include" and "lib" respectively.
* BUILDLINK_CPPFLAGS.pkg (not shown above) is the list of preprocessor flags
@@ -3205,7 +3210,7 @@ dependencies. Including these buildlink3.mk files means that the headers and
libraries for these dependencies are also symlinked into ${BUILDLINK_DIR}
whenever the pkg buildlink3.mk file is included.
-11.2.2. Updating BUILDLINK_DEPENDS. pkg in buildlink3.mk files
+11.2.2. Updating BUILDLINK_DEPENDS.pkg in buildlink3.mk files
There are two situations that require increasing the dependency listed in
BUILDLINK_DEPENDS.pkg after a package update:
@@ -3224,9 +3229,9 @@ settle for an older one which will not contain the necessary shared libraries.
Please take careful consideration before adjusting BUILDLINK_DEPENDS.pkg as we
don't want to cause unneeded package deletions and rebuilds. In many cases, new
-versions of packages work just fine with older dependencies. See Section
-15.1.4, "Handling dependencies" for more information about dependencies on
-other packages, including the BUILDLINK_RECOMMENDED and RECOMMENDED
+versions of packages work just fine with older dependencies. See
+Section 15.1.4, "Handling dependencies" for more information about dependencies
+on other packages, including the BUILDLINK_RECOMMENDED and RECOMMENDED
definitions.
11.3. Writing builtin.mk files
@@ -3540,9 +3545,9 @@ original copies available.
Once the required configuration files are in place (i.e., under the examples
hierarchy), the pkginstall framework can use them as master copies during the
package installation to update what is in ${PKG_SYSCONFDIR}. To achieve this,
-the variables CONF_FILES and CONF_FILES_PERMS are used. Check out Section
-12.1.2, "File manipulation" for information about their syntax and their
-purpose. Here is an example, taken from the mail/mutt package:
+the variables CONF_FILES and CONF_FILES_PERMS are used. Check out
+Section 12.1.2, "File manipulation" for information about their syntax and
+their purpose. Here is an example, taken from the mail/mutt package:
EGDIR= ${PREFIX}/share/doc/mutt/samples
CONF_FILES= ${EGDIR}/Muttrc ${PKG_SYSCONFDIR}/Muttrc
@@ -3717,7 +3722,7 @@ The first section contains the information about which build options are
supported by the package, and any default options settings if needed.
1. PKG_OPTIONS_VAR is the name of the make(1) variable that the user can set
- to override the default options. It should be set to "PKG_OPTIONS.pkgbase".
+ to override the default options. It should be set to PKG_OPTIONS.pkgbase.
2. PKG_SUPPORTED_OPTIONS is a list of build options supported by the package.
@@ -3739,14 +3744,14 @@ supported by the package, and any default options settings if needed.
6. PKG_SUGGESTED_OPTIONS is a list of build options which are enabled by
default.
- 7. PKG_OPTIONS_LEGACY_VARS is a list of "USE_VARIABLE: option" pairs that map
+ 7. PKG_OPTIONS_LEGACY_VARS is a list of "USE_VARIABLE:option" pairs that map
legacy /etc/mk.conf variables to their option counterparts. Pairs should be
added with "+=" to keep the listing of global legacy variables. A warning
will be issued if the user uses a legacy variable.
- 8. PKG_OPTIONS_LEGACY_OPTS is a list of "old-option: new-option" pairs that
- map options that have been renamed to their new counterparts. Pairs should
- be added with "+=" to keep the listing of global legacy options. A warning
+ 8. PKG_OPTIONS_LEGACY_OPTS is a list of "old-option:new-option" pairs that map
+ options that have been renamed to their new counterparts. Pairs should be
+ added with "+=" to keep the listing of global legacy options. A warning
will be issued if the user uses a legacy option.
9. PKG_LEGACY_OPTIONS is a list of options implied by deprecated variables
@@ -3936,8 +3941,9 @@ PKGPATH (read-only)
WRKDIR (read-only)
This is an absolute pathname pointing to the directory where all work takes
- place. This directory typically contains temporary directories used by the
- various pkgsrc frameworks, like buildlink or the wrappers.
+ place. The distfiles are extraced to this directory. It also contains
+ temporary directories and log files used by the various pkgsrc frameworks,
+ like buildlink or the wrappers.
WRKSRC (read-write)
@@ -4364,14 +4370,16 @@ Table of Contents
15.5.5. Packages with hardcoded paths to other interpreters
15.5.6. Packages installing perl modules
15.5.7. Packages installing info files
- 15.5.8. Packages installing GConf2 data files
- 15.5.9. Packages installing scrollkeeper data files
- 15.5.10. Packages installing X11 fonts
- 15.5.11. Packages installing GTK2 modules
- 15.5.12. Packages installing SGML or XML data
- 15.5.13. Packages installing extensions to the MIME database
- 15.5.14. Packages using intltool
- 15.5.15. Packages installing startup scripts
+ 15.5.8. Packages installing man pages
+ 15.5.9. Packages installing GConf2 data files
+ 15.5.10. Packages installing scrollkeeper data files
+ 15.5.11. Packages installing X11 fonts
+ 15.5.12. Packages installing GTK2 modules
+ 15.5.13. Packages installing SGML or XML data
+ 15.5.14. Packages installing extensions to the MIME database
+ 15.5.15. Packages using intltool
+ 15.5.16. Packages installing startup scripts
+ 15.5.17. Packages installing TeX modules
15.6. Feedback to the author
@@ -4920,6 +4928,7 @@ If this distinction is not fine enough, you can also use the following defines.
FreeBSD __FreeBSD__
DragonFly __DragonFly__
+ Interix __INTERIX
Linux linux, __linux, __linux__
NetBSD __NetBSD__
OpenBSD __OpenBSD__
@@ -5116,7 +5125,33 @@ message. The script overriding makeinfo logs a message and according to the
value of USE_MAKEINFO and TEXINFO_REQD either run the appropriate makeinfo
command or exit on error.
-15.5.8. Packages installing GConf2 data files
+15.5.8. Packages installing man pages
+
+Many packages install manual pages. The man pages are installed under ${PREFIX}
+/${PKGMANDIR} which is /usr/pkg/man by default. PKGMANDIR defaults to "man".
+For example, you can set PKGMANDIR to "share/man" to have man pages install
+under /usr/pkg/share/man/ by default.
+
+Note
+
+The support for a custom PKGMANDIR is not complete.
+
+The PLIST files can just use man/ as the top level directory for the man page
+file entries and the pkgsrc framework will convert as needed.
+
+Packages that are configured with GNU_CONFIGURE set as "yes", by default will
+use the ./configure --mandir switch to set where the man pages should be
+installed. The path is GNU_CONFIGURE_MANDIR which defaults to ${PREFIX}/$
+{PKGMANDIR}.
+
+Packages that use GNU_CONFIGURE but do not use --mandir, can set
+CONFIGURE_HAS_MANDIR to "no". Or if the ./configure script uses a non-standard
+use of --mandir, you can set GNU_CONFIGURE_MANDIR as needed.
+
+See Section 10.5, "Man page compression" for information on installation of
+compressed manual pages.
+
+15.5.9. Packages installing GConf2 data files
If a package installs .schemas or .entries files, used by GConf2, you need to
take some extra steps to make sure they get registered in the database:
@@ -5143,7 +5178,7 @@ take some extra steps to make sure they get registered in the database:
.entries files installed by the package, if any. Names must not contain any
directories in them.
-15.5.9. Packages installing scrollkeeper data files
+15.5.10. Packages installing scrollkeeper data files
If a package installs .omf files, used by scrollkeeper, you need to take some
extra steps to make sure they get registered in the database:
@@ -5159,7 +5194,7 @@ extra steps to make sure they get registered in the database:
3. Remove the share/omf directory from the PLIST. It will be handled by
scrollkeeper.
-15.5.10. Packages installing X11 fonts
+15.5.11. Packages installing X11 fonts
If a package installs font files, you will need to rebuild the fonts database
in the directory where they get installed at installation and deinstallation
@@ -5175,7 +5210,7 @@ Note that you should not create new directories for fonts; instead use the
standard ones to avoid that the user needs to manually configure his X server
to find them.
-15.5.11. Packages installing GTK2 modules
+15.5.12. Packages installing GTK2 modules
If a package installs GTK2 immodules or loaders, you need to take some extra
steps to get them registered in the GTK2 database properly:
@@ -5198,7 +5233,7 @@ steps to get them registered in the GTK2 database properly:
5. Check the PLIST and remove any entries under the libdata/gtk-2.0 directory,
as they will be handled automatically.
-15.5.12. Packages installing SGML or XML data
+15.5.13. Packages installing SGML or XML data
If a package installs SGML or XML data files that need to be registered in
system-wide catalogs (like DTDs, sub-catalogs, etc.), you need to take some
@@ -5224,7 +5259,7 @@ extra steps:
(specifically, arguments recognized by the 'add' action). Note that you
will normally not use this variable.
-15.5.13. Packages installing extensions to the MIME database
+15.5.14. Packages installing extensions to the MIME database
If a package provides extensions to the MIME database by installing .xml files
inside ${PREFIX}/share/mime/packages, you need to take some extra steps to
@@ -5245,7 +5280,7 @@ ensure that the database is kept consistent with respect to these new files:
3. Remove any share/mime/* directories from the PLIST. They will be handled by
the shared-mime-info package.
-15.5.14. Packages using intltool
+15.5.15. Packages using intltool
If a package uses intltool during its build, include the ../../textproc/
intltool/buildlink3.mk file, which forces it to use the intltool package
@@ -5255,7 +5290,7 @@ This tracks intltool's build-time dependencies and uses the latest available
version; this way, the package benefits of any bug fixes that may have appeared
since it was released.
-15.5.15. Packages installing startup scripts
+15.5.16. Packages installing startup scripts
If a package contains a rc.d script, it won't be copied into the startup
directory by default, but you can enable it, by adding the option
@@ -5263,6 +5298,27 @@ PKG_RCD_SCRIPTS=YES in /etc/mk.conf. This option will copy the scripts into /
etc/rc.d when a package is installed, and it will automatically remove the
scripts when the package is deinstalled.
+15.5.17. Packages installing TeX modules
+
+If a package installs TeX packages into the texmf tree, the ls-R database of
+the tree needs to be updated.
+
+Note
+
+Except the main TeX packages such as teTeX-texmf, packages should install files
+into PKG_LOCALTEXMFPREFIX, not PKG_TEXMFPREFIX.
+
+ 1. Include ../../print/teTeX/module.mk instead of ../../mk/tex.buildlink3.mk.
+ This takes care of rebuilding the ls-R database at installation and
+ deinstallation time.
+
+ 2. If your package installs files into a texmf tree other than the one at
+ PKG_LOCALTEXMFPREFIX, set TEXMFDIRS to the list of all texmf trees that
+ need database update.
+
+ 3. Make sure that none of ls-R databases are included in PLIST, as they will
+ be removed only by the teTeX-bin package.
+
15.6. Feedback to the author
If you have found any bugs in the package you make available, if you had to do