mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-15 11:20:03 +00:00
118 lines
2.9 KiB
Groff
118 lines
2.9 KiB
Groff
.if t .ds 85 8\(12
|
|
.if n .ds 85 8-1/2
|
|
.TH 9wm 1
|
|
.SH NAME
|
|
9wm \- \*(85-like Window Manager for X
|
|
.SH SYNOPSIS
|
|
.B 9wm
|
|
[
|
|
.B \-grey
|
|
] [
|
|
.B \-version
|
|
] [
|
|
.B \-font
|
|
.I fname
|
|
] [
|
|
.B \-term
|
|
.I termprog
|
|
] [
|
|
.BR exit | restart
|
|
]
|
|
.SH DESCRIPTION
|
|
.I 9wm
|
|
is a window manager for X which attempts to emulate the window management
|
|
policies of Plan 9's
|
|
.I \*(85
|
|
window manager.
|
|
.PP
|
|
The
|
|
.B \-grey
|
|
option makes the background light grey, as does \*(85.
|
|
Use this option for maximum authenticity.
|
|
.B \-font
|
|
.I fname
|
|
sets the font in
|
|
.IR 9wm 's
|
|
menu to
|
|
.IR fname ,
|
|
overriding the default.
|
|
.B \-term
|
|
.I termprog
|
|
specifies an alternative program to run when the
|
|
.I New
|
|
menu item is selected.
|
|
.B \-version
|
|
prints the current version on standard error, then exits.
|
|
.PP
|
|
To make
|
|
.I 9wm
|
|
exit, you have to run
|
|
.B "9wm exit"
|
|
on the command line. There is no ``exit'' menu item.
|
|
.PP
|
|
.I 9wm
|
|
is click-to-type: it has a notion of the current window,
|
|
which is usually on top, and always has its border darkened.
|
|
Characters typed at the keyboard go to the current window,
|
|
and mouse clicks outside the current window are swallowed up
|
|
by
|
|
.IR 9wm .
|
|
To make another window the current one, click on it with button 1.
|
|
Unlike other X window managers, 9wm implements `mouse focus': mouse events
|
|
are sent only to the current window.
|
|
.PP
|
|
A menu of window operations is available by pressing button 3
|
|
outside the current window.
|
|
The first of these,
|
|
.IR New ,
|
|
attempts to spawn a
|
|
.I 9term
|
|
process (or
|
|
.I xterm
|
|
if
|
|
.I 9term
|
|
is not available).
|
|
The new
|
|
.I 9term
|
|
will request that its outline be swept using button 3
|
|
of the mouse, by changing the cursor.
|
|
.RI ( xterm
|
|
defaults to a fixed size, and thus wants to be dragged; pressing
|
|
button 3 places it.)
|
|
.PP
|
|
The next four menu items are
|
|
.IR Reshape ,
|
|
.IR Move ,
|
|
.IR Delete ,
|
|
and
|
|
.IR Hide .
|
|
All of the operations change the cursor into a target, prompting the user
|
|
to click button 3 on one of the windows to select it for the operation.
|
|
At this stage, clicking button 1 or 2 will abort the operation.
|
|
Otherwise, if the operation was
|
|
.IR Resize ,
|
|
the user is prompted to sweep out the new outline with button 3.
|
|
If it was
|
|
.IR Move ,
|
|
the user should keep the button held down after the initial click that selected
|
|
the window, and drag the window to the right place before releasing.
|
|
In either case, button 1 or 2 will abort the operation.
|
|
.PP
|
|
If the
|
|
.I Delete
|
|
operation is selected, the window will be deleted when the button is released.
|
|
This typically kills the client that owns the window.
|
|
The
|
|
.I Hide
|
|
operation just makes the window invisible. While hidden, the window's
|
|
name appears on the bottom of the button 3 menu. Selecting that item
|
|
brings the window back (unhides it).
|
|
This operation replaces the iconification feature provided by other
|
|
window managers.
|
|
.SH BUGS
|
|
Is not completely compatible with \*(85.
|
|
.PP
|
|
There is a currently a compiled-in limit of 32 hidden windows.
|
|
.SH "SEE ALSO"
|
|
.IR 9term (1),
|
|
.IR xterm (1).
|