summaryrefslogtreecommitdiff
path: root/doc/pkgsrc.html
diff options
context:
space:
mode:
authorwiz <wiz@pkgsrc.org>2005-06-01 21:03:16 +0000
committerwiz <wiz@pkgsrc.org>2005-06-01 21:03:16 +0000
commite0a97944b01cbf5943172d8162081e7c12189a4c (patch)
treee139c8bebda6c79ee8dda8351879d82752ce6274 /doc/pkgsrc.html
parent803c8a2bb1a4a14b324756a07a7eed24e4cbf8bc (diff)
downloadpkgsrc-e0a97944b01cbf5943172d8162081e7c12189a4c.tar.gz
regen (USE_X11 -> x11.bl3.mk, jmmv whitespace changes).
Diffstat (limited to 'doc/pkgsrc.html')
-rw-r--r--doc/pkgsrc.html175
1 files changed, 91 insertions, 84 deletions
diff --git a/doc/pkgsrc.html b/doc/pkgsrc.html
index a906e70ea8a..9e38278048a 100644
--- a/doc/pkgsrc.html
+++ b/doc/pkgsrc.html
@@ -4042,31 +4042,31 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<li>
<p><a href=
"http://www.NetBSD.org/MailingLists/index.html#pkgsrc-bugs"
- target="_top">pkgsrc-bugs</a> -- a list where
- problem reports related to pkgsrc are sent and
- discussed</p>
+ target="_top">pkgsrc-bugs</a>: A list where problem
+ reports related to pkgsrc are sent and
+ discussed.</p>
</li>
<li>
<p><a href=
"http://www.NetBSD.org/MailingLists/index.html#pkgsrc-bulk"
- target="_top">pkgsrc-bulk</a> -- a list where the
+ target="_top">pkgsrc-bulk</a>: A list where the
results of pkgsrc bulk builds are sent and
- discussed</p>
+ discussed.</p>
</li>
<li>
<p><a href=
"http://www.NetBSD.org/MailingLists/index.html#pkgsrc-changes"
- target="_top">pkgsrc-changes</a> -- a list where
- all commit messages to pkgsrc are sent</p>
+ target="_top">pkgsrc-changes</a>: A list where all
+ commit messages to pkgsrc are sent.</p>
</li>
<li>
<p><a href=
"http://www.NetBSD.org/MailingLists/index.html#tech-pkg"
- target="_top">tech-pkg</a> -- a general discussion
- list for all things related to pkgsrc</p>
+ target="_top">tech-pkg</a>: A general discussion
+ list for all things related to pkgsrc.</p>
</li>
</ul>
</div>
@@ -4127,8 +4127,8 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/x11-links/README.html"
- class="pkgname">pkgtools/x11-links</a>: symlinks
- for use by buildlink</p>
+ class="pkgname">pkgtools/x11-links</a>: Symlinks
+ for use by buildlink.</p>
</li>
</ul>
</div>
@@ -4142,8 +4142,8 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/digest/README.html"
- class="pkgname">pkgtools/digest</a>: calculates
- various kinds of checksums (including SHA1)</p>
+ class="pkgname">pkgtools/digest</a>: Calculates
+ various kinds of checksums (including SHA1).</p>
</li>
<li>
@@ -4151,15 +4151,15 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/libnbcompat/README.html"
class="pkgname">pkgtools/libnbcompat</a>:
- compatibility library for pkgsrc tools</p>
+ Compatibility library for pkgsrc tools.</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/mtree/README.html"
- class="pkgname">pkgtools/mtree</a>: installed on
- non-BSD systems due to lack of native mtree</p>
+ class="pkgname">pkgtools/mtree</a>: Installed on
+ non-BSD systems due to lack of native mtree.</p>
</li>
<li>
@@ -4167,9 +4167,10 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkg_install/README.html"
class="pkgname">pkgtools/pkg_install</a>:
- up-to-date replacement for /usr/sbin/pkg_install,
- or for use on operating systems where pkg_install
- is not present</p>
+ Up-to-date replacement for <code class=
+ "filename">/usr/sbin/pkg_install</code>, or for use
+ on operating systems where pkg_install is not
+ present.</p>
</li>
</ul>
</div>
@@ -4183,17 +4184,18 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkg_tarup/README.html"
- class="pkgname">pkgtools/pkg_tarup</a>: create a
+ class="pkgname">pkgtools/pkg_tarup</a>: Create a
binary package from an already-installed package.
- used by <span><strong class="command">make
- replace</strong></span> to save the old package</p>
+ Used by <span><strong class="command">make
+ replace</strong></span> to save the old
+ package.</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/dfdisk/README.html"
- class="pkgname">pkgtools/dfdisk</a>: adds extra
+ class="pkgname">pkgtools/dfdisk</a>: Adds extra
functionality to pkgsrc, allowing it to fetch
distfiles from multiple locations. It currently
supports the following methods: multiple CD-ROMs
@@ -4204,16 +4206,16 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/xpkgwedge/README.html"
- class="pkgname">pkgtools/xpkgwedge</a>: put X11
- packages someplace else (enabled by default)</p>
+ class="pkgname">pkgtools/xpkgwedge</a>: Put X11
+ packages someplace else (enabled by default).</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/devel/cpuflags/README.html"
- class="pkgname">devel/cpuflags</a>: will determine
- the best compiler flags to optimise code for your
+ class="pkgname">devel/cpuflags</a>: Determine the
+ best compiler flags to optimise code for your
current CPU and compiler.</p>
</li>
</ul>
@@ -4228,37 +4230,37 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkg_chk/README.html"
- class="pkgname">pkgtools/pkg_chk</a>: reports on
+ class="pkgname">pkgtools/pkg_chk</a>: Reports on
packages whose installed versions do not match the
- latest pkgsrc entries</p>
+ latest pkgsrc entries.</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkgdep/README.html"
- class="pkgname">pkgtools/pkgdep</a>: makes
+ class="pkgname">pkgtools/pkgdep</a>: Makes
dependency graphs of packages, to aid in choosing a
- strategy for updating</p>
+ strategy for updating.</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkgdepgraph/README.html"
- class="pkgname">pkgtools/pkgdepgraph</a>: makes
+ class="pkgname">pkgtools/pkgdepgraph</a>: Makes
graphs from the output of <a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkgdep/README.html"
class="pkgname">pkgtools/pkgdep</a> (uses
- graphviz)</p>
+ graphviz).</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkglint/README.html"
- class="pkgname">pkgtools/pkglint</a>: the
+ class="pkgname">pkgtools/pkglint</a>: The
pkglint(1) program checks a pkgsrc entry for
errors, lintpkgsrc(1) does various checks on the
complete pkgsrc system.</p>
@@ -4268,8 +4270,8 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkgsurvey/README.html"
- class="pkgname">pkgtools/pkgsurvey</a>: report what
- packages you have installed</p>
+ class="pkgname">pkgtools/pkgsurvey</a>: Report what
+ packages you have installed.</p>
</li>
</ul>
</div>
@@ -4283,9 +4285,9 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkgdiff/README.html"
- class="pkgname">pkgtools/pkgdiff</a>: automate
+ class="pkgname">pkgtools/pkgdiff</a>: Automate
making and maintaining patches for a package
- (includes pkgdiff, pkgvi, mkpatches, ...)</p>
+ (includes pkgdiff, pkgvi, mkpatches, etc.).</p>
</li>
<li>
@@ -4295,16 +4297,16 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
class="pkgname">pkgtools/rpm2pkg</a>, <a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/url2pkg/README.html"
- class="pkgname">pkgtools/url2pkg</a>: aids in
- converting to pkgsrc</p>
+ class="pkgname">pkgtools/url2pkg</a>: Aids in
+ converting to pkgsrc.</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/gensolpkg/README.html"
- class="pkgname">pkgtools/gensolpkg</a>: convert
- pkgsrc to a Solaris package</p>
+ class="pkgname">pkgtools/gensolpkg</a>: Convert
+ pkgsrc to a Solaris package.</p>
</li>
</ul>
</div>
@@ -4318,25 +4320,25 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkgconflict/README.html"
- class="pkgname">pkgtools/pkgconflict</a>: find
+ class="pkgname">pkgtools/pkgconflict</a>: Find
packages that conflict but aren't marked as
- such</p>
+ such.</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/pkg_comp/README.html"
- class="pkgname">pkgtools/pkg_comp</a>: build
- packages in a chrooted area</p>
+ class="pkgname">pkgtools/pkg_comp</a>: Build
+ packages in a chrooted area.</p>
</li>
<li>
<p><a xmlns=
"http://www.w3.org/TR/xhtml1/transitional" href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/libkver/README.html"
- class="pkgname">pkgtools/libkver</a>: spoof kernel
- version for chrooted cross builds</p>
+ class="pkgname">pkgtools/libkver</a>: Spoof kernel
+ version for chrooted cross builds.</p>
</li>
</ul>
</div>
@@ -4418,11 +4420,10 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
"filename">wget</code> to resume downloads, you'll have
to use something like:</p>
<pre class="programlisting">
- FETCH_CMD=wget
- FETCH_BEFORE_ARGS=--passive-ftp
- FETCH_RESUME_ARGS=-c
- FETCH_OUTPUT_ARGS=-O
-
+FETCH_CMD=wget
+FETCH_BEFORE_ARGS=--passive-ftp
+FETCH_RESUME_ARGS=-c
+FETCH_OUTPUT_ARGS=-O
</pre>
</div>
@@ -4445,8 +4446,7 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
add the following line into <code class=
"filename">/etc/mk.conf</code>:</p>
<pre class="programlisting">
- X11_TYPE=XFree86
-
+X11_TYPE=XFree86
</pre>
</div>
@@ -4469,8 +4469,7 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
the following line into <code class=
"filename">/etc/mk.conf</code>:</p>
<pre class="programlisting">
- X11_TYPE=xorg
-
+X11_TYPE=xorg
</pre>
</div>
@@ -4495,7 +4494,7 @@ nbftp% <strong class="userinput"><code>chmod 755 .</code></strong>
firewalls, and it uses port 80 as the proxy port number.
So the proxy environment variables are:</p>
<pre class="programlisting">
- ftp_proxy=ftp://orpheus.amdahl.com:80/
+ftp_proxy=ftp://orpheus.amdahl.com:80/
http_proxy=http://orpheus.amdahl.com:80/
</pre>
</div>
@@ -4516,10 +4515,19 @@ http_proxy=http://orpheus.amdahl.com:80/
distfiles. From <code class="filename">bsd.pkg.mk</code>,
<code class="varname">FETCH_CMD</code> is assigned the
first available command from the following list:</p>
- <pre class="programlisting">
-${LOCALBASE}/bin/ftp
-/usr/bin/ftp
-</pre>
+
+ <div class="itemizedlist">
+ <ul type="disc">
+ <li>
+ <p><code class=
+ "filename">${LOCALBASE}/bin/ftp</code></p>
+ </li>
+
+ <li>
+ <p><code class="filename">/usr/bin/ftp</code></p>
+ </li>
+ </ul>
+ </div>
<p>On a default NetBSD installation, this will be
<code class="filename">/usr/bin/ftp</code>, which
@@ -4699,10 +4707,9 @@ ${LOCALBASE}/bin/ftp
following into your <code class=
"filename">/etc/mk.conf</code>:</p>
<pre class="programlisting">
- .if exists(${LOCALBASE}/bin/sudo)
- SU_CMD=${LOCALBASE}/bin/sudo /bin/sh -c
- .endif
-
+.if exists(${LOCALBASE}/bin/sudo)
+SU_CMD=${LOCALBASE}/bin/sudo /bin/sh -c
+.endif
</pre>
</div>
@@ -4825,9 +4832,10 @@ ${LOCALBASE}/bin/ftp
variable <code class="varname">PKG_CONFIG</code> prior to
package installation.</p>
- <p>Here is an example, taken from mail/mutt/Makefile:</p>
+ <p>Here is an example, taken from <code class=
+ "filename">mail/mutt/Makefile</code>:</p>
<pre class="programlisting">
- EGDIR= ${PREFIX}/share/doc/mutt/samples
+EGDIR= ${PREFIX}/share/doc/mutt/samples
CONF_FILES= ${EGDIR}/Muttrc ${PKG_SYSCONFDIR}/Muttrc
</pre>
@@ -4870,8 +4878,8 @@ CONF_FILES= ${EGDIR}/Muttrc ${PKG_SYSCONFDIR}/Muttrc
<div class="orderedlist">
<ol type="1">
<li>
- <p>&#8220;<span class=
- "quote">download-vulnerability-list</span>&#8221;,
+ <p><span><strong class=
+ "command">download-vulnerability-list</strong></span>,
an easy way to download a list of the security
vulnerabilities information. This list is kept up
to date by the NetBSD security officer and the
@@ -4885,9 +4893,9 @@ CONF_FILES= ${EGDIR}/Muttrc ${PKG_SYSCONFDIR}/Muttrc
</li>
<li>
- <p>&#8220;<span class=
- "quote">audit-packages</span>&#8221;, an easy way
- to audit the current machine, checking each
+ <p><span><strong class=
+ "command">audit-packages</strong></span>, an easy
+ way to audit the current machine, checking each
vulnerability which is known. If a vulnerable
package is installed, it will be shown by output to
stdout, including a description of the type of
@@ -6942,7 +6950,7 @@ PLIST_SUBST+= SOMEVAR="somevalue"
list of package names (without the &#8220;<span class=
"quote">-dirs</span>&#8221; part) together with the
required version number (always pick the latest one when
- writting new packages).</p>
+ writing new packages).</p>
<p>For example, if a package installs files under
<code class="filename">share/applications</code>, it
@@ -8090,10 +8098,11 @@ CONFIGURE_ARGS+= --enable-sasl=${BUILDLINK_PREFIX.sasl}
<p>Usually, X11 packages should be installed under
<code class="varname">LOCALBASE</code> whenever
- possible. Note that you will need to set
- <code class="varname">USE_X11</code> in them to
- request the presence of X11 and to get the right
- compilation flags.</p>
+ possible. Note that you will need to include
+ <code class=
+ "filename">../../mk/x11.buildlink3.mk</code> in
+ them to request the presence of X11 and to get the
+ right compilation flags.</p>
<p>Even though, there are some packages that cannot
be installed under <code class=
@@ -8105,14 +8114,12 @@ CONFIGURE_ARGS+= --enable-sasl=${BUILDLINK_PREFIX.sasl}
<code class="varname">USE_IMAKE</code> in your
package.</p>
- <p>Some notes: <code class="varname">USE_X11</code>
- and <code class="varname">USE_X11BASE</code> are
- mutually exclusive. If you need to find includes or
+ <p>Some notes: If you need to find includes or
libraries installed by a pkg that has <code class=
"varname">USE_IMAKE</code> or <code class=
"varname">USE_X11BASE</code> in its pkg
<code class="filename">Makefile</code>, you need to
- use <span class="emphasis"><em>both</em></span>
+ look in <span class="emphasis"><em>both</em></span>
<code class="filename">${X11BASE}</code> and
<code class="filename">${LOCALBASE}</code>. To
force installation of all X11 packages in
@@ -8120,8 +8127,8 @@ CONFIGURE_ARGS+= --enable-sasl=${BUILDLINK_PREFIX.sasl}
<a xmlns="http://www.w3.org/TR/xhtml1/transitional"
href=
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/pkgtools/xpkgwedge/README.html"
- class="pkgname">pkgtools/xpkgwedge</a> is enabled
- by default.</p>
+ class="pkgname">pkgtools/xpkgwedge</a> package is
+ enabled by default.</p>
</li>
<li>