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