bluetile-0.6: man/bluetile.1
.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
.el \{\
. de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "BLUETILE 1"
.TH BLUETILE 1 "2010-11-07" "perl v5.10.1" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
bluetile \- full\-featured tiling for the GNOME desktop environment
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
bluetile [\-\-help] [\-\-version] [\-\-restart]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBBluetile\fR is a tiling window manager designed to integrate with the
\&\s-1GNOME\s0 desktop environment. It provides both a traditional, stacking
layout mode as well as tiling layouts where windows are arranged to
use the entire screen without overlapping. \fBBluetile\fR tries to make the
tiling paradigm easily accessible to users coming from traditional
window managers by drawing on known conventions and providing both
mouse and keyboard access for all features.
.IP "\(bu" 4
Designed to integrate with the \s-1GNOME\s0 desktop environment
.IP "\(bu" 4
Hybrid approach: Stacking window layout & tiling layouts available
.IP "\(bu" 4
All features accessible from mouse, as well as keyboard
.IP "\(bu" 4
Maximizing & minimizing windows in all layouts
.IP "\(bu" 4
Good multihead support
.IP "\(bu" 4
Proper handling of fullscreen applications
.SH "OVERVIEW"
.IX Header "OVERVIEW"
To quickly get up and running just start \fBBluetile\fR from your current
window manager/desktop environment (preferably \s-1GNOME\s0). \fBBluetile\fR will
replace the currently running window manager (if the window manager
supports this) and start up.
.PP
One way to set up \fBBluetile\fR as your default window manager under \s-1GNOME\s0 is
to make sure that the environment variable \s-1WINDOW_MANAGER\s0 contains the
path to the \fBBluetile\fR binary before \s-1GNOME\s0 starts. This can be achieved by
putting something like the following line into ~/.gnomerc:
.PP
.Vb 1
\& export WINDOW_MANAGER=bluetile
.Ve
.PP
If you use a packaged version of \fBBluetile\fR, your distribution might
already provide you with a preconfigured xsession.
.SH "OPTIONS"
.IX Header "OPTIONS"
\&\fB\-\-help\fR print help message
.PP
\&\fB\-\-version\fR print the version number
.PP
\&\fB\-\-restart\fR request a running \fBBluetile\fR process to restart
.SH "KEYBOARD SHORTCUTS"
.IX Header "KEYBOARD SHORTCUTS"
This is a list of most keyboard shortcuts for \fBBluetile\fR:
.PP
.Vb 2
\& Win+Return Launch terminal
\& Win+p Launch GNOME "Run application" dialog
\&
\& Win+a Switch to stacking window layout
\& Win+s Switch to tiled horizontal layout
\& Win+d Switch to tiled vertical layout
\& Win+f Switch to fullscreen layout
\&
\& Win+j Move focus to the next window
\& Win+k Move focus to the previous window
\& Win+Space Move focus to the master window
\& Win+Shift+j Swap the focused window with the next window
\& Win+Shift+k Swap the focused window with the previous window
\& Win+Shift+Space Swap the focused window with the master window
\&
\& Win+h Shrink the master area
\& Win+l Expand the master area
\& Win+u Shrink a slave area
\& Win+i Expand a slave area
\& Win+, Increment the number of windows in the master area
\& Win+. Decrement the number of windows in the master area
\&
\& Win+Shift+c Close the focused window
\& Win+z Maximize/zoom focused window
\& Win+m Minimize focused window
\& Win+Shift+m Restore next minimized window
\& Win+o Show window menu for focused window
\& Win+t Push dialog window back into tiling
\& Win+b Toggle to previously displayed workspace
\&
\& Win+1 .. Win+9, Win+0
\& Switch to workspace N
\&
\& Win+Shift+1 .. Win+Shift+9, Win+Shift+0
\& Move client to workspace N
\&
\& Win+w, Win+e, Win+r
\& Switch to physical/Xinerama screens 1, 2 or 3
\&
\& Win+Shift+w, Win+Shift+e, Win+Shift+r
\& Move client to physical/Xinerama screen 1, 2 or 3
\&
\& Win+F5 Refresh layout
\& Win+Shift+q Quit Bluetile
.Ve
.SH "CONFIGURATION"
.IX Header "CONFIGURATION"
Edit the file ~/.bluetilerc to configure \fBBluetile\fR.
.SH "AUTHOR"
.IX Header "AUTHOR"
Jan Vornberger <jan.vornberger@informatik.uni\-oldenburg.de>