da1138cca5
an application under the Blackbox window manager, into pkgsrc using files provided by Anthony Mallet <anthony dot mallet at useless-ficus dot net> in PR pkg/17831 with minor modifications by myself.
117 lines
3.3 KiB
Text
117 lines
3.3 KiB
Text
$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
|