pkgsrc-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[pkgsrc/trunk]: pkgsrc/doc regen



details:   https://anonhg.NetBSD.org/pkgsrc/rev/ed83ad6d7d29
branches:  trunk
changeset: 534383:ed83ad6d7d29
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Thu Oct 18 23:06:23 2007 +0000

description:
regen

diffstat:

 doc/pkgsrc.html |  371 ++++++++++++-------------------------------------------
 doc/pkgsrc.txt  |  203 +++++++++--------------------
 2 files changed, 150 insertions(+), 424 deletions(-)

diffs (truncated from 860 to 300 lines):

diff -r 12ce9ea6ace3 -r ed83ad6d7d29 doc/pkgsrc.html
--- a/doc/pkgsrc.html   Thu Oct 18 23:03:47 2007 +0000
+++ b/doc/pkgsrc.html   Thu Oct 18 23:06:23 2007 +0000
@@ -113,7 +113,7 @@
 <dd><dl>
 <dt><span class="sect1"><a href="#general-configuration">5.1. General configuration</a></span></dt>
 <dt><span class="sect1"><a href="#variables-affecting-build">5.2. Variables affecting the build process</a></span></dt>
-<dt><span class="sect1"><a href="#variables-affecting-installation">5.3. Variables affecting the installion process</a></span></dt>
+<dt><span class="sect1"><a href="#variables-affecting-installation">5.3. Variables affecting the installation process</a></span></dt>
 <dt><span class="sect1"><a href="#conf.compiler">5.4. Selecting and configuring the compiler</a></span></dt>
 <dd><dl>
 <dt><span class="sect2"><a href="#selecting-the-compiler">5.4.1. Selecting the compiler</a></span></dt>
@@ -475,8 +475,6 @@
 <dl>
 <dt>1.1. <a href="#supported-platforms">Platforms supported by pkgsrc</a>
 </dt>
-<dt>3.1. <a href="#binary-kits">Binary kits and available packages</a>
-</dt>
 <dt>11.1. <a href="#patch-examples">Patching examples</a>
 </dt>
 <dt>23.1. <a href="#plist-handling">PLIST handling for GNOME packages</a>
@@ -826,7 +824,7 @@
 <dd><dl>
 <dt><span class="sect1"><a href="#general-configuration">5.1. General configuration</a></span></dt>
 <dt><span class="sect1"><a href="#variables-affecting-build">5.2. Variables affecting the build process</a></span></dt>
-<dt><span class="sect1"><a href="#variables-affecting-installation">5.3. Variables affecting the installion process</a></span></dt>
+<dt><span class="sect1"><a href="#variables-affecting-installation">5.3. Variables affecting the installation process</a></span></dt>
 <dt><span class="sect1"><a href="#conf.compiler">5.4. Selecting and configuring the compiler</a></span></dt>
 <dd><dl>
 <dt><span class="sect2"><a href="#selecting-the-compiler">5.4.1. Selecting the compiler</a></span></dt>
@@ -1097,218 +1095,7 @@
 <div class="sect1" lang="en">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
 <a name="binarydist"></a>3.1. Binary distribution</h2></div></div></div>
-<p>
-We provide a bootstrap kit in both source and binary form for other
-platforms than NetBSD, consisting of the pkg administration tools and other
-tools required to use pkgsrc and build packages.
-</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<p>
-Older binary snapshots are available in the
-<a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/archive/"; target="_top">bootstrap-pkgsrc/archive</a>
-directory on ftp.NetBSD.org.</p>
-</div>
-<div class="table">
-<a name="binary-kits"></a><p class="title"><b>Table 3.1. Binary kits and available packages</b></p>
-<div class="table-contents"><table summary="Binary kits and available packages" border="1">
-<colgroup>
-<col>
-<col>
-<col>
-<col>
-</colgroup>
-<thead><tr>
-<th>Platform</th>
-<th>Latest snapshot</th>
-<th>Binary kit</th>
-<th>Binary packages</th>
-</tr></thead>
-<tbody>
-<tr>
-<td class="osname">Darwin 5.5/powerpc (Mac OS X 10.1.5)</td>
-<td class="date">20021209</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Darwin-5.5-powerpc-20021209.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Darwin 6.6/powerpc (Mac OS X 10.2.6)</td>
-<td class="date">20030623</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Darwin-6.6-powerpc-20030623.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Darwin 7.6/powerpc (Mac OS X 10.3.6)</td>
-<td class="date">20041219</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Darwin-7.6.0-powerpc-20041219.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/Darwin-7.6/"; target="_top">binary packages</a></td>
-</tr>
-<tr>
-<td class="osname">Darwin 7.8/powerpc (Mac OS X 10.3.8)</td>
-<td class="date">20050320</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Darwin-7.8.0-powerpc-20050320.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Darwin 8.1/powerpc (Mac OS X 10.4.1)</td>
-<td class="date">20050625</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Darwin-8.1.0-powerpc-20050625.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/Darwin-8.1/powerpc/current/"; target="_top">binary packages</a></td>
-</tr>
-<tr>
-<td class="osname">Debian GNU Linux/i386</td>
-<td class="date">20031023</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Linux-2.4.22-debian-i386-20031023.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Fedora Core 2 Linux/i386</td>
-<td class="date">20050618</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Linux-2.6.10-i386-fc2-20050618.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Fedora Core 4 Linux/i386</td>
-<td class="date">20060105</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Linux-2.6.11-i386-fc4-20060105.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">FreeBSD 3.5/i386</td>
-<td class="date">20030411</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-FreeBSD-3.5-STABLE-i386-20030411.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">FreeBSD 4.7/i386</td>
-<td class="date">20021211</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-FreeBSD-4.7-RELEASE-i386-20021211.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">FreeBSD 5.0/i386</td>
-<td class="date">20030411</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-FreeBSD-5.0-RELEASE-i386-20030411.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">FreeBSD 5.1/i386</td>
-<td class="date">20030630</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-FreeBSD-5.1-RELEASE-i386-20030630.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">FreeBSD 5.2.1/i386</td>
-<td class="date">20040227</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-FreeBSD-5.2.1-RELEASE-i386-20040227.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">FreeBSD 5.3/i386</td>
-<td class="date">20050119</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-FreeBSD-5.3-RELEASE-i386-20050119.tar"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">HP-UX 11.11/hppa</td>
-<td class="date">20070421</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-HPUX-B.11.11-hppa-20070421.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Interix 3.5</td>
-<td class="date">20061106</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Interix-3.5-i386-20061106.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">IRIX 6.5 n32-bit ABI</td>
-<td class="date">20040911</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-IRIX-6.5-mips-20040911.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/IRIX-6.5/n32/"; target="_top">binary packages</a></td>
-</tr>
-<tr>
-<td class="osname">IRIX 6.5 64-bit ABI</td>
-<td class="date">20040912</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-IRIX64-6.5-mips-20040912.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/IRIX-6.5/64/"; target="_top">binary packages</a></td>
-</tr>
-<tr>
-<td class="osname">OpenBSD 3.2/i386</td>
-<td class="date">20030420</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-OpenBSD-3.2-i386-20030420.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">OpenBSD 3.3/i386</td>
-<td class="date">20030503</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-OpenBSD-3.3-i386-20030503.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">OpenBSD 3.5/i386</td>
-<td class="date">20040703</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-OpenBSD-3.5-i386-20040703.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">OSF1 5.1/alpha</td>
-<td class="date">20070420</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-OSF1-V5.1-alpha-20070420.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Slackware Linux 8.1/i386</td>
-<td class="date">20030417</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Linux-2.4.18-slackware-20030417.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Slackware Linux 9/i386</td>
-<td class="date">20040703</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-Linux-2.4.22-i386-slackware9-20040703.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Solaris 8/sparc</td>
-<td class="date">20050220</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-SunOS-5.8-sparc-20050220.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Solaris 8/i386</td>
-<td class="date">20050220</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-SunOS-5.8-i386-20050220.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Solaris 9/sparc</td>
-<td class="date">20060713</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-SunOS-5.9-sparc-pkgsrc-2006Q2.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-<tr>
-<td class="osname">Solaris 9/i386</td>
-<td class="date">20030411</td>
-<td class="kit-url"><a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/bootstrap-pkgsrc-SunOS-5.9-i386-20030411.tar.gz"; target="_top">binary kit</a></td>
-<td class="binary-pkgs-url"> </td>
-</tr>
-</tbody>
-</table></div>
-</div>
-<br class="table-break"><p>
-Simply download the binary kit for your platform, and extract it into
-<code class="filename">/</code> e.g.
-</p>
-<pre class="screen"><code class="prompt">#</code> <strong class="userinput"><code>cd /</code></strong>
-<code class="prompt">#</code> <strong class="userinput"><code>gzip -c -d /tmp/bootstrap-pkgsrc-SunOS-5.9-sparc-20031023.tar.gz \
-  | tar -xpf -</code></strong></pre>
-<p>
-Of course, as with any binary distributions, you should verify the
-checksum against the <a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/SUM"; target="_top">SUM</a>
-or <a href="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/bootstrap-pkgsrc/CKSUM"; target="_top">CKSUM</a>
-file and inspect the contents before extracting it.
-</p>
+<p>See <a href="#using-pkg" title="4.1. Using binary packages">Section 4.1, &#8220;Using binary packages&#8221;</a>.</p>
 </div>
 <div class="sect1" lang="en">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -1328,11 +1115,6 @@
     directory where pkgsrc will do its internal bookkeeping.
     However, these can also be set using command-line
     arguments.</p>
-<p>Binary packages for the pkgsrc tools and an initial set of packages is
-    available for supported platforms. An up-to-date list of these can be
-    found on <a href="http://www.pkgsrc.org/"; target="_top">www.pkgsrc.org</a>.
-    Note that this only works for privileged builds that install
-    into <code class="filename">/usr/pkg</code>.</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.
@@ -1376,7 +1158,7 @@
 <code class="prompt">#</code> <strong class="userinput"><code>sudo chown `id -u`:`id -g` /Volumes/NetBSD</code></strong></pre>
 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 <h3 class="title">Note</h3>
-<p>darwindiskimage will mount the filesystem nosuid, which will cause problems for packages that depend on setgid.  In the case of UFS, it will also mount the filesystem asynchronous, which is 
somewhat dangerous according to the mount(8) man page.  In the case of HFSX, it will disable journalling.</p>
+<p>darwindiskimage will mount the filesystem nosuid, which will cause problems for packages that depend on setgid.  In the case of UFS, it will also mount the filesystem asynchronous, which is 
somewhat dangerous according to the mount(8) man page.  In the case of HFSX, it will disable journaling.</p>
 </div>
 <p>Allow suid:</p>
 <pre class="screen"><code class="prompt">#</code> <strong class="userinput"><code>sudo mount -u -o suid /Volumes/NetBSD</code></strong></pre>
@@ -1890,18 +1672,18 @@
 <div class="sect1" lang="en">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
 <a name="using-pkg"></a>4.1. Using binary packages</h2></div></div></div>
-<p>To use binary packages, you need some tools to manage them. On
-  NetBSD, these tools are already installed. On all other operating
-  systems, you need to install them first. For some platforms, these
-  tools are already packages in an archive, ready to be extracted in the
-  <code class="filename">/</code> directory. They can be found in the <a href="ftp://ftp.NetBSD.org/pub/pkgsrc/bootstrap-pkgsrc"; target="_top"><code class="filename">bootstrap-pkgsrc</code></a>
-  directory of the FTP server.</p>
-<p>These pre-built package tools use
-  <code class="filename">/usr/pkg</code> for the base directory, and
-  <code class="filename">/var/db/pkg</code> for the database of installed
-  packages. If you cannot use these directories for whatever
-  reasons (maybe because you're not root), you have to build the
-  package tools yourself, which is explained in <a href="#bootstrapping-pkgsrc" title="3.2. Bootstrapping pkgsrc">Section 3.2, &#8220;Bootstrapping pkgsrc&#8221;</a>.</p>
+<p>On the <a href="ftp://ftp.NetBSD.org/"; target="_top">ftp.NetBSD.org</a>
+  server and its mirrors, there are collections of binary packages,
+  ready to be installed. These binary packages have been built using the
+  default settings for the directories, that is:</p>
+<div class="itemizedlist"><ul type="disc">
+<li><p><code class="filename">/usr/pkg</code> for <code class="varname">LOCALBASE</code>, where most of the files are installed,</p></li>
+<li><p><code class="filename">/usr/pkg/etc</code> for configuration files,</p></li>
+<li><p><code class="filename">/var</code> for <code class="varname">VARBASE</code>, where those files are installed that may change after installation.</p></li>
+</ul></div>
+<p>If you cannot use these directories for whatever reasons (maybe
+  because you're not root), you cannot use these binary packages, but
+  have to build the packages yourself, which is explained in <a href="#bootstrapping-pkgsrc" title="3.2. Bootstrapping pkgsrc">Section 3.2, &#8220;Bootstrapping pkgsrc&#8221;</a>.</p>
 <div class="sect2" lang="en">



Home | Main Index | Thread Index | Old Index