PBROWSER(1)                OpenBSD Reference Manual                PBROWSER(1)

NAME
     pbrowser - Ports System Frontend

SYNOPSIS
     pbrowser [-avlhs] [-p PKG_PATH]

DESCRIPTION
     The pbrowser is a graphical frontend for the ports(7) system. It allows
     for easy browsing through the ports tree and offers search facilities to
     a certain extent (e.g. search for all packages which depend on package
     glib-2.0 etc.).

     pbrowser also allows the user to install either prebuilt packages or to
     install from the ports(7) system. There are also two possibilities for
     the removal of installed packages allowing the user to either remove a
     package with all of the packages which depend on it, or to quit the pro-
     cess of removal if other packages depend on the package to be removed.

     The options are as follows:

     -s           Use sudo(8) for execution of privileged operations (e.g. in-
                  stallation of packages resp. ports or the deletion of pack-
                  ages).

     -a           Always prompt the user for a password whenever a privileged
                  operation must be performed (the default is to ask the user
                  only once and then remember the password). This option has
                  no effect if option -s is enabled.

     -v           Be verbose and log to stdout.

     -l           Be verbose and output the list of all scanned packages to
                  stdout.

     -p PKG_PATH  Specifies a custom PKG_PATH to get the prebuilt packages
                  from. If no PKG_PATH is specified, prebuild packages are in-
                  stalled from the OpenBSD site.

     The pbrowser user interface uses gtk+ and the GObject object oriented
     framework. The implementation of non interface functions is independent
     of gtk+, so other user interfaces like ncurses could also be implemented
     in the future.

SEE ALSO
     ports(7), bsd.port.mk(5), pkg_add(1), pkg_delete(1), pkg_info(1), sudo(8)

HISTORY
     The pbrowser program first appeared in OpenBSD 3.5.

AUTHORS
     Igor Boehm <igor@bytelabs.org>

CAVEATS
     The glib header files do not pass lint and a way to get around that fact
     must be found.  The compiler spits out warnings about unused variables in
     some callback functions. Of course those warnings are correct, but the
     code has to stay as it is because of the nature of user data being passed
     to callack functions for some signals which are emitted by gtk+.

OpenBSD 4.1                   September 29, 2004                             1
