[src/netbsd-1-6]: src/usr.sbin/pkg_install/add Pull up revision 1.38 (request...

[tron <tron%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/6ecebed9d9f6
branches:  netbsd-1-6
changeset: 529518:6ecebed9d9f6
user:      tron <tron%NetBSD.org@localhost>
date:      Sun Nov 24 22:32:21 2002 +0000

description:
Pull up revision 1.38 (requested by jschauma in ticket #1011):
Ispell. Begin new sentences on a new line.

diffstat:

 usr.sbin/pkg_install/add/pkg_add.1 |  93 +++++++++++++++++++++----------------
 1 files changed, 53 insertions(+), 40 deletions(-)

diffs (217 lines):

diff -r a2910186d957 -r 6ecebed9d9f6 usr.sbin/pkg_install/add/pkg_add.1
--- a/usr.sbin/pkg_install/add/pkg_add.1        Sun Nov 24 22:32:12 2002 +0000
+++ b/usr.sbin/pkg_install/add/pkg_add.1        Sun Nov 24 22:32:21 2002 +0000
@@ -1,6 +1,6 @@
-.\" $NetBSD: pkg_add.1,v 1.33.2.4 2002/11/24 22:30:56 tron Exp $
+.\" $NetBSD: pkg_add.1,v 1.33.2.5 2002/11/24 22:32:21 tron Exp $
 .\"
-.\" FreeBSD install - a package for the installation and maintainance
+.\" FreeBSD install - a package for the installation and maintenance
 .\" of non-core utilities.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -53,19 +53,20 @@
 Since the
 .Nm
 command may execute scripts or programs contained within a package file,
-your system may be susceptible to ``trojan horses'' or other subtle
+your system may be susceptible to ``Trojan horses'' or other subtle
 attacks from miscreants who create dangerous package files.
 .Pp
 You are advised to verify the competence and identity of those who
-provide installable package files.  For extra protection, use the
-digital signatures provided where possible (see the
+provide installable package files.
+For extra protection, use the digital signatures provided where possible
+(see the
 .Fl s
 option), or, failing that, use the
 .Fl M
 flag to extract the package file, and inspect its contents and scripts
-to ensure it poses no danger to your system's integrity.  Pay particular
-attention to any +INSTALL, +DEINSTALL, +REQUIRE or +MTREE_DIRS files,
-and inspect the +CONTENTS file for
+to ensure it poses no danger to your system's integrity.
+Pay particular attention to any +INSTALL, +DEINSTALL, +REQUIRE
+or +MTREE_DIRS files, and inspect the +CONTENTS file for
 .Cm @cwd ,
 .Cm @mode
 (check for setuid),
@@ -97,7 +98,8 @@
 in the same location that the original package was installed from.
 .It Fl f
 Force installation to proceed even if prerequisite packages are not
-installed or the requirements script fails.  Although
+installed or the requirements script fails.
+Although
 .Nm
 will still try to find and auto-install missing prerequisite packages,
 a failure to find one will not be fatal.
@@ -106,11 +108,13 @@
 .It Fl M
 Run in
 .Cm MASTER
-mode.  This is a very specialized mode for running
+mode.
+This is a very specialized mode for running
 .Nm
 and is meant to be run in conjunction with
 .Cm SLAVE
-mode.  When run in this mode,
+mode.
+When run in this mode,
 .Nm
 does no work beyond extracting the package into a temporary staging
 area (see the
@@ -131,15 +135,16 @@
 .Ar prefix
 as the directory in which to extract files from a package.
 If a package has set its default directory, it will be overridden
-by this flag.  Note that only the first
+by this flag.
+Note that only the first
 .Cm @cwd
 directive will be replaced, since
 .Nm
 has no way of knowing which directory settings are relative and
-which are absolute.  It is rare in any case to see more than one
-directory transition made, but when such does happen and you wish
-to have control over *all* directory transitions, then you
-may then wish to look into the use of
+which are absolute.
+It is rare in any case to see more than one directory transition made,
+but when such does happen and you wish to have control over *all* directory
+transitions, then you may then wish to look into the use of
 .Cm MASTER
 and
 .Cm SLAVE
@@ -149,21 +154,24 @@
 .Fl S
 options).
 .It Fl R
-Do not record the installation of a package.  This means
-that you cannot deinstall it later, so only use this option if
+Do not record the installation of a package.
+This means that you cannot deinstall it later, so only use this option if
 you know what you are doing!
 .It Fl S
 Run in
 .Cm SLAVE
-mode.  This is a very specialized mode for running
+mode.
+This is a very specialized mode for running
 .Nm
 and is meant to be run in conjunction with
 .Cm MASTER
-mode.  When run in this mode,
+mode.
+When run in this mode,
 .Nm
 expects the release contents to be already extracted and waiting
 in the staging area, the location of which is read as a string
-from stdin.  The complete packing list is also read from stdin,
+from stdin.
+The complete packing list is also read from stdin,
 and the contents then acted on as normal.
 .It Fl s Ar verification-type
 Use a callout to an external program to verify the binary package
@@ -173,12 +181,12 @@
 At the present time, the following verification types
 are defined: none, gpg and pgp5.
 The signature will be verified at install time, and the results
-will be displayed. If the signature type is anything other than
-none, the user will be asked if
+will be displayed.
+If the signature type is anything other than none, the user will be asked if
 .Nm
-should proceed to install the binary package. The user must then
-take the decision whether to proceed or not, depending upon the
-amount of trust that is placed in the signatory of the binary
+should proceed to install the binary package.
+The user must then take the decision whether to proceed or not, depending
+upon the amount of trust that is placed in the signatory of the binary
 package.
 Please note that, at the current time, it is not possible to use
 the verification feature when using
@@ -197,8 +205,8 @@
 but it may be necessary to override it in the situation where
 space in your
 .Pa /var/tmp
-directory is limited.  Be sure to leave some number of `X' characters
-for
+directory is limited.
+Be sure to leave some number of `X' characters for
 .Xr mktemp 3
 to fill in with a unique ID.
 .Pp
@@ -221,8 +229,9 @@
 .Ar pkg-name
 arguments may be specified, each being either a file containing the
 package (these usually ending with the ``.tgz'' suffix) or a
-URL pointing at a file available on an ftp or web site.  Thus you may
-extract files directly from their anonymous ftp or WWW locations (e.g.
+URL pointing at a file available on an ftp or web site.
+Thus you may extract files directly from their anonymous ftp or WWW
+locations (e.g.
 .Nm
 ftp://ftp.netbsd.org/pub/NetBSD/packages/1.5/i386/shells/bash-2.04.tgz).
 Note:  If you wish to use
@@ -234,8 +243,9 @@
 .Bf -emphasis
 FTP_PASSIVE_MODE
 .Ef
-to some value in your environment.  Otherwise, the more standard
-ACTIVE mode may be used.  If
+to some value in your environment.
+Otherwise, the more standard ACTIVE mode may be used.
+If
 .Nm
 consistently fails to fetch a package from a site known to work,
 it may be because you have a firewall that demands the usage of
@@ -265,7 +275,8 @@
 .Pa +REQUIRED_BY
 file aside (if it exists), and by running
 .Xr pkg_delete 1
-on the installed package. Installation then procedes as if the package
+on the installed package.
+Installation then proceeds as if the package
 was not installed, and restores the
 .Pa +REQUIRED_BY
 file afterwards.
@@ -274,8 +285,8 @@
 .Cm @pkgcfl
 directives, see
 .Xr pkg_create 1 )
-with an already recorded as installed package. If it is,
-installation is terminated.
+with an already recorded as installed package.
+If it is, installation is terminated.
 .It
 All package dependencies (from
 .Cm @pkgdep
@@ -405,7 +416,8 @@
 .Ev PKG_PREFIX
 set to the installation prefix (see the
 .Fl p
-option above).  This allows a package author to write a script
+option above).
+This allows a package author to write a script
 that reliably performs some action on the directory where the package
 is installed, even if the user might change it with the
 .Fl p
@@ -418,10 +430,11 @@
 is used if a given package can't be found, it's usually set to
 .Pa /usr/pkgsrc/packages/All .
 The environment variable
-should be a series of entries separated by semicolons.  Each entry
-consists of a directory name or URL. The current directory may be indicated
-implicitly by an empty directory name, or explicitly by a single
-period. FTP URLs may not end with a slash.
+should be a series of entries separated by semicolons.
+Each entry consists of a directory name or URL.
+The current directory may be indicated implicitly by an empty directory
+name, or explicitly by a single period.
+FTP URLs may not end with a slash.
 .Ss PKG_DBDIR
 Where to register packages instead of
 .Pa /var/db/pkg .