pkgsrc-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[pkgsrc/trunk]: pkgsrc/doc Regenerate.
details: https://anonhg.NetBSD.org/pkgsrc/rev/e290a9068035
branches: trunk
changeset: 499336:e290a9068035
user: reed <reed%pkgsrc.org@localhost>
date: Tue Sep 20 06:37:21 2005 +0000
description:
Regenerate.
Various changes to pkgsrc guide since this was last generated
in early August.
diffstat:
doc/pkgsrc.html | 394 +++++++++++++++++++++++++++++--------------------------
doc/pkgsrc.txt | 328 ++++++++++++++++++++++++----------------------
2 files changed, 384 insertions(+), 338 deletions(-)
diffs (truncated from 2270 to 300 lines):
diff -r fb42770c0bf6 -r e290a9068035 doc/pkgsrc.html
--- a/doc/pkgsrc.html Tue Sep 20 06:25:11 2005 +0000
+++ b/doc/pkgsrc.html Tue Sep 20 06:37:21 2005 +0000
@@ -139,7 +139,7 @@
pkgsrc</a></span></dt>
<dt><span class="sect1"><a href=
- "#platform-specific-notes">3.2. Platform specific
+ "#platform-specific-notes">3.2. Platform-specific
notes</a></span></dt>
<dd>
@@ -285,7 +285,7 @@
<dt><span class="sect2"><a href=
"#setting-up-a-sandbox">6.3.6. Setting up a
- sandbox for chroot'ed builds</a></span></dt>
+ sandbox for chrooted builds</a></span></dt>
<dt><span class="sect2"><a href=
"#building-a-partial-set">6.3.7. Building a
@@ -503,8 +503,8 @@
Variable substitution in PLIST</a></span></dt>
<dt><span class="sect1"><a href=
- "#manpage-compression">10.5.
- Manpage-compression</a></span></dt>
+ "#manpage-compression">10.5. Man
+ page-compression</a></span></dt>
<dt><span class="sect1"><a href=
"#using-PLIST_SRC">10.6. Changing PLIST source with
@@ -512,7 +512,7 @@
"varname">PLIST_SRC</code></a></span></dt>
<dt><span class="sect1"><a href=
- "#platform-specific-plist">10.7. Platform specific
+ "#platform-specific-plist">10.7. Platform-specific
and differing PLISTs</a></span></dt>
<dt><span class="sect1"><a href=
@@ -611,7 +611,7 @@
<dt><span class="sect2"><a href=
"#conf-files-configure">12.2.2. Telling the
- software were configuration files
+ software where configuration files
are</a></span></dt>
<dt><span class="sect2"><a href=
@@ -1011,8 +1011,8 @@
</div>
</div>
- <p>There is a lot of software freely available for Unix
- based systems, which usually runs on NetBSD and other
+ <p>There is a lot of software freely available for
+ Unix-based systems, which usually runs on NetBSD and other
Unix-flavoured systems, too, sometimes with some
modifications. The NetBSD Packages Collection (pkgsrc)
incorporates any such changes necessary to make that
@@ -1277,7 +1277,7 @@
<dd>
<p>The piece of software to be installed which will
- be constructed from all the files in the Distfile by
+ be constructed from all the files in the distfile by
the actions defined in the corresponding package.</p>
</dd>
</dl>
@@ -1345,7 +1345,7 @@
pkgsrc</a></span></dt>
<dt><span class="sect1"><a href=
- "#platform-specific-notes">3.2. Platform specific
+ "#platform-specific-notes">3.2. Platform-specific
notes</a></span></dt>
<dd>
@@ -1490,7 +1490,7 @@
<dt><span class="sect2"><a href=
"#setting-up-a-sandbox">6.3.6. Setting up a
- sandbox for chroot'ed builds</a></span></dt>
+ sandbox for chrooted builds</a></span></dt>
<dt><span class="sect2"><a href=
"#building-a-partial-set">6.3.7. Building a
@@ -1732,7 +1732,7 @@
pkgsrc</a></span></dt>
<dt><span class="sect1"><a href=
- "#platform-specific-notes">3.2. Platform specific
+ "#platform-specific-notes">3.2. Platform-specific
notes</a></span></dt>
<dd>
@@ -1854,6 +1854,19 @@
up-to-date list of these can be found on <a href=
"http://www.pkgsrc.org/"; target=
"_top">www.pkgsrc.org</a>.</p>
+
+ <div class="note" style=
+ "margin-left: 0.5in; margin-right: 0.5in;">
+ <h3 class="title">Note</h3>
+
+ <p>The bootstrap installs a <span><strong class=
+ "command">bmake</strong></span> tool. Use this
+ <span><strong class="command">bmake</strong></span>
+ when building via pkgsrc. For examples in this guide,
+ use <span><strong class="command">bmake</strong></span>
+ instead of “<span class=
+ "quote">make</span>”.</p>
+ </div>
</div>
<div class="sect1" lang="en" xml:lang="en">
@@ -1862,8 +1875,8 @@
<div>
<h2 class="title" style="clear: both"><a name=
"platform-specific-notes" id=
- "platform-specific-notes"></a>3.2. Platform
- specific notes</h2>
+ "platform-specific-notes"></a>3.2. Platform-specific
+ notes</h2>
</div>
</div>
</div>
@@ -1912,7 +1925,7 @@
<h3 class="title">Note</h3>
<p>You cannot use a HFS+ file system for pkgsrc,
- because pkgsrc currently requires the filesystem to
+ because pkgsrc currently requires the file system to
be case-sensitive, and HFS+ is not.</p>
</div>
@@ -2081,7 +2094,7 @@
</div>
</div>
- <p>Interix is a POSIX compatible subsystem for the
+ <p>Interix is a POSIX-compatible subsystem for the
Windows NT kernel, providing a Unix-like environment
with a tighter kernel integration than available with
Cygwin. It is part of the Windows Services for Unix
@@ -2180,8 +2193,8 @@
</li>
<li>
- <p>To enable case-sensitivity for the
- filesystem, run REGEDIT.EXE, and change the
+ <p>To enable case-sensitivity for the file
+ system, run REGEDIT.EXE, and change the
following registry key:</p>
<p>
@@ -2304,8 +2317,8 @@
from a different host, please make sure to set
<code class="varname">WRKOBJDIR</code> to a local
directory, as it appears that IRIX linker occasionally
- runs into issues when trying to link over a network
- mounted filesystem.</p>
+ runs into issues when trying to link over a
+ network-mounted file system.</p>
<p>The bootstrapping process should set all the right
options for programs such as imake(1), but you may want
@@ -2481,8 +2494,8 @@
program uses <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional"; class=
"filename">/etc/mk.conf</code> as well. You can
- work around this by enclosing all the pkgsrc
- specific parts of the file with:</p>
+ work around this by enclosing all the
+ pkgsrc-specific parts of the file with:</p>
<pre class="programlisting">
.ifdef BSD_PKG_MK
# pkgsrc stuff, e.g. insert defaults/mk.conf or similar here
@@ -2612,7 +2625,7 @@
<code class="varname">CXX</code> and optionally,
<code class="varname">CPP</code> in <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional"; class=
- "filename">/etc/mk.conf</code>, eg.</p>
+ "filename">/etc/mk.conf</code>, e.g.:</p>
<pre class="programlisting">
CC= cc
CXX= CC
@@ -2620,7 +2633,7 @@
</pre>
<p>You may also want to build 64-bit binaries,
- eg.</p>
+ e.g.:</p>
<pre class="programlisting">
CFLAGS= -xtarget=ultra -xarch=v9
</pre>
@@ -2630,7 +2643,7 @@
<code class="varname">PATH</code>. This includes
<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional"; class=
- "filename">/usr/ccs/{bin,lib}</code> and eg.
+ "filename">/usr/ccs/{bin,lib}</code> and e.g.
<code xmlns=
"http://www.w3.org/TR/xhtml1/transitional"; class=
"filename">/usr/pkg/{bin,sbin}</code>.</p>
@@ -2747,11 +2760,11 @@
"http://www.w3.org/TR/xhtml1/transitional"; class=
"filename">/usr/pkgsrc/packages</code>).</p>
- <p>This same directory layout applies for CDROM
+ <p>This same directory layout applies for CD-ROM
distributions, only that the directory may be rooted
somewhere else, probably somewhere below <code xmlns=
"http://www.w3.org/TR/xhtml1/transitional"; class=
- "filename">/cdrom</code>. Please consult your CDROMs
+ "filename">/cdrom</code>. Please consult your CD-ROMs
documentation for the exact location.</p>
</div>
@@ -2767,7 +2780,7 @@
</div>
</div>
- <p>If you have the files on a CDROM or downloaded them
+ <p>If you have the files on a CD-ROM or downloaded them
to your hard disk, you can install them with the
following command (be sure to <span><strong class=
"command">su</strong></span> to root first):</p>
@@ -2792,7 +2805,7 @@
<p>To save some typing, you can set the <code class=
"varname">PKG_PATH</code> environment variable to a
- semicolon separated list of paths (including remote
+ semicolon-separated list of paths (including remote
URLs); trailing slashes are not allowed.</p>
<p>Additionally to the <code xmlns=
@@ -2811,12 +2824,11 @@
"ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/security/audit-packages/README.html";
target="_top"><code xmlns="" class=
"filename">security/audit-packages</code></a>
- regularly, and especially after installing new
- packages, and verify that the vulnerabilities are
- acceptable for your configuration. An example
- <code class="varname">PKG_PATH</code> would be:
- <code xmlns="http://www.w3.org/TR/xhtml1/transitional";
- class=
+ regularly, especially after installing new packages,
+ and verify that the vulnerabilities are acceptable for
+ your configuration. An example <code class=
+ "varname">PKG_PATH</code> would be: <code xmlns=
+ "http://www.w3.org/TR/xhtml1/transitional"; class=
"filename">ftp://ftp.NetBSD.org/pub/NetBSD/packages/<OSVERSION>/<ARCH>/All;ftp://ftp.NetBSD.org/pub/NetBSD/packages/<OSVERSION>/<ARCH>/vulnerable</code>
Please note that semicolon (';') is a shell
meta-character, so you'll probably have to quote
@@ -2886,7 +2898,7 @@
“<span class="quote">comp</span>” and the
“<span class="quote">text</span>”
distribution sets must be installed. If you want to
- build X11 related packages the “<span class=
+ build X11-related packages the “<span class=
"quote">xbase</span>” and “<span class=
"quote">xcomp</span>” distribution sets are
required, too.</p>
@@ -2949,8 +2961,21 @@
<p>Assuming that the distfile has been fetched (see
previous section), become root and change into the
- relevant directory and running <span><strong class=
- "command">make</strong></span>. For example, type</p>
+ relevant directory and run <span><strong class=
+ "command">make</strong></span>.</p>
+
+ <div class="note" style=
+ "margin-left: 0.5in; margin-right: 0.5in;">
+ <h3 class="title">Note</h3>
+
+ <p>If using bootstrap or pkgsrc on a non-NetBSD
+ system, use the pkgsrc <span><strong class=
+ "command">bmake</strong></span> command instead of
+ “<span class="quote">make</span>” in the
+ examples in this guide.</p>
+ </div>
+
+ <p>For example, type</p>
<pre class="screen">
<code class="prompt">%</code> <strong class=
"userinput"><code>cd misc/figlet</code></strong>
@@ -2991,7 +3016,7 @@
"varname">LOCALBASE=/usr/local</code> in your
environment. Please note that you should use a
directory which is dedicated to packages and not shared
- with other programs (ie, do not try and use
+ with other programs (i.e., do not try and use
<code class="varname">LOCALBASE=/usr</code>). Also, you
should not try to add any of your own files or
directories (such as <code xmlns=
@@ -3098,7 +3123,7 @@
"filename">pkgsrc/mk/defaults/mk.conf</code> for more
Home |
Main Index |
Thread Index |
Old Index