pkgsrc-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[pkgsrc/trunk]: pkgsrc/doc re-generated.
details: https://anonhg.NetBSD.org/pkgsrc/rev/99e62c1a3ea5
branches: trunk
changeset: 516854:99e62c1a3ea5
user: rillig <rillig%pkgsrc.org@localhost>
date: Sat Jul 29 16:01:37 2006 +0000
description:
re-generated.
diffstat:
doc/pkgsrc.html | 776 +++++++++++++++++++++++++++++++++++++++++++++----------
doc/pkgsrc.txt | 531 ++++++++++++++++++++++++++++----------
2 files changed, 1019 insertions(+), 288 deletions(-)
diffs (truncated from 2040 to 300 lines):
diff -r f35be7f6c2fb -r 99e62c1a3ea5 doc/pkgsrc.html
--- a/doc/pkgsrc.html Sat Jul 29 15:57:04 2006 +0000
+++ b/doc/pkgsrc.html Sat Jul 29 16:01:37 2006 +0000
@@ -53,11 +53,15 @@
<dt><span class="chapter"><a href="#introduction">1. What is pkgsrc?</a></span></dt>
<dd><dl>
<dt><span class="sect1"><a href="#introduction-section">1.1. Introduction</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="#why-pkgsrc">1.1.1. Why pkgsrc?</a></span></dt>
+<dt><span class="sect2"><a href="#intro.platforms">1.1.2. Supported platforms</a></span></dt>
+</dl></dd>
<dt><span class="sect1"><a href="#overview">1.2. Overview</a></span></dt>
<dt><span class="sect1"><a href="#terminology">1.3. Terminology</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="#term.abbrev">1.3.1. Commonly used abbreviations</a></span></dt>
-<dt><span class="sect2"><a href="#term.people">1.3.2. People involved in pkgsrc</a></span></dt>
+<dt><span class="sect2"><a href="#term.roles">1.3.2. Roles involved in pkgsrc</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="#typography">1.4. Typography</a></span></dt>
</dl></dd>
@@ -79,16 +83,17 @@
</dl></dd>
<dt><span class="chapter"><a href="#platforms">3. Using pkgsrc on systems other than NetBSD</a></span></dt>
<dd><dl>
-<dt><span class="sect1"><a href="#bootstrapping-pkgsrc">3.1. Bootstrapping pkgsrc</a></span></dt>
-<dt><span class="sect1"><a href="#platform-specific-notes">3.2. Platform-specific notes</a></span></dt>
-<dd><dl>
-<dt><span class="sect2"><a href="#darwin">3.2.1. Darwin (Mac OS X)</a></span></dt>
-<dt><span class="sect2"><a href="#freebsd">3.2.2. FreeBSD</a></span></dt>
-<dt><span class="sect2"><a href="#interix">3.2.3. Interix</a></span></dt>
-<dt><span class="sect2"><a href="#irix">3.2.4. IRIX</a></span></dt>
-<dt><span class="sect2"><a href="#linux">3.2.5. Linux</a></span></dt>
-<dt><span class="sect2"><a href="#openbsd">3.2.6. OpenBSD</a></span></dt>
-<dt><span class="sect2"><a href="#solaris">3.2.7. Solaris</a></span></dt>
+<dt><span class="sect1"><a href="#binarydist">3.1. Binary distribution</a></span></dt>
+<dt><span class="sect1"><a href="#bootstrapping-pkgsrc">3.2. Bootstrapping pkgsrc</a></span></dt>
+<dt><span class="sect1"><a href="#platform-specific-notes">3.3. Platform-specific notes</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="#darwin">3.3.1. Darwin (Mac OS X)</a></span></dt>
+<dt><span class="sect2"><a href="#freebsd">3.3.2. FreeBSD</a></span></dt>
+<dt><span class="sect2"><a href="#interix">3.3.3. Interix</a></span></dt>
+<dt><span class="sect2"><a href="#irix">3.3.4. IRIX</a></span></dt>
+<dt><span class="sect2"><a href="#linux">3.3.5. Linux</a></span></dt>
+<dt><span class="sect2"><a href="#openbsd">3.3.6. OpenBSD</a></span></dt>
+<dt><span class="sect2"><a href="#solaris">3.3.7. Solaris</a></span></dt>
</dl></dd>
</dl></dd>
<dt><span class="chapter"><a href="#using">4. Using pkgsrc</a></span></dt>
@@ -97,7 +102,12 @@
<dd><dl>
<dt><span class="sect2"><a href="#finding-binary-packages">4.1.1. Finding binary packages</a></span></dt>
<dt><span class="sect2"><a href="#installing-binary-packages">4.1.2. Installing binary packages</a></span></dt>
-<dt><span class="sect2"><a href="#a-word-of-warning">4.1.3. A word of warning</a></span></dt>
+<dt><span class="sect2"><a href="#using.pkg_delete">4.1.3. Deinstalling packages</a></span></dt>
+<dt><span class="sect2"><a href="#using.pkg_info">4.1.4. Getting information about installed packages</a></span></dt>
+<dt><span class="sect2"><a href="#vulnerabilities">4.1.5. Checking for security vulnerabilities in installed packages</a></span></dt>
+<dt><span class="sect2"><a href="#pkg_versions">4.1.6. Finding if newer versions of your installed packages are in pkgsrc</a></span></dt>
+<dt><span class="sect2"><a href="#using.pkg_admin">4.1.7. Other administrative functions</a></span></dt>
+<dt><span class="sect2"><a href="#a-word-of-warning">4.1.8. A word of warning</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="#building-packages-from-source">4.2. Building packages from source</a></span></dt>
<dd><dl>
@@ -410,6 +420,15 @@
</dl></dd>
</dl>
</div>
+<div class="list-of-tables">
+<p><b>List of Tables</b></p>
+<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>
+</dl>
+</div>
<div class="chapter" lang="en">
<div class="titlepage"><div><div><h2 class="title">
<a name="introduction"></a>Chapter 1. What is pkgsrc?</h2></div></div></div>
@@ -417,11 +436,15 @@
<p><b>Table of Contents</b></p>
<dl>
<dt><span class="sect1"><a href="#introduction-section">1.1. Introduction</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="#why-pkgsrc">1.1.1. Why pkgsrc?</a></span></dt>
+<dt><span class="sect2"><a href="#intro.platforms">1.1.2. Supported platforms</a></span></dt>
+</dl></dd>
<dt><span class="sect1"><a href="#overview">1.2. Overview</a></span></dt>
<dt><span class="sect1"><a href="#terminology">1.3. Terminology</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="#term.abbrev">1.3.1. Commonly used abbreviations</a></span></dt>
-<dt><span class="sect2"><a href="#term.people">1.3.2. People involved in pkgsrc</a></span></dt>
+<dt><span class="sect2"><a href="#term.roles">1.3.2. Roles involved in pkgsrc</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="#typography">1.4. Typography</a></span></dt>
</dl>
@@ -429,19 +452,13 @@
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="introduction-section"></a>1.1. Introduction</h2></div></div></div>
-<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 software run, and makes the installation
- (and de-installation) of the software package easy by means of a
- single command. </p>
-<p>Once the software
- has been built, it is manipulated with the <span><strong class="command">pkg_*</strong></span> tools
- so that installation
- and de-installation, printing of an inventory of all installed packages and
- retrieval of one-line comments or more verbose descriptions are all
- simple.</p>
+<p>There is a lot of software freely available for Unix-based
+systems, which is usually available in form of the source code. Before
+such software can be used, it needs to be configured to the local
+system, compiled and installed, and this is exactly what The NetBSD
+Packages Collection (pkgsrc) does. pkgsrc also has some basic commands
+to handle binary packages, so that not every user has to build the
+packages for himself, which is a time-costly task.</p>
<p>pkgsrc currently contains several thousand packages,
including:</p>
<div class="itemizedlist"><ul type="disc">
@@ -458,24 +475,122 @@
<p>pkgsrc has built-in support for handling varying dependencies,
such as pthreads and X11, and extended features such as IPv6 support on
a range of platforms.</p>
+<div class="sect2" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="why-pkgsrc"></a>1.1.1. Why pkgsrc?</h3></div></div></div>
+<p>
+pkgsrc provides the following key features:
+</p>
+<div class="itemizedlist"><ul type="disc">
+<li><p>Easy building of software from source as well as the creation
+ and installation of binary packages. The source and latest
+ patches are retrieved from a master or mirror download site, checksum
+ verified, then built on your system. Support for binary-only
+ distributions is available for both native platforms and NetBSD
+ emulated platforms.</p></li>
+<li><p>All packages are installed in a consistent directory tree,
+ including binaries, libraries, man pages and other
+ documentation.</p></li>
+<li><p>Package dependencies, including when performing package updates,
+ are handled automatically. The configuration files of various
+ packages are handled automatically during updates, so local changes
+ are preserved.</p></li>
+<li><p>Like NetBSD, pkgsrc is designed with portability in mind and
+ consists of highly portable code. This allows the greatest speed of
+ development when porting to new a platform. This portability also
+ ensures that pkgsrc is <span class="emphasis"><em>consistent across all
+ platforms</em></span>.</p></li>
+<li><p>The installation prefix, acceptable software licenses,
+ international encryption requirements and build-time options for a
+ large number of packages are all set in a simple, central
+ configuration file.</p></li>
+<li><p>The entire source (not including the distribution files) is
+ freely available under a BSD license, so you may extend and adapt
+ pkgsrc to your needs. Support for local packages and patches is
+ available right out of the box, so you can configure it specifically
+ for your environment.</p></li>
+</ul></div>
+</div>
+<div class="sect2" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="intro.platforms"></a>1.1.2. Supported platforms</h3></div></div></div>
+<p>pkgsrc consists of both a source distribution and a binary
+distribution for these operating systems. After retrieving the required
+source or binaries, you can be up and running with pkgsrc in just
+minutes!</p>
<p>pkgsrc was derived from FreeBSD's ports system, and
initially developed for NetBSD only. Since then, pkgsrc has
grown a lot, and now supports the following platforms:</p>
-<div class="itemizedlist"><ul type="disc">
-<li><p><a href="http://developer.apple.com/darwin/" target="_top">Darwin</a>
- (<a href="http://www.apple.com/macosx/" target="_top">Mac OS X</a>)</p></li>
-<li><p><a href="http://www.DragonFlyBSD.org/" target="_top">DragonFly BSD</a></p></li>
-<li><p><a href="http://www.FreeBSD.org/" target="_top">FreeBSD</a></p></li>
-<li><p>Microsoft Windows, via <a href="http://www.microsoft.com/windows/sfu/" target="_top">Interix</a></p></li>
-<li><p><a href="http://www.sgi.com/software/irix6.5/" target="_top">IRIX</a></p></li>
-<li><p><a href="http://www.linux.org/" target="_top">Linux</a></p></li>
-<li><p><a href="http://www.NetBSD.org/" target="_top">NetBSD</a> (of
- course)</p></li>
-<li><p><a href="http://h30097.www3.hp.com/" target="_top">Tru64</a>
- (Digital UNIX, OSF1)</p></li>
-<li><p><a href="http://www.openbsd.org/" target="_top">OpenBSD</a></p></li>
-<li><p><a href="http://www.sun.com/solaris/" target="_top">Solaris</a></p></li>
-</ul></div>
+<div class="table">
+<a name="supported-platforms"></a><p class="title"><b>Table 1.1. Platforms supported by pkgsrc</b></p>
+<table summary="Platforms supported by pkgsrc" border="1">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>Platform</th>
+<th>Date Support Added</th>
+</tr></thead>
+<tbody>
+<tr>
+<td><a href="http://www.NetBSD.org/" target="_top">NetBSD</a></td>
+<td align="center">Aug 1997</td>
+</tr>
+<tr>
+<td><a href="http://wwws.sun.com/software/solaris/" target="_top">Solaris</a></td>
+<td align="center">Mar 1999</td>
+</tr>
+<tr>
+<td><a href="http://www.kernel.org/" target="_top">Linux</a></td>
+<td align="center">Jun 1999</td>
+</tr>
+<tr>
+<td>
+ <a href="http://developer.apple.com/darwin/" target="_top">Darwin</a>
+ (<a href="http://developer.apple.com/macosx/" target="_top">Mac OS X</a>)
+ </td>
+<td align="center">Oct 2001</td>
+</tr>
+<tr>
+<td><a href="http://www.freebsd.org/" target="_top">FreeBSD</a></td>
+<td align="center">Nov 2002</td>
+</tr>
+<tr>
+<td><a href="http://www.openbsd.org/" target="_top">OpenBSD</a></td>
+<td align="center">Nov 2002</td>
+</tr>
+<tr>
+<td><a href="http://www.sgi.com/software/irix/" target="_top">IRIX</a></td>
+<td align="center">Dec 2002</td>
+</tr>
+<tr>
+<td>BSD/OS</td>
+<td align="center">Dec 2003</td>
+</tr>
+<tr>
+<td><a href="http://www-1.ibm.com/servers/aix/" target="_top">AIX</a></td>
+<td align="center">Dec 2003</td>
+</tr>
+<tr>
+<td>
+ <a href="http://www.microsoft.com/windows/sfu/" target="_top">Interix</a>
+ (Microsoft Windows Services for Unix)
+ </td>
+<td align="center">Mar 2004</td>
+</tr>
+<tr>
+<td><a href="http://www.dragonflybsd.org/" target="_top">DragonFlyBSD</a></td>
+<td align="center">Oct 2004</td>
+</tr>
+<tr>
+<td><a href="http://www.tru64.org/" target="_top">OSF/1</a></td>
+<td align="center">Nov 2004</td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
</div>
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -557,7 +672,7 @@
</div>
<div class="sect2" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="term.people"></a>1.3.2. People involved in pkgsrc</h3></div></div></div>
+<a name="term.roles"></a>1.3.2. Roles involved in pkgsrc</h3></div></div></div>
<div class="variablelist"><dl>
<dt><span class="term">pkgsrc users</span></dt>
<dd>
@@ -615,16 +730,17 @@
</dl></dd>
<dt><span class="chapter"><a href="#platforms">3. Using pkgsrc on systems other than NetBSD</a></span></dt>
<dd><dl>
-<dt><span class="sect1"><a href="#bootstrapping-pkgsrc">3.1. Bootstrapping pkgsrc</a></span></dt>
-<dt><span class="sect1"><a href="#platform-specific-notes">3.2. Platform-specific notes</a></span></dt>
-<dd><dl>
-<dt><span class="sect2"><a href="#darwin">3.2.1. Darwin (Mac OS X)</a></span></dt>
-<dt><span class="sect2"><a href="#freebsd">3.2.2. FreeBSD</a></span></dt>
-<dt><span class="sect2"><a href="#interix">3.2.3. Interix</a></span></dt>
-<dt><span class="sect2"><a href="#irix">3.2.4. IRIX</a></span></dt>
-<dt><span class="sect2"><a href="#linux">3.2.5. Linux</a></span></dt>
-<dt><span class="sect2"><a href="#openbsd">3.2.6. OpenBSD</a></span></dt>
-<dt><span class="sect2"><a href="#solaris">3.2.7. Solaris</a></span></dt>
+<dt><span class="sect1"><a href="#binarydist">3.1. Binary distribution</a></span></dt>
+<dt><span class="sect1"><a href="#bootstrapping-pkgsrc">3.2. Bootstrapping pkgsrc</a></span></dt>
+<dt><span class="sect1"><a href="#platform-specific-notes">3.3. Platform-specific notes</a></span></dt>
+<dd><dl>
+<dt><span class="sect2"><a href="#darwin">3.3.1. Darwin (Mac OS X)</a></span></dt>
+<dt><span class="sect2"><a href="#freebsd">3.3.2. FreeBSD</a></span></dt>
+<dt><span class="sect2"><a href="#interix">3.3.3. Interix</a></span></dt>
+<dt><span class="sect2"><a href="#irix">3.3.4. IRIX</a></span></dt>
+<dt><span class="sect2"><a href="#linux">3.3.5. Linux</a></span></dt>
+<dt><span class="sect2"><a href="#openbsd">3.3.6. OpenBSD</a></span></dt>
+<dt><span class="sect2"><a href="#solaris">3.3.7. Solaris</a></span></dt>
</dl></dd>
</dl></dd>
<dt><span class="chapter"><a href="#using">4. Using pkgsrc</a></span></dt>
@@ -633,7 +749,12 @@
<dd><dl>
<dt><span class="sect2"><a href="#finding-binary-packages">4.1.1. Finding binary packages</a></span></dt>
Home |
Main Index |
Thread Index |
Old Index