AMATERUS is a Window Manager using GTK+.  It has not been so
stable yet for daily use.  I recommend you to try it under
the Xnest environment.

Example: How to invoke AMATERUS under Xnest
% Xnest :1 &
% DISPLAY=:1 amaterus &

You can also see debug messages by setting environmental
variable WM_DEBUG.


MOUSE BUTTON OPERATIONS
=======================
There are 4 operations: Press (press the button), Drag (move
the mouse on keeping the button pressed), Double (double-click)
and Release (release the button).  1, 2 and 3 denote the kind
of buttons: e.g. Double1 means the double clicking of the left
button.


OPERATION ON ROOT WINDOW (temporary)
====================================
Press1: (left click)
Pop-up window appears in which you can input the command to be
invoked.  If "Terminal" is selected, one of kterm, rxvt of xterm
is executed which was determined on configuration.
If "New Group..." is selected, new "group" is created.  See
"WINDOW GROUP" below about the group.  "Restart" restarts
AMATERUS,  "TWM" stops AMATERUS and invokes twm, and "Exit"
simply stops AMATERUS.

Press2: (center click)
Select the clients which will belong to the group.

Press3: (right click)
Displays a list of the running clients.  If you select a
client from the list, the window of it comes at the top,
restoring the window if it was iconified.


BUTTONS ON WINDOW
=================
[_] Iconify Button:
 Press1:
  Iconify.  The Icon can be moved by dragging.
 Press2:
  Iconify the client together with all the members of
  the same group.

[x] Close Button:
 Press1:
  Close the window.

[G] Grouping Button
 Press1:
  Choice the group.  All the members will be manipulated
  simultaneously.
 Press2:
  Change the group to which the client belongs.

* Title Button:
 Press1:
  Put the window on top.
 Drag1: 
  Move the window.
 Double1:
  Put the window below.
 Drag3:
  Resize the Window.

* Resize button at the foot of the window
 Press1:
  Put the window on top.
 Drag1: 
  Resize the Window.

[<] Title Modify Button:
 Press1:
  Displays title format, and you can edit it.  Default is "$t".
  Try "$t $x, $y ($wx$h)" to see how it works.  The
  parameters beginning with $ have following meanings,
  respectively.

     $t Window Title
     $i Icon name
     $x X coordinate
     $y Y coordinate
     $w width
     $h height
     $$ $ itself

  You can modify the content of the title bar by editing this
  title format.  For example, you can set "$t: (For DEVEL)"
  when you want to explicitly notice that the window is for
  development purpose.


WINDOW GROUP
============
Group feature enable you to manipulate multiple windows at the
same time.  You can select the group from any client which
is a member of it, and manipulate all the clients belonging to 
the group at once.

Left-clicking (Press1) the root window and selecting the "New group",
a window is displayed into which you can specify the group
name.  Group name has no limitations.  It can even be duplicate.
Once you input the group name, it is created.

To select the window to be join to the group, click the center (Press2)
on the [G] button of the window.  You can also select the clients
from the menu that will be appeared by Press2 on root window.  In
this case, you can select multiple clients at once by selecting them
by space key on the menu.

"Destroy Group" eliminates the group.  Note that it destroys
not the windows which belong to the group but the group itself.
To rename the group, use "Rename Group".

On left-clicking (Press1) the [G] button, the menu for the group selection
appears.  "All Clients" and "Only This" groups are special ones.
The former is the group to which all the client belongs.  The
latter group"s" are created corresponding to all the clients,
have only one client, and can be seen only from the client.
In addition, the both cannot be destroyed.


AUTO CREATION OF THE GROUP
==========================
On some clients, WM_CLIENT_LEADER property is set.  The windows
which have same value for this WM_CLIENT_LEADER property (Window type)
are regarded as the ones created by the same ancestor, 
and a group is created automatically by the window manager.
It is possible to register another clients to this group.

The group created automatically is destroyed also automatically
when all the member-clients are removed.


FUTURE PLAN
===========
This product had been developed as a part of my bachelor thesis,
so that the features related to it was implemented preferentially
(launcher functions had lower priorities, for example).
The thesis was finished in 2000 spring.  I'd like to keep developing
it and update versions.

There has been no customization features yet.  I'll implement it
near future.  Edit wmwindow.c to modify the window frame, and
wmroot.c or wmmisc.c to modify launcher.  If you are familiar
with GTK+, it is very easy to change the button layouts on the
frame as well as window designs.

Please be patient :)

                                                      KOMATSU, Hiroyuki
                                                -----------------------
                                                    komatsu@taiyaki.org

          (English translation by NAKANO Takeo <nakano@apm.seikei.ac.jp>)

$Id: README.en,v 1.2 2000/08/08 08:57:05 komatsu Exp $
