aboutsummaryrefslogtreecommitdiff
path: root/ports-mgmt/bpkg/files/bpkg.8
diff options
context:
space:
mode:
Diffstat (limited to 'ports-mgmt/bpkg/files/bpkg.8')
-rw-r--r--ports-mgmt/bpkg/files/bpkg.898
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 ,