$NetBSD: patch-ac,v 1.1.1.1 2002/08/04 16:24:22 jschauma Exp $

--- /dev/null	Sun Aug  4 11:24:41 2002
+++ data/bbappconf.1.tmp	Sun Aug  4 11:52:41 2002
@@ -0,0 +1,112 @@
+.TH BBAPPCONF 1 "August 04, 2002" bbappconf "bbtools"
+.SH NAME
+bbappconf \- configure applications for blackbox
+
+.SH SYNOPSIS
+.B bbappconf
+[\fIOPTIONS\fR]
+
+.SH DESCRIPTION
+\fBbbappconf\fR is a tool to configure the behaviour of certain aspects of
+an application under the Blackbox window manager.
+
+.SH USAGE
+By default \fBbbappconf\fR reads the Blackbox style-file as defined in
+\fI$HOME/.blackboxrc\fR and copies as much of the style as possible. The
+result is an application which looks a lot like the toolbar.
+
+The \fI-geometry\fR is given as +x+y or -x-y (or combination)
+where -x-y is the (x,y) distance of the right bottom of screen
+to the right bottom of \fBbbappconf\fR.
+
+So \fI-geometry -0-0\fR puts the application in the lower right corner of the
+screen.
+
+.SH OPTIONS
+A summary of the options supported by \fBbbappconf\fR is included below.
+
+.TP
+\fB\-c[onfig]\fR \fIfilename\fR
+use alternate config file
+.TP
+.B \-d[ecorated]
+Show 'normal' decorated window
+.TP
+\fB\-display\fR \fIdisplay name\fR
+X server to connect to
+.TP
+\fB\-geom[etry]\fR \fIgeometry\fR
+Set geometry of window
+.TP
+\fB\-h[elp]\fR
+Show summary of options and exit.
+.TP
+\fB\-n[obb]\fR
+fall back on default configuration
+.TP
+\fB\-s[hape]\fR
+Don't display groundplate
+.TP
+\fB\-v[ersion]\fR
+Display version number
+.TP
+\fB\-w[ithdrawn]\fR
+Place bbtool in the Slit
+
+.SH CONFIGURATION
+To be able to do something with windows we first have to identify them.
+In bbappconf this is done using the X-Windows class hints.
+
+A class hints consists of the application name and class.
+Normally all windows of an application have the same class, different windows
+of an application can have different names.
+
+You can tell bbappconf to indentify a windows as follows:
+.br
+bbappconf.x.classHint.class:  class
+.br
+bbappconf.x.classHint.name:   name
+
+You should at least define one of these, if both are defined both should
+match.  If you want to find out the class/name of a window, use xprop, it will
+show you: WM_CLASS(STRING) = "name", "class"
+
+After you have identified an application window you can tell bbappconf what
+to do with it:
+.TP
+.I bbappconf.x.stick:
+true or false -- makes the window stick on all your desktops.
+.TP
+.I bbappconf.x.decorless:
+true or false -- removes all decorations from a window, like titlebars.
+.TP
+.I bbappconf.x.startOnWorkspace:
+1..number of workspaces -- tells \fBbbappconf\fR to start a window on a certain workspace.
+
+.SH EXAMPLES
+The configuration file shows some examples.
+
+.SH FILES
+.SS "Under Blackbox"
+.nf
+\fI@PREFIX@/share/bbtools/bbappconf.bb\fR the global configuration file
+\fI$HOME/.bbtools/bbappconf.bb\fR a local configuration file
+
+.SS "Under other Window managers"
+.nf
+\fI@PREFIX@/share/bbtools/bbappconf.nobb\fR the global configuration file
+\fI$HOME/.bbtools/bbappconf.nobb\fR a local configuration file
+
+.SH VERSION
+0.0.1-peak3
+
+.SH HISTORY
+\fBbbappconf\fR first appeared on the internet on October 17th, 2000
+
+.SH "SEE ALSO"
+.BR blackbox(1)
+
+.SH AUTHOR
+John Kennis <jkennis@chello.nl> - bbappconf
+.br
+Jan Schaumann <jschauma@netmeister.org> - this man page