[pkgsrc/trunk]: pkgsrc/doc/guide/files Updated the "Using pkgsrc" chapter a b...

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/28c9904c5d8a
branches:  trunk
changeset: 508594:28c9904c5d8a
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Wed Feb 22 01:30:25 2006 +0000

description:
Updated the "Using pkgsrc" chapter a bit, making it more
platform-independent. Explicitly added URLs where to find binary
packages for Solaris.

diffstat:

 doc/guide/files/using.xml |  99 ++++++++++++++++++++++++++++++++--------------
 1 files changed, 69 insertions(+), 30 deletions(-)

diffs (114 lines):

diff -r 171dc321f6c5 -r 28c9904c5d8a doc/guide/files/using.xml
--- a/doc/guide/files/using.xml Wed Feb 22 00:06:44 2006 +0000
+++ b/doc/guide/files/using.xml Wed Feb 22 01:30:25 2006 +0000
@@ -1,41 +1,80 @@
-<!-- $NetBSD: using.xml,v 1.16 2006/02/12 14:44:59 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.17 2006/02/22 01:30:25 rillig Exp $ -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
-  <title>Using pkgsrc</title>
+<title>Using pkgsrc</title>
 
-  <sect1 id="getting-started">
-    <title>Working with binary packages</title>
+       <para>Basically, there are two ways of using pkgsrc. The first
+       is to only install the package tools and to use binary packages
+       that someone else has prepared. This is the <quote>pkg</quote>
+       in pkgsrc. The second way is to install the <quote>src</quote>
+       of pkgsrc, too. Then you are able to build your own packages,
+       and you can still use binary packages from someone else.</para>
+
+<sect1 id="using-pkg">
+<title>Using binary packages</title>
 
-    <para> This section describes how to find, retrieve and install a
-      precompiled binary package that someone else already prepared
-      for your type of machine. </para>
+       <para>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 the
+       following platforms, prebuilt versions of the package tools
+       are available and can simply be downloaded and unpacked in the
+       <filename>/</filename> directory:</para>
 
-    <sect2 id="where-to-get-binary-packages">
-      <title>Where to get binary packages</title>
+       <informaltable id="binary-bootstrap-kits">
+       <tgroup cols="2">
+       <thead><row><entry>Platform</entry><entry>URL</entry></row></thead>
+       <tbody>
+       <row><entry>Solaris 5.10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/bootstrap-pkgsrc/</filename></entry></row>
+       </tbody>
+       </tgroup>
+       </informaltable>
+
+       <para>These prebuilt package tools use
+       <filename>/usr/pkg</filename> for the base directory, and
+       <filename>/var/db/pkg</filename> 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 <xref
+       linkend="bootstrapping-pkgsrc" />.</para>
 
-      <para> Precompiled packages are stored on ftp.NetBSD.org and its
-        mirrors in the directory
-        <filename>/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/</filename> for
-       anonymous FTP access.  <varname>OSVERSION</varname> is the &os;
-       version (<command>uname -r</command>), <varname>ARCH</varname>
-       is the architecture (<command>uname -p</command>).
-       In that directory, there is a
-        subdirectory for each category plus a subdirectory
-        <filename>All</filename> which includes the actual binaries in
-        <filename>.tgz</filename> files. The category subdirectories
-        use symbolic links to those files (this is the same directory
-        layout as in
-        <filename>/usr/pkgsrc/packages</filename>). </para>
+<sect2 id="finding-binary-packages">
+<title>Finding binary packages</title>
+
+       <para>To install binary packages, you first need to know from
+       where to get them. You can get them on CD-ROMs, DVDs, or via FTP
+       or HTTP.</para>
+
+       <para>For NetBSD, the binary packages are made available on
+       <filename>ftp.NetBSD.org</filename> and its mirrors, in the
+       directory
+       <filename>/pub/NetBSD/packages/<replaceable>OSVERSION</replaceable>/<replaceable>ARCH</replaceable>/</filename>.
+       <replaceable>OSVERSION</replaceable> is the output of
+       <command>uname -r</command>, and <replaceable>ARCH</replaceable>
+       is the output of <command>uname -p</command>.</para>
+
+       <para>For some other platforms, binary packages can be found at
+       the following locations:</para>
 
-      <para> This same directory layout applies for CD-ROM
-        distributions, only that the directory may be rooted somewhere
-        else, probably somewhere below
-        <filename>/cdrom</filename>. Please consult your CD-ROMs
-        documentation for the exact location. </para>
-    </sect2>
+       <informaltable id="binary-packages">
+       <tgroup cols="2">
+       <thead><row><entry>Platform</entry><entry>URL</entry></row></thead>
+       <tbody>
+       <row><entry>Solaris 5.10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/</filename></entry></row>
+       </tbody>
+       </tgroup>
+       </informaltable>
 
-    <sect2 id="how-to-use-binary-packages">
-      <title>How to use binary packages</title>
+       <para>In each of these directories, there is a subdirectory
+       <filename>All</filename> that contains all the binary packages.
+       Further, there are subdirectories for categories that contain
+       symbolic links that point to the actual binary package in
+       <filename>../All</filename>. This directory layout is used for
+       all package repositories, no matter if they are accessed via
+       HTTP, FTP, NFS, CD-ROM, or the local filesystem.</para>
+
+</sect2>
+<sect2 id="installing-binary-packages">
+<title>Installing binary packages</title>
 
       <para> If you have the files on a CD-ROM or downloaded them to
         your hard disk, you can install them with the following command