[pkgsrc/trunk]: pkgsrc/pkgtools/pkg_install/files/delete Improve wording, rem...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/2773ec863a26
branches:  trunk
changeset: 572363:2773ec863a26
user:      wiz <wiz%pkgsrc.org@localhost>
date:      Wed Feb 24 21:11:27 2010 +0000

description:
Improve wording, remove unneeded Bk/Ek, various minor fixes.

diffstat:

 pkgtools/pkg_install/files/delete/pkg_delete.1 |  36 +++++++++++++-------------
 1 files changed, 18 insertions(+), 18 deletions(-)

diffs (106 lines):

diff -r bb5eb8a1e20c -r 2773ec863a26 pkgtools/pkg_install/files/delete/pkg_delete.1
--- a/pkgtools/pkg_install/files/delete/pkg_delete.1    Wed Feb 24 20:49:54 2010 +0000
+++ b/pkgtools/pkg_install/files/delete/pkg_delete.1    Wed Feb 24 21:11:27 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pkg_delete.1,v 1.26 2010/01/22 13:30:41 joerg Exp $
+.\" $NetBSD: pkg_delete.1,v 1.27 2010/02/24 21:11:27 wiz Exp $
 .\"
 .\" FreeBSD install - a package for the installation and maintenance
 .\" of non-core utilities.
@@ -26,13 +26,9 @@
 .Sh SYNOPSIS
 .Nm
 .Op Fl ADFfkNnORrVv
-.Bk -words
 .Op Fl K Ar pkg_dbdir
-.Ek
-.Bk -words
 .Op Fl P Ar destdir
 .Op Fl p Ar prefix
-.Ek
 .Ar pkg-name ...
 .Sh DESCRIPTION
 The
@@ -41,8 +37,8 @@
 with the
 .Xr pkg_add 1
 command.
-The given packages are sorted, so that the dependencies of a package
-are deleted after the package.
+The given packages are sorted, so that the dependencies needed by a
+package are deleted after the package.
 Before any action is executed,
 .Nm
 checks for packages that are marked as
@@ -50,8 +46,7 @@
 or have depending packages left.
 If the
 .Fl k
-flag is given, preserved packages are removed from the list of packages
-to remove.
+flag is given, preserved packages are skipped and not removed.
 Unless the
 .Fl f
 flag is given,
@@ -114,7 +109,9 @@
 .It Fl D
 If a deinstallation script exists for a given package, do not execute it.
 .It Fl F
-Any pkg-name given will be interpreted as pathname which is
+Any
+.Ar pkg-name
+given will be interpreted as pathname which is
 subsequently transformed in a (real) package name via the Package
 Database.
 That way, packages can be deleted by giving a filename
@@ -141,14 +138,16 @@
 .It Fl N
 Remove the package's registration and its entries from the package database,
 but leave the files installed.
-Don't run any deinstall scripts or @unexec lines either.
+Don't run any deinstall scripts or
+.Cm @unexec
+lines either.
 .It Fl n
 Don't actually deinstall a package, just report the steps that
-would be taken if it were.
+would be taken.
 .It Fl O
-Only delete the package's entries from the package database, do not
+Only delete the package's entries from the package database; do not
 touch the package or its files itself.
-.It Fl p Ar destdir
+.It Fl P Ar destdir
 Prefix all file and directory names with
 .Ar destdir .
 For packages without install scripts this has the same behavior as
@@ -163,7 +162,7 @@
 .Xr pkg_add 1 .
 .It Fl R
 Recursively remove all packages that were needed by the given packages
-and that have no other dependencies left.
+and are no longer required, even if they were installed manually.
 This option overrides the
 .Fl A
 flag.
@@ -198,8 +197,9 @@
 If a filename is given instead of a package name, the package of which
 the given file belongs to can be deleted if the
 .Fl F
-Flag is given.
-The filename needs to be absolute, see the output produced by the pkg_info
+flag is given.
+The filename needs to be absolute, see the output produced by the
+.Xr pkg_info 1
 .Fl aF
 command.
 .Pp
@@ -234,7 +234,7 @@
 after deleting them.
 Passing the keywords
 .Ar VIEW-DEINSTALL ,
-.Ar DEINSTALL
+.Ar DEINSTALL ,
 and
 .Ar POST-DEINSTALL
 lets you potentially write only one program/script that handles all