< amiwm >  by Marcus Comstedt (marcuslysator.liu.se)


0. Legal notices

This program is distributed as FreeWare.  The copyright remains with
the author.

Amiga and Workbench are registered trademarks of Amiga Technologies GMBH.

1. Intro

This is amiwm, an X window manager that tries to make your workstation
look like an Amiga®.  "Why?" you ask.  Because I wanted it to.  So there!

2. Compiling etc.

For instructions on building and installing, read the file INSTALL.

3. Configuration

amiwm reads the file .amiwmrc in the directory pointed to by $HOME
when starting.  If this file does not exist, it reads the file
system.amiwmrc instead.

The configuration file can contain any of the following statements:

FastQuit {yes|no}

Specifies whether amiwm should quit directly when the Quit menu item
is selected, rather than popping up a requester.
(on/off or true/false can be used instead of yes/no.)

SizeBorder {right|bottom|both|none}

Specifies which border should be enlarged when a sizegadget is present.

ForceMove {manual|auto|always}

Enables you to move windows outside the perimeter of the root window
when pressing shift, when trying to drag at least 25% of the window
ofscreen, or always, respectively.

IconDir "path"

Specifies a directory in which amiwm will look for icons.

DefaultIcon "name"

Gives the filename of the .info file to use as a default icon.
It is relative to the IconDir.

IconPalette {system|magicwb}

Selects either the Workbench® default palette, or the MagicWorkbench
standard palette for use with icons.

ScreenFont "fontname"

Selects a font to use for windowtitles etc.

IconFont "fontname"

Selects a font for icontitles.

{detailpen|blockpen|textpen|shinepen|shadowpen|fillpen|filltextpen|
	backgroundpen|highlighttextpen|bardetailpen|barblockpen|
	bartrimpen} "colorname"

Modifies the colour scheme for the window manager.

ToolItem "name" "command"

Adds an item in the Tools menu with the specified name, which executes
the command when selected.

ToolItem Separator

Inserts a separator bar in the Tools menu.

ToolItem "name" { <tool item commands> }

Create ToolItem:s in a submenu with the specified name.  It is not legal
to create a submenu inside another submenu.

Screen "name"

Create a new screen with the specified name.  It will be placed below all
earlier created screens.  To move a window between two screens, iconify it
and drag the icon over to the other screen.

ModulePath "path(:path...)"

Sets one or more directories where amiwm will look for module binaries.
The default is AMIWM_HOME.  Note that the module binaries cannot be
shared amongst different architectures.

Module "name" ["initstring"]

Start a module with the specified name.  If initstring is specified, it
is sent to the module.  There are currently two modules shipped with
amiwm; Background and Keyboard.  These are documented in the file
README.modules.  If a module is limited to a single screen, like the
Background module, the screen that was created last is used.

InterScreenGap number

Sets the size in number of pixels of the "video DMA off" area that appears
between screens when they are dragged.

AutoRaise {yes|no}

Selects wheteher windows will automatically be moved to the front when
they are activated.


4. Troubleshooting

The most likely reason for the windowmanager to crash is if it
can't find its default icon, or if this is not accepted as an
.info file.  If this happens, amiwm _will_ dump core.  So make
sure that either 'make install' runs successfully (in which case
amiwm will know where its icon is), or that the file .amiwmrc
contains a correct specification of the icon's location.

Don't mail me bug reports just because amiwm prints "Bad Window" on
stderr once in a while.  Redirect it to /dev/null or live with it.  :)

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                   75      89  84.3% -lh5- 67b8 Feb  9  1996 amiwm/alloc.h
[generic]                 1849    3852  48.0% -lh5- abb5 Aug  2  1996 amiwm/amiwm.1
[generic]                   95     130  73.1% -lh5- 395e Apr  4  1996 amiwm/Background
[generic]                 2118    7819  27.1% -lh5- c3be Jul 31  1996 amiwm/client.c
[generic]                  344     706  48.7% -lh5- f8a9 Feb 26  1996 amiwm/client.h
[generic]                17183   66551  25.8% -lh5- 2df5 Aug  2  1996 amiwm/configure
[generic]                  738    1340  55.1% -lh5- 577c Aug  2  1996 amiwm/configure.in
[generic]                 1661    4471  37.2% -lh5- 002f Nov 20  1995 amiwm/def_tool.info
[generic]                 2232    5688  39.2% -lh5- 75da Mar 13  1996 amiwm/diskobject.c
[generic]                 3011   10536  28.6% -lh5- 96ed Aug  2  1996 amiwm/executecmd.c
[generic]                 3730   16452  22.7% -lh5- 827a Jul 30  1996 amiwm/frame.c
[generic]                 1329    3611  36.8% -lh5- 14a8 May 18  1996 amiwm/gram.y
[generic]                 1533    4339  35.3% -lh5- a32f Apr 26  1996 amiwm/icc.c
[generic]                  250     484  51.7% -lh5- 5622 Mar 16  1996 amiwm/icc.h
[generic]                 3089   10317  29.9% -lh5- c662 Apr 26  1996 amiwm/icon.c
[generic]                  199     315  63.2% -lh5- ebbb Apr 26  1996 amiwm/icon.h
[generic]                  536    1012  53.0% -lh5- 5264 Apr  4  1996 amiwm/INSTALL
[generic]                 1857    4771  38.9% -lh5- 0b99 Dec  2  1995 amiwm/install-sh
[generic]                 1228    3431  35.8% -lh5- 24a1 Aug  2  1996 amiwm/kbdlexer.l
[generic]                  642    1317  48.7% -lh5- 8c95 Apr 10  1996 amiwm/kbdmodule.y
[generic]                  567    1210  46.9% -lh5- 9d88 May 23  1996 amiwm/lex.l
[generic]                  249     489  50.9% -lh5- 28ec Apr  1  1996 amiwm/libami/broker.c
[generic]                 1369    3639  37.6% -lh5- 0093 Feb 20  1996 amiwm/libami/drawinfo.c
[generic]                  823    2258  36.4% -lh5- 23d1 Feb 20  1996 amiwm/libami/drawinfo.h
[generic]                  637    1508  42.2% -lh5- ec3e Apr 27  1996 amiwm/libami/error.c
[generic]                  248     481  51.6% -lh5- 5e14 Apr  1  1996 amiwm/libami/eventdispatcher.c
[generic]                 1215    3556  34.2% -lh5- 88cc Apr  4  1996 amiwm/libami/hotkey.c
[generic]                  275     488  56.4% -lh5- aab9 Apr  4  1996 amiwm/libami/kbdsupport.c
[generic]                 1547    4498  34.4% -lh5- 4423 Jul 31  1996 amiwm/libami/libami.h
[generic]                  486    2037  23.9% -lh5- 4d43 Apr 18  1996 amiwm/libami/lists.c
[generic]                  495    1007  49.2% -lh5- 9909 Apr 27  1996 amiwm/libami/Makefile.in
[generic]                  152     320  47.5% -lh5- 9cc5 Apr  4  1996 amiwm/libami/mdscreen.c
[generic]                 1282    3886  33.0% -lh5- 2df5 Aug  2  1996 amiwm/libami/module.c
[generic]                 3858   13068  29.5% -lh5- 171e Aug  2  1996 amiwm/libami/readargs.c
[generic]                 8979   32091  28.0% -lh5- da48 Aug  1  1996 amiwm/main.c
[generic]                 1471    4099  35.9% -lh5- fc77 Aug  2  1996 amiwm/Makefile.in
[generic]                 5257   21467  24.5% -lh5- c3ad Aug  2  1996 amiwm/menu.c
[generic]                 3028   10108  30.0% -lh5- ebe2 Jul 31  1996 amiwm/module.c
[generic]                  353     789  44.7% -lh5- bab7 Apr  4  1996 amiwm/module.h
[generic]                  177     270  65.6% -lh5- c5ef Mar 31  1996 amiwm/prefs.h
[generic]                 1223    2938  41.6% -lh5- d749 Mar 31  1996 amiwm/rc.c
[generic]                 1844    3798  48.6% -lh5- 7715 Apr  4  1996 amiwm/README
[generic]                  926    2039  45.4% -lh5- 48e7 Apr  4  1996 amiwm/README.modules
[generic]                 2557    8252  31.0% -lh5- 544f Jul 31  1996 amiwm/requestchoice.c
[generic]                  149     204  73.0% -lh5- 94d2 Nov 20  1995 amiwm/scoptions
[generic]                 2026    5961  34.0% -lh5- b5c7 Apr 26  1996 amiwm/screen.c
[generic]                  354     640  55.3% -lh5- c39c Apr  1  1996 amiwm/screen.h
[generic]                  400     866  46.2% -lh5- 5427 Nov 20  1995 amiwm/smakefile
[generic]                  127     150  84.7% -lh5- 0b63 Apr  4  1996 amiwm/system.amiwmrc
[generic]                   27      27 100.0% -lh0- 4a17 Jul 31  1996 amiwm/version.h
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        50 files   85800  279375  30.7%            Oct 31  1996