diff options
Diffstat (limited to 'ports-mgmt/bpkg/files/bpkg.8')
-rw-r--r-- | ports-mgmt/bpkg/files/bpkg.8 | 98 |
1 files changed, 32 insertions, 66 deletions
diff --git a/ports-mgmt/bpkg/files/bpkg.8 b/ports-mgmt/bpkg/files/bpkg.8 index 6048ce2e1487..21fe65026cc9 100644 --- a/ports-mgmt/bpkg/files/bpkg.8 +++ b/ports-mgmt/bpkg/files/bpkg.8 @@ -23,111 +23,85 @@ .\" SUCH DAMAGE. .\" .\" -.Dd December 24, 2007 +.Dd June 19, 2008 .Dt BPKG 8 .Os .Sh NAME .Nm bpkg -.Nd a simple tool for managing FreeBSD packages/ports. +.Nd a simple tool for displaying information about ports. .Sh SYNOPSIS .Nm -.Op Fl bBdDeEfFgiIjkLmMnoOpqQrsSwz +.Op Fl bdeEfgiIjkLmMoOpqQrsSwz .Ar pkg-name ... .Nm -.Op Fl aAcChltvZ +.Op Fl cChltvZ .Pp .Sh DESCRIPTION .Nm -is a simple tool written in sh(1) for managing FreeBSD packages/ports. It is a -wrapper around base system utilities manipulating the FreeBSD Ports Collection. -The main goal of this project is to provide one universal tool for -packages/ports management. -.Sh TERMINOLOGY -.An Nm Port -- a software ready to be compiled from source using the Ports Collection -framework. -.Pp -.An Nm Package -- an installed software (from binary package or port) or a binary package file -in .tbz format made from a port. +is a simple tool written in sh(1) for displaying information about ports. Its +main goal is to provide a quick way to display all kinds of useful info about +installed ports and the whole ports tree. .Sh OPTIONS The following command line arguments are supported: .Bl -tag -width F1 -.It Ar pkg-name ... -with no additional arguments, upgrade/install the specified packages from -RELEASE repository. -.It Fl a -upgrade all installed packages (interactive mode). [no arguments] -.It Fl A -upgrade all installed packages (non-interactive mode). [no arguments] .It Fl b -upgrade/install the specified ports, update the list of installed ports in /root/ports.lst. -.It Fl B -create backup package file in /usr/obj/ from a locally installed package. +create backup package file in /usr/obj/ from a locally installed port. .It Fl c clean all distfiles in /usr/ports/distfiles/* [no arguments] .It Fl C clean all distfiles in /usr/ports/distfiles/* and also all working directories of the ports tree /usr/ports/*/*/work/ [no arguments] .It Fl d -delete the specified installed package. -.It Fl D -display description of the package/port. +display description of the port. .It Fl e -configure options for the specified package/port using dialog(1). -.It Fl E -compile and install any dependencies of the specified package/port and then -compile and install the port itself. +configure options for the specified port using dialog(1). .It Fl f -show the packing list instructions for the package/port. -.It Fl F -show the latest available binary package in the FreeBSD repository. [-RELEASE] +show the packing list instructions for the port. .It Fl g show files that do not match the recorded checksum in the specified installed -package. +port. .It Fl h display help. [no arguments] .It Fl i -display info about the package/port (priority - installed packages). +display info about the port (priority - installed ports). .It Fl I -display short info about the package/port (priority - installed packages). +display short info about the port (priority - installed ports). .It Fl j search the ports tree according to ports' descriptions. .It Fl k -show the deinstall script (if any) for the installed package. +show the deinstall script (if any) for the installed port. .It Fl l -display short info about all installed packages. [no arguments] +display short info about all installed ports. [no arguments] .It Fl L -show the files within the installed package. +show the files within the installed port. .It Fl m -display package/port's Makefile. +display port's Makefile. .It Fl M -show the install-message file for the installed package. -.It Fl n -simulation mode, do not actually install a package/port. +show the install-message file for the installed port. .It Fl o -display config options for the specified package/port. +display config options for the specified port. .It Fl O -remove config options for the specified package/port. +remove config options for the specified port. .It Fl p search the ports tree and display short info about the port. .It Fl q -upgrade/install the specified packages from -STABLE repository. +show the latest available package in the FreeBSD repository. [-RELEASE] .It Fl Q -show the latest available binary package in the FreeBSD repository. [-STABLE] +show the latest available package in the FreeBSD repository. [-STABLE] .It Fl r -show the list of all package/port's dependencies. +show the list of all port's dependencies. .It Fl s -show the total size occupied by files installed within the package. +show the total size occupied by files installed within the port. .It Fl S search the ports tree and display info about the port. .It Fl t -list all installed packages and dates of their installation. [no arguments] +list all installed ports and dates of their installation. [no arguments] .It Fl w -which installed package owns the specified file. +which installed port owns the specified file. .It Fl v -list all installed packages and possible upgrades. [no arguments] +list all installed ports and possible upgrades. [no arguments] .It Fl z -display dynamic object dependencies for the specified package. +display dynamic object dependencies for the specified port. .It Fl Z display all missing dynamic object dependencies. [no arguments] .El @@ -139,17 +113,9 @@ of the .Nm command: .Pp -.Dl Ar "# bpkg foo" -.Pp -Upgrade or install a package named foo (root privileges required). -.Pp -.Dl Ar "# bpkg -b foo" -.Pp -Upgrade or install a port named foo (root privileges required). -.Pp -.Dl Ar "> bpkg -i 'foo bar'" +.Dl Ar "> bpkg -i foo" .Pp -Display info about packages/ports foo and bar. +Display info about port foo. .Pp .Dl Ar "> bpkg -S 'foo[0-9]+$'" .Pp @@ -157,7 +123,7 @@ Display all ports matching the regular expression. .Pp .Dl Ar "> bpkg -t | head" .Pp -Display 10 most recently installed packages. +Display 10 most recently installed ports. .Sh SEE ALSO .Xr pkg_add 1 , .Xr pkg_create 1 , |