.\" 
.\" $Id: bbkeys.1.in,v 1.6 2004/08/28 03:31:48 vanrijn Exp $
.\" 
.TH "BBKEYS" "1" "August 27, 2004" "vanRijn" "bbkeys"
.SH "NAME"
bbkeys \- a general XWindow keygrabber

.SH "SYNOPSIS"
.B bbkeys
[\fIOPTION\fR]

.SH "DESCRIPTION"
\fBbbkeys\fR is the keygrabber for the blackbox window manager. \fBbbkeys\fR
handles all keybindings and keyboard shortcuts for  blackbox. It uses
blackbox's Image classes for rendering its look and feel so that \fBbbkeys\fR
will render itself to match whatever blackbox style is used. It is highly
configurable either via the \fIbbconf\fR GUI utility or the (now deprecated)
\fIbbkeysconf\fR GUI utility or by hand\-editting bbkeys's config file.

.SH "USAGE"
On startup, \fBbbkeys\fR reads \fI$HOME/.bbkeysrc\fR, which you can edit by
hand or through \fIbbconf\fR or \fIbbkeysconf\fR. This is now configurable
through a command\-line switch as show in OPTIONS.

.SH "OPTIONS"
A summary of the options supported by \fBbbkeys\fR is included below.


.TP 
\fB\-d or \-\-display\fR \fI<display name>\fR
use alternate config file. (default is ~/.bbkeysrc)
.TP 
\fB\-D or \-\-debug\fR
print debugging information
.TP 
\fB\-c or \-\-config\fR \fI<filename>\fR
use alternate config file. (default is ~/.bbkeysrc)
.TP 
\fB\-v or \-\-version\fR
display version number and exit
.TP 
\fB\-h or \-\-help\fR
display help message

.SH "FILES"
.nr
Default: \fI$datadir=/usr/local/share/\fR
.br 
\fI$HOME/.bbkeysrc\fR maintains keybindings
.br 
See \fIbbkeysrc(5)\fR


.SH "VERSION"
@VERSION@

.SH "BUGS"
This application is perfect and should solve all of your problems,  up to and
including male pattern baldness and world hunger. Should you, against all
odds, find any bugs, please report them to the author.


.SH "SEE ALSO"
.BR bbkeysrc(5)


.SH "AUTHOR"
.nr
Jason 'vanRijn' Kasper <vR@movingparts.net> \- bbkeys
.br 
Jan Schaumann <jschauma@netmeister.org> \- this man page