mirror of https://github.com/0intro/wmii
Fix triggering of ClientFocus event. Switch to pseudo-LaTeX for wmii(1).
This commit is contained in:
Kris Maglione
parent
c094fe491c
commit
3b84423e32
|
|
@ -408,7 +408,5 @@ focus_area(Area *a) {
|
|||
write_event("FocusFloating\n");
|
||||
else
|
||||
write_event("ColumnFocus %d\n", i);
|
||||
if(a->frame)
|
||||
write_event("ClientFocus 0x%x\n", a->sel->client->w.w);
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -336,6 +336,8 @@ focus_client(Client *c) {
|
|||
else
|
||||
setfocus(screen->barwin, RevertToParent);
|
||||
|
||||
write_event("ClientFocus 0x%x\n", clientwin(c));
|
||||
|
||||
XSync(display, False);
|
||||
flushevents(FocusChangeMask, True);
|
||||
}
|
||||
|
|
|
|||
|
|
@ -370,9 +370,6 @@ focus_frame(Frame *f, Bool restack) {
|
|||
if(!a->floating && ((a->mode == Colstack) || (a->mode == Colmax)))
|
||||
arrange_column(a, False);
|
||||
|
||||
if((f != old) && (f->area == old_a))
|
||||
write_event("ClientFocus 0x%x\n", f->client->w.w);
|
||||
|
||||
if(restack)
|
||||
restack_view(v);
|
||||
}
|
||||
|
|
|
|||
|
|
@ -204,7 +204,7 @@ main(int argc, char **argv)
|
|||
if(fontname != nil) {
|
||||
font = XLoadQueryFont(dpy, fontname);
|
||||
if(font == nil)
|
||||
fprintf(stderr, "%s: warning: can't load font %s\n",
|
||||
fprintf(stderr, "%s: warning: can't load font '%s'\n",
|
||||
progname, fontname);
|
||||
}
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,9 @@
|
|||
TARG = `{make -VTARG}
|
||||
|
||||
default:V: all
|
||||
|
||||
all:V: $TARG
|
||||
|
||||
%.1: %.tex
|
||||
latex2man -M $stem.tex $stem.1
|
||||
|
||||
693
man/wmii.1
693
man/wmii.1
|
|
@ -1,320 +1,389 @@
|
|||
.TH WMII 1 wmii-VERSION
|
||||
'\" t
|
||||
.\" Manual page created with latex2man on Fri May 25 01:19:10 EDT 2007
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
||||
.de Vb
|
||||
.ft CW
|
||||
.nf
|
||||
..
|
||||
.de Ve
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
.TH "WMII\-VERSION" "1" "25 May 2007" "" ""
|
||||
.SH NAME
|
||||
wmii \(em window manager improved\(emimproved
|
||||
|
||||
.SH SYNOPSIS
|
||||
.B wmii
|
||||
.RB [ -a
|
||||
.IR <address> ]
|
||||
.RB [ -c
|
||||
.IR <wmiirc> ]
|
||||
|
||||
wmii
|
||||
[\fB\-a\fP\fI<address>\fP]
|
||||
[\fB\-c\fP\fI<wmiirc>\fP]
|
||||
.br
|
||||
.B wmii \-v
|
||||
|
||||
wmii
|
||||
\fB\-v\fP
|
||||
.PP
|
||||
.SH DESCRIPTION
|
||||
.PD 0
|
||||
.SS Overview
|
||||
.B wmii
|
||||
is a dynamic window manager for X11. In contrast to static window management
|
||||
the user rarely has to think about how to organize windows, no matter what he
|
||||
is doing or how many applications are used at the same time. The window manager
|
||||
adapts to the current environment and fits to the needs of the user, rather
|
||||
than forcing him to use a preset, fixed layout and trying to shoehorn all
|
||||
windows and applications into it.
|
||||
.P
|
||||
.B wmii
|
||||
supports classic and tiled window management with extended keyboard and mouse
|
||||
control. The classic window management arranges windows in a floating layer
|
||||
in which windows can be moved and resized freely. The tiled window management
|
||||
is based on columns which split up the screen horizontally. Each column handles
|
||||
arbitrary windows and arranges them vertically in a non\-overlapping way. They
|
||||
can then be moved and resized between and within columns at will.
|
||||
.P
|
||||
.B wmii
|
||||
provides a virtual filesystem which represents the internal state similar to
|
||||
the procfs of Unix operating systems. Modifying this virtual filesystem results
|
||||
in changing the state of the window manager. The virtual filesystem service can
|
||||
be accessed through 9P\-capable client programs, like
|
||||
.BR wmiir (1) .
|
||||
This allows simple and powerful remote control of the core window manager.
|
||||
.P
|
||||
.B wmii
|
||||
basically consists of clients, columns, views, and the bar, which are described
|
||||
in detail in the
|
||||
.B Terminology
|
||||
section.
|
||||
|
||||
.SS Terminology
|
||||
.TP 2
|
||||
Display
|
||||
A running X server instance consisting of input devices and screens.
|
||||
.TP 2
|
||||
Screen
|
||||
A physical or virtual (Xinerama or
|
||||
.BR Xnest (1))
|
||||
screen of an X display. A screen displays a bar window and a view at a time.
|
||||
.TP 2
|
||||
Window
|
||||
A (rectangular) drawable X object which is displayed on a screen, usually an
|
||||
application window.
|
||||
.TP 2
|
||||
Client
|
||||
An application window surrounded by a frame window containing a border and a
|
||||
title\-bar.
|
||||
.TP 2
|
||||
Floating layer
|
||||
A screen layer of
|
||||
.B wmii
|
||||
on top of all other layers, where clients are arranged in a classic (floating)
|
||||
way. They can be resized or moved freely.
|
||||
.TP 2
|
||||
Managed layer
|
||||
A screen layer of
|
||||
.B wmii
|
||||
behind the floating layer, where clients are arranged in a non\-overlapping
|
||||
(managed) way. Here, the window manager dynamically assigns each client a
|
||||
size and position. The managed layer consists of columns.
|
||||
.TP 2
|
||||
Tag
|
||||
Alphanumeric strings which can be assigned to a client. This provides a
|
||||
mechanism to group clients with similar properties. Clients can have one
|
||||
tag, e.g.
|
||||
.IR work ,
|
||||
or several tags, e.g.
|
||||
.IR work+mail .
|
||||
Tags are separated with the
|
||||
.I +
|
||||
character.
|
||||
.TP 2
|
||||
View
|
||||
A set of clients containing a specific tag, quite similiar to a workspace in
|
||||
other window managers. It consists of the floating and managed layers.
|
||||
.TP 2
|
||||
Column
|
||||
A column is a screen area which arranges clients vertically in a
|
||||
non\-overlapping way. Columns provide three different modes, which arrange
|
||||
clients with equal size, stacked, or maximized respectively. Clients can be
|
||||
moved and resized between and within columns freely.
|
||||
.TP 2
|
||||
Bar
|
||||
The bar at the bottom of the screen displays a label for each view and
|
||||
allows the creation of arbitrary user\-defined labels.
|
||||
.TP 2
|
||||
Event
|
||||
An event is a message which can be read from a special file in the filesystem
|
||||
of
|
||||
.BR wmii ,
|
||||
such as a mouse button press, a key press, or a message written by a different
|
||||
9P\-client.
|
||||
.SS Basic window management
|
||||
Running a raw
|
||||
.B wmii
|
||||
process without a
|
||||
.BR wmiirc (1)
|
||||
script provides basic window management capabilities already. However, to use
|
||||
it effectively, remote control through its filesystem interface is necessary.
|
||||
By default it is only usable with the mouse in conjunction with the
|
||||
.I Mod1 (Alt)
|
||||
modifier key. Other interactions, such as customizing the style, killing or
|
||||
retagging clients, and grabbing keys, cannot be achieved without accessing the
|
||||
filesystem.
|
||||
.P
|
||||
The filesystem can be accessed by connecting to the
|
||||
.I address
|
||||
of
|
||||
.B wmii
|
||||
with any 9P\-capable client, such as
|
||||
.BR wmiir (1).
|
||||
.PP
|
||||
.SS OVERVIEW
|
||||
.PP
|
||||
wmii
|
||||
is a dynamic window manager for X11. In contrast to
|
||||
static window management the user rarely has to think about how to
|
||||
organize windows, no matter what he is doing or how many
|
||||
applications are used at the same time. The window manager adapts
|
||||
to the current environment and fits to the needs of the user, rather
|
||||
than forcing him to use a preset, fixed layout and trying to
|
||||
shoehorn all windows and applications into it.
|
||||
.PP
|
||||
wmii
|
||||
supports classic and tiled window management with
|
||||
extended keyboard and mouse control. The classic window management
|
||||
arranges windows in a floating layer in which windows can be moved
|
||||
and resized freely. The tiled window management is based on columns
|
||||
which split up the screen horizontally. Each column handles
|
||||
arbitrary windows and arranges them vertically in a nonoverlapping
|
||||
way. They can then be moved and resized between and within columns
|
||||
at will.
|
||||
.PP
|
||||
wmii
|
||||
provides a virtual filesystem which represents the
|
||||
internal state similar to the procfs of Unix operating systems.
|
||||
Modifying this virtual filesystem results in changing the state of
|
||||
the window manager. The virtual filesystem service can be accessed
|
||||
through 9Pcapable client programs, like \fIwmiir\fP(1)\&.
|
||||
This
|
||||
allows simple and powerful remote control of the core window
|
||||
manager.
|
||||
.PP
|
||||
wmii
|
||||
basically consists of clients, columns, views, and the
|
||||
bar, which are described in detail in the \fBTerminology\fP
|
||||
section.
|
||||
.PP
|
||||
.SS TERMINOLOGY
|
||||
.PP
|
||||
.TP
|
||||
Display
|
||||
A running X server instance consisting of input devices
|
||||
and screens.
|
||||
.TP
|
||||
Screen
|
||||
A physical or virtual (Xinerama or \fIXnest\fP(1))
|
||||
screen
|
||||
of an X display. A screen displays a bar window and a view at a time.
|
||||
.TP
|
||||
Window
|
||||
A (rectangular) drawable X object which is displayed on a
|
||||
screen, usually an application window.
|
||||
.TP
|
||||
Client
|
||||
An application window surrounded by a frame window containing
|
||||
a border and a titlebar.
|
||||
.TP
|
||||
Floating layer
|
||||
A screen layer of wmii
|
||||
on top of all other
|
||||
layers, where clients are arranged in a classic (floating) way.
|
||||
They can be resized or moved freely.
|
||||
.TP
|
||||
Managed layer
|
||||
A screen layer of wmii
|
||||
behind the floating layer,
|
||||
where clients are arranged in a nonoverlapping (managed) way. Here,
|
||||
the window manager dynamically assigns each client a size and position.
|
||||
The managed layer consists of columns.
|
||||
.TP
|
||||
Tag
|
||||
Alphanumeric strings which can be assigned to a client. This provides
|
||||
a mechanism to group clients with similar properties. Clients can have one
|
||||
tag, e.g. \fIwork\fP,
|
||||
or several tags, e.g. \fIwork+mail\fP\&.
|
||||
.PP
|
||||
Tags are separated with the \fI+\fP
|
||||
character.
|
||||
.TP
|
||||
View
|
||||
A set of clients containing a specific tag, quite similiar to a
|
||||
workspace in other window managers. It consists of the floating and
|
||||
managed layers.
|
||||
.TP
|
||||
Column
|
||||
A column is a screen area which arranges clients vertically in a
|
||||
non\-overlapping way. Columns provide three different modes, which
|
||||
arrange clients with equal size, stacked, or maximized respectively.
|
||||
Clients can be moved and resized between and within columns freely.
|
||||
.TP
|
||||
Bar
|
||||
The bar at the bottom of the screen displays a label for each view and
|
||||
allows the creation of arbitrary userdefined labels.
|
||||
.TP
|
||||
Event
|
||||
An event is a message which can be read from a special file in the
|
||||
filesystem of wmii,
|
||||
such as a mouse button press, a key press, or
|
||||
a message written by a different 9P\-client.
|
||||
.PP
|
||||
.SS BASIC WINDOW MANAGEMENT
|
||||
.PP
|
||||
Running a raw wmii
|
||||
process without a \fIwmiirc\fP(1)
|
||||
script
|
||||
provides basic window management capabilities already. However, to
|
||||
use it effectively, remote control through its filesystem interface
|
||||
is necessary. By default it is only usable with the mouse in
|
||||
conjunction with the \fIMod1 (Alt)\fP
|
||||
modifier key. Other
|
||||
interactions, such as customizing the style, killing or retagging
|
||||
clients, and grabbing keys, cannot be achieved without accessing the
|
||||
filesystem.
|
||||
.PP
|
||||
The filesystem can be accessed by connecting to the \fIaddress\fP
|
||||
of wmii
|
||||
with any 9P\-capable client, such as \fIwmiir\fP(1)
|
||||
.PP
|
||||
.SS ACTIONS
|
||||
.PP
|
||||
An action is a shell script in the default setup, but it can
|
||||
actually be any executable file. It is executed usually by
|
||||
selecting it from the actions menu. You can customize an action by
|
||||
copying it from the global action directory
|
||||
CONFPREFIX/wmii\-3.5
|
||||
to $HOME/.wmii\-3.5
|
||||
and then
|
||||
editing the copy to fit your needs. Of course you can also create
|
||||
your own actions there; make sure that they are executable.
|
||||
.PP
|
||||
Here is a list of the default actions:
|
||||
.PP
|
||||
.TS
|
||||
tab(&) expand;
|
||||
l lS.
|
||||
T{
|
||||
quit
|
||||
T}&T{
|
||||
leave the window manager nicely
|
||||
T}
|
||||
T{
|
||||
status
|
||||
T}&T{
|
||||
periodically print date and load average to the bar
|
||||
T}
|
||||
T{
|
||||
welcome
|
||||
T}&T{
|
||||
display a welcome message that contains the wmii tutorial
|
||||
T}
|
||||
T{
|
||||
wmiirc
|
||||
T}&T{
|
||||
configure wmii
|
||||
T}
|
||||
.TE
|
||||
.PP
|
||||
.SS DEFAULT KEY BINDINGS
|
||||
.SS Moving Around
|
||||
.PP
|
||||
.TS
|
||||
tab(&) expand;
|
||||
l lS.
|
||||
T{
|
||||
\fBKey\fP
|
||||
T}&T{
|
||||
\fBAction\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-h
|
||||
T}&T{
|
||||
Move to a window to the \fIleft\fP
|
||||
of the one currently
|
||||
focused
|
||||
T}
|
||||
T{
|
||||
Mod\-l
|
||||
T}&T{
|
||||
Move to a window to the \fIright\fP
|
||||
of the one currently
|
||||
focused
|
||||
T}
|
||||
T{
|
||||
Mod\-j
|
||||
T}&T{
|
||||
Move to the window \fIbelow\fP
|
||||
the one currently focused
|
||||
T}
|
||||
T{
|
||||
Mod\-k
|
||||
T}&T{
|
||||
Move to a window \fIabove\fP
|
||||
the one currently focused
|
||||
T}
|
||||
T{
|
||||
Mod\-space
|
||||
T}&T{
|
||||
Toggle between the managed and floating layers
|
||||
T}
|
||||
T{
|
||||
Mod\-t \fItag\fP
|
||||
T}&T{
|
||||
Move to the view of the given \fItag\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-\fI[0\-9]\fP
|
||||
T}&T{
|
||||
Move to the view with the given number
|
||||
T}
|
||||
.TE
|
||||
.PP
|
||||
.SS Moving Things Around
|
||||
.PP
|
||||
.TS
|
||||
tab(&) expand;
|
||||
l lS.
|
||||
T{
|
||||
\fBKey\fP
|
||||
T}&T{
|
||||
\fBAction\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-Shift\-h
|
||||
T}&T{
|
||||
Move the current window \fIwindow\fP
|
||||
to a
|
||||
column on the \fIleft\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-Shift\-l
|
||||
T}&T{
|
||||
Move the current window to a column
|
||||
on the \fIright\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-Shift\-j
|
||||
T}&T{
|
||||
Move the current window below the window
|
||||
beneath it.
|
||||
T}
|
||||
T{
|
||||
Mod\-Shift\-k
|
||||
T}&T{
|
||||
Move the current window above the window
|
||||
above it.
|
||||
T}
|
||||
T{
|
||||
Mod\-Shift\-space
|
||||
T}&T{
|
||||
Toggle the current window between the
|
||||
managed and floating layer
|
||||
T}
|
||||
T{
|
||||
Mod\-Shift\-t \fItag\fP
|
||||
T}&T{
|
||||
Move the current window to the
|
||||
view of the given \fItag\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-Shift\-\fI[0\-9]\fP
|
||||
T}&T{
|
||||
Move to the current window to the
|
||||
view with the given number
|
||||
T}
|
||||
.TE
|
||||
.PP
|
||||
.SS Miscellaneous
|
||||
.PP
|
||||
.TS
|
||||
tab(&) expand;
|
||||
l lS.
|
||||
T{
|
||||
\fBKey\fP
|
||||
T}&T{
|
||||
\fBAction\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-m
|
||||
T}&T{
|
||||
Switch the current column to \fImax mode\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-s
|
||||
T}&T{
|
||||
Switch the current column to \fIstack mode\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-d
|
||||
T}&T{
|
||||
Switch the current column to \fIdefault mode\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-Shift\-c
|
||||
T}&T{
|
||||
Kill
|
||||
the selected client
|
||||
T}
|
||||
T{
|
||||
Mod\-p \fIprogram\fP
|
||||
T}&T{
|
||||
Execute
|
||||
\fIprogram\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-a \fIaction\fP
|
||||
T}&T{
|
||||
Execute
|
||||
the named \fIaction\fP
|
||||
T}
|
||||
T{
|
||||
Mod\-Enter
|
||||
T}&T{
|
||||
Execute
|
||||
an xterm
|
||||
T}
|
||||
.TE
|
||||
.PP
|
||||
.SH CONFIGURATION
|
||||
|
||||
.SS Actions
|
||||
An action is a shell script in the default setup, but it can actually be
|
||||
any executable file. It is executed usually by selecting it from the
|
||||
actions menu.
|
||||
You can customize an action by copying it from the global action
|
||||
directory CONFPREFIX/wmii-3.5 to $HOME/.wmii-3.5 and then editing the copy to
|
||||
fit your needs. Of course you can also create your own actions there; make
|
||||
sure that they are executable.
|
||||
.P
|
||||
Here is a list of the default actions:
|
||||
.TP 2
|
||||
quit
|
||||
leave the window manager nicely
|
||||
.TP 2
|
||||
status
|
||||
periodically print date and load average to the bar
|
||||
.TP 2
|
||||
welcome
|
||||
display a welcome message that contains the wmii tutorial
|
||||
.TP 2
|
||||
wmiirc
|
||||
configure wmii
|
||||
.SS Default Key Bindings
|
||||
.PD 0
|
||||
.B Moving Around
|
||||
.RS 2
|
||||
.TP 16
|
||||
.I Key
|
||||
.I Action
|
||||
.TP
|
||||
.B Mod-h
|
||||
Move to a
|
||||
.B window
|
||||
to the
|
||||
.B left
|
||||
of the one currently focused
|
||||
.TP
|
||||
.B Mod-l
|
||||
Move to a
|
||||
.B window
|
||||
to the
|
||||
.B right
|
||||
of the one currently focused
|
||||
.TP
|
||||
.B Mod-j
|
||||
Move to a
|
||||
.B window below
|
||||
the one currently focused
|
||||
.TP
|
||||
.B Mod-k
|
||||
Move to a
|
||||
.B window above
|
||||
the one currently focused
|
||||
.TP
|
||||
.B Mod-space
|
||||
.B Toggle
|
||||
between the managed and floating
|
||||
.B layer
|
||||
.TP
|
||||
.BI Mod-t \ tag
|
||||
Move to the
|
||||
.B view
|
||||
of the given
|
||||
.I tag
|
||||
.TP
|
||||
.B Mod-[0-9]
|
||||
Move to the
|
||||
.B view
|
||||
with the given number
|
||||
.PD 1
|
||||
.P
|
||||
.RE
|
||||
.B Moving Things Around
|
||||
.RS 2
|
||||
.PD 0
|
||||
.TP 16
|
||||
.I Key
|
||||
.I Action
|
||||
.TP
|
||||
.B Mod-Shift-h
|
||||
Move the current window
|
||||
.B window
|
||||
to a column on the
|
||||
.B left
|
||||
.TP
|
||||
.B Mod-Shift-l
|
||||
Move the current window
|
||||
.B window
|
||||
to a column on the
|
||||
.B right
|
||||
.TP
|
||||
.B Mod-Shift-j
|
||||
Move the current
|
||||
.B window below
|
||||
the one beneath it
|
||||
.TP
|
||||
.B Mod-Shift-k
|
||||
Move the current
|
||||
.B window above
|
||||
the one above it
|
||||
.TP
|
||||
.B Mod-Shift-space
|
||||
.B Toggle
|
||||
the current
|
||||
.B window
|
||||
between the managed and floating
|
||||
.B layer
|
||||
.TP
|
||||
.BI Mod-Shift-t \ tag
|
||||
Move the current window to the
|
||||
.B view
|
||||
of the given
|
||||
.I tag
|
||||
.TP
|
||||
.B Mod-Shift-[0-9]
|
||||
Move to the current window to the
|
||||
.B view
|
||||
with the given number
|
||||
.PD 1
|
||||
.P
|
||||
.RE
|
||||
.B Miscellaneous
|
||||
.RS 2
|
||||
.PD 0
|
||||
.TP 16
|
||||
.I Key
|
||||
.I Action
|
||||
.TP
|
||||
.B Mod-m
|
||||
Switch the current column to
|
||||
.B max mode
|
||||
.TP
|
||||
.B Mod-s
|
||||
Switch the current column to
|
||||
.B stack mode
|
||||
.TP
|
||||
.B Mod-d
|
||||
Switch the current column to
|
||||
.B default mode
|
||||
.TP
|
||||
.B Mod-Shift-c
|
||||
.B Kill
|
||||
the selected client
|
||||
.TP
|
||||
.BI Mod-p \ program
|
||||
.B Execute
|
||||
.I program
|
||||
.TP
|
||||
.BI Mod-a \ action
|
||||
Execute the
|
||||
.B named action
|
||||
.TP
|
||||
.B Mod-Enter
|
||||
Start an
|
||||
.B xterm
|
||||
|
||||
.SS Configuration
|
||||
If you feel the need to change the default configuration, then customize (as
|
||||
described above) the
|
||||
.B wmiirc
|
||||
action. This action is executed at the end of the
|
||||
.B wmii
|
||||
script and does all the work of setting up the window manager, the key
|
||||
bindings, the bar labels, etc.
|
||||
.PP
|
||||
If you feel the need to change the default configuration, then
|
||||
customize (as described above) the wmiirc
|
||||
action. This
|
||||
action is executed at the end of the wmii
|
||||
script and does all
|
||||
the work of setting up the window manager, the key bindings, the bar
|
||||
labels, etc.
|
||||
.PP
|
||||
.SH FILES
|
||||
.TP
|
||||
/tmp/ns.$USER.${DISPLAY%.0}/wmii
|
||||
The wmii socket file which provides a 9P service.
|
||||
.TP
|
||||
CONFPREFIX/wmii-3.5
|
||||
Global action directory.
|
||||
.TP
|
||||
$HOME/.wmii-3.5
|
||||
User-specific action directory. Actions are first searched here.
|
||||
.SH ENVIRONMENT
|
||||
.TP
|
||||
HOME, DISPLAY
|
||||
See the section
|
||||
.B FILES
|
||||
above.
|
||||
.P
|
||||
The following variables are set and exported within
|
||||
.B wmii
|
||||
and thus can be used in actions:
|
||||
.TP
|
||||
WMII_ADDRESS
|
||||
Socket file of
|
||||
Used by
|
||||
.BR wmiir (1).
|
||||
.SH SEE ALSO
|
||||
.BR dmenu (1),
|
||||
.BR wmiir (1)
|
||||
|
||||
.PP
|
||||
.TP
|
||||
/tmp/ns.USER.{DISPLAY%\&.0}/wmii
|
||||
The wmii socket file which provides a 9P service.
|
||||
.TP
|
||||
CONFPREFIX/wmii\-3.5
|
||||
Global action directory.
|
||||
.TP
|
||||
$HOME/.wmii\-3.5
|
||||
User\-specific action directory. Actions are first searched here.
|
||||
.PP
|
||||
.SH ENVIRONMENT
|
||||
|
||||
.PP
|
||||
.TP
|
||||
HOME, DISPLAY
|
||||
See the section \fBFILES\fP
|
||||
above.
|
||||
.PP
|
||||
The following variables are set and exported within wmii
|
||||
and
|
||||
thus can be used in actions:
|
||||
.PP
|
||||
.TP
|
||||
WMII_ADDRESS
|
||||
Socket file of Used by \fIwmiir\fP(1)\&.
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
|
||||
\fIdmenu\fP(1),
|
||||
\fIwmiir\fP(1)
|
||||
.PP
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,188 @@
|
|||
\begin{Name}{1}{wmii-VERSION}{Kris Maglione}{}{wmii - window manager improved, improved}
|
||||
\section{SYNOPSIS}
|
||||
\Prog{wmii} \oOptArg{-a}{<address>} \oOptArg{-c}{<wmiirc>} \\
|
||||
\Prog{wmii} \Opt{-v}
|
||||
|
||||
\section{DESCRIPTION}
|
||||
|
||||
\subsection{Overview}
|
||||
|
||||
\Prog{wmii} is a dynamic window manager for X11. In contrast to
|
||||
static window management the user rarely has to think about how to
|
||||
organize windows, no matter what he is doing or how many
|
||||
applications are used at the same time. The window manager adapts
|
||||
to the current environment and fits to the needs of the user, rather
|
||||
than forcing him to use a preset, fixed layout and trying to
|
||||
shoehorn all windows and applications into it.
|
||||
|
||||
\Prog{wmii} supports classic and tiled window management with
|
||||
extended keyboard and mouse control. The classic window management
|
||||
arranges windows in a floating layer in which windows can be moved
|
||||
and resized freely. The tiled window management is based on columns
|
||||
which split up the screen horizontally. Each column handles
|
||||
arbitrary windows and arranges them vertically in a non\-overlapping
|
||||
way. They can then be moved and resized between and within columns
|
||||
at will.
|
||||
|
||||
\Prog{wmii} provides a virtual filesystem which represents the
|
||||
internal state similar to the procfs of Unix operating systems.
|
||||
Modifying this virtual filesystem results in changing the state of
|
||||
the window manager. The virtual filesystem service can be accessed
|
||||
through 9P\-capable client programs, like \Cmd{wmiir}{1}. This
|
||||
allows simple and powerful remote control of the core window
|
||||
manager.
|
||||
|
||||
\Prog{wmii} basically consists of clients, columns, views, and the
|
||||
bar, which are described in detail in the \textbf{Terminology}
|
||||
section.
|
||||
|
||||
\subsection{Terminology}
|
||||
|
||||
\begin{description}
|
||||
\item[Display] A running X server instance consisting of input devices
|
||||
and screens.
|
||||
\item[Screen] A physical or virtual (Xinerama or \Cmd{Xnest}{1}) screen
|
||||
of an X display. A screen displays a bar window and a view at a time.
|
||||
\item[Window] A (rectangular) drawable X object which is displayed on a
|
||||
screen, usually an application window.
|
||||
\item[Client] An application window surrounded by a frame window containing
|
||||
a border and a titlebar.
|
||||
\item[Floating layer] A screen layer of \Prog{wmii} on top of all other
|
||||
layers, where clients are arranged in a classic (floating) way.
|
||||
They can be resized or moved freely.
|
||||
\item[Managed layer] A screen layer of \Prog{wmii} behind the floating layer,
|
||||
where clients are arranged in a non\-overlapping (managed) way. Here,
|
||||
the window manager dynamically assigns each client a size and position.
|
||||
The managed layer consists of columns.
|
||||
\item[Tag] Alphanumeric strings which can be assigned to a client. This provides
|
||||
a mechanism to group clients with similar properties. Clients can have one
|
||||
tag, e.g. \emph{work}, or several tags, e.g. \emph{work+mail}.
|
||||
|
||||
Tags are separated with the \emph{+} character.
|
||||
\item[View] A set of clients containing a specific tag, quite similiar to a
|
||||
workspace in other window managers. It consists of the floating and
|
||||
managed layers.
|
||||
\item[Column] A column is a screen area which arranges clients vertically in a
|
||||
non-overlapping way. Columns provide three different modes, which
|
||||
arrange clients with equal size, stacked, or maximized respectively.
|
||||
Clients can be moved and resized between and within columns freely.
|
||||
\item[Bar] The bar at the bottom of the screen displays a label for each view and
|
||||
allows the creation of arbitrary user\-defined labels.
|
||||
\item[Event] An event is a message which can be read from a special file in the
|
||||
filesystem of \Prog{wmii}, such as a mouse button press, a key press, or
|
||||
a message written by a different 9P-client.
|
||||
\end{description}
|
||||
|
||||
\subsection{Basic window management}
|
||||
|
||||
Running a raw \Prog{wmii} process without a \Cmd{wmiirc}{1} script
|
||||
provides basic window management capabilities already. However, to
|
||||
use it effectively, remote control through its filesystem interface
|
||||
is necessary. By default it is only usable with the mouse in
|
||||
conjunction with the \emph{Mod1 (Alt)} modifier key. Other
|
||||
interactions, such as customizing the style, killing or retagging
|
||||
clients, and grabbing keys, cannot be achieved without accessing the
|
||||
filesystem.
|
||||
|
||||
The filesystem can be accessed by connecting to the \emph{address}
|
||||
of \Prog{wmii} with any 9P-capable client, such as \Cmd{wmiir}{1}
|
||||
|
||||
\subsection{Actions}
|
||||
|
||||
An action is a shell script in the default setup, but it can
|
||||
actually be any executable file. It is executed usually by
|
||||
selecting it from the actions menu. You can customize an action by
|
||||
copying it from the global action directory
|
||||
\File{CONFPREFIX/wmii-3.5} to \File{\$HOME/.wmii-3.5} and then
|
||||
editing the copy to fit your needs. Of course you can also create
|
||||
your own actions there; make sure that they are executable.
|
||||
|
||||
Here is a list of the default actions:
|
||||
|
||||
\begin{Table}[]{2}
|
||||
quit & leave the window manager nicely \\
|
||||
status & periodically print date and load average to the bar \\
|
||||
welcome & display a welcome message that contains the wmii tutorial \\
|
||||
wmiirc & configure wmii \\
|
||||
\end{Table}
|
||||
|
||||
\subsection{Default Key Bindings}
|
||||
\subsubsection{Moving Around}
|
||||
\begin{Table}[]{2}
|
||||
\textbf{Key} & \textbf{Action} \\
|
||||
Mod-h & Move to a window to the \emph{left} of the one currently
|
||||
focused \\
|
||||
Mod-l & Move to a window to the \emph{right} of the one currently
|
||||
focused \\
|
||||
Mod-j & Move to the window \emph{below} the one currently focused \\
|
||||
Mod-k & Move to a window \emph{above} the one currently focused \\
|
||||
Mod-space & Toggle between the managed and floating layers \\
|
||||
Mod-t \emph{tag} & Move to the view of the given \emph{tag} \\
|
||||
Mod-\emph{[0-9]} & Move to the view with the given number \\
|
||||
\end{Table}
|
||||
|
||||
\subsubsection{Moving Things Around}
|
||||
\begin{Table}[]{2}
|
||||
\textbf{Key} & \textbf{Action} \\
|
||||
Mod-Shift-h & Move the current window \emph{window} to a
|
||||
column on the \emph{left} \\
|
||||
Mod-Shift-l & Move the current window to a column
|
||||
on the \emph{right} \\
|
||||
Mod-Shift-j & Move the current window below the window
|
||||
beneath it. \\
|
||||
Mod-Shift-k & Move the current window above the window
|
||||
above it. \\
|
||||
Mod-Shift-space & Toggle the current window between the
|
||||
managed and floating layer \\
|
||||
Mod-Shift-t \emph{tag} & Move the current window to the
|
||||
view of the given \emph{tag} \\
|
||||
Mod-Shift-\emph{[0-9]} & Move to the current window to the
|
||||
view with the given number \\
|
||||
\end{Table}
|
||||
|
||||
\subsubsection{Miscellaneous}
|
||||
\begin{Table}[]{2}
|
||||
\textbf{Key} & \textbf{Action} \\
|
||||
Mod-m & Switch the current column to \emph{max mode} \\
|
||||
Mod-s & Switch the current column to \emph{stack mode} \\
|
||||
Mod-d & Switch the current column to \emph{default mode} \\
|
||||
Mod-Shift-c & \Prog{Kill} the selected client \\
|
||||
Mod-p \emph{program} & \Prog{Execute} \emph{program} \\
|
||||
Mod-a \emph{action} & \Prog{Execute} the named \emph{action} \\
|
||||
Mod-Enter & \Prog{Execute} an \Prog{xterm} \\
|
||||
\end{Table}
|
||||
|
||||
\section{Configuration}
|
||||
|
||||
If you feel the need to change the default configuration, then
|
||||
customize (as described above) the \Prog{wmiirc} action. This
|
||||
action is executed at the end of the \Prog{wmii} script and does all
|
||||
the work of setting up the window manager, the key bindings, the bar
|
||||
labels, etc.
|
||||
|
||||
\section{FILES}
|
||||
|
||||
\begin{description}
|
||||
\item[/tmp/ns.$USER.${DISPLAY\%.0}/wmii] The wmii socket file which provides a 9P service.
|
||||
\item[CONFPREFIX/wmii-3.5] Global action directory.
|
||||
\item[\$HOME/.wmii-3.5] User-specific action directory. Actions are first searched here.
|
||||
\end{description}
|
||||
|
||||
\section{ENVIRONMENT}
|
||||
|
||||
\begin{description}
|
||||
\item[HOME, DISPLAY] See the section \textbf{FILES} above.
|
||||
\end{description}
|
||||
|
||||
The following variables are set and exported within \Prog{wmii} and
|
||||
thus can be used in actions:
|
||||
|
||||
\begin{description}
|
||||
\item[WMII\_ADDRESS] Socket file of Used by \Cmd{wmiir}{1}.
|
||||
\end{description}
|
||||
|
||||
\section{SEE ALSO}
|
||||
\Cmd{dmenu}{1}, \Cmd{wmiir}{1}
|
||||
|
||||
\end{Name}
|
||||
|
||||
Loading…
Reference in New Issue