diff options
Diffstat (limited to 'doc/pkgsrc.html')
| -rw-r--r-- | doc/pkgsrc.html | 175 |
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>“<span class= - "quote">download-vulnerability-list</span>”, + <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>“<span class= - "quote">audit-packages</span>”, 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 “<span class= "quote">-dirs</span>” 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> |