[src/netbsd-1-5]: src/usr.sbin/pkg_install/info Pull up revisions 1.25-1.28 (...

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

details:   https://anonhg.NetBSD.org/src/rev/c4eb8cc1689a
branches:  netbsd-1-5
changeset: 492839:c4eb8cc1689a
user:      he <he%NetBSD.org@localhost>
date:      Sat Feb 23 18:09:35 2002 +0000

description:
Pull up revisions 1.25-1.28 (requested by seb):
  Synchronize with recent developments:
   o Add ``-n'' argument to show needed packages; fixes PR#13071
   o Improve version number handling by recognizing "pl" and "rc"
   o Various internal cleanups, bugfixes, and API tweaks

diffstat:

 usr.sbin/pkg_install/info/pkg_info.1 |  38 ++++++++++++++++++++++++++++-------
 1 files changed, 30 insertions(+), 8 deletions(-)

diffs (93 lines):

diff -r 53dfec589344 -r c4eb8cc1689a usr.sbin/pkg_install/info/pkg_info.1
--- a/usr.sbin/pkg_install/info/pkg_info.1      Sat Feb 23 18:08:23 2002 +0000
+++ b/usr.sbin/pkg_install/info/pkg_info.1      Sat Feb 23 18:09:35 2002 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pkg_info.1,v 1.21.4.2 2001/05/01 10:55:59 he Exp $
+.\" $NetBSD: pkg_info.1,v 1.21.4.3 2002/02/23 18:09:35 he Exp $
 .\"
 .\" FreeBSD install - a package for the installation and maintainance
 .\" of non-core utilities.
@@ -25,7 +25,7 @@
 .Nd a utility for displaying information on software packages
 .Sh SYNOPSIS
 .Nm
-.Op Fl BbcDdFfhIikLmpqRrSsVv
+.Op Fl BbcDdFfhIikLmnpqRrSsVv
 .Bk -words
 .Op Fl e Ar package
 .Ek
@@ -65,7 +65,9 @@
 Show some of the important definitions used when building
 the binary package (the "Build information") for each package.
 .It Fl b
-Show the NetBSD RCS Id strings from the files used in the construction
+Show the
+.Nx
+RCS Id strings from the files used in the construction
 of the binary package (the "Build version") for each package. These files are the
 package Makefile, any patch files, any checksum files, and the packing
 list file.
@@ -86,7 +88,7 @@
 stdout unless turned off using the
 .Fl q
 option.
-
+.Pp
 If the given
 .Ar pkg-name
 contains a
@@ -97,15 +99,33 @@
 style {,} alternates have also been implemented in addition to this.
 Package version numbers can also be matched in a relational manner
 using the
-.Pa >=, <=, >
+.Pa \*[Ge], \*[Le], \*[Gt]
 and
-.Pa <
+.Pa \*[Lt]
 operators.
 For example,
-.Pa pkg_info -e 'name>=1.3'
+.Pa pkg_info -e 'name\*[Ge]1.3'
 will match versions 1.3 and later of the
 .Pa name
 package.
+The collating sequence of the various package version numbers is
+unusual, but strives to be consistent. The magic string ``rc''
+equates to
+.Pa release candidate
+and sorts before a release. For example,
+.Pa name-1.3rc3
+will sort before
+.Pa name-1.3
+and after
+.Pa name-1.2.9
+In addition, alphabetic characters sort in the same place as
+their numeric counterparts, so that
+.Pa name-1.2e
+has the same sorting value as
+.Pa name-1.2.5
+The magic string ``pl'' equates to a
+.Pa patch level
+and has the same value as a dot in the dewey-decimal ordering schemes.
 .It Fl F
 Interpret any pkg-name given as filename, and translate it to a
 package name using the Package Database. This can be used to query
@@ -136,6 +156,8 @@
 each field.
 .It Fl m
 Show the mtree file (if any) for each package.
+.It Fl n
+Show which packages each package needs (depends upon), if any.
 .It Fl p
 Show the installation prefix for each package.
 .It Fl q
@@ -205,7 +227,7 @@
 Package info is either extracted from package files named on the
 command line, or from already installed package information
 in
-.Pa /var/db/pkg/<pkg-name> .
+.Pa /var/db/pkg/\*[Lt]pkg-name\*[Gt] .
 .Pp
 A filename can be given instead of a (installed) package name to query
 information on the package this file belongs to. This filename is then