diff options
Diffstat (limited to 'usr.sbin/pkg_install/info')
| -rw-r--r-- | usr.sbin/pkg_install/info/pkg_info.1 | 36 |
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 |