This file gives a short description of the configuration possibilities of
bbpager. For blackbox users, bbpager attempts to copy the look of blackbox to
help integrate itself visually in the blackbox environment. For all users,
bbpager provides a flexible mechanism for specifying configuration options.


** Configuring bbpager **
-------------------------

bbpager searches in several locations for its configuration options. In order
of precedence (that is, an option defined in a location listed higher on the
list will take precedence over an option defined lower on the list), these
locations are:

1) bbpager-specific options in the blackbox style file. The location of the
   blackbox style file is taken from the session.styleFile option in the
   blackbox configuration file. By default bbpager looks for the blackbox
   configuration file in $HOME/.blackboxrc, though an alternate location may be
   given with the bbpager command-line option called -bbconfig. Specifying
   bbpager-specific configuration options in the blackbox style file is useful
   if the user wants to change some aspect of bbpager from one blackbox style
   to another.

2) The bbpager configuration file specified by the -config command-line option.
   If the -config command-line option is given, then bbpager reads the options
   provided in the specified file and does NOT look for the local or global
   configuration files described in (3) and (4) below.

3) The user's local configuration file in $HOME/.bbtools/bbpager.rc . bbpager
   will look in this location only if the -config command-line option was not
   provided.

4) The global configuration file in $datadir/bbtools/bbpager.rc . bbpager will
   look in this location only if the -config command-line option was not
   provided.

5) blackbox options in the blackbox style file. From the style file, bbpager
   will copy several of the blackbox look-and-feel options and use them as
   defaults. These default values will be used unless the bbpager options are
   explicitly specified elsewhere. See "Visual Integration with Blackbox" below.

6) The bbpager source code, which contains last-resort values.


** Visual Integration with Blackbox **
----------------------------------------------

If the blackbox configuration file exists, bbpager will use the current blackbox
style to set a few of its default style options. Specifically, it will use the
following textures as defaults:

bbpager               blackbox
-------               --------
bbpager.frame         toolbar
bbpager.desktop       toolbar.label
bbpager.window        window.label.unfocus
bbpager.window.focus  window.label.focus


** Configuration Options **
---------------------------

Please see the the global configuration file for a complete list of the bbpager
configuration options and a description of each.
