1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
|
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 $sysconfdir/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.
|