aboutsummaryrefslogtreecommitdiff
path: root/usr.sbin/pkg_install/info
diff options
context:
space:
mode:
authorRuslan Ermilov <ru@FreeBSD.org>2004-07-02 23:13:00 +0000
committerRuslan Ermilov <ru@FreeBSD.org>2004-07-02 23:13:00 +0000
commit07bfccd71e05867cb46c11ea07ec0027794972b3 (patch)
tree502f17eb951b74c914af346cd4dbff252350c082 /usr.sbin/pkg_install/info
parent2ac2784f0c53b69968c131cd068d27cdbacca99f (diff)
Notes
Diffstat (limited to 'usr.sbin/pkg_install/info')
-rw-r--r--usr.sbin/pkg_install/info/pkg_info.136
1 files changed, 24 insertions, 12 deletions
diff --git a/usr.sbin/pkg_install/info/pkg_info.1 b/usr.sbin/pkg_install/info/pkg_info.1
index 1fd2c112eaef..b8f5259adaaf 100644
--- a/usr.sbin/pkg_install/info/pkg_info.1
+++ b/usr.sbin/pkg_install/info/pkg_info.1
@@ -51,14 +51,16 @@ command.
The following command line options are supported:
.Bl -tag -width indent
.It Ar pkg-name ...
-The named packages are described. A package name may either be the name of
+The named packages are described.
+A package name may either be the name of
an installed package, the pathname to a package distribution file or a
URL to an FTP available package.
Package version numbers can also be matched in a relational manner using the
.Pa \*[Ge], \*[Le], \*[Gt]
and
.Pa \*[Lt]
-operators. For example,
+operators.
+For example,
.Pa pkg_info 'portupgrade\*[Ge]20030723'
will match versions 20030723 and later of the
.Pa portupgrade
@@ -97,7 +99,8 @@ Show files that don't match the recorded checksum.
.It Fl i
Show the install script (if any) for each package.
.It Fl I
-Show an index line for each package. This option takes
+Show an index line for each package.
+This option takes
precedence over all other package formatting options.
.It Fl j
Show the requirements script (if any) for each package.
@@ -110,7 +113,8 @@ Show the list of installed packages which require each package.
.It Fl m
Show the mtree file (if any) for each package.
.It Fl L
-Show the files within each package. This is different from just
+Show the files within each package.
+This is different from just
viewing the packing list, since full pathnames for everything
are generated.
.It Fl s
@@ -118,7 +122,8 @@ Show the total size occupied by files installed within each package.
.It Fl o
Show the
.Dq origin
-path recorded on package generation. This path
+path recorded on package generation.
+This path
intended to give an idea as to where the underlying port, from which
package was generated, is located in the
.Fx
@@ -133,7 +138,8 @@ automatically expands shell glob patterns in the
.It Fl W
For the specified
.Ar filename
-argument show which package it belongs to. If the file is not in the
+argument show which package it belongs to.
+If the file is not in the
current directory, and does not have an absolute path, then the
.Ev PATH
is searched using
@@ -146,7 +152,8 @@ argument list all packages having this origin.
Treat the
.Ar pkg-name
as a regular expression and display information only for packages
-whose names match that regular expression. Multiple regular
+whose names match that regular expression.
+Multiple regular
expressions could be provided, in that case
.Nm
displays information about all packages that match at least one
@@ -160,11 +167,13 @@ as an extended regular expression.
.It Fl e Ar pkg-name
If the package identified by
.Ar pkg-name
-is currently installed, return 0, otherwise return 1. This option
+is currently installed, return 0, otherwise return 1.
+This option
allows you to easily test for the presence of another (perhaps
prerequisite) package from a script.
.It Fl E
-Show only matching package names. This option takes
+Show only matching package names.
+This option takes
precedence over all other package formatting options.
If any packages match, return 0, otherwise return 1.
.It Fl l Ar str
@@ -175,7 +184,8 @@ shown with
This is primarily of use to front-end programs who want to request a
lot of different information fields at once for a package, but don't
necessary want the output intermingled in such a way that they can't
-organize it. This lets you add a special token to the start of
+organize it.
+This lets you add a special token to the start of
each field.
.It Fl t Ar template
Use
@@ -189,7 +199,8 @@ By default, this is the string
but it may be necessary to override it in the situation where
space in your
.Pa /tmp
-directory is limited. Be sure to leave some number of `X' characters
+directory is limited.
+Be sure to leave some number of `X' characters
for
.Xr mktemp 3
to fill in with a unique ID.
@@ -224,7 +235,8 @@ Points to the directory where
creates its temporary files.
If this variable is not set,
.Ev TMPDIR
-is used. If both are unset, the builtin defaults are used.
+is used.
+If both are unset, the builtin defaults are used.
.It Ev PKG_DBDIR
Specifies an alternative location for the installed package database.
.El