⟦38df5b9de⟧

TextFile

.TH WM local wm
.SH NAME
wm \- window manager
.SH SYNOPSIS
.B wm
[ \fB\-n\fP ]  [ \fB\-f\fP rfile ]
.SH DESCRIPTION
.I Wm
manages a collection of windows on a display terminal.
.PP
It determines what type of terminal you are using from
the environment parameter $TERM
(see
.IR environ (5))
and then uses
.IR curses (3)
to adapt to it.
.PP
Each window has its own UNIX shell
(as specified by the environment parameter $SHELL;
the default is
.IR sh (1)),
running in parallel with those in the other windows.
The idea behind this scheme is that you can use each window
for a series of commands dealing with a single topic.
Then, you can change back and forth between the windows without
losing your place in any of them.
.PP
At any time, you can give commands to change the window you are typing in,
to move a window or change its size,
or to create or kill a window.
Windows can overlap or completely obscure one another.
Obscured windows can subsequently be "lifted" up
and placed on top of the other windows.
When a window is partially or completely obscured,
subsequent output to that window will be held until the window
becomes completely visible again, effectively suspending the job
running in the obscured window.
.PP
When the program is started,
it will attempt to restore the sizes and positions of the windows
in use when you last ran
.IR wm
(unless you use
.B \-n
option).
If you give the
.B \-f
.I rfile
option,
.I wm
tries to restore windows from the file
.I rfile.
Otherwise, it first tries the file
.I .wmrc
in the current directory,
then, if necessary,
.I .wmrc
in your home directory.
Failing all this,
.I wm
will give you a window the size of your screen.
Now, you can type UNIX commands in the new window.
.PP
.I Wm
commands can be issued at any time.
Every
.I wm
command consists of a prefix character \fI<wm-esc>\fP followed by one
more character, possibly followed by some arguments.
Any other characters typed on the terminal are treated as input
to the program in the current window.
To enter \fI<wm-esc>\fP itself as input to a program, type it twice.
The \fI<wm-esc>\fP is initially set to ASCII ESC, but there is
a command for changing it.
.PP
The available
.I wm
commands are \fI<wm-esc>\fP followed by:
.IP \fBn\fP
Create a new window.
To do this, move the cursor to the position you want the
lower left corner of your window
to occupy,
using the keys
.B k
(up),
.B j
(down),
.B h
(left), and
.B l
(right)
and also
.BR K ,
.BR J ,
.BR H ,
and
.B L
(for large increments in the respective directions).
Then type an
.BR x .
Then move the cursor (using the same commands) to the upper
right corner, and type another
.BR x .
.IP \fBi\fP
Identify each window by outlining it with its window number
(each window has a one digit name, e.g.
#\fB1\fP, #\fB2\fP, #\fB3\fP,
used in referring to that window).
.IP \fIdigit\fP
Change the current window.
The named window is placed on "top" of the screen
(that is, in front of any other windows that had been obscuring it).
Input from the keyboard will now be sent to this window.
(Delayed responses to commands entered in other windows will,
of course, continue to be routed to their correct windows.)
.IP \fBl\fP
Change to the last-used window.
Change back to the window that had most recently been the current window.
.IP \fBm\fP
Move and/or change the size of the current window.
.I Wm
asks for the lower left and upper right corners of desired
new position of the window (same convention as for new windows).
It is not advisable to move a window except when
the program running in it is at the shell prompt level.
In particular, screen-oriented programs such as
.I vi
can get very confused if their window size is changed while they are running.
.IP \fBt\fP
Reset the environment variables $TERM and $TERMCAP for the current window.
This may be necessary if these variables get unset or scrambled,
for instance during a remote login.
This command should only be invoked when
the program running in it is at the shell prompt level because
it operates by sending commands to the shell as if
they were typed in from the keyboard.
.IP \fBd\fP
Dump current window contents. An image of the current window is
written to the file
.I wmdump
in the current directory.
.IP \fBk\fP
Kill the named window.
Sends the signal SIGHUP (hangup) to the processes associated with the window,
then erases the window.
(The
.I name
of this window may later be re-used in creating a new window.)
.IP \fBp\fP
Change the prefix character.
.IP \fBr\fP
Redraw the screen.
Clears the entire screen and redraws what should be there.
Helpful after garbage (like a broadcast message) has arrived.
.IP \fBq\fP
Quit.
End the current 
.I wm
session.
First terminates the processes associated with each
.I wm,
window by sending them the signal SIGHUP (hangup).
Then, if you have changed the window configuration during the session
(and didn't specify the 'no restore' (\fB\-n\fP) option),
asks you if you want to save the current window configuration
for the next session.
Then exits.
.IP \fBz\fP
Suspend
.I wm
by using the Berkeley job control system,
or perhaps by spawning a non-window subshell.
.IP "\fBh\fP or \fB?\fP"
Help.
Displays a summary of
.I wm
commands.
.SH FILES
.IP \fI.wmrc\fP
.IP \fI$HOME/.wmrc\fP
used to save the arrangement of your windows from one session to the next.
.SH BUGS
It'll never beat a BLIT.
.SH "SEE ALSO"
R.J.K. Jacob,
"User-Level Window Managers for UNIX,"
.I "Proc. UniForum International Conference on UNIX,"
pp. 123-133 (1984).
.SH AUTHOR
Robert J.K. Jacob
.br
Naval Research Laboratory
.sp
Revised by Matt Lennon and Tom Truscott
.br
Research Triangle Institute
DataMuseum.dk

DKUUG/EUUG Conference tapes

⟦38df5b9de⟧ TextFile

Derivation

TextFile
